Claude docs changes for October 25th, 2026 [diff]
Executive Summary
- Mods get a new
settings.readhook that can change or refuse Claude Code's merged settings, plus$.settings.read({ source, key }), newkeyrules for controls, andclaude -prefusal reasons - Code Review's
REVIEW.mdcan now@-include a repository skill'sSKILL.md, with detailed rules for what a review does and doesn't take from a skill - The Agent SDK adds
setMcpPermissionModeOverride(),seedReadState(), andbackgroundTasks()onQuery, plus new model-refusal and control-request progress messages - Self-hosted environments gain guidance on memory and process limits, releasing idle sessions, proxy handling of the session event stream, and fixes for re-opened sessions that stay queued
- Desktop SSH remote sessions now support the Windows OpenSSH client and
MaxSessions 1servers, and cloud sessions and scheduled tasks have new UI flows (Changes card, archived tab, full-page form, "The last run" warnings)
New Claude Code versions
No new Claude Code versions in this update.
Claude Code changes
New Documents
No new documents.
Changed documents
agent-sdk/hooks [Source]
- A timed-out
PreToolUsecallback no longer hides a deny from another hook: the tool result carries that hook's reason, and the timeout text can follow it. [lines 760-762] [Source]
agent-sdk/typescript [Source]
getSessionMessageshas a newoptions.includeSystemMessagesoption, and returned messages can havetype: "system". [lines 308-314] [Source]- New
QuerymethodsetMcpPermissionModeOverride(serverName, mode)applies a stricter permission mode ('default'or'auto') to one MCP server's tools. It works only inbypassPermissionsorautosessions and in streaming input mode. [lines 683-704] [Source] - New
seedReadState(path, mtime)marks a file as already read so a later Edit doesn't fail withFile has not been read yet. [lines 706-712] [Source] - New
backgroundTasks(toolUseId?)moves running Bash commands and subagents to the background, like Ctrl+B. [lines 714-725] [Source] SDKMessageaddsSDKControlRequestProgressMessage,SDKModelRefusalFallbackMessage, andSDKModelRefusalNoFallbackMessage. [lines 1518-1531] [Source]- Success results gain a
time_to_request_msfield. [line 1757] [Source]
channels-reference [Source]
- Added a third reason a remote permission reply is ignored: an earlier prompt in the session used the same ID, so Claude Code drops any channel verdict carrying it. [lines 581-585] [Source]
claude-apps-gateway [Source]
- Reworked the explanation of
disableAllHooks: trueinmanagedSettings: lists which hooks stop and which keep running, and states thathooks,allowedHttpHookUrls, andhttpHookAllowedEnvVarsare ignored there. [lines 457-469] [Source]
claude-code-on-the-web [Source]
- Diff review now starts from the Changes card in the session panel, which appears after Claude pushes to a branch. The panel can be reopened from the title bar. [lines 246-255] [Source]
- Archiving, finding archived sessions (new Archived tab at claude.ai/code/sessions), unarchiving, and deleting were rewritten for the new menus. [lines 318-330] [Source]
- Auto-fix is now toggled from the pull request's ⋮ menu in the Changes card. [lines 344-349] [Source]
- New troubleshooting entries: "Your new session couldn't start" and "Can't rewind to this message" (self-hosted runners before v2.1.246). [lines 389-394] [Source]
- Custom-role note clarified: the cloud sessions permission is needed to start sessions from the browser, apps, or terminal. [line 7] [Source]
claude-projects [Source]
- A local session connected through Remote Control can now be brought into a project from the claude.ai/code sidebar menu, with caveats for Require trusted devices. [lines 110-125] [Source]
cloud-environments [Source]
- Setup scripts run before the environment's variables are set, so they must set any values they need themselves (now four constraints). [lines 442-447] [Source]
code-review-customize [Source]
- New section "Include a skill file":
@.claude/skills/<folder>/SKILL.mdin the rootREVIEW.mdincludes a skill. Covers path, size (30,000 bytes), count (eight), symlink and protected-branch rules, what a review gets from a skill (body only, no!commands, substitutions, or supporting files), and character substitutions. [lines 129-188] [Source] - Exclusions and Nit caps must live in
REVIEW.mdor a file beside it, not in an included skill. [line 199] [Source]
code-review-pull-requests [Source]
- Explains the two sentences a re-review uses to count findings it left out. [lines 151-154] [Source]
code-review-troubleshooting [Source]
- Added the "include line(s) in the root REVIEW.md were skipped" check run message, and a note about left-out findings when a review finds no issues. [line 74] [Source]
desktop [Source]
- SSH remote sessions: servers with
MaxSessions 1now work on macOS/Linux with Desktop v3.1623.0 or later and with the Windows OpenSSH client, with notes on login prompts and!commands. [lines 983-988] [Source] - Windows can now use
%USERPROFILE%\.ssh\configthrough the OpenSSH client (Desktop v2.2553.0+, OpenSSH 9.4+, non-Store install). New section on connecting on Windows without the OpenSSH client and its limits. [lines 1032-1067] [Source] - Rejoining a running SSH task after quit or restart now works on Windows from v3.1623.0. Updated guidance for long tasks and the
Restarting Claude Code on <host>…state. [lines 1269-1352] [Source]
desktop-changelog [Source]
- Same updates as
desktop(SSHMaxSessions 1, Windows OpenSSH client, rejoining tasks). [lines 983-1067] [Source]
desktop-scheduled-tasks [Source]
- Accounts that show Routines instead of Scheduled are covered, and a new "Full-page form" section describes the Local/Cloud menu and the New local routine page. [lines 14-117] [Source]
errors [Source]
- New entries:
MCP server "<name>" is disabled,git is not installed on this Mac, and twoSandbox is requiredmessages. [lines 316-351] [Source] - The
Waiting for API responsebanner behind a gateway now appears after 45 seconds (was 20) from v2.1.309. [lines 491-501] [Source] - Disk-full error guidance consolidated for the quota and inode messages. [lines 4786-4796] [Source]
fast-mode [Source]
- Availability-check troubleshooting split into one section per message (network connectivity, currently unavailable, disabled by your organization), with the right skip variable for each. [lines 154-171] [Source]
hooks [Source]
- Windows without Git Bash: reorganized fixes, and a new "PowerShell started no program" section for a
commandthat is only quoted strings. [lines 960-981] [Source] - New note: pressing
Escduring a prompt check stops it, but a block issued at the same moment still stands. [lines 1482-1487] [Source] - A plugin's
WorktreeCreatehook doesn't run with--worktreeplus--tmux. Define it in a settings file instead. [lines 3140-3144] [Source]
hooks-guide [Source]
- Multiple
PreToolUsehooks returningupdatedInputare not merged, and which rewrite wins isn't guaranteed. [line 953] [Source]
interactive-mode [Source]
- The diff panel keeps its last-read state during an unfinished merge, rebase, cherry-pick, or revert. [lines 658-659] [Source]
llm-gateway-connect [Source]
- New
/fastrow for "currently unavailable" with a gateway-issuedANTHROPIC_API_KEY. [lines 518-520] [Source]
llm-gateway-protocol [Source]
- Claude Code (v2.1.310+) also retries without
effortwhen the upstream rejects theeffort-2025-11-24beta value withUnexpected value(s). [lines 237-241] [Source]
model-config [Source]
- Allowlist matching details: Google Cloud Agent Platform IDs with an
@date need the date in the entry, and[1m]suffixes are stripped before matching. [lines 946-952] [Source]
monitoring-usage [Source]
- For Desktop SSH sessions, set variables under
envin the remote machine's managed settings file instead of login files.precompute_reusescope clarified. [lines 469-1402] [Source]
network-config [Source]
- New "Cloud provider and LLM gateway routing" heading. Fast mode behind a gateway needs
api.anthropic.comreachable through the proxy. [lines 239-243] [Source]
plugins-reference [Source]
- Monitors don't start with
-p. On Windows,${CLAUDE_PLUGIN_ROOT}keeps backslashes in exec-form and PowerShell hooks. [lines 154-605] [Source]
plugins/components [Source]
- Monitor availability reworked: on Bedrock, AWS, Agent Platform, Foundry, or with telemetry off, monitors need v2.1.310 or later. [lines 583-585] [Source]
plugins/mods/api [Source]
- New section "Calls refused in
claude -pruns and Agent SDK sessions": refusal reasons (--max-turns,--max-budget-usd, input ended, interrupted) and fixes. [lines 340-364] [Source] - Explains why a
claude -prun with a mod that submits prompts every turn never exits, and how to bound it. [lines 366-378] [Source] $.settings.read()accepts{ source }and{ key }(key requires v2.1.304+). [lines 414-452] [Source]
plugins/mods/events [Source]
- New
settings.readhook section coveringe.layers,e.source, returning{ value }or{ deny }, distinguishing Claude Code's own read vianext.origin, and an example. [lines 312-373] [Source] - A hook that throws or times out is skipped and the action proceeds. Add a
.catchhandler to refuse instead. [lines 114-216] [Source]
plugins/mods/gallery [Source]
Imagecan now draw inside tmux 3.3+ (Claude Code v2.1.310+), with a requirements checklist and the tmux options to set. File-path sources fail in tmux like iTerm2. [lines 352-381] [Source]
plugins/mods/interface [Source]
- New "Which controls need a
key": everyInputandSelectneeds one, and aButtonfalls back to its label. [lines 507-516] [Source]
plugins/mods/reference [Source]
- Added the
settings.readevent and its fields.typescan be omitted from the manifest from v2.1.299. [lines 20-128] [Source]
plugins/mods/troubleshoot [Source]
- New entries: "This mod's change didn't load",
needs a key/is drawn twice/key each once, andsettings.readproblems (key has no effect, value the key can't hold, refused to the engine). [lines 167-342] [Source]
plugins/troubleshooting [Source]
- Marketplace clones turn off git prompts and askpass programs (including
GIT_ASKPASS) and run SSH in batch mode. New test command:git -c core.askPass= ls-remote <url>. [lines 250-255] [Source] - Forward-slash plugin root paths apply only to hooks that run through Git Bash. [lines 978-980] [Source]
remote-control [Source]
- New troubleshooting entry for "Remote Control disconnected" / "Can't reach". [lines 400-407] [Source]
routines [Source]
- New "Full-page form" for creating tasks, a cron time-zone note (UTC unless
CRON_TZ=), an Issue GitHub event category, and run outcomes (Succeeded, Failed, Cancelled). [lines 65-333] [Source] - New troubleshooting table of "The last run" warnings and what to do for each. [lines 503-517] [Source]
sandboxing [Source]
- New troubleshooting for
Sandbox is requiredrefusals whensandbox.failIfUnavailableis set. Excluded commands and!commands keep running, anddangerouslyDisableSandboxretries are ignored. [lines 1008-1022] [Source] - New section on when the sandbox deletes a newer top-level
HEAD,objects, orrefs, and why anobjectsorrefsfolder can disappear (fixed for folders with contents in v2.1.307). [lines 538-558] [Source] - Leftover placeholder files can also remain when a session exits while a background sandboxed command runs. [lines 900-910] [Source]
self-hosted-environments-configuration [Source]
- New
CLAUDE_CODE_REMOTE_SLACK_CHANNEL_IDvariable for Claude Tag sessions. [line 35] [Source] - New "Fix
Argument list too longat session start" for joined--append-system-promptarguments over 128 KB on Linux. [lines 89-108] [Source] spawn-runnerhook: after 10 failed requests in a row the session is blocked. New section on re-opened sessions that stay Queued or show Failed when the hook keys on the session ID. [lines 328-372] [Source]- New section on stopping sessions that fail to fetch server-managed settings with
forceRemoteSettingsRefresh, with Claude Tag and Bedrock caveats. [lines 794-814] [Source]
self-hosted-environments-deploy [Source]
- New section on adding github.com repositories to Claude Tag channel sessions (GitHub App, link the org, grant the repository). [lines 312-331] [Source]
- New sizing guidance: several runners per host, per-session memory limits, and process/thread limits with a step-by-step way to measure one session's peak. [lines 395-477] [Source]
- Pre-warmed checkout: clone depth guidance and a way to confirm the runner uses your clone. [lines 675-690] [Source]
- New "Release idle sessions on a fixed fleet" for queued sessions caused by idle ones. [lines 713-729] [Source]
- New section on proxies that buffer the session event stream, so Claude never answers the first message, with log lines to confirm the cause. [lines 916-952] [Source]
self-hosted-environments-reference [Source]
- New "Session startup timeout" section. Runners from v2.1.299 through v2.1.308 could release a session mid-turn. Update to v2.1.309 or later. [lines 51-66] [Source]
- Prometheus alert rules aggregate by namespace, and there is a new cost-per-idle-session query joining on
ccr_session_id. [lines 259-392] [Source]
settings-reference [Source]
- Sandbox filesystem wildcard rules rewritten as a table of what works on macOS versus Linux/WSL2, plus guidance for directory names with brackets, braces, or parentheses. [lines 1370-1403] [Source]
sandbox.failIfUnavailable: if the sandbox fails after startup, the session continues and sandboxed commands are refused. [line 1229] [Source]idleCompactionnow also applies to the VS Code chat panel and Desktop Code tab for accounts Anthropic selects, with new notices and a new subsection. [lines 2414-2476] [Source]availableModelsMatch: "exact"also permits an entry's dated Anthropic ID. [line 332] [Source]allowManagedHooksOnlyalso blocks monitors from plugins that aren't force-enabled (v2.1.310+).disableAllHooksinmanagedSettingsis described by what stops and what keeps running. [lines 3537-3564] [Source]
terminal-config [Source]
- tmux setup adds
set -g focus-events onand notes the extra requirements for drawing modImageelements. The tab title omits the status glyph in terminals that report protocol support. [lines 120-137] [Source]
tools-reference [Source]
- Monitor tool availability: v2.1.310 or later is needed on third-party providers or with telemetry off, and Windows needs Git Bash. [lines 382-386] [Source]
ultrareview [Source]
web-quickstart [Source]
- Diff review and PR creation now go through the Changes card. Right-click Create PR to choose Create draft PR. [lines 176-193] [Source]
web-scheduled-tasks [Source]
- Same updates as
routines: full-page form, cron time zone note, Issue event category, run outcome definitions, and "The last run" warnings table. [lines 65-517] [Source]
API changes
New Documents
No new documents.
Changed documents
No changed documents.