Claude Code Placemat

Template v1.1 2026-03-27 — As of CC v2.1.85

August 2026 v2.1.221 – v2.1.246 23 releases

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

ADDmodelPicker 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
ADDmodelPricing 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
ADDpromptCacheTtl / 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

ADDclaude 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
CHGkeybindingFlavor: "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
CHGListAgents / SendMessage — ListAgents now reports the session's own name (the identifier peers use to message it) and includes live teammates in its listing
CHGCLAUDE_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

ADDkeybindingFlavor JSON setting — set to "readline" to make Ctrl+W delete back to previous whitespace (Bash-style); default "classic" unchanged
ADDheadersHelper (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)
ADDclaude 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
ADDclaude 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
CHGCtrl L / Cmd+K in fullscreen — now always just repaints; the double-press /clear shortcut was removed
CHGclaude 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

ADDoutputStyle JSON setting — "concise" makes Claude lead with results and skip preamble/narration; configure via /config → Output style

CC v2.1.236 2026-08-19

ADDANTHROPIC_DEFAULT_MODEL env var — sets the model new sessions start on; a /model pick still overrides it and persists across restarts, unlike ANTHROPIC_MODEL
CHGSendMessage — 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

ADDspellcheck JSON setting — underline misspelled words in the prompt input as you type; requires aspell, hunspell, or ispell

CC v2.1.234 2026-08-17

ADDselection: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
ADDCLAUDE_CODE_PROJECT_DIR_NAME env var — custom short name for the per-project transcript directory
ADDCLAUDE_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

ADDCLAUDE_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
ADDCLAUDE_CODE_WEBFETCH_CACHE_TTL_MS env var — configure the WebFetch session URL cache TTL in milliseconds (default: 15 minutes)
ADDCLAUDE_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
CHGclaude 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)
ADDadditionalMarketplaces JSON setting — friendlier alias for extraKnownMarketplaces; add plugin marketplace repos beyond the built-in list
CHGstrictKnownMarketplaces — now also accepted as allowedMarketplaces

CC v2.1.229 2026-08-12

ADDclaude 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
ADDCLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS=0 env var — set to 0 to disable automatic staggering of same-prefix sibling workflow agents
ADDcommand (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

CHGSendMessage — 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

ADDclaude 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)
ADDANTHROPIC_BEDROCK_REGION_PREFIX env var — prefer a specific Bedrock cross-region inference profile over the AWS_REGION-derived one
ADDcrossSessionInbound / dialogExpiry (JSON settings) — crossSessionInbound holds inbound cross-session messages for approval when the receiving session has bypassed permissions; dialogExpiry controls the approval dialog timeout
CHGsandbox.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
CHGCLAUDE_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
CHGSendMessage — 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

ADDclaude --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)
ADDstrictKnownMarketplaces / blockedMarketplaces (managed settings) — allowlist/blocklist marketplace repos as plugin sources; support "owner/*" wildcard for GitHub org-wide control
ADDCLAUDE_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
ADDCLAUDE_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

ADDdisable-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
ADDclaude plugin validate CLI command — validates plugin manifest; warns when a plugin or marketplace name would be rejected by Claude Desktop's managed marketplace sync
CHGsandbox.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

ADDDirectoryAdded hook — fires after /add-dir or SDK register_repo_root registers a new working directory mid-session
ADDsandbox.network.strictAllowlist JSON setting — deny non-allowlisted hosts for sandboxed commands without prompting
ADDworkflowSizeGuideline JSON setting — set the advisory Dynamic workflow size guideline from any settings file; /config row hidden while one is set
CHGCLAUDE_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
CHGcontext: 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

ADDemojiCompletionEnabled JSON setting — disable emoji shortcode autocomplete in the prompt input (e.g. :heart: → ❤️)
ADDCLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS env var — cap on concurrently-running subagents (default 20); prevents unbounded fan-out from a single message
ADDCLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH env var — allow nested subagent spawning; subagents no longer spawn nested subagents by default
ADDFORCE_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

ADDsandbox.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

ADDCLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH env var — configure the 60 KB truncation limit on OpenTelemetry content attributes
CHGSessionStart hook — now reports source "fork" when a session begins as a fork instead of "resume"
CHGif: 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)
ADDclaude auto-mode reset — restore default auto-mode configuration; prompts for confirmation (--yes to skip)
ADDCLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION env var — session-wide limit on WebSearch tool calls (default 200)
ADDCLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION env var — per-session cap on subagent spawns (default 200); /clear resets the budget
ADDCLAUDE_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
ADDCLAUDE_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

ADDWrite(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
ADDCLAUDE_AX_SCREEN_READER=1 env var — enable screen reader mode; paired with --ax-screen-reader flag and axScreenReader JSON setting
ADDaxScreenReader JSON setting — set to true for opt-in plain-text rendering for screen reader users
ADDvimInsertModeRemaps JSON setting — map two-key insert-mode sequences to keys in vim mode (e.g. jj → Escape)
ADDCLAUDE_CODE_PROCESS_WRAPPER env var — run every Claude Code self-spawn through a required corporate launcher executable

CC v2.1.207 2026-07-11

ADDdisableAutoMode 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.*}
CHGCLAUDE_CODE_ENABLE_AUTO_MODE — no longer needed; auto mode now available by default on Bedrock, Vertex AI, and Foundry
CHGautoMode 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
ADDCtrl 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
CHGEnterWorktree 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

ADDroots/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)
CHGEsc (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

ADDdynamicWorkflowSize 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
ADDdefaultMode JSON setting — set default permission mode; "manual" (formerly "default") — both values accepted
CHGpermissionMode (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
CHGCLAUDE_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
CHGCLAUDE_CODE_MAX_RETRIES — cap of 15 is lifted when CLAUDE_CODE_RETRY_WATCHDOG is set

CC v2.1.198 2026-07-01

ADDNotification 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

CHGmcp__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

ADDCLAUDE_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

ADDautoMode.classifyAllShell JSON setting — route all Bash/PowerShell commands through the auto-mode classifier instead of only arbitrary-code-execution patterns
ADDOTEL_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
ADDCLAUDE_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

ADDsandbox.credentials JSON setting — block sandboxed commands from reading credential files and secret environment variables
ADDCLAUDE_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

ADDclaude 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
ADDteammateMode: "iterm2" JSON setting — use iTerm2 as the teammate backend; warns when auto mode cannot find the it2 CLI
ADDawsAuthRefresh JSON setting — configures "Claude Platform on AWS — refresh credentials" option in /login
ADDrespondToBashCommands JSON setting — set to false to keep ! bash command output as context-only (default: Claude responds automatically)
ADDCLAUDE_CODE_MAX_RETRIES env var — capped at 15; for unattended sessions use CLAUDE_CODE_RETRY_WATCHDOG instead
ADDCLAUDE_CODE_RETRY_WATCHDOG env var — retry watchdog for unattended sessions; replaces high CLAUDE_CODE_MAX_RETRIES values

CC v2.1.183 2026-06-19

ADDattribution.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
ADDsandbox.allowAppleEvents JSON setting — opt-in macOS setting to allow sandboxed commands to send Apple Events
ADDCLAUDE_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

ADDTool(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

ADDlanguage 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
ADDfooterLinksRegexes 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

ADDenforceAvailableModels 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

ADDwheelScrollAccelerationEnabled JSON setting — set to false to disable mouse-wheel scroll acceleration in fullscreen mode

CC v2.1.172 2026-06-10

CHGSubagentStart / 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
ADDCLAUDE_CODE_SAFE_MODE env var — paired with --safe-mode CLI flag
ADDdisableBundledSkills JSON setting — hide bundled skills, workflows, and built-in slash commands from the model; paired with CLAUDE_CODE_DISABLE_BUNDLED_SKILLS env var
ADDCLAUDE_CODE_DISABLE_BUNDLED_SKILLS env var — hide bundled skills, workflows, and built-in slash commands from the model; paired with disableBundledSkills JSON setting
ADDAPI_FORCE_IDLE_TIMEOUT=0 env var — opt out of the default 5-minute idle timeout on Vertex/Foundry
CHGclaude agents --json — now includes id and state fields; new --all flag includes completed sessions

CC v2.1.166 2026-06-06

ADDfallbackModel 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)
CHGMAX_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

ADDrequiredMinimumVersion / 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
CHGStop / 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
CHGclaude 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

ADDOTEL_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

ADDultracode 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

ADDCLAUDE_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

ADDclaude plugin init <name> CLI command — scaffold a new plugin in .claude/skills
ADDagent JSON setting — default agent name honored for dispatched sessions in claude agents; override per-session with --agent <name>
ADDEnterWorktree hook event — fires on worktree entry; can now switch between Claude-managed worktrees mid-session
CHGclaude 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
ADDclaude --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)
CHGCLAUDE_CODE_SESSION_ID / CLAUDECODE — now also injected into stdio MCP server subprocess environments
CHGclaude mcp list/get — unapproved .mcp.json servers now shown as ⏸ Pending approval instead of auto-connecting
DELCLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE — deprecated; use /model claude-opus-4-6[1m] then /fast on for Opus 4.6 fast mode
ADDdefaultEnabled: 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
ADDCOLUMNS / 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)
ADDdisallowed-tools frontmatter field — remove tools from the model while a skill or slash command is active
ADDSessionStart hook — return reloadSkills: true to re-scan skills; set hookSpecificOutput.sessionTitle to name the session on startup/resume
ADDMessageDisplay hook event — transform or hide assistant message text as it is displayed
ADDpluginSuggestionMarketplaces 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
CHGCtrl+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
ADDOTEL_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
ADDallowAllClaudeAiMcps — enterprise managed setting to load claude.ai cloud MCP connectors alongside managed-mcp.json

CC v2.1.147 2026-05-21

CHGCtrl 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

ADDclaude agents --json — list live sessions as JSON for scripting (tmux-resurrect, status bars, session pickers)
CHGStop / 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

ADDworktree.bgIsolation JSON setting — set to "none" to disable worktree isolation for background sessions

CC v2.1.142 2026-05-14

CHGclaude agents — new dispatch flags for configuring background sessions: --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, --dangerously-skip-permissions
ADDCLAUDE_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

ADDterminalSequence hook JSON output field — emit desktop notifications, window titles, and bells without a controlling terminal
ADDCLAUDE_CODE_PLUGIN_PREFER_HTTPS env var — clone GitHub plugin sources over HTTPS instead of SSH; for environments without a GitHub SSH key
ADDANTHROPIC_WORKSPACE_ID env var — workload identity federation; scopes the minted token to a specific workspace when the federation rule covers more than one
CHGclaude agents — new --cwd <path> flag scopes the session list to a directory

CC v2.1.139 2026-05-11

ADDclaude 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
ADDclaude 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
ADDargs: string[] hook field (exec form) — spawns command directly without a shell; path placeholders never need quoting
ADDcontinueOnBlock hook option for PostToolUse — feeds hook's rejection reason back to Claude and continues the turn
ADDCLAUDE_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

ADDautoMode.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
ADDCLAUDE_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

ADDworktree.baseRef JSON setting — fresh (default) branches worktrees from origin/<default>; head branches from local HEAD; applies to --worktree, EnterWorktree, and agent-isolation
ADDsandbox.bwrapPath / sandbox.socatPath managed settings — custom bubblewrap and socat binary paths (Linux/WSL)
ADDparentSettingsBehavior 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
CHGeffort.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

ADDCLAUDE_CODE_SESSION_ID env var — Session ID injected into Bash tool subprocess environment, matching the session_id passed to hooks
ADDCLAUDE_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

CHGCtrl 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
ADDskillOverrides JSON setting — off hides from model and /; user-invocable-only hides from model only; name-only collapses description
ADDCLAUDE_CODE_FORCE_SYNC_OUTPUT=1 env var — Force-enable synchronized output on terminals that auto-detection misses (e.g. Emacs eat)
ADDCLAUDE_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
ADDCLAUDE_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
ADDchannelsEnabled 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

ADDclaude 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
CHGclaude 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

ADDANTHROPIC_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

ADDclaude 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
ADDalwaysLoad MCP server config option — All tools from that server skip tool-search deferral when true
ADDclaude 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
CHGPostToolUse — Can now replace tool output via hookSpecificOutput.updatedToolOutput for all tools (was MCP-only)
CHGCLAUDE_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

ADDprUrlTemplate JSON setting — Point footer PR badge at a custom code-review URL instead of github.com
ADDCLAUDE_CODE_HIDE_CWD env var — Hide working directory in the startup logo
ADDPostToolUseFailure hook event — Fires when a tool call fails; hook input includes duration_ms
ADDeffort.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
CHGPreToolUse / 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
ADDtype: "mcp_tool" hook type — Hooks can now directly invoke MCP tools
ADDDISABLE_UPDATES env var — Block all update paths including manual claude update; stricter than DISABLE_AUTOUPDATER
ADDwslInheritsWindowsSettings 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
ADDclaude 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

ADDCLAUDE_CODE_FORK_SUBAGENT=1 env var — Enable forked subagents on external builds
ADDmcpServers 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
ADDhooks: agent frontmatter field — fires when running as main-thread agent via --agent

CC v2.1.113 2026-04-17

ADDsandbox.network.deniedDomains JSON setting — Block specific domains even when a broader allowedDomains wildcard would otherwise permit them
ADDCtrl A / Ctrl E (multiline input) — Move to start/end of current logical line, matching readline behavior
ADDCtrl 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
CHGCtrl O — Now toggles between normal and verbose transcript only; focus view moved to /focus
ADDautoScrollEnabled JSON setting — Disable conversation auto-scroll in fullscreen mode
ADDtui JSON setting — Default TUI mode; set to "fullscreen" for flicker-free alt-screen rendering
ADDTRACEPARENT / 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
ADDCtrl U key — Clear entire input buffer
ADDCtrl Y key — Restore input buffer cleared by Ctrl+U
ADDTranscript view: [ dump to scrollback, v open in editor
ADDCLAUDE_CODE_USE_POWERSHELL_TOOL env var — Enable PowerShell tool; Windows opt in/out, Linux/macOS requires pwsh on PATH
ADDOTEL_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
ADDCtrl A session picker key — Show all projects (picker now defaults to current directory)
ADDENABLE_PROMPT_CACHING_1H env var — Opt into 1-hour prompt cache TTL (API key, Bedrock, Vertex, Foundry)
ADDFORCE_PROMPT_CACHING_5M env var — Force 5-minute prompt cache TTL
ADDCLAUDE_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
ADDPreCompact hook event — fires before compaction; block by exiting with code 2 or returning {"decision":"block"}
ADDmonitors 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
ADDCLAUDE_CODE_CERT_STORE=bundled env var — Use only bundled CAs; by default OS CA cert store is now trusted (enterprise TLS proxy support)
ADDOTEL_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

ADDCLAUDE_CODE_PERFORCE_MODE env var — Edit/Write/NotebookEdit fail on read-only files with a p4 edit hint
ADDCLAUDE_CODE_SCRIPT_CAPS env var — Limit per-session script invocations (subprocess sandboxing)
CHGCLAUDE_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
ADDworkspace.git_worktree status line JSON input field — Set when current directory is inside a linked git worktree

CC v2.1.97 2026-04-08

CHGCtrl O — Description updated to note focus view toggle in NO_FLICKER mode
ADDstatusLine.refreshInterval JSON setting — Re-run status line command every N seconds

CC v2.1.94 2026-04-07

ADDCLAUDE_CODE_USE_MANTLE=1 env var — Enable Amazon Bedrock powered by Mantle
ADDkeep-coding-instructions skill frontmatter field — Control plugin output style for coding tasks
ADDUserPromptSubmit hook event — Fires on user prompt submit; supports hookSpecificOutput.sessionTitle to set session title

CC v2.1.92 2026-04-04

ADDforceRemoteSettingsRefresh 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

ADDdisableSkillShellExecution 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)
ADDplugin: 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
ADDMCP_CONNECTION_NONBLOCKING=true env var — Skip MCP connection wait in headless (-p) mode
ADDCLAUDE_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

ADDCLAUDE_CODE_NO_FLICKER=1 env var — Opt into flicker-free alt-screen rendering with virtualized scrollback
ADDPermissionDenied hook event — Fires after auto mode classifier denials; return {retry:true} to allow retry
ADDshowThinkingSummaries JSON setting — Show thinking summaries in interactive sessions (default: false since v2.1.88)

CC v2.1.86 2026-03-28

ADDCLAUDE_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

CHGCtrl F → Ctrl X K for killing background agents (v2.1.83)
ADDCwdChanged / FileChanged hook events (v2.1.83)
ADDinitialPrompt agent frontmatter field (v2.1.83)
ADDmanaged-settings.d/ drop-in policy directory (v2.1.83)
ADDTaskCreated hook event (v2.1.84)
ADDif: conditional field for hooks (v2.1.85)
ADDCLAUDE_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)
ADDCtrl L — Clear screen + full redraw
ADDCtrl O — Toggle verbose / transcript mode
ADDCtrl J — Newline (control sequence)
ADDTab — 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)