Source: ai-research/claude-code-docs-changelog-2026-10-16.md — code.claude.com changelog, versions v2.1.299–v2.1.302 (October 14–16, 2026), fetched 2026-10-16. The official What’s New digest page code.claude.com/docs/en/whats-new/2026-w42 returned HTTP 404 (consistent with all prior sweeps since W38; Tavily OAuth unavailable non-interactive; x-search ENOENT). Versions v2.1.297–v2.1.298 are not detailed in the available changelog summary; they may be small bug-fix releases. Continues Week 41.
Product: Claude Code · Date: 2026-10-12 to 2026-10-16
Week 42 delivers two infrastructure-level upgrades: idle compaction (v2.1.299) automatically compacts conversations that go idle above 200K tokens before the prompt cache expires, reducing the cost of long-running unattended sessions; and a BREAKING MCP allow-rule scope fix (v2.1.299) that changes how permission patterns match server names — mcp__a no longer matches a server named a__b. Additional highlights: CLAUDE_CODE_AUTO_MODE_MODEL for classifier model selection (v2.1.302), a /advisor expansion to Claude Platform on AWS (v2.1.300), the prompt.change mod hook (v2.1.300), LaTeX math rendering in VS Code (v2.1.301), and a notice that standalone Claude Design closes December 14, 2026.
Key Takeaways
- BREAKING: MCP allow rules now match only the named server (v2.1.299). Update
mcp__a__*patterns:mcp__ano longer matches a server nameda__b. Writemcp__<server>__*explicitly. See MCP. - Idle compaction (v2.1.299): sessions over 200K tokens that idle for ~54 minutes are auto-compacted before the prompt cache expires. Configure with
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS; disable with"idleCompaction": falsein settings. The/configmenu (v2.1.302) now has a row for this. CLAUDE_CODE_AUTO_MODE_MODEL(v2.1.302): select the model used by the client-side auto mode classifier independently of the session model.- Fork subagents on by default outside the terminal (v2.1.302): desktop app and VS Code now run fork subagents in the background by default, matching the terminal behavior.
- Sessions with no permission mode default to
defaulton third-party providers (v2.1.302). prompt.changemod hook (v2.1.300): plugins using the Claude Mods system can now intercept and modify the prompt before it is sent.UserPromptSubmithooks run before skill expansion (v2.1.299): the hook now fires earlier in the pipeline.- LaTeX math rendering in VS Code (v2.1.301): math expressions in Claude’s responses render inline in VS Code.
- /advisor on Claude Platform on AWS (v2.1.300):
/advisorcommand now available in Claude Platform on AWS sessions, not just native API. - Large API requests gzip-compressed by default (v2.1.300): set
CLAUDE_CODE_GZIP_REQUEST_BODIES=0to turn off. - Standalone Claude Design closes December 14, 2026 (v2.1.302): notice added; existing projects must migrate before the deadline.
- Multi-line
rowsfor mod inputs (v2.1.301): Mods can declare multi-line text input rows in the/configUI. CLAUDE_CODE_DISABLE_FILE_MENTIONS(v2.1.299): env var to suppress file-mention suggestions in the prompt.%motion in vim mode (v2.1.301): jumps to the matching bracket/paren in vim-style editing.- Slack Connect channel support in Claude Tag (v2.1.300): Claude Tag now works in Slack Connect channels shared across organizations.
Release table
| Version | Date (UTC) | Shape |
|---|---|---|
| v2.1.299 | 2026-10-14 | Idle compaction; MCP allow-rule scope fix (BREAKING); UserPromptSubmit before skill expansion; CLAUDE_CODE_DISABLE_FILE_MENTIONS; /usage warnings; exit prints resume ID; 131 fixes (largest this range) |
| v2.1.300 | 2026-10-14 | /advisor on AWS; OpenTelemetry GenAI attrs; prompt.change mod hook; Slack Connect in Claude Tag; claudeCode.attachSelection VS Code setting; gzip API requests default; —sandbox removed from remote-control; 59 fixes |
| v2.1.301 | 2026-10-15 | CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS; % motion in vim; multi-line rows for mods; classifier attrs in OTEL tool_decision; LaTeX in VS Code; “Get more usage” link; 37 fixes |
| v2.1.302 | 2026-10-16 | CLAUDE_CODE_AUTO_MODE_MODEL; /config idle-compaction row; standalone Claude Design closure Dec 14 notice; no-permission-mode → default on third-party; fork subagents default outside terminal; desktop/VS Code bg subagents; 43 fixes |
BREAKING: MCP allow rules scope fix (v2.1.299)
Prior to v2.1.299, an MCP allow rule written as mcp__a would match a server named a__b because the pattern-matching logic treated double underscores as a delimiter. This was a bug. The fix: a rule now matches only the exactly named server.
Migration: if you have any MCP permission patterns with double underscores in settings.json, update them:
// Before (may have been accidentally matching more than intended)
{ "allow": ["mcp__myserver"] }
// After (explicit wildcard for all tools under myserver)
{ "allow": ["mcp__myserver__*"] }If you relied on a broad pattern (e.g., mcp__prefix matching servers like prefix__toolset1 and prefix__toolset2), you now need explicit entries for each server. See MCP.
Idle compaction (v2.1.299, v2.1.302)
Long-running sessions that go idle with more than the configured token threshold are now auto-compacted before the prompt cache expires — preventing the full cache-miss cost on resumption.
- Trigger: conversation > 200K tokens AND idle for ~54 minutes
- Disable:
"idleCompaction": falsein~/.claude/settings.json - Configure minimum tokens:
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS=<N> - UI: v2.1.302 adds a row in
/configto toggle this setting
This pairs with the existing manual /compact and autoCompactWindow (subagent-level, added in W41 v2.1.296). The new setting applies to the primary session, not subagents. For unattended Routines or long background sessions, this is the main lever to prevent cache expiry between turns.
CLAUDE_CODE_AUTO_MODE_MODEL (v2.1.302)
The client-side auto mode classifier model can now be selected independently of the session’s main model. Use case: you run Opus 5.5 as the main model but want the classifier to use a cheaper model (e.g., Haiku 5.5) to reduce overhead on classification decisions.
export CLAUDE_CODE_AUTO_MODE_MODEL=claude-haiku-5-5This is the client-side classifier only; the server-side classifier (added in W38 v2.1.271) is not affected by this env var. See Auto Mode and CLI Reference.
Fork subagents on by default outside the terminal (v2.1.302)
Fork subagents (subagent_type: "fork") were already on by default in the terminal since W33. v2.1.302 extends the default to the desktop app and VS Code — background fork subagents now run without needing an explicit config flag.
Additionally, the desktop app and VS Code now run the main conversation’s non-fork subagents in the background by default, matching the behavior that was already default in the terminal. See Subagents.
prompt.change mod hook (v2.1.300)
A new Mods hook event: prompt.change. Plugins using the Claude Mods system can listen to prompt.change and modify the user’s prompt before it is expanded and sent to the model. This is distinct from prompt.autocomplete (W41 v2.1.292), which fires on autocomplete events.
Practical use cases: injecting dynamic context based on the prompt content, enforcing prompt format rules, or stripping sensitive patterns before they reach the model.
UserPromptSubmit hooks now run before skill expansion (v2.1.299)
Previously, UserPromptSubmit hooks ran after skills were expanded into the prompt. Now they run before — meaning the hook sees the raw user prompt, not the expanded version. If you have a UserPromptSubmit hook that was matching against skill-expanded text, update your patterns to match the pre-expansion prompt instead. See Hooks.
/advisor on Claude Platform on AWS (v2.1.300)
The /advisor command — which provides context-aware guidance about Claude Code features — is now available in Claude Platform on AWS sessions. Previously available only on the native Anthropic API; this brings it to the AWS-hosted deployment (added in W20). See CLI Reference.
OpenTelemetry GenAI semantic conventions (v2.1.300, v2.1.301)
Two OpenTelemetry additions:
- GenAI semantic-convention attributes (v2.1.300): Claude Code now emits standard OpenAI/Anthropic GenAI attributes in OTEL spans — provider, model name, token counts — matching the OpenTelemetry GenAI spec conventions.
- Classifier attributes in
tool_decisionevents (v2.1.301): OTELtool_decisionevents now include classifier-level attributes, useful for debugging auto-mode decisions in observability pipelines.
Standalone Claude Design closure (v2.1.302)
A notice was added to Claude Code: standalone Claude Design closes December 14, 2026. No additional details are given in the changelog entry about migration path or what replaces it. Users who rely on Claude Design as a standalone product should plan migration before the deadline.
Other additions
claudeCode.attachSelectionVS Code setting (v2.1.300): new VS Code extension setting controlling how selections are attached to prompts.CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS(v2.1.301): caps how long the retry watchdog will wait at a usage limit before giving up.CLAUDE_CODE_DISABLE_FILE_MENTIONS(v2.1.299): suppresses the inline file-suggestion popups in the prompt bar./usagewarnings (v2.1.299):/usagenow surfaces warnings when usage patterns are unusual or approaching limits.- Exit prints session ID resume command (v2.1.299): when you exit Claude Code, it now prints the
claude --resume <session-id>command for the session, making it easier to resume. --sandbox/--no-sandboxremoved fromclaude remote-control(v2.1.300): these flags are no longer accepted byclaude remote-control.- Grep and Glob “no matches” fix (v2.1.301): Grep and Glob were incorrectly reporting “no matches” in some cases where the search itself failed (e.g., permission error, missing path). Fixed to distinguish between a real empty result and an error.
Breaking and behaviour changes
- MCP allow rules scope fix (v2.1.299): see above — update
mcp__*patterns to use explicitmcp__<server>__*. - UserPromptSubmit hooks now run before skill expansion (v2.1.299): see above — re-check hook matchers.
- Sessions with no permission mode start in
defaulton third-party providers (v2.1.302): previously the behavior was undefined; now it’s explicitlydefault. --sandbox/--no-sandboxremoved fromclaude remote-control(v2.1.300): update any scripts that pass these flags.- Large API requests gzip-compressed by default (v2.1.300): set
CLAUDE_CODE_GZIP_REQUEST_BODIES=0if this causes issues with a custom proxy or gateway.
Try It
- Set
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS=300000to raise the idle-compaction threshold if you want to avoid compaction on medium-length sessions. - Update MCP allow rules: run
grep -r "mcp__" ~/.claude/to audit your settings for patterns that might be affected by the scope fix. - Use
CLAUDE_CODE_AUTO_MODE_MODEL=claude-haiku-5-5to lower classifier overhead when running the main session on Opus 5.5. - Check
prompt.changefor prompt normalization hooks: if you use Mods,prompt.changeis the right event for pre-send transformations. - VS Code users: LaTeX rendering is on by default — no config needed. Test with a math-heavy prompt.
Open Questions
- v2.1.297 and v2.1.298: these versions fall between v2.1.296 (Oct 9, covered in W41) and v2.1.299 (Oct 14). They were not detailed in the available WebFetch changelog summary and may be small bug-fix releases without notable features.
- Standalone Claude Design closure migration path: the notice says December 14, 2026. No migration documentation was included in the changelog entry — check
code.claude.com/docs/en/claude-designfor guidance. - Idle compaction and /compact instructions: does idle compaction honor a custom compaction instruction set via
/compact <instructions>? The changelog does not specify. CLAUDE_CODE_AUTO_MODE_MODELand effort: does the classifier model selection interact with the/effortsetting, or is it purely a model-choice override?
Related
- What’s New — Week 41 — the preceding digest (Haiku 5.5, onFailure: “block”, Agent effort param).
- MCP — MCP allow-rule scope fix (BREAKING), protocol defaults.
- Hooks — UserPromptSubmit before skill expansion; prompt.change mod hook.
- Auto Mode — CLAUDE_CODE_AUTO_MODE_MODEL for classifier model selection.
- Claude Mods — prompt.change mod hook; multi-line rows.
- Subagents — fork subagents on by default outside terminal.
- CLI Reference — new env vars, /config row, removed flags.
- Scheduled Tasks — idle compaction interacts with unattended sessions.