Claude docs changes for November 4th, 2026 [diff]

Executive Summary

  • Claude Code 2.1.318 hardens ~/.claude.json and login storage on shared network home directories, and adds login-expiry reporting to claude auth status and claude -p.
  • The Agent SDK and command/http hooks gain onFailure: "block", so a crashing or timed-out policy hook can block an action instead of letting it through.
  • Anthropic's text watermark is documented (new page), including the Sonnet 4.6 caveat for non-default temperature/top_p/top_k.
  • The API docs now show anthropic-version: 2026-10-21 in Managed Agents and compaction examples. Compaction can also return a null summary, and the sample code was updated to handle that.
  • The Agent SDK permissions docs were rewritten to explain how hooks, deny rules, bypassPermissions and plan mode interact. New docs also cover Windows SSH host commands in Desktop and a sandbox AppArmor/bubblewrap fix.

New Claude Code versions

2.1.318

New features

  • assume_role on mantle upstreams of the Claude apps gateway, for roles in another AWS account and per-developer cost attribution
  • effort option on a mod's $.model.fork
  • claude auth status (loginExpiresAt) and claude -p JSON results (credential_expires_at) report when a stored claude.ai sign-in ends. claude -p text output warns on stderr 10 days beforehand
  • Cloud sessions: "No repository" option, Chrome names (google-chrome, CHROME_PATH) for the built-in Chromium, and a New session button when the environment was deleted
  • Self-hosted runner: CLAUDE_RUNNER_SPAWN_REASON in the spawn-runner hook environment

Existing feature improvements

  • ~/.claude.json, settings files and the stored login survive saves on shared network home directories much better, and sessions re-check when the config is wrongly reported missing
  • Unattended runs (claude -p, SDK) no longer rewrite ~/.claude.json when nothing changed
  • MCP tool errors for a call made before the tool is loaded now return the input schema
  • More reliable git commits and PR creation under macOS /bin/bash; clearer Create PR failure messages in cloud and Remote Control sessions
  • Faster remote session reconnects after sleep; auto-update retries brief network failures right away
  • Changed: Claude Code no longer installs or updates the IDE extension when started in an IDE terminal (use /ide from an outside terminal)
  • Changed: background subagents move shell commands to the background after 3 minutes on all providers
  • Changed: deniedMcpServers URL entries also block matching Anthropic-provided servers and connectors in cloud sessions and on self-hosted runners
  • Changed: /claude-api managed-agents-onboard defaults new agents' built-in tools and quickstart MCP tools to the auto permission policy
  • Changed: what a mod attaches at prompt.submit stays in the user's turn instead of going out as a system message
  • Changed: subagents stop instead of switching models when "Switch models when a message is flagged" is "Ask each time"

Major bug fixes

  • Fixed --continue losing earlier conversation after a malformed tool call's retries ran out (regression in 2.1.314)
  • Fixed /logout, claude auth logout and claude mcp remove silently failing, and settings being dropped, on shared network home directories
  • Fixed claude mcp add/remove writing config without a lock
  • Fixed non-interactive launches replacing an invalid ~/.claude.json with defaults; the start now fails with restore instructions
  • Fixed jobs exiting with Not logged in when another terminal or host signs in to the same account
  • Fixed every connection failing when the NODE_EXTRA_CA_CERTS file is empty, not PEM, or starts with a damaged certificate
  • Fixed permission prompts being answered by keys typed just after sending a message
  • Fixed macOS sessions with many running Bash commands stalling while memory grew
  • Fixed claude remote-control hosts, the daemon and self-hosted runners failing with spawn ENOENT after an update removed a running binary
  • Fixed version cleanup deleting the binary of a process owned by another user
  • Fixed idle compaction replacing a conversation with a non-summary reply
  • Fixed claude -p/SDK sessions reporting success when an API error cut off a reply while a mod hooked turn.step

Claude Code changes

New Documents

None.

Changed documents

admin-setup [Source]

  • Minor wording updates only.

agent-sdk/hooks [Source]

  • New onFailure matcher option (on_failure in Python) with "block" to block the action when a hook callback throws or fails validation. It requires TypeScript SDK v0.3.317+ or Python SDK v0.2.177+. [line 220] [Source]
  • New section "Block the action when a callback fails", with examples, how to test it, and the events that behave differently (Stop, SubagentStop, TaskCompleted, TeammateIdle, PermissionRequest, PostToolUse). It also covers startup errors for onFailure. [lines 280-326] [Source]
  • Hook timeouts on PreCompact, Elicitation and WorktreeCreate also block when onFailure: "block" is set. [line 816] [Source]

agent-sdk/permissions [Source]

  • The permission evaluation order was rewritten. A hook returning allow doesn't skip deny and ask rules, and deny rules apply even in bypassPermissions. Tools that require user interaction always reach canUseTool. [lines 13-45] [Source]
  • Warning that allowed_tools does not constrain bypassPermissions. Use disallowed_tools to block specific tools. [line 123] [Source]
  • New "Path patterns in rules" section: Edit(path) covers Write and NotebookEdit, //path means absolute and /path is relative to the working directory. [lines 129-141] [Source]
  • Plan mode documentation expanded: edits reach canUseTool, and with auto mode available, shell commands, web fetches and searches go to the classifier (useAutoModeDuringPlan). A table shows which calls reach the callback. [lines 310-347] [Source]
  • acceptEdits clarified: protected paths aren't auto-approved, and the working directory plus added directories are covered. [line 280] [Source]

agent-sdk/secure-deployment [Source]

  • Added notes on critical-path removals and Bash rule limitations. [line 21] [Source]
  • Sandbox runtime network behavior was described, along with the lack of TLS inspection (domain fronting) and a warning about credentials for allowed domains. [lines 82-95] [Source]
  • Docker --network none section now explains how to run a host proxy through a mounted Unix socket for allowlists and credential injection. [lines 132-147] [Source]

agent-sdk/python [Source] and agent-sdk/typescript

  • Reference updates for the new on_failure / onFailure hook matcher option and related message types.

agent-teams [Source]

  • Teammates on the lead's model inherit the lead's effort level (split-pane from v2.1.186). [line 157] [Source]
  • Plan approval: when a teammate whose permission mode hasn't changed finishes planning, the plan is approved automatically on arrival. [line 167] [Source]
  • Cycling a teammate's permission mode with Shift+Tab. In-process teammates may run in the lead's mode, and per-teammate modes can't be set at spawn. [lines 287-295] [Source]
  • New limitation listed: no per-teammate permission modes at spawn. [line 495] [Source]

claude-apps-gateway-config [Source]

  • assume_role is now supported on mantle upstreams. It requires SigV4 credentials and isn't allowed with aws_bearer_token. [lines 493-565] [Source]

claude-md [Source] / memory

  • Use /context all and check Memory files to confirm CLAUDE.md loaded. /memory also lists CLAUDE.md locations that don't exist yet. [line 66] [Source]

desktop [Source] / desktop-changelog

  • SSH host commands now work on Windows, with a new "Write the command on Windows" section covering full .exe/.cmd/.bat paths and quoting. It includes a batch-file wrapper example. [lines 1684-1729] [Source]
  • Version requirements for connections from a command: Desktop v3.6556.0+ on macOS/Linux and v4.16336.0+ on Windows. Quoted paths with spaces also need v4.16336.0+. [line 1601] [Source]
  • Host key verification guidance, sshHostCommands managed-settings rollout advice (per-platform entries), and new reasons an entry is unavailable. [lines 1734-1820] [Source]

env-vars [Source]

  • New CLAUDE_CODE_DISABLE_BG_STABLE_PATH (macOS) to run background session hosts from the installed binary. [line 237] [Source]
  • New CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL to stop /ide from installing the IDE extension. [line 312] [Source]

errors [Source]

  • New entries for "Scheduled tasks/Routines are off for your organization" and the org toggle that controls them. [line 1210] [Source]
  • New remote managed settings messages (fail-closed, still loading, did not load) and how they show in the Desktop Code tab. [line 5822] [Source]
  • New auto mode denial "a hook changed this call's input after auto mode reviewed it", with remedies. [lines 781-795] [Source]
  • New Ubuntu AppArmor / bubblewrap sandbox errors with links to the fix. [line 456] [Source]

hooks [Source]

  • New "onFailure": "block" for command and http hooks, so a failing or timed-out policy hook blocks the action. [line 900] [Source]
  • updatedInput now replaces the whole input and is re-evaluated against permission rules. In auto mode, changing input after review can cause a denial. [lines 1959-2002] [Source]

ide-integrations [Source] / vs-code

  • Starting claude in the integrated terminal no longer installs the extension. Install it yourself, or run /ide from an external terminal, which installs it unless autoInstallIdeExtension is false. [line 817] [Source]

model-config [Source]

  • New "Effort level of subagents and teammates" section, and a pointer to the effort level after a fallback. [line 699] [Source]

monitoring-usage [Source]

  • Warning to use ENABLE_BETA_TRACING_DETAILED only for debugging, because of its high export volume and unstable content attributes. [line 329] [Source]

plugins/mods/reference [Source]

  • agent.spawn now also fires for teammates (e.isTeammate) and when a finished subagent is resumed, for example via SendMessage. A hook can return { deny: reason } to refuse a resumed run (v2.1.299+). [lines 153-162] [Source]

plugins/mods/troubleshoot [Source]

  • Note on the auto mode denial when a hook or mod changes a call's input. [line 198] [Source]

routines [Source] / web-scheduled-tasks

  • Team and Enterprise Owners can turn off scheduled tasks org-wide via the Scheduled tasks (Was Routines) / Routines toggle. A new troubleshooting section covers the resulting error. [line 30] [Source]

sandboxing [Source]

  • Clarified the Dependencies tab: if it's the only tab, the sandbox can't start. Restart Claude Code after installing dependencies. [lines 70-137] [Source]
  • New "Add an AppArmor profile for bubblewrap" section for Ubuntu's user namespace restriction. [lines 145-175] [Source]
  • Documented sandbox.failIfUnavailable to exit at startup instead of running unsandboxed. [line 96] [Source]
  • Additional container guidance for unprivileged containers where bubblewrap can't mount. [lines 911-932] [Source]

self-hosted-environments-configuration [Source]

  • Wrapper script guidance: use cases such as scoped credentials, secrets and resource limits. The runner starts it on every session start, resume or requeue, and it should exec into $CLAUDE_RUNNER_CLAUDE_BIN. [line 15] [Source]
  • The checkout hook now runs on every start, resume or requeue. The post-session hook is your only chance to save uncommitted work, with per-capacity behavior. [lines 145-193] [Source]
  • Wrapper-exported credentials aren't renewed during long sessions. [line 536] [Source]

server-managed-settings [Source]

  • Claude Code now warns in interactive sessions and the Desktop Code tab when the managed-settings fetch fails or a cached policy is in effect. [line 175] [Source]

settings-reference [Source]

sub-agents [Source]

  • Added guidance on choosing and inheriting a subagent's effort level.

API changes

New Documents

text-watermark [Source]

Describes Anthropic's text watermark on text from supported Claude models. It adds no tokens or hidden characters, carries no information about you, and needs no request changes. On Claude Sonnet 4.6, requests with non-default temperature, top_p or top_k might not carry the watermark, so omit all three if you rely on it.

Changed documents

about-claude/models/optimizing-for-cost-and-intelligence [Source]

  • Introduced beta message threads, which stop resending the conversation within a thread. They lower time to first token, not cost, so keep cache_control on every request. They can't be combined with batching. [lines 58-60, line 294]

build-with-claude/compaction-threshold [Source]

  • The API can pause for compaction without generating a summary. The compaction block's content is then null, the block is ignored, and you should keep the original messages. If safeguards block the summary, the stop reason is refusal. [line 1067, line 1643]
  • Sample code in all languages now looks for the compaction block instead of checking stop_reason == "compaction", and replaces history only if a summary exists. [lines 2778-2830] [Source]

managed-agents/quickstart [Source]

  • Restructured setup into "Before you begin", offering CLI sign-in (ant auth login, recommended for local development) or an API key. Installation steps for the CLI (Homebrew, curl, go install) were reorganized, and Maven was added alongside Gradle for Java. [lines 57-200] [Source]

managed-agents/webhooks [Source]

  • The C# SDK has no Unwrap(). Verify with a Standard Webhooks library and deserialize into UnwrapWebhookEvent. The Python example now uses standardwebhooks.WebhookVerificationError. [lines 138-198] [Source]
  • If an endpoint is auto-disabled after a 3xx redirect, create a new endpoint with the same event types and delete the old one. The new endpoint has its own signing secret. [line 427] [Source]

Managed Agents, compaction, context-editing and other pages with curl examples

  • Examples now send anthropic-version: 2026-10-21 instead of 2023-06-01 across the Managed Agents pages (agent-setup, environments, memory, sessions, vaults, skills and others), compaction, context editing and cost-optimization pages.

models/opus-5-5/migration-guide [Source]

  • Mid-conversation system messages are now listed as supported on Claude Platform on AWS and Claude Models on Google Cloud (Anthropic managed), in addition to the API, Bedrock and Google managed. [docs-md/api/models/opus-5-5/migration-guide.md]

models/opus-5-5/overview [Source] / models/sonnet-5-5/overview

  • The breaking-changes lists were removed from the overviews, which now describe typical use cases instead. [line 21] [Source]

release-notes/overview [Source]

  • Added a November 3, 2026 entry: Claude Mythos 5, Opus 4.7 and Sonnet 4.6 text now carries the text watermark. [line 15] [Source]
  • The browser use and computer use tool classes are now tied to Python SDK 1.12.0 and TypeScript SDK 0.132.0. [line 87] [Source]