Claude docs changes for September 22nd, 2026 [diff]
Executive Summary
- Pasted prompt text is now marked to Claude as untrusted content, and invisible/steganographic Unicode characters are stripped from prompts before sending — two new prompt-injection defenses in Claude Code.
- Plugins declared in a repository's
.claude/settings.jsonno longer install automatically in cloud sessions (Projects threads,claude-code-on-the-web, routines) — only plugins synced from your claude.ai account load there now. sandbox.excludedCommandsgot much stricter: an entry only takes a Bash call out of the sandbox when it covers every command in it, and shapes likesudo,eval,cd, subshells, and non-fd redirections always stay sandboxed regardless of the list.- New Claude API capability: on accounts where the prefix-binding check isn't enforced yet, sending the
thinking-binding-controls-2026-08-01beta header now surfaces athinking_mismatch_allowedentry ininput_transformationsso you can find history edits in production before opting into enforcement. - The Claude API's Compaction guide was split into five focused pages (on-demand, threshold, keep-recent-turns, background, and preserved-thinking interactions), and Claude Code's VS Code extension picked up a large batch of editor and accessibility features (per-change diff review, memory/instructions editors, background-task view, copy-response button).
Claude Code changes
Changed documents
advisor [Source]
- A saved advisor that the API has already refused in the current conversation now stays off until
/clearor/compact, even after you switch main models. [line 47] [Source] - When the API refuses a mismatched advisor/model pairing, Claude Code now silently resends the request without the advisor instead of failing every request with an error message. [lines 101-104] [Source]
agent-sdk/configuration [Source]
updateSettings()gained a"userSettings"destination that saveseffortLevelas the default effort for the session's current model, alongside the existing"localSettings"destination. [lines 163-171] [Source]
agent-sdk/cost-tracking [Source]
- A
query()call that resumes a session now reports the session's whole spend (earlier calls included), not just that call's own cost;maxBudgetUsd/max_budget_usdstill counts only the call's own spend. Requires Claude Code v2.1.277 or later — earlier versions started resumed totals at zero. [lines 29-83] [Source]
agent-sdk/modifying-system-prompts [Source]
- CLI-only custom system prompts (
--system-prompt/--system-prompt-file) can now split into a cached static part and a dynamic part with a literal__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__line, mirroring the SDK's array marker. Requires Claude Code v2.1.275 or later. [lines 339-345] [Source]
agent-sdk/python [Source]
- The Monitor tool's
persistentoption is gone — every watch now has a deadline, capped at 30 minutes (1,800,000 ms) even if a longertimeout_msis requested. [lines 2593-2609] [Source] TaskOutputwas removed in v2.1.277 (superseded by reading a background task's output file withRead); its schema no longer appears in the SDK reference. [lines 2989-2997] [Source]sandbox.excludedCommandsentries no longer unconditionally take a whole compound command out of the sandbox — see thesettings-referenceentry below for the full new rule. [lines 3228-3238] [Source]
artifacts [Source]
- Artifacts can now load JavaScript libraries from
unpkg.com, a fifth allowlisted CDN alongside cdnjs, jsDelivr, the Tailwind CDN, and the jQuery CDN. [lines 249, 346]
claude-apps-gateway [Source]
- A gateway can now return an
emailfield in its token response; Claude Code has the developer confirm the account before saving the credential, and/statusthen shows it. Requires Claude Code v2.1.275 or later on the client. [lines 247-253] [Source] /logoutnow sends a revocation request to the gateway'srevocation_endpoint, when advertised, so the gateway can end the session server-side too (best effort). Requires v2.1.275 or later. [lines 458-464] [Source]
claude-directory [Source]
- Pasted/attached images are no longer stored under
~/.claude/image-cache/. Since v2.1.275 they save outside~/.claude, under theCLAUDE_CODE_TMPDIRtemp directory, soclaude project purgeno longer removes them (the retention sweep still does). [lines 1305, 1369] ~/.claude/plugins/now also holds aninstalled_plugins.jsoninstall record, and plugins synced from your claude.ai account download into~/.claude/plugins/synced/. [line 1228] [Source]
claude-md [Source] / memory
- Corrected: user-level rules loading before project rules doesn't mean they take priority — when a user rule and a project rule conflict, Claude may follow either, so keep the two consistent. [line 265] [Source]
claude-projects [Source]
- Plugins declared in a repository's
.claude/settings.jsonno longer load into Projects threads; add the plugin under Project settings > Plugins instead. [lines 178-209] [Source]
cli-reference [Source]
--forward-subagent-textnow also forwards messages from subagents that a forked skill spawns, and from nested forked skills, requiring Claude Code v2.1.275 or later. [line 88] [Source]--max-budget-usd: totals restored when you--continueor--resumea conversation no longer count toward the cap. [line 91] [Source]- New
__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__marker line for splitting a custom--system-prompt/--system-prompt-fileinto a cached static part and a dynamic part. Requires v2.1.275 or later. [line 150] [Source]
cloud-environments [Source]
- Plugins and marketplaces declared in a repo's
.claude/settings.jsonno longer install in cloud sessions at all; enable the plugin for your claude.ai account instead so it loads as a synced plugin. [lines 245-267] [Source]
commands [Source]
- New bundled slash command:
/update-config [request]— describe a settings change and Claude edits the matchingsettings.json. [line 299] [Source] /code-review's cleanup-opportunity coverage is now conditional on the model and effort level rather than always included. [line 288] [Source]/ultrareviewcan now take a commit ID or tag, not just a branch name, as the comparison base. [line 297] [Source]
context-window [Source]
- Added the git status snapshot to the "what survives compaction" table: Claude Code reads a fresh one from your repository after
/compact. [line 1155] [Source]
costs [Source]
- Clarified that the 1.1× data-residency multiplier on the session cost figure also counts toward
--max-budget-usd, not just the reported total. [line 29] [Source]
desktop [Source] / desktop-changelog
- Plugins declared in a repository's
.claude/settings.jsonno longer install in cloud sessions; only claude.ai-synced plugins do. [lines 20-23] [Source] - Same fifth-CDN (
unpkg.com) addition for artifacts as noted above. [line 65] [Source]
discover-plugins [Source]
- Added the VS Code extension's Manage plugins dialog as an install path when
/pluginisn't available, and cloud sessions now point only at claude.ai-synced plugins. [lines 75-84] [Source] - Adding a plugin by URL now skips the marketplace-source confirmation dialog when the source matches a marketplace you've already added. [line 102] [Source]
env-vars [Source]
- New
CLAUDE_CODE_GATEWAY_HINT_HEADERSvariable to turn the new gateway hint headers on or off per connection (requires v2.1.273+). [line 141] [Source] - New
OTEL_LOG_MANAGED_SETTINGSvariable to add redacted managed settings and a SHA-256 digest to the newmanaged_settings_resolvedtelemetry event (requires v2.1.274+). [line 158] [Source] TASK_MAX_OUTPUT_LENGTHis now a no-op, removed alongside theTaskOutputtool in v2.1.277. [line 167] [Source]- With fetching off, Claude no longer receives pasted text marked as pasted (see terminal-config below) — it arrives unmarked instead. [line 175] [Source]
errors [Source]
- Documented several new error/message lookups:
Artifacts need a claude.ai login,Sign-in timed out while waiting for you to continue, new 400s fororphaned tool_resultandduplicate tool_use IDin conversation history,Couldn't open Claude Desktop, a marketplace-source-conflict error, a "plugin required by your organization" error, worktree-isolation refusal messages, and anotelHeadersHelper failedtelemetry warning. [lines 66, 84, 145-146, 198, 218, 232, 240-241]
fast-mode [Source]
- Two more organization settings can now block turning on fast mode with
/fast: managedfastMode: false, andfastModePerSessionOptIn: trueoutside an interactive terminal session. [lines 23-29, 177]
headless [Source]
--output-format json'stotal_cost_usdnow includes earlier runs' spend when you--continue/--resumea conversation. [line 62] [Source]
hooks [Source]
UserPromptSubmit'spromptfield now delivers expanded pasted content wrapped in<pasted_content id="…">tags when Claude Code marks pasted text — hooks that parse the prompt need to account for those lines. [line 93] [Source]SubagentStopnow also fires for Claude Code's own internal agents (prompt suggestions,/btwside questions), with an emptyagent_typethat a named matcher won't match unless the matcher is empty,"*", or a regex matching the empty string. [lines 2349-2352] [Source]
ide-integrations [Source] / vs-code
- Per-change diff review: Accept this change / Reject this change buttons under each hunk, plus context-menu and Command Palette actions, for diffs with 100 or fewer changes. Requires v2.1.275+. [lines 167-169] [Source]
- Customize menu gained Memory (view/edit/delete auto memories, v2.1.274-275) and Instructions (edit CLAUDE.md files, v2.1.274) panels, plus a Sign out action (v2.1.277). [lines 193-203] [Source]
- New Copy response button and
/copy [n]command (v2.1.277); the agent map now also lists background tasks like shell commands and monitors, and/tasksopens it even with no subagents running (v2.1.277). [lines 208-219] [Source] - Picking a non-
maxeffort level in the model picker now saves it as your default for that model; the effort picker in the model picker previously changed only the current session. [line 182] [Source] - Account & Usage dialog now shows session cost/tokens for third-party-provider and API-key sign-ins that don't have plan usage bars (v2.1.277). [line 262] [Source]
- New
lockEditorGroups(v2.1.274) andcontinueAfterReload(v2.1.274) settings: Claude's editor tab now locks its group by default, and a step interrupted by a window reload resumes automatically. [lines 273-284] [Source] - Selected text is now withheld from files matched by
files.exclude/search.excludeor gitignored (respectingrespectGitIgnore) — only the file path reaches Claude for those. [line 227] [Source] - Accessibility: new Focus last message command (v2.1.268), per-message screen-reader announcements ("You" / "Claude" / tool name / "Claude, thinking"), and arrow-key control over where a permission approval saves. [lines 321, 363-376]
- Restore-all-archived-sessions action added to the sessions list (v2.1.277). [line 245] [Source]
interactive-mode [Source]
- New
Ctrl+Enter/Ctrl+X Ctrl+Sshortcut to interrupt the current turn and send queued messages immediately, instead of waiting for the turn to end. Requires v2.1.275+. [line 32] [Source] - New security feature: Claude Code now strips invisible Unicode characters (tag characters, bidi controls, zero-width spaces) from a prompt when you press Enter, showing a notice and requiring a second Enter to send the cleaned text. [lines 518-523] [Source]
- Background-task memory-pressure termination now triggers only on critical memory pressure and logs why tasks were (or weren't) stopped in the debug log. [lines 302-304] [Source]
keybindings [Source]
- New
chat:sendNowaction (defaultCtrl+Enter,Ctrl+X Ctrl+S) for the immediate-send behavior above. Requires v2.1.275+. [line 110] [Source]
llm-gateway-protocol [Source]
- New feature: gateway hint headers. Claude Code can send
x-claude-code-request-class,x-claude-code-agent-type,x-claude-code-compaction,x-claude-code-context-compacted, andx-claude-code-prev-tool-durationsso a gateway can schedule, cache, or attribute requests. On by default on a direct Anthropic API connection; opt-in elsewhere viaCLAUDE_CODE_GATEWAY_HINT_HEADERS=1. Requires v2.1.273+. [lines 123-185] [Source]
managed-settings [Source]
- Documented invalid-value fallback behavior for three new managed keys —
strictKnownMarketplaces,disableSideloadFlags, andblockedMarketplaces— and forsyncClaudeAiPlugins. All four fallbacks require Claude Code v2.1.277 or later. [lines 216-234] [Source]
model-config [Source]
- On the Anthropic API, a Fable model now appears grayed out (with a reason) in the
/modelpicker when your organization can't use it, instead of being hidden entirely. [line 277] [Source]
monitoring-usage [Source]
- New OpenTelemetry event:
managed_settings_resolved, logged at session start, on managed-settings/policy-helper changes, and on startup refusals, so admins can find machines on unexpected managed sources or with a failing policy helper. SetOTEL_LOG_MANAGED_SETTINGS=1to include the redacted settings and a SHA-256 digest. Requires v2.1.274+. [lines 1226-1281] [Source] - New
effortspan attribute on LLM request spans (v2.1.274+); a new warning notificationotelHeadersHelper failed; telemetry is not being exportedappears once per session when the OTel headers helper first fails. [lines 21, 28]
plugin-evals [Source]
TaskOutputremoved from the default read-only tool allowlist for plugin evals, consistent with the tool's removal. [line 341] [Source]
plugins-reference [Source]
- New: plugin agent files can now live in subfolders of
agents/, loading with colon-scoped names likemy-plugin:review:security. [lines 66-71] [Source]
permission-modes [Source]
- New "Approvals you state in conversation" section documents how auto mode's classifier reads a verbal approval: it must name the action and its specifics, covers one action at a time, and can't clear every block. [lines 257-263] [Source]
- A guarded shell-variable expansion, such as
rm -rf "${DIR:?}"/*, now avoids the critical-pathrm -rfprompt inbypassPermissionsmode. [lines 281-286] [Source]
sandboxing [Source]
- When your shell leaves
$TMPDIRunset, an unsandboxed command that references it now getsCLAUDE_CODE_TMPDIR(or the OS default) instead of an empty string. [lines 9-12] [Source] - Clarified that adding a clipboard tool to
excludedCommandsdoesn't take a piped-to call out of the sandbox on its own. [lines 36-40] [Source]
security-guidance [Source]
- Cloud sessions no longer pick up this plugin via
.claude/settings.json; the "Enable in cloud sessions and shared repositories" section was replaced with claude.ai-sync guidance, and a VS Code install path was added. [lines 52-70] [Source]
self-hosted-environments-deploy [Source]
--use-anthropic-git-proxy's opt-in reporting to Anthropic requires Claude Code v2.1.267 or later; earlier versions accept the flag silently without reporting it. Recommended runner image version bumped to 2.1.267. [lines 104, 113]
server-managed-settings [Source]
gatewayInternalNetworkswas added to the gateway sign-in keys that server-managed settings can never supply or hide. [line 139] [Source]
sessions [Source]
- A
claude -prun started directly from a shell or script no longer gets a generated session title. [line 152] [Source]
settings-reference [Source]
sandbox.excludedCommandsis now much stricter: an entry only takes a Bash call out of the sandbox when it covers every command in the call, and shapes likesudo/eval/xargs,cd/pushd/popd, command substitution, subshells, control-flow blocks, non-fd redirections, and computed command names always stay sandboxed. [lines 1697-1719] [Source]taskOutputMaxCharswas removed in v2.1.277 alongside theTaskOutputtool. [lines 2828-2833] [Source]attribution: Claude Code now tells Claude that your own CLAUDE.md/memory instructions about attribution take precedence over the commit/PR lines, unless the line is set in managed settings. [line 3656] [Source]modelSettingsis now also written when you pick an effort level in the VS Code extension's model picker, not just the CLI's/effortor/model. [line 1122] [Source]
skills [Source]
- In a linked git worktree whose checkout has no
.claude/skillsat its root, Claude Code now loads the main checkout's project skills instead. Requires v2.1.277+. [line 130] [Source] - Clarified that synced skills are download-only: local edits under
~/.claude/skills/synced/aren't uploaded and can be overwritten by the next sync. [line 202] [Source]
statusline [Source]
cost.total_duration_msnow accumulates across session resumes and excludes time the session wasn't running, instead of measuring elapsed wall-clock time since start. [line 19] [Source]
sub-agents [Source]
tools/disallowedToolsfrontmatter now also accepts a comma-separated string, such asRead, Grep, Bash, in addition to a YAML list. [lines 49-52] [Source]- A
opus/sonnetfamily alias in a subagent's model now resolves to the main conversation's exact model (including its[1m]suffix) in two cases: when the main conversation is already in that family, or when Claude Code can't determine the main model's family on a non-Anthropic-API provider. [lines 60-65] [Source] - Security: a subagent's report now arrives under a header marking it as untrusted subagent output with no authority from you, and a background subagent's report arrives inside a notification marked as an automated event. [lines 914-917] [Source]
terminal-config [Source]
- New security feature: submitted prompts now mark the content behind each
[Pasted text #N]placeholder to Claude as pasted (untrusted) text, with instructions to only follow embedded instructions where your own message asked it to. [lines 122-126] [Source]
third-party-integrations [Source]
- Claude for Teams now includes SSO and server-managed settings (previously Enterprise-only); Claude for Enterprise's description was trimmed to domain capture, role-based permissions, and the compliance API. [lines 153-156] [Source]
troubleshooting [Source]
- New: a critical memory-usage warning now appears once a session's heap passes 2.5GB, with guidance to restart and
--continue, or run/compact, to clear it. [lines 36-38] [Source]
ultrareview [Source]
- A commit ID or tag now works as the comparison base, not just a branch name. [line 43] [Source]
- New: reviewing a repository's first commit (with confirmation), plus more specific refusal messages for "nothing to review" and "no merge base" cases. [lines 232-241] [Source]
- Security fix: the whole-repository fallback's consent now requires you to run the subcommand yourself — Claude running
claude ultrareviewfor you via the Bash tool no longer counts as consent and is refused. [line 250] [Source]
workflows [Source]
- In auto mode, a prompt that a workflow script computes and passes to
agent()is now marked as script-computed text rather than a request from you, when the classifier reviews that subagent's actions. [line 274] [Source]
worktrees [Source]
- Worktree cleanup now also checks checked-out submodules for changes before removing a worktree, and prompts instead of auto-removing when it can't verify the worktree's state. [lines 286-291] [Source]
- The command-shape isolation check now also blocks expansions like
${!name}or${ command; }that could run a command the text doesn't spell out. [line 299] [Source] - A worktree with no
.claude/skills(and, on v2.1.277+, no local override) now reads through to the main checkout's skills, agents, and commands. [lines 321-330] [Source]
API changes
New Documents
compaction-on-demand [Source]
New guide covering the recommended compaction path: request a summary on demand with the compact-2026-09-04 beta header and top-level compaction parameter, splitting the request that summarizes from your ordinary conversation turns.
compaction-threshold [Source]
New guide holding the original compact_20260112 token-threshold compaction content that used to live on the main Compaction page: the API compacts automatically inside an ordinary request once input tokens reach your configured trigger.
compaction-keep-recent-turns [Source]
New guide on keeping the most recent turns word for word behind an on-demand compaction summary.
compaction-background [Source]
New guide on running on-demand compaction as a background request while the conversation keeps going, then swapping in the summary block when it arrives.
compaction-thinking-blocks [Source]
New guide on the conditions under which thinking blocks in turns kept behind an on-demand compaction summary stay valid, for models with preserved thinking.
Changed documents
build-with-claude/compaction [Source]
- Rewritten from a full reference (3,800+ lines) into a short overview and decision page: a comparison table of on-demand vs. threshold vs. client-side compaction, and links out to the five new pages above for the details. [lines 1-50] [Source]
build-with-claude/preserved-thinking [Source]
- New API capability: with the
thinking-binding-controls-2026-08-01beta header,input_transformationsnow gains athinking_mismatch_allowedentry type. It flags a thinking block that fails the prefix-binding check on a request where the API doesn't enforce that check by default (for example, an older account on Claude Fable 5.1 that leavesprefix_mismatch_behaviorunset), without changing what the model receives — so you can find history edits in production traffic before opting into enforcement. [lines 31, 368-380, 787-874]
release-notes/overview [Source]
- Added a September 14, 2026 entry documenting the new
thinking_mismatch_allowedentry type described above. [line 389] [Source]
models/fable-5-1/migration-guide [Source]
- Cross-references the new
thinking_mismatch_allowedentries as a way to check an existing integration for history edits without opting into enforcement, and retargets its compaction links to the newcompaction-on-demand/compaction-thresholdpages. [lines 349-368] [Source]
manage-claude/user-management [Source]
- RBAC groups API: path parameters and response fields were renamed for clarity —
{group_id}path segments are now{rbac_group_id}, a group'srolesfield is nowrole_ids(withroleskept as a deprecated alias), and a group member'sgroup_idis nowrbac_group_id(withgroup_idkept as a deprecated alias). [lines 176-330] [Source] - Usage and cost reports for Claude Enterprise are now available through the Claude Enterprise Analytics API, split out into their own table row. [lines 181-184] [Source]
manage-claude/compliance-activity-feed [Source]
- New
system_actoractivity-feed actor type for automated background processing that Anthropic runs without a user or customer credential. Also notes that some Anthropic-run migrations (such as memory-store migrations) currently attribute touser_actorinstead, withip_address: 0.0.0.0. [lines 160-163] [Source]
manage-claude/cmek [Source]
- Clarified CMEK coverage: Claude Design, Claude Slides, and Claude Docs are now explicitly called out as unavailable under CMEK (Claude Code also can't publish artifacts), where "artifacts" was previously bundled generically under covered chat content. [lines 130-139] [Source]
about-claude/models/optimizing-for-cost-and-intelligence [Source]
- Corrected the cache-read pricing note: it no longer claims a fixed 0.025× multiplier for Claude Fable 5.1 and Claude Mythos 5.1, noting instead that "some models use a different multiplier." [lines 36-118] [Source]
- Anthropic now says explicitly that Opus 4.7, Opus 4.8, and Opus 5 are priced identically per token (previously phrased as "the Opus line" generally). [line 28] [Source]
Managed Agents guides (quickstart, tools, scheduled-deployments, permission-policies, memory, build-with-claude/skills-guide)
- The CLI examples across these guides switched from heredoc commands like
ant beta:agents create <<YAMLto a new declarativeant apply <file>workflow: point it at an agent/deployment/environment/memory-store/skill file (frontmatter plus body, or a plain YAML file), and it creates or updates the resource and records the resulting ID inclaude-lock.json. For skills,ant apply <dir>uploads the directory directly instead of requiring a manualzipstep first.
Beta API reference (all languages, e.g. api/beta)
- Cross-cutting documentation pass across the entire Beta API reference — repeated identically for every per-language SDK reference page (Python, TypeScript, Java, Go, PHP, Ruby, C#, and the CLI) — with no functional change: every
anthropic-workspace-id/workspace_idheader now explains that it selects the Workspace for multi-workspace credentials, and enum-valued fields (such as effort levels and dream statuses) gained a one-line description for each value. This is the reason for the unusually large size of today's diff; it isn't itemized file by file here.
Feature-compatibility metadata migration (dozens of API reference and guide pages, e.g. agents-and-tools/mcp-connector, managed-agents/overview)
- Anthropic moved each page's "Compatibility" section (beta status, beta header, ZDR eligibility, supported models/platforms) from in-body Markdown into page frontmatter (
featureMetadata). This is a rendering/authoring change with no content difference, affecting most tool, guide, and managed-agents pages; also not itemized file by file here.