Claude Code

Summary

Claude Code is a commercial AI coding agent, built by Anthropic, that works across a codebase to build features, fix bugs, and handle git workflows through natural-language commands. It runs as a command-line tool installed via a native script, Homebrew, or WinGet, with the same functionality also reachable through IDE extensions, a desktop app, and the web, and most surfaces require a Claude subscription or Anthropic Console account. It's aimed at software developers who want to delegate routine coding tasks and codebase navigation to an agent rather than perform them by hand, and its permission model — with prompts before writing to shell startup files or build-tool configs that grant code execution — points to teams running it in environments where unreviewed automation is a real risk. The category is agentic coding tools, a space Claude Code sits in alongside other AI-driven development assistants rather than one it names competitors in.

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.

Command line

Values are placeholders taken from each option’s declared default. Nothing is executed here — the output shown is a recording of a run that already happened.

Release history

1. v2.1.251 Aug 28, 2026 · issue 009

   Claude Code v2.1.251 adds PreModelSwitch/PostModelSwitch hooks, subagent live streaming, spend-limit tracking, and prompt-cache cost reporting.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v2.1.251 https://github.com/anthropics/claude-code.git
   # already have the repo? check out this version:
   $ git checkout v2.1.251

   └──▷ TRY IT
   Attach to a running background session by ID — now surfaced directly in the --resume message and listed in claude --help.
   copy

   $ claude attach <id>

   • ›Adds PreModelSwitch and PostModelSwitch hook events, letting hooks block, confirm, or annotate a model switch; SessionStart resume hooks now also receive session staleness and the estimated re-cache cost.
   • ›Adds attach, logs, stop, respawn, and rm subcommands to claude --help; the --resume message for a running background session now names the exact claude attach <id> command to use.
   • ›Adds a rate_limits.spend_limit field to status line scripts and a Spend limit bar to /usage for developers behind a Claude apps gateway with spend limits.
   • ›Adds a per-session prompt-cache line to /cost showing hit ratio, misses, tokens re-cached, and warm/cold status, plus a matching prompt_cache object for status line scripts.
   • ›Adds live streaming of a foreground subagent's tool calls and results to Remote Control clients (background subagents still show status only).
   +10 moreshow less

   • ›Changes CLAUDE_CODE_SUBAGENT_MODEL to set the default subagent model rather than override everything — an agent definition's model: key and an explicit per-spawn model now take precedence over it.
   • ›Changes the footer PR badge on Bedrock, Vertex, and Foundry (and when telemetry is off) to call the GitHub API directly via gh auth token, GH_TOKEN, or GITHUB_TOKEN instead of gh pr view.
   • ›Changes /effort to save the default effort level per model, so each model keeps its own setting when switching.
   • ›Changes /radio to be available on Bedrock, Vertex AI, Foundry, and Claude Platform on AWS, and when telemetry is disabled.
   • ›Changes project-level .claude/settings.json env to no longer set CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR, or TMPDIR/TMP/TEMP; these must now be set in shell, user, or managed settings.
   • ›Changes ANTHROPIC_CUSTOM_HEADERS from managed or project settings to require approval when it sets a credential, org/tenant, routing, or API-behavior header (e.g. Authorization, Host).
   • ›Changes server-managed settings that terminate sandbox TLS, route sandbox traffic through a custom proxy, inject credentials, or weaken sandbox isolation to require approval before they apply.
   • ›Changes the default model for seat-based Enterprise subscriptions to Opus 5.
   • ›Changes the default commit trailer to Co-Authored-By: Claude Code when the active model is not a recognized Claude model (e.g. third-party models behind a custom ANTHROPIC_BASE_URL).
   • ›[VSCode] Changes the Remote Control banner to a footer pill (shown while Remote Control is on or has failed) that opens the session on claude.ai/code; toggle with /remote-control.
   └──▷ BREAKING ON UPGRADE

   • !Project-level .claude/settings.json env no longer sets CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR, or TMPDIR/TMP/TEMP; any working setup relying on this must move those variables to shell, user, or managed settings.
   • !CLAUDE_CODE_SUBAGENT_MODEL no longer overrides an agent definition's model: key or an explicit per-spawn model; teams using it to force a uniform subagent model will see per-agent or per-spawn overrides take effect instead.
2. v2.1.248 Aug 27, 2026 · issue 009

   Claude Code v2.1.248 adds --restricted sandboxed mode, per-agent cache TTL, cross-session messaging, and /usage-credits for Enterprise.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v2.1.248 https://github.com/anthropics/claude-code.git
   # already have the repo? check out this version:
   $ git checkout v2.1.248

   └──▷ TRY IT
   Run Claude Code in a locked-down sandbox — e.g. in CI or an untrusted repo — where it cannot execute shell commands, fetch URLs, or read settings outside the working directory.
   copy

   $ CLAUDE_CODE_RESTRICTED=1 claude --tools Edit,View

   Set a 1-hour prompt cache TTL on a long-running agent so its context survives across turns without a full cache miss.
   yaml copy

   experimental:
     cacheTtl: "1h"

   Register a self-hosted runner with a human-readable label instead of the default hostname, useful when multiple runners share the same machine.
   copy

   $ claude self-hosted-runner --client-label prod-worker-1

   • ›Adds --restricted flag (or CLAUDE_CODE_RESTRICTED=1 env var): strips command/code-execution tools and WebFetch, confines file tools to the working directory, refuses bypassPermissions, and ignores user, project, and local settings files — unless specific tools are re-enabled via --tools.
   • ›Adds experimental.cacheTtl ("5m" or "1h") to agent frontmatter for a per-agent prompt cache TTL when no subagent TTL setting is configured.
   • ›Adds claude self-hosted-runner --client-label <label> (or SELF_HOSTED_RUNNER_CLIENT_LABEL) to override the label the runner registers with (default: hostname).
   • ›Adds cross-session messaging via SendMessage and ListAgents between sessions on the same machine, now supported on Bedrock, Vertex, Foundry, and when telemetry is disabled.
   • ›Adds /usage-credits command for Enterprise organizations (AWS Marketplace billing, self-serve Enterprise, and Enterprise trials) so members can request higher usage limits from their admin.
   +5 moreshow less

   • ›Adds server-managed settings diagnostics: a startup warning when settings fail to load, plus /doctor and /status output explaining load failures or why settings weren't fetched (Bedrock/Vertex/third-party provider, custom ANTHROPIC_BASE_URL).
   • ›Adds a warning in /web-setup when the GitHub CLI token lacks the workflow scope, preventing silent push rejections on large repositories.
   • ›Adds desktopSessionCleanupPeriodDays setting to cap how long the exemption for desktop-written sessions from transcript cleanup applies.
   • ›Changes /loop: self-paced dynamic mode and the no-prompt autonomous default are now always available, including on Bedrock, Vertex, and Foundry.
   • ›Changes shift+enter in the agent view dispatch input to insert a newline; ctrl+enter now dispatches and attaches.
3. v2.1.247 Aug 26, 2026 · issue 009

   Claude Code v2.1.247 adds AI-drafted feedback reports, a cost-optimization profiler, Admin API coverage, and org-customizable spinner tips.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v2.1.247 https://github.com/anthropics/claude-code.git
   # already have the repo? check out this version:
   $ git checkout v2.1.247

   └──▷ TRY IT
   Profile an existing project's Claude API spend and step through cost-reduction levers interactively.
   copy

   $ /claude-api cost-optimize

   Prevent Claude from drafting feedback reports automatically during sessions (org or user policy).
   ~/.claude/settings.json copy

   {
     "feedbackDrafts": false
   }

   Supply an org-branded spinner tip file with priority and cooldown controls so custom tips rotate alongside built-in ones.
   ~/.claude/settings.json copy

   spinnerTipsOverride:
     tipsFile: /etc/claude-code/org-tips.json
     label: "Acme Corp Tips"
     entries:
       - id: tip-cache
         text: "Use prompt caching on repeated context to cut costs by up to 90%."
         priority: 10
         cooldownSessions: 3

   • ›Adds /claude-api cost-optimize subcommand to profile an existing project's Claude API spend and work through cost levers (caching, token hygiene, batch, effort, model choice) one measured change at a time.
   • ›Adds SendFeedback tool so Claude can draft a feedback report during a session for you to review and send from /feedback; disable with the feedbackDrafts setting.
   • ›Adds {id, text, cooldownSessions, priority} entries, tipsFile, and label to spinnerTipsOverride so organizations can rotate custom tips alongside built-in ones.
   • ›Expands the /claude-api skill with Admin API coverage: organization members, invites, workspaces, API keys, rate limit reports, workload identity federation, and CMEK.
   • ›Adds a one-keystroke 'Yes, and switch to auto mode' option on Bash permission prompts, letting users jump straight to auto mode without navigating menus.
   +4 moreshow less

   • ›Improves plugin marketplace hardening: names containing control or invisible characters are now rejected, and marketplace-supplied text in /plugin and claude plugin output is escape-safe.
   • ›Improves Bedrock, Vertex, and Foundry sessions (and any with telemetry disabled): Claude is now informed when a configured MCP server failed to connect, instead of silently concluding its tools don't exist.
   • ›Changes Sonnet 5's default auto-compact window to its full 1M context, so sessions auto-compact at approximately 967K tokens instead of approximately 934K.
   • ›Changes cross-session peer messages to collapse by default to a one-line preview (Message from @<sender>: <first line>); Ctrl+O expands the full body.
4. v2.1.246 Aug 25, 2026 · issue 008

   Claude Code v2.1.246 adds Auto mode permissions UI, Bash wildcard safety warnings, and turn completion timestamps.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v2.1.246 https://github.com/anthropics/claude-code.git
   # already have the repo? check out this version:
   $ git checkout v2.1.246

   • ›Adds an Auto mode tab to /permissions for viewing and editing auto mode classifier rules.
   • ›Adds a startup warning when Bash allow rules contain a wildcard before the subcommand (e.g. Bash(git * main)), flagging rules that also match options injected before the subcommand.
   • ›Adds the turn's wall-clock completion time to the end-of-turn duration line (e.g. ✻ Sautéed for 23s · done 6:05 PM).
   • ›Improves /cd so the new directory's project settings, hooks, .mcp.json servers, skills, and agents all take effect immediately instead of waiting for --resume.
   • ›Improves subagent results: a subagent that hits its maxTurns limit now returns output marked as partial with a hint to continue via SendMessage, rather than appearing finished.
   +3 moreshow less

   • ›Improves non-interactive sessions (-p, SDK, cloud sessions) to automatically continue a response cut off mid-stream by a server error, connection loss, or stall.
   • ›Changes /code-review so Claude can initiate it on Bedrock, Vertex AI, Foundry, the Claude apps gateway, and when telemetry or non-essential traffic is disabled.
   • ›Changes /goal idle sessions to start at most three check-ins per goal on long-running background work; the next user message allows three more.
5. v2.1.239 Aug 21, 2026 · issue 004

   Claude Code v2.1.239 adds /claude-api upgrade, synced plugin management, and data-residency cost transparency.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v2.1.239 https://github.com/anthropics/claude-code.git
   # already have the repo? check out this version:
   $ git checkout v2.1.239

   └──▷ TRY IT
   Enable a plugin synced from claude.ai in a cloud session without overriding any locally installed plugin of the same name.
   copy

   $ claude plugin enable my-plugin@synced

   • ›Adds /claude-api upgrade subcommand to migrate Python projects from anthropic 0.x to 1.x (timeouts now use anthropic.Timeout, not httpx.Timeout).
   • ›Cloud sessions: synced plugins from claude.ai now appear as name@synced and work with claude plugin enable/disable <name>@synced, and never override a locally installed plugin with the same name.
   • ›Cost estimates via /cost, the status line, and --max-budget-usd now include the 1.1× US-only-inference premium for data-residency workspaces.
   • ›Extends the one-time fullscreen renderer offer to Bedrock, Vertex, Foundry, and other previously excluded setups; new installs there now start in fullscreen.
   • ›Alpine/musl builds: native image paste, clipboard, and audio-capture add-ons now load using musl-built binaries.
   +7 moreshow less

   • ›Usage-limit message now also shows when your session or weekly limit resets, in addition to the monthly spend limit.
   • ›Windows: cross-session messaging now available, letting Claude Code sessions message each other with SendMessage and discover each other via ListAgents, matching macOS/Linux behavior.
   • ›ListAgents and /list-agents now include live teammates, not only subagents and other local sessions.
   • ›CLAUDE_CODE_RETRY_WATCHDOG persistent retry mode now fails immediately on organization spend-limit and out-of-credits errors instead of waiting indefinitely.
   • ›/goal: repeat check-ins on long-running background work now back off (30 min, then 1 h, then every 2 h) instead of firing every 30 minutes.
   • ›Claude in Chrome: /clear now closes the session's Chrome tab group, and empty groups are closed on /resume and on exit.
   • ›Remote sessions: images uploaded from mobile now include their saved file path so Claude can copy them into files it creates.
6. v2.1.238 Aug 20, 2026 · issue 003

   Claude Code v2.1.238 adds keybinding flavors, self-hosted runner shutdown/proxy controls, and plugin marketplace auth helpers.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v2.1.238 https://github.com/anthropics/claude-code.git
   # already have the repo? check out this version:
   $ git checkout v2.1.238

   └──▷ TRY IT
   Allow a self-hosted runner to finish active sessions gracefully before exiting after receiving SIGTERM — useful for rolling restarts without dropping users.
   copy

   $ claude self-hosted-runner --defer-shutdown-max-min 5

   Authenticate to an egress proxy that requires a fresh token on each connection by supplying a command that generates the Proxy-Authorization header value.
   copy

   $ claude self-hosted-runner --proxy-authorization-command 'vault read -field=token secret/proxy-auth'

   • ›Adds keybindingFlavor setting: set to "readline" for Ctrl+W to delete back to the previous whitespace (Bash-style); default "classic" is unchanged.
   • ›Adds claude self-hosted-runner --defer-shutdown-max-min <minutes>: on SIGTERM, continues serving attached sessions, parks remaining sessions after the specified minutes, then exits.
   • ›Adds claude self-hosted-runner --proxy-authorization-command and --proxy-authorization-file for egress proxies that require a freshly issued Proxy-Authorization header on every connection.
   • ›Adds headersHelper to plugin marketplace URL entries and catalog entries: runs a command to mint HTTP headers (e.g. a short-lived token) for catalog and same-origin archive fetches.
   • ›A catalog entry's headersHelper runs only at claude plugin install or claude plugin update time, after its command is shown, with a [y/N] prompt (or pass -y to skip).
   +8 moreshow less

   • ›Cross-session messaging now reports 'refused' to the sender when the target session has crossSessionInbound: "refuse" set, instead of silently succeeding.
   • ›Cross-session messaging now notifies the sending session when the target inbox drops messages due to a rate limit or full queue, instead of messages vanishing silently.
   • ›MCP headersHelper in a project .mcp.json, and inline MCP servers in project or --add-dir agent files, now require the folder's trust dialog to have been accepted (also applies under claude -p).
   • ›MCP headersHelper from a project .mcp.json, plugin, or agent file now runs without inherited credential environment variables; user, managed, and claude.ai-scope helpers run from the Claude config directory.
   • ›Changes claude mcp list and claude mcp get to show disabled servers as ⊘ Disabled instead of connecting to them for a health check.
   • ›Removes the double-press Ctrl+L / Cmd+K /clear shortcut in fullscreen; both keys now always repaint the screen, and 1-row nvim terminals no longer trigger automatic /clear loops.
   • ›Updates the bundled claude-api skill for Managed Agents: adds web search/fetch domain settings and memory stores on self-hosted sandboxes.
   • ›Improves Remote Control connection resilience: brief HTTP 403 refusals from a network edge, VPN, or proxy are tolerated for up to 3 minutes, with the refusing party named when a block persists.
   └──▷ BREAKING ON UPGRADE

   • !The double-press Ctrl+L / Cmd+K shortcut to trigger /clear in fullscreen has been removed; those keys now only repaint.
7. v2.1.237 Aug 20, 2026 · issue 002

   Claude Code v2.1.237 adds a built-in 'Concise' output style selectable via /config.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v2.1.237 https://github.com/anthropics/claude-code.git
   # already have the repo? check out this version:
   $ git checkout v2.1.237

   └──▷ HOW TO FIND IT
   Switch to Concise output so Claude skips preamble and leads with results on every response.
   📍/config
   • ›Adds a built-in 'Concise' output style — accessible under 'Output style' in /config — where Claude leads with results and skips preamble and narration while working just as thoroughly.
8. v2.1.236 Aug 19, 2026 · issue 002

   Claude Code v2.1.236 adds ANTHROPIC_DEFAULT_MODEL env var, notify_when_idle for cross-session messaging, and stronger macOS sandbox deny rules.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v2.1.236 https://github.com/anthropics/claude-code.git
   # already have the repo? check out this version:
   $ git checkout v2.1.236

   └──▷ TRY IT
   Pin all new Claude Code sessions to a specific model without touching per-session config — useful in CI or shared environments where you want a consistent model baseline.
   copy

   $ export ANTHROPIC_DEFAULT_MODEL=claude-opus-4-5
   claude

   From one Claude Code session, request a one-shot idle notification from a long-running background session so you know exactly when it is free to accept new work.
   json copy

   { "session_id": "<target-session-id>", "message": "ping", "notify_when_idle": true }

   • ›Adds ANTHROPIC_DEFAULT_MODEL environment variable to set the default model for new sessions; a /model pick still overrides it and persists across restarts, unlike ANTHROPIC_MODEL.
   • ›Adds notify_when_idle field to cross-session SendMessage: ask another Claude Code session on the same machine to send one notice when it next goes idle — opt-in, one-shot, no polling (macOS and Linux).
   • ›Strengthens macOS sandbox: wildcard read-deny rules (e.g. **/.env) now take precedence inside allowed read regions, cover matched directories' contents, and cannot be bypassed by renaming the denied file.
   • ›/usage now shows the usage-credits spend row for Team and Enterprise members, including a capped row at 0% before anything is spent.
   • ›/goal now automatically checks in after 30 minutes (then 1h, 2h) when an idle session's goal is parked behind long-running background work, instead of waiting for the user to return.
   +7 moreshow less

   • ›Auto mode now sets aside Monitor allow rules while active, so Monitor commands are reviewed the same way Bash commands are.
   • ›Auto mode classifier on Bedrock, Vertex AI, and Foundry (and when telemetry is disabled) now uses the same defaults as on the Claude API, including severity-scored classification.
   • ›Auto mode git status check can no longer be fooled by a repo's status.showUntrackedFiles=no setting into reporting a clean tree.
   • ›SIGTERM in print/SDK mode no longer records an interrupted turn or synthetic tool denials before exiting; running commands are still terminated and the process exits with code 143.
   • ›Remote Control now marks a session offline within seconds when the CLI exits or its terminal closes.
   • ›SendMessage now refuses further messages to a session upfront once a rapid burst would exceed the session's inbox capacity, instead of reporting them sent while silently dropping them.
   • ›[VSCode] Adds screen reader support for the transcript: live announcements for replies, permission requests, errors, and status changes, plus per-turn heading navigation.
9. v2.1.235 Aug 18, 2026 · issue -001

   Claude Code v2.1.235 adds optional spellcheck setting with aspell/hunspell/ispell support and hardens SendMessage size limits.

   └──▷ GET THIS VERSION
   copy

   $ git clone --branch v2.1.235 https://github.com/anthropics/claude-code.git
   # already have the repo? check out this version:
   $ git checkout v2.1.235

   └──▷ USE IT
   Enable live spellchecking in the prompt input so typos are underlined as you type — requires aspell, hunspell, or ispell to be installed.
   yaml copy

   spellcheck: true

   • ›Adds optional spellcheck setting that underlines misspelled words in the prompt input as you type, using your installed aspell, hunspell, or ispell.
   • ›SendMessage now rejects messages too large for cross-session delivery up front instead of silently dropping them.
   • ›Remote Control: claude rc now applies the same enterprise-gateway availability check as interactive startup.
   • ›Improved memory and CPU usage while cloud sessions such as /ultrareview or /autofix-pr run in the background — their event streams are no longer re-scanned and re-rendered on every update.
   • ›Context-limit error now indicates when auto-compact is off and points to /config to re-enable it.
   +1 moreshow less

   • ›Vim mode now preserves NORMAL mode and cursor position when toggling the detailed transcript (ctrl+o) or closing a panel.
10. v2.1.235 Aug 18, 2026 · issue 001

    Claude Code v2.1.235 adds optional spellcheck setting and hardens SendMessage size limits and claude rc gateway checks.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.235 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.235

    • ›Adds optional spellcheck setting that underlines misspelled words in the prompt input as you type, backed by your installed aspell, hunspell, or ispell.
    • ›SendMessage now rejects messages too large for cross-session delivery up front instead of silently dropping them.
    • ›Remote Control: claude rc now applies the same enterprise-gateway availability check as interactive startup.
    • ›Context-limit error now indicates when auto-compact is off and directs users to /config to re-enable it.
11. v2.1.234 Aug 17, 2026 · issue -002

    Claude Code v2.1.234 adds mid-turn command access, GitLab MR badges, auto-resume at usage limits, and a new CLAUDE_CODE_PROJECT_DIR_NAME env var.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.234 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.234

    └──▷ TRY IT
    Give each CI/CD session its own clearly named transcript directory instead of a generic hash-based name.
    copy

    $ export CLAUDE_CODE_PROJECT_DIR_NAME=my-project
    claude

    Disable the automatic 30-minute goal check-in for background tasks when you want /goal to wait indefinitely.
    copy

    $ export CLAUDE_CODE_GOAL_CHECKIN_MINUTES=0
    claude

    • ›Adds CLAUDE_CODE_PROJECT_DIR_NAME environment variable so hosts can set a short name for the per-project transcript directory when each session gets its own config directory.
    • ›Adds CLAUDE_CODE_GOAL_CHECKIN_MINUTES environment variable to control how often /goal checks in on background tasks that have been waiting 30+ minutes (set to 0 to disable).
    • ›Adds selection:clear keybinding action, bindable to a key to clear in-app text selections including in the agents view.
    • ›Adds a GitLab merge request badge to the footer and statusline for repos with a GitLab remote and an authenticated glab CLI, showing MR !N with draft/pending/green states.
    • ›Adds automatic session continuation when a claude.ai usage limit resets; toggle via /config with the 'Continue automatically at usage limit' setting.
    +11 moreshow less

    • ›/permissions can now be opened while Claude is working, with rule changes applying immediately to the current turn.
    • ›/add-dir <path> can now be used while Claude is working; /add-dir, /autocompact, /theme, /help, /config, and /advisor dialogs open mid-turn in the fullscreen TUI.
    • ›claude setup-token now rejects unexpected extra arguments instead of silently ignoring them.
    • ›/goal now clears itself with a notice when a turn dies on an unrecoverable error (e.g. revoked auth, exhausted credit balance, or context overflow).
    • ›/goal now checks in on background tasks that have been waiting 30+ minutes instead of waiting indefinitely.
    • ›SendMessage and ListAgents now report when an account's session list was too long to check completely, rather than treating unseen sessions as absent.
    • ›Reduces context cost of the built-in claude-api skill from ~200k+ tokens to ~25k by loading reference docs on demand.
    • ›Remote Control: effort picks made on a phone or on claude.ai/code now apply to terminal- and Desktop/VS Code-hosted sessions, and the session publishes its effort level to connected clients.
    • ›Remote Control sessions now keep phones and claude.ai/code updated on the session's permission mode (and claude.ai/code on the model) as they change.
    • ›Improves transcript rendering so your own prompts now render markdown (highlighted code blocks, inline code, lists) the same way replies do.
    • ›Removes the 'Default teammate model' setting from /config; agent-team teammates now use the leader's model unless the spawn command names one.
    └──▷ BREAKING ON UPGRADE

    • !The 'Default teammate model' setting has been removed from /config; agent-team teammates now use the leader's model unless the spawn command explicitly names one.
12. v2.1.234 Aug 17, 2026 · issue 001

    Claude Code v2.1.234 adds CLAUDE_CODE_PROJECT_DIR_NAME, selection:clear keybinding, GitLab MR badge, auto-resume at usage limit, and NT-namespace path rejection.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.234 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.234

    └──▷ TRY IT
    Give a multi-user host a predictable, short transcript directory name per project instead of a generated one.
    copy

    $ CLAUDE_CODE_PROJECT_DIR_NAME=my-api-service claude

    Tune how long a /goal waits before Claude checks in on stalled background tasks — set to 0 to disable check-ins entirely.
    copy

    $ CLAUDE_CODE_GOAL_CHECKIN_MINUTES=15 claude

    • ›Adds the optional CLAUDE_CODE_PROJECT_DIR_NAME environment variable, letting hosts that give each session its own config directory choose a short name for the per-project transcript directory.
    • ›Adds the CLAUDE_CODE_GOAL_CHECKIN_MINUTES environment variable (set to 0 to opt out) — when background tasks keep a /goal waiting 30+ minutes, Claude now checks in instead of waiting indefinitely.
    • ›Adds the selection:clear keybinding action, which can be bound to a key to clear an in-app text selection; also works in the agents view.
    • ›Adds a GitLab merge request badge to the footer and statusline: repos with a GitLab remote and an authenticated glab CLI show MR !N with draft/pending/green states.
    • ›Session auto-resume: Claude Code now continues a session automatically when a claude.ai usage limit resets; disable in /config under 'Continue automatically at usage limit'.
    +11 moreshow less

    • ›/permissions can now be opened while Claude is actively working — rule changes apply immediately to the rest of the current turn.
    • ›/add-dir <path> can now be invoked mid-turn; /add-dir, /autocompact, /theme, /help, /config, and /advisor dialogs all open mid-turn in the fullscreen TUI.
    • ›/goal clears itself with a notice when a turn dies on an unrecoverable error (revoked auth, exhausted credit balance, or context overflow) instead of staying armed.
    • ›claude setup-token now rejects unexpected extra arguments instead of silently ignoring them.
    • ›Reduced context cost of loading the built-in claude-api skill from ~200k+ tokens to ~25k by loading reference docs on demand.
    • ›Removes the 'Default teammate model' setting from /config; agent-team teammates now use the leader's model unless the spawn command names one explicitly.
    • ›Remote Control sessions started from Claude Code Desktop or VS Code now keep phones and claude.ai/code updated on the session's permission mode (and claude.ai/code on the model) as they change.
    • ›Remote Control: effort picks made on a phone or claude.ai/code now apply to terminal- and Desktop/VS Code-hosted sessions, and the session publishes its effort level to all connected clients.
    • ›SendMessage and ListAgents now report when an account's session list was too long to check completely, instead of treating unseen sessions as absent.
    • ›Improves your own prompts in the transcript: they now render markdown (highlighted code blocks, inline code, lists) the same way replies do.
    • ›Improves auto-generated session titles to short, specific names (e.g., 'Login button bug') rather than sentences restating the request.
13. v2.1.233 Aug 14, 2026 · issue -005

    Claude Code v2.1.233 adds GitLab MR support, per-user identity forwarding, memory cgroup limits, and WebFetch cache TTL control

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.233 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.233

    └──▷ TRY IT
    Cap memory usage of Bash tool subprocesses on Linux so a runaway build cannot exhaust the host and stall the session.
    copy

    $ export CLAUDE_CODE_TOOL_MEMORY_LIMIT=2G
    claude

    Extend the WebFetch URL cache lifetime to avoid redundant fetches during long-running research sessions.
    copy

    $ export CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS=3600000
    claude

    Re-enable todo/task-tracking tools when working with a newer model (e.g. Sonnet 5) that disables them by default.
    copy

    $ export CLAUDE_CODE_ENABLE_TODO_TOOLS=1
    claude --model claude-sonnet-5

    • ›Adds CLAUDE_CODE_TOOL_MEMORY_LIMIT environment variable (opt-in) to enforce memory cgroup limits on Bash tool commands on Linux, preventing runaway builds from stalling a session.
    • ›Adds CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS environment variable to configure the WebFetch session URL cache TTL (default: 15 minutes).
    • ›Adds opt-in forward_user_identity setting on Anthropic apps gateway upstreams, sending the signed-in user's identity as headers so a proxy can attribute spend per user.
    • ›Adds CLAUDE_CODE_ENABLE_TODO_TOOLS=1 environment variable to re-enable TodoWrite/TaskCreate/Get/Update/List tools on Opus 4.8, Sonnet 5, Fable 5, Mythos 5, and newer models (now disabled by default on those models).
    • ›Extends the --worktree flag and claude agents view to support GitLab merge request URLs, displaying MRs as !N.
    +3 moreshow less

    • ›Improves claude plugin validate to check bare .claude/skills directories and report SKILL.md files with unparseable frontmatter.
    • ›Adds a [claude-code:unrecognized_model] diagnostic line to stderr in print mode when a request targets an unrecognized model ID; silence it by mapping the model with modelOverrides.
    • ›Improves claude self-hosted-runner session start time by creating the session branch without rewriting the working tree and removing two blocking server round trips.
    └──▷ BREAKING ON UPGRADE

    • !Todo/task-tracking tools (TaskCreate, TaskGet, TaskUpdate, TaskList, TodoWrite) are no longer available by default on Opus 4.8, Sonnet 5, Fable 5, Mythos 5, and newer models; set CLAUDE_CODE_ENABLE_TODO_TOOLS=1 to restore them.
14. v2.1.233 Aug 14, 2026 · issue 001

    Claude Code v2.1.233 adds GitLab MR support, per-user identity forwarding, Linux memory limits for Bash tools, and a WebFetch cache TTL env var.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.233 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.233

    └──▷ TRY IT
    Cap memory for a Bash tool invocation on Linux so a runaway build step cannot exhaust system memory and stall your session.
    copy

    $ CLAUDE_CODE_TOOL_MEMORY_LIMIT=2g claude

    Shorten the WebFetch URL cache TTL to 5 minutes when you need Claude to re-fetch frequently updated pages within a session.
    copy

    $ CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS=300000 claude

    Re-enable todo/task-tracking tools on a newer model (e.g. Sonnet 5) where they are now off by default.
    copy

    $ CLAUDE_CODE_ENABLE_TODO_TOOLS=1 claude

    • ›Adds CLAUDE_CODE_TOOL_MEMORY_LIMIT env var (opt-in, Linux only) to cap memory for Bash tool commands via cgroups, preventing a runaway build from stalling the session.
    • ›Adds CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS env var to override the WebFetch session URL cache TTL (default: 15 minutes).
    • ›Adds forward_user_identity opt-in setting on Anthropic upstreams in the apps gateway, sending the signed-in user's identity as headers so a downstream proxy can attribute spend per user.
    • ›Adds CLAUDE_CODE_ENABLE_TODO_TOOLS=1 env var to restore TaskCreate, TaskGet, TaskUpdate, TaskList, and TodoWrite tools on Opus 4.8, Sonnet 5, Fable 5, Mythos 5, and newer models, where they are now disabled by default.
    • ›Adds GitLab merge request URL support to the --worktree flag and the claude agents view, displaying MRs as !N.
    +4 moreshow less

    • ›Improves claude plugin validate to check a bare .claude/skills directory and report SKILL.md files whose frontmatter fails to parse.
    • ›Improves print mode diagnostics: writes a [claude-code:unrecognized_model] line to stderr when a request uses an unrecognized model ID; silence it by mapping with modelOverrides.
    • ›Improves screen reader mode: the /effort selector now renders as a numbered list with a typed-number prompt, and hint and dialog text is no longer clipped.
    • ›Improves claude self-hosted-runner session start time by creating the session branch without rewriting the working tree and eliminating two blocking server round trips.
    └──▷ BREAKING ON UPGRADE

    • !Todo/task-tracking tools (TaskCreate, TaskGet, TaskUpdate, TaskList, TodoWrite) are no longer available by default on Opus 4.8, Sonnet 5, Fable 5, Mythos 5, and newer models; set CLAUDE_CODE_ENABLE_TODO_TOOLS=1 to re-enable them.
15. v2.1.232 Aug 13, 2026 · issue -006

    Claude Code v2.1.232 adds subagent forking by default, cross-session @-mentions, GitLab secret redaction, and deeper Remote Control resilience.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.232 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.232

    └──▷ USE IT
    Configure a managed gateway policy that references GitLab-hosted plugin marketplaces using the new friendlier alias allowedMarketplaces.
    yaml copy

    allowedMarketplaces:
      - https://gitlab.com/myorg/claude-plugins

    Block a specific GitLab marketplace URL at the enterprise policy level so it stays blocked even when the CLI detects it as a git clone.
    yaml copy

    blockedMarketplaces:
      - https://gitlab.com/untrusted-org/plugins

    Control how cross-session messages from your other Claude sessions are handled — accept, hold, or refuse — via the new /config dialog.
    📍Open /config in an interactive Claude Code session, then find 'Messages from your other sessions' and set it to accept, hold, or refuse.
    • ›Adds additionalMarketplaces and allowedMarketplaces as accepted aliases for extraKnownMarketplaces and strictKnownMarketplaces in settings.
    • ›Enterprise policy: a url-typed blockedMarketplaces entry for a bare repo URL now blocks that URL when the CLI classifies it as a git clone.
    • ›Gateway: sandbox.bwrapPath, sandbox.socatPath, and sandbox.ripgrep now require managed-settings approval when a server override is present.
    • ›Changes sandbox.ripgrep to be honored only from user, managed, and --settings settings; project settings can no longer override the sandbox ripgrep binary.
    • ›Gateway: the desktop: overlay now accepts every released Desktop setting (validated at boot against Desktop's own schema); unknown or invalid keys fail boot.
    +16 moreshow less

    • ›Gateway: empty managed.policies[].match.groups / admin.admin_groups entries and malformed email_domain values now fail at boot instead of silently matching no one or granting admin access.
    • ›Adds /config rows for 'Dialog expiry' and 'Messages from your other sessions' (cross-session inbound accept/hold/refuse controls).
    • ›Adds secret redaction for GitLab token families glrt-, gloas-, glptt-, glagent-, glimt-, glsoat-, glcbt-, glft-, glffct-, and full redaction of routable glpat-/gldt- tokens; the glab CLI config store gets the same sandbox and credential-path protection as gh.
    • ›Adds GitLab support to plugin marketplaces: bare gitlab.com repo URLs (including nested subgroups) now clone like github.com URLs.
    • ›Subagent forking is now on by default: a subagent_type: "fork" subagent inherits the full conversation and prompt cache, and non-teammate agent spawns in interactive sessions now run in the background by default.
    • ›Type @ in the prompt to mention another Claude session by name; Claude uses SendMessage to reach that session directly.
    • ›SendMessage now delivers to a bare name that exactly matches one live session without requiring a ref confirmation first.
    • ›Interactive sessions now keep unique names: starting or renaming a session to a name already in use gives it a name-word-word variant automatically.
    • ›Fable 5 is offered as an advisor in /advisor again for organizations with Fable access, with usage-credits consent configured through /model fable.
    • ›/plugin install plugin@marketplace now refreshes the marketplace first so newly published plugins install without a manual marketplace update.
    • ›/code-review at high, xhigh, and max effort now runs in a background agent like the other effort levels.
    • ›/feedback and /bug now open immediately when invoked while Claude is responding, without waiting for the turn to finish.
    • ›Remote Control now keeps reconnecting for about 30 minutes after a network blip.
    • ›Bash input redirections (< file) are now permission-checked like their argument spellings on all platforms.
    • ›Hardened the auto-generated cross-session messaging socket directory on shared /tmp against pre-planted symlinks or another user's directory.
    • ›Hardened the Linux filesystem sandbox against a protected-path bypass.
    └──▷ BREAKING ON UPGRADE

    • !sandbox.ripgrep set in project settings is now ignored; only user, managed, and --settings sources are honored.
    • !Gateway: unknown or invalid keys in the desktop: overlay now fail boot instead of being silently accepted.
    • !Gateway: empty managed.policies[].match.groups / admin.admin_groups entries and malformed email_domain values (empty, containing @, whitespace, or commas) now fail at boot.
16. v2.1.232 Aug 13, 2026 · issue 001

    Claude Code v2.1.232 adds cross-session messaging via @, subagent_type: "fork" on by default, GitLab marketplace support, and new secret redaction for GitLab tokens.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.232 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.232

    └──▷ TRY IT
    Install a newly published GitLab-hosted plugin without manually refreshing the marketplace first.
    copy

    $ /plugin install [email protected]/myorg/mygroup/my-marketplace

    • ›Enables subagent_type: "fork" subagents by default, so forked subagents inherit the full conversation and prompt cache; non-teammate agent spawns in interactive sessions now run in the background by default.
    • ›Adds @-mention in the prompt to reference another Claude session by name, triggering SendMessage to deliver directly to that live session without a confirmation step.
    • ›Adds /config rows for 'Dialog expiry' and 'Messages from your other sessions', controlling cross-session inbound message behavior (accept/hold/refuse).
    • ›Adds secret redaction for GitLab token families glrt-, gloas-, glptt-, glagent-, glimt-, glsoat-, glcbt-, glft-, glffct-, plus full redaction of routable glpat-/gldt- tokens; the glab CLI config store receives the same sandbox and credential-path protection as gh.
    • ›Adds GitLab support to plugin marketplaces: bare gitlab.com repo URLs (including nested subgroups) now clone the same way github.com URLs do.
    +11 moreshow less

    • ›Accepts additionalMarketplaces and allowedMarketplaces as friendlier aliases for the settings keys extraKnownMarketplaces and strictKnownMarketplaces.
    • ›Adds enterprise policy support for a url-typed blockedMarketplaces entry that keeps blocking a bare repo URL even when the CLI classifies it as a git clone.
    • ›Expands the Gateway desktop: overlay to accept every released Desktop setting (previously limited to 11 hand-listed keys), validated at boot against Desktop's own schema; unknown or invalid keys now fail boot.
    • ›Hardens Gateway boot validation: empty managed.policies[].match.groups/admin.admin_groups entries and malformed email_domain values now fail at boot instead of silently matching no one or granting admin access.
    • ›Interactive sessions on the same machine now enforce unique names: a collision produces a name-word-word variant automatically.
    • ›Changes sandbox.ripgrep to be honored only from user, managed, and --settings settings; project settings can no longer override the sandbox ripgrep binary.
    • ›Adds managed settings approval dialog improvements: shows endpoint URLs, requires approval for server-managed sandbox binary overrides (sandbox.bwrapPath, sandbox.socatPath, sandbox.ripgrep).
    • ›/code-review at high, xhigh, and max effort now runs in a background agent, consistent with other effort levels.
    • ›/plugin install plugin@marketplace now refreshes the marketplace before installing, so newly published plugins install without a manual marketplace update.
    • ›Remote Control now reconnects for up to ~30 minutes after a network blip and no longer drops after multiple blips spread across an hour.
    • ›Bash input redirections (< file) are now permission-checked on all platforms, matching the behavior for argument spellings.
    └──▷ BREAKING ON UPGRADE

    • !Gateway: unknown or invalid keys in the desktop: overlay now fail boot (previously accepted silently).
    • !Gateway: empty managed.policies[].match.groups/admin.admin_groups entries and malformed email_domain values now fail at boot (previously matched silently or granted admin access).
    • !sandbox.ripgrep set in project settings is no longer honored; it must be in user, managed, or --settings settings.
17. v2.1.229 Aug 12, 2026 · issue -007

    Claude Code v2.1.229 adds plugin marketplace command sources, Remote Control offline/cloud labels, VSCode session groups, and SSE keepalive for Vertex/Bedrock.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.229 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.229

    └──▷ TRY IT
    Resume the most recent Remote Control session without specifying a session ID.
    copy

    $ claude remote-control --continue

    • ›Adds plugin marketplace command sources: a local command (e.g. an IDE) prints the plugin directory, re-resolved each session and applied without a restart; mode: "link" uses it in place.
    • ›ListAgents now marks disconnected Remote Control sessions as offline and labels cloud sessions as cloud.
    • ›Adds CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS env var to control workflow fan-out staggering for same-prefix sibling agents; set to 0 to disable.
    • ›Adds SSE keepalive pings to gateway streaming responses during long thinking pauses, preventing idle-timeout disconnects on Vertex and Bedrock upstreams.
    • ›Adds server-supplied Claude Code hook support for self-hosted runner sessions, matching managed-environment behavior.
    +7 moreshow less

    • ›Documents claude remote-control --continue for resuming the most recent Remote Control session.
    • ›Changes /commit-push-pr to no longer auto-approve git/gh commands with dangerous flags such as --force, --amend, and --no-verify.
    • ›Changes self-hosted runner Windows startup to require an explicit --base-dir; there is no default checkout directory on Windows.
    • ›Improves sandbox IPv6 handling: literals in network domain lists are now bracketed (e.g. [::1]:443), and ambiguous spellings are enforced fail-closed and flagged by /doctor.
    • ›[VSCode] Adds session groups in the sidebar — right-click to create, rename, or delete; Cmd/Ctrl- or Shift-click to move several sessions at once.
    • ›[VSCode] Makes the /btw side-question panel resizable by dragging its boundary, in both side-docked and stacked layouts.
    • ›[VSCode] 'Report a problem' and /bug now open the built-in feedback dialog.
    └──▷ BREAKING ON UPGRADE

    • !Self-hosted runner Windows startup now requires an explicit --base-dir; there is no default checkout directory on Windows.
    • !/commit-push-pr no longer auto-approves git/gh commands with dangerous flags (--force, --amend, --no-verify, etc.).
18. v2.1.229 Aug 12, 2026 · issue 001

    Claude Code v2.1.229 adds plugin command sources, ListAgents session labels, SSE keepalives, and VSCode session groups.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.229 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.229

    └──▷ TRY IT
    Resume the most recent Remote Control session without looking up a session ID — useful when reconnecting after a network drop.
    copy

    $ claude remote-control --continue

    Disable workflow fan-out staggering in environments where prompt-prefix caching is not needed or causes timing issues.
    copy

    $ CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS=0 claude

    • ›Documents claude remote-control --continue for resuming the most recent Remote Control session without specifying a session ID.
    • ›Adds plugin marketplace command sources: a local command (e.g. from an IDE) prints the plugin directory, which is re-resolved each session and applied without a restart; mode: "link" uses it in place.
    • ›Sets CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS=0 to disable the new workflow fan-out staggering that lets sibling agents reuse cached prompt prefixes.
    • ›ListAgents now marks disconnected Remote Control sessions as offline and labels cloud sessions as cloud, making session inventory clearer.
    • ›Adds SSE keepalive pings to gateway streaming responses during long thinking pauses, preventing idle-timeout disconnects on Vertex and Bedrock upstreams.
    +8 moreshow less

    • ›Adds server-supplied Claude Code hook support for self-hosted runner sessions, matching managed-environment behavior.
    • ›Improves workflow fan-outs to stagger same-prefix sibling agents so subsequent agents read the cached prompt prefix instead of re-paying it.
    • ›Changes /commit-push-pr so git/gh commands with dangerous flags (--force, --amend, --no-verify, etc.) are no longer auto-approved.
    • ›Requires an explicit --base-dir for self-hosted runner Windows startup; there is no longer a default checkout directory on Windows.
    • ›Improves sandbox: IPv6 literals in network domain lists are now bracketed (e.g. [::1]:443), and ambiguous spellings are enforced fail-closed and flagged by /doctor.
    • ›Updates /login to repeat the CLAUDE_CODE_OAUTH_TOKEN override warning after a successful login.
    • ›[VSCode] Adds session groups in the sidebar — right-click to create, rename, or delete; Cmd/Ctrl- or Shift-click to move several sessions at once.
    • ›[VSCode] Makes the /btw side-question panel resizable by dragging its boundary, in both side-docked and stacked layouts.
    └──▷ BREAKING ON UPGRADE

    • !Self-hosted runner Windows startup now requires an explicit --base-dir; there is no default checkout directory on Windows, so existing Windows runner configs without --base-dir will fail to start.
19. v2.1.228 Aug 11, 2026 · issue 001

    Claude Code v2.1.228 hardens synced skills, improves cross-session messaging, and lets newer models overwrite unread files.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.228 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.228

    • ›Hardened skills synced from claude.ai: they no longer shadow local commands or MCP prompts, descriptions are sanitized and labeled, and skill bodies no longer run ! commands or expand @ files on your machine.
    • ›Improved cross-session messages: sender and body now display inline instead of a collapsed line, and messages to Remote Control sessions on other machines show your Remote Control session name as the sender.
    • ›The Write tool now allows newer models to overwrite an existing file they haven't read this session, matching the Edit tool's rules; older models still require a read first.
    • ›Improved Vertex AI credential handling: expired or missing Google Cloud credentials now fail within seconds instead of retrying for minutes.
    • ›Improved compaction progress: the retry countdown and stall hint now appear during compaction instead of only a progress bar.
20. v2.1.228 Aug 11, 2026 · issue -008

    Claude Code v2.1.228 hardens synced skills, improves cross-session messaging, and lets newer models overwrite unread files.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.228 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.228

    • ›Hardened skills synced from claude.ai: they no longer shadow local commands or MCP prompts, descriptions are sanitized and labeled, and skill bodies no longer run ! commands or expand @ files on your machine.
    • ›Improved cross-session messages: sender and body now display inline instead of a collapsed line, and messages to Remote Control sessions on other machines show your Remote Control session name as the sender.
    • ›The Write tool now allows newer models to overwrite an existing file they haven't read this session, matching the Edit tool's rules; older models still require a read first.
    • ›Improved Vertex AI credential handling: expired or missing Google Cloud credentials now fail within seconds instead of retrying for minutes.
    • ›Improved compaction progress: the retry countdown and stall hint now appear during compaction instead of only a progress bar.
21. v2.1.225 Aug 8, 2026 · issue -011

    Claude Code v2.1.225 adds gateway spend-limit warnings, workspace trust for agents, and cross-machine Remote Control messaging.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.225 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.225

    • ›Adds gateway spend-limit support to the usage warning: the limit-reached message now names the cap, its reset time, and the operator's message (requires gateway on 2.1.225).
    • ›SendMessage can now start a conversation with Remote Control sessions on other machines by name, as shown by ListAgents in the name [ref] format — previously only reply-after-first-contact was possible.
    • ›Adds a workspace trust prompt to claude agents for untrusted directories, matching the existing behavior of claude.
    • ›Remote Control: photos attached from the Claude app are now passed directly to Claude instead of being read from disk via a separate tool call.
22. v2.1.225 Aug 8, 2026 · issue 001

    Claude Code v2.1.225 adds gateway spend-limit warnings, workspace trust for claude agents, and SendMessage remote session initiation by name.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.225 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.225

    • ›Adds a workspace trust prompt to claude agents for untrusted directories, matching the existing behavior of the claude command.
    • ›Adds gateway spend-limit support to Claude Code's usage warning: when the cap is reached, the message now names the limit, its reset time, and the operator's message (requires gateway v2.1.225).
    • ›SendMessage can now initiate a conversation with Remote Control sessions on other machines by name — ListAgents surfaces them as name [ref] — rather than requiring the remote session to message first.
    • ›SendMessage now locks a confirmed Remote Control recipient by identity, so a same-named local session can never silently replace it when the remote list is temporarily unreachable.
    • ›Improves Remote Control: photos attached from the Claude app are passed directly to Claude instead of being read from disk via a separate tool call.
23. v2.1.224 Aug 7, 2026 · issue -012

    Claude Code v2.1.224 adds self-hosted runners, archive plugin installs, JWT/AWS credential masking, and cross-session messaging.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.224 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.224

    └──▷ TRY IT
    Stand up a self-hosted runner so your team's Claude Code web and mobile sessions execute on your own infrastructure instead of Anthropic-managed compute.
    copy

    $ claude self-hosted-runner

    Route Bedrock inference to a specific cross-region profile (e.g. us-west-2) regardless of the ambient AWS_REGION, useful when your deployment region differs from the inference profile region.
    copy

    $ export ANTHROPIC_BEDROCK_REGION_PREFIX=us-west-2
    claude

    • ›Adds claude self-hosted-runner subcommand to turn your own machines or containers into execution targets for Claude Code web, mobile, and desktop sessions (Team and Enterprise plans).
    • ›Adds archive plugin source to install plugins from a zip over HTTPS without git or npm, with optional SHA-256 pinning.
    • ›Adds ANTHROPIC_BEDROCK_REGION_PREFIX environment variable to prefer a specific cross-region Bedrock inference profile over the AWS_REGION-derived one.
    • ›Adds crossSessionInbound and dialogExpiry settings: cross-session messages to bypassed-permission sessions are held for approval; messages to other sessions auto-deliver.
    • ›Adds sandbox credential-masking options extract, onExtractNoMatch, decode: "jwt" with maskClaims, and awsPairs/sigv4 for AWS SigV4 re-signing; requires network.tlsTerminate and honored only from user, managed, or --settings settings.
    +7 moreshow less

    • ›Adds cross-session SendMessage and ListAgents APIs: Claude Code sessions on macOS and Linux can now discover and message each other across machines.
    • ›Removes the 200-subagent-per-session spawn cap, allowing long-running sessions to continue launching new agents (concurrency and depth limits still apply).
    • ›Adds a cancel-and-confirm step when removing an unavailable paste changes a command's text.
    • ›Improves fullscreen mode to retain the full pre-compaction history in scrollback across repeated compactions, not just the most recent interval.
    • ›Improves Remote Control: attached web and mobile clients now see compaction progress and the post-compaction boundary, and /clear resets propagate to attached clients.
    • ›Improves Remote Control: connection failures now show a persistent failure indicator with details and a reconnect shortcut instead of an 8-second toast.
    • ›Changes feedback-survey transcript sharing to also upload (with consent) the last request's model settings — system prompt (including CLAUDE.md), tool definitions, and model parameters — with secrets redacted.
24. v2.1.224 Aug 7, 2026 · issue 001

    Claude Code v2.1.224 adds self-hosted runners, cross-session messaging, archive plugins, JWT/AWS sandbox credential masking, and removes the 200-subagent cap.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.224 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.224

    └──▷ TRY IT
    Route Bedrock inference to a specific cross-region profile rather than the one inferred from AWS_REGION.
    copy

    $ export ANTHROPIC_BEDROCK_REGION_PREFIX=us-east
    claude

    • ›New claude self-hosted-runner subcommand turns your own machines or containers into execution environments for Claude Code web, mobile, and desktop sessions (Team and Enterprise plans).
    • ›New ANTHROPIC_BEDROCK_REGION_PREFIX environment variable lets Bedrock users prefer a specific cross-region inference profile instead of the AWS_REGION-derived default.
    • ›New crossSessionInbound and dialogExpiry settings: cross-session messages sent to a bypassed-permission session are held for approval; messages to other sessions auto-deliver.
    • ›New sandbox credential-masking options: extract and onExtractNoMatch for structured env values; decode: "jwt" with maskClaims for JWT-aware masking; awsPairs and sigv4 for AWS SigV4 re-signing — require network.tlsTerminate and honored only from user, managed, or --settings settings.
    • ›New archive plugin source: install plugins from a zip over HTTPS without git or npm, with optional SHA-256 pinning.
    +6 moreshow less

    • ›New cross-session SendMessage API lets Claude Code sessions message each other across any of your machines; ListAgents discovers available sessions (macOS and Linux).
    • ›Removes the 200-subagent-per-session spawn cap so long-running sessions are no longer blocked from spawning new agents (concurrency and depth limits still apply).
    • ›Remote Control now shows compaction progress and the post-compaction boundary to attached web and mobile clients, and propagates /clear resets to those clients.
    • ›Remote Control connection failures now display a persistent failure indicator with details and a reconnect shortcut instead of only an 8-second toast.
    • ›Fullscreen mode now retains the full pre-compaction history in scrollback across repeated compactions instead of only the most recent interval.
    • ›Feedback-survey transcript share now also uploads (with consent) the last request's model settings — system prompt (including CLAUDE.md), tool definitions, and model parameters — with secrets redacted.
25. v2.1.223 Aug 6, 2026 · issue -013

    Claude Code v2.1.223 adds owner wildcards for marketplace policies, a /teleport hint for cloud sessions, and /review alias improvements.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.223 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.223

    └──▷ USE IT
    Block all marketplace repos under a GitHub org in a single managed-settings entry, rather than listing each repo individually.
    json copy

    {
      "blockedMarketplaces": ["my-org/*"]
    }

    Pick up a cloud session on your local machine when the /teleport hint appears in a cloud session.
    copy

    $ claude --teleport <session id>

    Run a deep cloud code review on a specific pull request.
    copy

    $ /code-review ultra 42

    • ›Adds owner wildcard entries ("owner/*") to strictKnownMarketplaces and blockedMarketplaces managed settings, allowing admins to permit or block all marketplace repos under an entire GitHub org in one entry.
    • ›Changes CLAUDE_CODE_DISABLE_1M_CONTEXT to apply the 200K auto-compaction cap to every Claude model with a native 1M window dynamically rather than a fixed list, and adds a startup warning when auto-compaction is not holding the session to 200K.
    • ›Adds a /teleport hint in cloud sessions showing how to continue work locally with claude --teleport <session id>.
    • ›Makes /review an alias for /code-review, which reviews the current diff or a PR via /code-review <level> <pr#>; /code-review ultra triggers a deep cloud review.
    • ›Changes /code-review with no effort level to reuse the last typed level, so re-running the command does not require re-specifying the effort.
    +1 moreshow less

    • ›Adds a warning when a workflow agent, forked skill, slash command, or resumed background agent requests a subagent model that is restricted and the parent model runs instead.
26. v2.1.223 Aug 6, 2026 · issue 001

    Claude Code v2.1.223 adds org-level marketplace wildcards, teleport-to-local hints, and a smarter /code-review command.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.223 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.223

    └──▷ USE IT
    Block all marketplace repos under a GitHub org in one managed-settings entry instead of listing each repo individually.
    managed-settings.json copy

    {
      "blockedMarketplaces": ["my-org/*"]
    }

    Pick up a cloud session locally after starting work in the browser — use the teleport hint printed in the cloud session.
    copy

    $ claude --teleport <session id>

    Run a deep cloud review on a specific PR number by passing an effort level and PR number to /code-review.
    copy

    $ /code-review ultra 4321

    • ›Adds owner wildcard entries ("owner/*") to the strictKnownMarketplaces and blockedMarketplaces managed settings, allowing admins to allow or block all marketplace repos under an entire GitHub org in one entry.
    • ›Adds --teleport <session id> flag to claude, surfaced as a /teleport hint inside cloud sessions so practitioners can seamlessly continue a cloud session locally.
    • ›Adds CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 env var to restore previous behavior where sessions on unrecognized model IDs could grow past the assumed context window; default now enforces the window via auto-compaction.
    • ›Makes /review a proper alias of /code-review, which now supports /code-review <level> <pr#> to review a specific PR and /code-review ultra for a deep cloud review.
    • ›Makes /code-review remember the last effort level used, so omitting a level reruns at the previous setting (e.g. high); pass a new level like /code-review high to override.
    +1 moreshow less

    • ›Adds a warning when workflow agents, forked skills, slash commands, or resumed background agents have their requested subagent model restricted and the parent model is substituted instead.
27. v2.1.222 Aug 4, 2026 · issue 001

    Claude Code v2.1.222 tightens auto-mode safety, improves diff accuracy, and restricts Remote Control auto-start to user scope

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.222 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.222

    • ›Remote Control auto-start can no longer be enabled via repo-local .claude/settings.json or .claude/settings.local.json; enable it at user scope via /config (those files can still turn it off).
    • ›Auto mode now routes messages sent to other agent sessions via SendMessage through the permission classifier before dispatch, preventing unreviewed cross-agent actions.
    • ›The /diff view, Remote Control workspace diff, and file-edit diffs in Claude Code web sessions now use raw git blob content, bypassing workspace-configured diff drivers and textconv for cleaner output.
    • ›Worktree-isolated sessions and their subagents can no longer run destructive git commands against the main checkout; isolation now covers file edits and Bash across every session type.
    • ›The disable-model-invocation refusal now instructs Claude to ask the user to run the skill instead of attempting to replicate its workflow.
    +1 moreshow less

    • ›Removes the ultraplan feature.
    └──▷ BREAKING ON UPGRADE

    • !Remote Control auto-start can no longer be enabled by repo-local settings (.claude/settings.json or .claude/settings.local.json); repos relying on those files to turn Remote Control on must switch to user-scope configuration via /config.
28. v2.1.222 Aug 4, 2026 · issue -015

    Claude Code v2.1.222 tightens auto-mode safety, improves diff accuracy, and restricts Remote Control auto-start to user scope

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.222 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.222

    • ›Remote Control auto-start can no longer be enabled via repo-local .claude/settings.json or .claude/settings.local.json; enable it at user scope via /config (those files can still turn it off).
    • ›Auto mode now routes messages sent to other agent sessions via SendMessage through the permission classifier before dispatch, preventing unreviewed cross-agent actions.
    • ›The /diff view, Remote Control workspace diff, and file-edit diffs in Claude Code web sessions now use raw git blob content, bypassing workspace-configured diff drivers and textconv for cleaner output.
    • ›Worktree-isolated sessions and their subagents can no longer run destructive git commands against the main checkout; isolation now covers file edits and Bash across every session type.
    • ›The disable-model-invocation refusal now instructs Claude to ask the user to run the skill instead of attempting to replicate its workflow.
    +1 moreshow less

    • ›Removes the ultraplan feature.
    └──▷ BREAKING ON UPGRADE

    • !Remote Control auto-start can no longer be enabled by repo-local settings (.claude/settings.json or .claude/settings.local.json); repos relying on those files to turn Remote Control on must switch to user-scope configuration via /config.
29. v2.1.221 Aug 4, 2026 · issue -015

    Claude Code v2.1.221 adds Focus view, sandbox credential masking, a prompt-audit subcommand, and sweeping workflow improvements.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.221 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.221

    └──▷ TRY IT
    Audit prompts and tool descriptions in your project for patterns optimized for older models before migrating to a newer Claude generation.
    copy

    $ claude-api prompt-audit

    Mask AWS credentials inside the sandbox so sandboxed commands see a sentinel value while the proxy substitutes the real secret on egress.
    yaml copy

    mode: "mask"
    extract: "aws_secret_access_key = (.+)"

    Validate a plugin before publishing to catch marketplace name rejections that would break managed sync.
    copy

    $ claude plugin validate ./my-plugin

    • ›Adds mode: "mask" for sandbox credential files on Linux and WSL — sandboxed commands read a sentinel copy (the whole file, or just spans captured by an extract regex) while the sandbox proxy substitutes the real value on egress; macOS falls back to deny.
    • ›Adds a prompt-audit subcommand to the claude-api skill for auditing prompts and tool descriptions for patterns written for older models.
    • ›Adds warnings to claude plugin validate when a marketplace or plugin name would be rejected by Claude Desktop's managed marketplace sync.
    • ›Changes /status to show the session kind: interactive, or a background job that is attached or unattended.
    • ›Changes sessions forked with /fork to create a new worktree of their own instead of working in the original session's checkout.
    +15 moreshow less

    • ›Changes plugins to accept "." as a skills path, with the root-level SKILL.md validation error now suggesting the plugin root.
    • ›Changes /plugin install to refresh a stale marketplace catalog and retry before reporting a plugin not found.
    • ›Changes plugins installed from /plugin to activate immediately when safe, instead of always requiring /reload-plugins.
    • ›Changes the Gateway model field validation to reject non-string values with a 400 instead of forwarding them.
    • ›Adds Focus view in VSCode: a chat-menu toggle that hides tool activity behind an expandable per-turn summary with a live running-tool indicator, toggled with Ctrl+Alt+F or the 'Claude Code: Toggle Focus view' command.
    • ›Improves Stats panel to count cache tokens in its token totals, with a breakdown by input, output, cache read, and cache write.
    • ›Re-enables tool search on Google Vertex AI for Claude 4.5-generation and newer models.
    • ›Changes background sessions to commit and push to preserve work, open a draft PR only when the task calls for one, follow CLAUDE.md git instructions, and always report where the work lives.
    • ›Changes emoji autocomplete to accept alternate shortcodes like :thumbsup:, :thumbsdown:, and :love:.
    • ›Changes Claude in Chrome to close browser tabs it opens once it no longer needs them.
    • ›Changes fast mode to report on the stream when usage credits run out mid-session, instead of failing silently.
    • ›Changes Monitor: a watch that exits without producing output now says so instead of reporting 'stream ended'.
    • ›Improves Windows startup to read process creation times via a native kernel32 call instead of spawning PowerShell, so endpoint security tools that gate powershell.exe no longer prompt.
    • ›Improves /ultrareview error messages when a repo shares no history with its base: a checkout with no branches is now refused up front with advice to create one, and refusal hints no longer suggest git fetch --unshallow on already-complete clones.
    • ›Reduces prompt-cache costs for auto-mode permission checks by reusing the cached conversation prefix across decisions.
30. v2.1.221 Aug 4, 2026 · issue 001

    Claude Code v2.1.221 adds Focus view, sandbox credential masking, prompt-audit, and smarter plugin/session workflows

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.221 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.221

    └──▷ USE IT
    Mask a credential file in the sandbox so sandboxed commands see a sentinel value while the proxy substitutes the real secret on egress
    yaml copy

    mode: "mask"

    • ›Adds mode: "mask" for sandbox credential files on Linux and WSL — sandboxed commands read a sentinel copy (whole file or spans captured by an extract regex) while the sandbox proxy substitutes the real value on egress; macOS falls back to deny
    • ›Adds a prompt-audit subcommand to the claude-api skill for auditing prompts and tool descriptions for patterns written for older models
    • ›Adds warnings to claude plugin validate when a marketplace or plugin name would be rejected by Claude Desktop's managed marketplace sync
    • ›[VSCode] Adds Focus view, toggled with Ctrl+Alt+F or the 'Claude Code: Toggle Focus view' command, hiding tool activity behind an expandable per-turn summary with a live running-tool indicator
    • ›Adds '.' as a valid skills path value in plugins, and the root-level SKILL.md validation error now suggests using the plugin root
    +10 moreshow less

    • ›/status now shows the session kind: interactive, or a background job that is attached or unattended
    • ›/fork now creates a new worktree for the forked session instead of sharing the original session's checkout
    • ›Plugins installed via /plugin install now activate immediately when safe, without requiring /reload-plugins
    • ›/plugin install now refreshes a stale marketplace catalog and retries before reporting a plugin not found
    • ›Background sessions now commit and push to preserve work, open a draft PR only when the task calls for one, follow CLAUDE.md git instructions, and always report where work lives
    • ›Tool search on Google Vertex AI re-enabled for Claude 4.5-generation and newer models
    • ›Stats panel now counts cache tokens in its token totals, with a breakdown by input, output, cache read, and cache write
    • ›Emoji autocomplete now accepts common alternate shortcodes like :thumbsup:, :thumbsdown:, and :love:
    • ›Windows startup no longer spawns powershell.exe to read process creation times, eliminating prompts from endpoint security tools that gate powershell.exe
    • ›Auto-mode permission checks for parallel tool calls are now cache-efficient, reducing prompt-cache costs by reusing the cached conversation prefix across decisions
31. v2.1.219 Jul 24, 2026 · issue -026

    Claude Code v2.1.219 adds Opus 5, sandbox network controls, depth-3 subagent nesting, and richer MCP diagnostics

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.219 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.219

    └──▷ USE IT
    Lock sandbox commands to only your approved hosts, preventing any unapproved outbound traffic without a prompt.
    json copy

    {
      "sandbox": {
        "network": {
          "strictAllowlist": true
        }
      }
    }

    Set the dynamic workflow size guideline centrally from a shared settings file instead of relying on each user's /config.
    json copy

    {
      "workflowSizeGuideline": "medium"
    }

    • ›Adds sandbox.network.strictAllowlist setting to deny all non-allowlisted hosts for sandboxed commands without prompting.
    • ›Adds workflowSizeGuideline settings key so the advisory dynamic workflow size guideline can be set from any settings file; the /config row is hidden while one is active.
    • ›Adds mcp_server_errors field to the headless stream-json init event, listing --mcp-config entries skipped by config validation; terminal runs also print a startup warning.
    • ›Adds DirectoryAdded hook that fires after /add-dir or the SDK register_repo_root control request registers a new working directory mid-session.
    • ›Subagents can now spawn nested subagents up to depth 3 (was 1); set CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 to disable nesting.
    +6 moreshow less

    • ›Adds nested subagent forwarding in stream-json: subagents spawned at depth 2+ now appear when --forward-subagent-text is set, keyed by their spawning Agent tool_use id.
    • ›Adds Claude Opus 5 (claude-opus-5) as the new default Opus model with 1M context window, priced at $10/$50 per Mtok in fast mode.
    • ›Adds HTTP status and error text to claude mcp list and /mcp when a server fails to connect, plus a warning for MCP config values with hidden leading or trailing whitespace.
    • ›Adds structured failure categories to self-hosted runner spawn and session failures, distinguishing hook errors, runner crashes, and config errors.
    • ›Changes dynamic workflows to default to a medium size guideline (fewer than 15 agents); alternate sizes or unrestricted mode are selectable via Dynamic workflow size in /config.
    • ›Removes Opus 4.7 from fast mode; /fast now applies to Opus 5 and Opus 4.8.
    └──▷ BREAKING ON UPGRADE

    • !Opus 4.7 is removed from fast mode; /fast now applies only to Opus 5 and Opus 4.8.
    • !Managed MCP allowlist/denylist ${VAR} entries now resolve from the startup environment and managed-settings env instead of the settings-file env, which may change which values are substituted.
32. v2.1.219 Jul 24, 2026 · issue 001

    Claude Code v2.1.219 adds Opus 5, strict sandbox networking, new hooks, and depth-3 subagent nesting

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.219 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.219

    └──▷ USE IT
    Lock sandboxed commands to only the hosts you explicitly allow — no prompt, just deny everything else.
    json copy

    {
      "sandbox": {
        "network": {
          "strictAllowlist": true
        }
      }
    }

    Pin the Dynamic workflow size guideline in a shared settings file so all team members get the same agent-count target without needing to touch /config.
    json copy

    {
      "workflowSizeGuideline": "medium"
    }

    Prevent deeply nested subagent spawning in CI pipelines where you want a flat, auditable agent graph.
    copy

    $ CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 claude -p 'Run the full test suite and summarise failures'

    • ›Adds sandbox.network.strictAllowlist setting to deny non-allowlisted hosts for sandboxed commands without prompting — no user prompt, just block.
    • ›Adds workflowSizeGuideline settings key so the Dynamic workflow size guideline can be set from any settings file (the /config row is hidden while this key is active).
    • ›Adds mcp_server_errors field to the headless stream-json init event, listing --mcp-config entries skipped by config validation; terminal runs print a startup warning.
    • ›Adds DirectoryAdded hook that fires after /add-dir or the SDK register_repo_root control request registers a new working directory mid-session.
    • ›Adds nested subagent forwarding in stream-json: subagents spawned at depth-2+ now appear when --forward-subagent-text is set, keyed by their spawning Agent tool_use id.
    +5 moreshow less

    • ›Adds HTTP status and error text to claude mcp list and /mcp when a server fails to connect, plus a warning for MCP config values with hidden leading or trailing whitespace.
    • ›Adds Claude Opus 5 (claude-opus-5) as the new default Opus model — 1M context window, fast mode at $10/$50 per Mtok.
    • ›Subagents can now spawn nested subagents up to depth 3 (was 1); set CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 to disable nesting.
    • ›Dynamic workflows now default to a medium size guideline (fewer than 15 agents); change via Dynamic workflow size in /config.
    • ›Removes Opus 4.7 from fast mode; /fast now applies to Opus 5 and Opus 4.8 only.
    └──▷ BREAKING ON UPGRADE

    • !Opus 4.7 is removed from fast mode; /fast now applies only to Opus 5 and Opus 4.8 — workflows pinned to Opus 4.7 in fast mode will no longer run in fast mode.
    • !Subagent spawn depth default raised from 1 to 3; pipelines that relied on nesting being blocked at depth 2 will now allow deeper nesting unless CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 is set.
33. v2.1.218 Jul 22, 2026 · issue -028

    Claude Code v2.1.218 runs /code-review as a background subagent and expands skill/plugin config with new boolean values

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.218 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.218

    └──▷ USE IT
    Opt a specific skill out of the new default background execution when it uses context: fork.
    yaml copy

    context: fork
    background: false

    Diagnose a failing MCP server connection — HTTP status and error text now appear inline.
    copy

    $ claude mcp list

    • ›Accepts yes/no/on/off/1/0 (case-insensitive) as valid boolean values for skill and plugin frontmatter, alongside true/false.
    • ›Skills with context: fork now run in the background by default; opt out per skill with background: false in frontmatter.
    • ›Agent markdown files now reject agent names containing : (reserved for plugin namespacing).
    • ›Adds HTTP status and error text to claude mcp list and /mcp output when a server fails to connect, plus a warning for MCP config values with hidden leading or trailing whitespace.
    • ›Changes /code-review to run as a background subagent, keeping stacked slash commands as its review target without filling the active conversation.
    +7 moreshow less

    • ›Changes /deep-research to start only on manual invocation; Claude no longer auto-launches it.
    • ›Adds screen-reader announcements of deleted text for word and line deletions (Option+Delete, Ctrl+W, Cmd+Backspace, Ctrl+U, Ctrl+K) in --ax-screen-reader mode.
    • ›Adds an announcement when fast mode changes as a result of switching models via /config model=<x> or Remote Control.
    • ›Changes plan mode with auto so it no longer prompts for Bash commands the static analyzer cannot prove read-only; the auto-mode classifier judges them instead.
    • ›Improves auto mode: dangerous-rm, background-&, and suspicious-Windows-path checks no longer open permission dialogs — the auto-mode classifier adjudicates them.
    • ›Improves trust dialogs to name the repository root the grant covers.
    • ›Changes server-managed settings so benign feature and cost toggles no longer trigger the settings-approval prompt.
    └──▷ BREAKING ON UPGRADE

    • !Agent markdown files that use : in agent names will now be rejected; rename any such agents before upgrading.
34. v2.1.218 Jul 22, 2026 · issue 001

    Claude Code v2.1.218 runs /code-review as a background subagent, expands boolean syntax in frontmatter, and tightens auto-mode permission flow.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.218 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.218

    └──▷ USE IT
    Opt a specific skill out of the new default background execution when it uses context: fork.
    yaml copy

    context: fork
    background: false

    • ›Adds yes/no/on/off/1/0 (case-insensitive) as accepted boolean values in skill and plugin frontmatter, alongside the existing true/false.
    • ›Skills with context: fork now run in the background by default; opt out per-skill with background: false in frontmatter.
    • ›Switches /code-review to run as a background subagent, keeping stacked slash commands as its review target and preventing review output from flooding the conversation.
    • ›Adds HTTP status codes and error text to claude mcp list and /mcp when a server fails to connect, plus a warning for MCP config values with hidden leading or trailing whitespace.
    • ›Adds an announcement when fast mode changes due to a model switch via /config model=<x> or Remote Control.
    +8 moreshow less

    • ›Changes /deep-research to start only when invoked manually — Claude no longer launches it autonomously.
    • ›Improves auto mode: dangerous-rm, background-&, and suspicious-Windows-path checks no longer open permission dialogs; the auto-mode classifier adjudicates them instead.
    • ›Changes plan mode with auto to no longer prompt for Bash commands the static analyzer cannot prove read-only; the auto-mode classifier judges them instead.
    • ›Changes server-managed settings so benign feature and cost toggles no longer trigger the settings-approval prompt.
    • ›Rejects agent names containing : in agent markdown files, reserving that character for plugin namespacing.
    • ›Adds screen-reader announcements of deleted text for Option+Delete, Ctrl+W, Cmd+Backspace, Ctrl+U, and Ctrl+K in --ax-screen-reader mode.
    • ›Improves trust dialogs to name the specific repository root the grant covers.
    • ›Improves /ultrareview so descriptive arguments like 'review my auth changes' run a branch review with the text applied as a note to findings, and invalid arguments surface actionable error feedback.
    └──▷ BREAKING ON UPGRADE

    • !Agent markdown files now reject agent names containing : — any existing agent whose name includes : will be refused on load.
35. v2.1.217 Jul 21, 2026 · issue -029

    Claude Code v2.1.217 adds emoji autocomplete, subagent concurrency controls, and new transcript-failure warnings.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.217 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.217

    └──▷ TRY IT
    Allow subagents to spawn one level of nested subagents in an orchestration workflow that relies on hierarchical delegation.
    copy

    $ CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 claude

    • ›Adds emojiCompletionEnabled setting to control emoji shortcode autocomplete in the prompt input — type :heart: to insert or :hea for suggestions; set emojiCompletionEnabled to false to disable.
    • ›Adds CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS environment variable to cap concurrently-running subagents (default 20), preventing a single message from fanning out unbounded background agents.
    • ›Adds CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH environment variable to allow nested subagent spawning beyond the new default of zero (subagents no longer spawn nested subagents by default).
    • ›Adds FORCE_HYPERLINK=0 environment variable to opt out of always-on footer PR badge hyperlinks, which are now clickable even when terminal hyperlink support cannot be detected (e.g. over SSH/tmux).
    • ›Adds warnings when transcript writes are failing (e.g. disk full) or when session saving is disabled due to an inherited environment variable, rather than silently losing transcripts.
    └──▷ BREAKING ON UPGRADE

    • !Subagents no longer spawn nested subagents by default; set CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH to restore deeper nesting.
36. v2.1.217 Jul 21, 2026 · issue 001

    Claude Code v2.1.217 adds subagent concurrency caps, emoji autocomplete, transcript-failure warnings, and AWS gateway deployment assets.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.217 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.217

    └──▷ TRY IT
    Limit how many background agents a single agentic session can fan out to, to control cost and resource usage.
    copy

    $ CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=5 claude

    Allow subagents to spawn their own subagents up to a controlled depth when running multi-layer agentic pipelines.
    copy

    $ CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=2 claude

    • ›Adds CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS environment variable (default 20) to cap concurrently-running subagents, preventing a single message from fanning out unbounded background agents.
    • ›Adds CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH environment variable to allow nested subagent spawning; by default subagents no longer spawn nested subagents.
    • ›Adds emojiCompletionEnabled setting to control emoji shortcode autocomplete in the prompt input (type :heart: to insert or :hea for suggestions).
    • ›Adds FORCE_HYPERLINK=0 environment variable to opt out of footer PR badge links being rendered as clickable hyperlinks even when terminal support cannot be detected (e.g. over ssh/tmux).
    • ›Adds AWS reference deployment assets under examples/gateway/aws/ — including setup.sh, Dockerfile, gateway.yaml.example (Bedrock upstream, Okta IdP), and a terraform/ module — for running Claude apps gateway on AWS with Amazon Bedrock.
    +1 moreshow less

    • ›Adds warnings when transcript writes are failing (e.g. disk full) or when session saving is off due to an inherited environment variable, instead of silently losing transcripts.
    └──▷ BREAKING ON UPGRADE

    • !Subagents no longer spawn nested subagents by default; set CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH to restore deeper nesting.
37. v2.1.216 Jul 20, 2026 · issue -030

    Claude Code v2.1.216 adds sandbox.filesystem.disabled to decouple filesystem isolation from network egress control.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.216 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.216

    └──▷ USE IT
    Keep network egress sandboxed but allow Claude Code to access the filesystem freely — useful when your workflow depends on filesystem hooks or tools that break under filesystem isolation.
    yaml copy

    sandbox.filesystem.disabled: true

    • ›Adds sandbox.filesystem.disabled setting to skip filesystem isolation while keeping network egress control active.
    • ›Background sessions: /mcp and /install-github-app now park a 'needs input' request in the agent view when no client is attached.
    • ›The /fork confirmation now shows the new session's name, claude attach id, and a note when the copy shares the checkout.
    • ›The /ultrareview diff-too-large error now shows configured limits, measured diff size, and the largest contributing files.
    • ›The /code-review ultra empty-diff message now names the exact base ref and suggests passing an explicit base.
    +1 moreshow less

    • ›The /context command now shows an explicit warning when the conversation exceeds the context window, and a failed /compact displays as an error.
38. v2.1.216 Jul 20, 2026 · issue 001

    Adds sandbox.filesystem.disabled setting to decouple filesystem isolation from network egress control in Claude Code v2.1.216.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.216 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.216

    └──▷ USE IT
    Allow a sandboxed agent to access the filesystem freely while still restricting outbound network traffic.
    .claude/settings.json copy

    sandbox.filesystem.disabled: true

    • ›Adds sandbox.filesystem.disabled setting to skip filesystem isolation while keeping network egress control active.
    • ›/fork confirmation now shows the new session name, claude attach id, and a note when the copy shares your checkout — all on one line.
    • ›/context now shows an explicit warning when the conversation exceeds the context window, and a failed /compact displays as an error.
    • ›/rewind now reports how many tracked paths it skipped rather than silently restoring or deleting files through symlinks or hard links.
    • ›Background sessions: /mcp and /install-github-app now park a 'needs input' request in the agent view when no client is attached.
    +3 moreshow less

    • ›/ultrareview diff-too-large error now shows configured limits, measured diff size, and the largest contributing files.
    • ›/code-review ultra empty-diff message now names the exact base ref and suggests passing an explicit base.
    • ›Spend limit adjustment prompt now shows the server's reason when a spend limit change is rejected.
39. v2.1.214 Jul 18, 2026 · issue -032

    Claude Code v2.1.214 adds EndConversation tool, OTEL enhancements, and new docker permission prompts.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.214 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.214

    └──▷ TRY IT
    Cap the size of OTEL content attributes to avoid bloated traces when Claude Code handles large tool outputs.
    copy

    $ export CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH=32768
    claude

    • ›Adds CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH environment variable to configure the 60 KB truncation limit on OpenTelemetry content attributes.
    • ›Adds message.uuid, client_request_id, and tool_source attributes to OpenTelemetry log events for message-level correlation and tool provenance.
    • ›Adds permission prompts for docker commands (including the Podman docker shim) carrying daemon-redirect flags --url, --connection, --identity, and Podman's remote mode.
    • ›Adds the EndConversation tool, allowing Claude to end sessions with highly abusive users or jailbreak attempts.
    • ›Adds an ISO modified timestamp to memory file frontmatter.
    +5 moreshow less

    • ›Adds reasoning effort to the subagentStatusLine payload so custom agent rows can render model and effort.
    • ›Adds a periodic progress heartbeat for long-running tool calls that previously went silent.
    • ›Changes SessionStart hooks to report source: 'fork' when a session begins as a fork instead of 'resume'.
    • ›Changes single-segment dir/** hook if: conditions to match only <cwd>/dir; use **/dir/** for any-depth matching.
    • ›Changes file commands using -m/--magic-file or -f/--files-from to require permission instead of being auto-allowed as read-only.
    └──▷ BREAKING ON UPGRADE

    • !Single-segment dir/** hook if: conditions now match only <cwd>/dir; any-depth matching requires rewriting the pattern to **/dir/**.
    • !file commands using -m/--magic-file or -f/--files-from now require explicit permission instead of being auto-allowed as read-only — existing workflows relying on silent approval will now prompt.
    • !SessionStart hooks now receive source: 'fork' instead of source: 'resume' when a session begins as a fork — hook logic that branches on 'resume' may misclassify fork sessions.
40. v2.1.212 Jul 17, 2026 · issue -033

    Claude Code v2.1.212 adds per-session search/subagent caps, MCP auto-backgrounding, and a redesigned /fork workflow

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.212 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.212

    └──▷ TRY IT
    Cap the number of web searches an autonomous session can make to avoid runaway search loops in long-running agents.
    copy

    $ CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION=50 claude --bg 'Research all CVEs published last week and summarize the top 10'

    Limit subagent delegation in a complex multi-agent run, then reset the budget mid-session with /clear if you need to continue.
    copy

    $ CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION=20 claude 'Refactor the entire src/ directory using parallel subagents'

    Lower the MCP auto-background threshold so slow tool calls move to the background sooner, keeping your session interactive.
    copy

    $ CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS=30000 claude

    • ›Adds CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION environment variable to tune the new per-session WebSearch call limit (default 200), preventing runaway search loops.
    • ›Adds CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION environment variable to tune the new per-session subagent spawn cap (default 200); /clear resets the budget.
    • ›Adds CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS environment variable to configure (or disable) the threshold at which MCP tool calls running longer than 2 minutes automatically move to the background.
    • ›Adds claude auto-mode reset subcommand to restore the default auto-mode configuration; accepts --yes to skip the confirmation prompt.
    • ›Redesigns /fork to copy the conversation into a new background session (its own row in claude agents) while you keep working; the previous in-session subagent behavior is now /subtask.
    +7 moreshow less

    • ›Adds /resume in the agent view as a picker of past sessions — including sessions deleted from the list — resuming the selected one as a background session.
    • ›Enterprise forceLoginMethod is now enforced for VS Code extension, SDK, setup-token, and install-github-app logins, not just the terminal.
    • ›Headless/SDK sessions now apply a set_model control request mid-turn, switching models on the next round-trip without waiting for the next turn.
    • ›Agent view and claude agents --json now surface sessions waiting on a sandbox, MCP-input, or managed-settings prompt as 'Needs input' instead of 'Working'.
    • ›Session transcripts now record the reasoning effort level on each assistant message.
    • ›Reduces token usage in inter-agent messaging: SendMessage bodies are no longer duplicated into replayed history and tool results.
    • ›Improves prompt caching: the mid-conversation system block now works behind LLM gateways and custom base URLs (Bedrock, Vertex, 1P).
    └──▷ BREAKING ON UPGRADE

    • !The Task tool's mode parameter is deprecated and now ignored; subagents inherit the parent session's permission mode by default.
    • !/fork no longer launches an in-session subagent — that behavior is now /subtask. Workflows that relied on /fork for subagent spawning must switch to /subtask.
41. v2.1.211 Jul 15, 2026 · issue -035

    Claude Code v2.1.211 adds --forward-subagent-text flag and CLAUDE_CODE_FORWARD_SUBAGENT_TEXT env var for subagent stream output, plus several workflow improvements.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.211 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.211

    └──▷ TRY IT
    Set token budget with scientific notation in an environment where the variable must be typed or scripted compactly.
    copy

    $ export CLAUDE_MAX_TOKENS=1e6
    claude -p 'Summarize this large codebase'

    • ›Adds --forward-subagent-text flag and CLAUDE_CODE_FORWARD_SUBAGENT_TEXT environment variable to include subagent text and thinking in stream-json output.
    • ›Integer environment variables (timeouts, token budgets, retry counts) now accept scientific notation and digit-separator spellings like 1e6 and 64_000.
    • ›Changes 'always allow' permission rules to save at the repository root, so approvals granted in a git worktree persist across sessions and worktrees.
    • ›Changes /usage-credits to ask for confirmation before sending a request to organization admins.
    • ›The save_to_disk option on Claude in Chrome screenshot actions now writes the image to disk and returns the path (previously did nothing).
    +2 moreshow less

    • ›Changes Vim mode s and S (substitute char/line) to work in NORMAL mode, matching standard vim behavior.
    • ›Improves background agent result reporting — Claude now reports the status of still-running agents and waits for real completion instead of fabricating results.
42. v2.1.210 Jul 14, 2026 · issue -036

    Claude Code v2.1.210 adds live tool-call timers, permission-rule warnings, screen reader announcements, and smarter agent dashboard cues.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.210 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.210

    • ›Adds a live elapsed-time counter to the collapsed tool summary line so long-running tool calls visibly tick instead of appearing stuck.
    • ›Adds a startup warning when Write(path), NotebookEdit(path), or Glob(path) are used as permission rules, directing users to Edit(path) or Read(path) instead.
    • ›Screen reader mode now announces permission mode changes aloud when cycling modes with Shift+Tab.
    • ›Memory writes that leave a MEMORY.md index over its read limit now produce an explicit error instead of silent truncation.
    • ›The agents footer hint now shows how many background agents are waiting on input, with color emphasis when the count changes.
    +1 moreshow less

    • ›Improves auto mode: the permission classifier now defaults to Sonnet 5 for external sessions, validated on the first request and pinned for the session.
43. v2.1.208 Jul 14, 2026 · issue -036

    Claude Code v2.1.208 adds screen reader mode, vim insert remaps, corporate process wrapper, and mouse support in fullscreen menus.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.208 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.208

    └──▷ TRY IT
    Enable plain-text rendering for a screen reader user without modifying settings files.
    copy

    $ CLAUDE_AX_SCREEN_READER=1 claude

    Route all Claude Code child processes through a corporate launcher (e.g. for audit logging or credential injection).
    copy

    $ CLAUDE_CODE_PROCESS_WRAPPER=/usr/local/bin/corp-launcher claude

    Map jj to Escape in vim insert mode so you never have to reach for the Escape key.
    json copy

    # In ~/.claude/settings.json
    { "vimInsertModeRemaps": { "jj": "Escape" } }

    • ›Adds screen reader mode (--ax-screen-reader / CLAUDE_AX_SCREEN_READER=1 / axScreenReader: true) for opt-in plain-text rendering.
    • ›Adds vimInsertModeRemaps setting to map two-key insert-mode sequences (e.g. jj → Escape) in vim mode.
    • ›Adds CLAUDE_CODE_PROCESS_WRAPPER env var so every Claude Code self-spawn is routed through a required corporate launcher executable.
    • ›Adds mouse-click support for multi-select menus and "Other" input rows in fullscreen mode.
    • ›Completed background agents now remain listed in /tasks until cleanup instead of disappearing immediately on finish.
    +5 moreshow less

    • ›Ctrl+X in agent view deletes renamed-branch worktrees while protecting unpushed commits and preserving the session row when a worktree is kept.
    • ›Catastrophic removals (e.g. rm -rf ~) inside command substitutions ($(…), backticks, <(…)) now prompt even in --dangerously-skip-permissions and auto mode.
    • ›Per-tool-call CPU overhead in print/SDK sessions reduced up to 7× at high MCP tool counts via tool-pool assembly caching.
    • ›Session transcript size reduced up to 79× in edit-heavy sessions by pruning superseded file-history backups.
    • ›/usage now shows last-known usage bars with an "as of" note when the usage endpoint is rate-limited, instead of an error screen.
44. v2.1.207 Jul 11, 2026 · issue -039

    Claude Code v2.1.207 makes Auto Mode generally available on Bedrock, Vertex, and Foundry and tightens plugin security.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.207 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.207

    └──▷ USE IT
    Disable auto mode on Bedrock or Vertex if you relied on the old opt-in flag to keep it off.
    json copy

    # In ~/.claude/settings.json
    {
      "disableAutoMode": true
    }

    Migrate a plugin hook from shell-form (now rejected for user-config interpolation) to exec form so it survives the security change.
    json copy

    # Before (rejected):
    # command: "my-hook ${user_config.api_key}"
    
    # After — exec form in hook definition:
    {
      "args": ["my-hook", "$CLAUDE_PLUGIN_OPTION_API_KEY"]
    }

    • ›Auto mode is now available on Bedrock, Vertex AI, and Foundry without the CLAUDE_CODE_ENABLE_AUTO_MODE opt-in flag; disable via disableAutoMode in settings.
    • ›Bedrock, Vertex, and Claude Platform on AWS now default to Claude Opus 4.8.
    • ›Plugin hooks/monitors/MCP headersHelper: ${user_config.*} in shell-form commands is now rejected; hooks must use exec form (args array) or $CLAUDE_PLUGIN_OPTION_<KEY>.
    • ›Plugin option values (pluginConfigs) are no longer read from project-level .claude/settings.json; only user, --settings, and managed settings are honored.
    • ›Agent view: pasting the same text again now expands the existing collapsed [Pasted text #N] placeholder instead of creating a duplicate.
    +2 moreshow less

    • ›Agent view: blocked session peeks now lead with the question and display a worded staleness clock (e.g. waiting 3m).
    • ›/doctor now reports when the launcher at ~/.local/bin/claude is externally managed.
    └──▷ BREAKING ON UPGRADE

    • !Auto mode no longer reads autoMode from .claude/settings.local.json (repo-resident); move the setting to ~/.claude/settings.json.
    • !${user_config.*} interpolation in shell-form plugin hook/monitor/headersHelper commands is rejected; switch to exec form (args array) or $CLAUDE_PLUGIN_OPTION_<KEY> for hooks, or read the value inside the script for monitors and headersHelper.
    • !pluginConfigs plugin option values are no longer read from project-level .claude/settings.json; only user-level, --settings, and managed settings are honored.
45. v2.1.206 Jul 10, 2026 · issue -040

    Claude Code v2.1.206 adds directory suggestions for /cd, a /doctor CLAUDE.md trimmer, smarter git push remotes, and faster background agent upgrades.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.206 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.206

    └──▷ TRY IT
    Quickly identify and slim down a bloated CLAUDE.md before committing it to the repo.
    copy

    $ /doctor

    Navigate to a subdirectory mid-session with autocomplete suggestions, the same way /add-dir works.
    copy

    $ /cd src/

    • ›Adds directory path suggestions to /cd, matching the autocomplete behavior already available in /add-dir.
    • ›New /doctor check analyzes checked-in CLAUDE.md files and proposes trimming content Claude can derive directly from the codebase.
    • ›/commit-push-pr now auto-allows git push to the repo's configured remote.pushDefault (or the sole remote when only one exists), not just origin.
    • ›/login now supports Anthropic-operated public gateway endpoints.
    • ›EnterWorktree prompts for confirmation before entering a git worktree outside the project's .claude/worktrees/ directory.
    +3 moreshow less

    • ›Background agents upgrade to a new Claude Code version immediately after an update, eliminating the slow stale-session upgrade cost on attach.
    • ›Agents view status column now uses full terminal width instead of truncating at 64 characters.
    • ›Ctrl+X in the agents view now permanently removes a completed session; deleted background jobs stay deleted across renders.
46. v2.1.205 Jul 8, 2026 · issue -042

    Claude Code v2.1.205 adds a full /doctor setup checkup, smarter agent view with PR linking, and a new auto-mode safety rule for rm -rf.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.205 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.205

    └──▷ TRY IT
    Review agent sessions with PR-linked context and human-readable status headlines.
    copy

    $ claude agents

    • ›Adds an auto mode rule that blocks tampering with session transcript files.
    • ›Adds auto mode prompt before running rm -rf on a variable it can't resolve from context.
    • ›Improves agent view: sessions that edit, merge, comment on, or push to an existing PR now link it in claude agents.
    • ›Improves agent view: rows now show a colored state word and a classifier-written headline instead of raw tool call text, with full status and exact ask for blocked sessions in the peek.
    • ›Background task notifications now explicitly state that no human input has occurred, preventing fabricated in-transcript approvals from being acted on.
    +2 moreshow less

    • ›Auto-update binary downloads now stream to disk instead of buffering in memory, cutting peak updater memory usage by roughly 400 MB.
    • ›Reserves the 'Claude Browser' MCP server name (alongside 'Claude Preview'); user-configured MCP servers can no longer register under either name.
    └──▷ BREAKING ON UPGRADE

    • !User-configured MCP servers can no longer register under the name 'Claude Browser' or 'Claude Preview'; servers using either name will be rejected.
47. v2.1.203 Jul 7, 2026 · issue -043

    Claude Code v2.1.203 adds login-expiry warnings, MCP roots integration, a manual-permission badge, and a VSCode remote-control toggle.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.203 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.203

    • ›Adds a warning when your login session is about to expire so you can re-authenticate before background sessions are interrupted.
    • ›Adds a grey ⏸ badge to the footer when manual permission mode is active, making the current mode always visible.
    • ›Exposes the session's additional working directories via MCP roots/list, with notifications/roots/list_changed fired whenever the set changes.
    • ›Moves 'claude command missing or broken' startup warnings out of the launch flow into /doctor and /status for on-demand review.
    • ›Changes the claude agents detail views (background tasks, diff, workflow) to close with Esc instead of the left arrow key.
    +2 moreshow less

    • ›Redesigns the empty claude agents view to always display organized sections (Needs Input / Working / Completed) with descriptions.
    • ›[VSCode] Adds a Settings toggle for 'Enable Remote Control for all sessions'.
    └──▷ BREAKING ON UPGRADE

    • !The left arrow key no longer closes the background tasks, diff, and workflow detail views — press Esc instead.
48. v2.1.202 Jul 6, 2026 · issue -044

    Claude Code v2.1.202 adds dynamic workflow sizing, OTel workflow attributes, and a multi-level /code-review command.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.202 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.202

    └──▷ TRY IT
    Cap agent count for lighter workflows to reduce cost or context usage.
    copy

    $ /config

    • ›New 'Dynamic workflow size' setting in /config lets you guide how many agents Claude spawns in dynamic workflows (small/medium/large) — advisory, not a hard cap.
    • ›Adds workflow.run_id and workflow.name OpenTelemetry attributes to telemetry from workflow-spawned agents, enabling full reconstruction of a workflow run from OTel data.
    • ›New /code-review <level> <pr#> command runs a multi-agent PR review at a chosen effort level; /review <pr> reverts to fast single-pass review.
    └──▷ BREAKING ON UPGRADE

    • !/review <pr> now performs a fast single-pass review instead of the multi-agent review; use /code-review <level> <pr#> to get multi-agent review behavior.
49. v2.1.200 Jul 3, 2026 · issue -047

    Claude Code v2.1.200 makes 'Manual' the default permission mode and adds opt-in idle timeout for AskUserQuestion dialogs.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.200 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.200

    • ›Changes --permission-mode manual and "defaultMode": "manual" in config to be the new default permission mode across CLI, --help, VS Code, and JetBrains (previously called 'default').
    • ›Adds opt-in idle timeout for AskUserQuestion dialogs via /config, replacing the previous auto-continue behavior.
50. v2.1.199 Jul 2, 2026 · issue -048

    Claude Code v2.1.199 adds stacked skill invocations, auto-retry on 429s, and an elevated retry watchdog cap.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.199 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.199

    └──▷ TRY IT
    Compose multiple skills in a single invocation to layer context before a task — useful when a workflow requires, e.g., a security-review skill and a code-style skill together.
    copy

    $ /skill-security /skill-codestyle review this PR for vulnerabilities and style issues

    • ›Supports stacked slash-skill invocations (/skill-a /skill-b do XYZ) loading up to 5 leading skills simultaneously, not just the first.
    • ›Transient server rate-limit errors (429s unrelated to usage limits) are now automatically retried with backoff for subscribers instead of failing the turn.
    • ›New CLAUDE_CODE_RETRY_WATCHDOG behaviour raises the default retry count for non-capacity transient errors to 300 and removes the previous cap of 15 on CLAUDE_CODE_MAX_RETRIES.
    • ›Pull-request links in claude agents session rows now render as bare #N for cleaner output.
51. v2.1.198 Jul 1, 2026 · issue -049

    Claude Code v2.1.198 ships background subagents by default, auto-PR on worktree completion, /dataviz skill, and AWS upstream gateway support.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.198 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.198

    └──▷ TRY IT
    Receive a desktop notification when a background agent finishes or needs input — useful for long-running tasks you want to monitor hands-off.
    copy

    $ claude agents

    • ›Subagents now run in the background by default, letting Claude continue working and receive notifications when they finish.
    • ›Claude in Chrome is now generally available.
    • ›Adds agent_needs_input and agent_completed notification hooks to claude agents via the Notification hook.
    • ›New /dataviz skill for chart and dashboard design guidance with a runnable color-palette validator.
    • ›Gateway adds Claude Platform on AWS (anthropicAws) as an upstream provider; model-not-found responses now advance the failover chain.
    +10 moreshow less

    • ›Background agents launched from claude agents now automatically commit, push, and open a draft PR when they finish code work in a worktree.
    • ›The built-in Explore agent now inherits the main session's model (capped at opus) instead of running on haiku.
    • ›Subagents and context compaction now inherit the session's extended thinking configuration, improving output quality on delegated tasks.
    • ›Improved focus mode: subagents launched in a turn appear in its activity summary, and completed background notifications fold into a single count.
    • ›Syntax highlighting accuracy improved in code blocks, diffs, and file previews by upgrading to highlight.js 11.
    • ›Keyboard shortcut hints now show opt/cmd instead of alt/super when connected from a Mac over SSH.
    • ›API retry UX now shows the error reason after the second attempt, and displays a status page link when the API is overloaded.
    • ›/login now opens the sign-in dialog from the claude agents view.
    • ›Subagents now treat messages from the agent that launched them as normal task direction.
    • ›Removed the /agents wizard; subagents are now created by asking Claude or editing .claude/agents/ directly.
    └──▷ BREAKING ON UPGRADE

    • !The /agents wizard has been removed; subagent creation must now be done by asking Claude directly or editing .claude/agents/ manually.
    • !claude --bg combined with --print/-p is now rejected up front instead of silently creating an unattachable session.
52. v2.1.197 Jun 30, 2026 · issue -050

    Claude Sonnet 5 is now the default model in Claude Code, with a 1M-token context window and promotional pricing through August 31.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.197 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.197

    • ›Switches default model to Claude Sonnet 5, featuring a native 1M-token context window for working across massive codebases in a single session.
    • ›Introduces promotional pricing of $2/$10 per million input/output tokens through August 31, 2025.
53. v2.1.196 Jun 29, 2026 · issue -051

    Claude Code v2.1.196 adds org-default models, clickable file attachments, and an always-on stream watchdog.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.196 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.196

    └──▷ TRY IT
    Disable the new always-on stream watchdog if your provider intentionally sends long silent gaps (e.g. a slow self-hosted endpoint).
    copy

    $ CLAUDE_ENABLE_STREAM_WATCHDOG=0 claude

    • ›Adds organization default models: admins set a model in the org console; users see 'Org default' or 'Role default' in /model when no personal selection is made.
    • ›Adds readable default session names at start, making sessions easier to identify and resume.
    • ›Adds clickable file attachments in chat — Cmd/Ctrl-click reveals the file in Finder/Explorer.
    • ›Enables the streaming idle watchdog by default for all providers: aborts and retries any response stream that produces no events for 5 minutes; disable with CLAUDE_ENABLE_STREAM_WATCHDOG=0.
    • ›Improves background agents: workers killed by a daemon restart are automatically resumed from where they left off when the agents view next opens.
    +3 moreshow less

    • ›Improves /code-review workflow: merges five cleanup finders into one, cutting token usage by roughly 25%.
    • ›Disables Remote Control automatically when ANTHROPIC_BASE_URL points at a non-Anthropic host, matching existing behavior under CLAUDE_CODE_USE_BEDROCK/_VERTEX/_FOUNDRY.
    • ›Hardens claude mcp list/get: untrusted workspaces no longer auto-spawn .mcp.json servers self-approved via a committed .claude/settings.json; such servers show ⏸ Pending approval instead.
    └──▷ BREAKING ON UPGRADE

    • !Opening the agents view from a foreground session now requires a single ← press instead of two.
54. v2.1.195 Jun 26, 2026 · issue -054

    Claude Code v2.1.195 adds mouse-disable env var for fullscreen mode and improves remote session startup UX.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.195 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.195

    └──▷ TRY IT
    Suppress accidental mouse clicks and drags in a fullscreen Claude Code session (e.g. on a touch-enabled display or when embedding in a kiosk) while keeping scroll working.
    copy

    $ CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1 claude

    • ›Adds CLAUDE_CODE_DISABLE_MOUSE_CLICKS env var to suppress mouse click/drag/hover in fullscreen mode while preserving wheel scroll.
    • ›Improves claude agents completed list to fill available vertical space, with a compacting header on short terminals so live sessions stay visible.
    • ›Improves remote session startup with a provisioning checklist displayed while the container initializes.
    • ›Improves Linux voice mode to distinguish between 'no microphone detected' and 'SoX not installed' when SoX is present but no capture device exists.
    └──▷ BREAKING ON UPGRADE

    • !Hook matchers now exact-match hyphenated identifiers (e.g. code-reviewer, mcp__brave-search) instead of substring-matching — existing hooks that relied on partial matches will stop firing; use mcp__brave-search__.* to match all tools from a hyphenated MCP server.
55. v2.1.193 Jun 25, 2026 · issue -055

    Claude Code v2.1.193 adds shell classifier routing, OTEL response logging, live path autocomplete, and memory-pressure reaping for background shells.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.193 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.193

    └──▷ USE IT
    Enforce auto-mode classification on every shell command — useful in enterprise deployments that want consistent policy enforcement across all Bash/PowerShell invocations, not just detected code-execution patterns.
    json copy

    # In your Claude Code settings (e.g. settings.json)
    { "autoMode.classifyAllShell": true }

    Capture full assistant response text in your OTEL pipeline for audit or compliance logging.
    📍OTEL_LOG_ASSISTANT_RESPONSES=1 claude ...
    Prevent idle background shell commands from being reaped under memory pressure if your workflow depends on long-lived idle shells.
    📍CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1 claude ...
    • ›New autoMode.classifyAllShell setting routes all Bash/PowerShell commands through the auto-mode classifier, not just arbitrary-code-execution patterns.
    • ›Adds auto-mode denial reasons to the transcript, denial toast, and /permissions recent denials for better visibility into blocked actions.
    • ›New claude_code.assistant_response OpenTelemetry log event captures the model's full response text (redacted by default; enable with OTEL_LOG_ASSISTANT_RESPONSES=1).
    • ›Adds live file path autocomplete in bash mode (!) for faster command entry.
    • ›Adds a startup notice when MCP servers need authentication, pointing users to /mcp.
    +1 moreshow less

    • ›Adds automatic memory-pressure reaping for idle background shell commands (disable with CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1).
    └──▷ BREAKING ON UPGRADE

    • !The claude_code.assistant_response OTEL log event is emitted by default when OTEL_LOG_USER_PROMPTS is enabled — deployments that already log prompt content will also start receiving response content on upgrade. Set OTEL_LOG_ASSISTANT_RESPONSES=0 to keep prompts-only logging.
56. v2.1.191 Jun 24, 2026 · issue -056

    Claude Code v2.1.191 adds /rewind to restore conversations before /clear, cuts streaming CPU usage ~37%, and hardens MCP reliability.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.191 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.191

    └──▷ TRY IT
    Accidentally cleared your conversation mid-session? Use /rewind to jump back to the state before /clear and continue without losing context.
    copy

    $ /rewind

    • ›Adds /rewind command to resume a conversation from the state it was in before /clear was run.
    • ›Sandbox network permission dialog now remembers allowed hosts for the entire session, eliminating repeated prompts.
    • ›MCP capability discovery (tools/list, prompts/list, resources/list) now retries transient network errors with backoff, improving server reliability.
    • ›MCP OAuth in headless environments skips the browser popup and goes directly to the paste-the-URL prompt.
    • ›MCP HTTP 404 errors now surface the URL and point to the MCP config file for faster debugging.
57. v2.1.187 Jun 23, 2026 · issue -057

    Claude Code v2.1.187 adds sandbox credential blocking, org model restrictions, and mouse support in fullscreen menus.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.187 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.187

    • ›Adds sandbox.credentials setting to block sandboxed commands from reading credential files and secret environment variables.
    • ›Adds org-configured model restrictions enforced across the model picker, --model, /model, and ANTHROPIC_MODEL, with a clear 'restricted by your organization's settings' message.
    • ›Adds mouse click support for selecting menus (permission prompts, /model, /config, etc.) in fullscreen mode.
    • ›Improves /install-github-app to make GitHub Actions workflow setup optional — install just the GitHub App and skip the workflow/secret steps.
    • ›Improves /btw with ←/→ arrow navigation to step through earlier answers.
    +1 moreshow less

    • ›Improves /plugin to surface recently unused plugins for easier cleanup.
58. v2.1.186 Jun 22, 2026 · issue -058

    Claude Code v2.1.186 adds CLI MCP auth, bash auto-response, SSH-friendly headless login, and richer workflow/plugin views.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.186 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.186

    └──▷ TRY IT
    Authenticate a named MCP server over SSH without a browser pop-up.
    copy

    $ claude mcp login my-server --no-browser

    Keep the old context-only behavior for bash commands instead of having Claude auto-reply to their output.
    json copy

    # settings.json
    { "respondToBashCommands": false }

    • ›Adds claude mcp login <name> and claude mcp logout <name> to authenticate MCP servers directly from the CLI, with --no-browser stdin redirect for SSH sessions.
    • ›Adds ! bash command auto-response: Claude now automatically replies to bash command output; disable with "respondToBashCommands": false in settings.json.
    • ›Adds status filtering (press f) to the /workflows agent detail view.
    • ›Adds a 'Skills' section to the /plugin Installed tab.
    • ›Adds teammateMode: "iterm2" setting with a warning when auto mode cannot find the it2 CLI.
    +6 moreshow less

    • ›Adds 'Claude Platform on AWS - refresh credentials' option to /login when awsAuthRefresh is configured.
    • ›Background subagents now surface permission prompts in the main session instead of auto-denying, showing which agent is asking; Esc denies just that tool.
    • ›Improves memory: the agent is now reminded to compact its MEMORY.md index when nearing the size limit.
    • ›Improves skill frontmatter to accept display-name, default-enabled, fallback, and metadata.* keys in kebab-case, snake_case, and camelCase.
    • ›Improves malformed SKILL.md YAML frontmatter handling: loads the skill body with empty metadata instead of failing silently.
    • ›Changes /review <pr> to use the same review engine as /code-review medium.
    └──▷ BREAKING ON UPGRADE

    • !CLAUDE_CODE_MAX_RETRIES is now capped at 15; unattended sessions that relied on higher values must switch to CLAUDE_CODE_RETRY_WATCHDOG instead.
59. v2.1.183 Jun 19, 2026 · issue -061

    Claude Code v2.1.183 adds IaC destroy guards, deprecated-model warnings, and a new attribution.sessionUrl setting.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.183 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.183

    └──▷ TRY IT
    List all shorthand keys you can set inline with /config key=value, so you don't have to guess field names.
    copy

    $ /config --help

    • ›Blocks destructive git commands (git reset --hard, git checkout -- ., git clean -fd, git stash drop) in auto mode unless you explicitly asked to discard local work, and blocks git commit --amend on commits not made by the agent this session.
    • ›Blocks terraform destroy, pulumi destroy, and cdk destroy in auto mode unless you asked for the specific stack.
    • ›Adds a warning on stderr (in -p print mode) when the requested model is deprecated or auto-updated to a newer model, now also covering models set in agent frontmatter.
    • ›Adds attribution.sessionUrl setting to omit the claude.ai session link from commits and PRs in web and Remote Control sessions.
    • ›Adds /config --help to list all available shorthand keys for /config key=value.
    +1 moreshow less

    • ›Changes /config toggle behavior: Enter and Space both change the selected setting; Esc now saves and closes instead of reverting.
    └──▷ BREAKING ON UPGRADE

    • !The /config Esc key no longer reverts changes — it now saves and closes the config panel.
    • !The startup 'setup issues' line under the logo has been removed; run /doctor or use --debug to see configuration issues.
60. v2.1.181 Jun 17, 2026 · issue -063

    Claude Code v2.1.181 adds in-prompt config setting, Apple Events sandbox opt-in, and a presence-file push-notification suppressor.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.181 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.181

    └──▷ TRY IT
    Toggle extended thinking off mid-session without leaving the prompt.
    copy

    $ /config thinking=false

    Suppress mobile push notifications while you're actively at your machine by pointing the env var at a lock file you create on login.
    copy

    $ export CLAUDE_CLIENT_PRESENCE_FILE="$HOME/.claude_presence" && touch "$HOME/.claude_presence" && claude

    • ›Adds /config key=value slash command to set any configuration value directly from the prompt (e.g. /config thinking=false), works in interactive mode, -p, and Remote Control.
    • ›Adds sandbox.allowAppleEvents opt-in setting so sandboxed commands can send Apple Events on macOS.
    • ›Adds CLAUDE_CLIENT_PRESENCE_FILE environment variable: point it at a marker file to suppress mobile push notifications while at the machine.
    • ›Upgrades the bundled Bun runtime to v1.4.
    • ›Improves streaming of long paragraphs: text now appears line-by-line instead of waiting for the first line break.
    +3 moreshow less

    • ›Improves subagent panel: idle subagents auto-hide after 30 s, list caps at 5 rows with scroll hints, and keyboard hints appear in the footer.
    • ›Improves MCP OAuth browser page to match Claude Code's visual style and auto-close on success.
    • ›Changes fullscreen mode URL opening to require Cmd+click (macOS) / Ctrl+click, matching native terminal behavior.
    └──▷ BREAKING ON UPGRADE

    • !Fullscreen mode URL opening now requires Cmd+click (macOS) / Ctrl+click; plain clicks no longer open URLs.
61. v2.1.178 Jun 15, 2026 · issue -065

    Claude Code v2.1.178 adds parameter-matching permission rules, smarter nested skill/directory scoping, and tighter subagent safety checks.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.178 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.178

    • ›Adds Tool(param:value) syntax for permission rules to match on a tool's input parameters, with * wildcard support (e.g. Agent(model:opus) to block Opus subagents).
    • ›Nested .claude/skills directories now load automatically when working in their directory; name clashes surface as <dir>:<name> so both skills remain accessible.
    • ›Nearest-wins scoping for nested .claude/ directories: agent, workflow, and output-style configs closest to the working directory take precedence; project-scope workflow saves target the closest existing .claude/workflows/.
    • ›Auto mode now evaluates subagent spawns through the classifier before launch, preventing a subagent from requesting a blocked action without review.
    • ›Improves /doctor with a consistent flat tree layout, clearer section status icons, and highlighted command names.
    +4 moreshow less

    • ›Improves the skill listing truncation warning to show how many skill descriptions are affected.
    • ›Changes the workflow prompt keyword to a purple shimmer highlight, triggering only on explicit phrases like "run a workflow" or "workflow:" rather than any mention of the word.
    • ›Improves Remote Control error messages: connection failures show a persistent red "/rc failed" footer indicator, and "not yet enabled" errors now explain whether the cause is a gate, check failure, stale entitlement, or org policy.
    • ›/bug now requires a description before submission and no longer uses model-refusal text as the GitHub issue title.
62. v2.1.176 Jun 12, 2026 · issue -068

    Claude Code v2.1.176 adds language-aware session titles, footer link badges, and smarter Bedrock credential caching.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.176 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.176

    • ›Session titles are now generated in the language of the conversation; pin a specific language with the language setting.
    • ›New footerLinksRegexes setting lets you add regex-matched link badges to the footer row via user or managed settings.
63. v2.1.175 Jun 12, 2026 · issue -068

    Claude Code adds enforceAvailableModels managed setting to lock model selection within admin-defined allowlists.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.175 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.175

    └──▷ USE IT
    Lock an enterprise deployment so users can never select a model outside the admin-approved list, even via project or user settings.
    json copy

    {
      "enforceAvailableModels": true,
      "availableModels": ["claude-3-5-sonnet-20241022", "claude-3-haiku-20240307"]
    }

    • ›Adds enforceAvailableModels managed setting that forces the Default model to fall back to the first allowed model when it would otherwise resolve to a disallowed model, and prevents users or projects from widening a managed availableModels list.
64. v2.1.174 Jun 12, 2026 · issue -068

    Claude Code v2.1.174 adds wheel-scroll acceleration control and detailed VS Code usage attribution breakdowns.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.174 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.174

    └──▷ HOW TO FIND IT
    Review where your token spend is going — broken down by subagents, MCP tools, skills, and context size — without leaving VS Code.
    📍In VS Code, open the Claude Code panel, then run /usage to open the Account & usage dialog showing the last 24h or 7d breakdown.
    • ›Adds wheelScrollAccelerationEnabled setting to disable mouse-wheel scroll acceleration in fullscreen mode.
    • ›Adds usage attribution panel in the VS Code Account & usage dialog (/usage) showing cache misses, long context, subagents, and per-skill/agent/plugin/MCP breakdowns over the last 24h or 7d.
65. v2.1.172 Jun 10, 2026 · issue -070

    Claude Code v2.1.172 adds recursive sub-agents (5 levels deep), Bedrock region auto-detection, plugin search, and a new OTEL model attribute.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.172 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.172

    └──▷ TRY IT
    Inspect which AWS region Bedrock is using and where it came from, without needing to set AWS_REGION explicitly.
    copy

    $ /status

    Filter a long marketplace plugin list without scrolling through every entry.
    📍/plugin
    • ›Enables sub-agents to spawn their own sub-agents, up to 5 levels of nesting.
    • ›Amazon Bedrock now auto-detects AWS region from ~/.aws config files following AWS SDK precedence when AWS_REGION is unset; /status shows the region source.
    • ›Adds a search bar inside the /plugin marketplace browser for filtering plugins.
    • ›Adds a model attribute to the claude_code.lines_of_code.count OTEL metric, enabling per-model telemetry breakdowns.
66. v2.1.170 Jun 9, 2026 · issue -071

    Claude Code v2.1.170 adds access to Claude Fable 5, Anthropic's most capable generally available model.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.170 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.170

    • ›Adds access to Claude Fable 5 (Mythos-class model), Anthropic's most capable generally available model.
67. v2.1.169 Jun 8, 2026 · issue -072

    Claude Code v2.1.169 adds --safe-mode, /cd command, and disableBundledSkills for cleaner troubleshooting and session control.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.169 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.169

    └──▷ TRY IT
    Troubleshoot a misbehaving setup by launching Claude Code with all customizations stripped out — no CLAUDE.md, hooks, plugins, or MCP servers.
    copy

    $ claude --safe-mode

    Switch your active session to a different project directory without losing prompt cache continuity.
    copy

    $ /cd ~/projects/other-repo

    List all background agent sessions — including completed ones — with their IDs and states for scripting or monitoring pipelines.
    copy

    $ claude agents --json --all

    • ›Adds --safe-mode flag (and CLAUDE_CODE_SAFE_MODE env var) to launch with all customizations disabled — CLAUDE.md, plugins, skills, hooks, and MCP servers — for clean troubleshooting.
    • ›Adds /cd command to change the working directory mid-session without breaking the prompt cache.
    • ›Adds disableBundledSkills setting and CLAUDE_CODE_DISABLE_BUNDLED_SKILLS env var to hide bundled skills, workflows, and built-in slash commands from the model.
    • ›Adds --all flag to claude agents --json to include completed sessions; also surfaces new id and state fields on each session entry.
    • ›The claude agents --json command now correctly includes blocked and just-dispatched background sessions.
    +5 moreshow less

    • ›Background sessions now preserve --ide, --chrome, --bare, --remote-control, and other flags across retire→wake cycles.
    • ›Remote-managed settings with an invalid entry now apply remaining valid policies and surface the validation error instead of silently dropping the whole payload.
    • ›/workflows command now opens immediately even while a turn is in progress.
    • ›The "CLAUDE.md is too long" warning threshold now scales with the model's context window.
    • ›Adds a tip suggesting claude agents when running multiple concurrent sessions.
68. v2.1.166 Jun 6, 2026 · issue -074

    Claude Code v2.1.166 adds fallback model chains, glob-based tool deny rules, and hardened cross-session security.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.166 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.166

    └──▷ TRY IT
    Run a model that thinks by default without extended thinking to reduce latency and token cost.
    copy

    $ MAX_THINKING_TOKENS=0 claude -p "Analyze this code for vulnerabilities" < main.go

    • ›Adds fallbackModel setting to configure up to three fallback models tried in order when the primary model is overloaded or unavailable; --fallback-model now also applies to interactive sessions.
    • ›Adds glob pattern support in deny rule tool-name position ("*" denies all tools); allow rules reject non-MCP globs, and unknown tool names in deny rules warn at startup.
    • ›Hardens cross-session messaging: messages relayed via SendMessage from other Claude sessions no longer carry user authority — receivers refuse relayed permission requests, and auto mode blocks them.
    • ›Enables disabling thinking on models that think by default via the Claude API using MAX_THINKING_TOKENS=0, --thinking disabled, or the per-model thinking toggle (3P providers unchanged).
    • ›Retries a turn once on the fallback model when the API rejects an unexpected non-retryable error; auth, rate-limit, request-size, and transport errors still surface immediately.
    +2 moreshow less

    • ›claude update now announces the target version before downloading.
    • ›In claude agents, typing a URL into the session list now filters to the session whose first prompt contained it.
69. v2.1.163 Jun 4, 2026 · issue -076

    Claude Code v2.1.163 adds version enforcement settings, /plugin list, hook feedback context, and stdio MCP session IDs.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.163 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.163

    └──▷ USE IT
    Enforce an approved version range across a managed fleet so users on out-of-range builds are blocked at startup.
    json copy

    {
      "requiredMinimumVersion": "2.1.163",
      "requiredMaximumVersion": "2.1.999"
    }

    Audit which plugins are active in the current session — useful after an update or policy change.
    copy

    $ /plugin list --enabled

    Surface stop-hook diagnostics back to Claude (e.g. a linter summary) so it can react without the run being marked as a hook error.
    json copy

    {
      "hookSpecificOutput": {
        "additionalContext": "Linter found 3 warnings in src/main.ts — please review before finishing."
      }
    }

    • ›Adds requiredMinimumVersion and requiredMaximumVersion managed settings to enforce a permitted Claude Code version range, refusing startup if the installed version falls outside it.
    • ›New /plugin list command lists installed plugins, with --enabled/--disabled filters to narrow results.
    • ›Adds a 'c to copy' shortcut in /btw that copies the raw markdown answer to the clipboard, preserving formatting on paste.
    • ›Skills: new \$ escape syntax lets command bodies include a literal $ before a digit.
    • ›stdio MCP servers now receive the same CLAUDE_CODE_SESSION_ID environment variable as hooks and Bash when using --resume.
    +1 moreshow less

    • ›Background agent sessions now update to a new Claude Code version silently in the background, eliminating cold-restart wait times when reopening a session after an update.
70. v2.1.162 Jun 3, 2026 · issue -077

    claude agents gets richer status info, --tools Grep/Glob now works on native builds, and /effort persists as default.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.162 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.162

    └──▷ TRY IT
    Poll agent session status in CI/automation to detect which sessions are blocked waiting for a permission prompt.
    copy

    $ claude agents --json | jq '.[] | select(.waitingFor != null) | {id, waitingFor}'

    Restrict Claude Code to only built-in Grep and Glob search tools on a native build — previously listing these names was silently ignored.
    copy

    $ claude --tools Grep,Glob

    • ›Adds waitingFor field to claude agents --json output, showing what a waiting session is blocked on (e.g. a permission prompt).
    • ›Explicitly listing Grep or Glob in --tools now activates the dedicated embedded search tools on native builds (previously silently ignored).
    • ›The /effort command now confirms when the chosen level will persist as the default for new sessions.
    • ›Clicking a slash command in the autocomplete menu fills it into the prompt instead of running it immediately — press Enter to run.
    • ›Remote Control status is now shown as a persistent footer pill with a session link instead of a one-time startup message.
    +2 moreshow less

    • ›Launch-prompt warnings (deep link/pre-filled prompt) now stay pinned below the input until acted upon instead of scrolling away.
    • ›Background service startup and claude update now wait for endpoint-security scanning of new binaries instead of timing out after 5 seconds.
71. v2.1.161 Jun 2, 2026 · issue -078

    Claude Code v2.1.161 adds OTEL label slicing, smarter agents UI, MCP connector collapsing, and independent parallel tool results.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.161 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.161

    └──▷ TRY IT
    Slice Claude Code usage metrics by team or repo in your OTEL backend without any code changes — just set resource attributes before launching.
    copy

    $ OTEL_RESOURCE_ATTRIBUTES="team=security,repo=infra-scanner" claude <prompt>

    • ›Adds OTEL_RESOURCE_ATTRIBUTES values as labels on metric datapoints, enabling usage metrics to be sliced by custom dimensions like team or repo.
    • ›Shows done/total progress before detail text in claude agents rows when work is fanned out; peek view highlights the longest-running item.
    • ›Collapses never-signed-in claude.ai connectors in /mcp behind a 'Show unused connectors' row to reduce noise.
    • ›Parallel tool calls now return independent results — a failed Bash command no longer cancels sibling calls in the same batch.
72. v2.1.160 Jun 2, 2026 · issue -078

    Claude Code v2.1.160 adds shell-startup write prompts, safer acceptEdits mode, and a grep-satisfies-read shortcut.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.160 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.160

    • ›Adds a confirmation prompt before writing to shell startup files (.zshenv, .zlogin, .bash_login) and ~/.config/git/ to prevent unintended command execution.
    • ›In acceptEdits mode, prompts before writing build-tool config files that grant code execution (.npmrc, .yarnrc*, bunfig.toml, .bazelrc, .pre-commit-config.yaml, .devcontainer/, etc.).
    • ›Single-file grep/egrep/fgrep commands now satisfy the read-before-edit check, eliminating the need for a separate Read step after grepping a file.
    • ›Renames the dynamic-workflow trigger keyword from workflow to ultracode; the keyword is highlighted in violet in the prompt input.
    └──▷ BREAKING ON UPGRADE

    • !The CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE environment variable is removed and is now a no-op.
    • !The dynamic-workflow trigger keyword is renamed from workflow to ultracode; the word workflow no longer triggers a dynamic workflow run.
73. v2.1.157 May 29, 2026 · issue -082

    Claude Code v2.1.157 adds auto-loaded plugins, plugin scaffolding, richer telemetry, and smarter agents dispatch.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.157 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.157

    └──▷ TRY IT
    Bootstrap a new plugin without touching any marketplace — scaffold it locally and it loads automatically on next launch.
    copy

    $ claude plugin init my-recon-tool

    Capture detailed tool parameters (bash commands, MCP/skill names) in OTEL traces for audit or pipeline debugging.
    copy

    $ OTEL_LOG_TOOL_DETAILS=1 claude --print 'Run nmap on 10.0.0.0/24 and summarize open ports'

    • ›Adds automatic loading of plugins from .claude/skills directories — no marketplace required.
    • ›New claude plugin init <name> command scaffolds a new plugin directly into .claude/skills.
    • ›Adds autocomplete for /plugin arguments: subcommands, installed plugin names, and plugins from known marketplaces.
    • ›Honors the agent field in settings.json for dispatched sessions, with --agent <name> to override per-run.
    • ›EnterWorktree can now switch between Claude-managed worktrees mid-session.
    +5 moreshow less

    • ›tool_decision telemetry events now include tool_parameters (bash commands, MCP/skill names) when OTEL_LOG_TOOL_DETAILS=1 is set.
    • ›Claude-managed worktrees are left unlocked after an agent finishes, enabling clean git worktree remove/prune workflows.
    • ›Adds a 'Workflow keyword trigger' setting in /config to prevent the word 'workflow' in a prompt from triggering a dynamic workflow.
    • ›Slash-command autocomplete in the claude agents dispatch input now matches substrings.
    • ›Pressing backspace immediately after a workflow trigger keyword dismisses the workflow request instead of deleting a character.
74. v2.1.154 May 28, 2026 · issue -083

    Claude Code v2.1.154 adds Opus 4.8 with fast mode, dynamic multi-agent workflows, shell background sessions, and smarter plugin discovery.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.154 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.154

    └──▷ TRY IT
    Hand off a large, multi-step research or coding task to a fleet of background agents and check their progress.
    copy

    $ claude
    # Inside the session:
    > Create a workflow to audit every Go package in this repo for security issues
    > /workflows

    Run a long-lived shell process as a detachable background session inside the agents view.
    copy

    $ claude agents
    # Inside agents view:
    ! npm run build:watch

    Run a background shell command directly from the CLI without entering the interactive UI.
    copy

    $ claude --bg --exec 'pytest tests/ -x -q'

    • ›Adds Claude Opus 4.8 as the new default model with /effort xhigh for maximum effort on hard tasks.
    • ›Introduces dynamic workflows: ask Claude to orchestrate work across tens to hundreds of background agents; view runs with /workflows.
    • ›Fast mode on Opus 4.8 now available at 2× the standard rate for 2.5× the speed.
    • ›The lean system prompt is now the default for all models except Haiku, Sonnet, and Opus 4.7 and earlier.
    • ›Reduces unsolicited multiple-choice prompts: Claude now reserves them for decisions it genuinely cannot make itself.
    +10 moreshow less

    • ›claude agents: type ! <command> to run a shell command as a background session you can attach to and detach from; also available as claude --bg --exec '<command>'.
    • ›claude agents: /logout now signs you out instead of routing to a background session.
    • ›The ←← agents view shortcut now works on Bedrock, Vertex, Foundry, and with telemetry disabled.
    • ›Claude in Chrome: choose which connected browser to use via /chrome → "Select browser…" or inline during a browser action with multiple browsers connected.
    • ›Plugins can declare defaultEnabled: false in plugin.json or a marketplace entry; enable them with /plugin or claude plugin enable. Dependencies of enabled plugins are still auto-enabled.
    • ›The /plugin Discover tab now pins contextually relevant plugins with a "suggested for this directory" annotation.
    • ›Streaming tool execution is now always on, including when telemetry is disabled or on Bedrock/Vertex/Foundry (previously behind a feature flag).
    • ›Stdio MCP server subprocesses now receive CLAUDE_CODE_SESSION_ID and CLAUDECODE=1 environment variables.
    • ›claude mcp list/get now show unapproved .mcp.json servers as ⏸ Pending approval when output is piped, instead of auto-approving and connecting.
    • ›Improves auto-mode classifier detection of data exfiltration, particularly bulk transfers of repository contents.
    └──▷ BREAKING ON UPGRADE

    • !CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE is deprecated and will be removed on 06/01; switch to /model claude-opus-4-6[1m] then /fast on to use fast mode on Opus 4.6.
    • !The lean system prompt is now the default for all models except Haiku, Sonnet, and Opus 4.7 and earlier, which may change Claude's behavior on upgrade for affected model users.
    • !/simplify no longer runs the full /code-review --fix bug-hunting review; it now performs a cleanup-only pass.
75. v2.1.153 May 28, 2026 · issue -083

    Claude Code v2.1.153 adds LFS-skip for marketplace sources, richer agent autocomplete, terminal-aware status scripts, and persistent macOS permissions.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.153 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.153

    └──▷ USE IT
    Skip downloading large LFS objects when adding a heavy model or dataset repo as a marketplace source.
    yaml copy

    # In your Claude Code marketplace config:
    github:
      repo: owner/heavy-dataset-repo
      skipLfs: true

    Size a custom status-line script to the actual terminal width without hardcoding column counts.
    copy

    $ # status_line.sh — now receives COLUMNS and LINES automatically
    printf '%*s' "$COLUMNS" '' | tr ' ' '-'

    • ›Adds skipLfs option to github/git plugin marketplace sources to skip Git LFS downloads during clone and update.
    • ›Adds COLUMNS and LINES environment variables to status line commands so scripts can size output to the terminal width.
    • ›Expands claude agents dispatch autocomplete to suggest native slash commands and bundled skills, not just project skills.
    • ›Updates claude agents PR column to display PR #N for a single PR or N PRs for multiple.
    • ›Merges separate 'needs authentication' startup notices for MCP servers and connectors into a single message.
    +3 moreshow less

    • ›macOS background agents now appear as 'Claude Code' in Privacy & Security and retain permission grants across upgrades.
    • ›New /model picker saves your model selection as the default for new sessions; press s to switch for the current session only.
    • ›Moving /bg while Claude is responding now continues the response in the background session instead of dropping it.
    └──▷ BREAKING ON UPGRADE

    • !The modelPicker:setAsDefault keybinding is renamed to modelPicker:thisSessionOnly in keybindings.json; the previous d action is replaced by s.
76. v2.1.152 May 27, 2026 · issue -084

    Claude Code v2.1.152 adds auto-fix code review, hook-driven skill reloading, a MessageDisplay hook, and live thinking indicators.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.152 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.152

    └──▷ TRY IT
    Run a code review and immediately apply all suggestions to your working tree in one step.
    copy

    $ claude /code-review --fix

    Restrict which tools are available when a skill is active — useful for locked-down review or planning skills.
    yaml copy

    # In a skill's frontmatter (e.g., .claude/skills/review.md)
    ---
    disallowed-tools:
      - Bash
      - Edit
    ---

    Reload skills installed by a SessionStart hook without restarting the session.
    copy

    $ claude /reload-skills

    • ›Adds --fix flag to /code-review: automatically applies review findings (reuse, simplification, efficiency suggestions) to the working tree after review; /simplify now invokes /code-review --fix.
    • ›Skills and slash commands can now set disallowed-tools in frontmatter to restrict which tools the model can use while that skill is active.
    • ›Adds /reload-skills command to re-scan skill directories mid-session without restarting.
    • ›SessionStart hooks can now return reloadSkills: true to make newly installed skills available in the same session.
    • ›SessionStart hooks can now set the session title via hookSpecificOutput.sessionTitle on startup and resume.
    +11 moreshow less

    • ›Adds MessageDisplay hook event, enabling hooks to transform or hide assistant message text as it is rendered.
    • ›Adds pluginSuggestionMarketplaces managed setting, allowing admins to allowlist org marketplaces whose plugins may be suggested via context-aware tips.
    • ›claude plugin marketplace remove now accepts --scope user|project|local for symmetry with marketplace add, install, and uninstall.
    • ›Automatically switches to the configured --fallback-model for the rest of the session when the primary model is not found, instead of failing every request.
    • ›Auto mode no longer requires opt-in consent.
    • ›Vim mode: / in NORMAL mode now opens reverse history search (like Ctrl+R), matching bash/zsh vi-mode behavior.
    • ›The /usage breakdown now includes large session files, scanned with a streaming read to keep memory usage flat.
    • ›Thinking summaries in collapsed groups now render as markdown, stay readable for at least 3 seconds, and cap at 10 lines; Ctrl+O shows the full thinking.
    • ›In fullscreen mode, the 'Thinking for Ns' indicator now counts up live while the model thinks and retains its value if interrupted mid-thought.
    • ›Post-response timer now shows 'Waiting for N background agents/workflows to finish' and reports cumulative time once results are processed.
    • ›Adds session entrypoint as an OpenTelemetry metric attribute (app.entrypoint), opt-in via OTEL_METRICS_INCLUDE_ENTRYPOINT=true.
77. v2.1.149 May 22, 2026 · issue -089

    Claude Code v2.1.149 adds per-category usage breakdowns, keyboard-scrollable diffs, GFM task list rendering, and enterprise MCP connector controls.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.149 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.149

    └──▷ TRY IT
    Check which categories (skills, subagents, plugins, MCP servers) are eating into your usage limits before hitting a cap.
    copy

    $ /usage

    Allow all claude.ai cloud MCP connectors in an enterprise managed deployment, alongside your existing managed-mcp.json config.
    json copy

    { "allowAllClaudeAiMcps": true }

    • ›Adds per-category breakdown in /usage showing what's consuming your limits — skills, subagents, plugins, and per-MCP-server cost.
    • ›Enables keyboard scrolling in /diff detail view via arrows, j/k, PgUp/PgDn, Space, and Home/End.
    • ›Renders GFM task list checkboxes (- [ ] todo / - [x] done) in Markdown output instead of plain bullets.
    • ›New enterprise managed setting allowAllClaudeAiMcps loads claude.ai cloud MCP connectors alongside managed-mcp.json.
    • ›Improves /feedback reports to include conversation context from before compaction, aiding triage of issues in long sessions.
78. v2.1.147 May 21, 2026 · issue -090

    Claude Code v2.1.147 adds a new /code-review command with inline GitHub PR comments and pinned background session persistence.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.147 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.147

    └──▷ TRY IT
    Run a high-effort correctness review on your current code and post findings as inline comments on an open GitHub PR.
    copy

    $ /code-review high --comment

    • ›New /code-review command (replaces /simplify) reports correctness bugs at a chosen effort level and can post findings as inline GitHub PR comments via --comment.
    • ›Pinned background sessions (Ctrl+T in claude agents) now stay alive when idle, restart in place to apply updates, and are only shed under memory pressure after non-pinned sessions.
    └──▷ BREAKING ON UPGRADE

    • !The /simplify command is renamed to /code-review and its cleanup-and-fix behavior has been removed; scripts or workflows invoking /simplify will no longer work.
79. v2.1.146 May 21, 2026 · issue -090

    Claude Code v2.1.146 renames /simplify to /code-review with optional effort levels.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.146 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.146

    └──▷ TRY IT
    Run a high-effort code review on your current working changes to catch deeper issues before merging.
    copy

    $ /code-review high

    • ›New /code-review command (replaces /simplify) with an optional effort level parameter (e.g. /code-review high).
    • ›Auto mode now respects AskUserQuestion when the user or a skill explicitly relies on it, enabling interactive flows in automated contexts.
    └──▷ BREAKING ON UPGRADE

    • !The /simplify command has been renamed to /code-review; any scripts, docs, or habits referencing /simplify will need to be updated.
80. v2.1.145 May 19, 2026 · issue -092

    Claude Code v2.1.145 adds JSON agent listing, richer OTEL spans, plugin previews, and mouse support in fullscreen.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.145 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.145

    └──▷ TRY IT
    Pipe live agent session data into a status bar or session picker script.
    copy

    $ claude agents --json | jq '.[] | select(.status == "awaiting_input") | .agent_id'

    • ›New claude agents --json command lists live Claude sessions as JSON for scripting (tmux-resurrect, status bars, session pickers).
    • ›Adds agent_id and parent_agent_id attributes to claude_code.tool OTEL spans, with corrected trace parenting so subagent spans nest under their dispatching Agent tool span.
    • ›Status line JSON input now includes GitHub repo and PR information when detected.
    • ›/plugin Discover and Browse screens now preview a plugin's commands, agents, skills, hooks, and MCP/LSP servers before installation.
    • ›claude agents terminal tab title now shows the awaiting-input count so an alt-tabbed window indicates when an agent needs attention.
    +2 moreshow less

    • ›Slash command and @-mention suggestion list now supports mouse hover and click in fullscreen mode.
    • ›Read tool now returns a truncated first page with a 'PARTIAL view' notice instead of a hard error when a whole-file read exceeds the token limit.
81. v2.1.144 May 19, 2026 · issue -092

    Claude Code v2.1.144 adds /resume for background sessions, elapsed-time notifications, plugin last-updated stamps, and per-session model switching.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.144 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.144

    └──▷ TRY IT
    Switch to a different model mid-session without changing your default, so tomorrow's new sessions still open with your preferred model.
    copy

    $ /model   # then select the desired model; press 'd' to set a new default for future sessions only if wanted

    • ›Adds /resume support for background sessions — sessions started via claude --bg or agent view now appear alongside interactive ones, marked with bg.
    • ›Adds elapsed duration to background subagent completion notifications (e.g. "Agent completed · 3h 2m 5s").
    • ›Plugin browse and discover panes now display when each plugin was last updated.
    • ›/model now changes the model for the current session only; press d in the model picker to set a default for all new sessions.
    • ›Adds claude --bg --name <label> echoing the session name in the post-spawn confirmation message.
    +8 moreshow less

    • ›Adds claude agents Ctrl+R session rename that immediately updates the attached session's banner.
    • ›/doctor now shows an exec-form example when a command hook is missing the command field.
    • ›Skill-listing truncation moved out of startup notifications — full breakdown now available via /doctor.
    • ›Improved SDK/headless MCP startup: pre-wait now overlaps with startup instead of blocking before the first turn (up to 2 s faster with slow MCP servers).
    • ›Improved recovery from rare pre-response stream stalls — now retries streaming once instead of falling back to a slower non-streaming request.
    • ›claude agents / --bg rejection messages now name the specific gate (non-TTY, env var, or setting) instead of a generic message.
    • ›Plugin marketplace add/update now respects the CLAUDE_CODE_PLUGIN_PREFER_HTTPS environment variable.
    • ›/plugin now returns to the Installed list after enabling, disabling, or uninstalling a plugin.
82. v2.1.143 May 15, 2026 · issue -096

    Claude Code v2.1.143 adds plugin dependency enforcement, projected context costs, and richer claude agents session control.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.143 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.143

    └──▷ TRY IT
    Launch the agents dashboard scoped to a specific model, effort level, and MCP config so every dispatched session inherits those defaults.
    copy

    $ claude agents --model claude-opus-4-5 --effort high --mcp-config ./mcp.json

    Allow background sessions to edit the working copy directly when git worktrees are impractical in your repo.
    json copy

    # In settings.json
    { "worktree": { "bgIsolation": "none" } }

    • ›Adds plugin dependency enforcement: claude plugin disable refuses when another enabled plugin depends on the target and shows a copy-pasteable disable-chain hint; claude plugin enable force-enables transitive dependencies.
    • ›Adds projected context cost (per-turn and per-invocation token estimates) to the /plugin marketplace browse pane.
    • ›New worktree.bgIsolation: "none" setting lets background sessions edit the working copy directly without EnterWorktree, for repos where worktrees are impractical.
    • ›PowerShell tool now passes -ExecutionPolicy Bypass by default; opt out with CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1.
    • ›PowerShell tool is now enabled by default on Windows for Bedrock, Vertex, and Foundry users; opt out with CLAUDE_CODE_USE_POWERSHELL_TOOL=0.
    +8 moreshow less

    • ›claude agents now accepts --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, and --dangerously-skip-permissions to configure the dashboard and sessions dispatched from it.
    • ›claude --bg --dangerously-skip-permissions now persists across retire→wake cycles.
    • ›/bg now preserves --mcp-config, --settings, --add-dir, --plugin-dir, and --strict-mcp-config, keeping MCP servers and settings across respawn.
    • ›/bg and ←-detach now preserve --fallback-model, so backgrounded workers degrade gracefully on overload.
    • ›/bg and ←-detach now preserve --allow-dangerously-skip-permissions, keeping bypass-permissions available in the Shift+Tab cycle.
    • ›Background sessions now preserve the model and effort level set after waking from idle.
    • ›Shift+Tab in attached agent sessions now includes auto mode in the permission cycle.
    • ›Background sessions launched from claude agents now honor permissions.defaultMode from settings.json.
    └──▷ BREAKING ON UPGRADE

    • !Worktree cleanup no longer falls back to rm -rf when git worktree remove fails, preventing accidental deletion of gitignored or in-progress files — workflows that relied on that fallback cleanup behavior will need an alternative removal step.
83. v2.1.142 May 14, 2026 · issue -097

    Claude Code v2.1.142 expands claude agents configuration flags and upgrades Fast mode to Opus 4.7 by default.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.142 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.142

    └──▷ TRY IT
    Pin fast mode to Opus 4.6 to keep consistent behavior across a team before adopting the new default.
    copy

    $ CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1 claude --fast

    • ›Adds --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort, and --dangerously-skip-permissions flags to claude agents for fine-grained control over dispatched background sessions.
    • ›Fast mode now defaults to Opus 4.7 (up from 4.6); set CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1 to pin back to 4.6.
    • ›Plugins with a root-level SKILL.md and no skills/ subdirectory are now automatically surfaced as a skill.
    • ›The /plugin details pane and claude plugin details command now display LSP servers provided by a plugin.
    • ›/web-setup now warns before overwriting an existing GitHub App connection.
    └──▷ BREAKING ON UPGRADE

    • !Fast mode now uses Opus 4.7 by default instead of Opus 4.6; workloads sensitive to model changes must set CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1 to preserve previous behavior.
84. v2.1.141 May 13, 2026 · issue -098

    Claude Code v2.1.141 adds terminalSequence hooks, HTTPS plugin cloning, workspace identity scoping, and richer agent/rewind controls.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.141 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.141

    └──▷ TRY IT
    Trigger a desktop notification from a hook after a long-running task completes, without needing a controlling terminal.
    copy

    $ # In your hook script, emit a bell via terminalSequence:
    echo '{"terminalSequence": "\a"}'

    Install a Claude Code plugin in a CI/CD environment that lacks a GitHub SSH key.
    copy

    $ CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 claude plugin install <plugin-name>

    List only agents scoped to the current project directory, filtering out unrelated sessions.
    copy

    $ claude agents --cwd /path/to/project

    • ›Adds terminalSequence field to hook JSON output, enabling hooks to emit desktop notifications, window titles, and bells without a controlling terminal.
    • ›Adds CLAUDE_CODE_PLUGIN_PREFER_HTTPS env var to clone GitHub plugin sources over HTTPS instead of SSH, for environments without a GitHub SSH key.
    • ›Adds ANTHROPIC_WORKSPACE_ID env var for workload identity federation, scoping minted tokens to a specific workspace when a federation rule covers more than one.
    • ›Adds claude agents --cwd <path> to scope the session list to a specific directory.
    • ›Extends /feedback to optionally include sessions from the last 24 hours or 7 days, covering issues that span multiple sessions.
    +5 moreshow less

    • ›Adds 'Summarize up to here' option in the Rewind menu to compress earlier context while keeping recent turns intact.
    • ›Background agents launched via /bg or ←← now preserve the current permission mode instead of reverting to default.
    • ›Auto mode permission dialog now explains when a permissions.ask rule triggered the prompt.
    • ›Spinner now warms to amber after 10 seconds of thinking to signal Claude is still working.
    • ›Improves plugin menu navigation: →/Tab switch tabs, ↑ moves to the tab strip, and tab headers and search box are clickable in fullscreen mode.
85. v2.1.139 May 11, 2026 · issue -100

    Claude Code v2.1.139 adds agent view, /goal command, hook exec form, and subagent OTEL tracing.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.139 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.139

    └──▷ TRY IT
    Review all active and completed Claude Code sessions across projects from a single pane.
    copy

    $ claude agents

    Let Claude autonomously iterate on a task until a specific condition is met, tracking progress live.
    copy

    $ /goal All unit tests pass and coverage is above 80%

    • ›Adds claude agents command (Research Preview): a unified list of all Claude Code sessions — running, blocked, or complete.
    • ›Adds /goal command: set a completion condition and Claude works autonomously across turns until it's met, with a live elapsed/turns/tokens overlay panel.
    • ›Adds /scroll-speed command to tune mouse wheel scroll speed with a live preview.
    • ›Adds claude plugin details <name> to inspect a plugin's component inventory and projected per-session token cost.
    • ›Adds transcript view navigation shortcuts: ? for keyboard shortcuts, {/} to jump between user prompts, v to toggle the shortcut panel.
    +12 moreshow less

    • ›Adds args: string[] field (exec form) to hooks, spawning the command directly without a shell so path placeholders never need quoting.
    • ›Adds continueOnBlock config option for PostToolUse hooks — when true, feeds the hook's rejection reason back to Claude and continues the turn instead of blocking.
    • ›MCP stdio servers now receive CLAUDE_PROJECT_DIR in their environment; plugin configs can reference ${CLAUDE_PROJECT_DIR} in commands.
    • ›Compaction prompt now instructs the model to preserve sensitive user instructions across compaction.
    • ›/mcp Reconnect now picks up .mcp.json edits without a full restart and surfaces the HTTP status and URL on reconnect failure.
    • ›API requests from subagents now carry x-claude-code-agent-id and x-claude-code-parent-agent-id headers; claude_code.llm_request OTEL spans include agent_id and parent_agent_id attributes.
    • ›Remote MCP server reconnect retry on transient failures is now enabled for all users.
    • ›/context all per-skill token estimates now account for the model's tokenizer and display rounded values.
    • ›claude plugin install <name>@<marketplace> now auto-refreshes the marketplace and retries before reporting a plugin as not found.
    • ›/context now shows the providing plugin's name for plugin-sourced skills.
    • ›Remote Control, /schedule, claude.ai MCP connectors, and notification preferences are now disabled when ANTHROPIC_API_KEY / apiKeyHelper / ANTHROPIC_AUTH_TOKEN is set, even if a Claude.ai login also exists.
    • ›[VSCode] Press Cmd/Ctrl+Shift+T to reopen the most recently closed session tab, configurable via claudeCode.enableReopenClosedSessionShortcut.
    └──▷ BREAKING ON UPGRADE

    • !Remote Control, /schedule, claude.ai MCP connectors, and notification preferences are disabled when ANTHROPIC_API_KEY, apiKeyHelper, or ANTHROPIC_AUTH_TOKEN is set — even if a Claude.ai login also exists. Unset the API key to re-enable these features.
86. v2.1.136 May 8, 2026 · issue -103

    Claude Code v2.1.136 adds hard-deny auto mode classifier rules and an OTel survey toggle for enterprises.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.136 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.136

    └──▷ USE IT
    Enforce a hard block on a category of auto mode actions that no allow rule or user intent can override.
    json copy

    {
      "autoMode": {
        "hard_deny": ["delete_files", "network_requests"]
      }
    }

    Re-enable the session quality survey when your enterprise pipelines session telemetry through OpenTelemetry.
    copy

    $ CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL=1 claude

    • ›Adds CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL env var to re-enable the session quality survey for enterprises capturing responses via OpenTelemetry.
    • ›Adds settings.autoMode.hard_deny for auto mode classifier rules that block requests unconditionally, regardless of user intent or allow exceptions.
    • ›WSL2: image paste from Windows clipboard now works via a PowerShell fallback when xclip/wl-paste cannot read image data.
87. v2.1.133 May 7, 2026 · issue -104

    Claude Code v2.1.133 adds worktree base-ref control, custom sandbox binary paths, admin policy merge, and effort-level hook inputs.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.133 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.133

    └──▷ TRY IT
    Read the active effort level inside a hook script to adjust external tooling (e.g. skip heavy analysis on low-effort runs).
    copy

    $ #!/bin/bash
    # In a Claude hook script
    echo "Current effort: $CLAUDE_EFFORT"
    if [ "$CLAUDE_EFFORT" = "low" ]; then
      exit 0  # skip expensive checks
    fi

    • ›Adds worktree.baseRef setting (fresh | head) to control whether new worktrees branch from origin/<default> or local HEAD.
    • ›Adds sandbox.bwrapPath and sandbox.socatPath managed settings (Linux/WSL) to specify custom bubblewrap and socat binary locations.
    • ›Adds parentSettingsBehavior admin-tier key ('first-wins' | 'merge') to opt SDK managedSettings into the policy merge chain.
    • ›Hooks now receive the active effort level via the effort.level JSON input field and the $CLAUDE_EFFORT environment variable, readable by Bash tool commands.
    └──▷ BREAKING ON UPGRADE

    • !The default worktree.baseRef is fresh, which changes EnterWorktree's base back to origin/<default>; since v2.1.128 it has been local HEAD. Set worktree.baseRef: "head" to preserve unpushed commits in new worktrees.
88. v2.1.132 May 6, 2026 · issue -105

    Claude Code v2.1.132 adds session ID env var in subprocesses and an opt-out for the fullscreen alternate-screen renderer.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.132 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.132

    └──▷ TRY IT
    Keep Claude Code output in your terminal's native scrollback instead of the fullscreen renderer — useful in tmux, screen, or any workflow where you rely on scroll history.
    copy

    $ CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 claude

    Reference the session ID inside a Bash tool script to tag logs or correlate subprocess events back to the originating Claude Code session.
    copy

    $ echo "Running inside Claude Code session: $CLAUDE_CODE_SESSION_ID" >> /tmp/session-audit.log

    • ›Adds CLAUDE_CODE_SESSION_ID environment variable to Bash tool subprocess environments, matching the session_id passed to hooks — enabling scripts and hooks to correlate subprocess activity back to the parent session.
    • ›Adds CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 env var to opt out of the fullscreen alternate-screen renderer, keeping conversation output in the terminal's native scrollback.
    • ›Adds a 'Pasting…' footer hint while a Ctrl+V image paste is being read from the clipboard.
89. v2.1.129 May 6, 2026 · issue -105

    Claude Code v2.1.129 adds URL-based plugin loading, auto-update on Homebrew/WinGet, and cross-project history search by default.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.129 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.129

    └──▷ TRY IT
    Load a community or internal plugin directly from a URL without installing it permanently.
    copy

    $ claude --plugin-url https://example.com/my-plugin.zip

    Enable background auto-updates on a Homebrew install so Claude Code silently upgrades and prompts to restart.
    copy

    $ export CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1
    claude

    Force synchronized output when running Claude Code inside Emacs eat or another terminal where auto-detection fails.
    copy

    $ CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 claude

    • ›Adds --plugin-url <url> flag to fetch and load a plugin .zip archive from a URL for the current session.
    • ›Adds CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 env var to force synchronized output on terminals where auto-detection fails (e.g. Emacs eat).
    • ›Adds CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE env var: when set on Homebrew or WinGet installs, Claude Code upgrades itself in the background and prompts to restart.
    • ›Adds CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 env var to opt in to Gateway /v1/models discovery for the /model picker (now opt-in instead of automatic).
    • ›Ctrl+R history picker now searches all prompts across all projects by default; press Ctrl+S to narrow to the current project or session.
    +4 moreshow less

    • ›skillOverrides setting is now functional: off hides a skill from the model and /, user-invocable-only hides from the model only, name-only collapses the description.
    • ›The claude_code.pull_request.count OTel metric now counts PRs/MRs created via MCP tools in addition to shell commands.
    • ›Policy refusal error messages now include the API Request ID to aid support debugging.
    • ›Plugin manifests: themes and monitors should now be declared under "experimental": { ... }; claude plugin validate warns on top-level declarations.
    └──▷ BREAKING ON UPGRADE

    • !Gateway /v1/models model discovery (automatic in v2.1.126–2.1.128) is now opt-in via CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1; setups relying on automatic gateway model discovery will no longer see those models without setting this variable.
90. v2.1.128 May 4, 2026 · issue -107

    Claude Code v2.1.128 adds ZIP plugin support, channels auth expansion, MCP server diagnostics, and smarter /mcp and /color UX.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.128 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.128

    └──▷ TRY IT
    Install a plugin distributed as a ZIP archive without unpacking it first.
    copy

    $ claude --plugin-dir ./my-plugin.zip

    Audit connected MCP servers to spot any that registered zero tools (possible misconfiguration).
    copy

    $ /mcp

    • ›Bare /color with no arguments now picks a random session color.
    • ›Adds tool-count display to /mcp output; servers that connect with zero tools are flagged.
    • ›--plugin-dir now accepts .zip plugin archives in addition to directories.
    • ›--channels now works with console (API key) authentication; console orgs with managed settings must set channelsEnabled: true to enable.
    • ›Updated /model picker collapses duplicate Opus 4.7 entries and labels the current Opus model simply as "Opus".
    +5 moreshow less

    • ›Subprocesses (Bash, hooks, MCP, LSP) no longer inherit OTEL_* environment variables, isolating OTEL-instrumented apps from the CLI's own OTLP endpoint.
    • ›Reconnecting MCP servers now summarize re-announced tools by server prefix instead of flooding the conversation with full tool-name lists.
    • ›SDK hosts now receive a persistent localSettings suggestion for Bash permission prompts, so "Always allow" writes to .claude/settings.local.json.
    • ›Auto mode classifier errors now include a hint (retry, /compact, or run with --debug) when an action cannot be evaluated.
    • ›Headless --output-format stream-json: init.plugin_errors now includes --plugin-dir load failures in addition to dependency demotions.
    └──▷ BREAKING ON UPGRADE

    • !workspace is now a reserved MCP server name — existing servers configured with that name will be skipped with a warning.
    • !Subprocesses (Bash, hooks, MCP, LSP) no longer inherit OTEL_* environment variables; any setup relying on subprocess inheritance of the CLI's OTEL config will stop working.
    • !EnterWorktree now creates the new branch from local HEAD instead of origin/<default-branch>; workflows that depended on the previous behavior of branching from the remote default may behave differently.
91. v2.1.126 May 1, 2026 · issue -110

    Claude Code v2.1.126 adds project purge, gateway model picker, headless OAuth, and richer OTel events.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.126 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.126

    └──▷ TRY IT
    Clean up all Claude Code state for a stale or sensitive project before archiving or handing off a repo — preview what will be deleted first.
    copy

    $ claude project purge /path/to/project --dry-run

    Non-interactively purge all project state (transcripts, tasks, file history, config entry) in a CI or scripted cleanup flow.
    copy

    $ claude project purge /path/to/project -y

    • ›Adds claude project purge [path] command to delete all Claude Code state for a project (transcripts, tasks, file history, config entry) with --dry-run, -y/--yes, -i/--interactive, and --all flags.
    • ›The /model picker now lists models from a gateway's /v1/models endpoint when ANTHROPIC_BASE_URL points at an Anthropic-compatible gateway.
    • ›--dangerously-skip-permissions now bypasses write prompts for .claude/, .git/, .vscode/, shell config files, and other previously-protected paths (catastrophic removal commands still prompt).
    • ›claude auth login now accepts an OAuth code pasted directly into the terminal when the browser callback can't reach localhost (WSL2, SSH, containers).
    • ›The claude_code.skill_activated OpenTelemetry event now fires for user-typed slash commands and carries a new invocation_trigger attribute ("user-slash", "claude-proactive", or "nested-skill").
    +2 moreshow less

    • ›Windows: Claude now treats PowerShell as the primary shell (instead of Bash) when the PowerShell tool is enabled.
    • ›Windows: PowerShell 7 installed via the Microsoft Store, MSI without PATH, or .NET global tool is now detected automatically.
92. v2.1.122 Apr 28, 2026 · issue -113

    Claude Code v2.1.122 adds Bedrock service tier selection, PR-URL session lookup, and new OpenTelemetry events.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.122 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.122

    └──▷ TRY IT
    Route Bedrock API calls to a specific service tier (e.g., priority) for latency-sensitive workloads.
    copy

    $ ANTHROPIC_BEDROCK_SERVICE_TIER=priority claude --model anthropic.claude-opus-4-5

    • ›Adds ANTHROPIC_BEDROCK_SERVICE_TIER env var to select a Bedrock service tier (default, flex, or priority), sent as the X-Amzn-Bedrock-Service-Tier header.
    • ›Pasting a GitHub, GitHub Enterprise, GitLab, or Bitbucket PR URL into the /resume search box now finds the session that created that PR.
    • ›Adds claude_code.at_mention OpenTelemetry log event for @-mention resolution.
    • ›OpenTelemetry numeric attributes on api_request/api_error log events are now emitted as numbers instead of strings.
    • ›The /mcp view now surfaces claude.ai connectors hidden by a manually-added server with the same URL, with a hint to remove the duplicate.
    └──▷ BREAKING ON UPGRADE

    • !OpenTelemetry consumers parsing numeric attributes on api_request/api_error log events as strings will receive numbers instead — pipelines that treat those fields as strings may need to be updated.
93. v2.1.121 Apr 28, 2026 · issue -113

    Claude Code v2.1.121 adds MCP alwaysLoad, plugin pruning, PostToolUse output replacement, mTLS Workload Identity, and expanded OpenTelemetry spans.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.121 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.121

    └──▷ USE IT
    Pin a high-priority MCP server's tools so they are always available without waiting for tool-search deferral — useful for servers you rely on in every session.
    json copy

    # In your MCP server config (e.g. .claude/mcp_settings.json)
    {
      "mcpServers": {
        "my-server": {
          "command": "my-mcp-server",
          "alwaysLoad": true
        }
      }
    }

    Clean up orphaned plugin dependencies after removing plugins, or cascade-remove a plugin and all its unique dependencies in one step.
    copy

    $ # Prune all orphaned dependencies
    claude plugin prune
    
    # Or remove a plugin and cascade its dependencies
    claude plugin uninstall my-plugin --prune

    • ›Adds alwaysLoad option to MCP server config — when true, all tools from that server bypass tool-search deferral and are always available.
    • ›Adds claude plugin prune command to remove orphaned auto-installed plugin dependencies; plugin uninstall --prune cascades removals.
    • ›PostToolUse hooks can now replace tool output for ALL tools via hookSpecificOutput.updatedToolOutput, not just MCP tools.
    • ›Adds type-to-filter search box to /skills for quickly finding skills in long lists.
    • ›Vertex AI: supports X.509 certificate-based Workload Identity Federation (mTLS ADC).
    +11 moreshow less

    • ›OpenTelemetry spans now include stop_reason, gen_ai.response.finish_reasons, and user_system_prompt (gated behind OTEL_LOG_USER_PROMPTS) on LLM request spans.
    • ›SDK: mcp_authenticate now supports redirectUri for custom scheme completion and claude.ai connectors.
    • ›Enables CLAUDE_CODE_FORK_SUBAGENT=1 in non-interactive sessions for SDK and claude -p.
    • ›--dangerously-skip-permissions no longer prompts for writes to .claude/skills/, .claude/agents/, and .claude/commands/.
    • ›MCP servers that hit a transient error at startup now auto-retry up to 3 times instead of staying disconnected.
    • ›Terminal tab session title is now generated in the configured language setting.
    • ›LSP diagnostic summaries now expand on click or Ctrl+O and show an expand hint.
    • ›Scrollable overflow dialogs: terminal dialogs that exceed terminal height are now navigable with arrow keys, PgUp/PgDn, Home/End, and mouse wheel in both fullscreen and non-fullscreen modes.
    • ›Clicking any line of a long URL wrapped across rows in fullscreen mode now opens the full URL.
    • ›[VSCode] Voice dictation now respects the accessibility.voice.speechLanguage setting when no Claude Code language is configured.
    • ›[VSCode] /context now opens a native token usage dialog.
94. v2.1.119 Apr 23, 2026 · issue -118

    Claude Code v2.1.119 adds GitLab/Bitbucket PR support, persistent config, richer hooks, and OpenTelemetry improvements.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.119 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.119

    └──▷ TRY IT
    Load a GitLab MR or Bitbucket PR directly into a Claude Code session for review or agentic work, without converting the URL to GitHub format.
    copy

    $ claude --from-pr https://gitlab.com/myorg/myrepo/-/merge_requests/42

    Hide the working directory from the startup logo when running Claude Code in shared or recorded terminal sessions.
    copy

    $ CLAUDE_CODE_HIDE_CWD=1 claude

    • ›Adds prUrlTemplate setting to point the footer PR badge at a custom code-review URL instead of github.com.
    • ›Adds CLAUDE_CODE_HIDE_CWD environment variable to hide the working directory in the startup logo.
    • ›--from-pr now accepts GitLab merge-request, Bitbucket pull-request, and GitHub Enterprise PR URLs in addition to github.com.
    • ›/config settings (theme, editor mode, verbose, etc.) now persist to ~/.claude/settings.json and participate in project/local/policy override precedence.
    • ›--print mode now honors the agent's tools: and disallowedTools: frontmatter, matching interactive-mode behavior.
    +11 moreshow less

    • ›--agent <name> now honors the agent definition's permissionMode for built-in agents.
    • ›PowerShell tool commands can now be auto-approved in permission mode, matching Bash behavior.
    • ›PostToolUse and PostToolUseFailure hook inputs now include duration_ms (tool execution time, excluding permission prompts and PreToolUse hooks).
    • ›Subagent and SDK MCP server reconfiguration now connects servers in parallel instead of serially, reducing startup latency.
    • ›Plugins pinned by another plugin's version constraint now auto-update to the highest satisfying git tag.
    • ›OpenTelemetry tool_result and tool_decision events now include tool_use_id; tool_result also includes tool_input_size_bytes.
    • ›Status line stdin JSON now includes effort.level and thinking.enabled fields.
    • ›Tool search on Vertex AI is now opt-in via ENABLE_TOOL_SEARCH environment variable.
    • ›Slash command suggestions now highlight the characters that matched your query.
    • ›Slash command picker now wraps long descriptions onto a second line instead of truncating.
    • ›owner/repo#N shorthand links in output now use your git remote's host instead of always pointing at github.com.
    └──▷ BREAKING ON UPGRADE

    • !Tool search is now disabled by default on Vertex AI; opt in by setting ENABLE_TOOL_SEARCH to restore the previous behavior.
95. v2.1.118 Apr 23, 2026 · issue -118

    Claude Code v2.1.118 adds vim visual mode, custom themes, MCP tool hooks, and a new /usage command.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.118 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.118

    └──▷ TRY IT
    Block all updates in a locked-down enterprise environment where even manual claude update must be prohibited.
    copy

    $ DISABLE_UPDATES=1 claude

    Allow a hook to call an MCP tool directly — e.g., log an event to a custom MCP server after every agent stop.
    json copy

    {
      "type": "mcp_tool",
      "server": "my-mcp-server",
      "tool": "log_event",
      "params": { "event": "agent_stop" }
    }

    Tag a plugin release with version validation before publishing.
    copy

    $ claude plugin tag v1.2.0

    • ›Adds vim visual mode (v) and visual-line mode (V) with selection, operators, and visual feedback in the editor.
    • ›Merges /cost and /stats into a unified /usage command with tabs; old names remain as shortcuts.
    • ›Introduces custom named themes: create/switch via /theme or hand-edit JSON in ~/.claude/themes/; plugins can ship themes via a themes/ directory.
    • ›Hooks can now invoke MCP tools directly using type: "mcp_tool".
    • ›New DISABLE_UPDATES env var completely blocks all update paths including manual claude update, stricter than DISABLE_AUTOUPDATER.
    +8 moreshow less

    • ›WSL on Windows can now inherit Windows-side managed settings via the wslInheritsWindowsSettings policy key.
    • ›Auto mode: include "$defaults" in autoMode.allow, autoMode.soft_deny, or autoMode.environment to extend the built-in rule list instead of replacing it.
    • ›Adds a 'Don't ask again' option to the auto mode opt-in prompt.
    • ›New claude plugin tag subcommand creates release git tags for plugins with version validation.
    • ›--continue/--resume now find sessions that added the current directory via /add-dir.
    • ›/color now syncs the session accent color to claude.ai/code when Remote Control is connected.
    • ›The /model picker honors ANTHROPIC_DEFAULT_*_MODEL_NAME/_DESCRIPTION overrides when using a custom ANTHROPIC_BASE_URL gateway.
    • ›Plugin version-constraint skips during auto-update are now surfaced in /doctor and the /plugin Errors tab.
96. v2.1.117 Apr 22, 2026 · issue -119

    Claude Code v2.1.117 adds fork-subagent support, richer OpenTelemetry attributes, and faster native search via embedded bfs/ugrep.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.117 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.117

    └──▷ TRY IT
    Surface custom/MCP slash-command names in OpenTelemetry traces for full audit visibility (they are redacted by default).
    copy

    $ OTEL_LOG_TOOL_DETAILS=1 claude

    • ›Enables forked subagents on external builds via CLAUDE_CODE_FORK_SUBAGENT=1.
    • ›Loads agent frontmatter mcpServers for main-thread agent sessions launched with --agent.
    • ›Persists /model selections across restarts even when a project pins a different model; startup header now indicates when the active model is from a project or managed-settings pin.
    • ›Adds summarization offer in /resume for stale, large sessions before re-reading them.
    • ›Concurrent MCP server connections now default when both local and claude.ai servers are configured, reducing startup time.
    +9 moreshow less

    • ›plugin install on an already-installed plugin now installs any missing dependencies instead of stopping.
    • ›Adds claude plugin marketplace add auto-resolution of missing dependencies from configured marketplaces; dependency errors now include an install hint.
    • ›Enforces managed-settings blockedMarketplaces and strictKnownMarketplaces on plugin install, update, refresh, and autoupdate.
    • ›Advisor Tool (experimental) dialog now carries an 'experimental' label, a learn-more link, and a startup notification when enabled.
    • ›Extends cleanupPeriodDays retention sweep to cover ~/.claude/tasks/, ~/.claude/shell-snapshots/, and ~/.claude/backups/.
    • ›OpenTelemetry user_prompt events now include command_name and command_source for slash commands; cost.usage, token.usage, api_request, and api_error now include an effort attribute for models that support effort levels; custom/MCP command names are redacted unless OTEL_LOG_TOOL_DETAILS=1 is set.
    • ›On native macOS and Linux builds, Glob and Grep tools are replaced by embedded bfs and ugrep available through the Bash tool, enabling faster searches without a separate tool round-trip.
    • ›Windows builds now cache where.exe executable lookups per process for faster subprocess launches.
    • ›Default effort for Pro/Max subscribers on Opus 4.6 and Sonnet 4.6 is now high (previously medium).
97. v2.1.116 Apr 20, 2026 · issue -121

    Claude Code v2.1.116 adds faster session resumption, deferred MCP startup, inline thinking progress, and smarter plugin dependency auto-install.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.116 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.116

    └──▷ TRY IT
    After adding a new plugin source, force-reload plugins so missing dependencies are pulled in automatically without manual marketplace steps.
    copy

    $ /reload-plugins

    Configure scroll sensitivity for VS Code, Cursor, or Windsurf so fullscreen sessions scroll smoothly without manual editor tweaks.
    copy

    $ /terminal-setup

    Run a main-thread agent that fires its frontmatter hooks as part of the agent lifecycle.
    copy

    $ claude --agent <path/to/agent.md>

    • ›Speeds up /resume on large sessions by up to 67% on sessions 40 MB and larger, with more efficient handling of dead-fork entries.
    • ›Defers resources/templates/list to first @-mention, reducing MCP startup time when multiple stdio servers are configured.
    • ›Improves fullscreen scrolling in VS Code, Cursor, and Windsurf terminals — /terminal-setup now configures scroll sensitivity for those editors.
    • ›Replaces the separate thinking-hint row with an inline progress indicator ('still thinking', 'thinking more', 'almost done thinking') in the spinner.
    • ›Extends /config search to match option values (e.g. searching 'vim' surfaces the Editor mode setting).
    +7 moreshow less

    • ›Allows /doctor to be opened while Claude is actively responding, without waiting for the current turn to finish.
    • ›Enables /reload-plugins and background plugin auto-update to auto-install missing plugin dependencies from already-added marketplaces.
    • ›Surfaces a rate-limit hint in the Bash tool when gh commands hit GitHub's API rate limit, letting agents back off instead of retrying.
    • ›Shows 5-hour and weekly usage immediately in the Settings Usage tab, with graceful handling when the usage endpoint is rate-limited.
    • ›Fires agent frontmatter hooks: when the agent is run as a main-thread agent via --agent.
    • ›Displays 'No commands match' in the slash command menu when a filter has zero results instead of hiding the menu entirely.
    • ›Security: sandbox auto-allow no longer bypasses the dangerous-path safety check for rm/rmdir targeting /, $HOME, or other critical system directories.
98. v2.1.113 Apr 17, 2026 · issue -124

    Claude Code v2.1.113 adds domain blocklisting, exec-wrapper deny rules, and expanded Remote Control capabilities.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.113 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.113

    └──▷ USE IT
    Block a specific domain (e.g., an exfiltration endpoint) even when a wildcard allowedDomains rule would normally permit it.
    json copy

    # In your Claude Code settings (e.g., .claude/settings.json)
    {
      "sandbox": {
        "network": {
          "allowedDomains": ["*.example.com"],
          "deniedDomains": ["malicious.example.com"]
        }
      }
    }

    • ›New sandbox.network.deniedDomains setting blocks specific domains even when a broader allowedDomains wildcard would otherwise permit them.
    • ›Security: Bash deny rules now match commands wrapped in env/sudo/watch/ionice/setsid and similar exec wrappers, closing bypass paths.
    • ›Security: Bash(find:*) allow rules no longer auto-approve find -exec/-delete, preventing unintended file operations.
    • ›Security: on macOS, /private/{etc,var,tmp,home} paths are treated as dangerous removal targets under Bash(rm:*) allow rules.
    • ›Bash tool now shows the full command in the transcript for multi-line commands whose first line is a comment, closing a UI-spoofing vector.
    +7 moreshow less

    • ›Remote Control (mobile/web) clients can now use /extra-usage and query @-file autocomplete suggestions.
    • ›CLI now spawns a native Claude Code binary via a per-platform optional dependency instead of bundled JavaScript.
    • ›Ctrl+A and Ctrl+E move to the start/end of the current logical line in multiline input, matching readline behavior.
    • ›Windows: Ctrl+Backspace now deletes the previous word.
    • ›Long URLs in responses and bash output stay clickable when they wrap across lines in terminals with OSC 8 hyperlinks.
    • ›Improved /ultrareview: faster launch with parallelized checks, diffstat in the launch dialog, and animated launching state.
    • ›Improved /loop: pressing Esc cancels pending wakeups; wakeups display as 'Claude resuming /loop wakeup' for clarity.
99. v2.1.111 Apr 16, 2026 · issue -125

    Claude Code v2.1.111 adds /ultrareview for cloud-based PR analysis, xhigh effort tier, PowerShell support, and a permission-prompt reducer.

    └──▷ GET THIS VERSION
    copy

    $ git clone --branch v2.1.111 https://github.com/anthropics/claude-code.git
    # already have the repo? check out this version:
    $ git checkout v2.1.111

    └──▷ TRY IT
    Review a specific GitHub PR with multi-agent cloud analysis to get comprehensive feedback before merging.
    copy

    $ /ultrareview 4821

    Reduce permission prompts in a project by auto-generating an allowlist from your session history.
    copy

    $ /less-permission-prompts

    Emit full API request and response bodies as OpenTelemetry log events to trace model calls during debugging.
    copy

    $ OTEL_LOG_RAW_API_BODIES=1 claude --output-format stream-json '<prompt>'

    • ›Adds xhigh effort level for Opus 4.7, sitting between high and max; selectable via /effort, --effort, or the model picker.
    • ›New /ultrareview command runs comprehensive code review in the cloud using parallel multi-agent analysis — no arguments reviews the current branch; /ultrareview <PR#> fetches and reviews a specific GitHub PR.
    • ›New /less-permission-prompts skill scans transcripts for common read-only Bash and MCP tool calls and proposes a prioritized allowlist for .claude/settings.json.
    • ›Auto mode is now available for Max subscribers using Opus 4.7, and no longer requires the --enable-auto-mode flag.
    • ›Adds PowerShell tool support on Windows (progressive rollout); opt in/out with CLAUDE_CODE_USE_POWERSHELL_TOOL; enable on Linux/macOS with CLAUDE_CODE_USE_POWERSHELL_TOOL=1 (requires pwsh on PATH).
    +9 moreshow less

    • ›Adds OTEL_LOG_RAW_API_BODIES environment variable to emit full API request and response bodies as OpenTelemetry log events for debugging.
    • ›New 'Auto (match terminal)' theme option automatically matches the terminal's dark/light mode; selectable via /theme.
    • ›/effort now opens an interactive slider with arrow-key navigation and Enter to confirm when called without arguments.
    • ›Read-only bash commands with glob patterns (e.g. ls *.ts) and commands beginning with cd <project-dir> && no longer trigger a permission prompt.
    • ›/skills menu now supports sorting by estimated token count — press t to toggle.
    • ›Ctrl+L now forces a full screen redraw in addition to clearing the prompt input.
    • ›Transcript view footer now shows [ (dump to scrollback) and v (open in editor) shortcuts.
    • ›Headless --output-format stream-json now includes plugin_errors on the init event when plugins are demoted for unsatisfied dependencies.
    • ›Improved /setup-vertex and /setup-bedrock to show the actual settings.json path when CLAUDE_CONFIG_DIR is set, seed model candidates from existing pins on re-run, and offer a '1M context' option for supported models.
    └──▷ BREAKING ON UPGRADE

    • !Ctrl+U behavior changed: it now clears the entire input buffer instead of deleting only to the start of the line (press Ctrl+Y to restore).
100. v2.1.110 Apr 15, 2026 · issue -126

     Claude Code v2.1.110 adds flicker-free TUI fullscreen, mobile push notifications, and distributed trace linking for SDK sessions.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.110 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.110

     └──▷ TRY IT
     Switch to flicker-free fullscreen rendering mid-conversation without starting a new session.
     copy

     $ /tui fullscreen

     Link a headless Claude Code SDK run into your existing distributed trace for end-to-end observability.
     copy

     $ TRACEPARENT=00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01 TRACESTATE=vendor=value claude --headless --print "summarise logs"

     • ›Adds /tui command and tui setting — run /tui fullscreen to switch to flicker-free rendering within the same conversation.
     • ›Adds /focus command to toggle focus view independently from verbose transcript (previously both were on Ctrl+O).
     • ›Adds push notification tool so Claude can send mobile push notifications when Remote Control and 'Push when Claude decides' config are enabled.
     • ›Adds autoScrollEnabled config to disable conversation auto-scroll in fullscreen mode.
     • ›Adds option to show Claude's last response as commented context in the Ctrl+G external editor, enabled via /config.
     +7 moreshow less

     • ›Improves /plugin Installed tab: items needing attention and favorites float to the top, disabled items collapse behind a fold, and f favorites the selected item.
     • ›Improves /doctor to warn when an MCP server is defined in multiple config scopes with different endpoints.
     • ›--resume/--continue now resurrects unexpired scheduled tasks.
     • ›Enables /autocompact, /context, /exit, and /reload-plugins commands from Remote Control (mobile/web) clients.
     • ›Write tool now informs the model when you edit proposed content in the IDE diff before accepting.
     • ›SDK/headless sessions now read TRACEPARENT/TRACESTATE from the environment for distributed trace linking.
     • ›Session recap is now enabled for users with telemetry disabled (Bedrock, Vertex, Foundry, DISABLE_TELEMETRY); opt out via /config or CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0.
     └──▷ BREAKING ON UPGRADE

     • !Ctrl+O no longer toggles focus view — it now toggles between normal and verbose transcript only; focus view must be toggled with the new /focus command.
101. v2.1.108 Apr 14, 2026 · issue -127

     Claude Code v2.1.108 adds 1-hour prompt cache TTL opt-in, session recap, and slash-command discovery via Skill tool.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.108 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.108

     └──▷ TRY IT
     Opt into the 1-hour prompt cache TTL on Bedrock to cut repeated-context costs across long sessions.
     copy

     $ ENABLE_PROMPT_CACHING_1H=1 claude

     Re-orient yourself after stepping away from a long session without scrolling through the full transcript.
     copy

     $ /recap

     Resume work in the current repo — the picker now defaults to sessions from this directory; switch to all projects if needed.
     copy

     $ /resume   # Ctrl+A to expand to all projects

     • ›Adds ENABLE_PROMPT_CACHING_1H env var to opt into 1-hour prompt cache TTL across API key, Bedrock, Vertex, and Foundry backends; FORCE_PROMPT_CACHING_5M forces the 5-minute TTL.
     • ›Adds /recap command (and CLAUDE_CODE_ENABLE_AWAY_SUMMARY env var) to generate a context summary when returning to a session; also configurable via /config.
     • ›Enables the model to discover and invoke built-in slash commands (/init, /review, /security-review) via the Skill tool.
     • ›Adds /undo as an alias for /rewind.
     • ›Adds a warning at startup when prompt caching is disabled via DISABLE_PROMPT_CACHING* environment variables.
     +5 moreshow less

     • ›Adds a 'verbose' indicator when viewing the detailed transcript via Ctrl+O.
     • ›Improves /resume picker to default to sessions from the current directory; Ctrl+A reveals all projects.
     • ›Improves /model to warn before switching models mid-conversation to flag the uncached full-history re-read cost.
     • ›Improves error messages: rate limits distinguished from plan usage limits; 5xx/529 errors link to status.claude.com; unknown slash commands suggest the closest match.
     • ›Reduces memory footprint for file reads, edits, and syntax highlighting by loading language grammars on demand.
     └──▷ BREAKING ON UPGRADE

     • !ENABLE_PROMPT_CACHING_1H_BEDROCK is deprecated (still honored) in favor of the unified ENABLE_PROMPT_CACHING_1H env var.
102. v2.1.105 Apr 13, 2026 · issue -128

     Claude Code v2.1.105 adds PreCompact hooks, plugin background monitors, worktree path switching, and a smarter /doctor with auto-fix.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.105 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.105

     └──▷ TRY IT
     Block compaction at a critical point in a long session by returning a structured decision from a PreCompact hook.
     copy

     $ #!/usr/bin/env sh
     # .claude/hooks/pre-compact.sh
     # Exit code 2 tells Claude Code to block compaction
     exit 2

     • ›Adds path parameter to the EnterWorktree tool to switch into an existing worktree of the current repository.
     • ›Adds PreCompact hook support: hooks can block compaction by exiting with code 2 or returning {"decision":"block"}.
     • ›Adds background monitor support for plugins via a top-level monitors manifest key that auto-arms at session start or on skill invoke.
     • ›Adds /proactive as an alias for /loop.
     • ›Improves /doctor layout with status icons and adds f keypress to have Claude automatically fix reported issues.
     +3 moreshow less

     • ›Raises plugin skill description listing cap from 250 to 1,536 characters, with a startup warning when descriptions are truncated.
     • ›Improves WebFetch to strip <style> and <script> contents from fetched pages, preventing CSS-heavy pages from exhausting the content budget.
     • ›Improves MCP large-output truncation prompt with format-specific recipes (e.g. jq for JSON, computed Read chunk sizes for text).
103. v2.1.101 Apr 10, 2026 · issue -131

     Claude Code v2.1.101 adds /team-onboarding, OS CA store trust by default, and auto-create cloud environments for /ultraplan.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.101 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.101

     └──▷ TRY IT
     Generate a ramp-up guide for a new teammate joining your project, based on your existing Claude Code usage patterns.
     copy

     $ /team-onboarding

     Resume a named session by its human-readable title (set via /rename) rather than an opaque session ID.
     copy

     $ claude -p --resume my-project-audit

     Restrict TLS trust to bundled CAs only, opting out of the new OS CA store default (e.g., in locked-down environments where OS trust anchors should not be used).
     copy

     $ CLAUDE_CODE_CERT_STORE=bundled claude

     • ›Adds /team-onboarding command to generate a teammate ramp-up guide from your local Claude Code usage.
     • ›Trusts OS CA certificate store by default, enabling enterprise TLS proxies without extra configuration (set CLAUDE_CODE_CERT_STORE=bundled to restrict to bundled CAs only).
     • ›Enables /ultraplan and other remote-session features to auto-create a default cloud environment, removing the requirement to complete web setup first.
     • ›Beta tracing now honors OTEL_LOG_USER_PROMPTS, OTEL_LOG_TOOL_DETAILS, and OTEL_LOG_TOOL_CONTENT; sensitive span attributes are opt-in only.
     • ›claude -p --resume <name> now accepts session titles set via /rename or --name.
     +5 moreshow less

     • ›Rate-limit retry messages now show which limit was hit and when it resets.
     • ›Refusal error messages now include the API-provided explanation when available.
     • ›Tool-not-available errors now explain why the tool is unavailable and how to proceed.
     • ›/plugin and claude plugin update now warn when the marketplace could not be refreshed instead of silently showing stale versions.
     • ›SDK query() now cleans up subprocesses and temp files when consumers break from for await or use await using.
     └──▷ BREAKING ON UPGRADE

     • !OS CA certificate store is now trusted by default; set CLAUDE_CODE_CERT_STORE=bundled to revert to bundled CAs only.
104. v2.1.98 Apr 9, 2026 · issue -132

     Claude Code v2.1.98 adds Vertex AI setup wizard, Perforce mode, subprocess sandboxing, and a new Monitor tool for background scripts.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.98 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.98

     └──▷ TRY IT
     Protect read-only Perforce-managed files so writes fail loudly with a p4 edit hint instead of silently overwriting them.
     copy

     $ CLAUDE_CODE_PERFORCE_MODE=1 claude

     Sandbox background script subprocesses with PID namespace isolation and cap the number of script invocations per session.
     copy

     $ CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 CLAUDE_CODE_SCRIPT_CAPS=10 claude

     Print the current prompt in a cache-friendly form that strips dynamic sections, useful for sharing stable prompt hashes across users in CI.
     copy

     $ claude --print --exclude-dynamic-system-prompt-sections

     • ›Adds interactive Google Vertex AI setup wizard from the login screen under '3rd-party platform', guiding through GCP auth, project/region config, credential verification, and model pinning.
     • ›New CLAUDE_CODE_PERFORCE_MODE env var: Edit/Write/NotebookEdit fail on read-only files with a p4 edit hint instead of silently overwriting them.
     • ›New Monitor tool for streaming events from background scripts.
     • ›Adds subprocess sandboxing with PID namespace isolation on Linux when CLAUDE_CODE_SUBPROCESS_ENV_SCRUB is set; new CLAUDE_CODE_SCRIPT_CAPS env var limits per-session script invocations.
     • ›New --exclude-dynamic-system-prompt-sections flag for print mode to improve cross-user prompt caching.
     +8 moreshow less

     • ›Adds workspace.git_worktree to status line JSON input, set when the current directory is inside a linked git worktree.
     • ›Propagates W3C TRACEPARENT env var to Bash tool subprocesses when OTEL tracing is enabled, correctly parenting child-process spans in the trace tree.
     • ›LSP: Claude Code now identifies itself to language servers via clientInfo in the initialize request.
     • ›Improved /agents with a tabbed layout: Running tab shows live subagents; Library tab adds Run agent and View running instance actions.
     • ›Improved /reload-plugins to pick up plugin-provided skills without requiring a restart.
     • ›Improved Vim mode: j/k in NORMAL mode now navigate history and select the footer pill at the input boundary.
     • ›Improved OTEL tracing: interaction spans now correctly wrap full turns under concurrent SDK calls, and headless turns end spans per-turn.
     • ›Updated /claude-api skill to cover Managed Agents alongside Claude API.
105. v2.1.97 Apr 8, 2026 · issue -133

     Claude Code v2.1.97 adds focus view toggle, refreshable status lines, git worktree context, live subagent indicators, and Cedar policy syntax highlighting.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.97 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.97

     └──▷ USE IT
     Keep a live clock or custom metric in the status line without restarting — useful for monitoring session-level stats in long-running agentic runs.
     json copy

     # In settings.json
     {
       "statusLine": {
         "command": "date '+%H:%M:%S'",
         "refreshInterval": 5
       }
     }

     Distinguish which git worktree a subagent is operating in from a shared status-line script — lets you label the session card with the worktree path.
     python copy

     # Example status-line script that reads workspace.git_worktree from stdin
     import sys, json
     data = json.load(sys.stdin)
     worktree = data.get("workspace", {}).get("git_worktree", "")
     print(f"worktree: {worktree}" if worktree else "main worktree")

     Toggle focus view during a long tool-heavy session to see just the prompt, a compact tool summary, and the final response without visual noise.
     copy

     $ # While Claude Code is running in NO_FLICKER mode, press:
     Ctrl+O

     • ›Adds focus view toggle (Ctrl+O) in NO_FLICKER mode showing prompt, one-line tool summary with edit diffstats, and final response
     • ›Adds refreshInterval status line setting to re-run the status line command every N seconds
     • ›Adds workspace.git_worktree field to status line JSON input, populated when inside a linked git worktree
     • ›Adds ● N running indicator in /agents next to agent types with live subagent instances
     • ›Adds syntax highlighting for Cedar policy files (.cedar, .cedarpolicy)
     +8 moreshow less

     • ›Accept Edits mode now auto-approves filesystem commands prefixed with safe env vars or process wrappers (e.g. LANG=C rm foo, timeout 5 mkdir out)
     • ›Auto mode and bypass-permissions mode now auto-approve sandbox network access prompts
     • ›sandbox.network.allowMachLookup now takes effect on macOS
     • ›Pasted and attached images are now compressed to the same token budget as images read via the Read tool
     • ›Slash command and @-mention completion now triggers after CJK sentence punctuation, enabling Japanese/Chinese input without a leading space
     • ›Bridge sessions now display the local git repo, branch, and working directory on the claude.ai session card
     • ›Bash tool OTEL tracing now injects a W3C TRACEPARENT env var into subprocesses when tracing is enabled
     • ›Updated /claude-api skill to cover Managed Agents alongside the Claude API
106. v2.1.94 Apr 7, 2026 · issue -134

     Claude Code v2.1.94 adds Mantle-powered Bedrock support, raises default effort to high, and expands hook/plugin capabilities.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.94 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.94

     └──▷ TRY IT
     Route Claude Code through Amazon Bedrock powered by Mantle instead of the default endpoint.
     copy

     $ CLAUDE_CODE_USE_MANTLE=1 claude

     Set a custom session title from a UserPromptSubmit hook by returning hookSpecificOutput.sessionTitle.
     json copy

     {
       "hookSpecificOutput": {
         "sessionTitle": "Incident triage — 2025-07-01"
       }
     }

     • ›Adds Amazon Bedrock powered by Mantle support via CLAUDE_CODE_USE_MANTLE=1.
     • ›Raises default effort level from medium to high for API-key, Bedrock/Vertex/Foundry, Team, and Enterprise users (adjustable with /effort).
     • ›Adds compact Slacked #channel header with a clickable channel link for Slack MCP send-message tool calls.
     • ›Adds keep-coding-instructions frontmatter field support for plugin output styles.
     • ›Adds hookSpecificOutput.sessionTitle to UserPromptSubmit hooks for setting the session title programmatically.
     +3 moreshow less

     • ›Plugin skills declared via "skills": ["./"] now use the skill frontmatter name as the invocation name instead of the directory basename, providing a stable name across install methods.
     • ›Improves --resume to resume sessions from other worktrees of the same repo directly instead of printing a cd command.
     • ›[VSCode] Adds a warning banner when settings.json files fail to parse so users know their permission rules are not being applied.
107. v2.1.92 Apr 4, 2026 · issue -137

     Claude Code v2.1.92 adds fail-closed remote policy enforcement, an interactive Bedrock setup wizard, and richer cost breakdowns.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.92 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.92

     └──▷ TRY IT
     Name a Remote Control session with your own prefix so it's identifiable across machines in a shared team environment.
     copy

     $ claude --remote-control-session-name-prefix my-team

     • ›Adds forceRemoteSettingsRefresh policy setting that blocks CLI startup until remote managed settings are freshly fetched and exits on fetch failure (fail-closed).
     • ›Adds an interactive Bedrock setup wizard from the login screen ('3rd-party platform') guiding AWS auth, region config, credential verification, and model pinning.
     • ›Adds per-model and cache-hit cost breakdown to the /cost command for subscription users.
     • ›Upgrades /release-notes to an interactive version picker.
     • ›Remote Control session names now default to your hostname as prefix (e.g. myhost-graceful-unicorn), overridable with --remote-control-session-name-prefix.
     +2 moreshow less

     • ›Pro users see a footer hint when returning to a session after prompt cache expiry, showing estimated uncached tokens for the next turn.
     • ›Write tool diff computation is 60% faster on large files containing tabs, &, or $.
     └──▷ BREAKING ON UPGRADE

     • !The /tag command has been removed.
     • !The /vim command has been removed; vim mode must now be toggled via /config → Editor mode.
108. v2.1.91 Apr 2, 2026 · issue -139

     Claude Code v2.1.91 adds MCP large-result passthrough, plugin executables, and multi-line deep link support.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.91 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.91

     └──▷ USE IT
     Pass a large DB schema or other oversized MCP tool result through without truncation by annotating the result metadata.
     json copy

     { "_meta": { "anthropic/maxResultSizeChars": 500000 }, "content": "<full schema here>" }

     Open Claude Code from a browser or launcher with a multi-line prompt pre-filled — useful for scripted handoffs or automation.
     copy

     $ open 'claude-cli://open?q=Summarize%20this%20file%0AHere%20is%20the%20context'

     Lock down a shared or CI environment so plugin and slash commands cannot execute inline shell code.
     json copy

     # In your Claude Code settings.json
     { "disableSkillShellExecution": true }

     • ›Adds MCP tool result persistence override via _meta["anthropic/maxResultSizeChars"] annotation (up to 500K), allowing large results like DB schemas to pass through without truncation.
     • ›New disableSkillShellExecution setting to disable inline shell execution in skills, custom slash commands, and plugin commands.
     • ›Supports multi-line prompts in claude-cli://open?q= deep links — encoded newlines (%0A) are no longer rejected.
     • ›Plugins can now ship executables under bin/ and invoke them as bare commands from the Bash tool.
109. v2.1.90 Apr 1, 2026 · issue -140

     Claude Code v2.1.90 adds /powerup interactive lessons, offline plugin cache control, and faster /resume loading.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.90 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.90

     └──▷ TRY IT
     Launch interactive feature lessons to onboard yourself or a teammate to Claude Code capabilities.
     copy

     $ /powerup

     Keep plugin marketplace working in an offline or network-restricted environment where git pull fails.
     copy

     $ CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1 claude

     • ›Adds /powerup command: interactive lessons teaching Claude Code features with animated demos.
     • ›Adds CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE env var to preserve the existing marketplace cache when git pull fails, enabling plugin use in offline or air-gapped environments.
     • ›Adds .husky to the list of protected directories in acceptEdits mode.
     • ›Improves /resume all-projects view to load project sessions in parallel, reducing wait times for users with many projects.
     • ›Changes --resume picker to hide sessions created by claude -p or SDK invocations, keeping the list focused on interactive sessions.
     +1 moreshow less

     • ›Removes Get-DnsClientCache and ipconfig /displaydns from the auto-allow list to protect DNS cache privacy.
     └──▷ BREAKING ON UPGRADE

     • !Get-DnsClientCache and ipconfig /displaydns are no longer auto-allowed; setups or scripts that relied on these commands running without a permission prompt will now require explicit approval.
110. v2.1.89 Apr 1, 2026 · issue -140

     Claude Code v2.1.89 adds deferred-permission hooks, flicker-free rendering, PermissionDenied hook, and faster MCP connections in headless mode.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.89 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.89

     └──▷ TRY IT
     Pause a headless session at a sensitive tool call and let a hook re-evaluate before proceeding — useful for human-in-the-loop approval pipelines.
     copy

     $ claude -p --resume <session-id>

     Speed up CI/automation runs by skipping MCP server wait entirely and capping individual server connect time at 5 s.
     copy

     $ MCP_CONNECTION_NONBLOCKING=true claude -p --mcp-config mcp.json '<prompt>'

     Eliminate terminal flicker in long streaming sessions or when running inside a multiplexer like tmux.
     copy

     $ CLAUDE_CODE_NO_FLICKER=1 claude

     • ›Adds "defer" permission decision to PreToolUse hooks, letting headless sessions pause at a tool call and resume via -p --resume for hook re-evaluation.
     • ›Adds CLAUDE_CODE_NO_FLICKER=1 environment variable to enable flicker-free alt-screen rendering with virtualized scrollback.
     • ›Adds PermissionDenied hook that fires after auto-mode classifier denials — return {retry: true} to signal the model it can retry the tool call.
     • ›Adds named subagents to @ mention typeahead suggestions.
     • ›Adds MCP_CONNECTION_NONBLOCKING=true for -p mode to skip the MCP connection wait entirely; bounds --mcp-config server connections at 5 s instead of blocking on the slowest server.
     +5 moreshow less

     • ›Auto mode: denied commands now surface a notification and appear in /permissions → Recent tab where you can retry with r.
     • ›Enables Edit to work on files viewed via Bash with sed -n or cat, without requiring a separate Read call first.
     • ›Hook output exceeding 50 K characters is now saved to disk with a file path and preview instead of being injected directly into context.
     • ›/env now applies to PowerShell tool commands (previously only affected Bash).
     • ›Pasting !command into an empty prompt now enters bash mode, matching typed ! behavior.
     └──▷ BREAKING ON UPGRADE

     • !cleanupPeriodDays: 0 in settings.json is now rejected with a validation error (it previously silently disabled transcript persistence).
     • !Thinking summaries are no longer generated by default in interactive sessions — existing workflows that relied on them must set showThinkingSummaries: true in settings.json.
111. v2.1.86 Mar 27, 2026 · issue -145

     Claude Code v2.1.86 adds session-ID headers for proxy aggregation and expands VCS exclusions to Jujutsu and Sapling.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.86 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.86

     └──▷ TRY IT
     Filter and group Claude Code traffic in a reverse proxy or SIEM by session without decoding request bodies.
     copy

     $ # In your proxy or log pipeline, match on the new header:
     X-Claude-Code-Session-Id: <session-id>

     • ›Adds X-Claude-Code-Session-Id header to all API requests so proxies can correlate and aggregate a session's requests without body inspection.
     • ›Adds .jj and .sl to VCS directory exclusion lists, preventing Grep and file autocomplete from descending into Jujutsu or Sapling metadata directories.
     • ›Read tool now uses a compact line-number format and deduplicates unchanged re-reads, reducing token usage in file-heavy workflows.
     • ›Memory filenames in the 'Saved N memories' notice now highlight on hover and are clickable to open the file directly.
     • ›Skill descriptions in the /skills listing are capped at 250 characters to reduce context consumption.
     +5 moreshow less

     • ›/skills menu now sorts alphabetically for easier scanning.
     • ›Auto mode now displays 'unavailable for your plan' when restricted by plan limits instead of the misleading 'temporarily unavailable'.
     • ›Improves prompt cache hit rate for Bedrock, Vertex, and Foundry users by removing dynamic content from tool descriptions.
     • ›Reduces startup event-loop stalls when many claude.ai MCP connectors are configured by extending the macOS keychain cache from 5 s to 30 s.
     • ›Reduces token overhead when mentioning files with @ by no longer JSON-escaping raw string content.
112. v2.1.85 Mar 26, 2026 · issue -146

     Claude Code v2.1.85 adds conditional hook filtering, richer PreToolUse headless flows, and expanded deep-link query support.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.85 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.85

     └──▷ USE IT
     Run a git-related hook only when Bash commands match git *, avoiding overhead for every other tool call.
     json copy

     # In your hooks config (e.g., .claude/settings.json)
     {
       "hooks": {
         "PreToolUse": [
           {
             "if": "Bash(git *)",
             "command": "./scripts/audit-git-command.sh"
           }
         ]
       }
     }

     Allow a headless CI integration to answer tool-permission questions programmatically without interactive prompts.
     json copy

     # PreToolUse hook returns both a permission decision and updated input
     # so AskUserQuestion is satisfied without user interaction
     {
       "permissionDecision": "allow",
       "updatedInput": { "answer": "yes" }
     }

     Enable full tool-parameter logging in OTEL tool_result events for detailed pipeline observability.
     copy

     $ OTEL_LOG_TOOL_DETAILS=1 claude --mcp-config mcp.json 'audit my repo'

     • ›Adds CLAUDE_CODE_MCP_SERVER_NAME and CLAUDE_CODE_MCP_SERVER_URL environment variables to MCP headersHelper scripts, enabling a single helper script to serve multiple MCP servers.
     • ›Adds conditional if field to hooks using permission rule syntax (e.g., Bash(git *)) so hooks only fire for matching tool calls, reducing unnecessary process spawning.
     • ›Adds timestamp markers in transcripts when scheduled tasks (/loop, CronCreate) fire, making it easier to audit timing of automated runs.
     • ›Expands deep link query support (claude-cli://open?q=…) to 5,000 characters, with a 'scroll to review' warning for long pre-filled prompts.
     • ›MCP OAuth now follows RFC 9728 Protected Resource Metadata discovery to locate the authorization server automatically.
     +4 moreshow less

     • ›Organization-policy-blocked plugins (managed-settings.json) are now hidden from marketplace views and cannot be installed or enabled.
     • ›PreToolUse hooks can now satisfy AskUserQuestion by returning updatedInput alongside permissionDecision: "allow", enabling headless integrations to supply answers programmatically.
     • ›Gates tool_parameters in OpenTelemetry tool_result events behind the OTEL_LOG_TOOL_DETAILS=1 environment variable to reduce log verbosity by default.
     • ›Improves PowerShell dangerous command detection coverage.
     └──▷ BREAKING ON UPGRADE

     • !tool_parameters in OpenTelemetry tool_result events are no longer emitted by default; set OTEL_LOG_TOOL_DETAILS=1 to restore them.
113. v2.1.84 Mar 26, 2026 · issue -146

     Claude Code v2.1.84 adds PowerShell tool preview, new hooks, env-var overrides for 3p model capability detection, and MCP deduplication.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.84 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.84

     └──▷ TRY IT
     Override capability detection when using a pinned Bedrock/Vertex/Foundry model that Claude Code doesn't recognize as supporting extended thinking.
     copy

     $ ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTS=thinking claude

     Raise the streaming idle watchdog timeout to 3 minutes for slow-responding enterprise API gateways.
     copy

     $ CLAUDE_STREAM_IDLE_TIMEOUT_MS=180000 claude

     • ›Adds PowerShell tool for Windows as an opt-in preview, enabling native PowerShell execution alongside the existing bash tool.
     • ›Adds ANTHROPIC_DEFAULT_{OPUS,SONNET,HAIKU}_MODEL_SUPPORTS env vars to override effort/thinking capability detection for pinned default models on Bedrock, Vertex, and Foundry; companion _MODEL_NAME/_DESCRIPTION vars customize the /model picker label.
     • ›Adds CLAUDE_STREAM_IDLE_TIMEOUT_MS env var to configure the streaming idle watchdog threshold (default 90 s).
     • ›Adds TaskCreated hook that fires when a task is created via TaskCreate.
     • ›Adds type: "http" support for the WorktreeCreate hook — return the created worktree path via hookSpecificOutput.worktreePath in the response JSON.
     +10 moreshow less

     • ›Adds allowedChannelPlugins managed setting for team/enterprise admins to define a channel plugin allowlist.
     • ›Adds x-client-request-id header to all API requests to aid timeout debugging.
     • ›Adds idle-return prompt that nudges users back after 75+ minutes of inactivity to /clear, reducing unnecessary token re-caching on stale sessions.
     • ›Deep links (claude-cli://) now open in the user's preferred terminal instead of the first terminal found in the detection list.
     • ›Rules and skills paths: frontmatter now accepts a YAML list of globs, not just a single pattern.
     • ›MCP servers configured both locally and via claude.ai connectors are now deduplicated — local config wins.
     • ›Background bash tasks stuck on an interactive prompt now surface a notification after ~45 seconds.
     • ›Global system-prompt caching now works when ToolSearch is enabled, including for users with MCP tools configured.
     • ›[VSCode] Adds a rate-limit warning banner showing usage percentage and reset time.
     • ›Stats screenshot (Ctrl+S in /stats) now works in all builds and renders 16× faster.
114. v2.1.83 Mar 25, 2026 · issue -147

     Claude Code v2.1.83 adds drop-in policy fragments, new hook events, credential scrubbing, transcript search, and agent initialPrompt support.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.83 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.83

     └──▷ TRY IT
     Strip cloud credentials from all subprocesses to prevent accidental credential leakage to spawned tools and MCP servers.
     copy

     $ CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 claude

     Prevent Claude Code from registering the claude-cli:// URL handler on a locked-down or shared workstation.
     json copy

     # In managed-settings.json or a managed-settings.d/ fragment:
     { "disableDeepLinkRegistration": true }

     • ›Adds managed-settings.d/ drop-in directory so separate teams can deploy independent policy fragments that merge alphabetically alongside managed-settings.json.
     • ›Adds CwdChanged and FileChanged hook events for reactive environment management (e.g., direnv integration).
     • ›Adds sandbox.failIfUnavailable setting to exit with an error when sandbox is enabled but cannot start, instead of silently running unsandboxed.
     • ›Adds disableDeepLinkRegistration setting to prevent claude-cli:// protocol handler registration.
     • ›Adds CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 environment variable to strip Anthropic and cloud provider credentials from subprocess environments (Bash tool, hooks, MCP stdio servers).
     +10 moreshow less

     • ›Adds transcript search — press / in transcript mode (Ctrl+O) to search, then n/N to step through matches.
     • ›Adds Ctrl+X Ctrl+E as a readline-native alias for opening the external editor (Ctrl+G still works).
     • ›Pasted images now insert an [Image #N] chip at the cursor for positional referencing in prompts.
     • ›Agents can now declare initialPrompt in frontmatter to auto-submit a first turn.
     • ›chat:killAgents and chat:fastMode keybindings are now rebindable via ~/.claude/keybindings.json.
     • ›/status now works while Claude is responding, instead of being queued until the turn finishes.
     • ›Linux now respects XDG_DATA_HOME when registering the claude-cli:// protocol handler.
     • ›WebFetch now identifies as Claude-User so site operators can recognize and allowlist Claude Code traffic via robots.txt.
     • ›Increased non-streaming fallback token cap from 21k to 64k and timeout from 120s to 300s so fallback requests are less likely to be truncated.
     • ›[VSCode] Spinner now turns red with 'Not responding' when the backend hasn't responded for 60 seconds.
     └──▷ BREAKING ON UPGRADE

     • !The 'stop all background agents' keybinding is changed from Ctrl+F to Ctrl+X Ctrl+K.
     • !TaskOutput tool is deprecated in favor of using Read on the background task's output file path.
115. v2.1.81 Mar 20, 2026 · issue -152

     Claude Code v2.1.81 adds --bare flag for headless scripting and --channels permission relay to mobile devices.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.81 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.81

     └──▷ TRY IT
     Run a fully headless, hook-free scripted prompt in CI where only an API key is available — no OAuth, no plugin overhead.
     copy

     $ claude --bare -p "Summarize the security findings in findings.json" --settings ci-settings.json

     • ›Adds --bare flag for scripted -p calls — skips hooks, LSP, plugin sync, and skill directory walks; requires ANTHROPIC_API_KEY or apiKeyHelper via --settings (OAuth/keychain and auto-memory disabled).
     • ›Adds --channels permission relay so channel servers that declare the permission capability can forward tool-approval prompts to your phone.
     • ›Updates MCP OAuth to support Client ID Metadata Document (CIMD / SEP-991) for servers without Dynamic Client Registration.
     • ›Improves MCP read/search tool calls to collapse into a single 'Queried {server}' line, expandable with Ctrl+O.
     • ›Improves ! bash mode discoverability — Claude now suggests it when you need to run an interactive command.
     +2 moreshow less

     • ›Improves ref-tracked plugin freshness — plugins now re-clone on every load to pick up upstream changes.
     • ›Resuming a session that was in a worktree now automatically switches back to that worktree.
     └──▷ BREAKING ON UPGRADE

     • !Plan mode now hides the 'clear context' option by default; restore it by setting "showClearContextOnPlanAccept": true in settings.
     • !Line-by-line response streaming is disabled on Windows (including WSL in Windows Terminal) due to rendering issues.
116. v2.1.80 Mar 19, 2026 · issue -153

     Claude Code v2.1.80 adds MCP push channels, inline plugin settings, effort frontmatter, and rate-limit statusline fields.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.80 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.80

     └──▷ TRY IT
     Push messages into your session from an MCP server during a long-running workflow — currently in research preview.
     copy

     $ claude --channels

     Set a specific effort level for a skill or slash command so it always runs at the right cost/quality trade-off when invoked.
     yaml copy

     # In your skill or slash-command frontmatter:
     ---
     effort: low
     ---

     • ›Adds rate_limits field to statusline scripts exposing Claude.ai rate-limit usage across 5-hour and 7-day windows, including used_percentage and resets_at.
     • ›Adds source: 'settings' plugin marketplace source so plugin entries can be declared inline in settings.json without a separate marketplace lookup.
     • ›Adds CLI tool usage detection to plugin tips, supplementing existing file-pattern matching for smarter plugin suggestions.
     • ›Adds effort frontmatter key for skills and slash commands to override the model effort level on a per-command basis.
     • ›Adds --channels (research preview) enabling MCP servers to push messages directly into a running session.
117. v2.1.79 Mar 18, 2026 · issue -154

     Claude Code v2.1.79 adds Console auth, turn-duration display, remote-control bridge, and multi-directory plugin seeds.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.79 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.79

     └──▷ TRY IT
     Authenticate with the Anthropic Console (API billing) instead of the default Claude.ai login flow.
     copy

     $ claude auth login --console

     Load plugins from multiple seed directories at once — useful when team-wide and project-local plugins live in separate paths.
     copy

     $ CLAUDE_CODE_PLUGIN_SEED_DIR=/shared/plugins:/project/.claude/plugins claude

     Bridge a running VSCode session to claude.ai/code so you can continue the conversation from a browser or phone.
     copy

     $ /remote-control

     • ›Adds --console flag to claude auth login for Anthropic Console (API billing) authentication.
     • ›Adds 'Show turn duration' toggle to the /config menu to display how long each turn takes.
     • ›Adds CLAUDE_CODE_PLUGIN_SEED_DIR support for multiple seed directories separated by the platform path delimiter (: on Unix, ; on Windows).
     • ›[VSCode] Adds /remote-control command to bridge your session to claude.ai/code for continuation from a browser or phone.
     • ›[VSCode] Session tabs now receive AI-generated titles based on your first message.
118. v2.1.78 Mar 17, 2026 · issue -155

     Claude Code v2.1.78 adds a StopFailure hook, plugin persistent state, and frontmatter-driven agent configuration.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.78 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.78

     └──▷ USE IT
     Trigger a Slack alert or pager when a session dies mid-run due to a rate limit or auth failure.
     json copy

     # In your Claude Code hooks config, add a StopFailure handler:
     {
       "hooks": {
         "StopFailure": "notify-on-error.sh"
       }
     }

     Add a custom internal model (e.g. a fine-tune) to the /model picker so teammates can select it by name.
     copy

     $ export ANTHROPIC_CUSTOM_MODEL_OPTION=my-org/claude-fine-tune-v1
     export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="FineTune v1"
     export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Internal security-tuned variant"
     claude

     Store plugin state across updates so that user preferences or cached data persist after a /plugin upgrade.
     copy

     $ # Inside your plugin script, write persistent data to the provided path:
     echo '{"last_scan": "2025-01-01"}' > "${CLAUDE_PLUGIN_DATA}/state.json"

     • ›New StopFailure hook event fires when a turn ends due to an API error (rate limit, auth failure, etc.), enabling automated error-handling workflows.
     • ›New ${CLAUDE_PLUGIN_DATA} variable provides plugins a persistent state directory that survives plugin updates; /plugin uninstall now prompts before deleting it.
     • ›Plugin-shipped agents can now declare effort, maxTurns, and disallowedTools in frontmatter for per-agent configuration.
     • ›New ANTHROPIC_CUSTOM_MODEL_OPTION env var adds a custom entry to the /model picker, with optional _NAME and _DESCRIPTION suffix vars for display.
     • ›Terminal notifications (iTerm2/Kitty/Ghostty popups, progress bar) now propagate to the outer terminal when Claude Code runs inside tmux with set -g allow-passthrough on.
     +1 moreshow less

     • ›Response text now streams line-by-line as it is generated.
119. v2.1.77 Mar 17, 2026 · issue -155

     Claude Code v2.1.77 raises output token limits to 128k, adds allowRead sandbox setting, and improves /copy, plugins, and agent resumption.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.77 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.77

     └──▷ USE IT
     Re-allow read access to a specific path inside a broader denyRead region for fine-grained sandbox control.
     yaml copy

     # In your Claude Code sandbox config:
     denyRead: ["/home/user"]
     allowRead: ["/home/user/project"]

     Retrieve a specific earlier assistant response — useful when you want to copy a response from several turns ago without scrolling.
     copy

     $ /copy 3

     Validate a plugin's frontmatter and hooks config before publishing to catch schema and YAML errors early.
     copy

     $ claude plugin validate ./my-plugin

     • ›Raises default max output tokens for Claude Opus 4.6 to 64k, and the upper bound for Opus 4.6 and Sonnet 4.6 models to 128k tokens.
     • ›New allowRead sandbox filesystem setting lets you re-allow read access within denyRead regions for fine-grained filesystem control.
     • ›/copy now accepts an optional index — /copy N copies the Nth-latest assistant response.
     • ›Renames /fork to /branch (/fork remains as an alias).
     • ›Background bash tasks are now killed if output exceeds 5 GB, preventing runaway processes from filling disk.
     +8 moreshow less

     • ›Sessions are now auto-named from plan content when you accept a plan.
     • ›Improved claude plugin validate to check skill, agent, and command frontmatter plus hooks/hooks.json, catching YAML parse errors and schema violations.
     • ›Headless mode plugin installation now composes correctly with CLAUDE_CODE_PLUGIN_SEED_DIR.
     • ›Shows a notice when apiKeyHelper takes longer than 10s, preventing it from blocking the main loop.
     • ›Faster startup on macOS (~60 ms) by reading keychain credentials in parallel with module loading.
     • ›Faster --resume on fork-heavy and very large sessions — up to 45% faster loading and ~100–150 MB less peak memory.
     • ›[VSCode] Plan preview tab titles now use the plan's heading instead of 'Claude's Plan'.
     • ›[VSCode] Footer now points to the macOptionClickForcesSelection setting when option+click doesn't trigger native selection on macOS.
     └──▷ BREAKING ON UPGRADE

     • !The Agent tool no longer accepts a resume parameter — use SendMessage({to: agentId}) to continue a previously spawned agent.
120. v2.1.76 Mar 14, 2026 · issue -157

     Claude Code v2.1.76 adds MCP elicitation, new hooks, sparse-checkout worktrees, /effort command, and session naming.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.76 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.76

     └──▷ TRY IT
     Name a session at startup so it's identifiable in Remote Control session lists and logs.
     copy

     $ claude -n "incident-2025-investigation" --worktree

     Load plugins from two separate directories (e.g. company-wide and personal) using the updated --plugin-dir flag.
     copy

     $ claude --plugin-dir /opt/company-plugins --plugin-dir ~/.local/claude-plugins

     • ›Adds MCP elicitation support — MCP servers can now request structured input mid-task via an interactive dialog (form fields or browser URL).
     • ›Adds Elicitation and ElicitationResult hooks to intercept and override MCP elicitation responses before they're sent back.
     • ›Adds -n / --name <name> CLI flag to set a display name for a session at startup.
     • ›Adds worktree.sparsePaths setting for claude --worktree to check out only specified directories via git sparse-checkout in large monorepos.
     • ›Adds PostCompact hook that fires after conversation compaction completes.
     +4 moreshow less

     • ›Adds /effort slash command to set the model effort level interactively.
     • ›Adds session quality survey with configurable sample rate via the feedbackSurveyRate setting for enterprise admins.
     • ›Improves background agent behavior — killing a background agent now preserves its partial results in the conversation context.
     • ›Updates --plugin-dir to support repeated use for multiple directories (one path per flag).
     └──▷ BREAKING ON UPGRADE

     • !--plugin-dir now only accepts one path per flag; use repeated --plugin-dir flags to specify multiple plugin directories.
121. v2.1.74 Mar 12, 2026 · issue -159

     Claude Code v2.1.74 adds actionable /context optimization tips and a configurable auto-memory directory.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.74 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.74

     └──▷ USE IT
     Redirect auto-memory storage to a shared or project-specific path rather than the default location.
     json copy

     # In your Claude Code settings (e.g., settings.json)
     {
       "autoMemoryDirectory": "/home/user/projects/myproject/.claude-memory"
     }

     Spot which tools or memories are eating your context budget and get specific tips to reclaim space before hitting limits.
     copy

     $ /context

     Sideload a local plugin build that overrides a same-named marketplace plugin during development.
     copy

     $ claude --plugin-dir ./my-plugin-dev-copy

     • ›Adds actionable suggestions to the /context command — identifies context-heavy tools, memory bloat, and capacity warnings with specific optimization tips.
     • ›Adds autoMemoryDirectory setting to configure a custom directory for auto-memory storage.
     • ›Changes --plugin-dir so local dev copies now override installed marketplace plugins with the same name (unless force-enabled by managed settings).
122. v2.1.73 Mar 11, 2026 · issue -160

     Claude Code v2.1.73 adds modelOverrides for custom provider model IDs and actionable SSL error guidance for corporate proxy users.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.73 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.73

     └──▷ USE IT
     Route model picker selections to a specific Bedrock inference profile ARN instead of the default model ID.
     json copy

     # In your Claude Code settings (e.g. ~/.claude/settings.json)
     {
       "modelOverrides": {
         "claude-opus-4-5": "arn:aws:bedrock:us-east-1::foundation-model/your-inference-profile-arn"
       }
     }

     • ›Adds modelOverrides setting to map model picker entries to custom provider model IDs (e.g., Bedrock inference profile ARNs).
     • ›Adds actionable guidance when OAuth login or connectivity checks fail due to SSL certificate errors (corporate proxies, NODE_EXTRA_CA_CERTS).
     • ›Updates default Opus model on Bedrock, Vertex, and Microsoft Foundry to Opus 4.6.
     • ›Enables /effort command to work while Claude is responding, matching /model behavior.
     └──▷ BREAKING ON UPGRADE

     • !The /output-style command is deprecated; output style is now fixed at session start for better prompt caching — use /config instead.
123. v2.1.72 Mar 10, 2026 · issue -161

     Claude Code v2.1.72 adds file-write in /copy, /plan descriptions, ExitWorktree tool, cron control, and a VS Code URI handler.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.72 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.72

     └──▷ TRY IT
     Write a focused selection to a file over SSH without relying on clipboard access.
     copy

     $ # In an active Claude Code session, open the copy picker with /copy, highlight the desired block, then press `w` to write it directly to a file.

     Jump straight into plan mode with context so Claude starts immediately rather than waiting for a follow-up prompt.
     copy

     $ claude> /plan fix the auth bug

     Stop all scheduled cron jobs mid-session without restarting Claude Code.
     copy

     $ CLAUDE_CODE_DISABLE_CRON=1 claude

     Open a new Claude Code tab in VS Code programmatically with a pre-filled prompt from an external script or tool.
     copy

     $ open 'vscode://anthropic.claude-code/open?prompt=explain+this+file&session=abc123'

     • ›Adds w key in /copy to write the focused selection directly to a file, bypassing the clipboard — useful over SSH.
     • ›Adds optional description argument to /plan (e.g., /plan fix the auth bug) to enter plan mode and immediately start working.
     • ›Adds ExitWorktree tool to cleanly leave an EnterWorktree session.
     • ›Adds CLAUDE_CODE_DISABLE_CRON environment variable to immediately stop scheduled cron jobs mid-session.
     • ›Adds lsof, pgrep, tput, ss, fd, and fdfind to the bash auto-approval allowlist, reducing permission prompts for common read-only operations.
     +9 moreshow less

     • ›Adds support for marketplace git URLs without a .git suffix (Azure DevOps, AWS CodeCommit).
     • ›Adds claude plugins as an alias for claude plugin.
     • ›Simplifies effort levels to low/medium/high (removed max) with new symbols (○ ◐ ●); adds /effort auto to reset to default.
     • ›Improves /config keyboard UX — Escape cancels changes, Enter saves and closes, Space toggles settings.
     • ›Improves up-arrow history to show the current session's messages first when running multiple concurrent sessions.
     • ›Improves voice input transcription accuracy for repo names and common dev terms (regex, OAuth, JSON).
     • ›Hides CLAUDE.md HTML comments (<!-- ... -->) from Claude when auto-injected; comments remain visible when read with the Read tool.
     • ›VSCode: Adds vscode://anthropic.claude-code/open URI handler to open a new Claude Code tab programmatically, with optional prompt and session query parameters.
     • ›VSCode: Adds effort level indicator on the input border.
     └──▷ BREAKING ON UPGRADE

     • !The CLAUDE_CODE_PROXY_SUPPORTS_TOOL_REFERENCE environment variable has been removed; the tool search proxy bypass is now controlled by a different environment variable.
     • !Effort level max has been removed; valid levels are now low, medium, and high only.
124. v2.1.71 Mar 7, 2026 · issue -164

     Claude Code v2.1.71 adds /loop scheduling, rebindable push-to-talk voice, and expands bash auto-approval allowlist

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.71 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.71

     └──▷ TRY IT
     Continuously poll a deploy status every 5 minutes without manually re-running the prompt — useful for watching long-running CI/CD pipelines.
     copy

     $ /loop 5m check the deploy

     Rebind push-to-talk to a modifier+letter combo that won't interfere with typing, then activate voice hands-free.
     json copy

     // In keybindings.json
     { "voice:pushToTalk": "meta+k" }

     • ›New /loop command runs a prompt or slash command on a recurring interval (e.g. /loop 5m check the deploy)
     • ›Adds cron scheduling tools for recurring prompts within a session
     • ›New voice:pushToTalk keybinding makes the voice activation key rebindable in keybindings.json (default: space); supports modifier+letter combos like meta+k
     • ›Expands bash auto-approval allowlist with fmt, comm, cmp, numfmt, expr, test, printf, getconf, seq, tsort, and pr
     • ›Updates /debug to toggle debug logging on mid-session without requiring a restart
     +2 moreshow less

     • ›Improves /plugin uninstall to disable project-scoped plugins in .claude/settings.local.json instead of .claude/settings.json, keeping changes out of shared teammate config
     • ›Plugin-provided MCP servers that duplicate a manually-configured server (same command/URL) are now automatically skipped, with suppressions shown in the /plugin menu
125. v2.1.70 Mar 6, 2026 · issue -165

     Claude Code v2.1.70 adds VS Code session browser, plan markdown view, and native MCP server management dialog.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.70 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.70

     └──▷ TRY IT
     Manage MCP servers (enable/disable, reconnect, OAuth) directly from the VS Code chat panel without switching to a terminal.
     copy

     $ /mcp

     • ›Adds a spark icon in the VS Code activity bar listing all Claude Code sessions, with sessions opening as full editors.
     • ›Adds a full markdown document view for plans in VS Code, including support for inline comments to provide feedback.
     • ›Adds a native MCP server management dialog via /mcp in the VS Code chat panel — enable/disable servers, reconnect, and manage OAuth authentication without leaving the editor.
126. v2.1.69 Mar 5, 2026 · issue -166

     Claude Code v2.1.69 adds Voice STT in 20 languages, new hook events, plugin hot-reload, and a suite of new settings and CLI options.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.69 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.69

     └──▷ TRY IT
     Strip Claude's default git commit/PR instructions from the system prompt when your team enforces its own commit conventions via a CLAUDE.md rule.
     copy

     $ CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1 claude

     Hot-reload plugins mid-session after editing a SKILL.md or plugin manifest, without restarting Claude Code.
     copy

     $ /reload-plugins

     • ›Adds /claude-api skill for building applications with the Claude API and Anthropic SDK
     • ›Adds Ctrl+U on an empty bash prompt (!) to exit bash mode, matching Escape and Backspace
     • ›Adds numeric keypad support for selecting options in Claude's interview questions
     • ›Adds optional --name argument to /remote-control and claude remote-control to set a custom session title visible in claude.ai/code
     • ›Expands Voice STT support to 20 total languages, adding Russian, Polish, Turkish, Dutch, Ukrainian, Greek, Czech, Danish, Swedish, and Norwegian
     +16 moreshow less

     • ›Adds effort level display (e.g., "with low effort") to the logo and spinner so the active effort setting is always visible
     • ›Adds agent name display in the terminal title when using claude --agent
     • ›Adds sandbox.enableWeakerNetworkIsolation setting (macOS only) to allow Go programs like gh, gcloud, and terraform to verify TLS certificates when using a custom MITM proxy with httpProxyPort
     • ›Adds includeGitInstructions setting and CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS env var to remove built-in commit and PR workflow instructions from Claude's system prompt
     • ›Adds /reload-plugins command to activate pending plugin changes without restarting
     • ›Adds ${CLAUDE_SKILL_DIR} variable so skills can reference their own directory in SKILL.md content
     • ›Adds InstructionsLoaded hook event that fires when CLAUDE.md or .claude/rules/*.md files are loaded into context
     • ›Adds agent_id and agent_type fields to hook events for subagent and --agent sessions
     • ›Adds worktree field to status line hook commands with name, path, branch, and original repo directory in --worktree sessions
     • ›Adds pluginTrustMessage in managed settings to append organization-specific context to the plugin trust warning
     • ›Adds pathPattern to strictKnownMarketplaces for regex-matching file/directory marketplace sources alongside hostPattern restrictions
     • ›Adds plugin source type git-subdir to point to a subdirectory within a git repo
     • ›Adds oauth.authServerMetadataUrl config option for MCP servers to specify a custom OAuth metadata discovery URL when standard discovery fails
     • ›Extends policy limit fetching (e.g., remote control restrictions) to Team plan OAuth users, not just Enterprise
     • ›[VSCode] Adds compaction display as a collapsible "Compacted chat" card with the summary inside
     • ›[VSCode] Permission mode picker now respects permissions.disableBypassPermissionsMode from effective Claude Code settings
127. v2.1.68 Mar 4, 2026 · issue -167

     Claude Code v2.1.68 adds 'ultrathink' keyword for on-demand high-effort reasoning and defaults Opus 4.6 to medium effort.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.68 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.68

     └──▷ TRY IT
     Force maximum reasoning depth on a single turn when tackling a complex architectural or security analysis problem.
     copy

     $ ultrathink — type this keyword in your message to Claude Code to elevate the next turn to high effort

     • ›Re-introduces the ultrathink keyword to trigger high-effort reasoning mode for the next turn.
     • ›Opus 4.6 now defaults to medium effort for Max and Team subscribers, balancing speed and thoroughness.
     └──▷ BREAKING ON UPGRADE

     • !Opus 4 and Opus 4.1 are removed from Claude Code on the first-party API; users with either model pinned are automatically migrated to Opus 4.6.
128. v2.1.63 Feb 28, 2026 · issue -170

     Claude Code v2.1.63 adds HTTP hooks, /simplify & /batch slash commands, and cross-worktree config sharing.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.63 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.63

     └──▷ TRY IT
     Opt out of claude.ai MCP servers entirely for a session — useful in air-gapped or compliance-restricted environments.
     copy

     $ ENABLE_CLAUDEAI_MCP_SERVERS=false claude

     • ›Adds /simplify and /batch bundled slash commands.
     • ›Adds HTTP hooks: POST JSON to a URL and receive JSON back, as an alternative to shell command hooks.
     • ›Adds ENABLE_CLAUDEAI_MCP_SERVERS=false environment variable to opt out of claude.ai MCP servers.
     • ›Improves /model command to display the currently active model in the slash command menu.
     • ›Project configs and auto memory are now shared across git worktrees of the same repository.
     +3 moreshow less

     • ›Adds manual URL paste fallback during MCP OAuth authentication when the automatic localhost redirect fails.
     • ›Adds 'Always copy full response' option to the /copy picker, skipping the code block picker for future /copy calls.
     • ›VSCode: Adds session rename and remove actions to the sessions list.
129. v2.1.59 Feb 26, 2026 · issue -172

     Claude Code v2.1.59 adds auto-memory saving, a /copy picker for code blocks, and smarter always-allow bash prefixes.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.59 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.59

     └──▷ TRY IT
     After a session, review and edit what Claude auto-saved to persistent memory so future sessions inherit the right context.
     copy

     $ /memory

     When a response contains multiple code blocks, pick exactly the one snippet you want on your clipboard instead of manually selecting text.
     copy

     $ /copy

     • ›Adds auto-memory: Claude automatically saves useful context to persistent memory, manageable via the /memory command.
     • ›New /copy command opens an interactive picker to select and copy individual code blocks or the full response.
     • ›Smarter 'always allow' prefix suggestions for compound bash commands — computes per-subcommand prefixes (e.g. each part of cd /tmp && git fetch && git push) instead of treating the whole command as one unit.
     • ›Reduces memory usage in multi-agent sessions by releasing completed subagent task state.
130. v2.1.51 Feb 24, 2026 · issue -174

     Claude Code v2.1.51 adds remote-control subcommand, custom npm registry support for plugins, and new SDK account environment variables.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.51 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.51

     └──▷ TRY IT
     Serve your local Claude Code environment to an external build system using the new remote-control subcommand.
     copy

     $ claude remote-control

     Extend the plugin git clone timeout when working behind a slow corporate proxy to avoid installation failures.
     copy

     $ CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=300000 claude

     Provide account metadata to Claude Code synchronously in SDK/CI contexts so telemetry events are correctly attributed from the very first event.
     copy

     $ CLAUDE_CODE_ACCOUNT_UUID=<uuid> [email protected] CLAUDE_CODE_ORGANIZATION_UUID=<org-uuid> claude --print "<prompt>"

     • ›Adds claude remote-control subcommand for external builds, enabling local environment serving for all users.
     • ›Adds CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS environment variable to configure plugin marketplace git timeout (default raised from 30s to 120s).
     • ›Supports custom npm registries and specific version pinning when installing plugins from npm sources.
     • ›Reduces the tool-result disk-persistence threshold from 100K to 50K characters, lowering context window consumption and extending conversation longevity.
     • ›Adds CLAUDE_CODE_ACCOUNT_UUID, CLAUDE_CODE_USER_EMAIL, and CLAUDE_CODE_ORGANIZATION_UUID environment variables so SDK callers can supply account metadata synchronously, eliminating a race condition in early telemetry.
     +2 moreshow less

     • ›Routes HTTP hooks through the sandbox network proxy when sandboxing is enabled, enforcing the domain allowlist.
     • ›The /model picker now shows human-readable labels (e.g., "Sonnet 4.5") instead of raw model IDs for pinned versions, with an upgrade hint when a newer version is available.
     └──▷ BREAKING ON UPGRADE

     • !BashTool now skips the login shell (-l flag) by default when a shell snapshot is available (previously required setting CLAUDE_BASH_NO_LOGIN=true to achieve this); environments that relied on login-shell initialization running unconditionally may behave differently.
     • !HTTP hook header values no longer interpolate arbitrary environment variables — env var interpolation now requires an explicit allowedEnvVars list in the hook configuration, so existing hooks using env var interpolation in headers will stop expanding those variables.
131. v2.1.50 Feb 20, 2026 · issue -178

     Claude Code v2.1.50 adds worktree isolation for agents, new hook events, claude agents CLI command, and 1M context controls.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.50 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.50

     └──▷ TRY IT
     List all configured agents to audit what's available in your Claude Code setup.
     copy

     $ claude agents

     Declare an agent that runs in its own isolated git worktree, keeping changes sandboxed from your main branch.
     yaml copy

     isolation: worktree

     Disable 1M context window support to control token usage or costs in environments where smaller context is preferred.
     copy

     $ CLAUDE_CODE_DISABLE_1M_CONTEXT=1 claude -p "summarize this repo"

     • ›Adds WorktreeCreate and WorktreeRemove hook events for custom VCS setup and teardown during agent worktree isolation.
     • ›Supports isolation: worktree in agent definitions, letting agents declaratively run in isolated git worktrees.
     • ›New claude agents CLI command lists all configured agents.
     • ›Adds startupTimeout configuration option for LSP servers.
     • ›Adds CLAUDE_CODE_DISABLE_1M_CONTEXT environment variable to disable 1M context window support.
     +5 moreshow less

     • ›Opus 4.6 (fast mode) now includes the full 1M context window.
     • ›CLAUDE_CODE_SIMPLE mode now also disables MCP tools, attachments, hooks, and CLAUDE.md file loading for a fully minimal experience.
     • ›VSCode: Adds /extra-usage command support in VS Code sessions.
     • ›Improves startup performance for headless mode (-p flag) by deferring Yoga WASM and UI component imports.
     • ›Improves memory efficiency during long sessions by clearing internal caches after compaction and clearing large tool results after processing.
132. v2.1.49 Feb 19, 2026 · issue -179

     Claude Code v2.1.49 adds file editing in Simple mode, ConfigChange hooks for auditing, and richer SDK model capability discovery.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.49 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.49

     └──▷ TRY IT
     Use Simple mode for lightweight file-editing tasks without needing a full agent setup.
     copy

     $ CLAUDE_CODE_SIMPLE=1 claude

     • ›Simple mode (CLAUDE_CODE_SIMPLE) now includes the file edit tool alongside the Bash tool, enabling direct file editing without leaving simple mode.
     • ›New ConfigChange hook event fires when configuration files change mid-session, enabling enterprise security auditing and optional blocking of settings changes.
     • ›SDK model info now exposes supportsEffort, supportedEffortLevels, and supportsAdaptiveThinking fields so consumers can programmatically discover model capabilities.
     • ›Permission suggestions are now populated when safety checks trigger an ask response, enabling SDK consumers to surface permission options to users.
     • ›Pressing Ctrl+C or ESC twice within 3 seconds now kills all background agents when the main thread is idle.
     +1 moreshow less

     • ›Improved permission prompts for path safety and working directory blocks now display the reason for the restriction.
     └──▷ BREAKING ON UPGRADE

     • !Sonnet 4.5 with 1M context is being removed from the Max plan in favor of Sonnet 4.6 (which now has 1M context); users must switch via /model.
133. v2.1.47 Feb 18, 2026 · issue -180

     Claude Code v2.1.47 adds new hook fields, keybindings, statusline data, and smarter background-agent lifecycle controls.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.47 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.47

     └──▷ TRY IT
     Kill all running background agents at once without interrupting the main thread.
     copy

     $ # While Claude Code is running, press ctrl+f to terminate all background agents instantly.

     • ›Adds last_assistant_message field to Stop and SubagentStop hook inputs, letting hooks read the final assistant response without parsing transcript files.
     • ›Adds chat:newline keybinding action for configurable multi-line input.
     • ›Adds added_dirs to the statusline JSON workspace section, exposing directories added via /add-dir to external scripts.
     • ›New ctrl+f shortcut kills all background agents; pressing ESC now cancels only the main thread while background agents keep running, giving finer control over agent lifecycle.
     • ›The /rename command now also updates the terminal tab title.
     +3 moreshow less

     • ›Increases initial session count in the /resume picker from 10 to 50 for faster session discovery.
     • ›Config backup files are now stored in ~/.claude/backups/ instead of the home directory root.
     • ›VS Code plan preview auto-updates as Claude iterates and keeps the preview open on rejection so Claude can revise.
134. v2.1.45 Feb 17, 2026 · issue -181

     Claude Code v2.1.45 adds Claude Sonnet 4.6 support, SDK rate-limit types, and richer plugin/spinner customization.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.45 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.45

     └──▷ USE IT
     Suppress all default spinner tips and show only your team's custom messages during long operations.
     json copy

     In your Claude Code settings (e.g. .claude/settings.json), add:
     {
       "spinnerTipsOverride": {
         "tips": ["Hang tight — running your scan…", "Almost there…"],
         "excludeDefault": true
       }
     }

     Load a shared plugin and marketplace config from a team-wide directory so all members get the same plugins without touching per-repo config.
     copy

     $ claude --add-dir /shared/team-claude-config

     • ›Supports Claude Sonnet 4.6 as a selectable model.
     • ›Reads enabledPlugins and extraKnownMarketplaces from --add-dir directories, enabling plugin and marketplace configuration via added directories.
     • ›New spinnerTipsOverride setting lets you supply custom spinner tip strings and optionally suppress built-in tips with excludeDefault: true.
     • ›New SDKRateLimitInfo and SDKRateLimitEvent types expose rate-limit utilization, reset times, and overage data to SDK consumers.
     • ›[VSCode] Permission destination choice (project/user/session) now persists across sessions.
135. v2.1.41 Feb 13, 2026 · issue -185

     Claude Code v2.1.41 adds auth subcommands, Windows ARM64 support, and smarter /rename.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.41 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.41

     └──▷ TRY IT
     Check your current authentication state without opening a browser — useful in CI or remote SSH sessions.
     copy

     $ claude auth status

     Log in to Claude Code from the CLI, e.g. when setting up a new machine or switching accounts.
     copy

     $ claude auth login

     Let Claude name the current session automatically based on what you've discussed, instead of typing a name manually.
     copy

     $ /rename

     • ›Adds claude auth login, claude auth status, and claude auth logout CLI subcommands for managing authentication from the terminal.
     • ›Adds native Windows ARM64 (win32-arm64) binary support.
     • ›Improves /rename to auto-generate a session name from conversation context when called without arguments.
136. v2.1.33 Feb 6, 2026 · issue -192

     Claude Code v2.1.33 adds multi-agent hook events, sub-agent spawn restrictions, persistent agent memory, and VSCode remote sessions.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.33 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.33

     └──▷ USE IT
     Restrict an orchestrator agent so it can only spawn specific sub-agent types, reducing blast radius in automated pipelines.
     yaml copy

     # In agent frontmatter (tools section):
     ---
     tools:
       - Task(researcher)
       - Task(summarizer)
     ---

     Give an agent persistent memory scoped to the current project so context survives across sessions.
     yaml copy

     # In agent frontmatter:
     ---
     memory: project
     ---

     • ›Adds TeammateIdle and TaskCompleted hook events for multi-agent workflows, enabling automation when agents become idle or complete tasks.
     • ›Supports restricting which sub-agents can be spawned via Task(agent_type) syntax in agent "tools" frontmatter.
     • ›Adds memory frontmatter field for agents with user, project, or local scope for persistent memory across sessions.
     • ›Adds plugin name to skill descriptions and the /skills menu for improved discoverability.
     • ›Improves API connection failure error messages to show specific causes (e.g., ECONNREFUSED, SSL errors) instead of generic messages.
     +3 moreshow less

     • ›Surfaces errors from invalid managed settings.
     • ›VSCode: Adds support for remote sessions, allowing OAuth users to browse and resume sessions from claude.ai.
     • ›VSCode: Adds git branch and message count to the session picker with branch-name search support.
137. v2.1.32 Feb 5, 2026 · issue -193

     Claude Code v2.1.32 adds Opus 4.6, experimental multi-agent teams, automatic memory, and partial conversation summarization.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.32 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.32

     └──▷ TRY IT
     Spin up an experimental multi-agent team session to tackle complex, parallelizable tasks.
     copy

     $ CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude

     • ›Adds Claude Opus 4.6 model support.
     • ›Introduces experimental multi-agent collaboration via agent teams (enable with CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1).
     • ›Claude now automatically records and recalls memories as it works across sessions.
     • ›Adds 'Summarize from here' option in the message selector for partial conversation summarization.
     • ›Skills defined in .claude/skills/ inside --add-dir directories are now loaded automatically.
     +2 moreshow less

     • ›Skill character budget now scales with context window size (2% of context), allowing more skill descriptions to appear untruncated for users with larger context windows.
     • ›VSCode: Adds a spinner when loading the past conversations list.
138. v2.1.31 Feb 4, 2026 · issue -194

     Claude Code v2.1.31 adds session resume hints and Japanese IME support in checkbox selection.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.31 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.31

     • ›Adds a session resume hint on exit, showing the command to continue a conversation later.
     • ›Supports full-width (zenkaku) space input from Japanese IME in checkbox selection.
139. v2.1.30 Feb 3, 2026 · issue -195

     Claude Code v2.1.30 adds PDF page-range reading, OAuth credentials for MCP servers, and a new /debug command

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.30 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.30

     └──▷ TRY IT
     Register a Slack MCP server that requires pre-configured OAuth credentials instead of Dynamic Client Registration.
     copy

     $ claude mcp add slack-mcp --client-id <your-client-id> --client-secret <your-client-secret>

     • ›Adds pages parameter to the Read tool for PDFs, enabling specific page ranges (e.g., pages: "1-5"); large PDFs (>10 pages) now return a lightweight reference when @-mentioned instead of being inlined into context
     • ›Adds pre-configured OAuth client credentials for MCP servers that lack Dynamic Client Registration support (e.g., Slack) via new --client-id and --client-secret flags on claude mcp add
     • ›Adds /debug command for Claude to help troubleshoot the current session
     • ›Supports additional git log and git show flags in read-only mode, including --topo-order, --cherry-pick, --format, and --raw
     • ›Adds token count, tool uses, and duration metrics to Task tool results
     +4 moreshow less

     • ›Adds reduced motion mode to the config
     • ›Improves --resume memory usage by 68% for users with many sessions via lightweight stat-based loading and progressive enrichment
     • ›Changes /model to execute immediately instead of being queued
     • ›[VSCode] Adds multiline input support to the "Other" text input in question dialogs via Shift+Enter
140. v2.1.27 Jan 30, 2026 · issue -199

     Claude Code v2.1.27 adds --from-pr flag for PR-linked session resumption and automatic PR linking via gh pr create.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.27 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.27

     └──▷ TRY IT
     Pick up a Claude Code session exactly where you left off for a specific pull request, by PR number or full URL.
     copy

     $ claude --from-pr 42

     Resume a session using a full PR URL instead of a number — useful when working across multiple repos.
     copy

     $ claude --from-pr https://github.com/myorg/myrepo/pull/42

     • ›New --from-pr flag lets you resume a session linked to a specific GitHub PR number or URL.
     • ›Sessions created via gh pr create are now automatically linked to the corresponding PR.
     • ›Tool call failures and denials are now recorded in debug logs for easier troubleshooting workflows.
     • ›VSCode: Enables the Claude in Chrome integration.
     • ›Permissions now respect content-level ask over tool-level allow, so granular deny patterns like ask: ["Bash(rm *)"] correctly override a broad allow: ["Bash"].
     └──▷ BREAKING ON UPGRADE

     • !Permission evaluation order has changed: a content-level ask rule now takes precedence over a tool-level allow. Configurations using allow: ["Bash"], ask: ["Bash(rm *)"] that previously permitted all Bash commands will now prompt for permission on rm commands.
141. v2.1.23 Jan 29, 2026 · issue -200

     Claude Code v2.1.23 adds customizable spinner verbs and shows PR merge status and timeout durations in the UI.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.23 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.23

     • ›Adds spinnerVerbs setting to customize the verbs displayed in the activity spinner.
     • ›Shows timeout duration alongside elapsed time for Bash commands.
     • ›Displays a purple status indicator in the prompt footer for merged pull requests.
142. v2.1.21 Jan 28, 2026 · issue -201

     Claude Code v2.1.21 adds Japanese IME input support and automatic Python venv activation in VS Code.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.21 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.21

     └──▷ USE IT
     Opt out of automatic Python venv activation in VS Code if you manage your interpreter another way.
     json copy

     // In VS Code settings.json
     { "claudeCode.usePythonEnvironment": false }

     • ›Supports full-width (zenkaku) number input from Japanese IME in option selection prompts.
     • ›Adds automatic Python virtual environment activation in the VS Code extension, ensuring python and pip use the correct interpreter (configurable via claudeCode.usePythonEnvironment).
     • ›Improves read/search progress indicators to show 'Reading…' while in progress and 'Read' when complete.
     • ›Improves Claude's preference for file operation tools (Read, Edit, Write) over bash equivalents (cat, sed, awk).
143. v2.1.20 Jan 27, 2026 · issue -202

     Claude Code v2.1.20 adds PR review status in the footer, vim history nav, TaskUpdate deletions, and per-directory CLAUDE.md loading.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.20 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.20

     └──▷ TRY IT
     Load project-specific CLAUDE.md instructions from a shared config directory alongside the default working directory.
     copy

     $ CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir /path/to/shared-config

     • ›Adds arrow key history navigation in vim normal mode when the cursor cannot move further.
     • ›Adds external editor shortcut (Ctrl+G) to the help menu for easier discovery.
     • ›Adds PR review status indicator to the prompt footer showing the current branch's PR state (approved, changes requested, pending, or draft) as a colored dot with a clickable link.
     • ›Supports loading CLAUDE.md files from additional directories specified via --add-dir (requires CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1).
     • ›Adds ability to delete tasks via the TaskUpdate tool.
     +7 moreshow less

     • ›Improves /sandbox command UI to show dependency status with installation instructions when dependencies are missing.
     • ›Enables the /commit-push-pr skill to automatically post PR URLs to configured Slack channels via MCP tools.
     • ›Makes the /copy command available to all users.
     • ›Changes background agents to prompt for tool permissions before launching.
     • ›Accepts wildcard permission rules like Bash(*) and treats them as equivalent to Bash.
     • ›Renders teammate messages with rich Markdown formatting (bold, code blocks, lists, etc.) instead of plain text.
     • ›Changes ToolSearch results to appear as a brief notification instead of inline in the conversation.
144. v2.1.19 Jan 23, 2026 · issue -206

     Claude Code v2.1.19 adds a Tasks system, argument shorthands for custom commands, and session forking/rewind for all VS Code users.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.19 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.19

     └──▷ TRY IT
     Use positional argument shorthands in a custom command to pass the first two arguments directly, e.g. a file path and a label.
     copy

     $ # In a custom command definition:
     # Analyze $0 and tag the result as $1
     analyze_file $0 --tag $1

     • ›Adds $0, $1, etc. shorthand syntax for accessing individual arguments in custom commands.
     • ›Changes indexed argument syntax from $ARGUMENTS.0 to $ARGUMENTS[0] (bracket notation).
     • ›Skills without additional permissions or hooks are now allowed without requiring approval.
     • ›[SDK] Adds replay of queued_command attachment messages as SDKUserMessageReplay events when replayUserMessages is enabled.
     • ›[VS Code] Session forking and rewind functionality is now enabled for all users.
     └──▷ BREAKING ON UPGRADE

     • !Indexed argument syntax for custom commands changed from $ARGUMENTS.0 to $ARGUMENTS[0]; existing custom commands using the old dot notation will need to be updated.
145. v2.1.16 Jan 22, 2026 · issue -207

     Claude Code v2.1.16 adds task management with dependency tracking, native VSCode plugin management, and remote session browsing for OAuth users.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.16 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.16

     • ›New task management system with dependency tracking between tasks.
     • ›[VSCode] Native plugin management support added to the IDE extension.
     • ›[VSCode] OAuth users can now browse and resume remote Claude sessions from the Sessions dialog.
146. v2.1.14 Jan 20, 2026 · issue -209

     Claude Code v2.1.14 adds history-based Tab autocomplete in bash mode, plugin search, SHA pinning, and a VSCode /usage command.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.14 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.14

     └──▷ TRY IT
     Quickly re-run a recent shell command in bash mode without retyping it — type the start of the command after ! and press Tab to pull from history.
     copy

     $ ! git log --on<Tab>   # completes to a previously run git command from your bash history

     • ›Adds history-based Tab autocomplete in bash mode (!) — type a partial command and press Tab to complete from your shell history.
     • ›Adds search/filter to the installed plugins list — type to filter by plugin name or description.
     • ›Supports pinning plugins to specific git commit SHAs, enabling marketplace entries to install exact versions.
     • ›Improves backspace to delete pasted text as a single token rather than one character at a time.
     • ›[VSCode] Adds /usage command to display current plan usage.
147. v2.1.9 Jan 16, 2026 · issue -213

     Claude Code v2.1.9 adds auto:N MCP threshold syntax, plansDirectory setting, external editor in prompts, and richer hook/skill APIs.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.9 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.9

     └──▷ USE IT
     Store plan files in a project-local directory so plans are version-controlled alongside your code.
     json copy

     # In your Claude Code settings (settings.json)
     { "plansDirectory": ".claude/plans" }

     Inject the current session ID into a skill command so downstream scripts can correlate activity back to the Claude session.
     json copy

     # In a skill definition
     { "command": "my-audit-tool --session ${CLAUDE_SESSION_ID}" }

     • ›Adds auto:N syntax to set the MCP tool search auto-enable threshold as a context window percentage (0–100).
     • ›Adds plansDirectory setting to customize where plan files are stored.
     • ›Adds external editor support (Ctrl+G) inside AskUserQuestion "Other" input fields.
     • ›Adds session URL attribution to commits and PRs created from web sessions.
     • ›Enables PreToolUse hooks to return additionalContext directly to the model.
     +1 moreshow less

     • ›Adds ${CLAUDE_SESSION_ID} string substitution so skills can access the current session ID.
148. v2.1.7 Jan 14, 2026 · issue -215

     Claude Code v2.1.7 adds MCP tool search auto mode, permission feedback, and task notification previews.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.7 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.7

     └──▷ TRY IT
     Opt out of MCP tool search auto mode if you need all tool descriptions loaded upfront rather than discovered on demand.
     copy

     $ claude config set disallowedTools '["MCPSearch"]'

     • ›Adds showTurnDuration setting to hide turn-duration messages like "Cooked for 1m 6s".
     • ›Enables feedback submission when accepting permission prompts.
     • ›Adds inline display of the agent's final response in task notifications, so results are visible without opening the full transcript.
     • ›Enables MCP tool search auto mode by default: when MCP tool descriptions exceed 10% of the context window, they are deferred and discovered on-demand via the MCPSearch tool, reducing upfront context consumption for users with many MCP tools.
     • ›Updates OAuth and API Console URLs from console.anthropic.com to platform.claude.com.
     └──▷ BREAKING ON UPGRADE

     • !MCP tool search auto mode is now on by default; users who relied on all MCP tool descriptions being loaded upfront must add MCPSearch to disallowedTools in their settings to restore the previous behaviour.
149. v2.1.6 Jan 13, 2026 · issue -216

     Claude Code v2.1.6 adds config search, date-ranged stats, nested skills discovery, and richer context window metrics.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.6 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.6

     └──▷ TRY IT
     Review spending or usage trends over the last week vs. month without leaving the terminal.
     copy

     $ /stats   # then press 'r' to cycle through Last 7 days / Last 30 days / All time

     Display remaining context window capacity in the status line by referencing the new percentage fields.
     copy

     $ # In your status line config, reference the new fields:
     # context_window.used_percentage
     # context_window.remaining_percentage

     • ›Adds search/filter functionality inside the /config command for quickly locating settings.
     • ›Adds an Updates section to /doctor showing the auto-update channel and available npm versions (stable/latest).
     • ›Adds date range filtering to /stats — press r to cycle between Last 7 days, Last 30 days, and All time.
     • ›Adds automatic discovery of skills from nested .claude/skills directories when working with files in subdirectories.
     • ›Adds context_window.used_percentage and context_window.remaining_percentage fields to the status line for easier context window display.
     +5 moreshow less

     • ›Improves the external CLAUDE.md imports approval dialog to show which files are being imported and from where.
     • ›Improves /tasks dialog to go directly to task details when only one background task is running.
     • ›Improves @ autocomplete with icons for different suggestion types and single-line formatting.
     • ›Changes terminal title to "Claude Code" on startup for better window identification.
     • ›Caps task notification display at 3 lines with an overflow summary when multiple background tasks complete simultaneously.
     └──▷ BREAKING ON UPGRADE

     • !The ability to @-mention MCP servers to enable/disable them has been removed — use /mcp enable <name> instead.
150. v2.1.4 Jan 11, 2026 · issue -218

     Claude Code v2.1.4 adds env var to fully disable background tasks and the Ctrl+B shortcut.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.4 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.4

     └──▷ TRY IT
     Prevent Claude Code from ever backgrounding tasks — useful in CI pipelines or restricted environments where background processes are undesirable.
     copy

     $ CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 claude

     • ›New CLAUDE_CODE_DISABLE_BACKGROUND_TASKS environment variable disables all background task functionality, including auto-backgrounding and the Ctrl+B shortcut.
151. v2.1.3 Jan 9, 2026 · issue -220

     Claude Code v2.1.3 adds release channel switching, unreachable-rule warnings, and a 10-minute hook timeout.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.3 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.3

     └──▷ TRY IT
     Switch between stable and latest release channels without leaving the CLI.
     copy

     $ /config

     Audit your permission rules for unreachable entries and get fix guidance before they silently do nothing.
     copy

     $ /doctor

     • ›Adds release channel toggle (stable or latest) to /config, letting you switch update tracks in-product.
     • ›New detection and warnings for unreachable permission rules surfaced in /doctor and after saving rules, with source attribution and actionable fix guidance.
     • ›Extends tool hook execution timeout from 60 seconds to 10 minutes, enabling longer-running hook scripts.
     • ›[VSCode] Adds clickable destination selector for permission requests, letting you choose where settings are saved: this project, all projects, shared with team, or session only.
     • ›Merges slash commands and skills into a unified concept, simplifying the mental model.
152. v2.1.2 Jan 9, 2026 · issue -220

     Claude Code v2.1.2 adds OSC 8 hyperlinks, winget support, plan-mode shortcut, and full large-output persistence to disk.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.1.2 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.1.2

     └──▷ TRY IT
     Force plugin autoupdates in CI or locked-down environments where the main auto-updater is disabled.
     copy

     $ FORCE_AUTOUPDATE_PLUGINS=1 claude

     • ›Adds clickable OSC 8 hyperlinks for file paths in tool output in supported terminals (e.g., iTerm).
     • ›Adds Windows Package Manager (winget) installation detection with automatic update instructions.
     • ›Adds Shift+Tab keyboard shortcut in plan mode to instantly select the "auto-accept edits" option.
     • ›Adds FORCE_AUTOUPDATE_PLUGINS environment variable to enable plugin autoupdate even when the main auto-updater is disabled.
     • ›Adds agent_type field to SessionStart hook input when --agent is specified.
     +3 moreshow less

     • ›Adds source path metadata to images dragged onto the terminal so Claude knows where images originated.
     • ›Large bash command outputs and tool outputs are now saved to disk instead of truncated, giving Claude access to full content via file references.
     • ›Unifies plugins and MCPs in the /plugins installed tab with scope-based grouping.
     └──▷ BREAKING ON UPGRADE

     • !The Windows managed settings path C:\ProgramData\ClaudeCode\managed-settings.json is deprecated; administrators must migrate to C:\Program Files\ClaudeCode\managed-settings.json.
     • !The minimum zod peer dependency is now ^4.0.0 (SDK).
153. v2.0.74 Dec 19, 2025 · issue -241

     Claude Code v2.0.74 adds LSP code-intelligence tools, expands terminal setup support, and improves theme controls.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.0.74 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.0.74

     └──▷ TRY IT
     Configure optimal key bindings and shell integration for Kitty, Alacritty, Zed, or Warp in one step.
     copy

     $ /terminal-setup

     Quickly toggle syntax highlighting off for a distraction-free diff review while browsing themes.
     copy

     $ /theme  # then press ctrl+t to toggle syntax highlighting on/off

     • ›Adds LSP (Language Server Protocol) tool enabling code-intelligence features: go-to-definition, find references, and hover documentation.
     • ›Adds /terminal-setup support for Kitty, Alacritty, Zed, and Warp terminals.
     • ›Adds ctrl+t shortcut in /theme to toggle syntax highlighting on/off.
     • ›Adds syntax highlighting info display inside the theme picker.
     • ›Improves /context command visualization with skills and agents grouped by source, slash commands listed, and token counts sorted.
154. v2.0.73 Dec 19, 2025 · issue -241

     Claude Code v2.0.73 adds clickable image links, kill-ring cycling, plugin search, custom fork session IDs, and VS Code tab badges.

     └──▷ GET THIS VERSION
     copy

     $ git clone --branch v2.0.73 https://github.com/anthropics/claude-code.git
     # already have the repo? check out this version:
     $ git checkout v2.0.73

     └──▷ TRY IT
     Fork an existing session and assign a meaningful custom ID so you can reference it later by name rather than an auto-generated hash.
     copy

     $ claude --resume <existing-session-id> --fork-session --session-id my-audit-branch

     • ›Adds clickable [Image #N] links in the terminal that open attached images in the default viewer.
     • ›Adds alt-y yank-pop to cycle through kill-ring history after a ctrl-y yank.
     • ›Adds search filtering to the plugin discover screen — filter by name, description, or marketplace in real time.
     • ›Supports custom session IDs when forking sessions via --session-id combined with --resume or --continue and --fork-session.
     • ›Improves /theme command to open the theme picker directly.
     +1 moreshow less

     • ›[VS Code] Adds tab icon badges showing pending permissions (blue) and unread completions (orange).