Claude Code changelog changedchangelog
Nearest release: v2.1.247, published 8 hours before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+36added
Lines−0removed
From line
6
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits71to this page, all time
The whole hunk
from line 6, old and new numbered
/
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 6
66
77Run `claude --version` to check your installed version.
88
9<Update label="2.1.247" description="August 26, 2026">
10 * Added the `SendFeedback` tool: when something goes wrong in a session, Claude can draft a feedback report for you to review and send from `/feedback` (turn off with the `feedbackDrafts` setting)
11 * Added `{id, text, cooldownSessions, priority}` entries, `tipsFile`, and `label` to `spinnerTipsOverride`, so organizations can rotate their own tips alongside the built-in ones
12 * Added a tip on Bash permission prompts pointing to auto mode, with a one-keystroke "Yes, and switch to auto mode" option
13 * Added `/claude-api cost-optimize` 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
14 * Updated the `/claude-api` skill with Admin API coverage (organization members, invites, workspaces, API keys, rate limit reports, workload identity federation, CMEK)
15 * Fixed fast arrow-key + Enter sequences acting on the row above the one you navigated to in history search, `/config`, `/mcp`, `/skills`, background tasks, and `/model`
16 * Fixed sub-agents dying on a first-call model 404: they now use the session's fallback model chain, and the error returned to the parent includes the error type, status, request id, and model
17 * Fixed a hook or background agent that printed megabytes of error output being able to overflow the conversation and wedge the session on "Prompt is too long"
18 * Fixed Ctrl keyboard shortcuts not firing under non-Latin (e.g. Cyrillic) keyboard layouts in kitty-protocol terminals
19 * Fixed text like `<35;150;7M` being inserted into the prompt when a mouse report arrived split across reads right after the escape prefix
20 * Fixed the Bash sandbox's after-command cleanup deleting a dotfile-managed `~/.claude/settings.json` symlink (nix/home-manager, stow) when it is repointed outside the sandbox's writable area
21 * Fixed `/terminal-setup` overwriting your entire Zed `keymap.json` instead of merging in its keybinding
22 * Fixed `/rename` silently confirming when the session registry could not be updated; it now says other sessions may still show the old name
23 * Fixed `/compact` and "Summarize from here" in sessions started with `--agent` summarizing under the default system prompt instead of the conversation's own
24 * Fixed a background session showing "opening…" forever in `claude agents` after its terminal host process died; the row now fails within seconds with the reason, and Enter restarts it
25 * Fixed unbounded memory growth when a hook's or background task's output file could not be written; the file now notes where output was lost
26 * Fixed `/install-github-app` over SSH: the copy shortcut now says how the sign-in URL was copied instead of always claiming success, and the URL appears immediately when no browser can open
27 * Fixed shell commands carried over from the foreground logging an internal error or showing a misleading `[exited with code -1]` line when they finish in background sessions
28 * Fixed a version-less marketplace plugin's live cache directory being deleted and recreated on a second-scope install, which could disrupt a running session using it
29 * Fixed Remote Control sessions started with `/remote-control` not reporting the working-tree diff to connected clients
30 * Fixed self-hosted runner sessions reporting `running` before Claude Code had started, which could trigger a premature "Claude is waiting for your input" notification from the Claude desktop app
31 * Fixed first-run setup exiting with "Unable to connect to Anthropic services" when managed settings configure Claude apps gateway sign-in and Anthropic endpoints are unreachable
32 * Fixed cloud sessions (Claude Code on the web, desktop and mobile apps) sometimes showing the previous permission mode when you switch modes right after sending a message
33 * Fixed cloud sessions going silent when the session's container restarts between turns while a background agent, shell, or monitor is still running — the resumed session now reports the lost work
34 * Improved plugin marketplace hardening: names containing control or invisible characters are rejected, and marketplace-supplied text in `/plugin` and `claude plugin` output is escape-safe
35 * Improved Bedrock, Vertex, and Foundry sessions (and any with telemetry disabled): Claude is now told when a configured MCP server failed to connect, instead of concluding its tools don't exist
36 * Changed Sonnet 5's default auto-compact window to its full 1M context, so sessions on the 1M window now auto-compact at about 967K tokens instead of about 934K
37 * Changed cross-session peer messages to collapse by default to a one-line `Message from @<sender>: <first line>` preview; Ctrl+O expands the full body
38 * Changed terminal hyperlinks in rendered markdown: link targets that point at a network or automounter path, contain a control character, or lead with an invisible character now render as plain text
39 * Changed the prompt-footer PR badge to skip its GitHub re-check on terminal refocus when the last check is under a minute old
40 * Changed analytics to stay off from startup, not only after login, when managed settings force gateway login or a custom OAuth deployment is configured
41 * Changed Claude apps gateway sign-in requests to identify Claude Code (a `surface=claude_code` device-authorization parameter and a `claude-code/<version>` User-Agent)
42 * Changed organization sign-in enforcement to exit at start when the administrator's managed settings cannot be read, even if host-supplied or per-user Windows registry settings exist
43</Update>
44
945<Update label="2.1.246" description="August 25, 2026">
1046 * Added a startup warning for Bash allow rules with a wildcard before the subcommand (e.g. `Bash(git * main)`), since they also match options inserted before the subcommand
1147 * Added an Auto mode tab to `/permissions` for viewing and editing auto mode classifier rules
from line 2100
20642100 * Fixed an unrecoverable conversation when reading a file whose image extension doesn't match its contents (e.g. HTML saved as .png) — now falls back to text
20652101 * Fewer spurious tool errors during search: `head`/`tail` file views now satisfy the read-before-edit check, and a "no matches" result (exit code 1) from `egrep`, `fgrep`, `git grep`, or `git diff` is no longer reported as a command failure
20662102 * Fixed `/branch` failing with "No conversation to branch" after entering a worktree or in some background sessions
2067 * Fixed pressing Escape in the AskUserQuestion notes field aborting the turn instead of returning to answer selection
2068 * Fixed model selection not applying when changed via the IDE model picker or `applyFlagSettings` after startup
2069 * Resumed sessions now keep the model they were using instead of picking up another session's `/model` choice
2070 * Fixed Bedrock and Vertex users unable to select "Opus (1M context)" from the `/model` picker (regression in v2.1.129)
2071 * Fixed remote-session login failing with "Can't access this organization" for users with `forceLoginMethod` and `forceLoginOrgUUID` set
2072 * Fixed MCP servers with paginated `tools/list` responses only returning the first page, silently dropping tools
2073 * Fixed MCP images with unsupported MIME types (e.g. SVG) breaking the conversation — now saved to disk and referenced in the tool result
2074 * Fixed file descriptor exhaustion when a build runs inside a skill directory — non-`.md` files no longer trigger skill reloads
2075 * Fixed session title being generated from plugin monitor output instead of the user's first prompt
2076 * Fixed Skill tool failing with permission error in headless mode (regression in v2.1.141)
2077 * Fixed plugins enabled in your own settings showing "not cached" errors after first load on a fresh machine; plugins enabled only by a project's `.claude/settings.json` now show an actionable `claude plugin install` hint
2078 * Fixed `claude mcp list` silently reporting no servers when `.mcp.json` can't be parsed (e.g. using VS Code's `"servers"` key instead of `"mcpServers"`) — now shows configuration errors
2079 * Fixed background side-queries on custom `ANTHROPIC_BASE_URL` setups and Bedrock Mantle not using Haiku — now falls back correctly when a first-party API key is configured or no Haiku model is set
2080 * Fixed scrolling in attached background sessions on Windows — PgUp/PgDn, mouse wheel, and Ctrl+O transcript navigation now work
2081 * Fixed a crash when closing the terminal while attached to a background session
2082 * Fixed on Windows, pressing ← in `claude agents` leaving the list unresponsive to keyboard input
2083 * Fixed ghost characters at the left edge when switching panes in Agent View on Windows Terminal with CJK content
2084 * `/bg` and `←`-detach now preserve directories added via `/add-dir`
2085 * Fixed Edit/Write refusing with "background session hasn't isolated its changes yet" right after detaching a session that was already editing in place
2086 * Fixed `claude respawn <id>` on a stopped background session showing "stopped" instead of running
2087 * Fixed `/resume` picker not showing sessions forked from a background session
2088 * Fixed opening a session from `claude agents` or running `claude logs <id>` hanging when the background service is unresponsive — now times out after 10s with a recovery hint
2089 * Fixed background Bash tasks spawned by subagents staying "Running" in SDK task panels after the process exits
2090 * Fixed completed or stopped background sessions briefly failing to wake being permanently marked as a startup crash
2091 * Fixed markdown links in `claude agents` attached sessions rendering as plain text instead of clickable hyperlinks
2092 * Fixed custom `spinnerVerbs` applying to the post-turn duration message — past-tense built-ins like "Worked for 5s" are restored there
2093 * `claude agents` / `--bg` rejection messages now name the specific gate (non-TTY, env var, or setting) instead of a generic message
2094 * `claude --bg --name <label>` now echoes the name in the post-spawn confirmation
2095 * `claude agents`: renaming a background session with Ctrl+R now updates the attached session's banner immediately
2096 * Background session worktree isolation guard now applies for non-git VCS users with `WorktreeCreate` hooks configured
2097 * Plugin marketplace add/update now respects `CLAUDE_CODE_PLUGIN_PREFER_HTTPS`
2098 * `/plugin` now returns to the Installed list after enabling, disabling, or uninstalling a plugin
2099 * `/doctor` now shows an exec-form example when a command hook is missing the `command` field
2100 * Skill-listing truncation is no longer shown as a startup notification — run `/doctor` for the full breakdown
2101 * Improved recovery from rare pre-response stream stalls — now retries streaming once instead of falling back to a slower non-streaming request
2102 * Improved SDK/headless MCP startup: pre-wait now overlaps startup instead of blocking before the first turn (up to 2s faster with slow MCP servers)
2103 * The post-survey follow-up hint now appears after every non-dismiss survey response with context-aware copy, making it easier to share more detail via /feedback.
2104</Update>
2105
2106<Update label="2.1.143" description="May 15, 2026">
2107 * Added plugin dependency enforcement: `claude plugin disable` now refuses when another enabled plugin depends on the target (with a copy-pasteable disable-chain hint), and `claude plugin enable` force-enables transitive dependencies
2108 * Added projected context cost (per-turn and per-invocation token estimates) to the `/plugin` marketplace browse pane
2109 * Added `worktree.bgIsolation: "none"` setting to let background sessions edit the working copy directly without `EnterWorktree`, for repos where worktrees are impractical
2110 * PowerShell tool now passes `-ExecutionPolicy Bypass`. Opt out with `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1`
2111 * Background sessions now preserve the model and effort level you set after waking from idle
2112 * Shift+Tab in attached agent sessions now includes auto mode in the cycle
2113 * Fixed a corrupt `.credentials.json` with a non-array `scopes` value hanging the CLI on startup or silently aborting OAuth token refresh
2114 * Fixed right-cl
2103 * Fixed pressing Escape in the AskUserQuesti
No line in this hunk matches that.