Claude docs changes for October 7th, 2026 [diff]
Executive Summary
- Claude Code 2.1.292 adds an
effortparameter to the Agent tool,claude plugin install --marketplace, and new mod hooks (prompt.autocomplete, prompt caching in$.model.complete), plus many security and permission fixes (UNC path reads, sandbox read-deny paths, tampered managed-settings cache) - New Managed Agents page on restricting
web_searchandweb_fetchdomains per tool, with content caps and search localization - Admin API moved out of beta: SDKs now use
client.organizationand the CLI usesant organizationinstead of thebetanamespace - New "Map egress paths to managed controls and events" guide, a retention-sweep verification guide, and HIPAA-configuration notes for permission modes and gateways
- Compliance API documents two new errors for very large local session transcripts, and inference hooks docs add a detailed error table
New Claude Code versions
2.1.292
New features
- Added
--marketplace <source>toclaude plugin install: adds the marketplace if needed (under the same policy checks asmarketplace add), then installs the plugin - Added an
effortparameter to the Agent tool so Claude can run a sub-agent at a chosen effort level - Added
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MSto set a longer base backoff delay when retrying overloaded (529) requests - Mods: added the
prompt.autocompleteevent, prompt caching for$.model.complete(cache: trueon a block), and workflow agents in theagent.spawnhook - Claude Tag: Edit button for the Allowed domains card; Code Review analytics now shows period totals and a per-repository breakdown
Existing feature improvements
- Faster startup of
claude -pand SDK sessions: the first turn no longer waits for HTTP/SSE MCP servers to answerresources/list - Much faster rendering of long bulleted or numbered replies
- Local (stdio) MCP servers now negotiate protocol version 2026-07-28 by default on every install (
MCP_PROTOCOL_NEGOTIATION=legacyopts out); servers that are slow to connect are remembered for 7 days - Hook output has
<system-reminder>tags escaped; Grep acceptsfile_pathforpath, and Write, WebFetch and Read ignore stray parameters - Sandbox auto-allow now runs interpreter commands with an env var prefix (
FOO=bar python3 app.py) unprompted under strict sandbox mode - Artifact tool lists up to 200 artifacts (was 50); scheduled and Run now routine runs publish private artifacts without approval
- Agent names are limited to 256 characters
claude plugin testnow fails on a failedexpector a refused stub answer instead of passing silently- Ctrl+C draft recovery keeps a cleared prompt reachable with Up
Major bug fixes
- Security: PreToolUse hook approvals and auto mode no longer bypass the permission prompt for reads from network (UNC) paths
- Fixed sandboxed commands being able to read staged
/ultrareviewuploads, and managed sandbox read-deny paths that change mid-session not dropping project grants - Fixed a tampered on-disk cache of server-managed settings being able to disable the built-in policy plugin, and notebook/PDF reads on macOS and Windows returning files outside what was approved
- Fixed subagents with
permissionMode: autoentering auto mode when it is unavailable - Fixed
NO_PROXYbeing ignored for Claude Code's own API requests whenHTTPS_PROXYis set - Fixed an MCP tool name longer than 128 characters making every request fail
- Fixed plan mode not being restored on
claude --resume//resume, and scheduled tasks//loopwakeups being lost after resume, crash or restart - Fixed
claude -pstopping background commands 5 seconds after the final result and dropping scheduled wakeups - Fixed Read returning only the first entry for a PDF
pageslist like "6,9,15", and @-mentioned files over 256KB being silently left out - Fixed multiple mod/plugin hook issues (denials after
next(e),tool.checkallow skipping dialogs, hooks worker restarts bypassing permission hooks)
Claude Code changes
Changed documents
agent-sdk/hooks [Source]
WorktreeRemovenow fires only for a worktree that aWorktreeCreatehook created. [line 167] [Source]
agent-sdk/typescript [Source]
- Example now wraps the claimed query loop in try/catch because a refused claim throws after yielding the error result. [lines 157-165] [Source]
setMcpServers()now only replaces the servers it manages (added through it and in-process SDK servers), with new rules for servers the call doesn't name. [line 635] [lines 5028-5029] [Source]ReportFindingslevelis now optional and not compared with the level the review ran at. [lines 3432-3434] [Source]
claude-apps-gateway-deploy [Source]
- New guidance that the gateway needs real PostgreSQL and
store.postgres_urltakes a single host (use a load balancer or managed endpoint for multi-node databases). [lines 212-216] [Source] - New troubleshooting row for an unparseable
store.postgres_url. [line 348] [Source]
claude-directory [Source]
- Link to the new "Check the retention sweep" guide. [line 1352] [Source]
- Purge command: success is indicated by the
Purged N item(s)line, and.heapsnapshotfiles from/heapdumpmust be deleted separately. [lines 1463-1465] [Source] AGENTS.mdis read in place of aCLAUDE.mdrather than alongside it. [line 1217] [Source]
cli-reference [Source]
- Added
claude daemon logsandclaude daemon runfor the background-session supervisor. [lines 28-29] [Source]
env-vars [Source]
- Added
CLAUDE_CODE_PLUGIN_DIR_WATCHto control reloading of mods loaded with--plugin-dir. [line 337] [Source] CLAUDE_CODE_SUBPROCESS_ENV_SCRUBnotes: before v2.1.251 the scrub removed onlyANTHROPIC_API_KEYandAWS_SECRET_ACCESS_KEY. [lines 518-542] [Source]
errors [Source]
- Output-content-filter blocks that arrive before any text or tool call are now retried once. [line 381] [Source]
- New entry for
Cloud sessions need a claude.ai sign-in. [line 192] [Source] - Image limit corrected: 3000 pixels when more than 20 images are in context. [line 2161] [Source]
hooks [Source]
WorktreeRemoveclarified: fires only for worktrees created by aWorktreeCreatehook (no longer for subagent isolation). [line 54] [lines 2975-2978] [Source]
keybindings [Source]
- Footer context: Ctrl+P/Ctrl+N added for up/down, and new
footer:close(x) action stops or dismisses an agent or workflow row. [lines 264-268] [Source]
llm-gateway-connect [Source]
- Desktop app SSH sessions are now available in beta with a gateway configuration (Desktop v1.40609.0+), controlled by an
sshHostAllowlist; the gateway must not be atlocalhost. [lines 179-186] [Source]
llm-gateway-rollout [Source]
- New section: gateway sessions aren't eligible for the HIPAA configuration; lists managed keys to restrict features and what they don't cover. [lines 191-201] [Source]
managed-mcp [Source]
- URL patterns without a port now match only the default port (443/80) when the hostname has no
*, and every port when it does; new examples for explicit ports and fordeniedMcpServersentries. [lines 296-318] [line 484] [Source]
monitoring-usage [Source]
- New section "Map egress paths to managed controls and events", pairing each path (Bash, MCP, hooks, plugins, WebFetch, Artifact, Remote Control, transcript retention) with managed settings keys and telemetry events. [lines 1476-1518] [Source]
- New section "Check the retention sweep" explaining how to interpret the
retention_sweepevent. [lines 1502-1520] [Source] files_past_cutoffalso counts staleskills/synced/andplugins/synced/folders. [line 1291] [Source]
permission-modes [Source]
- With the HIPAA configuration applied, sessions start in default (Manual) mode instead of auto; auto mode and
bypassPermissionsremain available and can be disabled via managed settings (v2.1.285+). [line 82] [lines 121-135] [Source]
plugins/mods/reference [Source]
- Added the
prompt.mentionevent (v2.1.290+) to redirect or deny reading an @-mentioned file. [line 67] [Source] - New "Box border styles" table listing valid
borderStylenames (an invalid name draws no border). [lines 235-255] [Source] - Text limits relaxed:
Code/Markdownno longer capped at 10,000 characters; first 100,000 characters of text in one tree are drawn. [lines 224-225] [Source] engine.create: only mods outside theusertier can withhold a namespace. [line 139] [Source]
quickstart [Source]
- Restructured: login merged into "Start your first session" (steps reduced from 8 to 7), added a list pointing to other pages for terminal beginners and other surfaces, removed the auto-mode default paragraph, and converted the "next steps" cards to a list. [lines 1-20] [lines 84-110] [Source]
sandboxing [Source]
- Notes that background sessions sandbox Bash commands per their own settings, and how to wrap the whole process in the sandbox runtime. [lines 959-960] [Source]
self-hosted-environments-deploy [Source]
- Runner shutdown section rewritten into a three-step drain (wait, terminate process trees, post-session hook) with an itemized timing formula (80s at defaults) and
--retire-at/--defer-shutdown-max-minguidance. [lines 375-395] [Source] - Processes that outlive their shell command (such as daemonized services) are not signaled when a session stops. [line 14] [Source]
sessions [Source]
- A conversation that ended in plan mode now resumes in plan mode from the picker and
/resume. [lines 76-84] [Source] - Session picker:
k/jnavigate and1-9resume the session at that position. [lines 176-182] [Source]
sub-agents [Source]
- Subagent
namelimited to 256 characters; longer names are skipped. [lines 285] [line 321] [Source] - Subagent
effortdoesn't overrideCLAUDE_CODE_EFFORT_LEVEL. [line 298] [Source]
worktrees [Source]
API changes
New Documents
managed-agents/tools-web-restrictions [Source]
New Managed Agents (beta) page, split out of the tools page, describing how to restrict web_search and web_fetch per tool with allowed_domains or blocked_domains on the agent toolset's configs entries. It covers max_content_tokens, user_location, how limited environment networking also applies, changing the lists mid-session, and examples in multiple languages.
Changed documents
api/*/beta (SDK reference for Python, TypeScript, Go, Java, Ruby, PHP, C#, CLI) [Source]
- Parameter docs across beta, sessions, memory stores, vaults, environments and messages now label each parameter as a query, header, path or body parameter instead of prefixing the description (mechanical reformat).
manage-claude/admin-api [Source]
- Admin API is no longer under beta: SDKs use
client.organization(wasclient.beta.organization) and the CLI usesant organization(wasant beta:organization); reference links updated. The same change appears in wif-admin-api, workspaces, rate-limits-api, user-management and the CMEK guides. [line 29] [Source]
manage-claude/compliance-errors [Source]
- New 400 error
transcript_page_read_limit_exceeded("Transcript page too large") for local session messages, with guidance to read oldest first and use a 5-minute timeout. [lines 131-150] [Source] - New 429 error
transcript_read_server_busy(not a rate limit): wait forretry-afterand resend unchanged. [lines 450-463] [Source]
manage-claude/inference-hooks-configuration [Source]
- Endpoint URLs that are private IPs, IPv6 addresses or
localhostare rejected. [line 60] [Source] - "Validate tool calls" is on by default in new configurations. [line 92] [Source]
- New table of "Recent errors" types (
DlpWebhookTimeoutError,...StatusError,...RelayError, etc.) withwebhook_error/relay_errorcategories. [lines 118-132] [Source]
manage-claude/inference-hooks-endpoint [Source]
- Tools on local MCP servers connected directly by Claude Code are client tools named
mcp__<server>__<tool>; denies stop the call before it runs. [lines 310-313] [Source] - A third-party tool's
origincan be a private or local address; clients should tolerate new messagerolevalues. [line 283] [line 800] [Source]
managed-agents/environments [Source]
- With
limitednetworking,allowed_hostsnow also applies toweb_searchandweb_fetch; a bare hostname matches only that exact host. [lines 407-409] [line 578] [Source]
managed-agents/tools [Source]
- Web search/fetch restriction content (about 400 lines) moved to the new tools-web-restrictions page, leaving a pointer. [line 235] [Source]
build-with-claude/effort [Source]
- Per-message effort (beta) now lists supported models on the Claude API and Google Cloud (Fable 5.1, Mythos 5.1, Opus 5.5, Opus 5, Sonnet 5.5), notes it is unavailable for Opus 5 on Amazon Bedrock, and describes the 400 error without the beta header. [line 278] [lines 365-367] [Source]