Claude docs changes for Oct, 29th 2026 [diff]
Executive Summary
- Nearly every API feature page now ends with a standardized "Availability" section (API support for Messages API vs. Managed Agents, platforms, required beta headers, and ZDR/HIPAA data handling), backed by new
featureMetadatafront matter. The ZDR/HIPAA table in API and data retention was reorganized to match. - The first-party Claude API request size limit for Messages and Token Counting is documented as 128 MB (previously 32 MB), and "direct Claude API" wording became "first-party Claude API".
- Claude Code gained
CLAUDE_CODE_EFFORT_LEVEL=auto(send no effort level),CLAUDE_CODE_DISABLE_BACKGROUND_TASKS, and MCP improvements:${VAR:-default}expansion, OAuth behind authenticating proxies, and handling of tools with invalid input schemas. - Plugin docs now describe two Anthropic marketplaces (official and community), deprecate
claude-code-plugins, and add README "Advice" output toclaude plugin validate. - Enterprise docs clarify which managed source supplies login keys (
forceLoginOrgUUID,forceLoginMethod). Self-hosted environments gained an orchestrator--shutdown-drain-secflag.
New Claude Code versions
No new version files in this commit.
Claude Code changes
New Documents
No new documents.
Changed documents
agent-sdk/agent-loop [Source]
- Reworded the definition of a "turn" and the examples of how many turns simple and complex tasks take. [lines 20-27] [Source]
agent-sdk/python [Source]
- Returning
PermissionResultAllowwith more than 4,096updated_permissionsitems makes Claude Code treat the result as invalid and deny the tool call. [line 1245] [Source]
agent-sdk/typescript [Source]
- Same 4,096-item limit on
updatedPermissionsforallowresults. [line 1404] [Source] CronCreateOutputandCronListOutputgained an optionalnextFireAt(epoch ms, jitter applied). [lines 4705-4743] [Source]setMcpServers()resolves after new servers connect or fail. Errors starting withBlocked by enterprisemean policy refused the server. [lines 5462-5479] [Source]
authentication [Source]
- If the browser shows a login code instead of redirecting back, paste it at the
Paste code here if promptedprompt. [line 16] [Source] - Deploy
forceLoginMethodandforceLoginOrgUUIDthrough device management, because server-managed settings arrive only after authentication. [line 182] [Source]
claude-apps-gateway [Source]
- Clarified how
forceLoginOrgUUIDfrom a parent is honored and howmanagedSourcesBehavior: "merge"applies. [lines 445-453] [Source]
claude-apps-gateway-config [Source]
- New
timeouts.upstream_ttfb_mssetting (default 120000 ms) for how long the gateway waits for upstream response headers. Non-Anthropic providers wait up to an hour unless set (gateway v2.1.295+). [lines 630-633] [line 1406] [Source] - Examples now use a custom restricted model id.
sshTransportneeds Claude Code v2.1.293+ on the gateway server. [lines 420-879] [line 1152] [Source]
claude-code-on-the-web [Source]
claude --cloudand--teleportrequire claude.ai sign-in. Added the "Cloud sessions aren't available with this Console sign-in" message and its fix (claude auth login). [lines 227-440] [Source]
claude-directory [Source]
- Windows path note for
~/.claude, andCLAUDE_CONFIG_DIRrelocates every path on the page. Notes when~/.claude.jsonis created. [lines 7-75] [Source]
corporate-launcher [Source]
- Sessions opened from
claude-cli://deep links bypass the launcher. UsedisableDeepLinkRegistrationto prevent them. [line 35] [Source]
deep-links [Source]
- Links only work on a machine after sending a prompt in an interactive session, which registers the handler. [lines 7-103] [Source]
desktop [Source]
- Added guidance for the "earlier layout" (no environment selector under the prompt box), including the Claude Desktop v4.29.0+ requirement for third-party provider sessions on your organization's infrastructure. [lines 42-2127] [Source]
desktop-changelog [Source]
- Same earlier-layout notes as the desktop page. [lines 42-2127] [Source]
desktop-quickstart [Source]
devcontainer [Source]
- Fallback for sign-in failing in containers: use the login URL shown above the paste prompt. [line 78] [Source]
discover-plugins [Source]
- Marketplace add for GitHub repos supports
#refto pin a branch or tag. Linked to the new Anthropic marketplaces page. [line 192] [line 382] [Source]
env-vars [Source]
- New
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS: removesrun_in_background, the Ctrl+B shortcut and background runs of forked skills. [line 232] [Source] CLAUDE_CODE_EFFORT_LEVELdescription updated (precedence over--effortand/effort). [line 275] [Source]- Feature-flag fetching also controls excluding MCP tools whose input schema the API would reject. [line 583] [Source]
errors [Source]
- New "Waiting for API response" banner section (20 s without data). [line 487] [Source]
- New "Command contains an invisible character" error (U+FEFF/U+180E) and expanded "No shell command was run" guidance. [lines 3598-3614] [line 4572] [Source]
- New "The Claude Code program for this computer could not be found" VS Code extension error. [line 5448] [Source]
- Tool input schema error: from v2.1.300 Claude Code retries without the rejected tool's parameters. [line 2497] [Source]
- Console sign-in cloud session error added to the lookup table. [line 218] [Source]
fast-mode [Source]
- Now covers Claude Opus 5.5 (available) plus Opus 5 and Opus 4.8 (research preview). Opus 5 and 4.8 on Console need provisioned access, and Opus 5.5 depends on usage tier. [lines 7-148] [Source]
- Console admins enable fast mode in Claude Code preferences. Rate limits are separate from standard Opus. [lines 145-202] [Source]
feature-availability [Source]
github-actions [Source]
github-enterprise-server [Source]
- New troubleshooting for "Connection test passed, but a second test failed/could not run" (allow Anthropic's outbound IPs). [line 220] [Source]
iam [Source]
- Same login-code and
forceLogin*deployment notes as the authentication page. [lines 16-182] [Source]
ide-integrations [Source]
- Same VS Code changes as the vs-code page (command menu, Thinking switch, worktree banner, Focus view shortcut,
sessionURI parameter, new error). [lines 132-925] [Source]
interactive-mode [Source]
- Background commands can be disabled with
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1(also removes Ctrl+B). [line 331] [Source]
managed-settings [Source]
- New section "Which managed source supplies login keys":
forceLoginOrgUUID,forceLoginMethodand gateway login keys come from the MDM policy or managed file ahead of remote settings. [line 181] [Source] - Merge table gained "highest-ranked source only" and "login keys" rows. [lines 207-209] [Source]
mcp [Source]
- Removing a remote server also deletes stored OAuth tokens and client registration (tokens are not revoked at the issuer). [line 241] [Source]
- New
✘ Blocked by enterprise managed policyserver status. [line 254] [Source] CLAUDE_CODE_DISABLE_BACKGROUND_TASKSturns off automatic backgrounding. [line 471] [Source]- Environment variable expansion rewritten:
${VAR}and${VAR:-default}incommand,args,env,url,headers; new section on empty-string variables. [lines 828-855] [Source] - New section on OAuth for servers behind an authenticating proxy (v2.1.299+). [line 1142] [Source]
- Tool input schema handling: tools breaking API rules are excluded, a new "Tools whose input schema the API refuses" section (v2.1.300+ retries without parameters), and behavior when feature flags are unavailable. [lines 1555-1575] [Source]
- New "Change the description length limits" via
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH. [line 1731] [Source]
mcp-quickstart [Source]
model-config [Source]
CLAUDE_CODE_EFFORT_LEVEL=auto(orunset) makes Claude Code send no effort level so the API default applies. New "Send no effort level" section describing/effort statusoutput. [lines 688-726] [Source]
monitoring-usage [Source]
- API request events now include
cache_creation_5m_tokensandcache_creation_1h_tokens. [line 860] [Source]
plugin-marketplaces [Source]
plugins [Source]
- Claude Code adds the official marketplace on first interactive start unless managed policy prevents it. The official tier covers
claude-plugins-officialand related names. [lines 65-87] [Source]
plugins/anthropic-marketplaces [Source]
- Reduced from three to two marketplaces: official (
claude-plugins-official) and community (claude-community), compared in a table. [lines 5-27] [Source] - The
claude-code-pluginsmarketplace is deprecated.ralph-wiggumis nowralph-loop, andclaude-opus-4-5-migrationis retired. [line 36] [Source] - The community marketplace must be added with
/plugin marketplace add anthropics/claude-plugins-community. [line 68] [Source]
plugins/cli-reference [Source]
claude plugin validatenow emits README "Advice" when a plugin README lacks an install line. It is exposed asadvicein--jsonoutput, doesn't change the exit code, and has a newcontentsdescription. [lines 637-680] [Source]
plugins/create [Source]
plugins/create-marketplace [Source]
plugins/install [Source]
#refpinning for GitHub marketplaces, plus a link to Anthropic's marketplaces. [lines 192-382] [Source]
plugins/mods/api [Source]
- A foreground Bash/PowerShell command from
$.tool.callthat was already running when the user stopped the turn is stopped at its timeout. [line 337] [Source]
plugins/overview [Source]
- Same official-marketplace auto-add and tier notes as the plugins page. [lines 65-87] [Source]
plugins/publish [Source]
- Pick a marketplace name other authors are unlikely to choose, since users can't have two marketplaces with the same name. [line 95] [Source]
plugins/security [Source]
self-hosted-environments-configuration [Source]
- New "Stop or restart the orchestrator" section:
--shutdown-drain-seclets runningspawn-runnerhooks finish onSIGTERM(v2.1.299+), with sizing guidance for stop timeouts and systemdKillMode. [lines 456-488] [Source] - Runner examples now pass
--base-dir '<writable-dir>'. [lines 17-20] [Source]
self-hosted-environments-deploy [Source]
- Runner shutdown timing: runners log how long they need after
SIGTERM, withterminationGracePeriodSecondsandstop_grace_periodguidance. [line 582] [Source] - New troubleshooting for runner not appearing, log redirection,
was paused or too slowandNobody can read this process's stdout anymore. [lines 841-909] [Source]
self-hosted-environments-quickstart [Source]
- Minor example update for the
--base-dirflag.
self-hosted-environments-reference [Source]
server-managed-settings [Source]
- First-party sign-in keys (
forceLoginOrgUUID,forceLoginMethod"claudeai"/"console") are exceptions to the no-merge rule. [line 153] [Source]
settings-reference [Source]
- Idle compaction conditions refined (session types, about an hour idle with the computer awake) and how to turn it off. [lines 2423-2474] [Source]
- Managed merge behavior: keys read from the highest-priority source only, and login-key lookup. [lines 5584-5595] [Source]
skills [Source]
- New troubleshooting:
<and>in skilldescription/when_to_usedisplay as</>; use square brackets orargument-hint. [line 1228] [Source] - "No shell command was run" explanation for dynamic context commands. [line 779] [Source]
slash-commands [Source]
- Same skills changes (angle-bracket display issue, "No shell command was run"). [lines 779-1228] [Source]
troubleshoot-install [Source]
- Rewrote the browser-login fallback as three steps (copy URL, sign in, paste code). Added a WSL2
BROWSERexample. [lines 1168-1196] [Source]
vs-code [Source]
- New command menu (
/) and a Thinking switch. Thinking blocks showing only a label needshowThinkingSummaries. [lines 132-190] [Source] - New section on reopening a conversation that moved into a worktree. [line 583] [Source]
- New "Toggle Focus view" shortcut. The URI handler's
sessionparameter supports worktree sessions in v2.1.300+. [line 642] [line 688] [Source] - Linked the new "program for this computer could not be found" error. [line 925] [Source]
worktrees [Source]
--worktreereuses an existing worktree of the same name. New troubleshooting forCan only use --worktree in a git repositoryandbelongs to a different repository/is a leftover worktree. [line 213] [lines 352-366] [Source]
API changes
New Documents
No new documents.
Changed documents
Most feature pages below also gained the new featureMetadata front matter and an Availability section (API support for the Messages API and Managed Agents, platform status, required beta headers, and ZDR/HIPAA data handling). Only pages with other substantive edits are described in detail.
about-claude/models/optimizing-for-cost-and-intelligence [Source]
- New measurement of Claude Haiku 5.5 subagents under Opus 5.5 on an internal coding benchmark in Managed Agents: about 30% lower cost per attempt with 3-4 points fewer passes, an alternative to lowering effort rather than better. [lines 598-1074] [Source]
- Advice to judge pairings on your own workload; removed the Haiku 5.5 worker note. [lines 533-590] [Source]
about-claude/pricing [Source]
agents-and-tools/tool-use/advisor-tool [Source]
- The single executor/advisor compatibility table became per-executor-model lists of supported advisor models. Added Availability (beta on Claude API, AWS, Google Cloud Anthropic managed), beta header, and ZDR info. [lines 1814-2053] [Source]
api/errors [Source]
- Messages and Token Counting request size limit raised from 32 MB to 128 MB on the first-party API. [lines 45-54] [Source]
api/overview [Source]
- Request limit now 128 MB for the first-party API. Claude Platform on AWS, Google Cloud (Anthropic managed) and Microsoft Foundry have their own Messages/Token Counting limits (32 MB). [lines 106-118] [Source]
api/opentelemetry/spans [Source]
- Availability metadata added (beta across all platforms). API spans for any cloud-platform request lack
server.address,server.portandurl.full. [lines 12-87] [Source]
api/service-tiers [Source]
- Marked service tiers as legacy and added an Availability section. [lines 7-252] [Source]
build-with-claude/batch-processing [Source]
- The Data retention section (29 days, not ZDR eligible) moved into the new Availability / Data handling section. [lines 1821-1865] [Source]
build-with-claude/compaction [Source]
- Comparison table and links now point to each compaction page's "API support" section instead of "Compatibility". The same Availability restructuring applies to the on-demand, background, keep-recent-turns, thinking-blocks and threshold pages. [lines 17-45] [Source]
build-with-claude/effort [Source]
- Per-model recommendations consolidated under one "Recommended effort levels" heading, ordered newest first, with links to each model's overview and prompting guide. Opus 4.7's table became a list. [lines 253-362] [Source]
- Effort is documented as always on for both the Messages API (
output_config.effort) and Managed Agents (efforton the model object). [lines 37-40] [line 698] [Source]
build-with-claude/fast-mode [Source]
- Reorganized: "Supported platforms" and "Model availability" merged into Availability with Messages API and Managed Agents support, and Pricing moved to the end. Documents Opus 5.5 on Claude API, Google Cloud (Anthropic managed) and Microsoft Foundry (hosted on Azure). Opus 5 and 4.8 remain research preview and require the
fast-mode-2026-02-01beta header. [lines 7-24] [lines 659-727] [Source]
build-with-claude/fallback-credit [Source]
- Added availability: beta on Claude API, AWS, Bedrock, Google Cloud and Foundry. On Bedrock and Google Cloud the token is bound to the caller identity and
allowed_fallback_modelsisn't exposed. [lines 7-629] [Source]
build-with-claude/overview [Source]
- Features overview reorganized (large rewrite of the feature tables, now split into platform and model-level groups to match the data retention page).
manage-claude/api-and-data-retention [Source]
- The single ZDR/HIPAA feature table was split into groups following the Features overview, starting with "Platform features". In Managed Agents no feature is ZDR or HIPAA eligible. The advisor tool is now ZDR eligible. [lines 154-220] [Source]
manage-claude/inference-hooks-configuration [Source]
- New "Inspect only selected roles" option. Turn on Limit by role and set Inspect to Only selected roles to pilot Inference hooks on part of the organization. Exclusions moved under Who is inspected, and changes are logged in the Activity Feed. [lines 108-125] [Source]
managed-agents/budgets [Source]
- Availability section added (session budgets in beta). The same metadata and Availability additions apply across the Managed Agents pages (agent-setup, dreams, environments, memory, multiagent-orchestration, scheduled-deployments, self-hosted-sandboxes, tools, vaults, webhooks, workflow-runs and others). [line 447] [Source]
test-and-evaluate/strengthen-guardrails/handle-streaming-refusals [Source]
- Streaming refusals are always on in both the Messages API (
stop_reason: "refusal"withstop_detailsonmessage_delta) and Managed Agents (session goes idle withstop_reason.type"refusal"). New Availability section lists models and platforms. [lines 7-45] [line 357] [Source]
Availability-section-only updates
The following pages gained the standardized featureMetadata and Availability section without other substantive changes: agents-and-tools/agent-skills/overview, mcp-connector, mcp-tunnels/overview, and the tool-use pages (bash, browser-use, code-execution, computer-use, define-tools, fine-grained-tool-streaming, memory, parallel-tool-use, programmatic-tool-calling, strict-tool-use, text-editor, tool-runner, tool-search, web-fetch, web-search). Also in this group are build-with-claude/cache-diagnostics, citations, context-editing, extended-thinking, files, mid-conversation-system-messages, multilingual-support, pdf-support, preserved-thinking, prompt-caching, refusals-and-fallback, search-results, streaming, structured-outputs, task-budgets, thinking, token-counting, vision and working-with-messages. The rest of the group is cli-sdks-libraries (apple-foundation-models, openai-sdk, middleware), manage-claude (data-residency, opentelemetry, opentelemetry/api, opentelemetry/sdk) and the remaining managed-agents pages.