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 newCLAUDE_CODE_DROP_UNAVAILABLE_DEFERRED_TOOLvariable lets you drop the pending call (v2.1.319) PostToolUsehooks now run (with a 10-second limit) when a turn is ended withCtrl+Enterduring a tool call- New
CLAUDE_CODE_CONFIG_LOCK_WAIT_MSvariable letsclaude mcp add/removewait longer for the~/.claude.jsonlock - Remote Control and Desktop can now be disabled via
remoteControlAtStartup: falsein 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
displaythinking value. [line 1352] [Source]
agent-sdk/typescript [Source]
- Same clarification about the
displaythinking 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-betaheader andsafeguardsbody field together, and keepsafeguard_resultsand tool-use IDs in responses. [lines 28-33] [Source]
desktop [Source]
- Remote Control auto-connect is skipped when
remoteControlAtStartupisfalsein 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, ordisableBrowserExternalNavigationin 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 likeclaude mcp addwait for the~/.claude.jsonlock. [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_NEGOTIATIONdescription updated (legacykeeps servers on the earlier handshake,autoprobes). [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-pand 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_unavailablestop reason, exit codes, and dropping the call withCLAUDE_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,EnterandEscaffectPostToolUsehooks. Hooks get 10 seconds afterCtrl+Enter, andasync: trueis 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 availableappears (deny rules, names over 128 characters,_meta.ui.visibility). [lines 305-314] [Source] - Reorganized the runtime and protocol negotiation notes. With
MCP_PROTOCOL_NEGOTIATIONunset, 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_CERTSfile 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.comas the test command, and aDisabledresult now suggests checking permission rules. [lines 430-436] [Source]
plugins/cli-reference [Source]
- New "Validate a manifest file" section: how
claude plugin validatedecides whether a file is a marketplace or a plugin manifest. [lines 630-639] [Source]
plugins/marketplace-reference [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
--cloudbundles a local repo. [lines 164-169] [Source]
sandboxing [Source]
- Mods run outside the sandbox: their file access, network requests, and
$.processprograms aren't sandboxed. [line 40] [Source]
self-hosted-environments-configuration [Source]
- New
CLAUDE_RUNNER_SPAWN_REASONvariable passed to thespawn-runnerhook (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
allowedProviderslist, 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_AUTHorCLAUDE_CODE_SKIP_MANTLE_AUTHis 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 --verifyand tells you to compare thePrimary key fingerprintagainst the one in Step 1. [lines 535-542] [Source]
tools-reference [Source]
PushNotificationnow 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
--cloudbundles a local repo. [lines 11, 43, 208]