Claude docs changes for October 14th, 2026 [diff]
Executive Summary
- Claude Code 2.1.299 adds idle compaction: a 200K+ token conversation left idle for about 54 minutes is compacted before its one-hour prompt cache expires. It is configurable with
idleCompactionandCLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS. - New "You should know" built-in mod surfaces one easily missed point per check (a tradeoff Claude made, a result that may be off) as a short note above the prompt.
- New Managed Agents guides on secure deployment: recommended settings, sandbox risks and boundaries, and reviewing and monitoring sessions.
- API docs now use Claude Opus 5.5 (
claude-opus-5-5) in examples, with updated Opus pricing in the Managed Agents session runtime example ($4 input / $20 output per million tokens). - Security hardening across 2.1.299: MCP allow rules and agent
tools:lists now match only the named server, andUserPromptSubmithooks run before skill or slash command expansion.
New Claude Code versions
2.1.299
New features
- Added
CLAUDE_CODE_DISABLE_FILE_MENTIONS: Claude gets the paths of@file mentions to read with its file tools instead of the files' contents - Added idle compaction in the terminal: a 200K+ token conversation left idle for about 54 minutes is compacted before its one-hour prompt cache expires.
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENSchanges the threshold, and"idleCompaction": falseturns it off - Added mod APIs for managed-settings mods:
$.prompt.media,$.session.identity(),size/weight/mono/tabularonText, named spacing steps onBox, skill details passed to theskill.prompthook, and aqueuedoor onsession.append - Added
--shutdown-drain-sectoclaude self-hosted-runner orchestratorfor graceful shutdown on SIGTERM - Added
/effortand/fastin agent view to set what new sessions start with; a bare/model,/effortor/fastthere opens a picker - Added
--disallow-toolsand adisallowed_toolscase field toclaude plugin eval - Added
CLAUDE_CODE_ATTRIBUTION_HEADER=0support for turning off the attribution block in Claude Desktop's Code tab via a Claude apps gateway policy - Added
/usagewarnings for max effort, workflows, always-on context and large tool results - Added a note in
/pluginandclaude plugin validatenaming a mod's hooks that are skipped where an organization manages Claude Code - Claude in Slack can now delete a canvas it created
Existing feature improvements
- Managed permission rules, managed hooks and organization MCP tool names are enforced better against user-installed mods
- PDFs that are @-mentioned no longer keep their bytes in the session transcript, reducing memory and disk use
- A local session can watch up to 25 published artifacts, up from 10
- Background agent notifications now say when an agent is only waiting on its own background work, got a message too late, or was stopped by a usage limit
- Better errors for worktree creation failures (unresolvable base commit, bare-repository layout) and for the unrecognized model ID startup warning
- Cloud sessions and Remote Control MCP connectors negotiate MCP protocol version 2026-07-28 by default (
MCP_PROTOCOL_NEGOTIATION=legacyopts out) - MCP tool descriptions and server instructions from Anthropic's first-party MCP servers are no longer cut at 4,096 characters
- Streams through a custom
ANTHROPIC_BASE_URLnow wait 300 seconds, up from 180, before aborting with no data - Behavior changes: MCP allow rules and agent
tools:lists reach only the server they name (mcp__ano longer matchesa__b);UserPromptSubmithooks run before a skill or custom slash command expands; the resume command printed at exit uses the session ID instead of its name;/ultrareviewerrors no longer suggestgit add .
Major bug fixes
- Fixed sandbox escapes: sandboxed commands writing into a
--plugin-dirfolder, reading or writing denied paths through symlinks on macOS, and globallowRead/allowWriteentries not being re-checked after a symlink replacement - Fixed plan mode running writes that a
PreToolUsehook or a mod'stool.checkhook allowed - Fixed third-party gateway API keys being sent to Anthropic for server-managed settings, feature flag and other requests
- Fixed Write dropping byte-order marks or silently converting Windows-1252, Shift-JIS, GBK or UTF-16BE files to UTF-8, and Read garbling UTF-16LE files
- Fixed cloud and headless sessions running an approved tool call twice after a restart (regression in 2.1.296)
- Fixed MCP servers named
constructororprototypenever connecting, and MCP deny/ask rules not applying to servers with a double underscore in their name - Fixed MCP connections over HTTP hanging for 30 seconds when a server never ends a notification reply
- Fixed images attached while Claude is working being sent at full size, causing repeated image errors in long conversations
- Fixed
/usage, the limit warning and the status line sometimes showing more than 100% used - Fixed scheduled tasks and loops misfiring around the daylight saving time change
- Windows: PreToolUse and PermissionRequest hooks that set no shell now block rather than fail open when Git for Windows isn't installed
Claude Code changes
Changed documents
claude-code-on-the-web [Source]
- Cloud sessions accept
/model,/effort,/colorand/renamewith the value passed as an argument. [line 253] [Source] - New error messages for organizations that disable cloud sessions or whose policy couldn't be verified. [lines 395-397] [Source]
commands [Source]
/cd <path>moves a session to a new working directory while keeping the conversation. [line 60] [Source]/color,/fast,/mcp(reconnect, enable, disable),/remote-controland/renameentries expanded with new argument and behavior details. [lines 66-125] [Source]
desktop [Source] and desktop-changelog
- Desktop release notes were updated with new entries (about 200 lines changed in each file).
env-vars [Source]
- New
CLAUDE_CODE_DISABLE_FILE_MENTIONSto stop@mention expansion. [line 251] [Source] - New
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS(default 200000, minimum 100000). [line 312] [Source] CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTHnow replaces both default limits: 4096, and 16384 for tools loaded through tool search. [line 315] [Source]- New
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MSraises the backoff ceiling for529overloaded retries (32000 to 64000). [line 344] [Source] - New
CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUGshows the last three checks of the You should know mod. [line 423] [Source] DISABLE_AUTO_COMPACTalso disables idle compaction, andENABLE_TOOL_SEARCHdefault behavior was simplified. [lines 439-465] [Source]
errors [Source]
- New sections for "Failed to fetch session from Sessions API", "Request rejected as unprocessable by the model", and MCP tool names over 128 characters. [lines 1977-1994] [Source]
- New sections for cloud-session policy errors ("Cloud sessions use your claude.ai login", "Couldn't verify your organization's policy") and a failed stash when a folder replaces a tracked file. [lines 2911-2967] [Source]
- Retry tuning table lists
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS. [line 444] [Source]
hooks [Source]
- New section "Hooks that start a background process": print the decision first and redirect the background process's output, or Claude Code blocks the call with
refusing to honor the suspect capture. [lines 853-873] [Source] - The
automatcher forPreCompactandPostCompactnow also covers idle compaction. [lines 3190-3222] [Source]
interactive-mode [Source]
- New "You should know suggestions" section for the built-in mod that shows one note above the prompt when it spots something you might have missed. It covers enabling it (
/plugin enable cc-plugin-you-should-know@builtin), the cost of background checks, answering notes (Learn more, Knew this already, Dismiss), and turning it off. [lines 430-483] [Source]
mcp [Source]
- A JSON entry with a
urlbut notypeis a configuration error and the server is skipped. [line 77] [Source] CLAUDE_PROJECT_DIRis stable; servers should use MCProots/listfor allowed directories. [line 109] [Source]- New "How Claude Code stops a stdio server" section describing the signal sequence on macOS/Linux and Windows. [lines 133-141] [Source]
- Reconnect behavior for remote servers in headless and SDK runs, per-server
timeoutas a floor on the idle timeout, and token refresh with one retry on a401. [lines 369-433] [line 753] [Source]
permission-modes [Source]
- Auto mode's default block list was consolidated, removing per-version notes. Handling of pushes to repositories with unknown visibility was clarified. [lines 380-415] [Source]
plugin-dependencies [Source]
- New section on how dependencies resolve when a plugin loads from claude.ai (
<name>@synced): a dependency counts as met by the marketplace copy or an enabled claude.ai plugin of the same name. [lines 212-222] [Source] - The same addition appears in
plugins/dependencies.
plugin-evals [Source]
- New troubleshooting entry for "cannot be evaluated where sessions load it" and how to evaluate a directory instead. [lines 665-678] [Source]
routines [Source]
- The artifact publishing rules moved to a new section, "When a run publishes an artifact without asking". New artifacts can be published without asking, and the conditions for republishing existing ones changed. [lines 315-332] [Source]
- API trigger tokens can now be deleted from the web UI to turn off API access. [lines 167-171] [Source]
settings-reference [Source]
- New
idleCompactionsetting with its conditions, plus how to change the token threshold. [lines 2913-2955] [Source] - Turning off
autoCompactEnabledalso turns off idle compaction. [line 2723] [Source] CLAUDE_CODE_DISABLE_FILE_MENTIONSlisted among variables ignored in project and local settings. [line 2884] [Source]
API changes
New Documents
secure-deployment [Source]
Guide listing the settings that limit what a Managed Agents agent can reach and do, most important first, with a summary table of recommended values and links to the pages that cover each setting.
secure-deployment-monitoring [Source]
Covers optionally running an offline reviewer job that sends each session's events to Claude through the Messages API, watching webhooks for sessions that need attention, and what Managed Agents retains and for how long.
secure-deployment-risks [Source]
Explains why the security settings matter (prompt injection, and Claude using reachable tools or credentials to get past obstacles) and what the Managed Agents sandbox can and cannot do.
Changed documents
advisor-tool [Source]
- All examples and the quick start now use
claude-opus-5-5as the advisor model. [line 60] [Source] - The C# example sets a 5 minute client timeout, because advisor calls run a second model inside the request. [lines 496-497] [Source]
claude-platform-on-aws [Source]
- The AWS region is now required, and the SDK errors if none is set. Region comes from
aws_region,AWS_REGION, orAWS_DEFAULT_REGION. [line 165] [Source] - API key authentication (
ANTHROPIC_AWS_API_KEY) is documented as an option, and the client auth resolution order was rewritten. [lines 190-259] [Source] ANTHROPIC_AWS_WORKSPACE_IDand theanthropic-workspace-idheader are described. [line 507] [Source]
compliance [Source]
- Two new activity types:
claude_artifact_type_default_updatedandclaude_artifact_type_pin_updated, bringing the total to 527. The same changes appear incompliance/activitiesandcompliance/activities/list. [line 284] [Source]
dreams [Source]
- Examples use
claude-opus-5-5, and the supported models list for the research preview now includesclaude-opus-5-5andclaude-fable-5-1. [line 159] [Source] - The output memory store ID appears in
outputsshortly after the dream starts running. [line 26] [Source]
pricing [Source]
- The Managed Agents session runtime example now uses Claude Opus 5.5 at $4 input / $20 output per million tokens (total $0.58, or $0.428 with prompt caching at a 0.05 cache read multiplier). [lines 438-455] [Source]
rate-limits [Source]
- The rate limit tables are now described per row, with some rows covering several models that share one limit. [line 121] [Source]
- The response headers table notes that not every 429 carries
retry-after; the spend-cap 429 never does. [lines 273-293] [Source]
thinking [Source]
- Lists the models where thinking is already on (Opus 5.5, Sonnet 5.5, Fable 5.1, Mythos 5.1, Haiku 5.5, and others) versus those that need
thinking: {type: "adaptive"}(Opus 4.8, 4.7, 4.6 and Sonnet 4.6). Examples useclaude-opus-5-5. [lines 71-73] [Source]