Claude docs changes for November 2nd, 2026 [diff]
Executive Summary
- New message threads beta for the Messages API: the server keeps the conversation, so each turn sends only new messages, giving smaller requests and a lower time to first token in long agent loops.
- New
permissions.blockWritesOutsideWorkingDirectoriessetting makesWrite,EditandNotebookEditrefuse paths outside the working directories in every permission mode. It also removes the worktree tools and protects settings files. - Fast mode for Opus 4.8 is deprecated and will be removed on November 30, 2026. Switch to Opus 5.5 (Claude Code v2.1.280 or later) or run
/fast off. - The Claude Apps gateway gained per-team upstream routing with
groups, Bedrock guardrail input tagging, andguardrail.tracelogging. - Per-message effort (beta) is now documented across several models, so you can change effort mid-conversation without invalidating the prompt cache. Java SDK 3.4.0,
antCLI 2.5.0 and the other SDKs were bumped.
New Claude Code versions
No new Claude Code versions in this update.
Claude Code changes
Changed documents
auto-mode-config [Source]
- The
/permissionsRecently denied tab is now Recently blocked, and retrying is documented as a step-by-step flow: check the command, pressrto approve, close the dialog. [lines 354-390] [Source] - Approving doesn't add a permission rule, so a retried action can be blocked again. You can also approve for later with
EnterthenEsc, take back an approval, or discard withCtrl+Ctwice. Rows that read "This row can't be approved here" can't be approved. [lines 356-385] [Source]
claude-apps-gateway-config [Source]
- New "Send each team to its own upstream" section: give upstreams a
groupslist so only developers in those IdP groups reach them. An upstream withoutgroupsis open to everyone, so list it last. [lines 775-850] [Source] - Failover rules clarified: a request moves past an upstream only if it failed, doesn't serve the model, or its
groupslist excludes the developer. Model-scoped and built-in model routing were also described. [lines 708-770] [Source] - New Bedrock guardrail
input_taggingoption (last_message,user_messages,all_messages,all_messages_and_system). Without it, Bedrock filters that need tagged input don't run. Limits are listed, such as tool results and images not being covered. [lines 368-440] [Source] - New
guardrail_trace: trueupstream option logs aguardrail.traceevent showing which filter fired, without the matched text. [lines 410-450] [Source] - Notes for
assume_roleupstreams: withoutgroups, every admitted developer can use the upstream. [line 494] [Source]
claude-apps-gateway-deploy [Source]
- Added the
guardrail.tracelog stream. [line 168] [Source] - Warning for rollbacks: removing only the
groupskey from an upstream leaves it open to every developer. [lines 311-314] [Source] - Troubleshooting entry for
400 you aren't in a group that can use this gateway. Upstreamgroupsnow count among the groups to keep when trimming the groups claim. [lines 426-459] [Source]
desktop [Source]
- New table of Claude Code settings that behave differently in the Desktop Code tab, for example
defaultShell,fileSuggestion,modelPickerandprUrlTemplate. [lines 1947-1968] [Source] - In SSH sessions Claude has no Browser pane tools, so it can't open your app or auto-verify changes. [line 119] [Source]
- Diagnostics now also ask for
remote-server.log.old, which is lost the next time the helper restarts. [lines 2302-2307] [Source]
errors [Source]
- New error "Claude Code didn't send your claude.ai login": an administrator's
apiKeyHelperisn't in effect, and Claude Code refuses prompts. [lines 1077-1089] [Source] - New entries for write refusals caused by
permissions.blockWritesOutsideWorkingDirectories, covering paths outside working directories and Claude Code settings files, with remedies such as/add-dir. [lines 4579-4618] [Source] - Auto mode "no usable answer" row clarified, including when the server gave no verdict. [line 675] [Source]
fast-mode [Source]
- Fast mode for Opus 4.8 was deprecated on October 30, 2026, and will be removed on November 30, 2026. Switch to Opus 5.5 with
/model(needs v2.1.280 or later) to keep fast mode, or run/fast off. [lines 13-19] [Source]
permission-modes [Source]
- Writes outside the working directories are never auto-approved while
blockWritesOutsideWorkingDirectoriesis on. Settings-file writes are refused in every mode. [lines 40, 738-739] remote-settings.jsonand its sync and consent files are now protected files. [line 778] [Source]- Renamed "Recently denied" to "Recently blocked". [lines 553-555] [Source]
permissions [Source]
- New section "Block file-tool reads and writes outside the working directories" covering
blockReadsOutsideWorkingDirectoriesand the newblockWritesOutsideWorkingDirectories. [lines 669-677] [Source]
server-managed-settings [Source]
- New section explaining when a machine's
apiKeyHelperisn't in effect while server-managed settings are the selected source, and how to clear the resulting refusal (v2.1.314 or later). [lines 156-164] [Source]
settings [Source]
permissions.blockWritesOutsideWorkingDirectoriesis a restrictive key honored from any scope, even when managed settings setfalse(v2.1.314 or later). [line 306] [Source]
settings-reference [Source]
- New
permissions.blockWritesOutsideWorkingDirectoriesentry: scope, type, default, a test procedure, and what stays writable (plan files, scratchpad and similar). It also removes the worktree tools. The write block is on by default while managedpermissionscan't be read. [lines 1092-1133] [Source]
setup [Source]
- Git is listed as an optional requirement:
claude plugin evalneeds git 2.31 or later, and uploading a local repository to a cloud session has its own git requirement. [line 25] [Source]
tools-reference [Source]
- New "EnterWorktree tool behavior" section: which
pathvalues are accepted (including nested repositories), when approval is prompted for paths outside.claude/worktrees/, restrictions from inside a worktree, and the tool's removal when writes are blocked. [lines 298-306] [Source]
worktrees [Source]
- New troubleshooting section "Claude has no
EnterWorktreetool" with workarounds:claude --worktree,claude --bg --worktree,worktree.bgIsolation: "none", andgit worktree add. [lines 51-64] [Source] - Background sessions' edits to the main checkout are blocked. To change those files, edit them yourself or start an interactive session there. [line 104] [Source]
API changes
New Documents
message-threads [Source]
New beta feature (header message-threads-2026-08-12) for the Messages API. You send the full conversation once with your system prompt and tools. Later turns send only the new messages and the previous response id, and the API rebuilds the conversation server-side. This gives smaller requests and a lower, steadier time to first token in long agent loops. A thread expires 5 minutes after its last request and is deleted within 1 hour. The page covers SDK helpers, using the thread field directly, prompt caching, streaming, recovering from threads that can't be continued, compaction, errors, unsupported features, pricing and rate limits, and availability. The feature is not ZDR or HIPAA eligible, and it is available on the Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) and Microsoft Foundry.
Changed documents
api-and-data-retention [Source]
- Message threads added to the feature eligibility table: not ZDR or HIPAA eligible, with contents held encrypted in memory and deleted within 1 hour. [lines 197-206] [Source]
effort [Source]
- Effort is now listed as stable on Claude Models on Google Cloud (Anthropic managed). The availability table now reads "All supported platforms". [lines 31, 710-712]
- Per-message effort (beta) is documented with its supported models and platforms. Claude Haiku 5.5 can change effort mid-conversation while preserving the prompt cache. [lines 286-397] [Source]
anthropic-managed [Source]
- Adaptive thinking and effort are added to the supported-features list. [lines 518-519] [Source]
extended-thinking [Source]
mid-conversation-system-messages [Source]
- A
role: "system"message can carryoutput_config.effortto change effort mid-conversation (beta). [line 1656] [Source]
overview [Source]
preserved-thinking [Source]
- Changing top-level
output_config.effortdoesn't invalidate thinking but does restart the prompt cache. [line 1240] [Source]
prompting-claude-haiku-5-5 [Source]
- Changing top-level effort between requests invalidates the prompt cache, so use per-message effort changes instead where available. [line 41] [Source]
thinking-steering-and-cost [Source]
- On Claude Haiku 5.5 the discouraging phrase doesn't reliably reduce thinking. Use per-message effort instead. [line 97] [Source]
vision [Source]
- The FAQ on image storage now points to API and data retention, and notes that Files API uploads can be deleted. [line 1368] [Source]
whats-new-fable-5-1 [Source]
- Fable 5.1 supports per-message effort changes (beta) without invalidating the prompt cache. [line 93] [Source]
working-with-messages [Source]
- Notes that message threads (beta) let the API keep the conversation, so later requests send only new messages. [lines 188-189] [Source]
overview [Source]
- SDK and CLI versions updated: ant CLI 2.5.0, Python 2.4.0, TypeScript 1.4.0, C# 13.4.0, Go 2.5.0, Java 3.4.0, PHP 1.4.0, Ruby 2.4.0. Java 3.4.0 and CLI 2.5.0 are also reflected in the quickstarts and the cloud-platform pages. [lines 59-66] [Source]
overview [Source]
- November 2, 2026 release note announcing message threads in beta. [lines 15-18] [Source]