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

Executive Summary

  • Claude Code 2.1.302 adds CLAUDE_CODE_AUTO_MODE_MODEL to choose the client-side auto mode classifier model, plus an /config toggle 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 Box spacing steps and Text typography props (size, weight, mono, tabular), with bold deprecated in favor of weight.
  • 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_MODEL to choose the model the client-side auto mode classifier uses (it doesn't affect server-side auto mode)
  • Added an Idle compaction row to /config to turn idle compaction off or on; notices after an idle compaction now say how to turn it off
  • Added a notice to /design-sync and /design-login that 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>@builtin now points to /plugin when 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 plugin and 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, ttlMs or cacheScope
  • Fixed classifier_category missing from OpenTelemetry tool_decision events for most auto mode classifier blocks
  • Fixed worktree isolation failing under git 2.56 or later when a stray .git file points at a missing directory

Claude Code changes

Changed documents

agent-sdk/hooks [Source]

  • The .env protection example now compares case-insensitively, with a note that it doesn't catch Windows backslash paths or Bash writes. [lines 54-139] [Source]
  • The PreToolUse timeout 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 PreToolUse hook returns allow. [line 273] [Source]
  • New Auto mode section: switching a session in auto mode to an unsupported model drops it to default mode (Claude Code v2.1.299+), and you must call set_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]

hooks [Source]

  • onFailure is 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 PreToolUse or PermissionRequest hook that fails there can block the call, with four fixes. [lines 934-950] [Source]
  • UserPromptSubmit hooks 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_MS can 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 bypassPermissions out of the Shift+Tab cycle 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>__* and mcp__<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 allow has 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]

  • tool.check hooks can't approve non-read-only calls in plan mode. [line 204] [Source]

plugins/mods/interface [Source]

  • Box spacing props accept step names, and Text accepts typography props such as weight. [lines 426-427] [Source]

plugins/mods/reference [Source]

  • New Box spacing steps table (xs to xl), requires v2.1.299+. [lines 300-320] [Source]
  • New Text typography props size, weight, mono, tabular, with how the terminal and VS Code extension treat them. bold is deprecated in favor of weight. [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 Bash deny rule matches are still blocked; critical-path rm/rmdir checks 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.