Template v1.2 2026-09-07 — As of CC v2.1.263
Content / CC Release Updates
November 2026 v2.1.317 – v2.1.327 9 releases
CC v2.1.327 2026-11-17
- ADD
attributionProject — names a session's billing group, for Claude apps gateways that set admin.billing_group_tag; confirmed only via this changelog entry, not yet in settings-reference.md as of the 2026-11-18 fetch
- ADD
CLAUDE_CODE_DISABLE_SHELL_HEAD_START=1 env var — given its first placemat row: stops a session's first Bash command's shell start-up files from running before the command is approved; confirmed only via this changelog entry, not yet in env-vars.md
- ADD
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC env var — given its first placemat row: disables auto-updates, telemetry, error reporting, release notes and other nonessential network traffic; real and already documented in env-vars.md, but missed by earlier passes
- CHG
claude mcp add-json <name> - — reads the server's JSON from stdin instead of the command line, so tokens can stay off it; not available inside a Claude Code session; noted on the existing claude mcp list/add/remove row
- CHG
claude mcp add --scope project — now stops, instead of overwriting the file, when .mcp.json lists its servers at the top level with no mcpServers key; noted on the existing row
- CHG
/tui classic — new name for /tui's non-fullscreen renderer; /tui default still works; noted on the existing row, whose visible command text was also corrected to commands.md's own /tui [default|fullscreen] form
- CHG
/install-github-app — now asks for confirmation before it changes a repository, and its repository, secret and API key steps use the standard list and keys, with shorter messages, a spinner and clearer errors; noted on the existing row
- CHG
/export — the dialog now asks before overwriting an existing file; /export <name> keeps the file instead and says to run /export; noted on the existing row
- CHG
permissions.blockReadsOutsideWorkingDirectories — now asks about more Bash commands in bypass and auto modes and denies some in auto mode, and refuses more that name a path under a Read or Edit deny rule, where it used to ask; noted on the existing row
- CHG
CLAUDE_CODE_AUTO_MODE_SERVER=0 — the billed-local-classifier fallback warning now says an upcoming release removes the fallback; each action it would have checked will be asked about or denied instead; noted on the existing row
- CHG
--worktree — the ExitWorktree tool now asks before removing a worktree that may hold unsaved work, and is refused in don't-ask mode or with nobody to answer, unless an allow rule, auto, or bypass permissions mode allows it; noted on the existing row
- CHG
claude plugin eval — now keeps its own deny rules over a plugin's permission hook, and flags calls the hook let through; noted on the existing row
- CHG
CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 — now also sends an x-claude-code-managed-settings-checksum header; noted on the existing row
- CHG
/config — now notes when another setting overrides a row; noted on the existing row
- CHG
/status — gained a list of broken agent, skill, command and output style files, keybinding errors, an unavailable sandbox, ignored permission settings and hook matchers that never match; noted on the existing row
CC v2.1.326 2026-11-16
- ADD
OTEL_RESOURCE_INCLUDE_HOST env var — given its first placemat row: adds host.name and host.id to OpenTelemetry resource attributes; off by default
- ADD
sandbox.filesystem.allowWrite — given its first placemat row: adds paths sandboxed commands can write to, beyond the default write-list; real and already documented, but missed by earlier passes
- ADD
allowedHttpHookUrls — given its first placemat row: limits which URLs HTTP hooks can target, with an empty array blocking every HTTP hook; real and already documented, but missed by earlier passes
- ADD
httpHookAllowedEnvVars — given its first placemat row: caps which env vars any HTTP hook may put into a request header, on top of each hook's own allowedEnvVars; real and already documented, but missed by earlier passes
- ADD
dangerouslyDisableSandbox: true (PermissionRequest field) — given its first placemat row: lets an approving hook or SDK host that rewrote a command's input drop it from the sandbox the original was checked under; confirmed only via this changelog entry, not yet in hooks.md as of the 2026-11-17 fetch
- ADD
claude self-hosted-runner --use-anthropic-gh false — given its first placemat row: opts out of the built-in Anthropic-run gh api that Linux and macOS runner sessions with no gh installed now get by default
- CHG
Ctrl O — also shows hidden startup notices; noted on the existing row
- CHG
disableAutoMode — terminal and VS Code sessions in organizations with the Claude Code + Cowork HIPAA configuration now also start in auto mode by default; this setting turns it off; noted on the existing row
CC v2.1.325 2026-11-13
- ADD
sandbox.autoAllowBashIfSandboxed — given its first placemat row: skip the permission prompt for sandboxed Bash commands; deny rules and content-scoped ask rules such as Bash(git push *) still apply
- ADD
sandbox.failIfUnavailable — given its first placemat row: exit at startup instead of running unsandboxed when the sandbox can't start; real and already documented, but missed by earlier passes
- ADD
disableRemotePreviewScripts — given its first placemat row: managed setting that turns off scripts in the desktop app's HTML previews over SSH and WSL; real and already documented, but missed by earlier passes
- ADD
CLAUDE_CODE_MAX_CONTEXT_TOKENS env var — given its first placemat row: overrides the context window Claude Code assumes for the active model; now also sets the window for unrecognized model IDs that start with claude-
- CHG
sandbox.autoAllowBashIfSandboxed default changed to false in v2.1.324; before that, sandboxed Bash commands ran without a permission prompt by default
- CHG
prependPlugins / appendPlugins — a remote marketplace's plugins that managed settings declare, enable and list here now count as the organization's; pluginDigests is deprecated and ignored; noted on both existing rows
- CHG
WorktreeCreate — now refuses a hook path that goes through a symlink inside the project; have the hook print the real path instead; noted on the existing row
CC v2.1.323 2026-11-12
- ADD
/logout — given its first placemat row: sign out from your Anthropic account; in a background session, now signs out every session on the computer, deletes stored MCP logins and plugin secrets, and ends the session, as in a terminal
- ADD
policyHelper / policyHelper.path / policyHelper.refreshIntervalMs / policyHelper.timeoutMs — given its first placemat row: managed setting that runs an executable at startup to compute managed settings; no longer takes environment variables from user or --settings files
- ADD
engines["claude-code"] (plugin manifest) — given its first placemat row: plugins outside this version range aren't installed, updated or loaded; install and update pick the newest version that fits
- CHG
CLAUDE_CODE_DISABLE_1M_CONTEXT / CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 — the context window assumed for an unrecognized model ID rose from 200K to 1M; a session on a smaller-window third-party model can now fail every turn once full, until /clear; noted on both existing rows
- CHG
MCP_SDK_GENERATION=v1 — the v1 MCP client is fully removed; setting this now runs the v2 client in a compatibility mode (earlier handshake, relaxed OAuth sign-in checks) instead; noted on the existing row
- CHG
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS — the maximum it accepts rose from 64,000ms to 300,000ms; noted on the existing row
- CHG
.mcp.json — a server's approval now matches its exact name; an entry approved under another spelling asks again; noted on the existing row
- CHG
PreToolUse — when a tool's permission check fails with an error after a PreToolUse hook returned allow, Claude Code now decides the call as if no hook had answered; noted on the existing row
- CHG
PermissionRequest — when a tool's permission check fails on input a PermissionRequest hook rewrote, Claude Code now asks again, or refuses the call where nobody can answer; noted on the existing row
- CHG
/security-review — now asks before Claude runs it, outside auto mode and bypass; noted on the existing row
- CHG
-w / --worktree — worktree creation now refuses checkouts whose .git folders are links or hold hard links, such as git-new-workdir layouts and cp -al copies; noted on the existing row
- CHG
claude plugin validate — type-checks a plugin's TypeScript hooks module under --strict, shows the $ nouns a mod's engine.create hook touches, and fails a mod whose engine.create hook isn't in the one accepted form; noted on the existing row
- CHG
claude plugin install <plugin> — shows a warning instead of success when the plugin's install command writes to stderr; noted on the existing row
- CHG
agentType — the subagentStatusLine setting this field belonged to was removed; subagent rows always use the default look now, and settings files that still hold the key load as before; noted on the existing row
CC v2.1.322 2026-11-10
- CHG
/fast — added fast mode on Vertex in the global, us and eu regions, falling back to standard speed if Vertex refuses it; noted on the existing row
CC v2.1.321 2026-11-09
- ADD
claude remote-control --settings <file> — given its first placemat row: applies a settings file to every session the server starts; if the file changes, no new session starts until you restart claude remote-control
- ADD
claude plugin restore-set-aside — given its first placemat row: recovers a plugin's set-aside options and secrets after a managed extraKnownMarketplaces take-over from an undeclared source
- ADD
CLAUDE_CODE_PLUGIN_DIR_WATCH — given its first placemat row (real since v2.1.287): controls mod hot-reload on file changes; now also covers headless sessions reloading mods in .claude/skills
- CHG
cleanupPeriodDays — also sets how long a managed extraKnownMarketplaces take-over from an undeclared source keeps the replaced marketplace's data set aside for claude plugin restore-set-aside; noted on the existing row
- CHG
.claude/skills/<name>/ — a nested .claude/skills/ folder inside ~/.claude/plugins no longer loads the way other nested skill folders do; noted on the existing row
CC v2.1.319 2026-11-06
- ADD
/tasks — given its first placemat row: view and manage background work in the current session, including subagents that have finished; also available as /bashes
- ADD
/tasks gets an "Earlier in this session" row listing finished subagents, so you can reopen one and message it even after it leaves the list or you restart; noted on the new row
- ADD
CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND env var — given its first placemat row: wait for an MCP task's result in an interactive session instead of backgrounding it right away
- ADD
CLAUDE_CODE_DISABLE_MCP_TASKS env var — given its first placemat row: turns off MCP tasks in the terminal entirely
- ADD
CLAUDE_CODE_DISABLE_FEATURE_FLAGS env var — given its first placemat row: stops feature-flag fetching without turning off telemetry
- ADD
CLAUDE_CODE_LOOP_KEEPALIVE env var — given its first placemat row: keeps a self-paced /loop scheduling a fallback wakeup after each turn
- ADD
permissions.denyInsteadOfPrompting — given its first placemat row: denies a tool call that would wait on a permission prompt and continues the turn, in terminal sessions, subagents and teammates
- CHG
/claude-api — gains a latency-optimize subcommand that finds where your Claude API code makes people wait and tries faster settings against your eval; noted on the existing row
- CHG
/claude-api — managed-agents-onboard templates were updated to match the Claude Console (removed Performance tuner, renamed two, turned off web search/fetch in five); noted on the existing row
- CHG
/usage — shows spend for today, this week and this month for developers behind a Claude apps gateway with no spend limit, on a gateway running this version or later; noted on the existing row
- CHG
/loop — a self-paced run now ends when a turn finishes instead of scheduling a fallback wakeup; set CLAUDE_CODE_LOOP_KEEPALIVE=1 to keep the old behavior; noted on the existing row
- CHG
/add-dir — registers plugin marketplaces for the new directory only once its own trust dialog is accepted; noted on the existing row
- CHG
PostToolUse hooks now run, with up to 10 seconds to finish, on tool calls that finish after a new message interrupts the turn; noted on the existing row
CC v2.1.318 2026-11-04
- ADD
/ide — given its first placemat row: manage IDE integrations and show status
- ADD
autoInstallIdeExtension — given its first placemat row: lets /ide install the IDE extension from an external terminal
- CHGClaude Code no longer installs or updates the IDE extension on its own when started in an IDE terminal; use
/ide from an outside terminal, or your editor's extensions view, instead
- CHG
switchModelsOnFlag — subagents now stop instead of switching models when set to "Ask each time"; noted on the existing row
- CHG
deniedMcpServers — a URL entry now also blocks a matching Anthropic-provided server and connectors in cloud sessions and on self-hosted runners; noted on the existing row
- CHG
/permissions — rule details, built-in rules, and the delete confirmation now use the standard dialog; Ctrl+C twice there goes back or cancels instead of quitting; noted on the existing row
- CHG
/claude-api — managed-agents-onboard now gives a new agent's built-in tools, and a quickstart template's MCP tools, the auto permission policy by default; noted on the existing row
- ADD
claude auth status / --output-format json — gained loginExpiresAt / credential_expires_at fields showing when a stored claude.ai sign-in ends; noted on the existing rows
- ADD
claude -p "q" text output gets a one-line stderr warning starting 10 days before a stored claude.ai sign-in ends; noted on the existing row
- CHG
claude self-hosted-runner orchestrator — its spawn-runner hook's environment now includes CLAUDE_RUNNER_SPAWN_REASON, naming why Anthropic sent the request; noted on the existing row
CC v2.1.317 2026-11-03
- ADD
CLAUDE_CODE_DISABLE_NESTED_SESSION_ID env var — given its first placemat row: on a self-hosted runner, has a nested claude -p run inside a session share that session's ID and transcript, as earlier versions did
- CHG
CLAUDE_CODE_SUBAGENT_EFFORT — a subagent or teammate on a different model from the main conversation now uses that model's own saved effort level or default instead of the session's, when nothing else names one; noted on the existing row
- ADD
onFailure: "block" (hook field) — now also applies to Agent SDK hook callbacks, not just command/HTTP hooks; noted on the existing row
- CHG
/plugin-authoring — once a mod you build works, now offers once to help you share it; noted on the existing row
- ADD
/schedule — now warns when a new cloud scheduled task gets connectors you didn't ask for, and how to remove them; noted on the existing row
- ADDAuto mode's check now shows a notice in the main view when it has no answer for a subagent's tool call, instead of showing nothing; noted on the existing
"$defaults" (autoMode) row
October 2026 v2.1.287 – v2.1.316 20 releases
CC v2.1.316 2026-10-31
- ADD
CLAUDE_CODE_DISABLE_ULTRATHINK env var — given its first placemat row: turns off the ultrathink prompt keyword
- ADD
CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP env var — given its first placemat row: keeps system cross-certificates that certify each other in a loop, for a private CA that needs one
- ADD
CLAUDE_CODE_SUBAGENT_EFFORT env var — given its first placemat row: sets the effort level subagents run at when nothing else names one
- CHGFast mode for Opus 4.8 is deprecated as of 2026-10-30 and removes on 2026-11-30; migrate to Opus 5.5 to keep the speedup; noted on the existing
/fast [on/off] row
- CHGAn
autoMode.allow list without "$defaults" no longer removes the built-in rule on scheduled-task prompts; noted on the existing "$defaults" (autoMode) row
- CHG
/ultrareview [PR#] — when it finds no GitHub remote, now says to create one at github.com/new instead of suggesting a gh command that gh rejects; noted on the existing row
- FIX
claude auth login/logout — where managed settings require a Claude apps gateway, a terminal run now shows the gateway sign-in instead of refusing; noted on the existing row
- ADD
/restart / /update — given its first placemat row: restarts Claude Code and resumes the session to apply an installed update; real and already documented since v2.1.288, but missed by earlier passes
CC v2.1.314 2026-10-30
- ADD
permissions.blockWritesOutsideWorkingDirectories setting — given its first placemat row: Write, Edit and NotebookEdit refuse paths outside the working directories, in every permission mode
- CHG
idleCompaction — now also compacts idle 200K+ token conversations in VS Code and Claude Desktop's Code tab, and covers subscribers with telemetry off and Bedrock/Vertex/Foundry/gateway sessions once the hour-long prompt cache is on; noted on the existing row
- FIX
FORCE_HYPERLINK=0 — =false (also no and off) now turns hyperlinks off too, instead of on; noted on the existing row
- CHG
CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK — the automatic model switch it pairs with now retries on another model instead of ending in a refusal when ANTHROPIC_DEFAULT_OPUS_MODEL, availableModels, or deniedModels leaves only an older Opus model, or none; noted on the existing row
- CHG
/claude-api — Datadog API tracing setup now sends the dd-llmobs-enabled: true header and drops an outdated macOS xattr install step; also now asks to read a Managed Agents workflow run's workflow before changing the agent; noted on the existing row
- CHG
/dataviz — now advises on y/x-axis tick label formatting thresholds and answers donut/pie chart requests with ranked bars or a segmented bar instead; noted on the existing row
- CHG
if: (hook field) — Monitor(tail *) now matches the Monitor tool's shell commands as Bash(tail *) matches Bash's, though such a hook can only block or ask on a Monitor call, not approve or rewrite it; noted on the existing row
- CHG
/ultrareview [PR#] — now checks workspace trust before running git, as claude ultrareview already did; noted on the existing row
- FIX
claude ultrareview [target] — in a CI job with a terminal, now refuses an untrusted folder at once instead of asking, when CI is set (claude remote-control does the same); noted on the existing row
- CHG
/permissions — its Recently blocked tab now refuses to approve a row you can't read in full, including one the terminal is too short to show, and its footer explains Esc; noted on the existing row
- CHG
PermissionRequest — in Cowork cloud sessions, a hook's allow of an MCP tool call now counts as no answer, so the classifier or a permission prompt decides instead; noted on the existing row
CC v2.1.312 2026-10-27
- ADD
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT env var — given its first placemat row: picks the full system prompt or a shorter one with abbreviated tool descriptions; Bedrock, Vertex, Foundry and Mantle now use the shorter prompt for any unrecognized model name, even one fronting Sonnet or Haiku
- ADD
CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK env var — given its first placemat row: turns off the automatic model switch when a safety classifier flags a request, now also for unrecognized model names
- ADD
switchModelsOnFlag setting — given its first placemat row: chooses whether a flagged request switches models automatically or pauses for you to decide
- CHG
autoCompactWindow — a subagent's window can now lower the one CLAUDE_CODE_AUTO_COMPACT_WINDOW sets, which it had no effect on before; still never raises it; noted on the existing row
- CHG
Ctrl Enter / Ctrl X Ctrl S — in fullscreen, clicking the "to send now" hint under a queued message now does the same thing as the key; noted on the existing row
- CHG
/model / /effort — a mid-task change's cache-refresh notice now says it may wait for your next message and clears once it no longer applies, and can trigger sooner while Claude is still working; noted on both existing rows
CC v2.1.311 2026-10-26
- ADD
claude self-hosted-runner --hold-idle-file / --max-hold-min — given their first placemat row: keeps an idle session alive while the host still reports leftover running processes
- ADD
ultrathink prompt keyword — given its first placemat row: raises that turn to xhigh effort on Opus 5.5, Sonnet 5.5, Haiku 5.5 and Fable 5.1 via Anthropic's API
- ADD
DISABLE_COMPACT env var — given its first placemat row: turns off both automatic compaction and the manual /compact command; setting it in a settings file's env block or a mod's $.env.set can now only disable compaction, never re-enable it
- ADD
CLAUDE_CODE_MODEL_CATALOG env var — given its first placemat row: set to off to skip loading Bedrock/Mantle/Vertex/Foundry model settings from Anthropic's signed catalog
- ADD
CLAUDE_CODE_SYNC_SKILLS env var — given its first placemat row: in -p mode, waits for claude.ai's enabled-skills list before the first query; with feature-flag fetching off, now reuses another session's list on the same machine if it's under 10 minutes old
- CHG
/model — model names and IDs now drop the [1m] suffix and its label where the suffix has no effect; the suffix is still accepted
- CHG
Ctrl D — in claude agents, also now needs two presses on an empty input to exit, matching the main prompt
- CHG
--output-format json / stream-json — DEL, C1 control and Unicode format characters inside strings are now escaped as \uXXXX; parsed values are unaffected
- CHG
claude --teleport / /teleport — now warns when a compacted cloud session loads from its last compaction, since the summarized messages aren't in the local copy
- CHG
claude purge — now says it deletes data only on this computer, not anything Anthropic stores
- CHG
/code-review — now puts the effort level argument before the target, and tells Claude to use max effort only when explicitly asked
- ADD
sshHostCommands setting — given its first placemat row: adds SSH connections to the Desktop environment selector whose host comes from running a command; real and already documented, but missed by earlier passes
CC v2.1.310 2026-10-23
- ADD
cleanupPeriodDays setting — given its first placemat row: sets how many days old transcripts are kept before automatic cleanup deletes them
- ADD
askUserQuestionTimeout setting — given its first placemat row: auto-continues an unanswered question after an idle timeout instead of waiting indefinitely
- CHGElicitation — an MCP tool call that times out in a non-interactive session while its elicitation is unanswered now tells Claude no answer came and not to repeat the call; noted on the existing row
- CHG
monitors plugin manifest key — the Monitor tool and plugin monitors now also work on Bedrock, Vertex, Foundry, and builds with telemetry or nonessential traffic disabled, where long foreground sleeps are blocked too; noted on the existing row
- CHG
sandbox.allowNestedUserNamespaces — /sandbox and the sandbox startup warning now name Ubuntu's AppArmor restriction on user namespaces and how to lift it; noted on the existing row
- CHG
permissions.blockReadsOutsideWorkingDirectories — auto mode's one-time prompt before the first blocked read now also says that blocking those reads makes shell commands ask for permission; noted on the existing row
CC v2.1.309 2026-10-22
- ADD
claude ultrareview's --trust-workspace flag and the CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK env var — the subcommand now requires workspace trust, asking on a terminal or exiting with Error: Workspace not trusted where it can't; the flag or env var trust a folder for CI; flag noted on the existing claude ultrareview [target] row, env var given its own row
- ADD
sandbox.excludedCommands setting — given its first placemat row: names Bash-rule-syntax command patterns that run outside the sandbox; while the sandbox is enabled but can't run, an excluded command now asks before writing to its write-list paths instead of an unsandboxed fallback, which is refused there
- CHG
/claude-api — service account keys and Workload Identity Federation tokens can now manage OpenTelemetry destinations; Managed Agents subagent teams now build on multiagent_20261001 with dynamic workflows on by default, instead of coordinator
- CHG
/dataviz — the bundled palette validator now accepts APCA as a text-contrast measure alongside WCAG 2 ratios, adds an apca(text, background) function, and says whether a label inside a colored chart fill should read white or near-black
- CHG
/rewind — sed -i edits now get the standard Bash permission prompt and run as written instead of a simulated file-edit preview, and like other Bash edits are no longer restored
CC v2.1.307 2026-10-21
- ADD
/claude-api api-version subcommand — migrates your code to a newer API version and repoints requests at it; noted on the existing /claude-api row
- ADD
claude self-hosted-runner --checkout-hook-timeout-min <n> CLI flag — given its first placemat row: stops a session's checkout hook after N minutes (default 30), failing its setup; 0 disables
- CHG
axScreenReader / CLAUDE_AX_SCREEN_READER (in a settings env block) — now apply only from user, managed, or --settings settings, not project settings (since v2.1.305); noted on both existing rows
- CHG
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION — the notice Claude gets once this budget is spent now also tells it not to query search engines through a browser or computer use; noted on the existing row
CC v2.1.305 2026-10-20
- ADD
sandbox.allowNestedUserNamespaces setting — given its first placemat row: Linux opt-in letting sandboxed commands create user namespaces (Chromium, rootless podman), loosening the sandbox's file protections
- ADD
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS env var — given its first placemat row: sets the minimum interval CLAUDE_CODE_RETRY_WATCHDOG waits between checks of whether a usage limit already lifted
- CHG
allowedMcpServers — a managed-mcp.json stdio server using ${VAR} expansion only in env is now exempt from its filtering too (one using ${VAR} elsewhere is still filtered), noted on the existing deniedMcpServers row
- CHG
/artifacts delete confirmation — y/n no longer answer it; only 1/Enter (keep), 2 (delete), and Esc (cancel) do now
- CHG
/usage — each warning is now a one-line fix naming its source; press f to apply, and the same fixes surface in /doctor
- CHG
/remote-control — pressing w during spawn-mode setup now says the chosen mode is saved for the folder, and a later start using that saved mode says where it came from
CC v2.1.304 2026-10-19
- ADD
/auto-mode-setup — given its first placemat row: drafts auto mode environment entries from your project and recent sessions for review before saving; now also available on Bedrock, Vertex, Foundry, the Claude apps gateway, and telemetry-disabled sessions
- ADD
/artifacts — given its first placemat row: lists, attaches, opens, or copies the link of artifacts you own or that are shared with you; delete confirmation now uses numbered choices
- ADD
CLAUDE_CODE_TRANSCRIPT_LOCAL_GC env var — given its first placemat row: trims pre-compaction history from a long -p/SDK session's transcript file once it passes 5MB
- ADD
CLAUDE_CODE_AUTO_COMPACT_WINDOW env var — given its first placemat row: sets the auto-compact window in tokens; now accepts k/M suffixes like 200k, with a warning on out-of-range or ignored values
- ADD
/claude-api managed-agents-secure subcommand — compares a Managed Agents agent's settings against Anthropic's security guide without changing anything; real and verified via the changelog, not yet in the commands reference table
- CHG
/reload-skills — compaction now resends the full skill list automatically, so this command itself sends only new or changed skills
- CHG
-w / --worktree — asks before removing the worktree and branch at exit when HEAD is detached or on another branch, so commits aren't lost
- CHG
alwaysLoad (MCP server config) — cloud sessions: a new conversation's first turn no longer waits on stdio MCP servers of claude.ai-synced plugins unless this is set
CC v2.1.302 2026-10-16
- ADD
CLAUDE_CODE_AUTO_MODE_MODEL env var — choose the model the client-side auto mode classifier uses; the server-side classifier's model is unaffected
- CHG
CLAUDE_CODE_FORK_SUBAGENT=0 — fork subagents (subagent_type: "fork") are now on by default in claude -p, the Agent SDK, the desktop app and VS Code, as they already were in the terminal; set to 0 to turn them off, claude mcp serve never offers them
- CHG
permissions.defaultMode — when unset, claude -p and Agent SDK sessions now start in manual mode instead on third-party providers, with telemetry off, or on a fresh install; --permission-mode auto still keeps auto
- CHG
idleCompaction — /config now has its own Idle compaction row, and the notice shown after an idle compaction says how to turn it off
- ADD
proxyAuthHelper managed setting — read from only the highest-priority admin source, alongside apiKeyHelper and the other auth-refresh helpers; real and verified but otherwise undocumented on the reference page, so marked unverified
- ADD
additionalMarketplaces — version-gated alias (v2.1.232+) of extraKnownMarketplaces, noted on its existing row alongside allowedMarketplaces's matching alias of strictKnownMarketplaces
CC v2.1.301 2026-10-15
- ADD
CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS env var — ends an unattended CLAUDE_CODE_RETRY_WATCHDOG request at a usage limit that resets too far away instead of waiting it out
- ADD
% vim-mode motion — jump to the matching bracket in NORMAL mode, alone or combined with d/c/y
- ADD
prependPlugins / appendPlugins settings — list an organization's mods to run before or after every mod a user installs
- ADD
worktree.location setting — choose the folder where Desktop SSH sessions create worktrees on the remote machine
- ADD
/artifact-capabilities / /artifact-diagramming / /claude-in-chrome [task] — bundled skills already documented in the commands reference, given their first placemat rows this sync
- FIXCorrected the
/fewer-permission-prompts skill row, which showed the command as /less-permission-prompts
CC v2.1.300 2026-10-15
- ADD
advisorModel setting / --advisor <model> flag — pick which model answers the server-side advisor tool; /advisor reaches Claude Platform on AWS
- ADD
CLAUDE_CODE_DISABLE_ADVISOR_TOOL env var — turn off the advisor tool entirely
- ADD
CLAUDE_CODE_GZIP_REQUEST_BODIES env var — set to 0 to stop gzip-compressing large requests to the Claude API
- CHG
PreToolUse hooks — an updatedInput is now validated like Claude's own input: unknown keys are dropped, and input the tool rejects denies the call
- CHG
PermissionRequest hooks — in Cowork cloud sessions, a setMode update in the hook's allow is now ignored; the rest of the approval still applies
- CHG
forceLoginGatewayUrl — Claude Desktop's Code tab now applies managed settings when this names a reachable Anthropic-operated gateway serving the session's hostname
- CHG
claude-api skill — leaves Managed Agents sessions in place unless you ask to archive or delete them
CC v2.1.299 2026-10-14
- ADD
idleCompaction setting / CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS env var — idle compaction now auto-compacts a 200K+ token conversation left idle for a while before its prompt cache expires; set the setting to false to turn it off
- ADD
CLAUDE_CODE_DISABLE_FILE_MENTIONS env var — stop expanding @ file mentions; Claude gets the paths and reads them with its own file tools
- ADD
CLAUDE_CODE_ATTRIBUTION_HEADER env var — set to 0 to drop the attribution block from the start of the system prompt
- ADD
claude self-hosted-runner orchestrator — new --shutdown-drain-sec <n> flag lets an in-flight poll and running spawn hooks finish before SIGTERM exits the process
- ADD
claude plugin eval — new --disallow-tools flag and disallowed_tools case field keep named built-in tools, such as Agent, out of eval runs
- CHG
claude agents — a bare /model, /effort or /fast in the dispatch input now opens a picker; /effort and /fast there set what new dispatched sessions start with
- CHG
MCP_PROTOCOL_NEGOTIATION=legacy — cloud sessions' and Remote Control's own MCP connectors also negotiate protocol 2026-07-28 by default now, on installs that fetch no flags
CC v2.1.296 2026-10-09
- ADD
autoCompactWindow — now also settable in subagent frontmatter and --agents definitions, so a subagent can auto-compact earlier than the main conversation's window
- ADD
CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL env var — run every Workflow tool agent on one model while other subagents keep theirs
- ADD
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS env var — sets a longer maximum delay for the backoff when retrying an overloaded (529) request
- CHG
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH — the default cap on MCP tool descriptions and server instructions is now 4,096 characters, raised from 2,048
CC v2.1.295 2026-10-08
- ADD
onFailure: "block" hook field — a command or HTTP hook that can't start, times out, or exits unexpectedly now blocks the action instead of letting it through
- ADD
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS env var — caps how long CLAUDE_CODE_RETRY_WATCHDOG waits out 429/529 errors before giving up
- ADD
forceLoginMethod: "gateway" / forceLoginGatewayUrl — now also work as your own user settings on machines with no managed settings
- ADD
/copy picker — quoted text in a response now copies without its leading > markers
- ADD
claude plugin validate — prints the install line to paste when a plugin's README has none; never fails --strict over it
CC v2.1.293 2026-10-07
- ADD
agentType subagentStatusLine task field — the subagent's type, the same value hooks get as agent_type on SubagentStart
CC v2.1.292 2026-10-06
- ADD
claude plugin install --marketplace <source> — adds the marketplace if needed, under the same checks as claude plugin marketplace add, then installs the plugin from it
- ADD
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS env var — sets a longer base delay for the backoff when retrying an overloaded (529) request
- CHG
MCP_PROTOCOL_NEGOTIATION=legacy — local (stdio) MCP server connections now negotiate protocol version 2026-07-28 by default on every install, Bedrock/Vertex/Foundry included; this opts back out
CC v2.1.290 2026-10-05
- ADD
claude attach <id|name> / claude logs <id|name> — part of a running background session's name now works in place of its id
- ADD
CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR env var — sets the hourly refill rate for an interactive session's WebSearch budget; 0 turns off refilling
- CHG
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION — in an interactive session this budget now refills over time instead of ending for good once spent
CC v2.1.288 2026-10-02
- ADD
/code-review --max-findings <n>|all — report more or fewer findings than the usual limit; sticks until you pass --max-findings default
- ADD
Ctrl F keybinding — find a session by name in claude agents
- ADD
Alt ↑ / Alt ↓ keybindings — jump between groups in claude agents
- ADD
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS env var — turns off structured outputs on Mantle or gateways that reject them, fixing session titles, memory recall and prompt hooks
- CHG
claude project purge renamed to claude purge; the old form still works and prints a notice
CC v2.1.287 2026-10-01
- ADD
/plugin-authoring — load Claude's reference for writing a mod, a plugin whose JS/TS hooks can draw UI and intercept tool calls
- ADD
allowManagedModsOnly managed setting — stops a user-installed mod from loading, leaving the rest of its plugin in place
- ADD
"bareElicitationCapability": true MCP server config field — needed for a server on the MCP 2025-11-25 protocol that sends URL elicitation prompts and stopped connecting after this update
- ADD
CLAUDE_AX_PREPARK_MS=50 env var — restores screen reader mode's old pause before writing a new or changed line
- CHG
CLAUDE_CODE_DISABLE_1M_CONTEXT — Opus 4.7+ and Fable now default to a 1M context window with no [1m] model-id suffix on Bedrock, Vertex, Foundry and the Claude apps gateway; this env var keeps 200K
- CHG
alwaysLoad MCP server config — set explicitly to false to defer all of that server's tools behind tool search
September 2026 v2.1.265 – v2.1.286 17 releases
CC v2.1.286 2026-09-30
- CHG
--bare CLI flag — connects only the MCP servers named on the command line, sends the model no system reminders, and starts no background tasks; a shell command that reaches its timeout now stops instead of moving to the background
- CHG
/plugin install <name> (npm source) — refuses git-repository or folder sources, and installs the plugin's dependencies only from registry packages
- CHG
/verify — if a project or user skill is literally named verify, Claude is now told to run it right before committing, except for docs-only and tests-only commits
CC v2.1.285 2026-09-29
- ADD
CLAUDE_CODE_DISABLE_WEB_FETCH env var — turn off the WebFetch tool
- ADD
claude --desktop CLI flag — open the Claude desktop app on the current directory, or on a session with --continue / --resume <id>
- ADD
claude plugin configure <plugin> CLI command — show a plugin's options and which are unset, or save new values read from stdin with --values-stdin
- ADD
claude plugin install --config <server>.<key>=<value> — set a bundled .mcpb MCP server's own settings at install time, so it starts without a visit to /plugin → Configure
- ADD
allowedProviders managed setting — limit which API providers a machine may use (Anthropic API, a custom endpoint, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform on AWS, or a Cloud gateway)
- ADD
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES env var — cap re-sends of a non-streaming fallback request that timed out
- CHG
claude mcp get — hides the command, arguments, and environment values of stdio MCP servers provided by plugins; variable names are still shown
- CHG
alwaysLoad (MCP server config) — a tool that sets its own _meta['anthropic/alwaysLoad'] to false now stays deferred even when its server is set to alwaysLoad
CC v2.1.284 2026-09-28
- ADD
effortSlider:decreaseEffort / increaseEffort / toggleUltracode keybinding actions — rebind the /effort interactive slider's step and Ultracode-toggle keys in keybindings.json
- ADD
/rate-limit-options — added to /help and the command menu for claude.ai subscribers, so usage-limit notices that mention it point to a findable command
- CHG
/effort ultracode [on|off] (also Tab in the interactive slider) — toggles Ultracode independently of effort level; no longer forces xhigh, and stays on at any effort level once enabled
- CHG
/mcp reconnect all — retries every server that failed to connect or needs authentication, in one pass
- CHG
permissions.defaultMode — when unset, interactive terminal and VS Code sessions now start in auto mode on every plan and provider; this setting still overrides that default
- CHG
/recap — declines with a short notice when relayed from a chat thread, a routine, or a webhook; typed in the terminal, Claude apps, Remote Control, -p, or an SDK host, it runs as usual
- CHG
CLAUDE_CODE_MCP_STARTUP_WAIT_MS=0 — servers named by --allowedTools or an mcp_tool hook still get up to 2s to connect on the first non-interactive turn
CC v2.1.283 2026-09-25
- ADD
/doctor prompt-audit (also /checkup prompt-audit) — audits CLAUDE.md files, skills, agents and commands for prompting patterns written for older models
- ADD
availableModelsMatch managed setting — an exact value restricts an availableModels entry to that named version, so new releases of it stay blocked until listed
- ADD
deniedModels managed setting — blocks specific models even when availableModels allows them
- CHG
CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 — also sends an x-claude-code-prompt-id header so gateways can group the requests serving one user prompt
- CHG
--system-prompt / --append-system-prompt — each now combines with its -file counterpart, with the file's text used first
CC v2.1.282 2026-09-24
- ADD
maxProseWidth setting — caps the width of Claude's prose in wide terminals; tables and code blocks keep the full width
- ADD
allowClaudeInChromeWithManagedMcp managed setting — let claude --chrome run alongside an exclusive managed-mcp.json; the error shown when Chrome is blocked now names it
CC v2.1.281 2026-09-23
- ADD
attribution setting — set to false to hide all commit and PR attribution in one step; older CLI versions skip a settings file that only holds this boolean, so keep the object form in files shared across versions
- CHG
Ctrl Enter / Ctrl X Ctrl S send-now key — moves running tools to the background and sends all queued messages, instead of cancelling the turn outright
- CHG
CLAUDE_CODE_AUTO_MODE_SERVER — also applies on a direct Anthropic API connection (1 opts in, 0 opts out); where the server-side classifier runs, it now also reviews read-only and sandboxed shell commands
- CHG
claude plugin validate — also flags .mcp.json entries that would be silently dropped at load, undeclared ${user_config.*} references, and insecure URLs
CC v2.1.280 2026-09-22
- ADD
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH env var — change the 2,048-character cap on MCP tool descriptions and server instructions for the session
- CHG
PermissionRequest hook — an agent-type hook no longer runs here since it has no way to return a decision; shows an error pointing to a command or http hook instead
CC v2.1.278 2026-09-19
- CHG
CLAUDE_CODE_AUTO_MODE_SERVER — the server-side auto mode classifier, which doesn't charge for classifier overhead, is now the default for Claude API and Enterprise users, and on Bedrock, Vertex, Foundry and gateways; set to 0 to opt out on Bedrock, Vertex, Foundry and gateways; warns on billed fallback
- ADD
/status — new Auto mode server row shows whether this session's auto mode classifier runs on the server
CC v2.1.277 2026-09-18
- ADD
AGENTS.md support — in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; toggle under "Project instructions" in /config (not yet on Bedrock, Vertex or Foundry)
- ADD
CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY env var — for Claude apps gateways whose only egress is a forward proxy; every outbound request hands the proxy the hostname instead of resolving it locally
- CHG
taskOutputMaxChars no longer has any effect — the deprecated TaskOutput tool was removed; Claude reads a background task's output file with Read instead
CC v2.1.275 2026-09-17
- ADD
Ctrl Enter / Ctrl X Ctrl S send-now key — interrupts the current turn and sends all queued messages at once; sent and queued messages show in gray until the model receives them
- ADD
syncClaudeAiSkills / syncClaudeAiPlugins settings — set to false to stop syncing the skills or plugins enabled on your claude.ai account into signed-in terminal sessions
- ADD
/plugin install <name> — added --marketplace <source>, which offers to add the marketplace before installing the plugin
- CHG
/plugin install <name> — an npm-source install now runs npm pack --ignore-scripts and is integrity-verified, so the package's install scripts never run
CC v2.1.274 2026-09-17
- ADD
CLAUDE_CODE_MCP_STARTUP_WAIT_MS env var — bound how long the first non-interactive turn waits for connecting MCP servers; 0 skips the wait
- ADD
OTEL_LOG_MANAGED_SETTINGS=1 env var — opt in to redacted settings and digests in the new managed-settings-resolved OTel event
- ADD
MCP_SDK_GENERATION=v1 / MCP_PROTOCOL_NEGOTIATION=legacy env vars — opt out of the v2 MCP client and MCP 2026-07-28 negotiation now default for direct HTTP servers on Bedrock, Vertex, Foundry and telemetry-disabled installs
- CHG
OTEL_LOG_RAW_API_BODIES — its file:<dir> mode also writes an index.jsonl linking each response to its request file and transcript message
- CHG
/status — the GitHub connection line now reads "Cloud sessions" instead of "Claude Code on the web"
CC v2.1.273 2026-09-15
- ADD
CLAUDE_CODE_GATEWAY_HINT_HEADERS env var — opt in to sending x-claude-code-request-class, x-claude-code-agent-type, x-claude-code-prev-tool-durations, x-claude-code-compaction and x-claude-code-context-compacted request headers to LLM gateways
- ADD
CLAUDE_CODE_AUTO_MODE_SERVER env var — use the platform's server-side auto mode classifier on Bedrock, Vertex and Foundry; those platforms now default to a local classifier instead
- CHG
/remote-control — from the Claude app, fork a session started this way (or with claude --remote-control); the fork runs as a background session on your computer
- CHG
/mcp — notifies when a server disconnects mid-session and automatic reconnection gives up
CC v2.1.271 2026-09-14
- CHG
/fast [on/off] — now works in Claude Code Remote sessions (cloud and self-hosted runners) too, via the host's fast-mode setting or by typing /fast in the session
- CHG
/config — mouse support in fullscreen mode: the wheel scrolls the list, a click on a value changes it, and the row under the pointer is highlighted
- ADD
claude self-hosted-runner --drain-marker-file <path> CLI flag — when present at a SIGTERM drain, the runner reports its exit to the server as a host drain (telemetry only)
- ADD
claude self-hosted-runner --host-config-snapshot disk|memory CLI flag — choose where host config is cached; avoids silently losing it once the config directory exceeds 64 MiB
- ADD
allowed_domains — per-command field on Bash, PowerShell and Monitor in sandboxed auto mode; the classifier reviews the domains a command needs and opens sandbox access to only those
- ADD
omitClaudeMd agent frontmatter field (also settable via --agents JSON) — let a custom or plugin subagent run without user, project and local CLAUDE.md files; managed policy files still load
- ADD
claude plugin install / update — added --accept-command <sha256> to accept exactly the command a previous --json run displayed, instead of -y
- CHG
modelPricing — the discount multiplier can now run above 1, up to 10, for marked-up internal chargeback rates; the Claude apps gateway pricing block supports the same range
CC v2.1.269 2026-09-11
- ADD
claude plugin eval CLI command — run a plugin's eval suite against Claude Code; outputs scored, reproducible results as JSON + HTML report
- ADD
/output-style [name] slash command — list and switch output styles; works over Remote Control and in cloud and headless sessions
- ADD
bashEditDiffEnabled setting — show a diff of files a Bash command changed in the tool result when the Bash tool handles file edits
- ADD
OTEL_METRICS_INCLUDE_REPOSITORY env var — tag OpenTelemetry metrics and events with vcs.* repository attributes; commit events also emit vcs.ref.head.* with OTEL_LOG_TOOL_DETAILS
- ADD
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS env var — extend the LLM gateway /v1/models discovery timeout (default 3 s)
- ADD
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS env var — raise the Workflow tool's per-run concurrent agent limit (1–256) for inference-bound fan-outs
CC v2.1.268 2026-09-10
- ADD
claude self-hosted-runner --remove-session-state CLI flag — delete per-session directories under <base-dir>/_sessions/ when sessions end; off by default
- ADD
CLAUDE_CODE_WEBFETCH_DEADLINE_MS env var — override the 300-second WebFetch response deadline; set to 0 to disable
- ADD
gatewayInternalNetworks managed setting — allow /login to a Claude apps gateway on the organization's own public IPv4 block
- CHG
claude plugin enable/disable — added --json flag for structured output; also available on install, uninstall, and update
- CHG
CLAUDE_CODE_ENABLE_TODO_TOOLS=1 — clarified: tools are on by default only for Claude 3.x, Opus 4.0–4.7, Sonnet 4.0–4.6, Haiku 4.5; set this to enable on newer models
CC v2.1.267 2026-09-09
- ADD
maxEffortLevel setting — caps the maximum effort level on every provider (top-level or per model under modelSettings); applies to Bedrock, Vertex, and Foundry
- ADD
--system-prompt-snapshot off flag — renders the system prompt fresh on every request instead of reusing the conversation's recorded prompt
CC v2.1.265 2026-09-08
- CHG
--plugin-dir — now accepts a folder of plugins; each child folder with a manifest loads, and additions/removals while running are picked up
- ADD
forceLoginGatewayUrl managed setting — URL of the Claude apps gateway; machines with this set start as gateway sessions from startup, overriding leftover logins or API keys
Template / Structure
- DELCommand builder — dropped in the migration onto the shared
agentmats template; it generated claude invocations and did not carry over to any other placemat
- CHGMigrated into the agentmats monorepo under
claude-code/ — onto the shared placemat.css/placemat.js, per-agent localStorage keys (pm-claude-code-seen-version, pm-claude-code-collapsed, migrated once from the prior unprefixed keys), and changelog release ids renamed from cc-vX-Y-Z to rel-X-Y-Z
- ADDFooter link to the agent placemats hub — the same reference for Codex CLI, Kimi Code and Hermes Agent, with a cross-agent Rosetta table
- CHGSplit
Config & Environment (149 rows) into Settings (JSON) and Environment Variables cards; managed/enterprise-only keys moved to a Managed & Enterprise group
- ADDCollapsible groups — every group shows its row count and remembers whether you folded it
- ADDSticky section nav with per-card row counts, active-section highlight, and Collapse all / Expand all
- ADDCompact density toggle
- CHGSearch ignores separators (
ctrl+r finds Ctrl R), highlights hits, shows a match count and keeps ?q= in the URL; / focuses, Esc clears
- ADDPer-entry permalinks — hover a row and click
# to copy a link straight to it
- CHGKeyboard: the grid is one tab stop (was 749); ↑/↓ move between rows, Enter copies the chip,
l copies the link; added a skip link and a main landmark
- CHGLong descriptions are now a one-line summary plus folded notes (
+N expands; "Show all notes" in the legend)
- ADD"Since your last visit" strip and drawer — every change since the version you last saw is listed and highlighted, backed by a generated
changes.json and Atom feed.xml
- DELWhat's New modal — it only ever showed the newest release, and stayed silent when a release only demoted items
- ADDPrint stylesheet —
Ctrl P (or the ⎙ Print button) gives a seven-page A4 landscape placemat with a release header and greyscale-safe status marks
- FIXCommand builder no longer labels effort levels with model names; added
--model and --permission-mode selects
- FIXChangelog entries are a tag/text grid, so wrapped lines align under the text; only the newest month starts open; the header now matches the placemat
- ADDLink previews —
og:image, Twitter card and canonical URLs on both pages
- ADDVendor inventory gate —
sources.json now carries a slash/settings/hooks inventory extracted from the official reference pages, and tests/placemat.test.js fails any slash-command or settings/hooks row not on it and not marked unverified
- FIX
permissions.defaultMode row was mislabeled as a bare top-level defaultMode key; the settings reference documents it only in dotted form
- FIX
extraKnownMarketplaces row was mislabeled additionalMarketplaces and described as its "friendlier alias" — no such alias exists in the settings reference
- FIXHooks card row for
EnterWorktree confused a worktree-switching tool with the actual worktree hook events; corrected to WorktreeCreate / WorktreeRemove
- DEL
dynamicWorkflowSize settings row removed — not a documented settings.json key; the real key for the same feature is the existing workflowSizeGuideline row
Template v1.1 2026-03-27 — As of CC v2.1.85
September 2026 v2.1.257 – v2.1.261 5 releases
CC v2.1.261 2026-09-04
- ADD
/skill-doctor — shows which loaded skills go unused and what they cost in context, so you can prune them
- ADD
--append-subagent-system-prompt-file CLI flag — reads the subagent system prompt from a file, for prompts too large to pass on the command line
- ADD
bashOutputMaxChars / taskOutputMaxChars JSON settings — raise how much Bash command or background-task output Claude receives inline before saving to a file (cap at 128K characters)
CC v2.1.260 2026-09-03
- CHG
/diff — in fullscreen mode, opens as a panel beside the conversation showing uncommitted changes as Claude edits
- CHG
Ctrl L in fullscreen — clears the transcript view like a terminal clear; scroll up to see earlier messages
- CHG
/advisor — text form (/advisor, /advisor <model>, /advisor off) now works in desktop, Remote Control, and headless (-p/Agent SDK) sessions
- CHG
/reload-plugins — now available in headless sessions (Claude Code Desktop and SDK)
CC v2.1.259 2026-09-02
- ADD
managedMcpServers managed setting — provide HTTP/SSE MCP servers to every user in the organization (same entry shape as .mcp.json); entries naming a command to run are skipped
- ADD
deniedMcpServers managed setting — blocklist of managed MCP servers to deny; as of v2.1.259, allowedMcpServers governs only user-added servers and no longer filters managed-mcp.json servers
- ADD
--permission-prompts none CLI flag — deny any action that would prompt for unattended headless hosts; the active permission mode (including auto mode) still decides normally
- CHG
claude plugin validate — added --json for a machine-readable validation report
CC v2.1.257 2026-09-01
- ADD
timeFormat / timeZone JSON settings — control the turn-end clock and transcript timestamp format (12h, 24h, 24h UTC, or strftime pattern) and time zone
- ADD
CLAUDE_CODE_SUBAGENT_MODEL_FORCE env var — apply CLAUDE_CODE_SUBAGENT_MODEL (or the main model) to every subagent, ignoring per-spawn and agent-definition model overrides
- ADD
permissions.blockReadsOutsideWorkingDirectories JSON setting — block file reads outside the configured working directories; a one-time prompt appears before the first such read in auto mode
- CHG
/effort — press s in the interactive picker to switch effort for the current session only, matching /model
- CHG
/btw — history browsing changed from ←/→ to Shift+←/Shift+→ (or [/])
- CHG
defaultMode — "bypassPermissions" is now ignored in .claude/settings.json or .claude/settings.local.json; set in user or managed settings, or pass --permission-mode bypassPermissions
August 2026 v2.1.221 – v2.1.251 28 releases
CC v2.1.251 2026-08-28
- ADD
PreModelSwitch / PostModelSwitch hook events — block, confirm, or annotate a model switch before or after it happens
- ADD
prompt_cache status line script JSON input field — per-session prompt-cache stats (hit ratio, misses, tokens re-cached, warm/cold)
- CHG
/usage — spend limit bar for gateway users with spend limits; /cost now shows a per-session prompt-cache line (hit ratio, misses, tokens re-cached, warm/cold)
- CHG
/effort — saves the default effort level per model; each model keeps its own setting when you switch
- CHG
SessionStart — resume hooks now receive session staleness and estimated re-cache cost
CC v2.1.248 2026-08-27
- ADD
--restricted CLI flag / CLAUDE_CODE_RESTRICTED=1 env var — removes built-in tools that run commands or code and WebFetch (unless named in --tools); keeps file tools inside the working directory; refuses bypassPermissions; ignores user, project and local settings files
- ADD
experimental.cacheTtl (agent frontmatter) — per-agent prompt cache TTL ("5m" or "1h"); used when no subagent TTL setting is configured in the session
- ADD
claude self-hosted-runner --client-label <label> / SELF_HOSTED_RUNNER_CLIENT_LABEL — override the label the runner registers with (default: hostname)
- CHG
SendMessage / ListAgents — cross-session messaging between sessions on the same machine now available on Bedrock, Vertex, Foundry, and when telemetry is disabled
- CHG
/status — shows a line explaining a managed-settings load failure or why settings weren't fetched (e.g. Bedrock/Vertex/third-party provider, custom ANTHROPIC_BASE_URL)
CC v2.1.247 2026-08-26
- ADD
feedbackDrafts JSON setting — set to false to prevent Claude from auto-drafting a feedback report when something goes wrong; draft appears in /feedback
- CHG
/claude-api — added cost-optimize subcommand (profiles Claude API spend and works through cost levers); updated with Admin API coverage (organization members, invites, workspaces, API keys, rate limit reports, workload identity federation, CMEK)
- CHG
/loop — self-paced dynamic mode and no-prompt autonomous default now always available, including on Bedrock, Vertex, and Foundry
CC v2.1.246 2026-08-25
- CHG
/permissions — new Auto mode tab for viewing and editing auto mode classifier rules
- CHG
/cd — project settings, hooks, .mcp.json servers (behind the usual approval prompt), skills, and agents now take effect immediately after the move instead of on --resume
- CHG
/code-review — Claude can also start it on its own on Bedrock, Vertex AI, Foundry, through the Claude apps gateway, and when telemetry or non-essential traffic is disabled
- CHG
/goal — idle sessions start at most three check-ins per goal; your next message allows three more
CC v2.1.243 2026-08-25
- ADD
modelPicker JSON setting — curate the /model picker with an ordered, labeled list of models (any id spelling, including Vertex/Bedrock ids); entries are appended to or replace the built-in lineup
- ADD
modelPricing managed setting — set an organization's contracted per-model rates and discount multiplier for /cost, status line, and telemetry cost figures instead of list price
- ADD
promptCacheTtl / subagentPromptCacheTtl JSON settings — set a 1-hour prompt cache TTL for the main conversation while subagents stay at 5 minutes; for API-key and cloud-provider users
- CHG
/usage — new Loops breakdown: per-loop run count, total tokens, tokens per run, and last run
- CHG
/status — new Skipped sources line listing managed settings sources present but not applied; shows GitHub connection status for Claude Code on the web (Pro/Max)
- CHG
/mcp — shows a managed marker on claude.ai connectors whose authentication is managed by your organization
CC v2.1.239 2026-08-21
- ADD
claude plugin enable/disable <name>@synced — cloud-synced plugins from claude.ai appear as name@synced; managed with enable/disable <name>@synced; never override a locally installed same-named plugin
- ADD
/claude-api upgrade — new subcommand; migrates Python projects from anthropic 0.x to 1.x (timeouts use anthropic.Timeout, not httpx.Timeout)
- CHG
/goal — check-ins back off (30 min → 1 h → 2 h) instead of repeating every 30 min; resuming via claude --resume now restores the active goal
- CHG
keybindingFlavor: "readline" — extended with word-motion keys: Alt+F and Ctrl/Option+→ stop at end of word, Alt+D deletes to it (Ctrl+Y pastes back), punctuation separates words
- CHG
ListAgents / SendMessage — ListAgents now reports the session's own name (the identifier peers use to message it) and includes live teammates in its listing
- CHG
CLAUDE_CODE_RETRY_WATCHDOG — now fails immediately on organization spend-limit and out-of-credits errors instead of waiting indefinitely
CC v2.1.238 2026-08-20
- ADD
keybindingFlavor JSON setting — set to "readline" to make Ctrl+W delete back to previous whitespace (Bash-style); default "classic" unchanged
- ADD
headersHelper (plugin marketplace / catalog entry) — command that mints HTTP headers (e.g. a short-lived token) for catalog and same-origin archive fetches; for catalog entries, runs only on claude plugin install/update after displaying the command (-y to skip prompt)
- ADD
claude self-hosted-runner --defer-shutdown-max-min <minutes> — on SIGTERM, keep serving attached sessions for up to N minutes before parking remaining sessions and exiting
- ADD
claude self-hosted-runner --proxy-authorization-command / --proxy-authorization-file — supply a freshly issued Proxy-Authorization header on every connection for egress proxies requiring per-request credentials
- CHG
Ctrl L / Cmd+K in fullscreen — now always just repaints; the double-press /clear shortcut was removed
- CHG
claude mcp list / claude mcp get — disabled servers now show as ⊘ Disabled instead of connecting for a health check
CC v2.1.237 2026-08-20
- ADD
outputStyle JSON setting — "concise" makes Claude lead with results and skip preamble/narration; configure via /config → Output style
CC v2.1.236 2026-08-19
- ADD
ANTHROPIC_DEFAULT_MODEL env var — sets the model new sessions start on; a /model pick still overrides it and persists across restarts, unlike ANTHROPIC_MODEL
- CHG
SendMessage — added notify_when_idle option: ask another session to send one notice when it next goes idle, opt-in, one-shot, no polling (macOS and Linux)
CC v2.1.235 2026-08-18
- ADD
spellcheck JSON setting — underline misspelled words in the prompt input as you type; requires aspell, hunspell, or ispell
CC v2.1.234 2026-08-17
- ADD
selection:clear keybinding action — bind to a key via /keybindings to clear an in-app text selection; works in agents view
- CHG
/goal — clears itself on unrecoverable errors (revoked auth, exhausted credits, context overflow); checks in on background tasks waiting 30+ min (set CLAUDE_CODE_GOAL_CHECKIN_MINUTES=0 to opt out)
- CHG
/permissions — can now be opened while Claude is working; rule changes apply to the rest of the current turn
- CHG
/add-dir <path> — now usable while Claude is working
- ADD
CLAUDE_CODE_PROJECT_DIR_NAME env var — custom short name for the per-project transcript directory
- ADD
CLAUDE_CODE_GOAL_CHECKIN_MINUTES env var — set to 0 to disable automatic check-ins when /goal is waiting on background tasks for 30+ min
CC v2.1.233 2026-08-14
- ADD
CLAUDE_CODE_TOOL_MEMORY_LIMIT env var — opt-in memory cgroup limit for Bash tool commands on Linux; prevents a runaway build from stalling the session
- ADD
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS env var — configure the WebFetch session URL cache TTL in milliseconds (default: 15 minutes)
- ADD
CLAUDE_CODE_ENABLE_TODO_TOOLS=1 env var — re-enable task/todo tools (TaskCreate/Get/Update/List, TodoWrite) on Opus 4.8, Sonnet 5, Fable 5, Mythos 5, and newer models where they are no longer available by default
- CHG
claude plugin validate — now also checks a bare .claude/skills directory, reporting SKILL.md files whose frontmatter fails to parse
CC v2.1.232 2026-08-13
- ADD
/advisor slash command — AI advisor mode; Fable 5 available for organizations with Fable access (enable via /model fable)
- ADD
additionalMarketplaces JSON setting — friendlier alias for extraKnownMarketplaces; add plugin marketplace repos beyond the built-in list
- CHG
strictKnownMarketplaces — now also accepted as allowedMarketplaces
CC v2.1.229 2026-08-12
- ADD
claude remote-control --continue — resume the most recent Remote Control session
- CHG
/commit-push-pr — git/gh commands with dangerous flags (--force, --amend, --no-verify, etc.) are no longer auto-approved
- ADD
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS=0 env var — set to 0 to disable automatic staggering of same-prefix sibling workflow agents
- ADD
command (plugin marketplace source) — specify a plugin directory via a local command's output; re-resolved each session without restart; mode: "link" uses it in place
CC v2.1.225 2026-08-08
- CHG
SendMessage — can now initiate a conversation with a Remote Control session on another machine by name, without needing ListAgents
CC v2.1.224 2026-08-07
- ADD
claude self-hosted-runner CLI command — turn your own machine or container into a session host for Claude Code web, mobile, and desktop sessions (Team and Enterprise plans)
- ADD
ANTHROPIC_BEDROCK_REGION_PREFIX env var — prefer a specific Bedrock cross-region inference profile over the AWS_REGION-derived one
- ADD
crossSessionInbound / dialogExpiry (JSON settings) — crossSessionInbound holds inbound cross-session messages for approval when the receiving session has bypassed permissions; dialogExpiry controls the approval dialog timeout
- CHG
sandbox.credentials — new masking options: extract/onExtractNoMatch for structured env values, decode: "jwt" with maskClaims for JWT-aware masking, awsPairs/sigv4 for AWS SigV4 re-signing; requires network.tlsTerminate
- CHG
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION — built-in 200-spawn limit removed; long-running sessions no longer refuse new agents by default; concurrency and depth limits still apply
- CHG
SendMessage — supports cross-session messaging across machines; use ListAgents to discover sessions (macOS and Linux)
- CHG
/plugin install — now supports archive source: install plugins from a zip over HTTPS without git or npm; optional SHA-256 pinning
CC v2.1.223 2026-08-06
- ADD
claude --teleport <session-id> — continue a cloud session locally; session ID shown in the /teleport hint that appears in cloud sessions
- CHG
/code-review [level] [pr#] — /review is now an alias; supports PR number as target; ultra level triggers a deep cloud review; effort level persists across invocations (no arg reuses last level)
- ADD
strictKnownMarketplaces / blockedMarketplaces (managed settings) — allowlist/blocklist marketplace repos as plugin sources; support "owner/*" wildcard for GitHub org-wide control
- ADD
CLAUDE_CODE_DISABLE_1M_CONTEXT env var — hold every model with a native 1M context window to 200K via auto-compaction; startup warning appears when auto-compaction isn't holding the session to 200K
- ADD
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 env var — opt out of auto-compact enforcement for sessions on unrecognized model IDs
CC v2.1.222 2026-08-04
- ADD
disable-model-invocation (skill frontmatter) — prevent Claude from auto-invoking the skill; Claude is told to ask you to run it manually instead
CC v2.1.221 2026-08-04
- CHG
/fork — forked sessions now create their own git worktree instead of working in the original session's checkout
- CHG
/status — now shows session kind: interactive, or a background job that is attached or unattended
- ADD
/plugin install <name> slash command — install from marketplace; refreshes stale catalog before failing; activates immediately when safe without requiring /reload-plugins
- ADD
claude plugin validate CLI command — validates plugin manifest; warns when a plugin or marketplace name would be rejected by Claude Desktop's managed marketplace sync
- CHG
sandbox.credentials — new mode: "mask" option (Linux/WSL): sandboxed commands read a sentinel copy; sandbox proxy substitutes the real value on egress; macOS falls back to deny
July 2026 v2.1.198 – v2.1.220 22 releases
CC v2.1.219 2026-07-24
- ADD
DirectoryAdded hook — fires after /add-dir or SDK register_repo_root registers a new working directory mid-session
- ADD
sandbox.network.strictAllowlist JSON setting — deny non-allowlisted hosts for sandboxed commands without prompting
- ADD
workflowSizeGuideline JSON setting — set the advisory Dynamic workflow size guideline from any settings file; /config row hidden while one is set
- CHG
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH — default nesting depth changed to 3 (was 1); set to 1 to disable nesting
CC v2.1.218 2026-07-22
- ADD
/deep-research slash command — structured deep-research session; must be explicitly invoked (Claude no longer auto-starts it)
- CHG
/code-review — now runs as a background subagent; review work no longer fills your conversation; keeps stacked slash commands as review target
- CHG
/mcp — shows HTTP status and error text when a server fails to connect; warns for MCP config values with hidden leading or trailing whitespace
- CHG
context: fork (skill frontmatter) — skills now run in the background by default; opt out per skill with background: false
- ADDFrontmatter booleans —
yes/no/on/off/1/0 now accepted alongside true/false in skill and plugin frontmatter
CC v2.1.217 2026-07-21
- ADD
emojiCompletionEnabled JSON setting — disable emoji shortcode autocomplete in the prompt input (e.g. :heart: → ❤️)
- ADD
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS env var — cap on concurrently-running subagents (default 20); prevents unbounded fan-out from a single message
- ADD
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH env var — allow nested subagent spawning; subagents no longer spawn nested subagents by default
- ADD
FORCE_HYPERLINK=0 env var — opt out of clickable hyperlinks in footer PR badge links (on by default even without terminal detection)
CC v2.1.216 2026-07-20
- ADD
sandbox.filesystem.disabled JSON setting — skip filesystem isolation while keeping network egress control
CC v2.1.215 2026-07-19
- ADD
/verify built-in skill — verify a code change works end-to-end; must be explicitly invoked (Claude no longer auto-runs it)
- CHG
/code-review — Claude no longer auto-runs it; must be explicitly invoked with /code-review
CC v2.1.214 2026-07-18
- ADD
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH env var — configure the 60 KB truncation limit on OpenTelemetry content attributes
- CHG
SessionStart hook — now reports source "fork" when a session begins as a fork instead of "resume"
- CHG
if: hook field — single-segment dir/** conditions now match only <cwd>/dir; write **/dir/** for any-depth matching (deny/ask permission rules keep any-depth match)
CC v2.1.212 2026-07-17
- CHG
/fork — now copies conversation into a new background session (its own row in claude agents); old in-session subagent behavior moved to new /subtask
- ADD
/subtask slash command — launch an in-session subagent for the current task (formerly what /fork did)
- ADD
claude auto-mode reset — restore default auto-mode configuration; prompts for confirmation (--yes to skip)
- ADD
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION env var — session-wide limit on WebSearch tool calls (default 200)
- ADD
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION env var — per-session cap on subagent spawns (default 200); /clear resets the budget
- ADD
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS env var — threshold (ms) after which long-running MCP tool calls move to background automatically (default 120000); set to 0 to disable
- CHG
/resume — in the agent view, now opens a picker of past sessions including deleted ones and resumes the chosen session as a background session
CC v2.1.211 2026-07-15
- ADD
--forward-subagent-text CLI flag — include subagent text and thinking in --output-format stream-json output; paired with CLAUDE_CODE_FORWARD_SUBAGENT_TEXT env var
- ADD
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT env var — include subagent text and thinking in stream-json output; paired with --forward-subagent-text flag
- ADDVim mode
s / S — substitute char / substitute line in NORMAL mode, matching vim behavior
- CHG
/usage-credits — now asks for confirmation before sending request to organization admins
CC v2.1.210 2026-07-14
- ADD
Write(path) / NotebookEdit(path) / Glob(path) — deprecated permission-rule tool names; startup warns to use Edit(path) or Read(path) instead
CC v2.1.208 2026-07-14
- ADD
--ax-screen-reader CLI flag — opt-in plain-text rendering for screen reader users; also set via CLAUDE_AX_SCREEN_READER=1 env var or axScreenReader: true in settings
- ADD
CLAUDE_AX_SCREEN_READER=1 env var — enable screen reader mode; paired with --ax-screen-reader flag and axScreenReader JSON setting
- ADD
axScreenReader JSON setting — set to true for opt-in plain-text rendering for screen reader users
- ADD
vimInsertModeRemaps JSON setting — map two-key insert-mode sequences to keys in vim mode (e.g. jj → Escape)
- ADD
CLAUDE_CODE_PROCESS_WRAPPER env var — run every Claude Code self-spawn through a required corporate launcher executable
CC v2.1.207 2026-07-11
- ADD
disableAutoMode JSON setting — set to true to disable auto mode on Bedrock, Vertex AI, and Foundry (auto mode now available there by default without opt-in)
- ADD
$CLAUDE_PLUGIN_OPTION_<KEY> (hook env var) — access plugin config option values in exec-form hook commands; replaces rejected shell-form ${user_config.*}
- CHG
CLAUDE_CODE_ENABLE_AUTO_MODE — no longer needed; auto mode now available by default on Bedrock, Vertex AI, and Foundry
- CHG
autoMode settings — no longer read from .claude/settings.local.json; configure in ~/.claude/settings.json instead
CC v2.1.206 2026-07-09
- ADD
/commit-push-pr slash command — commit, push, and open a PR in one step; auto-allows git push to the repo's configured push remote (remote.pushDefault, or the sole remote) in addition to origin
- ADD
Ctrl X (Keys & Shortcuts) — in claude agents: permanently removes a completed session; deleted background jobs stay deleted
- CHG
/cd — now supports directory path suggestions, matching /add-dir behavior
- CHG
/doctor — now proposes trimming checked-in CLAUDE.md files by cutting content Claude could derive from the codebase
- CHG
EnterWorktree hook — now asks for confirmation before entering a git worktree outside the project's .claude/worktrees/ directory
CC v2.1.205 2026-07-08
- CHG
/doctor — upgraded to a full setup checkup that can diagnose and fix issues; /checkup added as alias
CC v2.1.203 2026-07-07
- ADD
roots/list MCP — additional working directories (from /add-dir) now included; notifications/roots/list_changed sent when the set changes
- ADD
/status slash command — show CC environment status and warnings (moved from startup output)
- CHG
Esc (Keys & Shortcuts) — now explicitly closes background-tasks, diff, and workflow detail views; left arrow no longer closes these views
CC v2.1.202 2026-07-06
- ADD
dynamicWorkflowSize JSON setting — controls how large Claude makes dynamic workflows (small/medium/large agent counts); advisory guideline, not a hard cap
CC v2.1.200 2026-07-03
- ADD
--permission-mode manual — new accepted value for the default permission mode; renamed from default — both values honored
- ADD
defaultMode JSON setting — set default permission mode; "manual" (formerly "default") — both values accepted
- CHG
permissionMode (agent frontmatter) — manual replaces default; both accepted
CC v2.1.199 2026-07-02
- ADD
/skill-a /skill-b [prompt] — stacked slash-skill invocations load up to 5 leading skills simultaneously
- CHG
CLAUDE_CODE_RETRY_WATCHDOG — raises default retry count for non-capacity transient errors to 300 and lifts the cap of 15 on CLAUDE_CODE_MAX_RETRIES
- CHG
CLAUDE_CODE_MAX_RETRIES — cap of 15 is lifted when CLAUDE_CODE_RETRY_WATCHDOG is set
CC v2.1.198 2026-07-01
- ADD
Notification hook — fires when a background agent session needs input or finishes; events: agent_needs_input / agent_completed
- ADD
/dataviz skill — chart and dashboard design guidance with a runnable color-palette validator
- DEL
/agents slash-command wizard removed — create or manage subagents by asking Claude or editing .claude/agents/ directly
June 2026 v2.1.160 – v2.1.197 32 releases
CC v2.1.197 2026-06-30
- CHG
/model — claude-sonnet-5 is now the default model with a native 1M-token context window
CC v2.1.196 2026-06-27
- CHG
mcp__name__.* (hook matcher) — hyphenated identifiers now exact-match; use glob suffix to match all tools from a hyphenated MCP server (e.g. mcp__brave-search__.*)
CC v2.1.195 2026-06-26
- ADD
CLAUDE_CODE_DISABLE_MOUSE_CLICKS env var — disable mouse click/drag/hover in fullscreen mode while keeping wheel scroll active
CC v2.1.193 2026-06-25
- ADD
autoMode.classifyAllShell JSON setting — route all Bash/PowerShell commands through the auto-mode classifier instead of only arbitrary-code-execution patterns
- ADD
OTEL_LOG_ASSISTANT_RESPONSES env var — opt in to emitting the model's response text as an OTEL log event (claude_code.assistant_response); when unset, follows OTEL_LOG_USER_PROMPTS; set to 0 to log prompts but not responses
- ADD
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1 env var — disable automatic memory-pressure reaping of idle background shell commands
CC v2.1.191 2026-06-24
- CHG
/rewind — now supports resuming a conversation from before /clear was run
- ADD
"Bash,PowerShell" (hook matcher) — comma-separated tool type names in a hook's matcher field fire the hook on any of the listed types
CC v2.1.187 2026-06-23
- ADD
sandbox.credentials JSON setting — block sandboxed commands from reading credential files and secret environment variables
- ADD
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT env var — override the default 5-minute idle timeout for remote MCP tool calls; stalled calls abort with an error instead of blocking indefinitely
- CHG
/btw — ←/→ arrow navigation to step through earlier answers
- ADD
/install-github-app slash command — install GitHub App with optional GitHub Actions workflow and repo secret setup
- CHG
/plugin list — surfaces recently-unused plugins for cleanup
- CHG
/model — org-restricted models show "restricted by your organization's settings"
CC v2.1.186 2026-06-22
- ADD
claude mcp login/logout <name> — authenticate or de-authenticate an MCP server from the CLI without opening /mcp; --no-browser redirects auth code to stdin for SSH completion
- CHG
/workflows — press f in the agent detail view to filter sessions by status
- ADD
teammateMode: "iterm2" JSON setting — use iTerm2 as the teammate backend; warns when auto mode cannot find the it2 CLI
- ADD
awsAuthRefresh JSON setting — configures "Claude Platform on AWS — refresh credentials" option in /login
- ADD
respondToBashCommands JSON setting — set to false to keep ! bash command output as context-only (default: Claude responds automatically)
- ADD
CLAUDE_CODE_MAX_RETRIES env var — capped at 15; for unattended sessions use CLAUDE_CODE_RETRY_WATCHDOG instead
- ADD
CLAUDE_CODE_RETRY_WATCHDOG env var — retry watchdog for unattended sessions; replaces high CLAUDE_CODE_MAX_RETRIES values
CC v2.1.183 2026-06-19
- ADD
attribution.sessionUrl JSON setting — set to false to omit the claude.ai session link from commits and PRs in web and Remote Control sessions
- ADD
/config --help — list all available shorthand keys for /config key=value
- CHG
/config toggle — Enter and Space both change the selected setting; Esc now saves and closes instead of reverting
CC v2.1.181 2026-06-17
- ADD
/config key=value — set any setting from the prompt (e.g. /config thinking=false); works in interactive, -p, and Remote Control
- ADD
sandbox.allowAppleEvents JSON setting — opt-in macOS setting to allow sandboxed commands to send Apple Events
- ADD
CLAUDE_CLIENT_PRESENCE_FILE env var — path to a marker file; while the file exists, mobile push notifications are suppressed
CC v2.1.178 2026-06-15
- ADD
Tool(param:value) permission rule syntax — match a tool's input parameters (supports * wildcard); e.g. Agent(model:opus) to block Opus subagents
- CHG
.claude/skills/<name>/ — nested skill directories now load when working on files there; name clashes use <dir>:<name> form
CC v2.1.176 2026-06-12
- ADD
language JSON setting — pin session-title language; titles auto-detect the conversation language by default; set to a BCP 47 tag (e.g. en, ja) to override
- ADD
footerLinksRegexes JSON setting — array of regex patterns for regex-matched link badges in the footer row; configurable via user or managed settings
CC v2.1.175 2026-06-12
- ADD
enforceAvailableModels managed setting — when enabled, the availableModels allowlist constrains the Default model (a Default that resolves to a disallowed model falls back to the first allowed model); user or project settings cannot widen a managed availableModels list
CC v2.1.174 2026-06-12
- ADD
wheelScrollAccelerationEnabled JSON setting — set to false to disable mouse-wheel scroll acceleration in fullscreen mode
CC v2.1.172 2026-06-10
- CHG
SubagentStart / SubagentStop — sub-agents can now spawn their own sub-agents, up to 5 levels deep
- CHG
/plugin list — search bar now available when browsing marketplace plugins
CC v2.1.169 2026-06-08
- ADD
/cd slash command — move session to a new working directory without breaking the prompt cache mid-session
- ADD
--safe-mode CLI flag — start with all customizations (CLAUDE.md, plugins, skills, hooks, MCP servers) disabled for troubleshooting; paired with CLAUDE_CODE_SAFE_MODE env var
- ADD
CLAUDE_CODE_SAFE_MODE env var — paired with --safe-mode CLI flag
- ADD
disableBundledSkills JSON setting — hide bundled skills, workflows, and built-in slash commands from the model; paired with CLAUDE_CODE_DISABLE_BUNDLED_SKILLS env var
- ADD
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS env var — hide bundled skills, workflows, and built-in slash commands from the model; paired with disableBundledSkills JSON setting
- ADD
API_FORCE_IDLE_TIMEOUT=0 env var — opt out of the default 5-minute idle timeout on Vertex/Foundry
- CHG
claude agents --json — now includes id and state fields; new --all flag includes completed sessions
CC v2.1.166 2026-06-06
- ADD
fallbackModel JSON setting — configure up to three fallback models tried in order when the primary model is overloaded or unavailable
- ADD
--thinking disabled CLI flag — disable thinking on models that think by default; equivalent to MAX_THINKING_TOKENS=0 or the per-model thinking toggle
- CHG
--fallback-model — now also applies to interactive sessions (previously headless only)
- CHG
MAX_THINKING_TOKENS — setting to 0 now disables thinking on models that think by default via the Claude API
- ADD
"*" (deny rule glob) — glob patterns now supported in deny rule tool-name position; "*" denies all tools; allow rules reject non-MCP globs; unknown tool names warn at startup
CC v2.1.163 2026-06-04
- ADD
requiredMinimumVersion / requiredMaximumVersion managed settings — CC refuses to start if its version is outside the allowed range; directs user to an approved version
- ADD
/plugin list slash command — list installed plugins; --enabled/--disabled filters
- CHG
/btw — press c to copy raw markdown answer to clipboard
- CHG
Stop / SubagentStop hooks — can now return hookSpecificOutput.additionalContext to give Claude feedback and continue the turn
- ADD
\$ escape syntax in skill command bodies — include a literal $ before a digit
CC v2.1.162 2026-06-03
- CHG
/terminal-setup — renamed Windsurf to Devin Desktop following the editor's rebrand
- CHG
claude agents --json — output now includes waitingFor field showing what a waiting session is blocked on
- CHG
/effort — now confirms when your chosen level will persist as the default for new sessions
CC v2.1.161 2026-06-02
- ADD
OTEL_RESOURCE_ATTRIBUTES env var — values now used as labels on metric datapoints; slice usage metrics by custom dimensions (e.g. team, repo)
CC v2.1.160 2026-06-02
- ADD
ultracode prompt trigger keyword — type in the prompt to start a dynamic workflow; highlighted in violet in the prompt input
May 2026 v2.1.126 – v2.1.159 23 releases
CC v2.1.158 2026-05-30
- ADD
CLAUDE_CODE_ENABLE_AUTO_MODE=1 env var — opt in to Auto mode on Bedrock, Vertex, and Foundry for Opus 4.7 and Opus 4.8
CC v2.1.157 2026-05-29
- ADD
claude plugin init <name> CLI command — scaffold a new plugin in .claude/skills
- ADD
agent JSON setting — default agent name honored for dispatched sessions in claude agents; override per-session with --agent <name>
- ADD
EnterWorktree hook event — fires on worktree entry; can now switch between Claude-managed worktrees mid-session
- CHG
claude agents — dispatch flags now include --agent <name>
- CHG
.claude/skills/<name>/ — plugins in .claude/skills directories now auto-loaded, no marketplace required
- CHG
/terminal-setup — now also disables GPU acceleration in VS Code, Cursor, and Windsurf to prevent garbled-text rendering
CC v2.1.154 2026-05-28
- ADD
/workflows slash command — view and manage dynamic workflow runs; orchestrates work across tens to hundreds of background agents for large, complex tasks
- ADD
claude --bg --exec '<cmd>' CLI flag — run a shell command as a background session you can attach to and detach from; also available as ! <cmd> in the claude agents TUI
- CHG
/simplify — now runs cleanup-only review (reuse, simplification, efficiency, altitude) and applies fixes; no longer invokes the full /code-review --fix bug hunt
- CHG
/effort / --effort — interactive slider labels renamed from Speed/Intelligence to Faster/Smarter; xhigh now Opus 4.8 only (was 4.7)
- CHG
CLAUDE_CODE_SESSION_ID / CLAUDECODE — now also injected into stdio MCP server subprocess environments
- CHG
claude mcp list/get — unapproved .mcp.json servers now shown as ⏸ Pending approval instead of auto-connecting
- DEL
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE — deprecated; use /model claude-opus-4-6[1m] then /fast on for Opus 4.6 fast mode
- ADD
defaultEnabled: false plugin manifest field (plugin.json) — plugin starts disabled; enable with /plugin or claude plugin enable
- CHG
/chrome — now shows browser selector to pick which connected browser to use when multiple are connected
CC v2.1.153 2026-05-28
- CHG
/model — selection now saved as default for new sessions; press s in picker to switch for current session only (replaces d)
- CHG
/doctor — now shows result of last update attempt; lists npm auto-update fix hints
- ADD
COLUMNS / LINES env vars — injected into status line command subprocesses for terminal-width sizing
CC v2.1.152 2026-05-27
- ADD
/reload-skills slash command — re-scan skill directories without restarting the session
- ADD
/simplify built-in skill — back as alias for /code-review --fix; applies review findings to working tree
- CHG
/code-review — new --fix flag applies findings to working tree (surfacing reuse/simplification/efficiency suggestions)
- ADD
disallowed-tools frontmatter field — remove tools from the model while a skill or slash command is active
- ADD
SessionStart hook — return reloadSkills: true to re-scan skills; set hookSpecificOutput.sessionTitle to name the session on startup/resume
- ADD
MessageDisplay hook event — transform or hide assistant message text as it is displayed
- ADD
pluginSuggestionMarketplaces managed setting — allowlist org marketplaces whose plugins may be suggested via context-aware tips
- CHG
--fallback-model — now activates for the rest of the session when the primary model is not found, not just overloaded
- CHG
Ctrl+O — in a collapsed thinking group, shows the full thinking
- ADDVim NORMAL mode
/ key — opens reverse history search (like Ctrl+R), matching bash/zsh vi-mode
- ADD
OTEL_METRICS_INCLUDE_ENTRYPOINT=true env var — opt in to app.entrypoint as an OpenTelemetry metric attribute
CC v2.1.149 2026-05-22
- CHG
/usage — per-category limits breakdown (skills, subagents, plugins, per-MCP-server cost)
- CHG
/diff — detail view now scrollable with arrows, j/k, PgUp/PgDn, Space, Home/End
- ADD
allowAllClaudeAiMcps — enterprise managed setting to load claude.ai cloud MCP connectors alongside managed-mcp.json
CC v2.1.147 2026-05-21
- CHG
Ctrl T — in claude agents: pin/unpin background session; pinned sessions stay alive when idle and restart in place for CC updates
CC v2.1.146 2026-05-21
- CHG
/simplify renamed to /code-review [effort] — optional effort level (e.g. /code-review high)
CC v2.1.145 2026-05-19
- ADD
claude agents --json — list live sessions as JSON for scripting (tmux-resurrect, status bars, session pickers)
- CHG
Stop / SubagentStop hook input — now includes background_tasks and session_crons fields
CC v2.1.144 2026-05-19
- CHG
/extra-usage renamed to /usage-credits; old name still works
- CHG
/model — now changes model for current session only; press d in the picker to set a default for new sessions
- CHG
/resume — background sessions (from --bg or agent view) now appear alongside interactive sessions in the picker, marked with bg
CC v2.1.143 2026-05-15
- ADD
worktree.bgIsolation JSON setting — set to "none" to disable worktree isolation for background sessions
CC v2.1.142 2026-05-14
- CHG
claude agents — new dispatch flags for configuring background sessions: --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, --dangerously-skip-permissions
- ADD
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1 env var — pin Fast mode to Opus 4.6; fast mode now defaults to Opus 4.7
CC v2.1.141 2026-05-13
- ADD
terminalSequence hook JSON output field — emit desktop notifications, window titles, and bells without a controlling terminal
- ADD
CLAUDE_CODE_PLUGIN_PREFER_HTTPS env var — clone GitHub plugin sources over HTTPS instead of SSH; for environments without a GitHub SSH key
- ADD
ANTHROPIC_WORKSPACE_ID env var — workload identity federation; scopes the minted token to a specific workspace when the federation rule covers more than one
- CHG
claude agents — new --cwd <path> flag scopes the session list to a directory
CC v2.1.139 2026-05-11
- ADD
claude agents CLI command — agent view (Research Preview): a single list of every CC session — running, blocked on you, or done
- ADD
/goal [condition] slash command — set a completion condition; Claude keeps working across turns until met; works in interactive, -p, and Remote Control; shows elapsed/turns/tokens overlay
- ADD
/scroll-speed slash command — tune mouse wheel scroll speed with a live preview
- ADD
claude plugin details <name> CLI command — show plugin component inventory and projected per-session token cost
- ADDTranscript view nav keys:
? for shortcuts, {/} to jump between user prompts, v to toggle shortcut panel
- ADD
args: string[] hook field (exec form) — spawns command directly without a shell; path placeholders never need quoting
- ADD
continueOnBlock hook option for PostToolUse — feeds hook's rejection reason back to Claude and continues the turn
- ADD
CLAUDE_PROJECT_DIR env var — injected into MCP stdio server environments; referenceable as ${CLAUDE_PROJECT_DIR} in plugin configs
CC v2.1.136 2026-05-08
- ADD
autoMode.hard_deny JSON setting — auto mode classifier rules that block unconditionally regardless of user intent; unlike autoMode.soft_deny, cannot be overridden by allow exceptions
- ADD
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL env var — re-enable session quality survey for enterprises capturing responses through OpenTelemetry
CC v2.1.133 2026-05-07
- ADD
worktree.baseRef JSON setting — fresh (default) branches worktrees from origin/<default>; head branches from local HEAD; applies to --worktree, EnterWorktree, and agent-isolation
- ADD
sandbox.bwrapPath / sandbox.socatPath managed settings — custom bubblewrap and socat binary paths (Linux/WSL)
- ADD
parentSettingsBehavior admin-tier key — first-wins or merge; opts SDK managedSettings parent tier into policy merge
- ADD
--remote-control CLI flag — enable Remote Control mode; bridges CLI session to claude.ai/code
- CHG
effort.level JSON input field — now also injected into hooks; previously status line only
- CHG
${CLAUDE_EFFORT} description — now available in hooks and Bash tool commands, not just skill content
CC v2.1.132 2026-05-06
- ADD
CLAUDE_CODE_SESSION_ID env var — Session ID injected into Bash tool subprocess environment, matching the session_id passed to hooks
- ADD
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 env var — Opt out of the fullscreen alternate-screen renderer; keeps conversation in the terminal's native scrollback
CC v2.1.129 2026-05-06
- CHG
Ctrl R — History picker now searches all projects by default; press Ctrl+S to narrow to current project or session
- ADD
--plugin-url <url> CLI flag — Fetch a plugin .zip archive from a URL for the current session
- ADD
skillOverrides JSON setting — off hides from model and /; user-invocable-only hides from model only; name-only collapses description
- ADD
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 env var — Force-enable synchronized output on terminals that auto-detection misses (e.g. Emacs eat)
- ADD
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE env var — On Homebrew or WinGet installs, runs the upgrade command in the background and prompts to restart when set
- ADD
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 env var — Opt in to listing gateway /v1/models in the /model picker when using a custom ANTHROPIC_BASE_URL gateway (was automatic in v2.1.126–v2.1.128)
CC v2.1.128 2026-05-04
- CHG
/color [color] — Bare /color with no args now picks a random session color
- CHG
/mcp — Now shows tool count for each connected server and flags servers with 0 tools
- CHG
--channels — Now works with console (API key) auth; console orgs with managed settings must set channelsEnabled: true
- ADD
channelsEnabled JSON setting — Enable --channels with console auth for managed-settings orgs
- ADD
--plugin-dir <path> CLI flag — Load plugins from a directory or .zip archive at launch
CC v2.1.126 2026-05-01
- ADD
claude project purge [path] CLI subcommand — Delete all Claude Code state for a project (transcripts, tasks, file history, config entry); supports --dry-run, -y/--yes, -i/--interactive, and --all
- CHG
--dangerously-skip-permissions — Now bypasses prompts for writes to .claude/, .git/, .vscode/, shell config files, and other protected paths (catastrophic removal commands still prompt)
- CHG
/model — Picker lists models from gateway's /v1/models endpoint when ANTHROPIC_BASE_URL points at a compatible gateway
- CHG
claude auth login — Accepts OAuth code pasted in terminal when browser callback can't reach localhost (WSL2, SSH, containers)
April 2026 v2.1.89 – v2.1.123 17 releases
CC v2.1.122–v2.1.123 2026-04-29
- ADD
ANTHROPIC_BEDROCK_SERVICE_TIER env var — Select a Bedrock service tier (default, flex, or priority); sent as the X-Amzn-Bedrock-Service-Tier header
CC v2.1.120–v2.1.121 2026-04-28
- ADD
claude ultrareview [target] CLI subcommand — Run /ultrareview non-interactively from CI or scripts; prints findings to stdout; --json for raw output
- ADD
${CLAUDE_EFFORT} skill template variable — Reference current effort level in skill content
- ADD
alwaysLoad MCP server config option — All tools from that server skip tool-search deferral when true
- ADD
claude plugin prune CLI command — Remove orphaned auto-installed plugin dependencies; plugin uninstall --prune cascades
- CHG
/skills — Now includes a type-to-filter search box for long skill lists
- CHG
PostToolUse — Can now replace tool output via hookSpecificOutput.updatedToolOutput for all tools (was MCP-only)
- CHG
CLAUDE_CODE_FORK_SUBAGENT=1 — Now also works in non-interactive sessions
- CHG
--dangerously-skip-permissions — No longer prompts for writes to .claude/skills/, .claude/agents/, and .claude/commands/
- CHG
/terminal-setup — Now also enables iTerm2 clipboard access for /copy
CC v2.1.119 2026-04-23
- ADD
prUrlTemplate JSON setting — Point footer PR badge at a custom code-review URL instead of github.com
- ADD
CLAUDE_CODE_HIDE_CWD env var — Hide working directory in the startup logo
- ADD
PostToolUseFailure hook event — Fires when a tool call fails; hook input includes duration_ms
- ADD
effort.level / thinking.enabled status line stdin JSON input fields — current effort level and thinking state
- CHG
--from-pr — Description updated to note it now accepts GitLab MR, Bitbucket PR, and GitHub Enterprise URLs
- CHG
PreToolUse / PostToolUse — Description updated to note PostToolUse hook input now includes duration_ms (tool exec time)
CC v2.1.118 2026-04-23
- ADD
/usage slash command — Unified usage view (cost + stats tabs); /cost and /stats become shortcuts that open the relevant tab
- CHG
/stats — Description updated to note it is now a shortcut to the /usage stats tab
- ADDVim Mode section in Keys & Shortcuts —
v / V enter visual / visual-line selection mode in NORMAL mode
- ADD
type: "mcp_tool" hook type — Hooks can now directly invoke MCP tools
- ADD
DISABLE_UPDATES env var — Block all update paths including manual claude update; stricter than DISABLE_AUTOUPDATER
- ADD
wslInheritsWindowsSettings JSON setting (policy key) — WSL sessions inherit Windows-side managed settings
- ADD
"$defaults" (autoMode) JSON setting — Include in autoMode.allow, autoMode.soft_deny, or autoMode.environment to add custom rules alongside the built-in list
- ADD
claude plugin tag CLI command — Create release git tags for plugins with version validation
- CHG
/theme — Description updated to note named custom themes via ~/.claude/themes/ and plugin theme shipping
CC v2.1.117 2026-04-22
- ADD
CLAUDE_CODE_FORK_SUBAGENT=1 env var — Enable forked subagents on external builds
- ADD
mcpServers agent frontmatter field — Loaded for main-thread agent sessions via --agent
- CHG
/model — Description updated to note selections persist across restarts; startup header shows model pin source
- CHG
/resume — Description updated to note it offers to summarize stale large sessions before re-reading
CC v2.1.116 2026-04-20
- CHG
/terminal-setup — description updated to note scroll sensitivity configuration in VS Code, Cursor, and Windsurf
- CHG
/config — description updated to note search matches option values
- CHG
/doctor — description updated to note openable while Claude is responding
- CHG
/reload-plugins — description updated to note auto-installs missing dependencies from added marketplaces
- ADD
hooks: agent frontmatter field — fires when running as main-thread agent via --agent
CC v2.1.113 2026-04-17
- ADD
sandbox.network.deniedDomains JSON setting — Block specific domains even when a broader allowedDomains wildcard would otherwise permit them
- ADD
Ctrl A / Ctrl E (multiline input) — Move to start/end of current logical line, matching readline behavior
- ADD
Ctrl Backspace (Windows) — Delete previous word
- ADD
/extra-usage slash command — Request extra usage allowance; now also available from Remote Control clients
CC v2.1.110–v2.1.112 2026-04-16
- ADD
/tui [fullscreen] slash command — Switch to flicker-free fullscreen TUI rendering in same conversation
- ADD
/focus slash command — Toggle focus view in fullscreen/TUI mode
- CHG
Ctrl O — Now toggles between normal and verbose transcript only; focus view moved to /focus
- ADD
autoScrollEnabled JSON setting — Disable conversation auto-scroll in fullscreen mode
- ADD
tui JSON setting — Default TUI mode; set to "fullscreen" for flicker-free alt-screen rendering
- ADD
TRACEPARENT / TRACESTATE env vars — Distributed trace context for SDK/headless sessions
- CHG
/effort [level] — Added xhigh level (Opus 4.7 only); no-arg invocation opens interactive slider
- CHG
--effort — Updated to include xhigh level (Opus 4.7 only)
- ADD
/less-permission-prompts skill — Scan transcripts for read-only Bash/MCP calls; propose settings.json allowlist
- ADD
/ultrareview [PR#] skill — Cloud code review via parallel agents; no args for current branch, PR# for specific PR
- ADD
Ctrl U key — Clear entire input buffer
- ADD
Ctrl Y key — Restore input buffer cleared by Ctrl+U
- ADDTranscript view:
[ dump to scrollback, v open in editor
- ADD
CLAUDE_CODE_USE_POWERSHELL_TOOL env var — Enable PowerShell tool; Windows opt in/out, Linux/macOS requires pwsh on PATH
- ADD
OTEL_LOG_RAW_API_BODIES env var — Emit full API request/response bodies as OTEL log events for debugging
- CHG
/theme — Added "Auto (match terminal)" option
CC v2.1.108–v2.1.109 2026-04-14
- ADD
/recap slash command — Summarize away context; auto-triggered on return or invoke manually
- ADD
/rewind / /undo slash commands — Rewind conversation; /undo is new alias for /rewind
- ADD
Ctrl A session picker key — Show all projects (picker now defaults to current directory)
- ADD
ENABLE_PROMPT_CACHING_1H env var — Opt into 1-hour prompt cache TTL (API key, Bedrock, Vertex, Foundry)
- ADD
FORCE_PROMPT_CACHING_5M env var — Force 5-minute prompt cache TTL
- ADD
CLAUDE_CODE_ENABLE_AWAY_SUMMARY env var — Force-enable recap/away summary when telemetry disabled
- CHG
/model — Now warns before switching models mid-conversation
- CHG
/doctor — Press f to auto-fix reported issues (v2.1.105, missed in prior update)
CC v2.1.105 2026-04-13
- ADD
/proactive slash command — alias for /loop
- ADD
PreCompact hook event — fires before compaction; block by exiting with code 2 or returning {"decision":"block"}
- ADD
monitors plugin manifest key — background monitor support; auto-arms at session start or on skill invoke
CC v2.1.101 2026-04-10
- ADD
/team-onboarding slash command — Generate teammate ramp-up guide from local CC usage
- ADD
CLAUDE_CODE_CERT_STORE=bundled env var — Use only bundled CAs; by default OS CA cert store is now trusted (enterprise TLS proxy support)
- ADD
OTEL_LOG_USER_PROMPTS / OTEL_LOG_TOOL_DETAILS / OTEL_LOG_TOOL_CONTENT env vars — OTEL beta tracing: opt in to emit sensitive span attributes
CC v2.1.98 2026-04-09
- ADD
CLAUDE_CODE_PERFORCE_MODE env var — Edit/Write/NotebookEdit fail on read-only files with a p4 edit hint
- ADD
CLAUDE_CODE_SCRIPT_CAPS env var — Limit per-session script invocations (subprocess sandboxing)
- CHG
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB — Description updated to include PID namespace isolation on Linux
- ADD
--exclude-dynamic-system-prompt-sections CLI flag — Exclude dynamic prompt sections in print mode for cross-user prompt caching
- ADD
workspace.git_worktree status line JSON input field — Set when current directory is inside a linked git worktree
CC v2.1.97 2026-04-08
- CHG
Ctrl O — Description updated to note focus view toggle in NO_FLICKER mode
- ADD
statusLine.refreshInterval JSON setting — Re-run status line command every N seconds
CC v2.1.94 2026-04-07
- ADD
CLAUDE_CODE_USE_MANTLE=1 env var — Enable Amazon Bedrock powered by Mantle
- ADD
keep-coding-instructions skill frontmatter field — Control plugin output style for coding tasks
- ADD
UserPromptSubmit hook event — Fires on user prompt submit; supports hookSpecificOutput.sessionTitle to set session title
CC v2.1.92 2026-04-04
- ADD
forceRemoteSettingsRefresh JSON setting — Block startup until remote managed settings are freshly fetched; fail-closed on fetch failure
- ADD
/release-notes slash command — Interactive version picker for release notes
- ADD
--remote-control-session-name-prefix CLI flag — Custom hostname prefix for Remote Control session names
- CHG
/cost — Description updated to reflect per-model and cache-hit breakdown
- DEL
/vim slash command removed — toggle vim mode via /config → Editor mode
CC v2.1.91 2026-04-02
- ADD
disableSkillShellExecution JSON setting — Disable inline shell execution in skills and custom slash commands
- ADD
_meta["anthropic/maxResultSizeChars"] MCP annotation — Override max result size per tool call (up to 500K chars)
- ADD
plugin: bin/ — Plugin executables in bin/ invocable as bare commands from Bash tool
CC v2.1.89–v2.1.90 2026-04-01
- ADD
/powerup slash command — Interactive lessons teaching CC features with animated demos
- ADD
MCP_CONNECTION_NONBLOCKING=true env var — Skip MCP connection wait in headless (-p) mode
- ADD
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE env var — Keep marketplace cache when git pull fails (offline envs)
- ADD
"defer" PreToolUse hook decision — Headless sessions pause at tool call; resume with -p --resume to re-evaluate
March 2026 v2.1.82 – v2.1.88 3 releases + template redesign
CC v2.1.88 2026-03-31
- ADD
CLAUDE_CODE_NO_FLICKER=1 env var — Opt into flicker-free alt-screen rendering with virtualized scrollback
- ADD
PermissionDenied hook event — Fires after auto mode classifier denials; return {retry:true} to allow retry
- ADD
showThinkingSummaries JSON setting — Show thinking summaries in interactive sessions (default: false since v2.1.88)
CC v2.1.86 2026-03-28
- ADD
CLAUDE_CODE_MCP_SERVER_NAME / CLAUDE_CODE_MCP_SERVER_URL — Inject server identity into MCP headersHelper scripts, enabling one helper to serve multiple servers (v2.1.85)
CC v2.1.82–v2.1.85 2026-03-27
- CHG
Ctrl F → Ctrl X K for killing background agents (v2.1.83)
- ADD
CwdChanged / FileChanged hook events (v2.1.83)
- ADD
initialPrompt agent frontmatter field (v2.1.83)
- ADD
managed-settings.d/ drop-in policy directory (v2.1.83)
- ADD
TaskCreated hook event (v2.1.84)
- ADD
if: conditional field for hooks (v2.1.85)
- ADD
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB env var (v2.1.83)
- FIXFixed
SubAgentStart → SubagentStart casing
Template v1.1 Redesign 2026-03-27
- CHGComplete visual redesign — darker theme, tighter spacing, compact layout
- CHGReplaced badge system (NEW/UNVERIFIED tags) with shaded code backgrounds + top legend
- CHGCard h2 headings now uppercase with letter-spacing
- CHGGrid minimum column width reduced from 420px to 340px
- CHGCode elements now use
word-break: break-word instead of break-all
- ADDRow hover highlight on all tables
- ADD8-bit Claude Code minion icon in header
- FIXFixed truncated code elements (e.g.,
--dangerously-skip-permissions was --dangerously-skip...)
- CHGTitle restored to "Claude Code Reference Dashboard"
- CHGHeader restructured: title + icon left, "As of release: vX.X.XX" + changelog link + theme + search right
- CHGFooter now tracks template version separately from CC release version
- CHGCommand Builder: model dropdown replaced with
--effort selector
- CHGCommand Builder: Verbose/Think checkboxes replaced with
--bare checkbox
- ADDSlash Commands (Tools) card — /init, /memory, /mcp, /hooks, /skills, /agents, /chrome, /add-dir, /btw, /loop, /schedule, /voice, /doctor, /pr-comments, /security-review, /stats, /desktop, /remote-control, /reload-plugins
- ADDConfig & Environment card — settings file priority, JSON settings, environment variables, managed-settings.d/
- ADDSkills & Agent Frontmatter card — skill YAML fields, agent YAML fields, built-in skills
- ADDMemory, Hooks & MCP card — rules, auto-memory, event hooks, MCP serve mode, elicitation
- ADD~30 new slash commands across two cards (Core + Tools)
- ADD
Ctrl L — Clear screen + full redraw
- ADD
Ctrl O — Toggle verbose / transcript mode
- ADD
Ctrl J — Newline (control sequence)
- ADD
Tab — Cycle permission modes
- ADD
\ P — Switch model
- ADD
\ T — Toggle thinking
- ADDSession Picker Nav section (P, R, /, A, B keys)
- ADD
--bare CLI flag — Minimal headless mode
- ADD
--channels CLI flag — Permission relay / MCP push messages
- ADD
--effort CLI flag — Set effort level at launch
- DELRemoved "Extension System & Auth" card — replaced with granular cards
- DELRemoved "Workflow & Custom Commands" card
- DELRemoved
.col-2 layout, .tip blocks
- DELRemoved
/review, /teleport, /plugin
- DELRemoved duplicate Ctrl F fast mode entry
- DELRemoved
Shift+Tab, Cmd+P, Enter, Esc standalone entries (restructured)
Template v1.0 2026-03 — As of CC v2.1.81
March 2026 Initial release
Template & Features
- ADDDark/light theme toggle with Anthropic brand colors
- ADDGlobal search with hierarchical filtering (Ctrl+K)
- ADDClick-to-copy on all
code elements with flash animation
- ADDCommand Builder with model selector, output format, verbose/think flags
- ADDResponsive mobile layout
- ADDBadge system for NEW, UNVERIFIED, and PRO items
Content Cards
- ADDKeyboard Shortcuts card — submission, interrupts, navigation, UI
- ADDSlash Commands card — session/context, project development, advanced
- ADDCLI Launch Flags card — launch types, behavior, context flags
- ADDExtension System & Auth card — Big 5 overview, auth commands
- ADDHooks & File Structure card — event hooks, .claude/ directory map
- ADDWorkflow & Custom Commands card — common combos, command variables