Claude docs changes for October 25th, 2026 [diff]

Executive Summary

  • Mods get a new settings.read hook that can change or refuse Claude Code's merged settings, plus $.settings.read({ source, key }), new key rules for controls, and claude -p refusal reasons
  • Code Review's REVIEW.md can now @-include a repository skill's SKILL.md, with detailed rules for what a review does and doesn't take from a skill
  • The Agent SDK adds setMcpPermissionModeOverride(), seedReadState(), and backgroundTasks() on Query, 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 1 servers, 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 PreToolUse callback 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]

  • getSessionMessages has a new options.includeSystemMessages option, and returned messages can have type: "system". [lines 308-314] [Source]
  • New Query method setMcpPermissionModeOverride(serverName, mode) applies a stricter permission mode ('default' or 'auto') to one MCP server's tools. It works only in bypassPermissions or auto sessions 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 with File 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]
  • SDKMessage adds SDKControlRequestProgressMessage, SDKModelRefusalFallbackMessage, and SDKModelRefusalNoFallbackMessage. [lines 1518-1531] [Source]
  • Success results gain a time_to_request_ms field. [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: true in managedSettings: lists which hooks stop and which keep running, and states that hooks, allowedHttpHookUrls, and httpHookAllowedEnvVars are 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.md in the root REVIEW.md includes 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.md or 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 1 now 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\config through 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 (SSH MaxSessions 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 two Sandbox is required messages. [lines 316-351] [Source]
  • The Waiting for API response banner 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 command that is only quoted strings. [lines 960-981] [Source]
  • New note: pressing Esc during a prompt check stops it, but a block issued at the same moment still stands. [lines 1482-1487] [Source]
  • A plugin's WorktreeCreate hook doesn't run with --worktree plus --tmux. Define it in a settings file instead. [lines 3140-3144] [Source]

hooks-guide [Source]

  • Multiple PreToolUse hooks returning updatedInput are 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 /fast row for "currently unavailable" with a gateway-issued ANTHROPIC_API_KEY. [lines 518-520] [Source]

llm-gateway-protocol [Source]

  • Claude Code (v2.1.310+) also retries without effort when the upstream rejects the effort-2025-11-24 beta value with Unexpected 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 env in the remote machine's managed settings file instead of login files. precompute_reuse scope clarified. [lines 469-1402] [Source]

network-config [Source]

  • New "Cloud provider and LLM gateway routing" heading. Fast mode behind a gateway needs api.anthropic.com reachable 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 -p runs and Agent SDK sessions": refusal reasons (--max-turns, --max-budget-usd, input ended, interrupted) and fixes. [lines 340-364] [Source]
  • Explains why a claude -p run 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.read hook section covering e.layers, e.source, returning { value } or { deny }, distinguishing Claude Code's own read via next.origin, and an example. [lines 312-373] [Source]
  • A hook that throws or times out is skipped and the action proceeds. Add a .catch handler to refuse instead. [lines 114-216] [Source]

plugins/mods/gallery [Source]

  • Image can 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": every Input and Select needs one, and a Button falls back to its label. [lines 507-516] [Source]

plugins/mods/reference [Source]

  • Added the settings.read event and its fields. types can 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, and settings.read problems (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 required refusals when sandbox.failIfUnavailable is set. Excluded commands and ! commands keep running, and dangerouslyDisableSandbox retries are ignored. [lines 1008-1022] [Source]
  • New section on when the sandbox deletes a newer top-level HEAD, objects, or refs, and why an objects or refs folder 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_ID variable for Claude Tag sessions. [line 35] [Source]
  • New "Fix Argument list too long at session start" for joined --append-system-prompt arguments over 128 KB on Linux. [lines 89-108] [Source]
  • spawn-runner hook: 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]
  • idleCompaction now 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]
  • allowManagedHooksOnly also blocks monitors from plugins that aren't force-enabled (v2.1.310+). disableAllHooks in managedSettings is described by what stops and what keeps running. [lines 3537-3564] [Source]

terminal-config [Source]

  • tmux setup adds set -g focus-events on and notes the extra requirements for drawing mod Image elements. 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]

  • Pressing Enter at the trust question also exits with code 1. [line 175] [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.