Claude docs changes for October 17th, 2026 [diff]
Executive Summary
- Claude Code 2.1.302 adds
CLAUDE_CODE_AUTO_MODE_MODELto choose the client-side auto mode classifier model, plus an/configtoggle for idle compaction. - Hooks docs now spell out when a failed hook blocks an action (
onFailure: "block"), including a new section on Windows without Git Bash. - Permissions docs add precedence rules for hooks and mods in plan mode, and clearer MCP rule syntax (
mcp__<server>__*, plugin-scoped names, special characters). - Mods reference gains
Boxspacing steps andTexttypography props (size,weight,mono,tabular), withbolddeprecated in favor ofweight. - Desktop docs clarify when a long-running task survives quitting Desktop.
New Claude Code versions
2.1.302
New features
- Added
CLAUDE_CODE_AUTO_MODE_MODELto choose the model the client-side auto mode classifier uses (it doesn't affect server-side auto mode) - Added an
Idle compactionrow to/configto turn idle compaction off or on; notices after an idle compaction now say how to turn it off - Added a notice to
/design-syncand/design-loginthat standalone Claude Design closes on December 14, 2026
Existing feature improvements
- Prompt suggestions no longer spend usage credits on models your plan covers only with credits
- URLs in backticks are now one clickable link when they wrap, in terminals that support hyperlinks
claude plugin details <name>@builtinnow points to/pluginwhen the plugin isn't found
Major bug fixes
- Fixed a "Prompt is too long" error when stopping a turn during compaction
- Fixed requests failing with "diagnostics: Extra inputs are not permitted" after switching to Vertex or Bedrock mid-session
- Fixed the Read tool loading image files of any size into memory; image sources over 128 MB are now refused
- Fixed a prompt cache miss when a tool added mid-session was loaded again through ToolSearch or after compaction
- Fixed
claude pluginand other subcommands exiting before a queued settings or config write finished, which could lose the change - Fixed MCP servers showing no tools, or all tool calls failing, when the server negotiates protocol version 2026-07-28 but omits
resultType,ttlMsorcacheScope - Fixed
classifier_categorymissing from OpenTelemetrytool_decisionevents for most auto mode classifier blocks - Fixed worktree isolation failing under git 2.56 or later when a stray
.gitfile points at a missing directory
Claude Code changes
Changed documents
agent-sdk/hooks [Source]
- The
.envprotection example now compares case-insensitively, with a note that it doesn't catch Windows backslash paths orBashwrites. [lines 54-139] [Source] - The
PreToolUsetimeout behavior is described as blocking the tool call, with version notes for earlier behavior. [line 751] [Source]
agent-sdk/mcp [Source]
- Explains how server names are normalized in tool names (
.and spaces become_), with a table, and how plugin-provided servers are named. [line 171] [Source]
agent-sdk/permissions [Source]
- Plan mode: file edits aren't auto-approved even when a
PreToolUsehook returnsallow. [line 273] [Source] - New Auto mode section: switching a session in auto mode to an unsupported model drops it to
defaultmode (Claude Code v2.1.299+), and you must callset_permission_mode("auto")to return. [lines 281-291] [Source]
desktop [Source]
- Rewrote guidance on quitting Desktop during long tasks: Windows never rejoins, third-party-provider tasks started before v2.42304.0 are lost, and other tasks continue only if Desktop can rejoin the process. [lines 972-1075] [Source]
desktop-changelog [Source]
- Same rejoin-after-quit clarifications as the Desktop page. [lines 972-1075] [Source]
hooks [Source]
onFailureis reworded, and non-blocking error, JSON parse, start-failure, timeout and HTTP sections now note the exception for hooks whose failure blocks the action. [lines 443-1004] [Source]- New section "Failed hooks on Windows without Git Bash": a shell-form
PreToolUseorPermissionRequesthook that fails there can block the call, with four fixes. [lines 934-950] [Source] UserPromptSubmithooks receive a typed skill or command line (e.g./deploy staging) as typed, not the expanded content. [line 1469] [Source]permissionDecision: "allow"wording refined for actions no mode auto-approves. [line 1922] [Source]- New "PreModelSwitch timeouts and other exit codes" subsection. [line 3422] [Source]
ide-integrations [Source]
- Same changes as the VS Code page (the two files carry the same content).
network-config [Source]
- Stream timers: explains what happens when no response headers arrive (first-byte deadline vs. body idle timeout after 5-6 minutes), and that
API_TIMEOUT_MScan be lowered below 300000 to retry sooner where the first-byte deadline doesn't run. [lines 168-188] [Source]
permission-modes [Source]
- Clarified that an ignored bypass request leaves
bypassPermissionsout of theShift+Tabcycle or starts the session in Manual mode. [lines 592-594] [Source] dev-mods/in the config directory is now a protected path. [line 647] [Source]
permissions [Source]
- MCP rule syntax:
mcp__<server>__*andmcp__<server>__<tool>, with guidance for special characters, plugin-provided servers, and names containing__. [lines 526-538] [Source] - New "Precedence among rules, hooks, and mods" heading and a "Hook approvals in plan mode" section: a hook's or mod's
allowhas no effect on non-read-only calls in plan mode. [lines 580-603] [Source]
plugins/mods/create [Source]
- Approval prompts happen because the mods folder, not
~/.claude, is a protected path. [line 24] [Source]
plugins/mods/events [Source]
plugins/mods/interface [Source]
Boxspacing props accept step names, andTextaccepts typography props such asweight. [lines 426-427] [Source]
plugins/mods/reference [Source]
- New
Boxspacing steps table (xstoxl), requires v2.1.299+. [lines 300-320] [Source] - New
Texttypography propssize,weight,mono,tabular, with how the terminal and VS Code extension treat them.boldis deprecated in favor ofweight. [lines 320-340] [Source]
plugins/mods/troubleshoot [Source]
- New entry "Another mod's band shows and yours doesn't": mods share one band above the prompt, so keep
await next(e)in your tree. [lines 182-194] [Source]
sandboxing [Source]
- Auto-allow mode: commands in a form that a
Bashdeny rule matches are still blocked; critical-pathrm/rmdirchecks apply to commands recognized as targeting such a path. [lines 174-175] [Source]
vs-code [Source]
- Feature list reformatted; new guidance to run the CLI in the integrated terminal for editors that can't install the extension. [lines 9-41] [Source]
- Diffs with more than 100 changes open without per-change accept/reject buttons. [line 98] [Source]
API changes
No API documentation changes today.