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

Executive Summary

  • Deferred tool calls ("defer" hook) have new behavior when the tool is unavailable on resume: a new CLAUDE_CODE_DROP_UNAVAILABLE_DEFERRED_TOOL variable lets you drop the pending call (v2.1.319)
  • PostToolUse hooks now run (with a 10-second limit) when a turn is ended with Ctrl+Enter during a tool call
  • New CLAUDE_CODE_CONFIG_LOCK_WAIT_MS variable lets claude mcp add/remove wait longer for the ~/.claude.json lock
  • Remote Control and Desktop can now be disabled via remoteControlAtStartup: false in managed settings (MDM policy)
  • Cloud sessions no longer strictly require GitHub, and push notifications now work in cloud sessions

New Claude Code versions

No new version files in this update.


Claude Code changes

Changed documents

agent-sdk/python [Source]

  • Clarified that on providers such as Amazon Bedrock and Google Cloud's Agent Platform, Claude Code doesn't pass the display thinking value. [line 1352] [Source]

agent-sdk/typescript [Source]

  • Same clarification about the display thinking value on Bedrock and Google Cloud's Agent Platform. [line 5432] [Source]

auto-mode-classifier-billing [Source]

  • Rewrote the LLM gateway guidance with explicit requirements: forward the anthropic-beta header and safeguards body field together, and keep safeguard_results and tool-use IDs in responses. [lines 28-33] [Source]

desktop [Source]

  • Remote Control auto-connect is skipped when remoteControlAtStartup is false in managed settings; new "Keep sessions off your other devices" subsection with an MDM/managed-settings option. [lines 548-559] [Source]
  • Features turned off via browserExternalPageTools, disableMobileSimulatorTools, or disableBrowserExternalNavigation in managed settings are covered in the managed-settings section. [line 2016] [Source]

desktop-changelog [Source]

  • Same Remote Control managed-settings and MDM changes as in the desktop page. [lines 548-559] [Source]

desktop-ios-simulator [Source]

  • New section on minimizing or closing the simulator pane: Claude can still use the device, and clicking iOS Simulator in the title bar shows it again. [lines 85-91] [Source]

env-vars [Source]

  • New CLAUDE_CODE_CONFIG_LOCK_WAIT_MS: how long commands like claude mcp add wait for the ~/.claude.json lock. [line 220] [Source]
  • New CLAUDE_CODE_DROP_UNAVAILABLE_DEFERRED_TOOL: drops a deferred tool call whose tool is unavailable when resuming with -p. [line 277] [Source]
  • MCP_PROTOCOL_NEGOTIATION description updated (legacy keeps servers on the earlier handshake, auto probes). [line 487] [Source]

errors [Source]

  • "MCP server was not saved or removed" now explains lock contention from other Claude Code processes (10-20 second wait) and the fix via CLAUDE_CODE_CONFIG_LOCK_WAIT_MS; notes the behavior before v2.1.318. [lines 3562-3579] [Source]
  • Noted that a "file was not found" reason means the server may still be configured. [line 3585] [Source]

hooks [Source]

  • "defer" is honored only with -p and a single tool call; it is ignored with a warning in interactive sessions or with several tool calls. [lines 2062-2068] [Source]
  • New "Resume when a deferred tool is unavailable" section: the tool_deferred_unavailable stop reason, exit codes, and dropping the call with CLAUDE_CODE_DROP_UNAVAILABLE_DEFERRED_TOOL=1. Before v2.1.319, a prompt dropped the call. [lines 2101-2114] [Source]
  • New "PostToolUse after an interrupt" section: how Ctrl+Enter, Enter and Esc affect PostToolUse hooks. Hooks get 10 seconds after Ctrl+Enter, and async: true is recommended for longer ones. [lines 2229-2240] [Source]

mcp [Source]

  • New "Tool counts in a cloud session" section explaining why a count like 3 of 13 tools available appears (deny rules, names over 128 characters, _meta.ui.visibility). [lines 305-314] [Source]
  • Reorganized the runtime and protocol negotiation notes. With MCP_PROTOCOL_NEGOTIATION unset, Claude Code can skip asking a stdio server for 7 days. [lines 358-360] [Source]

network-config [Source]

  • Documented two new warnings shown when the NODE_EXTRA_CA_CERTS file can only be partly read or not at all. [lines 88-94] [Source]

permission-modes [Source]

  • Updated the auto-mode classifier troubleshooting steps. Use curl https://example.com as the test command, and a Disabled result now suggests checking permission rules. [lines 430-436] [Source]

plugins/cli-reference [Source]

  • New "Validate a manifest file" section: how claude plugin validate decides whether a file is a marketplace or a plugin manifest. [lines 630-639] [Source]

plugins/marketplace-reference [Source]

  • Name the file marketplace.json to have it validated as a marketplace. [line 454] [Source]

remote-control [Source]

  • Added guidance for the Remote Control isn't connected. dialog in /remote-control. [line 146] [Source]

sandbox-environments [Source]

  • Cloud session requirements reframed: GitHub is needed only to work in a GitHub repository, not when --cloud bundles a local repo. [lines 164-169] [Source]

sandboxing [Source]

  • Mods run outside the sandbox: their file access, network requests, and $.process programs aren't sandboxed. [line 40] [Source]

self-hosted-environments-configuration [Source]

  • New CLAUDE_RUNNER_SPAWN_REASON variable passed to the spawn-runner hook (e.g. runner_lost, resumed). Requires v2.1.318. [line 328] [Source]

server-managed-settings [Source]

  • If a session's provider isn't on the cached allowedProviders list, Claude Code can wait for a settings fetch and recheck before refusing. [line 194] [Source]

settings-reference [Source]

  • Push notification settings clarified: in a local session they need Remote Control. [lines 4828, 4965]
  • The credential helper reruns after a 401 (not 403) through an LLM gateway when CLAUDE_CODE_SKIP_VERTEX_AUTH, CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH or CLAUDE_CODE_SKIP_MANTLE_AUTH is set. Requires v2.1.318. [line 5175] [Source]
  • forceLoginOrgUUID: outside managed settings Claude Code doesn't check the login's organization. [line 5261] [Source]

setup [Source]

  • Manifest signature verification now uses gpg --with-fingerprint --verify and tells you to compare the Primary key fingerprint against the one in Step 1. [lines 535-542] [Source]

tools-reference [Source]

  • PushNotification now also sends a phone push from cloud sessions, and a desktop notification from local sessions. [line 38] [Source]

web-quickstart [Source]

  • A GitHub account is needed only for GitHub repositories, not when --cloud bundles a local repo. [lines 11, 43, 208]

API changes

Changed documents

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

  • Background compaction is now listed as beta on Amazon Bedrock. [line 28] [Source]

build-with-claude/compaction-keep-recent-turns [Source]

  • Keep-tail compaction is now listed as beta on Amazon Bedrock. [line 28] [Source]

build-with-claude/compaction-on-demand [Source]

  • On-demand compaction is now listed as beta on Amazon Bedrock. [line 28] [Source]