spacehub

surshar / claude-code

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.

Built by Anthropic · github.com/anthropics

claude-code / CHANGELOG.md
4,967 lines · 433.0 KBPreviewCodeRaw
1# Changelog
2
3## 2.1.210
4
5- Added a live elapsed-time counter to the collapsed tool summary line so long-running tool calls visibly tick instead of looking stuck
6- Added a startup warning for `Write(path)`, `NotebookEdit(path)`, and `Glob(path)` permission rules — use `Edit(path)` or `Read(path)` instead
7- Fixed `isolation: 'worktree'` subagents being able to run git-mutating commands against the main repo checkout instead of their own isolated worktree
8- Fixed the `ultracode` keyword opt-in firing on non-human-originated input such as webhook payloads and relayed PR comments
9- Fixed a rendered text fragment leaking into crash telemetry when a UI component returned content outside a styled text element
10- Fixed paste markers leaking into external editors opened from Claude Code, which could appear as stray È/É characters around pasted text
11- Fixed `claude attach` sometimes failing with "job not found" or "agent is still starting" errors during session transitions — attach now waits for the daemon to settle, and terminal resizes during a slow attach are applied once it completes
12- Fixed a session crash when a tool's result renderer returned a numeric bigint value or plain text instead of a UI element
13- Fixed a hook callback timeout being misreported to the model as a user rejection, which made unattended sessions stop and wait
14- Fixed Claude assuming a `cd` took effect after its command was moved to the background; the tool result now states the working directory is unchanged
15- Fixed plugin-provided MCP servers being torn down when MCP servers are re-synced mid-session
16- Fixed plan approvals without edits being labeled "(edited by user)" and overwriting the plan file with a stale snapshot
17- Fixed `/doctor` skipping its auto-mode-default proposal on Bedrock, Vertex, and Foundry, where auto mode no longer needs an opt-in
18- Fixed Grep content mode claiming "No matches found" when paginating past the end of results
19- Fixed unmatched `$1`/`$2` positional placeholders in skills and commands being silently stripped; they are now preserved verbatim
20- Fixed plugin cache writes leaving temp files behind on failure and failing on locked-file renames on Windows and network filesystems
21- Fixed background workers crash-looping when a client resets its connection to the background service
22- Fixed `claude agents --effort ultracode` not reaching dispatched sessions; the value was silently dropped
23- Fixed pressing ← to open the agents view dropping the task tracker when returning to the session
24- Fixed the agents dashboard retaining pasted images from abandoned reply drafts after their session was deleted
25- Fixed killed background sessions leaving a permanent `git worktree lock` behind; the periodic sweep now releases locks whose owning process is gone
26- Fixed SDK MCP servers registered via an `initialize` control request waiting until the next turn to start connecting
27- Fixed returning to the agents view from a session leaving overlapping ghost frames with `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1`
28- Fixed late-appearing `.claude/*` symlinks not being reconciled into the sandbox deny-write list
29- Hardened the Agent tool against indirect prompt injection via content a subagent read
30- Improved the Bash/PowerShell tool message when a command hits its timeout and is auto-backgrounded, so the model can distinguish a hang from an explicit background request
31- Improved auto mode: the permission classifier now defaults to Sonnet 5 for external sessions, validated on the session's first request and pinned for the session
32- Improved the bundled dataviz skill's chart color validation with perceptual OKLab color difference and recalibrated color-blindness thresholds
33- Memory writes that leave a MEMORY.md index over its read limit now produce an explicit error instead of silent truncation
34- Screen reader mode now announces permission mode changes aloud when cycling modes with Shift+Tab
35- The agents footer hint now shows how many background agents are waiting on your input, with a brief color emphasis when the count changes
36- Agent view: the session you pressed ← from stays visibly marked even after mouse hover or arrow keys move the selection
37- Fable temporarily shows as unavailable in the advisor picker while a server-side issue causing Fable advisor failures is fixed
38
39## 2.1.209
40
41- Fixed /model and other dialogs being blocked in `claude agents` background sessions (reverts an overly broad guard)
42
43## 2.1.208
44
45- Added screen reader mode: opt-in plain-text rendering for screen reader users. Run `claude --ax-screen-reader`, set CLAUDE_AX_SCREEN_READER=1, or add "axScreenReader": true to settings.
46- Added `vimInsertModeRemaps` setting: map two-key insert-mode sequences like `jj` to Escape in vim mode
47- Added `CLAUDE_CODE_PROCESS_WRAPPER`: agent view and the background service now honor a corporate launcher by running every Claude Code self-spawn through a required wrapper executable
48- Added mouse-click support for multi-select menus and "Other" input rows in fullscreen mode
49- Fixed fast mode staying off after switching back to a model that supports it — it now restores automatically when enabled in settings
50- Fixed replies typed to a background agent being lost when delivery fails — the text is now saved and delivered when the session restarts
51- Fixed background-session attach failing permanently ("Couldn't start the background daemon") after an update replaced the binary a running `claude agents` process was launched from
52- Fixed the context window (and auto-compact indicator) briefly resetting to 200k after the CLI auto-updates, causing a false "100% context used" when resuming long-context sessions
53- Fixed supervised and background sessions crashing when a server closed an HTTP/2 connection with a GOAWAY while requests were in flight
54- Fixed truncated stream-json/JSON output and missing result message when piping large responses from `claude -p`
55- Fixed `CLAUDE_CODE_MAX_OUTPUT_TOKENS` and similar env vars silently using the mantissa of scientific-notation values (`1e6` became `1`)
56- Fixed very large markdown tables stalling rendering or using excessive memory; tables over 200 rows show the first 200 with a "… N more rows" notice
57- Fixed the Edit tool failing on files modified after reading when the target text still matches uniquely
58- Fixed Read reporting empty files as "shorter than offset", Grep silently returning "No files found" for invalid regex patterns, Grep count mode under-reporting totals when paginated, and Glob crashing with an unclear error when the pattern, path, or working directory contained a null byte
59- Fixed `apiKeyHelper` script failures being hidden behind a generic 401 after ~10 silent retries; the script's own error is now shown within 3 attempts
60- Fixed Bedrock streaming requests failing with a misleading "Truncated event message received" when a gateway transforms the response — the error now names the content-type and points at the proxy
61- Fixed `/upgrade` showing a login flow instead of the upgrade URL when the browser fails to open
62- Fixed stream-json input killing the session on blank CRLF or whitespace-only lines from Windows-style SDK hosts
63- Fixed headless stream-json sessions hanging permanently when a `control_request` carried a non-string `set_model` payload; the CLI now answers with an error response
64- Fixed repeated "No completion record was found" notices on session resume — orphaned background tasks now collapse into a single summary
65- Fixed Remote Control clients attaching to a terminal-hosted session not seeing background agents and workflow progress until a task started or stopped
66- Fixed the Agent tool launching with no tools when a subagent's `tools` list resolves to nothing — it now returns a clear error naming the unrecognized entries
67- Fixed `/usage` showing stale cached bars over fresher data, and `/mcp` not reclassifying placeholder servers after config edits
68- Fixed "Change directory" in SDK hosts (e.g. Claude Desktop) failing with "A turn is in progress" on idle sessions that have a running background task
69- Fixed the workflow save dialog showing `~/.claude/workflows/` instead of the `CLAUDE_CONFIG_DIR` location for user-scope saves
70- Fixed `/release-notes` adding the viewed notes to the model's context — "Show all" previously injected the entire changelog into every subsequent request
71- Fixed a memory leak in the agent view where pasted images were retained for the screen's lifetime after sending peek replies
72- Fixed SDK sessions losing agents defined via the initialize request when a plugin refresh ran before the client attached
73- Fixed several memory leaks in long sessions: MCP stdio server stderr accumulating up to 64 MB per server, LSP documents staying open indefinitely (now LRU with 50-doc cap), async hook output retained after backgrounding, and unbounded growth in headless/SDK sessions from large tool-result payloads
74- Fixed a memory blowup when reading files with extremely long single lines using offset/limit — the read now returns a clean error instead of loading the whole line
75- Fixed multi-second per-turn slowdowns in sessions with many permission deny/ask rules — rule matchers are now compiled once and cached
76- Improved input responsiveness while agent task lists update — task updates no longer re-render the entire UI
77- Reduced per-tool-call CPU overhead in print/SDK sessions with many MCP tools by caching tool-pool assembly (up to 7x faster tool rounds at high tool counts)
78- Reduced memory usage by bounding the file edit read cache to 16 MB instead of pinning up to 1,000 full files
79- Reduced session transcript size (up to 79x in edit-heavy sessions) and bounded checkpoint disk usage by pruning superseded file-history backups
80- Reduced memory usage when resuming sessions with background agents or forks spawned from large conversations
81- Completed background agents now stay listed in `/tasks` until cleanup instead of vanishing the moment they finish
82- Attaching to a stopped background agent now shows its transcript immediately while the session warms up, instead of a blank "Session is starting" screen
83- Background sessions: an older daemon no longer silently restarts workers spawned by a newer version onto the older binary
84- Agent view: Ctrl+X now deletes renamed-branch worktrees, never destroys unpushed commits, keeps the session row when a worktree is kept, and reused worktree names reset to the current base
85- Catastrophic removals (e.g. `rm -rf ~`) in commands containing `$(…)`/backticks/`<(…)` now prompt in `--dangerously-skip-permissions` and auto mode, matching the plain form
86- `/install-github-app` and the `/mcp` settings menu no longer open in background sessions
87- MCP servers configured with an empty URL now show as "not configured" in `/mcp` instead of a config error
88- `/usage` now shows your last-known usage bars with an "as of" note when the usage endpoint is rate-limited, instead of an error screen
89- Fixed Bedrock auth failing with "Session token not found or invalid" for AWS SSO profiles whose sso_region differs from the Bedrock region (2.1.207 regression)
90
91## 2.1.207
92
93- Auto mode is now available without `CLAUDE_CODE_ENABLE_AUTO_MODE` opt-in on Bedrock, Vertex AI, and Foundry; disable via `disableAutoMode` in settings
94- Fixed the terminal freezing and keystrokes lagging while streaming responses containing very long lists, tables, paragraphs, or code blocks
95- Fixed remote managed settings from a non-interactive run (`claude -p`, the SDK) being permanently recorded as consented without ever showing the security consent dialog
96- Fixed spurious prompt-injection warnings triggered by benign system-generated conversation updates
97- Fixed the auto-updater overwriting a custom launcher script or symlink at `~/.local/bin/claude` on every release; `/doctor` now reports an externally managed launcher
98- Fixed compound commands with `cd` prompting for permission when the only output redirect was to `/dev/null`
99- Fixed the transcript jumping above the start of the answer when a response finishes streaming
100- Fixed `extensions.worktreeConfig` being left in the repo's `.git/config` (breaking go-git tools like `tea`) after the last `worktree.sparsePaths` worktree was removed
101- Fixed malformed bracket patterns in rules globs, skill paths, `.ignore`, and `.worktreeinclude` breaking file reads, file suggestions, and worktree creation
102- Fixed a crash loop in agent teams where a malformed teammate mailbox message caused repeated errors every second until the mailbox file was manually deleted
103- Fixed background sessions auto-named by accepting a plan not showing that name on their agent-view row
104- Fixed background sessions that entered a git worktree resuming blank after a cold reopen from the agent list
105- Fixed Remote Control task status updates being lost when the connection recovered from a network interruption or credential refresh
106- Fixed Remote Control sessions hosted by the desktop app not showing background agent and workflow progress on mobile and web
107- Fixed Deep research runs labeling every Fetch-phase agent "unknown" — chips now show the source hostname
108- Fixed Bedrock repeatedly requesting fresh AWS SSO credentials from IAM Identity Center on every API request
109- Improved agent view: pasting the same text again now expands the collapsed `[Pasted text #N]` placeholder instead of adding a second one
110- Improved agent view: blocked session peeks now lead with the question and show a worded staleness clock (`waiting 3m`) instead of the same timestamp twice
111- Changed Bedrock, Vertex, and Claude Platform on AWS to default to Claude Opus 4.8
112- Changed auto mode to no longer read `autoMode` from `.claude/settings.local.json` (repo-resident); use `~/.claude/settings.json` instead
113- Fixed an indefinite hang on Windows when AWS credential resolution stalls (e.g. a stuck `credential_process`): the 60-second stall guard now fires instead of waiting forever.
114- Plugin hooks/monitors/MCP headersHelper: `${user_config.*}` in shell-form commands is now rejected (shell-injection fix). Hooks: use exec form (`args` array) or `$CLAUDE_PLUGIN_OPTION_<KEY>`; monitors and headersHelper: read the value inside the script (config file or the server's `env` block).
115- Plugin option values (`pluginConfigs`) are no longer read from project-level `.claude/settings.json`; only user, `--settings`, and managed settings are honored
116- Fixed `/usage-credits` amount inputs silently stripping malformed values (e.g. a pasted timestamp) to digits; malformed amounts are now rejected with an error, and amounts over $1,000 require a typed confirmation
117
118## 2.1.206
119
120- Added directory path suggestions to `/cd`, matching `/add-dir` behavior
121- Added a `/doctor` check that proposes trimming checked-in `CLAUDE.md` files by cutting content Claude could derive from the codebase
122- `/commit-push-pr` now auto-allows `git push` to the repo's configured push remote (`remote.pushDefault`, or the sole remote when only one is configured) in addition to `origin`
123- Gateway: `/login` now supports Anthropic-operated public gateway endpoints
124- `EnterWorktree` now asks for confirmation before entering a git worktree outside the project's `.claude/worktrees/` directory
125- Background agents now upgrade to a new version in the background right after a Claude Code update, instead of paying a slow stale-session upgrade when you attach
126- Fixed an expired login failing every model with a misleading "There's an issue with the selected model" error instead of prompting to run `/login`
127- Fixed `claude --resume` and `--continue` not responding to keyboard input on startup
128- Fixed MCP servers configured via `--mcp-config` or `.mcp.json` ignoring a per-server `request_timeout_ms`, which caused long-running MCP tool calls to time out at the 60s default in fresh sessions
129- Fixed `CLAUDE_CODE_EXTRA_BODY` being silently ignored by `claude agents` / `--bg` background workers; the shell-exported override now follows the dispatching session
130- Fixed OAuth MCP servers requiring manual re-authentication after a single failed token refresh
131- Fixed `--permission-prompt-tool` pointing at an MCP server crashing with "MCP tool not found" on cold start before the server finishes connecting
132- Fixed `/model` picker rows printing a price for a different model than the row named, and stopped quoting first-party list prices on providers that don't bill them
133- Fixed server-provided model rows being misplaced in the `/model` picker when an entitlement or allowlist restriction drops the row they were positioned against
134- Fixed desktop sessions getting stuck showing "running" after a slash command was sent mid-turn
135- Fixed keyboard input being ignored in the agents view when a setup prompt appeared before a bare `claude --resume` on Windows
136- Fixed `claude rm` leaving the removed job in the daemon roster, causing the row to reappear in `claude agents`
137- Fixed `/remote-control` showing "Unknown command" when logged out — it now explains how to sign in
138- Fixed left arrow not stepping back out of a phase or agent in the workflow detail view
139- Fixed `/status` listing the same broken-install warning twice
140- Fixed false "disused plugin" tips and skewed disuse telemetry for LSP plugins
141- Fixed `/doctor`'s update check to compare Homebrew installs against their cask's channel instead of the settings channel
142- Fixed the fullscreen jump-to-bottom pill suggesting Ctrl+End on macOS, not showing rebound chords, and wrapping over the transcript
143- Bedrock: fixed a multi-minute startup hang when using an `awsCredentialExport` helper on networks with restricted egress
144- Improved `/code-review` findings quality on claude-opus-4-8 across all effort levels
145- Improved agents view: status column now uses full terminal width instead of truncating at 64 characters
146- Changed agents view: Ctrl+X now permanently removes a completed session, and sessions no longer render twice; deleted background jobs stay deleted
147
148## 2.1.205
149
150- Added an auto mode rule that blocks tampering with session transcript files
151- Fixed `--json-schema` silently producing unstructured output when the schema was invalid, and schemas using the `format` keyword being rejected
152- Fixed a message sent while Claude was working being silently lost when the turn ended at the `--max-turns` limit
153- Fixed Windows worktree removal deleting files outside the worktree when an NTFS junction or directory symlink existed inside it
154- Fixed background agents staying shown as "failed" or "completed" in the agent list after being resumed with `SendMessage`
155- Fixed background jobs flipping from "needs input" back to "working" in the agent list when the agent's turn contained no readable text
156- Fixed `claude attach` erroring when a background agent was mid-upgrade restart instead of waiting for it to come back
157- Fixed session-to-PR linking missing a PR created in a Bash call whose output exceeded the 30K inline limit
158- Fixed `claude mcp add-from-claude-desktop` getting stuck when a server name contains unsupported characters; invalid names are now reported and remaining servers still import
159- Fixed a plugin LSP server that fails to initialize preventing a valid LSP server from another plugin handling the same file extension
160- Fixed a Windows crash when the directory Claude was launched from is deleted, locked, or unmounted while a command is running
161- Fixed a crash when a file watcher was closed while a directory scan was still in flight
162- Fixed project verify skills being rewritten on every session instead of only when a documented command changed
163- Fixed the agent view rendering one line too high and clipping its header when the job list slightly overflowed the screen
164- Fixed background tasks in the web and mobile Remote Control panels showing stale "Running" status by forwarding full task state on every membership change
165- Improved auto mode to ask before running `rm -rf` on a variable it can't resolve from context
166- Auto-update binary downloads now stream to disk instead of buffering in memory, cutting the updater's peak memory usage by roughly 400 MB
167- Background task notifications now explicitly state that no human input has occurred, preventing fabricated in-transcript approvals from being acted on
168- Improved agent view: sessions that edit, merge, comment on, or push to an existing PR now link it in `claude agents`
169- Improved agent view: rows now show a colored state word and a classifier-written headline instead of raw tool call text, and the peek opens with full status including the exact ask for blocked sessions
170- `/doctor` is now a full setup checkup that can diagnose and fix issues; `/checkup` is its alias
171- Reserved the "Claude Browser" MCP server name (alongside "Claude Preview") ahead of the Claude Desktop pane rename; user-configured MCP servers can no longer register under either name
172- Fixed Cowork VM-mode local-agent sessions failing to start with "Not logged in · Please run /login" on CLI 2.1.203+
173
174## 2.1.204
175
176- Fixed hook events not streaming during SessionStart hooks in headless sessions, which could cause remote workers to be idle-reaped mid-hook
177
178## 2.1.203
179
180- Added a warning when your login is about to expire, so you can re-authenticate before background sessions are interrupted
181- Added a grey ⏸ badge to the footer when in manual permission mode, making the active mode always visible
182- Added the session's additional working directories to MCP `roots/list`, with `notifications/roots/list_changed` sent when the set changes
183- Fixed opening or switching background agent sessions on macOS stalling for 15–20 seconds due to a false low-memory detection (regression in 2.1.196)
184- Fixed background sessions becoming permanently unresponsive to attach, replies, and stop when the daemon's session token went stale — the session now recovers automatically
185- Fixed returning to `claude agents` silently stopping running subagents and re-running the prompt from scratch — their work now carries over
186- Fixed a memory and per-turn CPU regression in interactive sessions: the context-usage indicator no longer re-analyzes the entire transcript after every turn
187- Fixed background agents inheriting a stale `PATH` from the daemon instead of the dispatching shell, causing missing tools on Windows
188- Fixed background and agent-view sessions dropping a shell-exported `ANTHROPIC_BASE_URL`, which sent API keys to the default endpoint and failed with 401
189- Fixed Bash failing with "argument list too long" in repos with many git worktrees
190- Fixed worktree-isolated subagents sometimes running shell commands in the parent checkout instead of their own worktree
191- Fixed worktree creation rejecting nested repositories in multi-repo workspaces, leaving background sessions unable to isolate and edit
192- Fixed background agents crash-looping when their working directory was deleted, replaced by a file, or became an invalid path — they now fail once with a clear error
193- Fixed a background daemon auto-upgrade failure silently killing all running background sessions
194- Fixed `TaskStop` and `TaskOutput` failing to find background agents spawned by another agent — errors now list running agents by id and description
195- Fixed the `claude agents` composer discarding your typed message when a slash command isn't available there
196- Fixed the agent list crashing when opening a stopped session whose conversation was already open in another session
197- Fixed background sessions showing "Needs input" in the agent list after the question was already answered
198- Fixed background agent startup failures showing only "exit_with_message" instead of the actual error
199- Fixed background sessions ignoring `effortLevel` changes in settings.json when forked through the daemon
200- Fixed attached background sessions ignoring `CLAUDE_CODE_DISABLE_MOUSE` and `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` opt-outs
201- Fixed `/exit` incorrectly warning about running background agents after all named agents had completed
202- Fixed background sessions started from a non-git directory unable to edit files when a `WorktreeCreate` hook was configured
203- Fixed the `@` directory picker in `claude agents` not showing registered git worktrees
204- Fixed background task output on Windows being permanently replaced by an empty file after `/clear`
205- Fixed content jumping when scrolling up through long transcript history
206- Fixed the terminal flickering and jumping while typing in bash mode when a shell-history suggestion was shown
207- Fixed literal `^[[I` / `^[[O` escape codes being printed when reattaching to a background session
208- Fixed LSP-only plugins being incorrectly flagged for disuse when their language servers deliver diagnostics or answer navigation requests
209- Improved responsiveness while long responses stream: live-preview updates no longer re-render the whole screen
210- Improved subagent behavior: agents are now less likely to re-delegate their entire task to another subagent
211- Reduced binary size by ~7 MB and startup memory by ~7 MB by loading a large bundled dependency lazily instead of inlining it
212- Changed left arrow to no longer close the background tasks, diff, and workflow detail views — press Esc instead
213- Changed the empty `claude agents` view to always show the organized sections (Needs input / Working / Completed) with descriptions
214- Removed the startup "claude command missing or broken" warnings — they now appear in `/doctor` and `/status` instead
215- Removed a redundant navigation hint from the `claude agents` footer
216- [VSCode] Added a Settings toggle for "Enable Remote Control for all sessions"
217
218## 2.1.202
219
220- Added a "Dynamic workflow size" setting in `/config` for controlling how large Claude generally makes dynamic workflows (small/medium/large agent counts) — an advisory guideline, not an enforced cap
221- Added `workflow.run_id` and `workflow.name` OpenTelemetry attributes to telemetry emitted by workflow-spawned agents, so a workflow run's activity can be reconstructed from OTel data
222- Fixed a crash in the inline Ctrl+R history search when accepting or cancelling while the search was still scanning the history file
223- Fixed `/rename` on background sessions being reverted when the job restarts, which broke addressing the session by its new name
224- Fixed transient mTLS handshake failures when settings were re-applied during an in-place client certificate rotation
225- Fixed commands sent from Remote Control (mobile/web) into an interactive session failing with "Unknown command"
226- Fixed images and files sent from the Remote Control mobile or web app without a caption being silently dropped
227- Fixed the sign-in URL printed by `claude auth login` and `claude mcp login --no-browser` not being reliably clickable when it wraps over SSH — it is now emitted as a single hyperlink
228- Fixed opening a chat from `claude agents` sometimes failing with "currently running as a background agent" followed by a worker crash/respawn loop
229- Fixed workflow scripts with unicode quote escapes in strings being corrupted before parsing; workflow parse errors now show the offending line instead of always blaming TypeScript
230- Fixed voice dictation retrying in an unbounded loop when the microphone or audio recorder fails — repeated capture failures now pause voice input
231- Fixed `/remote-control` sessions showing the wrong permission mode in the mobile and web apps
232- Fixed resuming a session by name, or opening the resume picker, taking minutes and using a large amount of memory in repositories with many git worktrees
233- Fixed installer and updater downloads failing immediately with "aborted" when a proxy or network drops the connection mid-download — transient connection drops now retry
234- Fixed re-invoking an already-loaded skill appending a duplicate copy of its instructions to context
235- Improved `/workflows` agent list layout: wider titles, a dedicated time column, shorter model names, and no per-row tool-call counts
236- Improved MCP error messages: clearer error when a server config has `url` but no `type`, suggesting `"type": "http"` instead of the misleading "command: expected string"
237- Changed `/review <pr>` back to a fast single-pass review; use `/code-review <level> <pr#>` for the multi-agent review at a chosen effort level
238
239## 2.1.201
240
241- Claude Sonnet 5 sessions no longer use the mid-conversation system role for harness reminders
242
243## 2.1.200
244
245- Changed `AskUserQuestion` dialogs to no longer auto-continue by default; opt into an idle timeout via `/config`
246- Changed the "default" permission mode to "Manual" across the CLI, `--help`, VS Code, and JetBrains; `--permission-mode manual` and `"defaultMode": "manual"` are accepted alongside `default`
247- Fixed a crash at startup when `disabledMcpServers` or `enabledMcpServers` in `.claude.json` is set to a non-array value
248- Fixed background sessions silently stopping mid-turn after sleep/wake or when reopening a stalled session
249- Fixed background sessions re-running a turn cancelled with Esc after a stall respawn
250- Fixed background agents never starting again after a crash left a stale `daemon.lock` whose PID the OS reused
251- Fixed background-agent daemon handover so a reinstalled older build can no longer take over the daemon; build recency is now judged by the version's embedded build timestamp
252- Fixed background-agent roster issues: transient corruption permanently disabling orphan cleanup, older binaries not preserving fields written by newer versions, and socket auth tokens being stripped during daemon restarts
253- Fixed subagents cut off by a rate limit before producing any text output returning an empty result instead of failing cleanly
254- Fixed control bytes from background-agent output reaching the terminal in the agent view
255- Fixed `claude agents --plugin-dir <dir>` not showing the plugin's agents and skills in the agent view when the flag is placed after `agents`
256- Fixed project-scoped plugins not loading correctly from git worktrees of the same repository
257- Fixed `/mcp` server list not tracking focus for screen readers and magnifiers
258- Fixed voice dictation showing a misleading "Voice connection failed" message when a recording captures no audio
259- Fixed rendering flicker under tmux 3.4+ by enabling synchronized terminal output
260- Improved screen-reader output: decorative glyphs are now hidden, transcript symbols read as short labels, and nested tables read as `Header: value.` lines
261- Improved the install script to explain when installation is killed by the system running out of memory
262
263## 2.1.199
264
265- Stacked slash-skill invocations like `/skill-a /skill-b do XYZ` now load all leading skills (up to 5), not just the first
266- Fixed SSL certificate errors (TLS-inspecting proxies, missing `NODE_EXTRA_CA_CERTS`, expired certs) burning retries before showing actionable guidance — they now fail immediately with the fix hint
267- Fixed streaming responses being discarded when the API emits a mid-stream overloaded/server error after partial output — the partial is now kept with an incomplete-response notice
268- Fixed subagents cut off by a rate limit or server error silently failing instead of returning their partial work to the parent
269- Fixed subagents reporting API errors (e.g. usage limit reached) as successful results — the error is now reported to the parent agent
270- Fixed the background-agent daemon on Linux killing itself and every running agent every ~50 seconds after an unclean shutdown left a corrupted worker record
271- Fixed background agents failing to cold-start over SSH on macOS with "Could not switch to audit session" (regression in 2.1.196)
272- Fixed `claude stop` being silently undone when it raced a background-agent respawn — the respawn now honors the stop
273- Fixed background job progress indicators stalling for minutes while the job ran long commands
274- Fixed background sessions on memory-starved machines showing a generic error — they now indicate low memory and suggest freeing resources
275- Fixed remote sessions briefly flapping between Working and Idle in the agent view when a background agent completes
276- Fixed idle subagents vanishing from the agent panel while other subagents were still working; surplus idle agents now collapse into an expandable summary row
277- Fixed typing `/model` or `/fast` while viewing a subagent silently opening the lead's model picker — a notice now explains the command applies to the lead
278- Fixed `SessionStart`, `Setup`, and `SubagentStart` hooks silently hiding stderr when exiting with code 2 — the error is now shown in the transcript
279- Fixed `claude --dangerously-skip-permissions daemon <subcommand>` being treated as a chat prompt instead of running the subcommand
280- Fixed `SendMessage` silently misrouting when a re-spawned agent reuses a previous agent's name — the tool now detects the mismatch and asks the caller to retarget
281- Fixed opening or resuming a session with no new messages needlessly growing the transcript file
282- Fixed backgrounding a session with `←` or `/background` dropping its `/color` from the agent view row
283- Fixed resetting a corrupted config file from the startup recovery dialog destroying it unrecoverably — it now backs up the file first
284- Fixed Claude in Chrome repeatedly opening the reconnect page when sessions run from different builds or config directories
285- Fixed plan mode not prompting for state-changing browser tool calls; read-only `browser_batch` calls are now correctly auto-allowed
286- Transient server rate-limit errors (429s unrelated to your usage limit) are now retried automatically with backoff for subscribers instead of failing the turn
287- `CLAUDE_CODE_RETRY_WATCHDOG` now raises the default retry count for non-capacity transient errors to 300 and lifts the cap of 15 on `CLAUDE_CODE_MAX_RETRIES`
288- `claude agents` session rows now show pull-request links as bare `#N` without the redundant "PR" label
289
290## 2.1.198
291
292- Subagents now run in the background by default, so Claude keeps working while they run and is notified when they finish (previously a gradual rollout)
293- Claude in Chrome is now generally available
294- Added background agent notifications in `claude agents` — sessions that need input or finish now fire the `Notification` hook (`agent_needs_input` / `agent_completed`)
295- Added `/dataviz` skill for chart and dashboard design guidance with a runnable color-palette validator
296- Gateway: added Claude Platform on AWS (anthropicAws) as an upstream provider; model-not-found responses now advance the failover chain
297- Background agents launched from `claude agents` now commit, push, and open a draft PR when they finish code work in a worktree, instead of stopping to ask
298- The built-in Explore agent now inherits the main session's model (capped at opus) instead of running on haiku
299- Subagents and context compaction now inherit the session's extended thinking configuration, improving output quality on delegated tasks
300- Fixed brief network drops mid-response aborting the turn — transient errors like ECONNRESET now retry with backoff instead of failing
301- Fixed excessive background classifier requests when sandboxed processes repeatedly accessed the same network host
302- Fixed background tasks in web, desktop, and VS Code task panels getting stuck on "Running" after they finish or after resuming a session
303- Fixed agent teams: a teammate that dies on an API error now reports "failed" to the lead, and messaging a stuck teammate wakes it to retry immediately
304- Fixed the `/diff` panel not refreshing when you switch branches or commit outside the session
305- Fixed markdown tables overflowing and wrapping their right border when rendered in fullscreen mode
306- Fixed Claude Platform on AWS and Mantle sessions dead-ending with "Please run /login" when the STS token expires — `awsAuthRefresh` now runs automatically
307- Fixed "no route to host" for local-network hosts in macOS background agent sessions by declaring Local Network entitlements
308- Fixed `/desktop` failing with "Cannot determine working directory" after entering and exiting a worktree
309- Fixed background agents repeatedly showing "Reconnecting…" every ~52 seconds on macOS while the agents view was open
310- Fixed pressing `←` inside `claude attach <id>` exiting to the shell instead of opening the agent view
311- Fixed `claude --bg` silently creating an unattachable session when combined with `--print`/`-p`; the conflicting flags are now rejected up front
312- Fixed the workflow progress view dropping the earliest agents from the list while the phase counter stayed correct in SDK and desktop-app sessions
313- Fixed `.claude/rules/` conditional rules not loading when the target file is reached via a symlinked path
314- Fixed Cmd+click not opening URLs in fullscreen mode in Warp on macOS
315- Fixed double-click word selection in fullscreen mode to select the entire URL including the scheme
316- Fixed plan mode not auto-allowing read-only tool calls when a session starts in plan mode
317- Fixed `/branch` deriving its default fork name from the compaction summary instead of the first real prompt
318- Improved focus mode: subagents launched in a turn now appear in its activity summary, and completed background notifications fold into a single count
319- Improved syntax highlighting accuracy in code blocks, diffs, and file previews by upgrading to highlight.js 11
320- Keyboard shortcut hints now show opt/cmd instead of alt/super when connected from a Mac over SSH
321- Improved API retry UX: the error reason is now shown after the second attempt, and a status page link replaces the spinner tip when the API is overloaded
322- `/login` now opens the sign-in dialog from the `claude agents` view instead of saying it isn't available
323- Subagents now treat messages from the agent that launched them as normal task direction; an agent's message is still never treated as the user's approval
324- Removed the `/agents` wizard; ask Claude to create or manage subagents, or edit `.claude/agents/` directly
325
326## 2.1.197
327
328- Introducing Claude Sonnet 5: now the default model in Claude Code, with a native 1M-token context window and promotional pricing of $2/$10 per Mtok through August 31. Update to version 2.1.197 for access. https://www.anthropic.com/news/claude-sonnet-5
329
330## 2.1.196
331
332- Added support for organization default models — admins set it in the org console; it shows as "Org default" (or "Role default") in `/model` when you haven't picked one yourself
333- Added readable default names for sessions at start, making them easier to identify and message
334- Added clickable file attachments in chat — Cmd/Ctrl-click reveals the file in Finder/Explorer
335- Security: `claude mcp list`/`get` no longer spawn `.mcp.json` servers that a repo self-approved via a committed `.claude/settings.json`; untrusted workspaces show `⏸ Pending approval`
336- Fixed waking a background job permanently deleting its conversation and re-running the original prompt when the transcript probe misread a real transcript; the file is now set aside, never deleted
337- Fixed the rate-limit warning flickering off and rate-limit telemetry being over-counted when multiple parallel requests were in flight at the moment a usage limit was hit
338- Fixed duplicate recap lines after a background session's turn: a schema-rejected StructuredOutput attempt no longer renders alongside its retry
339- Fixed PowerShell `git diff`/`git grep`, `egrep`/`fgrep`, and quoted search patterns containing `|` being reported as failures when they exit 1, matching Bash behavior
340- Fixed multiple `claude agents` side panel issues: keyboard focus getting stuck when opening an agent, background jobs losing their subagent types on every open, and sessions showing incorrect status while actively running
341- Fixed `claude agents --dangerously-skip-permissions` silently falling back to auto mode instead of showing the bypass disclaimer and applying bypass mode to spawned agents
342- Fixed mid-turn crash recovery for Remote sessions — sessions interrupted by a server restart now auto-resume on the next worker
343- Fixed sessions moved with `/cd` reappearing in the old directory's resume list after a non-graceful exit when the old path contained special characters
344- Fixed `claude plugin validate` skipping local plugins whose source is "." and stopping after the first error class
345- Fixed Esc Esc at an idle prompt not opening the rewind menu (regression); use Ctrl+C or Ctrl+X Ctrl+K to stop background agents
346- Fixed MCP OAuth requesting the authorization server's full `scopes_supported` catalog when no scope is specified, causing `invalid_scope` failures on GitLab self-hosted and other enterprise IdPs
347- Fixed `/context` showing 0 tokens for all tool groups on Bedrock
348- Fixed `/deep-research` misreporting verifier failures as "all claims refuted" instead of `unverified`
349- Fixed plugin dependency version pins not being honored when the marketplace was added as a local folder path backed by a git repo
350- Fixed `claude agents` session status: completed rows no longer flip between "Done" and "Needs your input", stalled agents are now labeled "Needs attention", and results that mention a PR show a clickable link
351- Fixed voice dictation swallowing spaces and spuriously starting a recording during very fast typing when voice mode is enabled
352- Improved background session reliability: long-running commands and workflows now survive the session's process being stopped, restarted, or updated — including on Windows, where background shells are handed off instead of being killed
353- Improved background agents: workers killed by a daemon restart are now automatically resumed from where they left off the next time the agents view opens
354- Improved `/code-review` workflow: merged five cleanup finders into one, cutting token usage by roughly 25%
355- Reduced per-frame rendering work in the terminal UI by skipping no-op subtree walks during streaming
356- The streaming idle watchdog is now on by default for all providers — it aborts and retries when a response stream produces no events for 5 minutes. Set `CLAUDE_ENABLE_STREAM_WATCHDOG=0` to disable.
357- Remote Control is now disabled when `ANTHROPIC_BASE_URL` points at a non-Anthropic host, matching the existing behavior under `CLAUDE_CODE_USE_BEDROCK`/`_VERTEX`/`_FOUNDRY`
358- Changed opening the agents view from a foreground session to require a single `←` press instead of two, matching the behavior in background sessions
359
360## 2.1.195
361
362- Added `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` to disable mouse click/drag/hover in fullscreen mode while keeping wheel scroll
363- Fixed hook matchers with hyphenated identifiers (e.g. `code-reviewer`, `mcp__brave-search`) accidentally substring-matching — they now exact-match. Use `mcp__brave-search__.*` to match all tools from a hyphenated MCP server.
364- Fixed voice dictation on macOS capturing silence in long-running sessions after the default input device changes
365- Fixed voice dictation auto-submit never firing for languages written without spaces (Japanese, Chinese, Thai)
366- Fixed external plugins enabled only by project `.claude/settings.json` not requiring explicit install consent on every loader path
367- Fixed `/plugin` Enable/Disable not working when a plugin's `plugin.json` `name` differs from its marketplace entry name
368- Fixed background jobs disappearing from `claude agents` or losing data when written by a newer Claude Code version
369- Fixed reopening a crashed background task showing a blank screen for up to 5 seconds instead of its restart
370- Fixed background agent daemons running unreachable when the control socket fails to start, blocking restarts
371- Improved voice mode on Linux: now distinguishes "no microphone" from "SoX not installed" when SoX is present but no audio capture device exists
372- Improved `claude agents` completed list to fill available vertical space; on short terminals the header compacts so live sessions stay visible
373- Improved Remote session startup with a provisioning checklist while the container starts
374
375## 2.1.193
376
377- Added `autoMode.classifyAllShell` setting to route all Bash/PowerShell commands through the auto-mode classifier instead of only arbitrary-code-execution patterns
378- Added auto-mode denial reasons to the transcript, the denial toast, and `/permissions` recent denials
379- Added `claude_code.assistant_response` OpenTelemetry log event containing the model's response text. Redacted unless `OTEL_LOG_ASSISTANT_RESPONSES=1`; when that var is unset it follows `OTEL_LOG_USER_PROMPTS`, so deployments that already log prompt content will start receiving response content on upgrade — set `OTEL_LOG_ASSISTANT_RESPONSES=0` to keep prompts-only.
380- Added live file path autocomplete to bash mode (`!`)
381- Added a startup notice when MCP servers need authentication, pointing at `/mcp`
382- Added automatic memory-pressure reaping for idle background shell commands (disable with `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1`)
383- Fixed `/model` and other client-data-gated UI showing stale/empty state immediately after `/login`
384- Fixed backgrounding (←←) spuriously cancelling with "N background tasks would be abandoned" when all running tasks carry over to the new session
385- Fixed pinned background agents being re-prompted to "Continue from where you left off" after every auto-update
386- Fixed backgrounding the main turn spawning a phantom "general-purpose (resumed)" subagent that re-ran the main conversation
387- Fixed agent panel hiding sibling agents when viewing a subagent
388- Improved background agents: the launch result no longer instructs Claude to "end your response" — it keeps working on other tasks while the agent runs
389- Improved MCP `headersHelper` auth: the helper now re-runs and reconnects automatically when a tool call returns 401/403
390- Improved plugin auto-rename: marketplace `renames` maps are now followed automatically, updating your settings to the new name
391- Improved `/add-dir` message when the directory is already a working directory
392
393## 2.1.191
394
395- Added `/rewind` support for resuming a conversation from before `/clear` was run
396- Fixed scroll position jumping to the bottom while reading earlier output during a streaming response
397- Fixed background agents resurrecting after being stopped — stopping an agent from the tasks panel is now permanent
398- Fixed `/voice` showing a generic "not available" message when disabled by an organization's policy — it now explains the restriction
399- Fixed `/login` URL opening truncated in Windows Terminal when it wraps across lines
400- Fixed Cmd+click on links in fullscreen mode for Ghostty over ssh/tmux
401- Fixed `claude agents` sending builtin slash commands like `/usage` to background sessions as prompt text instead of showing a hint
402- Fixed `claude agents` job rows showing full filesystem paths for pasted images instead of the `[Image #N]` placeholder
403- Fixed hooks with comma-separated matchers (e.g. `"Bash,PowerShell"`) silently never firing
404- Fixed `/permissions` Recently-denied tab: approving a denial now persists on close instead of being silently discarded
405- Fixed the agent panel jumping by one row when scrolling the roster past the overflow cap
406- Fixed the welcome splash art overflowing the default 80×24 macOS Terminal window
407- Fixed managed settings: `forceRemoteSettingsRefresh` now takes effect when set via MDM or file policy, and the fetch sends `Cache-Control: no-cache` to prevent proxies from serving stale responses
408- Improved sandbox network permission dialog: hosts you allow with "Yes" are now remembered for the rest of the session instead of re-prompting on every connection
409- Improved MCP server reliability: capability discovery (`tools/list`, `prompts/list`, `resources/list`) now retries transient network errors with short backoff
410- Improved MCP OAuth: discovery and token requests now retry once after transient network errors, and headless environments skip the browser popup and go straight to the paste-the-URL prompt
411- Improved MCP error messages: HTTP 404 errors now show the URL and point to your MCP config
412- Improved vim mode prompt-history search (NORMAL `/`) to hint how to reach slash commands
413- Reduced CPU usage during streaming responses by ~37% by coalescing text updates to 100ms
414- Reduced long-session memory growth from terminal output cache
415
416## 2.1.190
417
418- Bug fixes and reliability improvements
419
420## 2.1.187
421
422- Added `sandbox.credentials` setting to block sandboxed commands from reading credential files and secret environment variables
423- Added org-configured model restrictions to the model picker, `--model`, `/model`, and `ANTHROPIC_MODEL`, with a "restricted by your organization's settings" message when a restricted model is selected
424- Added mouse click support to select menus (permission prompts, `/model`, `/config`, etc.) in fullscreen mode
425- Fixed `--resume` failing with "No conversation found" when the original `-p` run produced no model turns
426- Fixed `--json-schema` and workflow `agent({schema})` structured output: the model can no longer re-call `StructuredOutput` indefinitely after a successful call, and follow-up turns now reliably return structured output
427- Fixed remote MCP tool calls that hang with no response for 5 minutes — they now abort with an error instead of blocking indefinitely (override with `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`)
428- Fixed Claude Code Remote sessions taking ~2.7s longer to start after the agent proxy CA system-trust install was added
429- Fixed pasted Korean/CJK text turning into mojibake in terminals that deliver paste as per-byte extended-key events
430- Fixed `/update` over Remote Control hanging when a startup trust dialog would have shown
431- Fixed background jobs in the agents view getting stuck in "working" indefinitely when the agent ended a turn without producing structured output
432- Fixed channel connections dropping after navigating to the agents view and back, and after `/bg`, `/tui`, or `/update`
433- Fixed agent stop notifications not correctly attributing who stopped the agent, and improved wording ("finished"/"stopped" instead of "came to rest")
434- Fixed subagent depth tracking: resumed subagents now restore their original spawn depth, and forked subagents now count toward the depth cap
435- Fixed leaked agent worktree registrations: locked `.git/worktrees/` entries from killed agents are now cleaned up automatically
436- Fixed Cmd+click not opening URLs in fullscreen mode in Ghostty on macOS
437- Fixed `claude --help` not listing the `--bg`/`--background` flag
438- Fixed Esc, Ctrl-C, and Ctrl-D not working while `/share` is uploading
439- Improved `/install-github-app`: GitHub Actions workflow setup is now optional — you can install just the GitHub App and skip the workflow/secret steps
440- Improved `/btw` with ←/→ arrow navigation to step through earlier answers
441- Improved `/plugin` to surface plugins you haven't used recently so you can clean them up
442- [VSCode] Fixed extension becoming unresponsive when resuming a large session
443
444## 2.1.186
445
446- Added `claude mcp login <name>` and `claude mcp logout <name>` to authenticate MCP servers from the CLI without opening the interactive `/mcp` menu, with `--no-browser` stdin redirect support for completing over SSH
447- Added status filtering (press `f`) to the `/workflows` agent detail view
448- Added a "Skills" section to the `/plugin` Installed tab
449- Added `teammateMode: "iterm2"` setting with a warning when auto mode cannot find the `it2` CLI
450- Added "Claude Platform on AWS - refresh credentials" option to `/login` when `awsAuthRefresh` is configured
451- `!` bash commands now trigger Claude to respond to the output automatically; set `"respondToBashCommands": false` in settings.json to keep the previous context-only behavior
452- Fixed streaming requests failing with "Content block not found" or JSON parse errors after the machine wakes from sleep
453- Fixed subagent transcript scroll position bleeding into the main transcript on exit
454- Fixed background task previews flashing raw tool names before the agent's plan loaded
455- Fixed Chrome tab-group isolation not applying when the in-product permissions gate is off for concurrent CLI sessions
456- Fixed background session recaps being duplicated; the agent's own end-of-turn summary now shows as the recap line
457- Fixed opening a background session from `claude agents` leaving the previous screen painted behind it
458- Fixed `Agent(type)` deny rules and `Agent(x,y)` allowed-types restrictions not being enforced for named subagent spawns
459- Fixed Esc and Ctrl+C not responding while background agents are still running after the main turn ends
460- Fixed misaligned option numbers in permission prompts when the option text overflows
461- Fixed pressing `x` on a finished subagent in the agent panel not dismissing it
462- Fixed a misleading "MCP server disconnected" notice for intentionally retired tools when resuming older sessions
463- Fixed `/plugin` Installed showing a "more above" indicator when already scrolled to the top
464- Fixed `~~strikethrough~~` showing literal tildes in assistant messages instead of rendering as strikethrough
465- Fixed `--tools` allowing feature-gated tools to slip through before flags loaded on a cold first launch
466- Fixed background job status in `claude agents` showing a stale "needs input" message after replying
467- Fixed a dark-theme flash when opening a background session from `claude agents` on a light terminal
468- Fixed mouse-selected text staying highlighted after deleting it in `claude agents`
469- Fixed session cost not showing for usage-based Enterprise and Team subscribers
470- Fixed agent teams: teammates spawned via tmux/pane backends now inherit the leader's `--effort` level
471- Fixed Workflow `agent({schema})` subagents looping forever on repeated schema validation failures instead of aborting after 5 attempts
472- Improved `claude mcp get` and `claude mcp remove` to suggest the closest configured server name on a typo and truncate long server lists
473- Improved memory: the agent is now reminded to compact its `MEMORY.md` index when nearing the size limit
474- Improved skill frontmatter: `display-name`, `default-enabled`, `fallback`, and `metadata.*` keys now accept kebab-case, snake_case, and camelCase
475- Improved malformed `SKILL.md` YAML frontmatter handling: loads the skill body with empty metadata instead of failing silently
476- Changed `CLAUDE_CODE_MAX_RETRIES` to cap at 15; for unattended sessions, use `CLAUDE_CODE_RETRY_WATCHDOG` instead
477- Changed background subagents to surface permission prompts in the main session instead of auto-denying; the dialog shows which agent is asking, and Esc denies just that tool
478- Changed `/review <pr>` to use the same review engine as `/code-review medium`
479
480## 2.1.185
481
482- The stream-stall hint now reads "Waiting for API response · will retry in …" instead of "No response from API · Retrying in …", and triggers after 20s of silence instead of 10s
483
484## 2.1.183
485
486- Improved auto mode safety: destructive git commands (`git reset --hard`, `git checkout -- .`, `git clean -fd`, `git stash drop`) are now blocked when you didn't ask to discard local work, `git commit --amend` is blocked when the commit wasn't made by the agent this session, and `terraform destroy`/`pulumi destroy`/`cdk destroy` are blocked unless you asked for the specific stack
487- Added a warning when the requested model is deprecated or automatically updated to a newer model, shown on stderr in print mode (`-p`) and now also covering models set in agent frontmatter
488- Added `attribution.sessionUrl` setting to omit the claude.ai session link from commits and PRs in web and Remote Control sessions
489- Added `/config --help` to list all available shorthand keys for `/config key=value`
490- Changed `/config` toggle behavior: Enter and Space both change the selected setting, and Esc now saves and closes instead of reverting
491- Removed the startup "setup issues" line under the logo — run `/doctor` to see configuration issues or use `--debug`
492- Fixed `thinking.disabled.display: Extra inputs are not permitted` 400 errors on subagent spawns and session-title generation for affected configurations
493- Fixed WebSearch returning empty results in subagents
494- Fixed the terminal cursor being stranded above the prompt after navigating history in vim mode with the native cursor enabled
495- Fixed fullscreen TUI corruption (statusline mid-screen, duplicated spinner rows, merged text) in Windows Terminal under heavy nested-subagent load
496- Fixed turns silently completing with no visible output when the model returned only a thinking block; Claude now re-prompts once
497- Fixed user-level skills appearing multiple times in slash-command autocomplete when multiple plugins are enabled
498- Fixed MCP servers requiring authentication exposing auth-stub tools to the model in headless/SDK mode
499- Fixed tmux teammate panes failing to launch when the shell has slow rc-file initialization, and keystrokes typed during agent spawn leaking into the new tmux pane instead of the leader prompt
500- Fixed background tasks started by a teammate being killed when the teammate finishes a turn
501- Fixed scheduled task and webhook trigger deliveries being treated as keyboard input; they now classify as task notifications and can no longer approve a pending action or set the session title in auto mode
502- Fixed focus mode showing "Ran N PostToolUse hooks" timing lines under each response
503
504## 2.1.181
505
506- Added `/config key=value` syntax to set any setting from the prompt (e.g. `/config thinking=false`) — works in interactive, `-p`, and Remote Control
507- Added `sandbox.allowAppleEvents` opt-in setting that lets sandboxed commands send Apple Events on macOS
508- Added `CLAUDE_CLIENT_PRESENCE_FILE` environment variable: point it at a marker file to suppress mobile push notifications while you're at the machine
509- Upgraded the bundled Bun runtime to 1.4
510- Improved streaming of long paragraphs: text now appears line-by-line instead of waiting for the first line break
511- Improved auto-retry: API connection drops mid-thinking now automatically retry instead of showing "Connection closed while thinking"
512- Improved the subagent panel: idle subagents auto-hide after 30s, the list caps at 5 rows with scroll hints, and keyboard hints now show in the footer
513- Improved the MCP OAuth browser page to match Claude Code's visual style and auto-close on success
514- Changed fullscreen mode URL opening to require Cmd+click (macOS) / Ctrl+click, matching native terminal behavior
515- Changed the `Improved N memories` line to no longer list individual files outside verbose mode
516- Fixed prompt caching not reading on custom `ANTHROPIC_BASE_URL` and on Foundry due to a per-request attestation token changing every turn
517- Fixed Write/Edit producing 0-byte or truncated files on network drives and cloud-synced folders
518- Fixed `open`, `osascript`, and browser-based auth flows failing with error -600 on macOS by adding the Apple Events entitlement
519- Fixed a startup regression (~120ms per launch in fresh environments, introduced in 2.1.169): the first prompt no longer waits for the managed-settings fetch when no MCP servers are configured
520- Fixed startup blocking with a blank terminal for up to 15 seconds when the account settings fetch is slow on a degraded network
521- Fixed startup crash (`TypeError: Cannot read properties of null`) when `.claude.json` contains corrupted null project entries
522- Fixed macOS TUI freezing at session start (Ctrl+C unresponsive) when Spotlight is busy reindexing
523- Fixed long-running idle sessions losing their history when another Claude Code process ran the 30-day transcript cleanup
524- Fixed foreground subagents spawning unbounded nested chains; they now respect the same 5-level depth limit as background subagents
525- Fixed `/recap` and conversation forks using the previous model immediately after a model switch
526- Fixed subagent "Thinking" duration showing the parent agent's elapsed time instead of the subagent's own
527- Fixed subagents blocked on a nested agent showing a ticking elapsed time instead of "waiting" in the agent panel
528- Fixed the API retry indicator ("Retrying in 0s · attempt N/10") staying on screen after the retry succeeded
529- Fixed AWS `awsCredentialExport` credentials with a short remaining lifetime causing credential refreshes every minute, and now accepts the JSON shape from `aws configure export-credentials`
530- Fixed `claude mcp get`/`list` showing `✓ Connected` when tools/list fails; they now show `! Connected · tools fetch failed` with the error detail
531- Fixed `/remote-control` leaving a stale "connecting…" line; it now confirms in the transcript once connected
532- Fixed ExitWorktree refusing to remove a clean worktree with "Could not verify worktree state" when bare `git` cannot be resolved on Windows
533- Fixed settings changes (such as `/effort` or `/model`) failing with ENOENT when `~/.claude/settings.json` is a relative symlink under a symlinked `~/.claude`
534- Fixed IDE selection line numbers in context reminders being off by one (IntelliJ and VS Code)
535- Fixed Ctrl+C in fullscreen after a native terminal selection (modifier+drag) overwriting the clipboard with the app's prior selection
536- Fixed Ctrl+V showing "No image found in clipboard" instead of pasting when the clipboard contains text
537- Fixed agent creation failing with "EEXIST: file already exists" when the agents directory already exists (Windows/OneDrive)
538- Fixed AskUserQuestion preview content being cut off at the dialog edge instead of word-wrapping
539- Fixed AskUserQuestion multi-select questions silently dropping a typed "Other" free-text answer when submitting
540- Fixed `/stats` "Most active day" and daily token chart dates showing one day early in UTC-negative timezones
541- Fixed `/copy` and copy-on-select on Linux not detecting a clipboard utility installed after Claude Code started
542- Fixed tab-indented code rendering with incorrect indentation in the Write (create-file) preview
543- Fixed user prompts queued mid-turn not showing a full-width background highlight in the transcript
544- Fixed the activity spinner's pulse dwelling on the wrong glyph size in Ghostty
545
546## 2.1.179
547
548- Fixed mid-stream connection drops: partial responses are now preserved instead of showing a raw error, and the spinner no longer gets stuck at "running tool"
549- Fixed mouse-wheel scrolling in WSL2 under Windows Terminal and VS Code (regression in 2.1.172)
550- Fixed a sandbox `denyRead`/`allowRead` glob over a large directory tree making the Bash tool description enormous and the session unusable on Linux
551- Fixed the feedback survey capturing a single-digit reply as a session rating immediately after a turn completes
552- Fixed the welcome screen stacking multiple promotional banners — at most one promo now shows per session
553- Fixed Ctrl+O not showing the subagent's transcript when viewing a subagent
554- Fixed clicking the prompt input not returning focus from the subagent/footer panel
555- Fixed remote session background tasks appearing stuck as "still running" between turns
556- Improved plugin loading performance in remote sessions
557
558## 2.1.178
559
560- Agent teams: removed the `TeamCreate` and `TeamDelete` tools. With `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` set, every session now has one implicit team — spawn teammates directly with the Agent tool's `name` parameter, no setup step needed. The `team_name` parameter on the Agent tool is still accepted but ignored.
561- Added `Tool(param:value)` syntax for permission rules to match a tool's input parameters (with `*` wildcard), e.g. `Agent(model:opus)` to block Opus subagents
562- Skills in nested `.claude/skills` directories now load when working on files there; on a name clash, the nested skill appears as `<dir>:<name>` so both stay available
563- Nested `.claude/` directories: the agent, workflow, and output-style closest to the working directory now wins when names collide; project-scope workflow saves now target the closest existing `.claude/workflows/`
564- Improved auto mode: subagent spawns are now evaluated by the classifier before launch, closing a gap where a subagent could request a blocked action without review
565- Improved `/doctor` with consistent flat tree layout across all sections, clearer section status icons, and highlighted command names
566- Improved the skill listing truncation warning to show how many skill descriptions are affected
567- Changed the workflow prompt keyword to use a purple shimmer highlight and trigger only on explicit phrases like "run a workflow" or "workflow:", not on any mention of the word
568- Improved Remote Control error messages: connection failures now show a persistent red "/rc failed" indicator in the footer, and the "not yet enabled" error now explains whether it's a gate, a check failure, stale entitlement, or org policy
569- `/bug` now requires a description before submitting, and no longer uses model-refusal text as the GitHub issue title
570- Fixed a crash (out-of-memory) when the CLI inherits a stale websocket/OAuth file-descriptor environment variable from a parent process
571- Fixed Claude in Chrome silently failing to connect when the OAuth token belongs to a different account than the Claude Code login
572- Fixed nested `.claude/skills` skills with directory-qualified names being blocked by permission prompts in non-interactive runs
573- Fixed several subagent issues: viewing a subagent's transcript now shows tool results and live progress, messages sent while it finishes its turn are no longer dropped, and backgrounding a running subagent (ctrl+b) no longer restarts it from scratch
574- Fixed `claude agents` workers failing with `401 Invalid bearer token` when the daemon was started from a shell with a custom API gateway via `ANTHROPIC_BASE_URL` and `ANTHROPIC_AUTH_TOKEN`
575- Fixed compaction not honoring `--fallback-model`: compaction now falls back to the configured fallback model chain on overload or model-availability errors
576- Fixed model requests continuing to fail with auth errors after credentials were refreshed outside the session, due to a stale cached request configuration
577- Fixed background sessions created with `/bg` or `←←` after a turn finished showing "Working" forever in the agents list
578- Fixed Linux sandbox failing to start when `.claude/skills` or `.claude/hooks` is a symlink
579- Fixed `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` preventing fresh marketplace installs from cloning
580- Fixed MCP server-level specs (`mcp__server`, `mcp__server__*`, `mcp__*`) in subagent `disallowedTools` being silently ignored
581- Fixed vim mode undo: `u` now steps through NORMAL/VISUAL-mode commands one at a time instead of merging commands in quick succession into a single undo step
582- Fixed statusline links with custom URI schemes (e.g. `vscode://`) not opening when clicked in `claude agents`
583- [VSCode] Fixed pressing Esc to dismiss a CJK IME candidate window canceling the running Claude task
584
585## 2.1.176
586
587- Session titles are now generated in the language of your conversation (set the `language` setting to pin a specific language)
588- Added `footerLinksRegexes` setting for regex-matched link badges in the footer row, configurable via user or managed settings
589- Improved Bedrock credential caching: credentials from `awsCredentialExport` are now cached until their `Expiration` instead of a fixed 1 hour
590- Fixed `availableModels` enforcement: alias model picks can no longer be redirected to a blocked model via `ANTHROPIC_DEFAULT_*_MODEL` environment variables, and `/fast` now refuses to toggle when it would switch to a model outside the allowlist
591- Fixed auto mode failing on Fable 5 for organizations without Opus 4.8 enabled — the classifier now falls back to the best available Opus model
592- Fixed hook `if` conditions for Read/Edit/Write tool paths: documented patterns like `Edit(src/**)`, `Read(~/.ssh/**)`, and `Read(.env)` now match correctly
593- Fixed Linux sandbox failing to start when `.claude/settings.json` is a symlink with an absolute target
594- Fixed `/copy` and mouse-selection copy not reaching the system clipboard inside tmux over SSH, and tmux paste buffer not loading on versions older than 3.2
595- Fixed Remote Control connecting from web/mobile silently switching the session's model
596- Fixed Remote Control disconnect notifications showing a bare numeric code instead of a human-readable reason, and connection failures adding a duplicate line to the conversation transcript
597- Fixed Remote Control sessions not disconnecting when you sign in to a different account
598- Fixed `/cd` and worktree moves leaving the session reporting the previous directory's git branch
599- Fixed `claude agents`: pressing back in one window no longer detaches other windows attached to the same session
600- Fixed backgrounded sessions showing "Working" forever when `/bg` mid-turn had nothing left to continue
601- Fixed background agent search by PR URL: PRs opened during scheduled wakeups or while a job was blocked now appear in `claude agents` search
602- Fixed the agents view input showing no text cursor on Windows
603- Fixed `claude --bg -cn <name>` not seeding the session name
604- Fixed background sessions to neutralize Windows network paths in persisted state before respawn
605- Fixed background-session respawn rejecting malformed resume IDs from corrupted state files
606- Fixed the Windows background-service daemon not starting when `~/.claude/daemon` has the ReadOnly attribute set
607- Fixed cloud sessions failing with "Could not resolve authentication method" when idle for too long before being claimed
608- Background sessions now show clearer guidance when a window left open across an auto-update can't submit a reply, and `claude daemon status` explains version-skew behavior
609
610## 2.1.175
611
612- Added `enforceAvailableModels` managed setting — when enabled, the `availableModels` allowlist also constrains the Default model (a Default that would resolve to a disallowed model now falls back to the first allowed model), and user or project settings can no longer widen a managed `availableModels` list
613
614## 2.1.174
615
616- Added `wheelScrollAccelerationEnabled` setting to disable mouse-wheel scroll acceleration in fullscreen mode
617- Fixed the `/model` picker hiding the model family that Default resolves to — Opus now appears as its own row on Max/Team Premium/Enterprise plans, Sonnet on Pro/Team plans, and Opus on pay-as-you-go API accounts
618- Fixed `/model` picker showing a hardcoded Sonnet version label when `ANTHROPIC_DEFAULT_SONNET_MODEL` pins a different Sonnet
619- Fixed the "Fable 5 is now consuming usage credits" banner incorrectly showing for enterprise accounts with usage-based billing
620- Fixed Bedrock GovCloud regions (`us-gov-*`) deriving the wrong inference profile prefix (`global` instead of `us-gov`), causing 400 errors on derived model IDs
621- Fixed background sessions inheriting another session's `ANTHROPIC_*` provider env (gateway URL, custom headers, `/model` aliases) from the shell that started the background daemon
622- Fixed a 1-2 second pause when exiting Claude Code shortly after a shell command was interrupted or killed on macOS and Linux
623- Fixed git commit co-author attribution showing an incorrect model name for some models
624- Fixed the `/advisor` dialog pre-selecting a saved advisor model that is blocked by the `availableModels` allowlist
625- Fixed skill hot-reload re-sending the entire skill listing when a single skill changed; only changed skills are now re-announced
626- Fixed Workflow tool `agent()` subagents missing per-agent attribution headers
627- [VSCode] Added usage attribution to the Account & usage dialog (`/usage`) showing cache misses, long context, subagents, and per-skill/agent/plugin/MCP breakdowns over the last 24h or 7d
628- Fixed pre-warmed background workers failing with "Could not resolve authentication method" when claimed after sitting idle
629
630## 2.1.173
631
632- Fixed Fable 5 model names with a `[1m]` suffix not being normalized — Fable 5 includes 1M context by default, so the suffix is now stripped automatically
633- Fixed a spurious "sandbox dependencies missing" startup warning on Windows when sandbox was enabled in settings
634
635## 2.1.172
636
637- Sub-agents can now spawn their own sub-agents (up to 5 levels deep)
638- Amazon Bedrock now reads the AWS region from `~/.aws` config files when `AWS_REGION` isn't set, matching AWS SDK precedence; `/status` shows where the region came from
639- Added a search bar when browsing a marketplace's plugins in `/plugin`
640- Added `model` attribute to the `claude_code.lines_of_code.count` OTEL metric
641- Fixed sessions using 1M context without usage credits getting permanently stuck — the session now automatically compacts back under the standard context limit
642- Fixed a repeating "an image in the conversation could not be processed and was removed" error when the conversation contained multiple images
643- Fixed the agents view keeping a session under Working with a busy spinner for up to 30 seconds after the worker replied
644- Fixed background agents potentially reading another directory's project settings (`.mcp.json` approvals, trust) when dispatched onto a pre-warmed worker
645- Fixed background-session attach failing with EAUTH for sessions started on an older version after the daemon auto-updated
646- Fixed a background sub-agent staying stuck as "active" in the agent panel after a nested agent it spawned was stopped
647- Fixed `/model` suggestions in the `claude agents` dispatch input rendering with a misleading slash prefix and showing models disabled for your org
648- Fixed `availableModels` restrictions not being applied to subagent model overrides, the agent dispatch model picker, and the advisor model
649- Fixed `availableModels` allowlists hiding the `/model` picker's Opus and Sonnet 1M rows when entries use version-specific IDs like `claude-opus-4-8`
650- Fixed the `/model` picker on Bedrock offering models the provider doesn't serve — selecting one silently switched the session model and lit the selection marker on multiple rows
651- Fixed model IDs getting a doubled 1M-context suffix (e.g. `[1M][1m]`) when `ANTHROPIC_DEFAULT_OPUS_MODEL` already includes one
652- Fixed `opusplan` model setting not shipping with 1M context in plan mode for entitled users; the `opusplan[1m]` workaround now also correctly switches to Opus in plan mode
653- Fixed `WebFetch(domain:*.example.com)` wildcard domain rules never matching subdomains in allow, deny, and ask position, and file permission rules with mid-pattern wildcards (e.g. `Read(secrets-*/config.json)`) being rejected at startup
654- Fixed up-arrow prompt history showing the main agent's prompts while a subagent's chat tab is open
655- Fixed memory recall not finding mounted team memory stores (`CLAUDE_MEMORY_STORES`) in remote sessions
656- Fixed workflow validation rejecting scripts whose prompt strings or comments merely mention `Date.now()`/`Math.random()`
657- Disable mouse tracking on Windows consoles that don't fully support it
658- Fixed the `/plugin` marketplace list losing its cursor after backing out of a long plugin list, and Esc from the plugin browser returning to the wrong tab
659- Improved performance in long conversations by removing redundant message normalization and avoiding full message-history transforms when streaming tool-use state is unchanged
660- Reduced idle CPU usage: `/goal` status chip no longer re-renders the terminal at 5 Hz while idle, and fewer UI re-renders while subagents run in parallel
661- Improved Claude in Chrome tool loading: browser tools now load in a single batched call instead of one per tool
662- Improved the non-interactive Usage Policy refusal message to suggest starting a new session or changing your model
663- `/code-review` now keeps the `ultra` option visible when you're not signed in to claude.ai, with an explanation that the cloud review requires a claude.ai account
664- Shortened the Remote Control footer indicator to "/rc active" and hid it on narrow terminals
665- Stopped promoting `/loop` in remote sessions, where pending loops don't keep the container alive
666- [VSCode] Fixed PowerShell tool calls rendering as raw JSON instead of a proper command display and permission dialog, and stripped ANSI escape codes from displayed shell output
667
668## 2.1.170
669
670- Introducing Claude Fable 5: a Mythos-class model that we’ve made safe for general use. Fable’s capabilities exceed those of any model we’ve ever made generally available. Update to version 2.1.170 for access. https://www.anthropic.com/news/claude-fable-5-mythos-5
671- Fixed sessions not saving transcripts (and not appearing in --resume) when launched from the VS Code integrated terminal or any shell that inherited Claude Code environment variables.
672
673## 2.1.169
674
675- Self-hosted runner: added a `post-session` lifecycle hook that runs after the session ends and before the workspace is deleted, so you can snapshot uncommitted work or export logs; also made the child-process SIGTERM→SIGKILL window configurable (default unchanged at 5s)
676- Added `--safe-mode` flag (and `CLAUDE_CODE_SAFE_MODE`) to start Claude Code with all customizations (CLAUDE.md, plugins, skills, hooks, MCP servers) disabled for troubleshooting
677- Added `/cd` command to move a session to a new working directory without breaking the prompt cache mid-session
678- Added a `disableBundledSkills` setting and `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` environment variable to hide bundled skills, workflows, and built-in slash commands from the model
679- Fixed Up/Down arrows jumping to command history past the wrapped rows of a long input line — they now move through each visual row first, and history recall enters at the near edge
680- Fixed enterprise managed MCP policies (`allowedMcpServers`/`deniedMcpServers`) not being enforced on reconnect, IDE-typed configs, `--mcp-config` servers during the first session after install, or before remote settings loaded; also fixed slow cold starts for orgs without remote settings
681- Fixed a ~30-50ms UI stall at the start of each turn for macOS users logged in with claude.ai credentials
682- Fixed `claude -p` being slow or appearing to hang on Windows while waiting for the slash-command/skill scan (regression in 2.1.161)
683- Fixed Remote Control getting stuck on "reconnecting" after resuming a session when an OAuth token refresh happened at the same time
684- Fixed Git Credential Manager's "Connect to GitHub" popup appearing on Windows at startup when background git commands ran without cached credentials
685- Fixed footer hints (e.g. "esc to interrupt") not showing for users with a custom statusline
686- Fixed stale permission and dialog prompts reappearing every time you reattached to a remote session whose worker had died while waiting on them
687- Fixed `claude agents --json` omitting blocked and just-dispatched background sessions; added `--all` to include completed sessions, plus new `id` and `state` fields
688- Fixed agents view leaving a stale/garbled frame after navigating back from an agent on WSL in Windows Terminal
689- Fixed background agents ignoring project-level settings `env` values (e.g. `ANTHROPIC_MODEL`) when dispatched onto a pre-warmed worker
690- Fixed MCPB plugin cache being spuriously invalidated on Windows, causing unnecessary re-extraction
691- Fixed plugin `.in_use` PID lock files accumulating without bound; stale markers from crashed sessions are now swept once per day
692- Fixed untrusted project settings being able to set OTEL client-certificate paths without trust confirmation
693- `/workflows` now opens immediately even while a turn is in progress
694- Improved `TaskCreate` reliability: malformed inputs are repaired automatically and validation errors for unloaded tools include the schema
695- Improved the error message shown when your organization has disabled API key authentication, with guidance based on where the active API key comes from
696- Reduced CPU usage while responses stream and during spinner animations
697- Restored a default 5-minute idle timeout on Vertex/Foundry so a stalled stream aborts instead of hanging indefinitely; set `API_FORCE_IDLE_TIMEOUT=0` to opt out
698- Remote-managed settings with an invalid entry now apply their remaining valid policies and surface the validation error, instead of silently dropping the whole payload
699- Background sessions now preserve `--ide`, `--chrome`, `--bare`, `--remote-control`, and other flags across retire→wake, and respawn state validation was hardened
700- Background sessions are now told that shared-checkout edits are blocked until they enter a worktree, avoiding a wasted rejected edit before `EnterWorktree`
701- The "CLAUDE.md is too long" warning threshold now scales with the model's context window
702- Auto-updater on Windows now stops retrying within a session once `claude.exe` is held by another process
703- Improved color contrast for skill tags in the slash-command menu
704- Promo credit claims for Apple/Google-billed subscribers without a payment method now explain where to add one
705- Added a tip suggesting `claude agents` when running multiple concurrent sessions
706
707## 2.1.168
708
709- Bug fixes and reliability improvements
710
711## 2.1.167
712
713- Bug fixes and reliability improvements
714
715## 2.1.166
716
717- Added `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
718- Added 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
719- Hardened 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
720- `MAX_THINKING_TOKENS=0`, `--thinking disabled`, and the per-model thinking toggle now disable thinking on models that think by default via the Claude API (3P providers unchanged)
721- Claude Code now 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
722- `claude update` now announces the target version before downloading instead of going silent
723- `claude agents`: typing a URL into the list now filters to the session whose first prompt contained it
724- Fixed a recurring "image could not be processed" error and extra token usage when an unprocessable image was sent in a session
725- Fixed remote sessions becoming permanently stuck when a brief backend disruption occurred during worker registration at startup
726- Fixed flickering in JetBrains IDE terminals (IntelliJ, PyCharm, WebStorm, etc.) on 2026.1+ by enabling synchronized output
727- Fixed Shift+non-ASCII characters (e.g. Shift+ä → Ä) being dropped in terminals using the Kitty keyboard protocol (WezTerm, Ghostty, kitty)
728- Fixed PowerShell command validation occasionally hanging far past its time budget on Windows when a killed process's children held its output pipes
729- Fixed orphaned `claude --bg-pty-host` processes spinning at 100% CPU after the daemon dies while connected on macOS
730- Fixed voice mode requiring `/login` to clear a stale auth check after toggling `/voice`
731- Fixed managed settings with an invalid entry silently disabling enforcement of their remaining valid policies
732- Fixed managed-settings `allowedMcpServers`/`deniedMcpServers` predicates not matching when they use `${VAR}` references
733- Fixed background agent sessions that entered a git worktree crash-looping with "No conversation found" when reopened from `claude agents`
734- Fixed duplicated thinking text in the Ctrl+O transcript view while streaming
735- Fixed `/doctor` showing a contradictory failed "Not inside a remote session" check when run inside a remote session
736- Fixed the cursor sticking at the end of the first line when typing a multiline prompt in the `claude agents` dispatch and reply inputs
737- Fixed blank lines appearing between background agent rows in the task list on terminals without Unicode support
738
739## 2.1.165
740
741- Bug fixes and reliability improvements
742
743## 2.1.163
744
745- Added `requiredMinimumVersion` and `requiredMaximumVersion` managed settings — Claude Code refuses to start if its version is outside the allowed range and directs the user to an approved version
746- Added `/plugin list` command to list installed plugins, with `--enabled`/`--disabled` filters
747- Added a "c to copy" shortcut to `/btw` that copies the raw markdown answer to the clipboard, preserving formatting when pasted elsewhere
748- Hooks: Stop and SubagentStop hooks can now return `hookSpecificOutput.additionalContext` to give Claude feedback and keep the turn going without being labeled a hook error
749- Skills: added `\$` escape syntax to include a literal `$` before a digit in command bodies
750- stdio MCP servers now receive the same `CLAUDE_CODE_SESSION_ID` as hooks/Bash on `--resume`
751- Fixed `claude -p` hanging forever after its final result when a backgrounded command never exits — background shells are now stopped ~5s after the result once stdin closes
752- Fixed `claude -p` failing with "ANTHROPIC_API_KEY required" on Bedrock/Vertex/Foundry when `CI=true` and no Anthropic API key is set
753- Fixed bash commands failing under bazel and EDR-protected Go workflows: `$TMPDIR` was overridden to `/tmp/claude-{uid}` for all commands instead of only sandboxed ones (regression in 2.1.154)
754- Fixed Bash commands failing on Windows with "EEXIST: file already exists" on the session-env directory when it has the read-only attribute or is inside OneDrive
755- Fixed org-managed permission rules not applying for the entire session when the managed settings fetch completed during startup on a fresh config directory
756- Fixed background sessions in `claude agents` losing their running background tasks when reattached after a Claude Code update
757- Fixed terminal misalignment and a multi-second hang when exiting the agent view by pressing Esc
758- Fixed clicking Stop on a background-task chip in the desktop app not clearing the chip when the underlying process was already gone
759- Fixed keyboard input becoming permanently unresponsive after a paste operation whose end marker is dropped by the terminal
760- Fixed hook `if: "Bash(...)"` conditions firing on every Bash command containing `$()` or `$VAR`; the pattern now matches against commands inside subshells and backticks too
761- Fixed deny rules on home-directory paths (e.g. `Read(~/Desktop/**)`) not blocking Bash commands that reference the path via `$HOME`
762- Fixed a stray "(no content)" line left in the transcript after closing panel dialogs like /mcp and /plugins
763- Background agent sessions now update to a new Claude Code version in the background, so opening a session after an update no longer waits on a cold restart
764- Clearer descriptions for built-in commands and skills in the / menu
765- The subscription-switch suggestion now shows in the startup announcement slot instead of a toast
766- `claude agents` dispatching from the state-grouped view now starts the session in the directory the agent view was opened from
767
768## 2.1.162
769
770- `claude agents --json` now includes `waitingFor` showing what a waiting session is blocked on (e.g. permission prompt)
771- `--tools`: explicitly listing Grep/Glob now provides the dedicated search tools on native builds with embedded search (previously these names were silently ignored)
772- `/effort` now confirms when your chosen level will persist as the default for new sessions
773- Clicking a slash command in the autocomplete menu now fills it into your prompt instead of running it immediately; press Enter to run
774- Remote Control now shows as a persistent footer pill (with a link to the session) instead of a startup message
775- Renamed Windsurf to Devin Desktop in the `/ide` menu, `/terminal-setup`, and `/scroll-speed`, following the editor's rebrand
776- Fixed a silent startup hang when the config directory is read-only or unwritable — Claude Code now starts with in-memory config and surfaces startup errors instead of showing a blank screen
777- Fixed WebFetch permission rules not being applied to built-in preapproved domains; explicit `WebFetch(domain:...)` deny/ask/allow rules now take precedence over the preapproved-host auto-allow
778- Fixed Windows permission rules never matching when spelled with backslashes (`~\`, `\\server\share`) or case-variant paths, and Read deny rules not hiding files from Glob/Grep results
779- Fixed an interrupt (Esc) sent at the very start of a turn being silently dropped in stream-json/SDK sessions, leaving the turn running with no "Interrupted" feedback
780- Fixed API 400 `no low surrogate in string` errors for classifier side-queries and MCP server descriptions containing emoji near a truncation boundary
781- Fixed MCP per-server `timeout` config values below 1000 ms being floored to a 1-second watchdog that aborted every tool call; sub-1000 ms values are now ignored (falling back to `MCP_TOOL_TIMEOUT` or default), and `claude mcp get` annotates them accordingly
782- Fixed the LSP tool's `workspaceSymbol` operation returning no results; it now accepts a `query` parameter and passes it to the language server
783- Fixed `claude agents` cutting live status text (tool args, replies, prompts, exec output) at 60–120 columns on wide terminals; the status detail now uses the full terminal width
784- Fixed `claude agents` truncating long session names at 40 columns; the name column now grows with terminal width
785- Fixed `claude agents` attach occasionally bouncing straight back to the session list on the first try after a background-service restart
786- Fixed `claude agents` Ctrl+V image paste doing nothing in the dispatch input and the session reply box; pasting with no image now shows a hint
787- Fixed backgrounding a session with ← silently losing the conversation when the background service cannot start; the session stays in the list as a failed row you can wake with Enter
788- Fixed replies from the agents view that fail to send being lost; they are now queued for delivery on the next session start
789- Fixed cross-session messaging (`SendMessage`) silently breaking when `CLAUDE_CODE_TMPDIR` or `$TMPDIR` points at a deep directory
790- Fixed opening a running background session from `claude agents` stalling for 5 seconds before attaching
791- Quieter startup: notices group by severity, and session info and announcements share a single line per launch
792- Startup warnings rewritten to be shorter and clearer, each with a concrete fix
793- Launch-prompt warnings (deep link/pre-filled prompt) now stay pinned below the input until you act instead of scrolling away
794- Failed turns now show a compact warning line instead of a multi-line red error block
795- Improved background service startup and `claude update` verification to wait out endpoint-security scanning of new binaries instead of failing after 5 seconds
796- Background dispatch spawn failures now report the error class name when no errno is available
797- Removed the "Claude in Chrome enabled" and "marketplace installed" startup messages; model auto-updates and the team-onboarding tip now show as quiet notices under the logo
798
799## 2.1.161
800
801- `OTEL_RESOURCE_ATTRIBUTES` values are now included as labels on metric datapoints, so you can slice usage metrics by custom dimensions like team or repo
802- `claude agents` rows now show `done/total` before the detail when work is fanned out; peek shows the longest-running item
803- `/mcp` now collapses claude.ai connectors you've never signed in to behind a "Show unused connectors" row
804- Parallel tool calls: a failed Bash command no longer cancels other calls in the same batch — each tool returns its own result independently
805- Fullscreen mode: clipboard now uses `wl-copy`/`xclip`/`xsel` on Linux when available, copies to both the clipboard and PRIMARY selection for middle-click paste, and the "hold {key} for native selection" hint now shows the correct key per terminal
806- Fixed the `/effort` dialog, workflow animations, and prompt keyword shimmer not honoring the "Reduce motion" setting
807- Fixed `forceLoginOrgUUID`/`forceLoginMethod` managed-settings policies blocking third-party provider sessions (Bedrock, Vertex, Foundry, Mantle) alongside the org pin (regression in 2.1.146)
808- Fixed background subagent output corrupting `claude -p` stdout when using `--output-format text` or `json`
809- Fixed `/usage-credits` starting a re-login for Team and Enterprise admins instead of pointing to the organization's usage settings page
810- Fixed `/autofix-pr` reporting "cannot run on the default branch" when the session is inside a git worktree or another repository
811- Fixed `--resume` picker not showing sessions from the current directory when it isn't a git worktree (e.g., jj workspaces)
812- Fixed Windows hooks that invoke bash explicitly (e.g., `/usr/bin/bash script.sh`) failing with "command not found" or "cannot execute binary file"
813- Fixed OpenTelemetry log events (`user_prompt`, `api_request`, `tool_result`, `tool_decision`) being silently dropped when emitted before telemetry initialization completed
814- Fixed `claude mcp` list/get/add printing secrets to the terminal: `${VAR}` references are no longer expanded, and credential headers and URL secrets are redacted
815- Fixed Workflow agents spawned with `isolation: "worktree"` in background sessions being blocked from editing files inside their own worktree
816- Fixed background sessions dispatched from `claude agents` booting on a stale model from the daemon's environment instead of the model in `settings.json`
817- Fixed a potential crash when rendering Write tool results after resuming a session
818- Fixed completed subagents getting stuck showing as running when an error occurs while finalizing their result
819- Fixed `EADDRINUSE` errors from tools that bind Unix sockets under `$TMPDIR` when `CLAUDE_CODE_TMPDIR` is set to a deep path
820- Improved terminal rendering performance by stabilizing the layout engine's JIT compilation profile
821- Improved rendering performance for large file writes
822- [VSCode] Added a tip suggesting disabling terminal GPU acceleration (or running `/terminal-setup`) to fix garbled glyphs
823
824## 2.1.160
825
826- Added a prompt before writing to shell startup files (`.zshenv`, `.zlogin`, `.bash_login`) and `~/.config/git/`, which could otherwise lead to unintended command execution
827- `acceptEdits` mode now prompts before writing build-tool config files that grant code execution (`.npmrc`, `.yarnrc*`, `bunfig.toml`, `.bazelrc`, `.pre-commit-config.yaml`, `.devcontainer/`, etc.)
828- Edit no longer requires a separate Read after viewing a file with `grep`: single-file `grep`/`egrep`/`fgrep` commands now satisfy the read-before-edit check
829- Fixed copy-on-select not writing to the Windows clipboard on WSL — now uses PowerShell interop instead of OSC 52, which terminals like MobaXterm don't support
830- Fixed restoring a completed session from `claude agents` dropping chat history and re-running the original prompt
831- Fixed background sessions re-attached after overnight retire losing their conversation and re-running the original prompt
832- Fixed `claude --bg` occasionally failing with "socket missing" when the background daemon was cold-starting on a loaded machine
833- Fixed an issue on Windows where the directory a background session was started in could not be deleted after `claude rm` until the background daemon exited
834- Fixed background agents that resumed work being shown under Completed in the agents list
835- Fixed `claude agents` freezing for several seconds when returning to the session list due to the auto-updater re-checking on every exit
836- Fixed Esc, arrow keys, and typing becoming unresponsive on Windows when attached to a background session or in the agent view while the host is under heavy CPU load
837- Fixed background agents emitting terminal sync-output markers to terminals that don't support them (Apple Terminal, tmux), causing render artifacts when entering a running agent
838- Fixed mouse wheel scrolling prompt history instead of the transcript right after opening a session from the agents list
839- Fixed CJK IME composition appearing at the bottom-left of the screen instead of at the input caret in the `claude agents` view
840- Fixed valid `file:///C:/...` links being rewritten to a broken path on Windows terminals with hyperlink support
841- Fixed voice mode failing to connect when the project directory or branch name contains non-ASCII or special characters
842- Fixed the auto mode unavailability message on third-party providers (Bedrock/Vertex/Foundry) to point to the `CLAUDE_CODE_ENABLE_AUTO_MODE` opt-in instead of incorrectly blaming the model
843- Fixed `/effort ultracode` incorrectly blaming the dynamic workflows setting when the model cannot run xhigh; ultracode is no longer offered on models that do not support it
844- Fixed model-not-found errors suggesting `--model` when running via the SDK or other hosts where the CLI flag doesn't apply
845- Fixed Claude's past replies disappearing from scrollback when resuming a brief mode session with brief mode turned off
846- Fixed vim mode `p` pasting on the line below instead of at the cursor when the register was yanked with `v$`
847- Improved performance of opening recently-inactive background agent sessions in `claude agents`
848- Improved auto mode classifier latency by reducing reasoning on routine actions, lowering the chance of "could not evaluate this action" blocks
849- Improved background-session teardown (`claude rm`/`stop`, idle reap) to send SIGTERM to running shell subprocesses before SIGKILL, so cleanup handlers run
850- Removed `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE`; the environment variable is now a no-op
851- Removed the JetBrains plugin install suggestion from startup
852- Renamed the dynamic-workflow trigger keyword from `workflow` to `ultracode`. The word "workflow" no longer triggers a run; asking for one in your own words still works. The trigger keyword is highlighted in violet in the prompt input
853
854## 2.1.159
855
856- Internal infrastructure improvements (no user-facing changes)
857
858## 2.1.158
859
860- Auto mode is now available on Bedrock, Vertex, and Foundry for Opus 4.7 and Opus 4.8. Opt in by setting `CLAUDE_CODE_ENABLE_AUTO_MODE=1`
861
862## 2.1.157
863
864- Plugins in `.claude/skills` directories are now automatically loaded, no marketplace required
865- Added `claude plugin init <name>` to scaffold a new plugin in `.claude/skills`
866- Added autocomplete for `/plugin` arguments: subcommands, installed plugin names, and plugins from known marketplaces
867- `claude agents`: the `agent` field in `settings.json` is now honored for dispatched sessions, with `--agent <name>` to override it
868- `EnterWorktree` can now switch between Claude-managed worktrees mid-session
869- `tool_decision` telemetry events now include `tool_parameters` (bash commands, MCP/skill names) when `OTEL_LOG_TOOL_DETAILS=1`
870- Worktrees managed by Claude are now left unlocked when the agent finishes, so `git worktree remove`/`prune` can clean them up
871- Fixed unprocessable images (zero-byte, corrupt) attached via paste, MCP, or dialog crashing the request instead of becoming a text placeholder
872- Fixed sandbox network permission prompts appearing in auto and bypass-permissions mode when using the desktop app, IDE extensions, or SDK
873- Fixed `claude agents` completed sessions not retiring when an idle subagent was still parked or had leaked a backgrounded shell
874- Fixed `claude agents` pressing Esc not cancelling a slow "opening…", leaving the list unresponsive
875- Fixed background agent worktrees under `.claude/worktrees/` being orphaned after the 30-day job retention sweep
876- Fixed background sessions re-attached after a sleep/wake not telling the model the correct date
877- Fixed copy-on-select in `claude agents` not reaching the system clipboard inside tmux with `set-clipboard on` (regression in 2.1.153)
878- Fixed `--resume` not reporting background subagents that were running when the previous Claude Code process exited
879- Fixed the `--resume` session picker leaving its contents on the terminal after exiting in fullscreen mode
880- Fixed `--worktree` and `--worktree --tmux` returning to the canonical repo root instead of the current linked worktree
881- Fixed the `/model` picker showing an incorrect "Newer version available" hint when the selected model is already the newest in its family; the pinned-model row now shows the model's description instead of its raw ID
882- Fixed literal markdown markers (backticks, asterisks) appearing in the in-progress message text in fullscreen mode
883- Fixed the terminal freezing after approving the managed-settings security dialog at startup
884- Fixed a rare duplicate line appearing in scrollback after the terminal UI redraws
885- Fixed right-click paste duplicating the clipboard in the VS Code, Cursor, and Windsurf integrated terminals
886- WSL: fixed image paste (`alt+v` keybinding), screenshot paste on Windows 11, and added support for dragging images from Windows Explorer
887- Improved performance of long and resumed conversations by eliminating redundant message-rendering recomputations
888- `/terminal-setup` now disables GPU acceleration in VS Code/Cursor/Windsurf integrated terminals to prevent garbled-text rendering
889- The Feature of the Week credit-claim status now appears as a notification in the status area instead of a line above the prompt
890- `claude agents`: slash-command autocomplete in the dispatch input now matches substrings
891- Removed the "bash commands will be sandboxed" startup banner — sandbox status still shows in `/status` and when a command is blocked
892- Removed the "/ide for …" startup hint toast
893- [IDE] Fixed clicking Stop while a background subagent is running not actually stopping it
894- [VSCode] Fixed the fast mode indicator not appearing on Opus 4.8
895- Pressing backspace right after a workflow trigger keyword now dismisses the workflow request (same as alt+w) instead of deleting a character
896- Added a "Workflow keyword trigger" setting in /config to stop the word "workflow" in a prompt from triggering a dynamic workflow
897
898## 2.1.156
899
900- Fixed an issue when using Opus 4.8 where thinking blocks were modified, leading to API errors.
901
902## 2.1.154
903
904- Opus 4.8 is here! Now defaults to high effort · /effort xhigh for your hardest tasks
905- Introducing dynamic workflows: ask Claude to create a workflow and it orchestrates work across tens to hundreds of agents in the background, so you can take on larger, more complex tasks. Run `/workflows` to view your runs
906- Fast mode on Opus 4.8 is now available at a fraction of its previous cost: 2x the standard rate for 2.5x the speed
907- The lean system prompt is now the default for all models except Haiku, Sonnet, and Opus 4.7 and earlier
908- Claude now reserves the multiple-choice question prompt for decisions it genuinely cannot make itself, instead of asking when it already has enough context to proceed
909- `/simplify` now runs a cleanup-only review (reuse, simplification, efficiency, altitude) and applies the fixes, instead of running the full `/code-review --fix` bug-hunting review
910- Renamed the `/effort` slider labels from "Speed"/"Intelligence" to "Faster"/"Smarter" for clarity
911- `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>'`
912- `claude agents`: `/logout` now signs you out instead of being sent to a background session
913- `←←` to open the agents view now works on Bedrock, Vertex, Foundry, and with telemetry disabled
914- Claude in Chrome: pick which connected browser to use via `/chrome` → "Select browser…", or in-chat when a browser action runs with multiple connected
915- Plugins can now declare `defaultEnabled: false` in `plugin.json` or a marketplace entry; enable them with `/plugin` or `claude plugin enable`. Dependencies of enabled plugins are still enabled automatically
916- The `/plugin` Discover tab now pins plugins whose relevance signals match the current directory with a "suggested for this directory" annotation
917- Streaming tool execution is now always enabled, including when telemetry is disabled or on Bedrock/Vertex/Foundry (previously behind a feature flag)
918- Stdio MCP server subprocesses now receive `CLAUDE_CODE_SESSION_ID` and `CLAUDECODE=1` in their environment
919- `claude mcp list`/`get` now show unapproved `.mcp.json` servers as `⏸ Pending approval` instead of auto-approving and connecting when output is piped
920- `/remote-control` autocomplete now shows "Disconnect Remote Control" when Remote Control is already active
921- Added Claude Opus 4.8 support and 4.7 → 4.8 migration guidance to the `/claude-api` skill
922- Deprecated `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` (will be removed on 06/01). To use fast mode on Opus 4.6, switch with `/model claude-opus-4-6[1m]` and then `/fast on`
923- Improved the auto-mode classifier's detection of data exfiltration, particularly bulk transfers of repository contents
924- Fixed `rm -rf $HOME` not being blocked as a dangerous path when `HOME` has a trailing slash
925- Fixed `$TMPDIR` resolving to different directories in sandboxed vs unsandboxed Bash commands within the same session
926- Fixed unreadable highlighted-row text in `claude agents` when the Claude Code theme doesn't match the terminal background
927- Fixed background-agent completion notifications triggering premature "out of context" behavior on some 1M-context models
928- Fixed background-session classifier losing the user's goal when a scheduled `/command` fires
929- Fixed pinned background sessions respawning every minute after a Claude Code update, causing repeated agent-start notifications and process churn at idle
930- Fixed background sessions stuck at "blocked", "running", or "working" not retiring after the idle grace period
931- Fixed subagents in background sessions bypassing the worktree-isolation guard and writing to the shared checkout
932- Fixed orphaned `claude --bg-pty-host` processes spinning at 100% CPU after the daemon exits on macOS
933- Fixed number key shortcuts not working for options shown below the divider in option dialogs
934- Fixed `worktree.baseRef: "head"` resolving to the main checkout's HEAD instead of the current worktree's HEAD when spawning subagents or calling `EnterWorktree` from inside a linked worktree
935- Fixed a stray leading space on wrapped lines when the previous line ended exactly at the terminal width
936- Fixed intermittent terminal rendering corruption in VS Code by capping the number of distinct colors the thinking spinner produces
937- Fixed plan file names including `[Image #N]` / `[Pasted text #N]` placeholders when a plan-mode prompt starts with pasted images or text
938- Fixed a phantom expand/click affordance on colored tool output: short ANSI-colored lines that fit on screen no longer show a "ctrl+o to expand" hint
939- Fixed a single invalid `allowedMcpServers`/`deniedMcpServers` entry in managed settings discarding all managed-settings policy; the bad entry is now dropped with a `claude doctor` warning
940- Fixed API 400 errors on models that don't support the effort parameter when `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` is set
941- Windows: Fixed update failures caused by `claude.exe` being in use showing a generic error instead of telling you to close other sessions and retry
942- Removed the stale "& for background" hint from the shortcuts help panel
943- [VSCode] Auto mode no longer requires the bypass-permissions setting to appear in the mode picker, and a dismissable notice on the new-session screen explains auto mode the first time it's active
944- Fixed the task panel below the prompt showing a stray unselectable "main" row when only a workflow is running
945- Fixed /mcp tools list and tool detail rendering when MCP servers have long or multi-line tool names or long descriptions
946- Fixed the /model picker not showing fast mode pricing on the Default option for API (pay-as-you-go) users when fast mode is on
947- Fixed auto mode incorrectly blocking actions with "could not evaluate this action" when the safety classifier ran out of output tokens while reasoning
948
949## 2.1.153
950
951- Added `skipLfs` option to `github`/`git` plugin marketplace sources to skip Git LFS downloads during clone and update
952- Claude Code now shows a one-time notice when your npm global install can't auto-update; `/doctor` lists the fixes
953- Status line commands now receive `COLUMNS` and `LINES` environment variables so scripts can size output to the terminal width
954- `claude agents`: autocomplete in the dispatch input now suggests native slash commands and bundled skills, not just project skills
955- `claude agents`: PR column now shows `PR #N` for a single PR or `N PRs` for multiple
956- `claude doctor` now shows the result of your last update attempt
957- Combined the separate "needs authentication" startup notifications for MCP servers and connectors into a single message
958- macOS: background agents now appear as "Claude Code" in Privacy & Security and keep their permission grants across upgrades
959- Fixed stateful MCP servers without the optional GET SSE stream reconnect-looping on `tools/list` (regression in v2.1.147)
960- Fixed a regression where a custom API gateway could receive the user's Anthropic OAuth credential instead of the gateway's own token
961- Fixed subagent (Agent tool) frontmatter MCP servers ignoring `--strict-mcp-config`, `--bare`, remote mode, enterprise managed MCP config, and managed-settings MCP server allow/deny policies
962- `--strict-mcp-config` no longer strips inline `mcpServers` from explicitly-passed agent definitions (`--agents` / SDK `agents`), and blocked subagent MCP servers now surface a visible warning
963- Fixed the Windows PowerShell installer reporting "Installation complete!" when installation actually failed
964- Fixed `claude update` installing the latest version instead of the configured release channel's version for npm installations
965- Fixed excessive memory usage (multiple GB) when resuming a session by transcript file path on machines with many stored sessions
966- Fixed `claude agents` and `claude --bg` running on a stale daemon started before binary-takeover support, even after upgrading
967- Fixed a hang where the CLI could fail to exit when stdin was closed without EOF in stream-json mode, leaving a stale session marker behind
968- Fixed malformed `file://` links in Claude's responses not being clickable in the terminal
969- Fixed `claude --help` rendering unwrapped output on terminals narrower than 92 columns
970- Fixed MCP tool progress notifications not rendering in the collapsed tool view
971- Fixed `Agent` tool with `subagent_type: 'claude'` running in an undocumented temporary worktree, which could silently discard outputs written to gitignored paths
972- `/bg` while Claude is responding now continues the response in the background session instead of dropping it
973- Fixed `/btw` keyboard shortcuts becoming unresponsive in background sessions while a task is running
974- Fixed background sessions writing temp files to `$CLAUDE_JOB_DIR` triggering a "sensitive file" permission prompt
975- Fixed recovering a background agent whose working directory was deleted showing a truncated stack trace instead of a clear error message
976- Fixed `EnterWorktree` not being available immediately in background sessions (previously required `ToolSearch` first)
977- Fixed `cmd+k` in iTerm2/Terminal.app not repainting attached background sessions
978- Fixed the IME candidate window appearing at the bottom of the screen instead of next to the input caret in attached background sessions on Windows
979- Fixed background-color bleed when attaching to a background agent from 256-color-only terminals after the agent had rendered file diffs
980- Fixed `/copy` and copy-on-select silently failing to update the system clipboard when attached to a background session inside tmux
981- Fixed opening `claude agents` with Remote Control enabled leaving zombie session entries on the Code tab after exiting
982- Fixed `/rename` in background sessions not updating the session banner immediately
983- Fixed Windows update rollback: if a Windows update fails, Claude Code now restores the original executable by copy and tells you how to recover
984- [VSCode] Fixed Claude Code processes not shutting down cleanly when VS Code closed on Windows, causing false "unclean exit" reports and orphaned MCP servers
985- `/model` now saves your selection as the default for new sessions (matching the IDE). Press `s` in the picker to switch models for the current session only.
986- If you customized the `modelPicker:setAsDefault` keybinding, rename it to `modelPicker:thisSessionOnly` in keybindings.json (the `d` action was replaced by `s`)
987
988## 2.1.152
989
990- `/code-review --fix` now applies review findings to your working tree after the review, surfacing reuse, simplification, and efficiency suggestions; `/simplify` now invokes `/code-review --fix`
991- Skills and slash commands can now set `disallowed-tools` in frontmatter to remove tools from the model while the skill is active
992- Added `/reload-skills` command to re-scan skill directories without restarting the session
993- `SessionStart` hooks can now return `reloadSkills: true` to re-scan skill directories, making skills installed by the hook available in the same session
994- `SessionStart` hooks can now set the session title via `hookSpecificOutput.sessionTitle` on startup and resume
995- Added a `MessageDisplay` hook event that lets hooks transform or hide assistant message text as it is displayed
996- Added `pluginSuggestionMarketplaces` managed setting: admins can allowlist org marketplaces whose plugins may be suggested via context-aware tips
997- `claude plugin marketplace remove` now accepts `--scope user|project|local` for symmetry with `marketplace add`, `install`, and `uninstall`
998- Claude Code now switches to your configured `--fallback-model` for the rest of the session when the primary model is not found, instead of failing every request
999- Auto mode no longer requires opt-in consent
1000- Vim mode: `/` in NORMAL mode now opens reverse history search (like Ctrl+R), matching bash/zsh vi-mode
1001- The `/usage` breakdown now includes large session files; files are scanned with a streaming read so memory usage stays flat
1002- Thinking summaries in the collapsed group now stay readable for at least 3 seconds, render as markdown, and cap at 10 lines (`Ctrl+O` shows the full thinking)
1003- In fullscreen mode, the "Thinking for Ns" indicator now counts up live while the model is thinking, and keeps its value if you interrupt mid-thought
1004- Simplified the Workflow tool's inline progress display — live agent counts now show only in the persistent workflow status row below the prompt
1005- The post-response timer now shows "Waiting for N background agents/workflows to finish" when backgrounded agents or workflows are still running, and reports the cumulative time once their results are processed
1006- Added the session entrypoint as an OpenTelemetry metric attribute (`app.entrypoint`, opt-in via `OTEL_METRICS_INCLUDE_ENTRYPOINT=true`)
1007- Fixed terminal styling degrading in very long sessions by recycling the renderer's style pool
1008- Fixed the sandbox-enabled warning not appearing in condensed startup mode — it now shows in every layout
1009- Fixed the loading spinner showing "still thinking"/"almost done thinking" while a tool is running, and reset the thinking status to "thinking" after each tool
1010- Fixed focus mode showing a spurious "N messages hidden" count on turns with no hidden activity
1011- Fixed clicking a link inside an expanded tool result collapsing the section instead of opening the link
1012- Fixed markdown table cell borders inheriting the color of inline code, wrapped continuation lines losing their style, and empty header cells showing a label in the narrow-terminal stacked layout
1013- Fixed plugin MCP servers with the same command but different environment variables being incorrectly deduplicated
1014- Fixed `/doctor` reporting "marketplace not found" or "plugin not found" for stale `enabledPlugins` entries referencing removed marketplaces or dropped plugins
1015- Fixed plugins that track a git branch silently no longer receiving updates after the plugin registry was rebuilt
1016- Fixed remote MCP servers failing to connect in Claude Code Remote sessions when the egress proxy is enabled
1017- Fixed the effort-change confirmation dialog appearing when the conversation has no messages or when switching between effort levels that resolve to the same underlying value
1018- Fixed the Agent tool description referencing an agent list that is never delivered when running with `--bare` or with attachments disabled
1019- Fixed a background worker crash in `claude agents` when accepting a stale permission prompt after a subagent was cancelled
1020- Fixed `cache_creation_input_tokens` reporting as 0 in transcript and result usage when the API reports cache writes only via the nested `cache_creation` breakdown
1021- Fixed the PushNotification tool incorrectly reporting "Mobile push not sent (Remote Control inactive)" in SDK-hosted sessions when Remote Control is enabled
1022- Fixed sessions getting stuck after a model or login switch left stale thinking-block signatures in history; now stripped proactively with a retry safety-net
1023
1024## 2.1.150
1025
1026- Internal infrastructure improvements (no user-facing changes)
1027
1028## 2.1.149
1029
1030- `/usage` now shows a per-category breakdown of what's driving your limits usage — skills, subagents, plugins, and per-MCP-server cost
1031- `/diff` detail view can now be scrolled with the keyboard (arrows, `j`/`k`, `PgUp`/`PgDn`, `Space`, `Home`/`End`)
1032- Markdown output now renders GFM task list checkboxes (`- [ ] todo` / `- [x] done`) instead of plain bullets
1033- Enterprise: added the `allowAllClaudeAiMcps` managed setting to load claude.ai cloud MCP connectors alongside `managed-mcp.json`
1034- Fixed a PowerShell permission bypass: built-in `cd` functions (`cd..`, `cd\`, `cd~`, `X:`) changed the working directory undetected, letting a later command read outside the workspace
1035- Fixed the sandbox write allowlist in git worktrees covering the entire main repository root instead of only the shared `.git` directory (with `hooks/` and `config` denied)
1036- Fixed PowerShell prefix/wildcard allow rules (e.g. `PowerShell(dotnet.exe build *)`) not pre-approving native executables and scripts
1037- Fixed a permission-analysis gap where the parser trusted stale variable-tracking values for `PWD`/`OLDPWD`/`DIRSTACK` across `cd`/`pushd`/`popd`
1038- Fixed `find` in the Bash tool exhausting the macOS system file/vnode table and crashing the host on large directory trees
1039- Fixed the managed-settings approval dialog leaving the terminal frozen after accepting at startup
1040- Fixed `/ultraplan` and remote session creation failing with "Could not capture uncommitted changes" when the working tree has no real changes
1041- Fixed `otelHeadersHelper` failing silently when the script path contains spaces; helper failures are now reported in `/doctor` and the debug log
1042- Fixed the thinking spinner staying amber across tool calls and onto fresh thinking bursts
1043- Fixed collapsed Bash output reporting the wrong hidden-line count for outputs with many short lines
1044- Fixed slash-command argument-hint clipping trailing typed characters when the hint overflows the input box
1045- Fixed argument-hint and progressive arg suggestions not appearing after Tab-completing a skill whose frontmatter `name:` differs from its directory basename
1046- Fixed the status bar showing the user's baseline `/effort` setting instead of the effort level applied by skill/agent `effort:` frontmatter
1047- Fixed Ctrl+O transcript view freezing at the moment it was opened instead of tailing new messages
1048- Fixed editing a recalled prompt-history entry losing the edit when navigating further up/down with arrow keys
1049- Fixed `/config` exit summary reporting phantom changes to auto-compact and theme when toggling unrelated settings
1050- Fixed `/insights` crashing when cached session-meta files are missing optional fields
1051- Fixed malformed PowerShell and History tool calls with missing input being misclassified as reads in transcript collapsing
1052- Fixed renaming a Remote Control session from claude.ai or the Claude mobile app not updating the local session name for `claude --resume`
1053- Fixed a race where a just-submitted prompt could appear twice in the up-arrow history
1054- Fixed tapping the "Jump to bottom" pill in fullscreen mode not dismissing it immediately
1055- Improved `/feedback` reports to include the conversation that happened before context compaction, making issues from earlier in long sessions easier to triage
1056
1057## 2.1.148
1058
1059- Fixed the Bash tool returning exit code 127 on every command for some users (a regression introduced in 2.1.147)
1060
1061## 2.1.147
1062
1063- Pinned background sessions (`Ctrl+T` in `claude agents`) now stay alive when idle, are restarted in place to apply Claude Code updates, and are shed under memory pressure only after non-pinned sessions
1064- Renamed `/simplify` to `/code-review`. It now reports correctness bugs at a chosen effort level (e.g., `/code-review high`); pass `--comment` to post findings as inline GitHub PR comments. The old cleanup-and-fix behavior has been removed
1065- Improved auto-updater: retries transient network failures, reports specific error categories and OS error codes on failure, and shows the current version when an update fails
1066- Improved diff rendering performance for large file edits
1067- Prompt history no longer records consecutive duplicate entries — recalling a prompt with arrow-up and submitting it again won't add another copy
1068- Fixed enterprise login restrictions (`forceLoginOrgUUID` and `forceLoginMethod` managed-settings) not being enforced against third-party-provider and API-key sessions
1069- Fixed `&` in `!` command output displaying as `&amp;`, which broke copy-pasting URLs from commands like `gcloud auth login` on headless machines
1070- Fixed unknown slash commands silently doing nothing in headless/SDK mode — they now show an error message
1071- Fixed `/help` rendering a broken tab header and showing only one command per page on small terminals when not in fullscreen mode
1072- Fixed shell snapshot dropping user functions whose names start with a single underscore, which broke aliases referencing them
1073- Fixed plugin agents that declare multiple `Agent(...)` types in `tools:` frontmatter dropping all but the last entry
1074- Fixed hook `if` conditions like `PowerShell(git push*)` never matching — only `PowerShell(*)` worked
1075- Fixed PowerShell tool dropping output for commands that rely on the default formatter
1076- Fixed: on Windows, "Yes, and don't ask again" for a PowerShell script invocation now writes a rule that actually matches on subsequent runs
1077- Fixed PowerShell tool failing on Windows with exit code 1 when `pwsh` is installed via winget or the Microsoft Store
1078- Fixed `/effort` opening with the slider on the wrong level — it now starts at your current effort
1079- Fixed paginating MCP servers dropping resources, templates, and prompts past page 1
1080- Fixed full-screen strobing in attached background sessions on Windows Terminal while Claude is streaming
1081- Fixed: on Windows, removing a background-job worktree no longer follows NTFS junctions into the main repo
1082- Fixed `/background` refusing sessions whose only typed input was a skill or custom slash command
1083- Fixed auto mode suppressing `AskUserQuestion` when the user or a skill explicitly relies on it; the auto-mode classifier now sees the user's answers as intent signal
1084- Fixed `/theme` "New custom theme" and color editor dialogs not responding to Esc
1085- Fixed an uncaught exception at the end of streaming sessions when running via the Agent SDK
1086- Fixed a rare hang when waiting for scroll to settle on Windows
1087- Fixed stale and doubled rows in the agent view list on Windows when background session results contain wide (CJK) characters
1088- Fixed pasted text being delivered to agents as an unreadable `[Pasted text #N]` placeholder instead of the actual content
1089- Fixed plugin component counts in `claude plugin details` and `/plugin` being doubled when a plugin's manifest listed paths overlapping its default directories
1090- Fixed backgrounded sessions re-prompting for tool permissions you already granted with "don't ask again"
1091- Fixed GNOME Terminal right-click and middle-click paste not inserting text
1092- Fixed `CLAUDE_CODE_SUBAGENT_MODEL` not applying to teammate processes spawned by agent teams
1093- Fixed slash commands followed by a tab or newline being treated as an unknown command
1094- Fixed several spacing and layout glitches in the `/plugin`, `/status`, `/mobile`, `/sandbox`, and `/permissions` menus
1095- Fixed stripped images prompting the model to repeatedly re-read media that was no longer present
1096
1097## 2.1.145
1098
1099- Added `claude agents --json` to list live Claude sessions as JSON for scripting (tmux-resurrect, status bars, session pickers)
1100- Added `agent_id` and `parent_agent_id` attributes to `claude_code.tool` OTEL spans, and fixed trace parenting so background subagent spans nest under the dispatching Agent tool span
1101- Status line JSON input now includes GitHub repo and PR information when detected
1102- `/plugin` Discover and Browse screens now show a plugin's commands, agents, skills, hooks, and MCP/LSP servers before installation
1103- `claude agents` terminal tab title now shows the awaiting-input count so an alt-tabbed window tells you when an agent needs attention
1104- Slash command and @-mention suggestion list now supports mouse hover and click in fullscreen mode
1105- Stop and SubagentStop hook input now includes `background_tasks` and `session_crons` fields
1106- Fixed a permission-prompt bypass where bare variable assignments to non-allowlisted environment variables in Bash commands were auto-approved
1107- Fixed MCP prompt slash commands showing raw server validation errors when a required argument is omitted — the error now names the missing argument and shows expected usage
1108- Fixed the spinner and elapsed-time display freezing until a keypress after the terminal was resized or refocused
1109- Fixed the cross-project resume hint failing in default Windows PowerShell 5.1 — Windows now uses `;` as the command separator
1110- Fixed voice push-to-talk not working in the agent view's reply pane
1111- Fixed task lists rendering in random order when several tasks are created at once
1112- Fixed stale "Failed to install Anthropic marketplace" banner showing when the marketplace is already installed
1113- Fixed the PR badge in the footer not updating immediately after `gh pr create` and other PR-state-changing commands run in-session
1114- Fixed Agent Teams teammates with non-ASCII names failing every API call due to invalid header encoding
1115- Fixed `/review` using a deprecated `projectCards` GraphQL query that errored on repos with Classic Projects
1116- Fixed `claude plugin validate` not flagging `skills:` entries that point at a file instead of a directory — the error now suggests the parent directory
1117- Fixed an infinite loop where a skill using `context: fork` could repeatedly re-invoke itself instead of running
1118- Improved the Read tool to return a truncated first page with a "PARTIAL view" notice instead of a hard error when a whole-file read exceeds the token limit
1119
1120## 2.1.144
1121
1122- Added `/resume` support for background sessions — sessions started via `claude --bg` or agent view now appear alongside interactive ones, marked with `bg`
1123- Added elapsed duration to background subagent completion notifications (e.g. "Agent completed · 3h 2m 5s")
1124- The `/plugin` browse and discover panes now show when a plugin was last updated
1125- `/model` now changes the model for the current session only; press `d` in the model picker to set a default for new sessions
1126- Renamed "extra usage" to "usage credits" across CLI copy; `/extra-usage` is now `/usage-credits` (old name still works)
1127- Fixed startup hanging up to 75s when `api.anthropic.com` is unreachable (captive portal, firewall, VPN issues) — side-channel API calls now time out after 15s
1128- Fixed garbled terminal output after a missed window-resize event (e.g. dragging a VS Code split-pane divider) — now self-heals on the next frame instead of requiring Ctrl+L
1129- Fixed progressive terminal display corruption (stale/garbled glyphs) that could appear in very long sessions and only cleared on terminal resize or restart
1130- Reduced terminal rendering glitches in VS Code by reducing spinner animation color count
1131- Fixed macOS background sessions crashing with "exit 1 before init" when the project lives under a Full Disk Access-protected folder (regression in 2.1.143)
1132- 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
1133- 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
1134- Fixed `/branch` failing with "No conversation to branch" after entering a worktree or in some background sessions
1135- Fixed pressing Escape in the AskUserQuestion notes field aborting the turn instead of returning to answer selection
1136- Fixed model selection not applying when changed via the IDE model picker or `applyFlagSettings` after startup
1137- Resumed sessions now keep the model they were using instead of picking up another session's `/model` choice
1138- Fixed Bedrock and Vertex users unable to select "Opus (1M context)" from the `/model` picker (regression in v2.1.129)
1139- Fixed remote-session login failing with "Can't access this organization" for users with `forceLoginMethod` and `forceLoginOrgUUID` set
1140- Fixed MCP servers with paginated `tools/list` responses only returning the first page, silently dropping tools
1141- Fixed MCP images with unsupported MIME types (e.g. SVG) breaking the conversation — now saved to disk and referenced in the tool result
1142- Fixed file descriptor exhaustion when a build runs inside a skill directory — non-`.md` files no longer trigger skill reloads
1143- Fixed session title being generated from plugin monitor output instead of the user's first prompt
1144- Fixed Skill tool failing with permission error in headless mode (regression in v2.1.141)
1145- 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
1146- 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
1147- 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
1148- Fixed scrolling in attached background sessions on Windows — PgUp/PgDn, mouse wheel, and Ctrl+O transcript navigation now work
1149- Fixed a crash when closing the terminal while attached to a background session
1150- Fixed on Windows, pressing ← in `claude agents` leaving the list unresponsive to keyboard input
1151- Fixed ghost characters at the left edge when switching panes in Agent View on Windows Terminal with CJK content
1152- `/bg` and `←`-detach now preserve directories added via `/add-dir`
1153- Fixed Edit/Write refusing with "background session hasn't isolated its changes yet" right after detaching a session that was already editing in place
1154- Fixed `claude respawn <id>` on a stopped background session showing "stopped" instead of running
1155- Fixed `/resume` picker not showing sessions forked from a background session
1156- 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
1157- Fixed background Bash tasks spawned by subagents staying "Running" in SDK task panels after the process exits
1158- Fixed completed or stopped background sessions briefly failing to wake being permanently marked as a startup crash
1159- Fixed markdown links in `claude agents` attached sessions rendering as plain text instead of clickable hyperlinks
1160- Fixed custom `spinnerVerbs` applying to the post-turn duration message — past-tense built-ins like "Worked for 5s" are restored there
1161- `claude agents` / `--bg` rejection messages now name the specific gate (non-TTY, env var, or setting) instead of a generic message
1162- `claude --bg --name <label>` now echoes the name in the post-spawn confirmation
1163- `claude agents`: renaming a background session with Ctrl+R now updates the attached session's banner immediately
1164- Background session worktree isolation guard now applies for non-git VCS users with `WorktreeCreate` hooks configured
1165- Plugin marketplace add/update now respects `CLAUDE_CODE_PLUGIN_PREFER_HTTPS`
1166- `/plugin` now returns to the Installed list after enabling, disabling, or uninstalling a plugin
1167- `/doctor` now shows an exec-form example when a command hook is missing the `command` field
1168- Skill-listing truncation is no longer shown as a startup notification — run `/doctor` for the full breakdown
1169- Improved recovery from rare pre-response stream stalls — now retries streaming once instead of falling back to a slower non-streaming request
1170- 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)
1171- 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.
1172
1173## 2.1.143
1174
1175- 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
1176- Added projected context cost (per-turn and per-invocation token estimates) to the `/plugin` marketplace browse pane
1177- Added `worktree.bgIsolation: "none"` setting to let background sessions edit the working copy directly without `EnterWorktree`, for repos where worktrees are impractical
1178- PowerShell tool now passes `-ExecutionPolicy Bypass`. Opt out with `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1`
1179- Background sessions now preserve the model and effort level you set after waking from idle
1180- Shift+Tab in attached agent sessions now includes auto mode in the cycle
1181- Fixed a corrupt `.credentials.json` with a non-array `scopes` value hanging the CLI on startup or silently aborting OAuth token refresh
1182- Fixed right-click paste in `claude agents` on Windows Terminal and WSL
1183- Fixed stop hooks that block repeatedly looping forever — the turn now ends with a warning after 8 consecutive blocks (override via `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP`)
1184- Fixed Esc/Ctrl+C not cancelling a pending `/loop` wakeup while Claude is idle between iterations
1185- Fixed `/goal` evaluator firing while background shells or delegated subagents are still running
1186- Fixed `NO_COLOR`/`FORCE_COLOR` in settings.json `env` stripping Claude Code's own UI colors — they now apply to subprocesses only
1187- Fixed agent view spawning repeated PowerShell processes on Windows when listing sessions
1188- Fixed `/bg` without a prompt sending "continue" to the forked session — the fork now waits for input
1189- Fixed `--agent <name>` not finding plugin-contributed agents without the `plugin:` prefix
1190- Fixed deleting a session from agent view not removing its transcript file
1191- Fixed stale-fragment rendering when scrolling in attached background sessions on Windows Terminal
1192- Fixed background agents false-positive worker-stall detection storm after host sleep or macOS App Nap
1193- Fixed 5xx error messages pointing at status.claude.com instead of naming the configured gateway or cloud provider
1194- The PowerShell tool is now enabled by default on Windows for Bedrock, Vertex, and Foundry users. Opt out with `CLAUDE_CODE_USE_POWERSHELL_TOOL=0`.
1195- `claude agents` now accepts `--add-dir`, `--settings`, `--mcp-config`, and `--plugin-dir` and applies them to the dashboard and to background sessions dispatched from it
1196- `claude agents` accepts `--permission-mode`, `--model`, `--effort`, and `--dangerously-skip-permissions` to set defaults for sessions dispatched from the view
1197- `claude --bg --dangerously-skip-permissions` now persists across retire→wake
1198- Fixed background sessions silently capturing IDE file references into the warm spare's input, which caused the reference to be prepended to the next prompt dispatched from `claude agents`
1199- Worktree cleanup no longer falls back to `rm -rf` when `git worktree remove` fails, preventing loss of gitignored or in-progress files
1200- Fixed background-job sessions on macOS getting "Operation not permitted" errors when reading files under `~/Documents`, `~/Desktop`, or `~/Downloads`, even with Full Disk Access granted.
1201- `/bg` now preserves `--mcp-config`, `--settings`, `--add-dir`, `--plugin-dir`, and `--strict-mcp-config`, so backgrounded sessions keep their MCP servers and settings across respawn.
1202- Background sessions launched from `claude agents` now honor `permissions.defaultMode` from settings.json (was previously overridden to auto mode)
1203- Fixed: on Windows, pressing ← in `claude agents` while a response was streaming could leave the agents list unresponsive to all input
1204- `/bg` and `←`-detach now preserve `--fallback-model`, so backgrounded workers degrade to the fallback model on overload instead of hard-failing.
1205- `/bg` and `←`-detach now preserve `--allow-dangerously-skip-permissions`, so the forked worker keeps bypass-permissions available in its Shift+Tab cycle.
1206- Fixed: background daemon spawn now falls back to the running binary when the `~/.local/bin/claude` launcher is missing or non-executable
1207- Fixed `claude agents --allow-dangerously-skip-permissions` defaulting dispatched sessions to bypass mode instead of making it available in the permission cycle
1208
1209## 2.1.142
1210
1211- Added new `claude agents` flags: `--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, and `--dangerously-skip-permissions` to configure dispatched background sessions
1212- Fast mode now uses Opus 4.7 by default (previously Opus 4.6). Set `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1` to pin fast mode to Opus 4.6
1213- Plugins with a root-level `SKILL.md` and no `skills/` subdirectory are now surfaced as a skill
1214- The `/plugin` details pane and `claude plugin details` now show LSP servers a plugin provides
1215- `/web-setup` warns before replacing an existing GitHub App connection
1216- Fixed `MCP_TOOL_TIMEOUT` not raising the per-request fetch timeout for remote HTTP and SSE MCP servers, which capped tool calls at 60 seconds regardless of the configured value
1217- Fixed background sessions not recognizing pre-existing git worktrees, blocking Edit while EnterWorktree refused to create a duplicate
1218- Fixed background sessions disappearing and daemon reconnect failing after macOS sleep/wake — the daemon now detects clock jumps instead of treating them as elapsed idle time
1219- Fixed daemon not exiting cleanly after the binary is upgraded (e.g. `brew upgrade`), causing dispatched agents to crash-loop on the deleted path
1220- Fixed background agents crash-looping when the Claude-in-Chrome extension is connected without a shared tab
1221- Fixed clicking links in an attached `claude agents` session — the background worker's headless browser shim no longer applies while attached
1222- Fixed `claude agents` "v to open in editor" using the daemon's default editor instead of your shell's `$EDITOR`/`$VISUAL`
1223- Fixed `claude agents` deadlocking on Windows with network-drive working directories; Ctrl+C now works during startup
1224- Fixed background-color bleed when attaching to a `claude agents` session from Apple Terminal or other 256-color-only terminals
1225- Fixed `claude --bg --dangerously-skip-permissions` not persisting across retire/wake
1226- Fixed session titles being derived from the URL when the first message is a link
1227- Fixed redundant `set_model` requests from remote clients injecting duplicate `/model` breadcrumbs into the transcript
1228- Fixed plugins using `skills: ["./"]` showing a false "path escapes plugin directory" error
1229- Fixed plugin cache cleanup deleting the active plugin version directory when no installation metadata is present
1230- Fixed `/plugin` browse pane showing "0 installs" for newly published plugins
1231- Fixed plugin advisories not naming every `plugin.json` key that shadows a default folder
1232- Improved reactive compaction: the first summarize attempt now seeds from the original request's overflow size, avoiding a wasted near-full-context retry
1233- Improved hook configuration error: configuring a prompt- or agent-type hook for `SessionStart`/`Setup`/`SubagentStart` now shows a clear "use a command-type hook instead" error
1234- Removed stale `/model claude-sonnet-4-20250514` suggestion from Usage Policy refusal messages
1235
1236## 2.1.141
1237
1238- Added `terminalSequence` field to hook JSON output so hooks can emit desktop notifications, window titles, and bells without a controlling terminal
1239- Added `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` to clone GitHub plugin sources over HTTPS instead of SSH, for environments without a GitHub SSH key
1240- Added `ANTHROPIC_WORKSPACE_ID` environment variable for workload identity federation — scopes the minted token to a specific workspace when the federation rule covers more than one
1241- Added `claude agents --cwd <path>` to scope the session list to a directory
1242- `/feedback` can now include recent sessions (last 24 hours or 7 days) for issues spanning more than the current session
1243- Rewind menu: added "Summarize up to here" to compress earlier context while keeping recent turns intact
1244- Auto mode permission dialog now explains when a `permissions.ask` rule caused the prompt
1245- Restored the "view diff in your IDE" option on file-edit permission prompts when an IDE is connected
1246- Background agents launched via `/bg` or `←←` now preserve the current permission mode instead of reverting to default
1247- `claude agents`: agents that finish work but leave a background shell running now move to Completed instead of staying under Working
1248- Improved spinner feedback during long thinking periods — the spinner now warms to amber after 10 seconds to signal Claude is still working
1249- Improved plugin menu navigation: `→`/Tab switch tabs, `↑` moves to the tab strip, and tab headers and search box are clickable in fullscreen mode
1250- Fixed background side-queries sending an unavailable Haiku model ID on Bedrock/Vertex/Foundry/gateway when no `ANTHROPIC_SMALL_FAST_MODEL` override is set — now falls back to the main-loop model
1251- Fixed `claude daemon status` and `/doctor` on Windows throwing when the daemon pipe key file is locked or unreadable — now shows the underlying error instead of an opaque failure
1252- Fixed `claude agents` showing the agent-type list instead of the dashboard when launched through a wrapper that adds flags
1253- Fixed `claude agents` opening a crashed session firing redundant dispatches when the working directory was deleted
1254- Fixed background jobs on a custom `ANTHROPIC_BASE_URL` gateway not getting auto-named — the namer now uses the main model when no Haiku model is configured
1255- Fixed `/model` in one session silently changing the autocompact threshold in other concurrent sessions
1256- Fixed switching permission mode while a tool-permission prompt is open not auto-dismissing the prompt when the new setting permits the tool
1257- Fixed pressing Enter while a permission/dialog prompt is open also submitting text in the input box
1258- Fixed hooks receiving a non-existent `transcript_path` after `EnterWorktree` switches the working directory
1259- Fixed markdown tables with cell wrapping falling back to the vertical key-value layout instead of rendering as a bordered grid (regression in 2.1.136)
1260- Fixed cancelled prompts being removed from Up-arrow history when auto-restored into the input box, avoiding duplicate entries
1261- Fixed prompts cancelled with Ctrl+C/Esc before any response being dropped from Up-arrow history
1262- Fixed Ctrl+C not interrupting a running turn while in vim INSERT/VISUAL mode
1263- Fixed alternative `chat:submit` keybindings (e.g. `meta+enter`, `ctrl+enter`) not working when `enter` is rebound to `chat:newline`
1264- Fixed prompt suggestions being silently disabled when an output style was configured
1265- Fixed `spinnerVerbs` setting not being honored in turn-completion messages
1266- Fixed AskUserQuestion popup hiding the last line of preceding chat content
1267- Fixed Web Search status showing "Did 0 searches" when searches returned errors
1268- Fixed multi-line statusline output dropping or corrupting rows when any line exceeds terminal width
1269- Fixed light-ansi theme using invisible white for diff context lines on light backgrounds — now uses black
1270- Fixed error overlay dumping minified bundle source that hid the original error message
1271- Fixed pressing Enter after typing a feedback survey rating digit submitting it as a chat message instead of the rating
1272- Fixed pressing `x` on a selected subagent in the agent panel typing into the prompt instead of stopping the agent
1273- Fixed session title being derived from plugin monitor notifications before the user's first prompt
1274- Fixed "Allowed by PermissionRequest hook" repeating once per tool call under a collapsed read/search group
1275- Fixed `/tui` silently dropping running background shells and subagents — now refuses and asks to wait for them to finish
1276- Fixed welcome banner showing "API Usage Billing" on Bedrock, Vertex, Foundry, and other third-party providers — now shows the provider name
1277- Fixed `/mcp` server list not keeping the focused server visible in short terminals in fullscreen mode
1278- Fixed redaction in `/feedback` bundles producing invalid JSON for quoted values like session IDs
1279- Fixed desktop and third-party provider sessions incorrectly inheriting `apiKeyHelper`/`ANTHROPIC_AUTH_TOKEN` from host managed-settings
1280- Fixed early analytics events being silently dropped when fired before logger initialization
1281- Fixed `claude plugin install` failing for plugins whose marketplace `ref` no longer exists upstream when a `sha` is also pinned
1282- Fixed plugin details pane showing 0 MCP servers for plugins that declare them via `.mcp.json`
1283- Fixed plugin MCP servers with unset config variables showing a generic connection failure instead of a "config issue" message with a fix-it hint; malformed `.mcp.json` entries no longer drop other MCP servers
1284- Fixed MCP server configs using POSIX shell parameter expansions (e.g. `${var%pattern}`) being incorrectly flagged as missing environment variables
1285- Fixed MCP HTTP/SSE servers returning 403 on connect showing as "failed" instead of "needs auth"
1286- Fixed remote MCP servers disconnecting unnecessarily when the optional server-events stream failed to reconnect — tool calls continue over POST
1287- Fixed Remote Control MCP connectors all failing with 401 when the worker session token rotated mid-session
1288- Fixed Remote Control automatically re-enrolling a trusted device when the server rejects a stale token, instead of looping through `/login`
1289- Fixed a race where early OTel spans could be silently dropped in SDK/headless mode with beta tracing enabled
1290- Fixed custom `voice:pushToTalk` keybindings and `"space": null` unbinds being silently ignored
1291- Fixed Windows Alt+V image paste reporting "no image found" when the clipboard contains a screenshot
1292- Fixed SDK "Claude Code native binary not found" on Linux when both glibc and musl platform packages are installed
1293- Bedrock: `awsCredentialExport` now always runs when configured instead of being skipped when ambient AWS credentials resolve, fixing auth for cross-account access
1294- [VSCode] Fixed in-chat mic showing no feedback when the microphone produced only silence — now shows "No audio detected"
1295- [VSCode] Voice mode: the WSL error now suggests installing `sox libsox-fmt-pulse` for WSLg users
1296- `claude agents`: launching a session no longer fails when the pre-warmed background worker is unhealthy — now falls back to a fresh launch
1297- `claude agents` no longer shows empty placeholder sessions left over from backgrounding a fresh REPL, and shows onboarding text when entered via ← with no other agents
1298- Empty idle background sessions left over from `←` are now automatically retired by the daemon after 5 minutes
1299
1300## 2.1.140
1301
1302- Improved Agent tool `subagent_type` matching to accept case- and separator-insensitive values (e.g. `"Code Reviewer"` resolves to `code-reviewer`)
1303- Updated agent color palette
1304- Fixed `/goal` silently hanging when `disableAllHooks` or `allowManagedHooksOnly` is set — now shows a clear message instead of an indicator that never resolves
1305- Fixed a regression in settings hot-reload where symlinked settings files caused misattributed change events and spurious `ConfigChange` hooks
1306- Fixed `claude --bg` failing with "connection dropped mid-request" when the background service was about to idle-exit
1307- Fixed background service startup failing on machines with enterprise endpoint security by allowing more time
1308- Fixed remote managed settings not retrying on 401 — now retries once with a force-refreshed token
1309- Fixed managed `extraKnownMarketplaces` auto-update policy not being persisted to `known_marketplaces.json`
1310- Fixed `/loop` scheduling redundant wakeups to poll for background tasks that already notify on completion
1311- Fixed a recurring event-loop stall on Windows when a missing executable (e.g. `gh`) triggered synchronous `where.exe` re-spawns on every check
1312- Fixed `Read` tool calls failing validation when `offset` is passed as a whitespace-padded or `+`-prefixed string
1313- Fixed native terminal cursor not staying at the input caret when the terminal loses focus
1314- Plugins now warn when a default component folder (e.g. `commands/`) is silently ignored because `plugin.json` sets the matching key. Shown in `/doctor`, `claude plugin list`, and `/plugin`.
1315
1316## 2.1.139
1317
1318- Added agent view (Research Preview): a single list of every Claude Code session — running, blocked on you, or done. Run `claude agents` to get started. See https://code.claude.com/docs/en/agent-view
1319- Added `/goal` command: set a completion condition and Claude keeps working across turns until it's met. Works in interactive, `-p`, and Remote Control. Shows live elapsed/turns/tokens as an overlay panel
1320- Added `/scroll-speed` command to tune mouse wheel scroll speed with a live preview
1321- Added `claude plugin details <name>` to show a plugin's component inventory and projected per-session token cost
1322- Added transcript view navigation: `?` for keyboard shortcuts, `{`/`}` to jump between user prompts, `v` to toggle shortcut panel
1323- Added hook `args: string[]` field (exec form) that spawns the command directly without a shell, so path placeholders never need quoting
1324- Added hook `continueOnBlock` config option for `PostToolUse` — set to `true` to feed the hook's rejection reason back to Claude and continue the turn
1325- MCP stdio servers now receive `CLAUDE_PROJECT_DIR` in their environment, matching hooks. Plugin configs can reference `${CLAUDE_PROJECT_DIR}` in commands
1326- Compaction prompt now asks the model to preserve sensitive user instructions
1327- `/mcp` Reconnect now picks up `.mcp.json` edits without a restart, and shows the HTTP status and URL when reconnecting fails
1328- `/context all` per-skill token estimates now account for the model's tokenizer and show rounded values
1329- `claude plugin install <name>@<marketplace>` now auto-refreshes the marketplace and retries before reporting a plugin as not found
1330- `/plugin` installed-plugin details now show hook event names and MCP server names cleanly
1331- `/context` now shows the providing plugin's name for plugin-sourced skills
1332- Remote MCP server reconnect retry on transient failures is now enabled for all users
1333- API requests from subagents now carry `x-claude-code-agent-id` / `x-claude-code-parent-agent-id` headers, and `claude_code.llm_request` OTEL spans include `agent_id` / `parent_agent_id` attributes
1334- 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. Unset the API key to use these features
1335- Fixed a deadlock where expired credentials and the `forceRemoteSettingsRefresh` policy setting blocked `claude auth login`/`logout`/`status` with no way to recover
1336- Fixed `autoAllowBashIfSandboxed` not auto-approving commands with shell expansions like `$VAR` and `$(cmd)`
1337- Fixed a bug where a hook writing to the terminal could corrupt an on-screen interactive prompt; hooks now run without terminal access
1338- Fixed unbounded memory growth when an HTTP/SSE MCP server streams non-protocol data — response bodies now capped at 16 MB per SSE frame
1339- Fixed `Skill(name *)` permission rules — the wildcard form now works as a prefix match, matching `Bash(ls *)` behavior
1340- Fixed settings hot-reload not detecting edits to symlinked `~/.claude/settings.json`
1341- Fixed plugin details failing to load when the marketplace key differs from the manifest name
1342- Fixed `/model` picker "Default" row not reflecting `ANTHROPIC_DEFAULT_OPUS_MODEL`/`ANTHROPIC_DEFAULT_SONNET_MODEL` overrides
1343- Fixed spurious "stream idle timeout" 5 minutes after a response completed, caused by the watchdog timer not being cleared on stream cancellation
1344- Fixed silent `exit 1` when 10+ MCP servers are configured and the cache directory is unwritable — the error message now includes the underlying cause
1345- Fixed a typing cursor blinking on tab names, list pointers, and select rows in dialogs
1346- Fixed transcript view letter shortcuts not working after mouse click
1347- Fixed Bash-mode up-arrow history repeating the first entry and clobbering the in-progress draft
1348- Fixed pasting or dropping multiple images only inserting the last one
1349- Fixed hyperlinks using unreadable dark navy on dark themes — they now adapt to the active theme
1350- Fixed model picker showing a redundant "Current model" row for third-party users whose model is set to the `opus` alias
1351- Fixed legacy Opus picker entry on PAYG 3P providers resolving to the same model as the default entry
1352- Fixed mouse wheel scrolling speed in Cursor and VS Code 1.92–1.104; the trackpad now scrolls at a steady rate and the mouse wheel keeps ~3 lines per notch
1353- Fixed scroll behavior in Windows Terminal and VS Code when attached to background sessions
1354- Fixed MCP resources from disconnected servers lingering in `@server:` autocomplete
1355- Fixed two-file diff snippets over-reporting the number of truncated lines by one
1356- Fixed Grep results not relativizing Windows drive-letter paths and count mode reporting wrong totals for single-file paths
1357- Fixed border-embedded text overflowing on CJK/emoji due to visual cell width miscalculation
1358- Fixed fuzzy-match highlighting splitting emoji and astral-plane characters mid-pair
1359- Fixed skill argument names containing regex metacharacters breaking argument substitution
1360- Fixed ProgressBar rendering a full block for an almost-full fractional cell
1361- Fixed task polling and `fs.watch` being resurrected when the last subscriber leaves while a fetch is in flight
1362- Fixed plugin dependency resolution leaving a stale count when the manifest name differs from the source identifier
1363- Fixed Insights Time-of-Day chart skewing when a session has an unparseable timestamp
1364- Fixed keybindings using only the cmd/super/win modifier being flagged as unparseable
1365- Fixed `claude_code.active_time.total` OpenTelemetry metric not being emitted in `--print` mode
1366- Fixed `claude plugin update` not preserving cross-plugin symlinks inside a marketplace
1367- [VSCode] Press Cmd/Ctrl+Shift+T to reopen the most recently closed session tab, configurable via `claudeCode.enableReopenClosedSessionShortcut`
1368
1369## 2.1.138
1370
1371- Internal fixes
1372
1373## 2.1.137
1374
1375- [VSCode] Fixed extension failing to activate on Windows
1376
1377## 2.1.136
1378
1379- Added `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` to re-enable the session quality survey for enterprises capturing responses through OpenTelemetry
1380- Added `settings.autoMode.hard_deny` for auto mode classifier rules that block unconditionally regardless of user intent or allow exceptions
1381- Fixed MCP servers configured in `.mcp.json`, plugins, and claude.ai connectors silently disappearing after `/clear` in the VS Code extension, JetBrains plugin, and Agent SDK
1382- Fixed a rare login loop where a concurrent credential write could overwrite a freshly-rotated OAuth token and force re-login
1383- Fixed MCP OAuth refresh tokens being lost when multiple servers refresh concurrently — users with several remote MCP servers should no longer need daily re-authentication
1384- Fixed an API error (400) when extended thinking emitted a redacted thinking block after a tool call
1385- Fixed `--resume` / `--continue` not finding sessions when the project path contains underscores
1386- Fixed plan mode not blocking file writes when a matching `Edit(...)` allow rule exists
1387- WSL2: image paste from Windows clipboard now works via a PowerShell fallback when xclip/wl-paste cannot read image data
1388- Fixed plugin `Stop`/`UserPromptSubmit` hooks failing when cache cleanup deletes a version still in use by a running session
1389- Improved visual consistency across slash command dialogs: standardized footer hints, dialog spacing, and arrow-key styling, and the dialog frame now appears immediately during loading instead of popping in after
1390- Fixed colors appearing at wrong positions in bash command output and markdown code blocks
1391- Fixed ReasonML diffs rendering corrupted "undefined" text artifacts at word-diff boundaries
1392- Fixed worktree exit dialog warning about uncommitted files in the wrong directory after worktree removal
1393- Fixed `@` file picker not matching files created mid-session in small non-git directories
1394- Fixed `@`-mention file picker not finding files in directories with more than 100 entries
1395- Fixed failed tool calls not being click-to-expand in fullscreen mode when their output was truncated
1396- Fixed Backspace and Ctrl+Backspace getting swapped after using Ctrl+G to open an external editor on terminals with persistent extended-key modes
1397- Fixed `/usage` weekly reset showing time of day instead of the calendar date
1398- Fixed welcome banner ellipsis causing column overflow on CJK terminals
1399- Fixed `/insights` crash when session history contains tool calls with malformed input fields
1400- Fixed a renderer crash when a tool's collapsibility classification changes mid-session
1401- Fixed a `skills` entry in `plugin.json` hiding the plugin's default `skills/` directory, and listing a file path now shows an error instead of failing silently
1402- Fixed IDE shell-integration lock files not respecting `CLAUDE_CONFIG_DIR`
1403- Fixed trailing whitespace in copied terminal output during streaming
1404- Fixed plugin uninstall and enable/disable not matching slugs case-insensitively
1405- Fixed tool error truncation marker showing a negative count for surrogate-pair strings
1406- Fixed env vars from `CLAUDE_ENV_FILE` SessionStart hooks going stale after `/resume` or `/clear`
1407- Fixed `/branch` saving a multi-line session title when given a pasted multi-line name
1408- Fixed a stray leading space on the second line of wrapped text at the column boundary
1409- Fixed Esc not dismissing dialogs in `/install-github-app`, `/desktop`, `/resume`, and `/web-setup`
1410- Fixed `/doctor` MCP schema errors not naming the missing field or showing the source file path
1411- Fixed Bash permission prompts showing an internal parser diagnostic instead of a user-readable explanation
1412- Fixed plugin slash commands with spaces (e.g. `/myplugin review`) not resolving to their namespaced form
1413- Fixed `AskUserQuestion` discarding multi-select answers when supplied as an array
1414- Fixed `/clear <name>` not labeling the cleared session for `/resume`
1415- Fixed `CronList` output missing qualifiers and the scheduled prompt
1416- Fixed "Jump to bottom" overlay leaving color artifacts on CJK characters in fullscreen mode
1417- Fixed wide markdown tables leaving a stale bordered render in terminal scrollback while streaming
1418- Fixed pasted text being silently dropped when a long prompt with a pasted-text placeholder was auto-truncated
1419- Fixed `/release-notes` getting stuck on an old version after a failed changelog refresh
1420- Fixed `/mcp` server list not scrolling when there are more servers than fit in the terminal
1421- Fixed mid-input slash command autocomplete not working after an initial slash command
1422- Fixed scrolling to bottom re-engaging auto-follow with `autoScrollEnabled: false`
1423- Fixed prompt suggestions being auto-submitted by Enter on an empty input instead of requiring Tab or arrow to accept
1424- Fixed keyboard shortcut hints not reflecting rebound keys from `keybindings.json`
1425- Fixed `/settings` language change being reverted on Escape after confirming
1426- Fixed `/terminal-setup` only appearing in autocomplete on exact name match instead of partial prefixes
1427- Fixed "Chat about this" on an `AskUserQuestion` dialog erasing the question text
1428- Fixed MCP tool results being invisible when the server returns content blocks
1429- Improved error message when `--worktree` collides with an existing or stale worktree
1430- Changed plugin marketplace removal key to `d` (matching delete elsewhere) instead of `r` which collided with retry
1431
1432## 2.1.133
1433
1434- Added `worktree.baseRef` setting (`fresh` | `head`) to choose whether `--worktree`, `EnterWorktree`, and agent-isolation worktrees branch from `origin/<default>` or local `HEAD`. **Note:** the default `fresh` changes `EnterWorktree`'s base back to `origin/<default>` (it has been local `HEAD` since 2.1.128) — set `worktree.baseRef: "head"` to keep unpushed commits in new worktrees
1435- Added `sandbox.bwrapPath` and `sandbox.socatPath` managed settings (Linux/WSL) to specify custom bubblewrap and socat binary locations
1436- Added `parentSettingsBehavior` admin-tier key (`'first-wins' | 'merge'`) to let admins opt SDK `managedSettings` (parent tier) into the policy merge
1437- Hooks now receive the active effort level via the `effort.level` JSON input field and the `$CLAUDE_EFFORT` environment variable, and Bash tool commands can read `$CLAUDE_EFFORT`
1438- Improved focus mode behavior
1439- Improved memory usage by releasing warm-spare background workers under memory pressure
1440- Fixed parallel sessions all dead-ending at 401 after a refresh-token race wiped shared credentials
1441- Fixed `Edit`/`Write` allow rules scoped to a drive root (`C:\`) or POSIX `/` matching incorrectly and always prompting
1442- Fixed an unhandled rejection (`ECOMPROMISED`) when a history or session-log file lock is compromised by clock skew or slow disk
1443- Fixed pressing Esc during conversation compaction showing a spurious "Error compacting conversation" notification
1444- Fixed `HTTP(S)_PROXY` / `NO_PROXY` / mTLS not being respected for the full MCP OAuth flow including discovery, dynamic client registration, token exchange, and token refresh
1445- Fixed Read/Write/Edit being denied on mapped network drives passed via `--add-dir` / SDK `additionalDirectories`
1446- Fixed Remote Control stop/interrupt from claude.ai not fully canceling the CLI session the same way local Esc does, causing queued messages to never advance after interrupting a stuck tool or prompt
1447- Fixed `/effort` in one session unexpectedly changing the effort level of other concurrent sessions, and a related issue where an IDE effort change could be silently dropped
1448- Fixed subagents not discovering project, user, or plugin skills via the Skill tool
1449- `claude --help` now lists `--remote-control` alongside `--remote-control-session-name-prefix`
1450- [VSCode] Fixed `claudeCode.claudeProcessWrapper` failing with "Unsupported platform" when the extension build doesn't bundle a Claude binary
1451
1452## 2.1.132
1453
1454- Added `CLAUDE_CODE_SESSION_ID` environment variable to the Bash tool subprocess environment, matching the `session_id` passed to hooks
1455- Added `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1` env var to opt out of the fullscreen alternate-screen renderer and keep the conversation in the terminal's native scrollback
1456- Added a "Pasting…" footer hint while a Ctrl+V image paste is being read from the clipboard
1457- Fixed external SIGINT (e.g. IDE stop button, `kill -INT`) not running graceful shutdown — terminal modes are now restored and the `--resume` hint is printed instead of an abrupt exit
1458- Fixed an uncaught exception when the terminal is closed or SSH disconnects mid-session under the native build
1459- Fixed `--resume` failing with `no low surrogate in string` when a tool error truncation split an emoji; pre-corrupted sessions are sanitized on load
1460- Fixed `--permission-mode` flag being ignored when resuming a plan-mode session with `-p --continue`/`--resume`, and plan mode not being re-applied after `ExitPlanMode` within the same session
1461- Fixed fullscreen mode showing a blank screen after laptop sleep/wake or Ctrl+Z/`fg` until the next keystroke or stream output
1462- Fixed cursor landing mid-grapheme on Ctrl+E/A/K/U/arrow keys when an Indic conjunct or ZWJ emoji wraps across lines
1463- Fixed vim operators corrupting text containing decomposed (NFD) accented characters
1464- Fixed pasting text starting with `/` silently swallowing the input or triggering an unknown-command reply
1465- Fixed pasting dumping stray escape sequences into the prompt when focus events or mouse-tracking reports interleave with the bracketed paste
1466- Fixed mouse wheel scrolling being too fast in Cursor and VS Code 1.92–1.104 due to an upstream xterm.js bug
1467- Fixed scroll-wheel handling in JetBrains IDE 2025.2 terminals (spurious arrow keys, wrong-direction events, runaway acceleration)
1468- Fixed `/usage` Ctrl+S hanging when copying the stats screenshot to the clipboard on Linux/X11
1469- Fixed `/terminal-setup` showing a contradictory error in Windows Terminal — Shift+Enter is natively supported there
1470- Fixed `/effort` picker not reflecting the `CLAUDE_CODE_EFFORT_LEVEL` env var override
1471- Fixed `/status` showing the wrong default model for some users
1472- Fixed slash command autocomplete popup being capped at ~3–5 visible commands instead of scaling with terminal height
1473- Fixed statusline `context_window` token counts reflecting cumulative session totals instead of current context usage
1474- Fixed Alt+T (thinking toggle) not working on macOS terminals without "Option as Meta" enabled (iTerm2, Terminal.app defaults)
1475- Fixed dead keyboard input on Windows after re-opening a background session from `claude agents`
1476- Fixed unbounded memory growth (10GB+ RSS) when a stdio MCP server writes non-protocol data to stdout
1477- Fixed MCP servers that connect but fail `tools/list` silently showing 0 tools — they now retry once and show "connected · tools fetch failed" in `/mcp`
1478- Fixed unauthorized claude.ai MCP connectors showing as "failed" instead of "needs auth", and headless `-p` mode retrying non-transient 4xx connection failures
1479- Improved visual consistency in slash command dialogs and `/login`, `/upgrade`, `/extra-usage` dialog spacing
1480- Updated the `/tui fullscreen` startup banner to describe additional renderer benefits (lower memory usage, mouse support, auto-copy on select)
1481- Fixed Bedrock and Vertex 400 errors when `ENABLE_PROMPT_CACHING_1H` is set
1482
1483## 2.1.131
1484
1485- Fixed VS Code extension failing to activate on Windows due to a hardcoded build path in the bundled SDK (`createRequire` polyfill bug)
1486- Fixed Mantle endpoint authentication failing with missing `x-api-key` header
1487
1488## 2.1.129
1489
1490- Added `--plugin-url <url>` flag to fetch a plugin `.zip` archive from a URL for the current session
1491- Added `CLAUDE_CODE_FORCE_SYNC_OUTPUT=1` env var to force-enable synchronized output on terminals that auto-detection misses (e.g. Emacs `eat`)
1492- Added `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`: when set on Homebrew or WinGet installations, Claude Code runs the upgrade command in the background and prompts to restart
1493- Plugin manifests: `themes` and `monitors` should now be declared under `"experimental": { ... }`. Top-level declarations still work but `claude plugin validate` will warn
1494- Gateway `/v1/models` discovery for the `/model` picker is now opt-in via `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` (was automatic in 2.1.126–2.1.128)
1495- Ctrl+R history picker now defaults to searching all prompts across all projects, matching pre-2.1.124 behavior. Press Ctrl+S to narrow to the current project or session
1496- Third-party deployments (Bedrock, Vertex, Foundry, or `ANTHROPIC_BASE_URL` gateway) no longer see spinner tips pointing at first-party Anthropic surfaces
1497- `skillOverrides` setting now works: `off` hides from model and `/`, `user-invocable-only` hides from model only, `name-only` collapses description
1498- The `claude_code.pull_request.count` OTel metric now counts PRs/MRs created via MCP tools, not just shell commands
1499- Policy refusal error messages now include the API Request ID for easier support debugging
1500- Fixed API errors with unrecognized 400 status codes showing raw JSON instead of the underlying error message
1501- Fixed `/clear` not resetting the terminal tab title after a conversation
1502- Fixed session title chip from `/rename` disappearing while a permission or other dialog is active
1503- Fixed agent panel below the prompt being hidden when subagents are running (regression in 2.1.122)
1504- Fixed external-editor handoff (Ctrl+G) blanking the conversation history above the prompt
1505- Fixed `/context` dumping its rendered ASCII visualization grid into the conversation, wasting ~1.6k tokens per call
1506- Fixed `/agents` Library list arrow-key navigation: the highlighted agent now stays visible when the list exceeds the viewport
1507- Fixed `/branch` success message not including the new branch's session id for `/resume`
1508- Fixed bold headers with keycap/ZWJ/skin-tone emoji losing trailing characters in fullscreen mode
1509- Fixed server-managed settings policy not applying for enterprise/team users whose stored OAuth credentials lacked the `user:inference` scope
1510- Fixed OAuth refresh race after wake-from-sleep that could log out all running sessions
1511- Fixed 1-hour prompt cache TTL being silently downgraded to 5 minutes
1512- Fixed cache-miss warning appearing spuriously after `/clear` or compaction when changing `/effort` or `/model`
1513- Fixed `Bash(mkdir *)`, `Bash(touch *)` and similar allow rules not being honored for in-project paths
1514- Fixed `deniedMcpServers` patterns with a `*://` scheme wildcard not matching mixed-case hostnames
1515- Fixed harmless WebSocket warning being logged as an error in `--debug` during voice mode
1516- [VSCode] Fixed `/clear` not clearing the conversation context and displayed transcript
1517
1518## 2.1.128
1519
1520- Bare `/color` (no args) now picks a random session color
1521- `/mcp` now shows the tool count for connected servers and flags servers that connected with 0 tools
1522- `--plugin-dir` now accepts `.zip` plugin archives in addition to directories
1523- `--channels` now works with console (API key) authentication — console orgs with managed settings must set `channelsEnabled: true` to enable
1524- Updated `/model` picker: collapsed duplicate Opus 4.7 entries, and current Opus now shows as "Opus" instead of "Opus 4.7"
1525- Subprocesses (Bash, hooks, MCP, LSP) no longer inherit `OTEL_*` environment variables, so OTEL-instrumented apps run via the Bash tool no longer pick up the CLI's own OTLP endpoint
1526- MCP: `workspace` is now a reserved server name — existing servers with that name will be skipped with a warning
1527- Reconnecting MCP servers no longer flood the conversation with full tool-name lists on every reconnect — re-announced tools are summarized by server prefix
1528- SDK hosts now receive a persistent `localSettings` suggestion for Bash permission prompts, so "Always allow" writes to `.claude/settings.local.json`
1529- `EnterWorktree` now creates the new branch from local HEAD as documented, instead of `origin/<default-branch>` — unpushed commits are no longer dropped
1530- Auto mode: when the classifier can't evaluate an action, the error now includes a hint (retry, `/compact`, or run with `--debug`)
1531- Fixed focus mode briefly dimming the previous response when submitting a new prompt
1532- Fixed stray "4;0;" desktop notification on every `/exit` in Kitty and other terminals that interpret OSC 9 as a notification
1533- Fixed Remote Control showing an empty "Opening your options…" message on rate limit instead of actionable upsell options
1534- Fixed drag-and-drop image upload hanging on "Pasting text…" when the image read fails
1535- Fixed crash loop when piping very large input (>10 MB) to `claude -p` via stdin
1536- Fixed long URLs not being individually clickable on every wrapped row in fullscreen mode
1537- Fixed `/plugin` Components panel showing "Marketplace 'inline' not found" for plugins loaded via `--plugin-dir`
1538- Fixed MCP tool results dropping images when the server returns both structured content and content blocks
1539- Fixed fenced code blocks inside list items carrying leading whitespace into the clipboard on copy-paste
1540- Fixed tab navigation in `/config` stranding focus — the tab header now stays focused so arrows and Esc keep working
1541- Fixed markdown link labels being lost on terminals without OSC 8 hyperlink support — links now render as `label (url)` instead of just the URL
1542- Fixed sessions on 1M-context models with a smaller autocompact window being falsely blocked with "Prompt is too long" before reaching the actual API limit
1543- Fixed parallel shell tool calls: a failing read-only command (grep, git diff, ls) no longer cancels sibling calls
1544- Fixed banner showing "with X effort" on models that don't support effort
1545- Fixed `/fast` on 3P providers fuzzy-matching to an unrelated skill instead of showing "not available"
1546- Fixed Bedrock default model resolving to `global.*` instead of the region-appropriate prefix
1547- Fixed vim mode: `Space` in NORMAL mode now moves the cursor right, matching standard vi/vim behavior
1548- Fixed terminal progress indicator (OSC 9;4) flickering off between tool calls — stays visible across the full turn
1549- Fixed `/rename` without args failing on resumed sessions whose last entry is a compact boundary
1550- Fixed stale "remote-control is active" status lines from prior sessions appearing after `--resume`/`--continue`
1551- Fixed stale `installed_plugins.json` entries pointing at deleted cache directories polluting PATH
1552- Fixed MCP stdio servers receiving corrupted arguments when `CLAUDE_CODE_SHELL_PREFIX` is set and an argument contains spaces or shell metacharacters
1553- Fixed sub-agent progress summaries missing the prompt cache (~3× `cache_creation` reduction)
1554- Fixed `/plugin update` never detecting new versions of npm-sourced plugins
1555- Fixed sub-agent summaries firing repeatedly while a sub-agent's transcript is static, capping worst-case token cost on idle sub-agents
1556- Headless `--output-format stream-json`: `init.plugin_errors` now includes `--plugin-dir` load failures in addition to dependency demotions
1557
1558## 2.1.126
1559
1560- The `/model` picker now lists models from your gateway's `/v1/models` endpoint when `ANTHROPIC_BASE_URL` points at an Anthropic-compatible gateway
1561- - Added `claude project purge [path]` to delete all Claude Code state for a project (transcripts, tasks, file history, config entry) — supports `--dry-run`, `-y/--yes`, `-i/--interactive`, and `--all`
1562- `--dangerously-skip-permissions` now bypasses prompts for writes to `.claude/`, `.git/`, `.vscode/`, shell config files, and other previously-protected paths (catastrophic removal commands still prompt as a safety net)
1563- `claude auth login` now accepts the OAuth code pasted into the terminal when the browser callback can't reach localhost (WSL2, SSH, containers)
1564- `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"`)
1565- Auto mode: the spinner now turns red when a permission check stalls, instead of looking like the tool is running
1566- Host-managed deployments (`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`) no longer auto-disable analytics on Bedrock/Vertex/Foundry
1567- Windows: PowerShell 7 installed via the Microsoft Store, MSI without PATH, or `.NET global tool` is now detected
1568- Windows: when the PowerShell tool is enabled, Claude now treats PowerShell as the primary shell instead of defaulting to Bash
1569- Read tool: removed the per-file malware-assessment reminder that could cause spurious refusals and "this is not malware" commentary on legacy models
1570- **Security:** Fixed `allowManagedDomainsOnly` / `allowManagedReadPathsOnly` being ignored when a higher-priority managed-settings source lacked a `sandbox` block
1571- Fixed pasting an image larger than 2000px breaking the session — images are now downscaled on paste, and oversized images in history are automatically removed and the request retried
1572- Fixed showing the login screen for "OAuth not allowed for organization" errors — now shows guidance to contact your admin
1573- Fixed OAuth login failing with timeout on slow or proxied connections, in IPv6-only devcontainers, and when the browser callback can't reach localhost
1574- Fixed a rare race where a concurrent credential write could clear a valid OAuth refresh token
1575- Fixed API retry countdown sticking at "0s" instead of counting down between attempts
1576- Fixed "Stream idle timeout" error after waking Mac from sleep mid-request
1577- Fixed background and remote sessions falsely aborting with "Stream idle timeout" during long model thinking pauses
1578- Fixed a hang where the assistant could finish thinking but show no output after a run of empty turns
1579- Fixed overly fast trackpad scrolling in Cursor and VS Code 1.92–1.104 integrated terminals
1580- Fixed claude.ai MCP connectors being suppressed by manual servers stuck in needs-auth state
1581- Fixed Japanese/Korean/Chinese text rendering as garbled characters on Windows in no-flicker mode
1582- Fixed `Ctrl+L` clearing the prompt input — it now only forces a screen redraw, matching readline behavior
1583- Fixed deferred tools (WebSearch, WebFetch, etc.) not being available to skills with `context: fork` and other subagents on their first turn
1584- Fixed plan-mode tools being unavailable in interactive sessions launched with `--channels`
1585- Fixed `/plugin` Uninstall reporting "Enabled" instead of "Uninstalled"
1586- Bounded total size of file-modified reminders when a linter touches many files at once
1587- Fixed `/remote-control` retries appearing stuck on "connecting…" — each retry now shows its result
1588- Fixed Remote Control failure notification not showing the error reason for initial connection failures
1589- Windows: clipboard writes no longer expose copied content in process command-line arguments visible to EDR/SIEM telemetry; also fixes >22KB selections not reaching the clipboard
1590- PowerShell tool: bare `--` (e.g. `git diff -- file`) is no longer mis-flagged as the `--%` stop-parsing token
1591- Fixed Agent SDK hang when the model emits a malformed tool name in a parallel tool call batch
1592
1593## 2.1.123
1594
1595- Fixed OAuth authentication failing with a 401 retry loop when `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` is set
1596
1597## 2.1.122
1598
1599- Added `ANTHROPIC_BEDROCK_SERVICE_TIER` environment variable to select a Bedrock service tier (`default`, `flex`, or `priority`), sent as the `X-Amzn-Bedrock-Service-Tier` header
1600- Pasting a PR URL into the `/resume` search box now finds the session that created that PR (GitHub, GitHub Enterprise, GitLab, and Bitbucket)
1601- `/mcp` now shows claude.ai connectors hidden by a manually-added server with the same URL, with a hint to remove the duplicate
1602- Clarified the `/mcp` message shown when an MCP server is still unauthorized after the browser sign-in flow
1603- OpenTelemetry: numeric attributes on `api_request`/`api_error` log events are now emitted as numbers, not strings
1604- OpenTelemetry: added `claude_code.at_mention` log event for `@`-mention resolution
1605- Fixed `/branch` producing forks that fail with "tool_use ids were found without tool_result blocks" when the source session contained entries from rewound timelines
1606- Fixed `/model` not showing the Effort option for Bedrock application inference profile ARNs, and those ARNs not receiving `output_config.effort`
1607- Fixed Vertex AI / Bedrock returning `invalid_request_error: output_config: Extra inputs are not permitted` on session-title generation and other structured-output queries
1608- Fixed Vertex AI `count_tokens` endpoint returning 400 errors for users behind proxy gateways
1609- Fixed `spinnerTipsOverride.excludeDefault` not suppressing the time-based spinner tips
1610- Fixed ToolSearch missing MCP tools that connected after session start in nonblocking mode
1611- Fixed `!exit` / `!quit` in bash mode terminating the CLI instead of running as a shell command
1612- Fixed images sent to newer models being resized to 2576px per side instead of the correct 2000px maximum
1613- Fixed remote control session idle status redrawing twice per second, which could flood `tmux -CC` control pipes and pause the terminal
1614- Fixed assistant messages appearing blank in some sessions due to a stale view preference
1615- Fixed a malformed hooks entry in `settings.json` no longer invalidating the entire file
1616- Voice mode: keybindings bound to Caps Lock now show an error since terminals don't deliver Caps Lock as a key event
1617
1618## 2.1.121
1619
1620- Added `alwaysLoad` option to MCP server config — when `true`, all tools from that server skip tool-search deferral and are always available
1621- Added `claude plugin prune` to remove orphaned auto-installed plugin dependencies; `plugin uninstall --prune` cascades
1622- Added a type-to-filter search box to `/skills` so you can find a skill in long lists without scrolling
1623- PostToolUse hooks can now replace tool output for all tools via `hookSpecificOutput.updatedToolOutput` (previously MCP-only)
1624- Fullscreen mode: typing into the prompt no longer jumps scroll back to the bottom after you've scrolled up to read earlier output
1625- Dialogs that overflow the terminal are now scrollable with arrow keys, PgUp/PgDn, home/end, and mouse wheel in both fullscreen and non-fullscreen modes
1626- Clicking any line of a long URL that wraps across rows in fullscreen mode now opens the full URL
1627- SDK and `claude -p`: `CLAUDE_CODE_FORK_SUBAGENT=1` now works in non-interactive sessions
1628- `--dangerously-skip-permissions` no longer prompts for writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/`
1629- `/terminal-setup` now enables iTerm2's "Applications in terminal may access clipboard" setting so `/copy` works, including from tmux
1630- MCP servers that hit a transient error during startup now auto-retry up to 3 times instead of staying disconnected
1631- The terminal tab session title is now generated in your configured `language` setting
1632- Claude.ai connectors with the same upstream URL are now deduplicated instead of appearing as duplicates
1633- Vertex AI: support X.509 certificate-based Workload Identity Federation (mTLS ADC)
1634- Faster startup after upgrading: removed the Recent Activity panel from the release-notes splash
1635- LSP diagnostic summaries now expand on click/ctrl+o and show the expand hint
1636- SDK: `mcp_authenticate` now supports `redirectUri` for custom scheme completion and claude.ai connectors
1637- OpenTelemetry: added `stop_reason`, `gen_ai.response.finish_reasons`, and `user_system_prompt` (gated behind `OTEL_LOG_USER_PROMPTS`) to LLM request spans
1638- [VSCode] Voice dictation now respects the `accessibility.voice.speechLanguage` setting when no Claude Code language is configured
1639- [VSCode] `/context` now opens a native token usage dialog
1640- Fixed unbounded memory growth (multi-GB RSS) when processing many images in a session
1641- Fixed `/usage` leaking up to ~2GB of memory on machines with large transcript histories
1642- Fixed memory leak when long-running tools fail to emit a clear progress event
1643- Fixed Bash tool becoming permanently unusable when the directory Claude was started in is deleted or moved mid-session
1644- Fixed `--resume` crashing on startup in external builds
1645- Fixed `--resume` failing on large sessions when a transcript line was corrupted by an unclean shutdown — the corrupt line is now skipped
1646- Fixed `thinking.type.enabled is not supported` error when using Bedrock application inference profile ARNs
1647- Fixed Microsoft 365 MCP OAuth failing with duplicate or unsupported `prompt` parameter
1648- Fixed scrollback duplication when pressing Ctrl+L or triggering a redraw in non-fullscreen mode on tmux, GNOME Terminal, Windows Terminal, and Konsole
1649- Fixed claude.ai MCP connectors silently disappearing when the connector-list fetch hits a transient auth error at startup
1650- Fixed "Always allow" rules for built-in tools in remote sessions not surviving worker restarts
1651- Fixed `NO_PROXY` not being respected for all HTTP clients when set via `managed-settings.json` under the native build
1652- Fixed managed settings approval prompt exiting the session even when accepted — now applies settings and continues
1653- Fixed `/usage` returning "rate limited" after a stale OAuth token — now refreshes automatically
1654- Fixed invalid legacy enum values in `settings.json` invalidating the entire settings file
1655- Fixed `/usage` dialog content being clipped when no-flicker mode is off
1656- Fixed `/focus` showing "Unknown command" when the fullscreen renderer is off — now explains how to enable it
1657- Fixed embedded grep/find/rg shell wrappers failing when the running binary is deleted mid-session — now falls back to installed tools
1658- Reduced peak file descriptor usage during `find` in the Bash tool on large directory trees
1659
1660## 2.1.120
1661
1662- Windows: Git for Windows (Git Bash) is no longer required — when absent, Claude Code uses PowerShell as the shell tool
1663- Added `claude ultrareview [target]` subcommand to run `/ultrareview` non-interactively from CI or scripts — prints findings to stdout (`--json` for raw output) and exits 0 on completion or 1 on failure
1664- Skills can now reference the current effort level with `${CLAUDE_EFFORT}` in their content
1665- Set `AI_AGENT` environment variable for subprocesses so `gh` can attribute traffic to Claude Code
1666- Spinner tips that recommend installing the desktop app or creating skills/agents are now hidden when you already have them
1667- Show a "use PgUp/PgDn to scroll" hint when the terminal sends arrow keys instead of scroll events
1668- Faster session start when you have many claude.ai connectors configured but not authorized
1669- The auto mode denial message now links to the configuration docs
1670- `claude plugin validate` now accepts `$schema`, `version`, and `description` at the top level of `marketplace.json` and `$schema` in `plugin.json`
1671- Auto-compact in auto mode now displays `auto` (lowercase, no token count) instead of a misleading token value
1672- Fixed pressing Esc during a stdio MCP tool call closing the entire server connection (regression in 2.1.105)
1673- Fixed `/rewind` and other interactive overlays not responding to keyboard input after launching with `claude --resume`
1674- Fixed terminal scrollback duplication in non-fullscreen mode (resize, dialog dismiss, long sessions)
1675- Fixed `DISABLE_TELEMETRY` / `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` not suppressing usage metrics telemetry for API and enterprise users
1676- Fixed false-positive "Dangerous rm operation" permission prompts in auto mode for multi-line bash commands containing both a pipe and a redirect
1677- Fixed long selection menus clipping below the terminal in fullscreen mode — the focused option now stays on screen as you scroll
1678- Fixed Write tool output collapsing instead of expanding when clicking "+N lines" in fullscreen
1679- Fixed slash command picker jumping while typing, and improved highlight to only match contiguous substrings in blue
1680- Fixed `/plugin` marketplace failing to load when one entry uses an unrecognized source format — that entry is shown but installing it prompts you to update
1681- [VSCode] `/usage` now opens the native Account & Usage dialog instead of returning plain-text session cost
1682- [VSCode] Voice dictation now respects the `language` setting in `~/.claude/settings.json`
1683- Fixed `find` in the Bash tool exhausting open file descriptors on large directory trees, causing host-wide crashes (macOS/Linux native builds)
1684
1685## 2.1.119
1686
1687- `/config` settings (theme, editor mode, verbose, etc.) now persist to `~/.claude/settings.json` and participate in project/local/policy override precedence
1688- Added `prUrlTemplate` setting to point the footer PR badge at a custom code-review URL instead of github.com
1689- Added `CLAUDE_CODE_HIDE_CWD` environment variable to hide the working directory in the startup logo
1690- `--from-pr` now accepts GitLab merge-request, Bitbucket pull-request, and GitHub Enterprise PR URLs
1691- `--print` mode now honors the agent's `tools:` and `disallowedTools:` frontmatter, matching interactive-mode behavior
1692- `--agent <name>` now honors the agent definition's `permissionMode` for built-in agents
1693- PowerShell tool commands can now be auto-approved in permission mode, matching Bash behavior
1694- Hooks: `PostToolUse` and `PostToolUseFailure` hook inputs now include `duration_ms` (tool execution time, excluding permission prompts and PreToolUse hooks)
1695- Subagent and SDK MCP server reconfiguration now connects servers in parallel instead of serially
1696- Plugins pinned by another plugin's version constraint now auto-update to the highest satisfying git tag
1697- Vim mode: Esc in INSERT no longer pulls a queued message back into the input; press Esc again to interrupt
1698- Slash command suggestions now highlight the characters that matched your query
1699- Slash command picker now wraps long descriptions onto a second line instead of truncating
1700- `owner/repo#N` shorthand links in output now use your git remote's host instead of always pointing at github.com
1701- Security: `blockedMarketplaces` now correctly enforces `hostPattern` and `pathPattern` entries
1702- OpenTelemetry: `tool_result` and `tool_decision` events now include `tool_use_id`; `tool_result` also includes `tool_input_size_bytes`
1703- Status line: stdin JSON now includes `effort.level` and `thinking.enabled`
1704- Fixed pasting CRLF content (Windows clipboards, Xcode console) inserting an extra blank line between every line
1705- Fixed multi-line paste losing newlines in terminals using kitty keyboard protocol sequences inside bracketed paste
1706- Fixed Glob and Grep tools disappearing on native macOS/Linux builds when the Bash tool is denied via permissions
1707- Fixed scrolling up in fullscreen mode snapping back to the bottom every time a tool finishes
1708- Fixed MCP HTTP connections failing with "Invalid OAuth error response" when servers returned non-JSON bodies for OAuth discovery requests
1709- Fixed Rewind overlay showing "(no prompt)" for messages with image attachments
1710- Fixed auto mode overriding plan mode with conflicting "Execute immediately" instructions
1711- Fixed async `PostToolUse` hooks that emit no response payload writing empty entries to the session transcript
1712- Fixed spinner staying on when a subagent task notification is orphaned in the queue
1713- Tool search is now disabled by default on Vertex AI to avoid an unsupported beta header error (opt in with `ENABLE_TOOL_SEARCH`)
1714- Fixed `@`-file Tab completion replacing the entire prompt when used inside a slash command with an absolute path
1715- Fixed a stray `p` character appearing at the prompt on startup in macOS Terminal.app via Docker or SSH
1716- Fixed `${ENV_VAR}` placeholders in `headers` for HTTP/SSE/WebSocket MCP servers not being substituted before requests
1717- Fixed MCP OAuth client secret stored via `--client-secret` not being sent during token exchange for servers requiring `client_secret_post`
1718- Fixed `/skills` Enter key closing the dialog instead of pre-filling `/<skill-name>` in the prompt
1719- Fixed `/agents` detail view mislabeling built-in tools unavailable to subagents as "Unrecognized"
1720- Fixed MCP servers from plugins not spawning on Windows when the plugin cache was incomplete
1721- Fixed `/export` showing the current default model instead of the model the conversation actually used
1722- Fixed verbose output setting not persisting after restart
1723- Fixed `/usage` progress bars overlapping with their "Resets …" labels
1724- Fixed plugin MCP servers failing when `${user_config.*}` references an optional field left blank
1725- Fixed list items containing a sentence-final number wrapping the number onto its own line
1726- Fixed `/plan` and `/plan open` not acting on the existing plan when entering plan mode
1727- Fixed skills invoked before auto-compaction being re-executed against the next user message
1728- Fixed `/reload-plugins` and `/doctor` reporting load errors for disabled plugins
1729- Fixed Agent tool with `isolation: "worktree"` reusing stale worktrees from prior sessions
1730- Fixed disabled MCP servers appearing as "failed" in `/status`
1731- Fixed `TaskList` returning tasks in arbitrary filesystem order instead of sorted by ID
1732- Fixed spurious "GitHub API rate limit exceeded" hints when `gh` output contained PR titles mentioning "rate limit"
1733- Fixed SDK/bridge `read_file` not correctly enforcing size cap on growing files
1734- Fixed PR not linked to session when working in a git worktree
1735- Fixed `/doctor` warning about MCP server entries overridden by a higher-precedence scope
1736- Windows: removed false-positive "Windows requires 'cmd /c' wrapper" MCP config warning
1737- [VSCode] Fixed voice dictation's first recording producing nothing on macOS while the microphone permission prompt is showing
1738
1739## 2.1.118
1740
1741- Added vim visual mode (`v`) and visual-line mode (`V`) with selection, operators, and visual feedback
1742- Merged `/cost` and `/stats` into `/usage` — both remain as typing shortcuts that open the relevant tab
1743- Create and switch between named custom themes from `/theme`, or hand-edit JSON files in `~/.claude/themes/`; plugins can also ship themes via a `themes/` directory
1744- Hooks can now invoke MCP tools directly via `type: "mcp_tool"`
1745- Added `DISABLE_UPDATES` env var to completely block all update paths including manual `claude update` — stricter than `DISABLE_AUTOUPDATER`
1746- WSL on Windows can now inherit Windows-side managed settings via the `wslInheritsWindowsSettings` policy key
1747- Auto mode: include `"$defaults"` in `autoMode.allow`, `autoMode.soft_deny`, or `autoMode.environment` to add custom rules alongside the built-in list instead of replacing it
1748- Added a "Don't ask again" option to the auto mode opt-in prompt
1749- Added `claude plugin tag` to create release git tags for plugins with version validation
1750- `--continue`/`--resume` now find sessions that added the current directory via `/add-dir`
1751- `/color` now syncs the session accent color to claude.ai/code when Remote Control is connected
1752- The `/model` picker now honors `ANTHROPIC_DEFAULT_*_MODEL_NAME`/`_DESCRIPTION` overrides when using a custom `ANTHROPIC_BASE_URL` gateway
1753- When auto-update skips a plugin due to another plugin's version constraint, the skip now appears in `/doctor` and the `/plugin` Errors tab
1754- Fixed `/mcp` menu hiding OAuth Authenticate/Re-authenticate actions for servers configured with `headersHelper`, and HTTP/SSE MCP servers with custom headers being stuck in "needs authentication" after a transient 401
1755- Fixed MCP servers whose OAuth token response omits `expires_in` requiring re-authentication every hour
1756- Fixed MCP step-up authorization silently refreshing instead of prompting for re-consent when the server's `insufficient_scope` 403 names a scope the current token already has
1757- Fixed an unhandled promise rejection when an MCP server's OAuth flow times out or is cancelled
1758- Fixed MCP OAuth refresh proceeding without its cross-process lock under contention
1759- Fixed macOS keychain race where a concurrent MCP token refresh could overwrite a freshly-refreshed OAuth token, causing unexpected "Please run /login" prompts
1760- Fixed OAuth token refresh failing when the server revokes a token before its local expiry time
1761- Fixed credential save crash on Linux/Windows corrupting `~/.claude/.credentials.json`
1762- Fixed `/login` having no effect in a session launched with `CLAUDE_CODE_OAUTH_TOKEN` — the env token is now cleared so disk credentials take effect
1763- Fixed unreadable text in the "new messages" scroll pill and `/plugin` badges
1764- Fixed plan acceptance dialog offering "auto mode" instead of "bypass permissions" when running with `--dangerously-skip-permissions`
1765- Fixed agent-type hooks failing with "Messages are required for agent hooks" when configured for events other than `Stop` or `SubagentStop`
1766- Fixed `prompt` hooks re-firing on tool calls made by an agent-hook verifier subagent
1767- Fixed `/fork` writing the full parent conversation to disk per fork — now writes a pointer and hydrates on read
1768- Fixed Alt+K / Alt+X / Alt+^ / Alt+_ freezing keyboard input
1769- Fixed connecting to a remote session overwriting your local `model` setting in `~/.claude/settings.json`
1770- Fixed typeahead showing "No commands match" error when pasting file paths that start with `/`
1771- Fixed `plugin install` on an already-installed plugin not re-resolving a dependency installed at the wrong version
1772- Fixed unhandled errors from file watcher on invalid paths or fd exhaustion
1773- Fixed Remote Control sessions getting archived on transient CCR initialization blips during JWT refresh
1774- Fixed subagents resumed via `SendMessage` not restoring the explicit `cwd` they were spawned with
1775
1776## 2.1.117
1777
1778- Forked subagents can now be enabled on external builds by setting `CLAUDE_CODE_FORK_SUBAGENT=1`
1779- Agent frontmatter `mcpServers` are now loaded for main-thread agent sessions via `--agent`
1780- Improved `/model`: selections now persist across restarts even when the project pins a different model, and the startup header shows when the active model comes from a project or managed-settings pin
1781- The `/resume` command now offers to summarize stale, large sessions before re-reading them, matching the existing `--resume` behavior
1782- Faster startup when both local and claude.ai MCP servers are configured (concurrent connect now default)
1783- `plugin install` on an already-installed plugin now installs any missing dependencies instead of stopping at "already installed"
1784- Plugin dependency errors now say "not installed" with an install hint, and `claude plugin marketplace add` now auto-resolves missing dependencies from configured marketplaces
1785- Managed-settings `blockedMarketplaces` and `strictKnownMarketplaces` are now enforced on plugin install, update, refresh, and autoupdate
1786- Advisor Tool (experimental): dialog now carries an "experimental" label, learn-more link, and startup notification when enabled; sessions no longer get stuck with "Advisor tool result content could not be processed" errors on every prompt and `/compact`
1787- The `cleanupPeriodDays` retention sweep now also covers `~/.claude/tasks/`, `~/.claude/shell-snapshots/`, and `~/.claude/backups/`
1788- 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 when the model supports effort levels. Custom/MCP command names are redacted unless `OTEL_LOG_TOOL_DETAILS=1` is set
1789- Native builds on macOS and Linux: the `Glob` and `Grep` tools are replaced by embedded `bfs` and `ugrep` available through the Bash tool — faster searches without a separate tool round-trip (Windows and npm-installed builds unchanged)
1790- Windows: cached `where.exe` executable lookups per process for faster subprocess launches
1791- Default effort for Pro/Max subscribers on Opus 4.6 and Sonnet 4.6 is now `high` (was `medium`)
1792- Fixed Plain-CLI OAuth sessions dying with "Please run /login" when the access token expires mid-session — the token is now refreshed reactively on 401
1793- Fixed `WebFetch` hanging on very large HTML pages by truncating input before HTML-to-markdown conversion
1794- Fixed a crash when a proxy returns HTTP 204 No Content — now surfaces a clear error instead of a `TypeError`
1795- Fixed `/login` having no effect when launched with `CLAUDE_CODE_OAUTH_TOKEN` env var and that token expires
1796- Fixed prompt-input undo (`Ctrl+_`) doing nothing immediately after typing, and skipping a state on each undo step
1797- Fixed `NO_PROXY` not being respected for remote API requests when running under Bun
1798- Fixed rare spurious escape/return triggers when key names arrive as coalesced text over slow connections
1799- Fixed SDK `reload_plugins` reconnecting all user MCP servers serially
1800- Fixed Bedrock application-inference-profile requests failing with 400 when backed by Opus 4.7 with thinking disabled
1801- Fixed MCP `elicitation/create` requests auto-cancelling in print/SDK mode when the server finishes connecting mid-turn
1802- Fixed subagents running a different model than the main agent incorrectly flagging file reads with a malware warning
1803- Fixed idle re-render loop when background tasks are present, reducing memory growth on Linux
1804- [VSCode] Fixed "Manage Plugins" panel breaking when multiple large marketplaces are configured
1805- Fixed Opus 4.7 sessions showing inflated `/context` percentages and autocompacting too early — Claude Code was computing against a 200K context window instead of Opus 4.7's native 1M
1806
1807## 2.1.116
1808
1809- `/resume` on large sessions is significantly faster (up to 67% on 40MB+ sessions) and handles sessions with many dead-fork entries more efficiently
1810- Faster MCP startup when multiple stdio servers are configured; `resources/templates/list` is now deferred to first `@`-mention
1811- Smoother fullscreen scrolling in VS Code, Cursor, and Windsurf terminals — `/terminal-setup` now configures the editor's scroll sensitivity
1812- Thinking spinner now shows progress inline ("still thinking", "thinking more", "almost done thinking"), replacing the separate hint row
1813- `/config` search now matches option values (e.g. searching "vim" finds the Editor mode setting)
1814- `/doctor` can now be opened while Claude is responding, without waiting for the current turn to finish
1815- `/reload-plugins` and background plugin auto-update now auto-install missing plugin dependencies from marketplaces you've already added
1816- Bash tool now surfaces a hint when `gh` commands hit GitHub's API rate limit, so agents can back off instead of retrying
1817- The Usage tab in Settings now shows your 5-hour and weekly usage immediately and no longer fails when the usage endpoint is rate-limited
1818- Agent frontmatter `hooks:` now fire when running as a main-thread agent via `--agent`
1819- Slash command menu now shows "No commands match" when your filter has zero results, instead of disappearing
1820- Security: sandbox auto-allow no longer bypasses the dangerous-path safety check for `rm`/`rmdir` targeting `/`, `$HOME`, or other critical system directories
1821- Claude Code and installer now use `https://downloads.claude.ai/claude-code-releases` instead of `https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases`
1822- Fixed Devanagari and other Indic scripts rendering with broken column alignment in the terminal UI
1823- Fixed Ctrl+- not triggering undo in terminals using the Kitty keyboard protocol (iTerm2, Ghostty, kitty, WezTerm, Windows Terminal)
1824- Fixed Cmd+Left/Right not jumping to line start/end in terminals that use the Kitty keyboard protocol (Warp fullscreen, kitty, Ghostty, WezTerm)
1825- Fixed Ctrl+Z hanging the terminal when Claude Code is launched via a wrapper process (e.g. `npx`, `bun run`)
1826- Fixed scrollback duplication in inline mode where resizing the terminal or large output bursts would repeat earlier conversation history
1827- Fixed modal search dialogs overflowing the screen at short terminal heights, hiding the search box and keyboard hints
1828- Fixed scattered blank cells and disappearing composer chrome in the VS Code integrated terminal during scrolling
1829- Fixed an intermittent API 400 error related to cache control TTL ordering that could occur when a parallel request completed during request setup
1830- Fixed `/branch` rejecting conversations with transcripts larger than 50MB
1831- Fixed `/resume` silently showing an empty conversation on large session files instead of reporting the load error
1832- Fixed `/plugin` Installed tab showing the same item twice when it appears under Needs attention or Favorites
1833- Fixed `/update` and `/tui` not working after entering a worktree mid-session
1834
1835## 2.1.114
1836
1837- Fixed a crash in the permission dialog when an agent teams teammate requested tool permission
1838
1839## 2.1.113
1840
1841- Changed the CLI to spawn a native Claude Code binary (via a per-platform optional dependency) instead of bundled JavaScript
1842- Added `sandbox.network.deniedDomains` setting to block specific domains even when a broader `allowedDomains` wildcard would otherwise permit them
1843- Fullscreen mode: Shift+↑/↓ now scrolls the viewport when extending a selection past the visible edge
1844- `Ctrl+A` and `Ctrl+E` now move to the start/end of the current logical line in multiline input, matching readline behavior
1845- Windows: `Ctrl+Backspace` now deletes the previous word
1846- Long URLs in responses and bash output stay clickable when they wrap across lines (in terminals with OSC 8 hyperlinks)
1847- Improved `/loop`: pressing Esc now cancels pending wakeups, and wakeups display as "Claude resuming /loop wakeup" for clarity
1848- `/extra-usage` now works from Remote Control (mobile/web) clients
1849- Remote Control clients can now query `@`-file autocomplete suggestions
1850- Improved `/ultrareview`: faster launch with parallelized checks, diffstat in the launch dialog, and animated launching state
1851- Subagents that stall mid-stream now fail with a clear error after 10 minutes instead of hanging silently
1852- Bash tool: multi-line commands whose first line is a comment now show the full command in the transcript, closing a UI-spoofing vector
1853- Running `cd <current-directory> && git …` no longer triggers a permission prompt when the `cd` is a no-op
1854- Security: on macOS, `/private/{etc,var,tmp,home}` paths are now treated as dangerous removal targets under `Bash(rm:*)` allow rules
1855- Security: Bash deny rules now match commands wrapped in `env`/`sudo`/`watch`/`ionice`/`setsid` and similar exec wrappers
1856- Security: `Bash(find:*)` allow rules no longer auto-approve `find -exec`/`-delete`
1857- Fixed MCP concurrent-call timeout handling where a message for one tool call could silently disarm another call's watchdog
1858- Fixed Cmd-backspace / `Ctrl+U` to once again delete from the cursor to the start of the line
1859- Fixed markdown tables breaking when a cell contains an inline code span with a pipe character
1860- Fixed session recap auto-firing while composing unsent text in the prompt
1861- Fixed `/copy` "Full response" not aligning markdown table columns for pasting into GitHub, Notion, or Slack
1862- Fixed messages typed while viewing a running subagent being hidden from its transcript and misattributed to the parent AI
1863- Fixed Bash `dangerouslyDisableSandbox` running commands outside the sandbox without a permission prompt
1864- Fixed `/effort auto` confirmation — now says "Effort level set to max" to match the status bar label
1865- Fixed the "copied N chars" toast overcounting emoji and other multi-code-unit characters
1866- Fixed `/insights` crashing with `EBUSY` on Windows
1867- Fixed exit confirmation dialog mislabeling one-shot scheduled tasks as recurring — now shows a countdown
1868- Fixed slash/@ completion menu not sitting flush against the prompt border in fullscreen mode
1869- Fixed `CLAUDE_CODE_EXTRA_BODY` `output_config.effort` causing 400 errors on subagent calls to models that don't support effort and on Vertex AI
1870- Fixed prompt cursor disappearing when `NO_COLOR` is set
1871- Fixed `ToolSearch` ranking so pasted MCP tool names surface the actual tool instead of description-matching siblings
1872- Fixed compacting a resumed long-context session failing with "Extra usage is required for long context requests"
1873- Fixed `plugin install` succeeding when a dependency version conflicts with an already-installed plugin — now reports `range-conflict`
1874- Fixed "Refine with Ultraplan" not showing the remote session URL in the transcript
1875- Fixed SDK image content blocks that fail to process crashing the session — now degrade to a text placeholder
1876- Fixed Remote Control sessions not streaming subagent transcripts
1877- Fixed Remote Control sessions not being archived when Claude Code exits
1878- Fixed `thinking.type.enabled is not supported` 400 error when using Opus 4.7 via a Bedrock Application Inference Profile ARN
1879
1880## 2.1.112
1881
1882- Fixed "claude-opus-4-7 is temporarily unavailable" for auto mode
1883
1884## 2.1.111
1885
1886- Claude Opus 4.7 xhigh is now available! Use /effort to tune speed vs. intelligence
1887- Auto mode is now available for Max subscribers when using Opus 4.7
1888- Added `xhigh` effort level for Opus 4.7, sitting between `high` and `max`. Available via `/effort`, `--effort`, and the model picker; other models fall back to `high`
1889- `/effort` now opens an interactive slider when called without arguments, with arrow-key navigation between levels and Enter to confirm
1890- Added "Auto (match terminal)" theme option that matches your terminal's dark/light mode — select it from `/theme`
1891- Added `/less-permission-prompts` skill — scans transcripts for common read-only Bash and MCP tool calls and proposes a prioritized allowlist for `.claude/settings.json`
1892- Added `/ultrareview` for running comprehensive code review in the cloud using parallel multi-agent analysis and critique — invoke with no arguments to review your current branch, or `/ultrareview <PR#>` to fetch and review a specific GitHub PR
1893- Auto mode no longer requires `--enable-auto-mode`
1894- Windows: PowerShell tool is progressively rolling out. Opt in or out with `CLAUDE_CODE_USE_POWERSHELL_TOOL`. On Linux and macOS, enable with `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` (requires `pwsh` on PATH)
1895- Read-only bash commands with glob patterns (e.g. `ls *.ts`) and commands starting with `cd <project-dir> &&` no longer trigger a permission prompt
1896- Suggest the closest matching subcommand when `claude <word>` is invoked with a near-miss typo (e.g. `claude udpate` → "Did you mean `claude update`?")
1897- Plan files are now named after your prompt (e.g. `fix-auth-race-snug-otter.md`) instead of purely random words
1898- 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 "with 1M context" option for supported models
1899- `/skills` menu now supports sorting by estimated token count — press `t` to toggle
1900- `Ctrl+U` now clears the entire input buffer (previously: delete to start of line); press `Ctrl+Y` to restore
1901- `Ctrl+L` now forces a full screen redraw in addition to clearing the prompt input
1902- Transcript view footer now shows `[` (dump to scrollback) and `v` (open in editor) shortcuts
1903- The "+N lines" marker for truncated long pastes is now a full-width rule for easier scanning
1904- Headless `--output-format stream-json` now includes `plugin_errors` on the init event when plugins are demoted for unsatisfied dependencies
1905- Added `OTEL_LOG_RAW_API_BODIES` environment variable to emit full API request and response bodies as OpenTelemetry log events for debugging
1906- Suppressed spurious decompression, network, and transient error messages that could appear in the TUI during normal operation
1907- Reverted the v2.1.110 cap on non-streaming fallback retries — it traded long waits for more outright failures during API overload
1908- Fixed terminal display tearing (random characters, drifting input) in iTerm2 + tmux setups when terminal notifications are sent
1909- Fixed `@` file suggestions re-scanning the entire project on every turn in non-git working directories, and showing only config files in freshly-initialized git repos with no tracked files
1910- Fixed LSP diagnostics from before an edit appearing after it, causing the model to re-read files it just edited
1911- Fixed tab-completing `/resume` immediately resuming an arbitrary titled session instead of showing the session picker
1912- Fixed `/context` grid rendering with extra blank lines between rows
1913- Fixed `/clear` dropping the session name set by `/rename`, causing statusline output to lose `session_name`
1914- Improved plugin error handling: dependency errors now distinguish conflicting, invalid, and overly complex version requirements; fixed stale resolved versions after `plugin update`; `plugin install` now recovers from interrupted prior installs
1915- Fixed Claude calling a non-existent `commit` skill and showing "Unknown skill: commit" for users without a custom `/commit` command
1916- Fixed 429 rate-limit errors on Bedrock/Vertex/Foundry referencing status.claude.com (it only covers Anthropic-operated providers)
1917- Fixed feedback surveys appearing back-to-back after dismissing one
1918- Fixed bare URLs in bash/PowerShell/MCP tool output being unclickable when the terminal wraps them across lines
1919- Windows: `CLAUDE_ENV_FILE` and SessionStart hook environment files now apply (previously a no-op)
1920- Windows: permission rules with drive-letter paths are now correctly root-anchored, and paths differing only by drive-letter case are recognized as the same path
1921
1922## 2.1.110
1923
1924- Added `/tui` command and `tui` setting — run `/tui fullscreen` to switch to flicker-free rendering in the same conversation
1925- Added push notification tool — Claude can send mobile push notifications when Remote Control and "Push when Claude decides" config are enabled
1926- Changed `Ctrl+O` to toggle between normal and verbose transcript only; focus view is now toggled separately with the new `/focus` command
1927- Added `autoScrollEnabled` config to disable conversation auto-scroll in fullscreen mode
1928- Added option to show Claude's last response as commented context in the `Ctrl+G` external editor (enable via `/config`)
1929- Improved `/plugin` Installed tab — items needing attention and favorites appear at the top, disabled items are hidden behind a fold, and `f` favorites the selected item
1930- Improved `/doctor` to warn when an MCP server is defined in multiple config scopes with different endpoints
1931- `--resume`/`--continue` now resurrects unexpired scheduled tasks
1932- `/context`, `/exit`, and `/reload-plugins` now work from Remote Control (mobile/web) clients
1933- Write tool now informs the model when you edit the proposed content in the IDE diff before accepting
1934- Bash tool now enforces the documented maximum timeout instead of accepting arbitrarily large values
1935- SDK/headless sessions now read `TRACEPARENT`/`TRACESTATE` from the environment for distributed trace linking
1936- 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`.
1937- Fixed MCP tool calls hanging indefinitely when the server connection drops mid-response on SSE/HTTP transports
1938- Fixed non-streaming fallback retries causing multi-minute hangs when the API is unreachable
1939- Fixed session recap, local slash-command output, and other system status lines not appearing in focus mode
1940- Fixed high CPU usage in fullscreen when text is selected while a tool is running
1941- Fixed plugin install not honoring dependencies declared in `plugin.json` when the marketplace entry omits them; `/plugin` install now lists auto-installed dependencies
1942- Fixed skills with `disable-model-invocation: true` failing when invoked via `/<skill>` mid-message
1943- Fixed `--resume` sometimes showing the first prompt instead of the `/rename` name for sessions still running or exited uncleanly
1944- Fixed queued messages briefly appearing twice during multi-tool-call turns
1945- Fixed session cleanup not removing the full session directory including subagent transcripts
1946- Fixed dropped keystrokes after the CLI relaunches (e.g. `/tui`, provider setup wizards)
1947- Fixed garbled startup rendering in macOS Terminal.app and other terminals that don't support synchronized output
1948- Hardened "Open in editor" actions against command injection from untrusted filenames
1949- Fixed `PermissionRequest` hooks returning `updatedInput` not being re-checked against `permissions.deny` rules; `setMode:'bypassPermissions'` updates now respect `disableBypassPermissionsMode`
1950- Fixed `PreToolUse` hook `additionalContext` being dropped when the tool call fails
1951- Fixed stdio MCP servers that print stray non-JSON lines to stdout being disconnected on the first stray line (regression in 2.1.105)
1952- Fixed headless/SDK session auto-title firing an extra Haiku request when `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` or `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` is set
1953- Fixed potential excessive memory allocation when piped (non-TTY) Ink output contains a single very wide line
1954- Fixed `/skills` menu not scrolling when the list overflows the modal in fullscreen mode
1955- Fixed Remote Control sessions showing a generic error instead of prompting for re-login when the session is too old
1956- Fixed Remote Control session renames from claude.ai not persisting the title to the local CLI session
1957
1958## 2.1.109
1959
1960- Improved the extended-thinking indicator with a rotating progress hint
1961
1962## 2.1.108
1963
1964- Added `ENABLE_PROMPT_CACHING_1H` env var to opt into 1-hour prompt cache TTL on API key, Bedrock, Vertex, and Foundry (`ENABLE_PROMPT_CACHING_1H_BEDROCK` is deprecated but still honored), and `FORCE_PROMPT_CACHING_5M` to force 5-minute TTL
1965- Added recap feature to provide context when returning to a session, configurable in `/config` and manually invocable with `/recap`; force with `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` if telemetry disabled.
1966- The model can now discover and invoke built-in slash commands like `/init`, `/review`, and `/security-review` via the Skill tool
1967- `/undo` is now an alias for `/rewind`
1968- Improved `/model` to warn before switching models mid-conversation, since the next response re-reads the full history uncached
1969- Improved `/resume` picker to default to sessions from the current directory; press `Ctrl+A` to show all projects
1970- Improved error messages: server rate limits are now distinguished from plan usage limits; 5xx/529 errors show a link to status.claude.com; unknown slash commands suggest the closest match
1971- Reduced memory footprint for file reads, edits, and syntax highlighting by loading language grammars on demand
1972- Added "verbose" indicator when viewing the detailed transcript (`Ctrl+O`)
1973- Added a warning at startup when prompt caching is disabled via `DISABLE_PROMPT_CACHING*` environment variables
1974- Fixed paste not working in the `/login` code prompt (regression in 2.1.105)
1975- Fixed subscribers who set `DISABLE_TELEMETRY` falling back to 5-minute prompt cache TTL instead of 1 hour
1976- Fixed Agent tool prompting for permission in auto mode when the safety classifier's transcript exceeded its context window
1977- Fixed Bash tool producing no output when `CLAUDE_ENV_FILE` (e.g. `~/.zprofile`) ends with a `#` comment line
1978- Fixed `claude --resume <session-id>` losing the session's custom name and color set via `/rename`
1979- Fixed session titles showing placeholder example text when the first message is a short greeting
1980- Fixed terminal escape codes appearing as garbage text in the prompt input after `--teleport`
1981- Fixed `/feedback` retry: pressing Enter to resubmit after a failure now works without first editing the description
1982- Fixed `--teleport` and `--resume <id>` precondition errors (e.g. dirty git tree, session not found) exiting silently instead of showing the error message
1983- Fixed Remote Control session titles set in the web UI being overwritten by auto-generated titles after the third message
1984- Fixed `--resume` truncating sessions when the transcript contained a self-referencing message
1985- Fixed transcript write failures (e.g., disk full) being silently dropped instead of being logged
1986- Fixed diacritical marks (accents, umlauts, cedillas) being dropped from responses when the `language` setting is configured
1987- Fixed policy-managed plugins never auto-updating when running from a different project than where they were first installed
1988
1989## 2.1.107
1990
1991- Show thinking hints sooner during long operations
1992
1993## 2.1.105
1994
1995- Added `path` parameter to the `EnterWorktree` tool to switch into an existing worktree of the current repository
1996- Added PreCompact hook support: hooks can now block compaction by exiting with code 2 or returning `{"decision":"block"}`
1997- Added background monitor support for plugins via a top-level `monitors` manifest key that auto-arms at session start or on skill invoke
1998- `/proactive` is now an alias for `/loop`
1999- Improved stalled API stream handling: streams now abort after 5 minutes of no data and retry non-streaming instead of hanging indefinitely
2000- Improved network error messages: connection errors now show a retry message immediately instead of a silent spinner
2001- Improved file write display: long single-line writes (e.g. minified JSON) are now truncated in the UI instead of paginating across many screens
2002- Improved `/doctor` layout with status icons; press `f` to have Claude fix reported issues
2003- Improved `/config` labels and descriptions for clarity
2004- Improved skill description handling: raised the listing cap from 250 to 1,536 characters and added a startup warning when descriptions are truncated
2005- Improved `WebFetch` to strip `<style>` and `<script>` contents from fetched pages so CSS-heavy pages no longer exhaust the content budget before reaching actual text
2006- Improved stale agent worktree cleanup to remove worktrees whose PR was squash-merged instead of keeping them indefinitely
2007- Improved MCP large-output truncation prompt to give format-specific recipes (e.g. `jq` for JSON, computed Read chunk sizes for text)
2008- Fixed images attached to queued messages (sent while Claude is working) being dropped
2009- Fixed screen going blank when the prompt input wraps to a second line in long conversations
2010- Fixed leading whitespace getting copied when selecting multi-line assistant responses in fullscreen mode
2011- Fixed leading whitespace being trimmed from assistant messages, breaking ASCII art and indented diagrams
2012- Fixed garbled bash output when commands print clickable file links (e.g. Python `rich`/`loguru` logging)
2013- Fixed alt+enter not inserting a newline in terminals using ESC-prefix alt encoding, and Ctrl+J not inserting a newline (regression in 2.1.100)
2014- Fixed duplicate "Creating worktree" text in EnterWorktree/ExitWorktree tool display
2015- Fixed queued user prompts disappearing from focus mode
2016- Fixed one-shot scheduled tasks re-firing repeatedly when the file watcher missed the post-fire cleanup
2017- Fixed inbound channel notifications being silently dropped after the first message for Team/Enterprise users
2018- Fixed marketplace plugins with `package.json` and lockfile not having dependencies installed automatically after install/update
2019- Fixed marketplace auto-update leaving the official marketplace in a broken state when a plugin process holds files open during the update
2020- Fixed "Resume this session with..." hint not printing on exit after `/resume`, `--worktree`, or `/branch`
2021- Fixed feedback survey shortcut keys firing when typed at the end of a longer prompt
2022- Fixed stdio MCP server emitting malformed (non-JSON) output hanging the session instead of failing fast with "Connection closed"
2023- Fixed MCP tools missing on the first turn of headless/remote-trigger sessions when MCP servers connect asynchronously
2024- Fixed `/model` picker on AWS Bedrock in non-US regions persisting invalid `us.*` model IDs to `settings.json` when inference profile discovery is still in-flight
2025- Fixed 429 rate-limit errors showing a raw JSON dump instead of a clean message for API-key, Bedrock, and Vertex users
2026- Fixed crash on resume when session contains malformed text blocks
2027- Fixed `/help` dropping the tab bar, Shortcuts heading, and footer at short terminal heights
2028- Fixed malformed keybinding entry values in `keybindings.json` being silently loaded instead of rejected with a clear error
2029- Fixed `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` in one project's settings permanently disabling usage metrics for all projects on the machine
2030- Fixed washed-out 16-color palette when using Ghostty, Kitty, Alacritty, WezTerm, foot, rio, or Contour over SSH/mosh
2031- Fixed Bash tool suggesting `acceptEdits` permission mode when exiting plan mode would downgrade from a higher permission level
2032
2033## 2.1.101
2034
2035- Added `/team-onboarding` command to generate a teammate ramp-up guide from your local Claude Code usage
2036- Added OS CA certificate store trust by default, so enterprise TLS proxies work without extra setup (set `CLAUDE_CODE_CERT_STORE=bundled` to use only bundled CAs)
2037- `/ultraplan` and other remote-session features now auto-create a default cloud environment instead of requiring web setup first
2038- Improved brief mode to retry once when Claude responds with plain text instead of a structured message
2039- Improved focus mode: Claude now writes more self-contained summaries since it knows you only see its final message
2040- Improved tool-not-available errors to explain why and how to proceed when the model calls a tool that exists but isn't available in the current context
2041- Improved rate-limit retry messages to show which limit was hit and when it resets instead of an opaque seconds countdown
2042- Improved refusal error messages to include the API-provided explanation when available
2043- Improved `claude -p --resume <name>` to accept session titles set via `/rename` or `--name`
2044- Improved settings resilience: an unrecognized hook event name in `settings.json` no longer causes the entire file to be ignored
2045- Improved plugin hooks from plugins force-enabled by managed settings to run when `allowManagedHooksOnly` is set
2046- Improved `/plugin` and `claude plugin update` to show a warning when the marketplace could not be refreshed, instead of silently reporting a stale version
2047- Improved plan mode to hide the "Refine with Ultraplan" option when the user's org or auth setup can't reach Claude Code on the web
2048- Improved beta tracing to honor `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_DETAILS`, and `OTEL_LOG_TOOL_CONTENT`; sensitive span attributes are no longer emitted unless opted in
2049- Improved SDK `query()` to clean up subprocess and temp files when consumers `break` from `for await` or use `await using`
2050- Fixed a command injection vulnerability in the POSIX `which` fallback used by LSP binary detection
2051- Fixed a memory leak where long sessions retained dozens of historical copies of the message list in the virtual scroller
2052- Fixed `--resume`/`--continue` losing conversation context on large sessions when the loader anchored on a dead-end branch instead of the live conversation
2053- Fixed `--resume` chain recovery bridging into an unrelated subagent conversation when a subagent message landed near a main-chain write gap
2054- Fixed a crash on `--resume` when a persisted Edit/Write tool result was missing its `file_path`
2055- Fixed a hardcoded 5-minute request timeout that aborted slow backends (local LLMs, extended thinking, slow gateways) regardless of `API_TIMEOUT_MS`
2056- Fixed `permissions.deny` rules not overriding a PreToolUse hook's `permissionDecision: "ask"` — previously the hook could downgrade a deny into a prompt
2057- Fixed `--setting-sources` without `user` causing background cleanup to ignore `cleanupPeriodDays` and delete conversation history older than 30 days
2058- Fixed Bedrock SigV4 authentication failing with 403 when `ANTHROPIC_AUTH_TOKEN`, `apiKeyHelper`, or `ANTHROPIC_CUSTOM_HEADERS` set an Authorization header
2059- Fixed `claude -w <name>` failing with "already exists" after a previous session's worktree cleanup left a stale directory
2060- Fixed subagents not inheriting MCP tools from dynamically-injected servers
2061- Fixed sub-agents running in isolated worktrees being denied Read/Edit access to files inside their own worktree
2062- Fixed sandboxed Bash commands failing with `mktemp: No such file or directory` after a fresh boot
2063- Fixed `claude mcp serve` tool calls failing with "Tool execution failed" in MCP clients that validate `outputSchema`
2064- Fixed `RemoteTrigger` tool's `run` action sending an empty body and being rejected by the server
2065- Fixed several `/resume` picker issues: narrow default view hiding sessions from other projects, unreachable preview on Windows Terminal, incorrect cwd in worktrees, session-not-found errors not surfacing in stderr, terminal title not being set, and resume hint overlapping the prompt input
2066- Fixed Grep tool ENOENT when the embedded ripgrep binary path becomes stale (VS Code extension auto-update, macOS App Translocation); now falls back to system `rg` and self-heals mid-session
2067- Fixed `/btw` writing a copy of the entire conversation to disk on every use
2068- Fixed `/context` Free space and Messages breakdown disagreeing with the header percentage
2069- Fixed several plugin issues: slash commands resolving to the wrong plugin with duplicate `name:` frontmatter, `/plugin update` failing with `ENAMETOOLONG`, Discover showing already-installed plugins, directory-source plugins loading from a stale version cache, and skills not honoring `context: fork` and `agent` frontmatter fields
2070- Fixed the `/mcp` menu offering OAuth-specific actions for MCP servers configured with `headersHelper`; Reconnect is now offered instead to re-invoke the helper script
2071- Fixed `ctrl+]`, `ctrl+\`, and `ctrl+^` keybindings not firing in terminals that send raw C0 control bytes (Terminal.app, default iTerm2, xterm)
2072- Fixed `/login` OAuth URL rendering with padding that prevented clean mouse selection
2073- Fixed rendering issues: flicker in non-fullscreen mode when content above the visible area changed, terminal scrollback being wiped during long sessions in non-fullscreen mode, and mouse-scroll escape sequences occasionally leaking into the prompt as text
2074- Fixed crash when `settings.json` env values are numbers instead of strings
2075- Fixed in-app settings writes (e.g. `/add-dir --remember`, `/config`) not refreshing the in-memory snapshot, preventing removed directories from being revoked mid-session
2076- Fixed custom keybindings (`~/.claude/keybindings.json`) not loading on Bedrock, Vertex, and other third-party providers
2077- Fixed `claude --continue -p` not correctly continuing sessions created by `-p` or the SDK
2078- Fixed several Remote Control issues: worktrees removed on session crash, connection failures not persisting in the transcript, spurious "Disconnected" indicator in brief mode for local sessions, and `/remote-control` failing over SSH when only `CLAUDE_CODE_ORGANIZATION_UUID` is set
2079- Fixed `/insights` sometimes omitting the report file link from its response
2080- [VSCode] Fixed the file attachment below the chat input not clearing when the last editor tab is closed
2081
2082## 2.1.98
2083
2084- Added interactive Google Vertex AI setup wizard accessible from the login screen when selecting "3rd-party platform", guiding you through GCP authentication, project and region configuration, credential verification, and model pinning
2085- Added `CLAUDE_CODE_PERFORCE_MODE` env var: when set, Edit/Write/NotebookEdit fail on read-only files with a `p4 edit` hint instead of silently overwriting them
2086- Added Monitor tool for streaming events from background scripts
2087- Added subprocess sandboxing with PID namespace isolation on Linux when `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` is set, and `CLAUDE_CODE_SCRIPT_CAPS` env var to limit per-session script invocations
2088- Added `--exclude-dynamic-system-prompt-sections` flag to print mode for improved cross-user prompt caching
2089- Added `workspace.git_worktree` to the status line JSON input, set whenever the current directory is inside a linked git worktree
2090- Added W3C `TRACEPARENT` env var to Bash tool subprocesses when OTEL tracing is enabled, so child-process spans correctly parent to Claude Code's trace tree
2091- LSP: Claude Code now identifies itself to language servers via `clientInfo` in the initialize request
2092- Fixed a Bash tool permission bypass where a backslash-escaped flag could be auto-allowed as read-only and lead to arbitrary code execution
2093- Fixed compound Bash commands bypassing forced permission prompts for safety checks and explicit ask rules in auto and bypass-permissions modes
2094- Fixed read-only commands with env-var prefixes not prompting unless the var is known-safe (`LANG`, `TZ`, `NO_COLOR`, etc.)
2095- Fixed redirects to `/dev/tcp/...` or `/dev/udp/...` not prompting instead of auto-allowing
2096- Fixed stalled streaming responses timing out instead of falling back to non-streaming mode
2097- Fixed 429 retries burning all attempts in ~13s when the server returns a small `Retry-After` — exponential backoff now applies as a minimum
2098- Fixed MCP OAuth `oauth.authServerMetadataUrl` config override not being honored on token refresh after restart, affecting ADFS and similar IdPs
2099- Fixed capital letters being dropped to lowercase on xterm and VS Code integrated terminal when the kitty keyboard protocol is active
2100- Fixed macOS text replacements deleting the trigger word instead of inserting the substitution
2101- Fixed `--dangerously-skip-permissions` being silently downgraded to accept-edits mode after approving a write to a protected path via Bash
2102- Fixed managed-settings allow rules remaining active after an admin removed them, until process restart
2103- Fixed `permissions.additionalDirectories` changes not applying mid-session — removed directories lose access immediately and added ones work without restart
2104- Fixed removing a directory from `additionalDirectories` revoking access to the same directory passed via `--add-dir`
2105- Fixed `Bash(cmd:*)` and `Bash(git commit *)` wildcard permission rules failing to match commands with extra spaces or tabs
2106- Fixed `Bash(...)` deny rules being downgraded to a prompt for piped commands that mix `cd` with other segments
2107- Fixed false Bash permission prompts for `cut -d /`, `paste -d /`, `column -s /`, `awk '{print $1}' file`, and filenames containing `%`
2108- Fixed permission rules with names matching JavaScript prototype properties (e.g. `toString`) causing `settings.json` to be silently ignored
2109- Fixed agent team members not inheriting the leader's permission mode when using `--dangerously-skip-permissions`
2110- Fixed a crash in fullscreen mode when hovering over MCP tool results
2111- Fixed copying wrapped URLs in fullscreen mode inserting spaces at line breaks
2112- Fixed file-edit diffs disappearing from the UI on `--resume` when the edited file was larger than 10KB
2113- Fixed several `/resume` picker issues: `--resume <name>` opening uneditable, filter reload wiping search state, empty list swallowing arrow keys, cross-project staleness, and transient task-status text replacing conversation summaries
2114- Fixed `/export` not honoring absolute paths and `~`, and silently rewriting user-supplied extensions to `.txt`
2115- Fixed `/effort max` being denied for unknown or future model IDs
2116- Fixed slash command picker breaking when a plugin's frontmatter `name` is a YAML boolean keyword
2117- Fixed rate-limit upsell text being hidden after message remounts
2118- Fixed MCP tools with `_meta["anthropic/maxResultSizeChars"]` not bypassing the token-based persist layer
2119- Fixed voice mode leaking dozens of space characters into the input when re-holding the push-to-talk key while the previous transcript is still processing
2120- Fixed `DISABLE_AUTOUPDATER` not fully suppressing the npm registry version check and symlink modification on npm-based installs
2121- Fixed a memory leak where Remote Control permission handler entries were retained for the lifetime of the session
2122- Fixed background subagents that fail with an error not reporting partial progress to the parent agent
2123- Fixed prompt-type Stop/SubagentStop hooks failing on long sessions, and hook evaluator API errors showing "JSON validation failed" instead of the real message
2124- Fixed feedback survey rendering when dismissed
2125- Fixed Bash `grep -f FILE` / `rg -f FILE` not prompting when reading a pattern file outside the working directory
2126- Fixed stale subagent worktree cleanup removing worktrees that contain untracked files
2127- Fixed `sandbox.network.allowMachLookup` not taking effect on macOS
2128- Improved `/resume` filter hint labels and added project/worktree/branch names in the filter indicator
2129- Improved footer indicators (Focus, notifications) to stay on the mode-indicator row instead of wrapping at narrow terminal widths
2130- Improved `/agents` with a tabbed layout: a Running tab shows live subagents, and the Library tab adds Run agent and View running instance actions
2131- Improved `/reload-plugins` to pick up plugin-provided skills without requiring a restart
2132- Improved Accept Edits mode to auto-approve filesystem commands prefixed with safe env vars or process wrappers
2133- Improved Vim mode: `j`/`k` in NORMAL mode now navigate history and select the footer pill at the input boundary
2134- Improved hook errors in the transcript to include the first line of stderr for self-diagnosis without `--debug`
2135- Improved OTEL tracing: interaction spans now correctly wrap full turns under concurrent SDK calls, and headless turns end spans per-turn
2136- Improved transcript entries to carry final token usage instead of streaming placeholders
2137- Updated the `/claude-api` skill to cover Managed Agents alongside Claude API
2138- [VSCode] Fixed false-positive "requires git-bash" error on Windows when `CLAUDE_CODE_GIT_BASH_PATH` is set or Git is installed at a default location
2139- Fixed `CLAUDE_CODE_MAX_CONTEXT_TOKENS` to honor `DISABLE_COMPACT` when it is set.
2140- Dropped `/compact` hints when `DISABLE_COMPACT` is set.
2141
2142## 2.1.97
2143
2144- Added focus view toggle (`Ctrl+O`) in `NO_FLICKER` mode showing prompt, one-line tool summary with edit diffstats, and final response
2145- Added `refreshInterval` status line setting to re-run the status line command every N seconds
2146- Added `workspace.git_worktree` to the status line JSON input, set when the current directory is inside a linked git worktree
2147- Added `● N running` indicator in `/agents` next to agent types with live subagent instances
2148- Added syntax highlighting for Cedar policy files (`.cedar`, `.cedarpolicy`)
2149- Fixed `--dangerously-skip-permissions` being silently downgraded to accept-edits mode after approving a write to a protected path
2150- Fixed and hardened Bash tool permissions, tightening checks around env-var prefixes and network redirects, and reducing false prompts on common commands
2151- Fixed permission rules with names matching JavaScript prototype properties (e.g. `toString`) causing `settings.json` to be silently ignored
2152- Fixed managed-settings allow rules remaining active after an admin removed them until process restart
2153- Fixed `permissions.additionalDirectories` changes in settings not applying mid-session
2154- Fixed removing a directory from `settings.permissions.additionalDirectories` revoking access to the same directory passed via `--add-dir`
2155- Fixed MCP HTTP/SSE connections accumulating ~50 MB/hr of unreleased buffers when servers reconnect
2156- Fixed MCP OAuth `oauth.authServerMetadataUrl` not being honored on token refresh after restart, fixing ADFS and similar IdPs
2157- Fixed 429 retries burning all attempts in ~13 seconds when the server returns a small `Retry-After` — exponential backoff now applies as a minimum
2158- Fixed rate-limit upgrade options disappearing after context compaction
2159- Fixed several `/resume` picker issues: `--resume <name>` opening uneditable, Ctrl+A reload wiping search, empty list swallowing navigation, task-status text replacing conversation summary, and cross-project staleness
2160- Fixed file-edit diffs disappearing on `--resume` when the edited file was larger than 10KB
2161- Fixed `--resume` cache misses and lost mid-turn input from attachment messages not being saved to the transcript
2162- Fixed messages typed while Claude is working not being persisted to the transcript
2163- Fixed prompt-type `Stop`/`SubagentStop` hooks failing on long sessions, and hook evaluator API errors displaying "JSON validation failed" instead of the actual message
2164- Fixed subagents with worktree isolation or `cwd:` override leaking their working directory back to the parent session's Bash tool
2165- Fixed compaction writing duplicate multi-MB subagent transcript files on prompt-too-long retries
2166- Fixed `claude plugin update` reporting "already at the latest version" for git-based marketplace plugins when the remote had newer commits
2167- Fixed slash command picker breaking when a plugin's frontmatter `name` is a YAML boolean keyword
2168- Fixed copying wrapped URLs in `NO_FLICKER` mode inserting spaces at line breaks
2169- Fixed scroll rendering artifacts in `NO_FLICKER` mode when running inside zellij
2170- Fixed a crash in `NO_FLICKER` mode when hovering over MCP tool results
2171- Fixed a `NO_FLICKER` mode memory leak where API retries left stale streaming state
2172- Fixed slow mouse-wheel scrolling in `NO_FLICKER` mode on Windows Terminal
2173- Fixed custom status line not displaying in `NO_FLICKER` mode on terminals shorter than 24 rows
2174- Fixed Shift+Enter and Alt/Cmd+arrow shortcuts not working in Warp with `NO_FLICKER` mode
2175- Fixed Korean/Japanese/Unicode text becoming garbled when copied in no-flicker mode on Windows
2176- Fixed Bedrock SigV4 authentication failing when `AWS_BEARER_TOKEN_BEDROCK` or `ANTHROPIC_BEDROCK_BASE_URL` are set to empty strings (as GitHub Actions does for unset inputs)
2177- Improved Accept Edits mode to auto-approve filesystem commands prefixed with safe env vars or process wrappers (e.g. `LANG=C rm foo`, `timeout 5 mkdir out`)
2178- Improved auto mode and bypass-permissions mode to auto-approve sandbox network access prompts
2179- Improved sandbox: `sandbox.network.allowMachLookup` now takes effect on macOS
2180- Improved image handling: pasted and attached images are now compressed to the same token budget as images read via the Read tool
2181- Improved slash command and `@`-mention completion to trigger after CJK sentence punctuation, so Japanese/Chinese input no longer requires a space before `/` or `@`
2182- Improved Bridge sessions to show the local git repo, branch, and working directory on the claude.ai session card
2183- Improved footer layout: indicators (Focus, notifications) now stay on the mode-indicator row instead of wrapping below
2184- Improved context-low warning to show as a transient footer notification instead of a persistent row
2185- Improved markdown blockquotes to show a continuous left bar across wrapped lines
2186- Improved session transcript size by skipping empty hook entries and capping stored pre-edit file copies
2187- Improved transcript accuracy: per-block entries now carry the final token usage instead of the streaming placeholder
2188- Improved Bash tool OTEL tracing: subprocesses now inherit a W3C `TRACEPARENT` env var when tracing is enabled
2189- Updated `/claude-api` skill to cover Managed Agents alongside the Claude API
2190
2191## 2.1.96
2192
2193- Fixed Bedrock requests failing with `403 "Authorization header is missing"` when using `AWS_BEARER_TOKEN_BEDROCK` or `CLAUDE_CODE_SKIP_BEDROCK_AUTH` (regression in 2.1.94)
2194
2195## 2.1.94
2196
2197- Added support for Amazon Bedrock powered by Mantle, set `CLAUDE_CODE_USE_MANTLE=1`
2198- Changed default effort level from medium to high for API-key, Bedrock/Vertex/Foundry, Team, and Enterprise users (control this with `/effort`)
2199- Added compact `Slacked #channel` header with a clickable channel link for Slack MCP send-message tool calls
2200- Added `keep-coding-instructions` frontmatter field support for plugin output styles
2201- Added `hookSpecificOutput.sessionTitle` to `UserPromptSubmit` hooks for setting the session title
2202- Plugin skills declared via `"skills": ["./"]` now use the skill's frontmatter `name` for the invocation name instead of the directory basename, giving a stable name across install methods
2203- Fixed agents appearing stuck after a 429 rate-limit response with a long Retry-After header — the error now surfaces immediately instead of silently waiting
2204- Fixed Console login on macOS silently failing with "Not logged in" when the login keychain is locked or its password is out of sync — the error is now surfaced and `claude doctor` diagnoses the fix
2205- Fixed plugin skill hooks defined in YAML frontmatter being silently ignored
2206- Fixed plugin hooks failing with "No such file or directory" when `CLAUDE_PLUGIN_ROOT` was not set
2207- Fixed `${CLAUDE_PLUGIN_ROOT}` resolving to the marketplace source directory instead of the installed cache for local-marketplace plugins on startup
2208- Fixed scrollback showing the same diff repeated and blank pages in long-running sessions
2209- Fixed multiline user prompts in the transcript indenting wrapped lines under the `❯` caret instead of under the text
2210- Fixed Shift+Space inserting the literal word "space" instead of a space character in search inputs
2211- Fixed hyperlinks opening two browser tabs when clicked inside tmux running in an xterm.js-based terminal (VS Code, Hyper, Tabby)
2212- Fixed an alt-screen rendering bug where content height changes mid-scroll could leave compounding ghost lines
2213- Fixed `FORCE_HYPERLINK` environment variable being ignored when set via `settings.json` `env`
2214- Fixed native terminal cursor not tracking the selected tab in dialogs, so screen readers and magnifiers can follow tab navigation
2215- Fixed Bedrock invocation of Sonnet 3.5 v2 by using the `us.` inference profile ID
2216- Fixed SDK/print mode not preserving the partial assistant response in conversation history when interrupted mid-stream
2217- Improved `--resume` to resume sessions from other worktrees of the same repo directly instead of printing a `cd` command
2218- Fixed CJK and other multibyte text being corrupted with U+FFFD in stream-json input/output when chunk boundaries split a UTF-8 sequence
2219- [VSCode] Reduced cold-open subprocess work on starting a session
2220- [VSCode] Fixed dropdown menus selecting the wrong item when the mouse was over the list while typing or using arrow keys
2221- [VSCode] Added a warning banner when `settings.json` files fail to parse, so users know their permission rules are not being applied
2222
2223## 2.1.92
2224
2225- Added `forceRemoteSettingsRefresh` policy setting: when set, the CLI blocks startup until remote managed settings are freshly fetched, and exits if the fetch fails (fail-closed)
2226- Added interactive Bedrock setup wizard accessible from the login screen when selecting "3rd-party platform" — guides you through AWS authentication, region configuration, credential verification, and model pinning
2227- Added per-model and cache-hit breakdown to `/cost` for subscription users
2228- `/release-notes` is now an interactive version picker
2229- Remote Control session names now use your hostname as the default prefix (e.g. `myhost-graceful-unicorn`), overridable with `--remote-control-session-name-prefix`
2230- Pro users now see a footer hint when returning to a session after the prompt cache has expired, showing roughly how many tokens the next turn will send uncached
2231- Fixed subagent spawning permanently failing with "Could not determine pane count" after tmux windows are killed or renumbered during a long-running session
2232- Fixed prompt-type Stop hooks incorrectly failing when the small fast model returns `ok:false`, and restored `preventContinuation:true` semantics for non-Stop prompt-type hooks
2233- Fixed tool input validation failures when streaming emits array/object fields as JSON-encoded strings
2234- Fixed an API 400 error that could occur when extended thinking produced a whitespace-only text block alongside real content
2235- Fixed accidental feedback survey submissions from auto-pilot keypresses and consecutive-prompt digit collisions
2236- Fixed misleading "esc to interrupt" hint appearing alongside "esc to clear" when a text selection exists in fullscreen mode during processing
2237- Fixed Homebrew install update prompts to use the cask's release channel (`claude-code` → stable, `claude-code@latest` → latest)
2238- Fixed `ctrl+e` jumping to the end of the next line when already at end of line in multiline prompts
2239- Fixed an issue where the same message could appear at two positions when scrolling up in fullscreen mode (iTerm2, Ghostty, and other terminals with DEC 2026 support)
2240- Fixed idle-return "/clear to save X tokens" hint showing cumulative session tokens instead of current context size
2241- Fixed plugin MCP servers stuck "connecting" on session start when they duplicate a claude.ai connector that is unauthenticated
2242- Improved Write tool diff computation speed for large files (60% faster on files with tabs/`&`/`$`)
2243- Removed `/tag` command
2244- Removed `/vim` command (toggle vim mode via `/config` → Editor mode)
2245- Linux sandbox now ships the `apply-seccomp` helper in both npm and native builds, restoring unix-socket blocking for sandboxed commands
2246
2247## 2.1.91
2248
2249- Added MCP tool result persistence override via `_meta["anthropic/maxResultSizeChars"]` annotation (up to 500K), allowing larger results like DB schemas to pass through without truncation
2250- Added `disableSkillShellExecution` setting to disable inline shell execution in skills, custom slash commands, and plugin commands
2251- Added support for multi-line prompts in `claude-cli://open?q=` deep links (encoded newlines `%0A` no longer rejected)
2252- Plugins can now ship executables under `bin/` and invoke them as bare commands from the Bash tool
2253- Fixed transcript chain breaks on `--resume` that could lose conversation history when async transcript writes fail silently
2254- Fixed `cmd+delete` not deleting to start of line on iTerm2, kitty, WezTerm, Ghostty, and Windows Terminal
2255- Fixed plan mode in remote sessions losing track of the plan file after a container restart, which caused permission prompts on plan edits and an empty plan-approval modal
2256- Fixed JSON schema validation for `permissions.defaultMode: "auto"` in settings.json
2257- Fixed Windows version cleanup not protecting the active version's rollback copy
2258- `/feedback` now explains why it's unavailable instead of disappearing from the slash menu
2259- Improved `/claude-api` skill guidance for agent design patterns including tool surface decisions, context management, and caching strategy
2260- Improved performance: faster `stripAnsi` on Bun by routing through `Bun.stripANSI`
2261- Edit tool now uses shorter `old_string` anchors, reducing output tokens
2262
2263## 2.1.90
2264
2265- Added `/powerup` — interactive lessons teaching Claude Code features with animated demos
2266- Added `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` env var to keep the existing marketplace cache when `git pull` fails, useful in offline environments
2267- Added `.husky` to protected directories (acceptEdits mode)
2268- Fixed an infinite loop where the rate-limit options dialog would repeatedly auto-open after hitting your usage limit, eventually crashing the session
2269- Fixed `--resume` causing a full prompt-cache miss on the first request for users with deferred tools, MCP servers, or custom agents (regression since v2.1.69)
2270- Fixed `Edit`/`Write` failing with "File content has changed" when a PostToolUse format-on-save hook rewrites the file between consecutive edits
2271- Fixed `PreToolUse` hooks that emit JSON to stdout and exit with code 2 not correctly blocking the tool call
2272- Fixed collapsed search/read summary badge appearing multiple times in fullscreen scrollback when a CLAUDE.md file auto-loads during a tool call
2273- Fixed auto mode not respecting explicit user boundaries ("don't push", "wait for X before Y") even when the action would otherwise be allowed
2274- Fixed click-to-expand hover text being nearly invisible on light terminal themes
2275- Fixed UI crash when malformed tool input reached the permission dialog
2276- Fixed headers disappearing when scrolling `/model`, `/config`, and other selection screens
2277- Hardened PowerShell tool permission checks: fixed trailing `&` background job bypass, `-ErrorAction Break` debugger hang, archive-extraction TOCTOU, and parse-fail fallback deny-rule degradation
2278- Improved performance: eliminated per-turn JSON.stringify of MCP tool schemas on cache-key lookup
2279- Improved performance: SSE transport now handles large streamed frames in linear time (was quadratic)
2280- Improved performance: SDK sessions with long conversations no longer slow down quadratically on transcript writes
2281- Improved `/resume` all-projects view to load project sessions in parallel, improving load times for users with many projects
2282- Changed `--resume` picker to no longer show sessions created by `claude -p` or SDK invocations
2283- Removed `Get-DnsClientCache` and `ipconfig /displaydns` from auto-allow (DNS cache privacy)
2284
2285## 2.1.89
2286
2287- Added `"defer"` permission decision to `PreToolUse` hooks — headless sessions can pause at a tool call and resume with `-p --resume` to have the hook re-evaluate
2288- Added `CLAUDE_CODE_NO_FLICKER=1` environment variable to opt into flicker-free alt-screen rendering with virtualized scrollback
2289- Added `PermissionDenied` hook that fires after auto mode classifier denials — return `{retry: true}` to tell the model it can retry
2290- Added named subagents to `@` mention typeahead suggestions
2291- Added `MCP_CONNECTION_NONBLOCKING=true` for `-p` mode to skip the MCP connection wait entirely, and bounded `--mcp-config` server connections at 5s instead of blocking on the slowest server
2292- Auto mode: denied commands now show a notification and appear in `/permissions` → Recent tab where you can retry with `r`
2293- Fixed `Edit(//path/**)` and `Read(//path/**)` allow rules to check the resolved symlink target, not just the requested path
2294- Fixed voice push-to-talk not activating for some modifier-combo bindings, and voice mode on Windows failing with "WebSocket upgrade rejected with HTTP 101"
2295- Fixed Edit/Write tools doubling CRLF on Windows and stripping Markdown hard line breaks (two trailing spaces)
2296- Fixed `StructuredOutput` schema cache bug causing ~50% failure rate when using multiple schemas
2297- Fixed memory leak where large JSON inputs were retained as LRU cache keys in long-running sessions
2298- Fixed a crash when removing a message from very large session files (over 50MB)
2299- Fixed LSP server zombie state after crash — server now restarts on next request instead of failing until session restart
2300- Fixed prompt history entries containing CJK or emoji being silently dropped when they fall on a 4KB boundary in `~/.claude/history.jsonl`
2301- Fixed `/stats` undercounting tokens by excluding subagent usage, and losing historical data beyond 30 days when the stats cache format changes
2302- Fixed `-p --resume` hangs when the deferred tool input exceeds 64KB or no deferred marker exists, and `-p --continue` not resuming deferred tools
2303- Fixed `claude-cli://` deep links not opening on macOS
2304- Fixed MCP tool errors truncating to only the first content block when the server returns multi-element error content
2305- Fixed skill reminders and other system context being dropped when sending messages with images via the SDK
2306- Fixed PreToolUse/PostToolUse hooks to receive `file_path` as an absolute path for Write/Edit/Read tools, matching the documented behavior
2307- Fixed autocompact thrash loop — now detects when context refills to the limit immediately after compacting three times in a row and stops with an actionable error instead of burning API calls
2308- Fixed prompt cache misses in long sessions caused by tool schema bytes changing mid-session
2309- Fixed nested CLAUDE.md files being re-injected dozens of times in long sessions that read many files
2310- Fixed `--resume` crash when transcript contains a tool result from an older CLI version or interrupted write
2311- Fixed misleading "Rate limit reached" message when the API returned an entitlement error — now shows the actual error with actionable hints
2312- Fixed hooks `if` condition filtering not matching compound commands (`ls && git push`) or commands with env-var prefixes (`FOO=bar git push`)
2313- Fixed collapsed search/read group badges duplicating in terminal scrollback during heavy parallel tool use
2314- Fixed notification `invalidates` not clearing the currently-displayed notification immediately
2315- Fixed prompt briefly disappearing after submit when background messages arrived during processing
2316- Fixed Devanagari and other combining-mark text being truncated in assistant output
2317- Fixed rendering artifacts on main-screen terminals after layout shifts
2318- Fixed voice mode failing to request microphone permission on macOS Apple Silicon
2319- Fixed Shift+Enter submitting instead of inserting a newline on Windows Terminal Preview 1.25
2320- Fixed periodic UI jitter during streaming in iTerm2 when running inside tmux
2321- Fixed PowerShell tool incorrectly reporting failures when commands like `git push` wrote progress to stderr on Windows PowerShell 5.1
2322- Fixed a potential out-of-memory crash when the Edit tool was used on very large files (>1 GiB)
2323- Improved collapsed tool summary to show "Listed N directories" for `ls`/`tree`/`du` instead of "Read N files"
2324- Improved Bash tool to warn when a formatter/linter command modifies files you have previously read, preventing stale-edit errors
2325- Improved `@`-mention typeahead to rank source files above MCP resources with similar names
2326- Improved PowerShell tool prompt with version-appropriate syntax guidance (5.1 vs 7+)
2327- Changed `Edit` to work on files viewed via `Bash` with `sed -n` or `cat`, without requiring a separate `Read` call first
2328- Changed hook output over 50K characters to be saved to disk with a file path + preview instead of being injected directly into context
2329- Changed `cleanupPeriodDays: 0` in settings.json to be rejected with a validation error — it previously silently disabled transcript persistence
2330- Changed thinking summaries to no longer be generated by default in interactive sessions — set `showThinkingSummaries: true` in settings.json to restore
2331- Documented `TaskCreated` hook event and its blocking behavior
2332- Preserved task notifications when backgrounding a running command with Ctrl+B
2333- PowerShell tool on Windows: external-command arguments containing both a double-quote and whitespace now prompt instead of auto-allowing (PS 5.1 argument-splitting hardening)
2334- `/env` now applies to PowerShell tool commands (previously only affected Bash)
2335- `/usage` now hides redundant "Current week (Sonnet only)" bar for Pro and Enterprise plans
2336- Image paste no longer inserts a trailing space
2337- Pasting `!command` into an empty prompt now enters bash mode, matching typed `!` behavior
2338- `/buddy` is here for April 1st — hatch a small creature that watches you code
2339
2340## 2.1.87
2341
2342- Fixed messages in Cowork Dispatch not getting delivered
2343
2344## 2.1.86
2345
2346- Added `X-Claude-Code-Session-Id` header to API requests so proxies can aggregate requests by session without parsing the body
2347- Added `.jj` and `.sl` to VCS directory exclusion lists so Grep and file autocomplete don't descend into Jujutsu or Sapling metadata
2348- Fixed `--resume` failing with "tool_use ids were found without tool_result blocks" on sessions created before v2.1.85
2349- Fixed Write/Edit/Read failing on files outside the project root (e.g., `~/.claude/CLAUDE.md`) when conditional skills or rules are configured
2350- Fixed unnecessary config disk writes on every skill invocation that could cause performance issues and config corruption on Windows
2351- Fixed potential out-of-memory crash when using `/feedback` on very long sessions with large transcript files
2352- Fixed `--bare` mode dropping MCP tools in interactive sessions and silently discarding messages enqueued mid-turn
2353- Fixed the `c` shortcut copying only ~20 characters of the OAuth login URL instead of the full URL
2354- Fixed masked input (e.g., OAuth code paste) leaking the start of the token when wrapping across multiple lines on narrow terminals
2355- Fixed official marketplace plugin scripts failing with "Permission denied" on macOS/Linux since v2.1.83
2356- Fixed statusline showing another session's model when running multiple Claude Code instances and using `/model` in one of them
2357- Fixed scroll not following new messages after wheel scroll or click-to-select at the bottom of a long conversation
2358- Fixed `/plugin` uninstall dialog: pressing `n` now correctly uninstalls the plugin while preserving its data directory
2359- Fixed a regression where pressing Enter after clicking could leave the transcript blank until the response arrived
2360- Fixed `ultrathink` hint lingering after deleting the keyword
2361- Fixed memory growth in long sessions from markdown/highlight render caches retaining full content strings
2362- Reduced startup event-loop stalls when many claude.ai MCP connectors are configured (macOS keychain cache extended from 5s to 30s)
2363- Reduced token overhead when mentioning files with `@` — raw string content no longer JSON-escaped
2364- Improved prompt cache hit rate for Bedrock, Vertex, and Foundry users by removing dynamic content from tool descriptions
2365- Memory filenames in the "Saved N memories" notice now highlight on hover and open on click
2366- Skill descriptions in the `/skills` listing are now capped at 250 characters to reduce context usage
2367- Changed `/skills` menu to sort alphabetically for easier scanning
2368- Auto mode now shows "unavailable for your plan" when disabled by plan restrictions (was "temporarily unavailable")
2369- [VSCode] Fixed extension incorrectly showing "Not responding" during long-running operations
2370- [VSCode] Fixed extension defaulting Max plan users to Sonnet after the OAuth token refreshes (8 hours after login)
2371- Read tool now uses compact line-number format and deduplicates unchanged re-reads, reducing token usage
2372
2373## 2.1.85
2374
2375- Added `CLAUDE_CODE_MCP_SERVER_NAME` and `CLAUDE_CODE_MCP_SERVER_URL` environment variables to MCP `headersHelper` scripts, allowing one helper to serve multiple servers
2376- Added conditional `if` field for hooks using permission rule syntax (e.g., `Bash(git *)`) to filter when they run, reducing process spawning overhead
2377- Added timestamp markers in transcripts when scheduled tasks (`/loop`, `CronCreate`) fire
2378- Added trailing space after `[Image #N]` placeholder when pasting images
2379- Deep link queries (`claude-cli://open?q=…`) now support up to 5,000 characters, with a "scroll to review" warning for long pre-filled prompts
2380- MCP OAuth now follows RFC 9728 Protected Resource Metadata discovery to find the authorization server
2381- Plugins blocked by organization policy (`managed-settings.json`) can no longer be installed or enabled, and are hidden from marketplace views
2382- PreToolUse hooks can now satisfy `AskUserQuestion` by returning `updatedInput` alongside `permissionDecision: "allow"`, enabling headless integrations that collect answers via their own UI
2383- `tool_parameters` in OpenTelemetry tool_result events are now gated behind `OTEL_LOG_TOOL_DETAILS=1`
2384- Fixed `/compact` failing with "context exceeded" when the conversation has grown too large for the compact request itself to fit
2385- Fixed `/plugin enable` and `/plugin disable` failing when a plugin's install location differs from where it's declared in settings
2386- Fixed `--worktree` exiting with an error in non-git repositories before the `WorktreeCreate` hook could run
2387- Fixed `deniedMcpServers` setting not blocking claude.ai MCP servers
2388- Fixed `switch_display` in the computer-use tool returning "not available in this session" on multi-monitor setups
2389- Fixed crash when `OTEL_LOGS_EXPORTER`, `OTEL_METRICS_EXPORTER`, or `OTEL_TRACES_EXPORTER` is set to `none`
2390- Fixed diff syntax highlighting not working in non-native builds
2391- Fixed MCP step-up authorization failing when a refresh token exists — servers requesting elevated scopes via `403 insufficient_scope` now correctly trigger the re-authorization flow
2392- Fixed memory leak in remote sessions when a streaming response is interrupted
2393- Fixed persistent ECONNRESET errors during edge connection churn by using a fresh TCP connection on retry
2394- Fixed prompts getting stuck in the queue after running certain slash commands, with up-arrow unable to retrieve them
2395- Fixed Python Agent SDK: `type:'sdk'` MCP servers passed via `--mcp-config` are no longer dropped during startup
2396- Fixed raw key sequences appearing in the prompt when running over SSH or in the VS Code integrated terminal
2397- Fixed Remote Control session status staying stuck on "Requires Action" after a permission is resolved
2398- Fixed shift+enter and meta+enter being intercepted by typeahead suggestions instead of inserting newlines
2399- Fixed stale content bleeding through when scrolling up during streaming
2400- Fixed terminal left in enhanced keyboard mode after exit in Ghostty, Kitty, WezTerm, and other terminals supporting the Kitty keyboard protocol — Ctrl+C and Ctrl+D now work correctly after quitting
2401- Improved @-mention file autocomplete performance on large repositories
2402- Improved PowerShell dangerous command detection
2403- Improved scroll performance with large transcripts by replacing WASM yoga-layout with a pure TypeScript implementation
2404- Reduced UI stutter when compaction triggers on large sessions
2405
2406## 2.1.84
2407
2408- Added PowerShell tool for Windows as an opt-in preview. Learn more at https://code.claude.com/docs/en/tools-reference#powershell-tool
2409- Added `ANTHROPIC_DEFAULT_{OPUS,SONNET,HAIKU}_MODEL_SUPPORTS` env vars to override effort/thinking capability detection for pinned default models for 3p (Bedrock, Vertex, Foundry), and `_MODEL_NAME`/`_DESCRIPTION` to customize the `/model` picker label
2410- Added `CLAUDE_STREAM_IDLE_TIMEOUT_MS` env var to configure the streaming idle watchdog threshold (default 90s)
2411- Added `TaskCreated` hook that fires when a task is created via `TaskCreate`
2412- Added `WorktreeCreate` hook support for `type: "http"` — return the created worktree path via `hookSpecificOutput.worktreePath` in the response JSON
2413- Added `allowedChannelPlugins` managed setting for team/enterprise admins to define a channel plugin allowlist
2414- Added `x-client-request-id` header to API requests for debugging timeouts
2415- Added idle-return prompt that nudges users returning after 75+ minutes to `/clear`, reducing unnecessary token re-caching on stale sessions
2416- Deep links (`claude-cli://`) now open in your preferred terminal instead of whichever terminal happens to be first in the detection list
2417- Rules and skills `paths:` frontmatter now accepts a YAML list of globs
2418- MCP tool descriptions and server instructions are now capped at 2KB to prevent OpenAPI-generated servers from bloating context
2419- MCP servers configured both locally and via claude.ai connectors are now deduplicated — the local config wins
2420- Background bash tasks that appear stuck on an interactive prompt now surface a notification after ~45 seconds
2421- Token counts ≥1M now display as "1.5m" instead of "1512.6k"
2422- Global system-prompt caching now works when `ToolSearch` is enabled, including for users with MCP tools configured
2423- Fixed voice push-to-talk: holding the voice key no longer leaks characters into the text input, and transcripts now insert at the correct position
2424- Fixed up/down arrow keys being unresponsive when a footer item is focused
2425- Fixed `Ctrl+U` (kill-to-line-start) being a no-op at line boundaries in multiline input, so repeated `Ctrl+U` now clears across lines
2426- Fixed null-unbinding a default chord binding (e.g. `"ctrl+x ctrl+k": null`) still entering chord-wait mode instead of freeing the prefix key
2427- Fixed mouse events inserting literal "mouse" text into transcript search input
2428- Fixed workflow subagents failing with API 400 when the outer session uses `--json-schema` and the subagent also specifies a schema
2429- Fixed missing background color behind certain emoji in user message bubbles on some terminals
2430- Fixed the "allow Claude to edit its own settings for this session" permission option not sticking for users with `Edit(.claude)` allow rules
2431- Fixed a hang when generating attachment snippets for large edited files
2432- Fixed MCP tool/resource cache leak on server reconnect
2433- Fixed a startup performance issue where partial clone repositories (Scalar/GVFS) triggered mass blob downloads
2434- Fixed native terminal cursor not tracking the text input caret, so IME composition (CJK input) now renders inline and screen readers can follow the input position
2435- Fixed spurious "Not logged in" errors on macOS caused by transient keychain read failures
2436- Fixed cold-start race where core tools could be deferred without their bypass active, causing Edit/Write to fail with InputValidationError on typed parameters
2437- Improved detection for dangerous removals of Windows drive roots (`C:\`, `C:\Windows`, etc.)
2438- Improved interactive startup by ~30ms by running `setup()` in parallel with slash command and agent loading
2439- Improved startup for `claude "prompt"` with MCP servers — the REPL now renders immediately instead of blocking until all servers connect
2440- Improved Remote Control to show a specific reason when blocked instead of a generic "not yet enabled" message
2441- Improved p90 prompt cache rate
2442- Reduced scroll-to-top resets in long sessions by making the message window immune to compaction and grouping changes
2443- Reduced terminal flickering when animated tool progress scrolls above the viewport
2444- Changed issue/PR references to only become clickable links when written as `owner/repo#123` — bare `#123` is no longer auto-linked
2445- Slash commands unavailable for the current auth setup (`/voice`, `/mobile`, `/chrome`, `/upgrade`, etc.) are now hidden instead of shown
2446- [VSCode] Added rate limit warning banner with usage percentage and reset time
2447- Stats screenshot (Ctrl+S in /stats) now works in all builds and is 16× faster
2448
2449## 2.1.83
2450
2451- Added `managed-settings.d/` drop-in directory alongside `managed-settings.json`, letting separate teams deploy independent policy fragments that merge alphabetically
2452- Added `CwdChanged` and `FileChanged` hook events for reactive environment management (e.g., direnv)
2453- Added `sandbox.failIfUnavailable` setting to exit with an error when sandbox is enabled but cannot start, instead of running unsandboxed
2454- Added `disableDeepLinkRegistration` setting to prevent `claude-cli://` protocol handler registration
2455- Added `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1` to strip Anthropic and cloud provider credentials from subprocess environments (Bash tool, hooks, MCP stdio servers)
2456- Added transcript search — press `/` in transcript mode (`Ctrl+O`) to search, `n`/`N` to step through matches
2457- Added `Ctrl+X Ctrl+E` as an alias for opening the external editor (readline-native binding; `Ctrl+G` still works)
2458- Pasted images now insert an `[Image #N]` chip at the cursor so you can reference them positionally in your prompt
2459- Agents can now declare `initialPrompt` in frontmatter to auto-submit a first turn
2460- `chat:killAgents` and `chat:fastMode` are now rebindable via `~/.claude/keybindings.json`
2461- Fixed mouse tracking escape sequences leaking to shell prompt after exit
2462- Fixed Claude Code hanging on exit on macOS
2463- Fixed screen flashing blank after being idle for a few seconds
2464- Fixed a hang when diffing very large files with few common lines — diffs now time out after 5 seconds and fall back gracefully
2465- Fixed a 1–8 second UI freeze on startup when voice input was enabled, caused by eagerly loading the native audio module
2466- Fixed a startup regression where Claude Code would wait ~3s for claude.ai MCP config fetch before proceeding
2467- Fixed `--mcp-config` CLI flag bypassing `allowedMcpServers`/`deniedMcpServers` managed policy enforcement
2468- Fixed claude.ai MCP connectors (Slack, Gmail, etc.) not being available in single-turn `--print` mode
2469- Fixed `caffeinate` process not properly terminating when Claude Code exits, preventing Mac from sleeping
2470- Fixed bash mode not activating when tab-accepting `!`-prefixed command suggestions
2471- Fixed stale slash command selection showing wrong highlighted command after navigating suggestions
2472- Fixed `/config` menu showing both the search cursor and list selection at the same time
2473- Fixed background subagents becoming invisible after context compaction, which could cause duplicate agents to be spawned
2474- Fixed background agent tasks staying stuck in "running" state when git or API calls hang during cleanup
2475- Fixed `--channels` showing "Channels are not currently available" on first launch after upgrade
2476- Fixed uninstalled plugin hooks continuing to fire until the next session
2477- Fixed queued commands flickering during streaming responses
2478- Fixed slash commands being sent to the model as text when submitted while a message is processing
2479- Fixed scrollback jumping when collapsed read/search groups finish after scrolling offscreen
2480- Fixed scrollback jumping to top when the model starts or stops thinking
2481- Fixed SDK session history loss on resume caused by hook progress/attachment messages forking the parentUuid chain
2482- Fixed copy-on-select not firing when you release the mouse outside the terminal window
2483- Fixed ghost characters appearing in height-constrained lists when items overflow
2484- Fixed `Ctrl+B` interfering with readline backward-char at an idle prompt — it now only fires when a foreground task can be backgrounded
2485- Fixed tool result files never being cleaned up, ignoring the `cleanupPeriodDays` setting
2486- Fixed space key being swallowed for up to 3 seconds after releasing voice hold-to-talk
2487- Fixed ALSA library errors corrupting the terminal UI when using voice mode on Linux without audio hardware (Docker, headless, WSL1)
2488- Fixed voice mode SoX detection on Termux/Android where spawning `which` is kernel-restricted
2489- Fixed Remote Control sessions showing as Idle in the web session list while actively running
2490- Fixed footer navigation selecting an invisible Remote Control pill in config-driven mode
2491- Fixed memory leak in remote sessions where tool use IDs accumulate indefinitely
2492- Improved Bedrock SDK cold-start latency by overlapping profile fetch with other boot work
2493- Improved `--resume` memory usage and startup latency on large sessions
2494- Improved plugin startup — commands, skills, and agents now load from disk cache without re-fetching
2495- Improved Remote Control session titles: AI-generated titles now appear within seconds of the first message
2496- Improved `WebFetch` to identify as `Claude-User` so site operators can recognize and allowlist Claude Code traffic via `robots.txt`
2497- Reduced `WebFetch` peak memory usage for large pages
2498- Reduced scrollback resets in long sessions from once per turn to once per ~50 messages
2499- Faster `claude -p` startup with unauthenticated HTTP/SSE MCP servers (~600ms saved)
2500- Bash ghost-text suggestions now include just-submitted commands immediately
2501- Increased non-streaming fallback token cap (21k → 64k) and timeout (120s → 300s local) so fallback requests are less likely to be truncated
2502- Interrupting a prompt before any response now automatically restores your input so you can edit and resubmit
2503- `/status` now works while Claude is responding, instead of being queued until the turn finishes
2504- Plugin MCP servers that duplicate an org-managed connector are now suppressed instead of running a second connection
2505- Linux: respect `XDG_DATA_HOME` when registering the `claude-cli://` protocol handler
2506- Changed "stop all background agents" keybinding from `Ctrl+F` to `Ctrl+X Ctrl+K` to stop shadowing readline forward-char
2507- Deprecated `TaskOutput` tool in favor of using `Read` on the background task's output file path
2508- Added `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` env var to disable the non-streaming fallback when streaming fails
2509- Plugin options (`manifest.userConfig`) now available externally — plugins can prompt for configuration at enable time, with `sensitive: true` values stored in keychain (macOS) or protected credentials file (other platforms)
2510- Claude can now reference the on-disk path of clipboard-pasted images for file operations
2511- `Ctrl+L` now clears the screen and forces a full redraw — use this to recover when Cmd+K leaves the UI partially blank. Use `Ctrl+U` or double-Esc to clear prompt input.
2512- `--bare -p` (SDK pattern) is ~14% faster to the API request
2513- Memory: `MEMORY.md` index now truncates at 25KB as well as 200 lines
2514- Disabled `AskUserQuestion` and plan-mode tools when `--channels` is active
2515- Fixed API 400 error when a pasted image was queued during a failing tool call
2516- Fixed MCP tool calls hanging indefinitely when an SSE connection drops mid-call and exhausts its reconnection attempts
2517- Fixed Remote Control session titles showing raw XML when a background agent completed before the first user message
2518- Fixed remote sessions forgetting conversation history after a container restart due to progress-message gaps in the resumed transcript chain
2519- Fixed remote sessions requiring re-login on transient auth errors instead of retrying automatically
2520- Fixed `rg ... | wc -l` and similar piped commands hanging and returning `0` in sandbox mode on Linux
2521- Fixed voice input hold-to-talk not activating when a CJK IME inserts a full-width space
2522- Fixed `--worktree` hanging silently when the worktree name contained a forward slash
2523- [VSCode] Spinner now turns red with "Not responding" when the backend hasn't responded for 60 seconds
2524- [VSCode] Fixed session history not loading correctly when reopening a session via URL or after restart
2525- [VSCode] Added Esc-twice (or `/rewind`) to open a keyboard-navigable rewind picker
2526- [VSCode] Fixed "Fork conversation from here" and rewind actions failing silently after the session cache goes stale
2527
2528## 2.1.81
2529
2530- Added `--bare` flag for scripted `-p` calls — skips hooks, LSP, plugin sync, and skill directory walks; requires `ANTHROPIC_API_KEY` or an `apiKeyHelper` via `--settings` (OAuth and keychain auth disabled); auto-memory fully disabled
2531- Added `--channels` permission relay — channel servers that declare the permission capability can forward tool approval prompts to your phone
2532- Fixed multiple concurrent Claude Code sessions requiring repeated re-authentication when one session refreshes its OAuth token
2533- Fixed voice mode silently swallowing retry failures and showing a misleading "check your network" message instead of the actual error
2534- Fixed voice mode audio not recovering when the server silently drops the WebSocket connection
2535- Fixed `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` not suppressing the structured-outputs beta header, causing 400 errors on proxy gateways forwarding to Vertex/Bedrock
2536- Fixed `--channels` bypass for Team/Enterprise orgs with no other managed settings configured
2537- Fixed a crash on Node.js 18
2538- Fixed unnecessary permission prompts for Bash commands containing dashes in strings
2539- Fixed plugin hooks blocking prompt submission when the plugin directory is deleted mid-session
2540- Fixed a race condition where background agent task output could hang indefinitely when the task completed between polling intervals
2541- Resuming a session that was in a worktree now switches back to that worktree
2542- Fixed `/btw` not including pasted text when used during an active response
2543- Fixed a race where fast Cmd+Tab followed by paste could beat the clipboard copy under tmux
2544- Fixed terminal tab title not updating with an auto-generated session description
2545- Fixed invisible hook attachments inflating the message count in transcript mode
2546- Fixed Remote Control sessions showing a generic title instead of deriving from the first prompt
2547- Fixed `/rename` not syncing the title for Remote Control sessions
2548- Fixed Remote Control `/exit` not reliably archiving the session
2549- Improved MCP read/search tool calls to collapse into a single "Queried {server}" line (expand with Ctrl+O)
2550- Improved `!` bash mode discoverability — Claude now suggests it when you need to run an interactive command
2551- Improved plugin freshness — ref-tracked plugins now re-clone on every load to pick up upstream changes
2552- Improved Remote Control session titles to refresh after your third message
2553- Updated MCP OAuth to support Client ID Metadata Document (CIMD / SEP-991) for servers without Dynamic Client Registration
2554- Changed plan mode to hide the "clear context" option by default (restore with `"showClearContextOnPlanAccept": true`)
2555- Disabled line-by-line response streaming on Windows (including WSL in Windows Terminal) due to rendering issues
2556- [VSCode] Fixed Windows PATH inheritance for Bash tool when using Git Bash (regression in v2.1.78)
2557
2558## 2.1.80
2559
2560- Added `rate_limits` field to statusline scripts for displaying Claude.ai rate limit usage (5-hour and 7-day windows with `used_percentage` and `resets_at`)
2561- Added `source: 'settings'` plugin marketplace source — declare plugin entries inline in settings.json
2562- Added CLI tool usage detection to plugin tips, in addition to file pattern matching
2563- Added `effort` frontmatter support for skills and slash commands to override the model effort level when invoked
2564- Added `--channels` (research preview) — allow MCP servers to push messages into your session
2565- Fixed `--resume` dropping parallel tool results — sessions with parallel tool calls now restore all tool_use/tool_result pairs instead of showing `[Tool result missing]` placeholders
2566- Fixed voice mode WebSocket failures caused by Cloudflare bot detection on non-browser TLS fingerprints
2567- Fixed 400 errors when using fine-grained tool streaming through API proxies, Bedrock, or Vertex
2568- Fixed `/remote-control` appearing for gateway and third-party provider deployments where it cannot function
2569- Fixed `/sandbox` tab switching not responding to Tab or arrow keys
2570- Improved responsiveness of `@` file autocomplete in large git repositories
2571- Improved `/effort` to show what auto currently resolves to, matching the status bar indicator
2572- Improved `/permissions` — Tab and arrow keys now switch tabs from within a list
2573- Improved background tasks panel — left arrow now closes from the list view
2574- Simplified plugin install tips to use a single `/plugin install` command instead of a two-step flow
2575- Reduced memory usage on startup in large repositories (~80 MB saved on 250k-file repos)
2576- Fixed managed settings (`enabledPlugins`, `permissions.defaultMode`, policy-set env vars) not being applied at startup when `remote-settings.json` was cached from a prior session
2577
2578## 2.1.79
2579
2580- Added `--console` flag to `claude auth login` for Anthropic Console (API billing) authentication
2581- Added "Show turn duration" toggle to the `/config` menu
2582- Fixed `claude -p` hanging when spawned as a subprocess without explicit stdin (e.g. Python `subprocess.run`)
2583- Fixed Ctrl+C not working in `-p` (print) mode
2584- Fixed `/btw` returning the main agent's output instead of answering the side question when triggered during streaming
2585- Fixed voice mode not activating correctly on startup when `voiceEnabled: true` is set
2586- Fixed left/right arrow tab navigation in `/permissions`
2587- Fixed `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` not preventing terminal title from being set on startup
2588- Fixed custom status line showing nothing when workspace trust is blocking it
2589- Fixed enterprise users being unable to retry on rate limit (429) errors
2590- Fixed `SessionEnd` hooks not firing when using interactive `/resume` to switch sessions
2591- Improved startup memory usage by ~18MB across all scenarios
2592- Improved non-streaming API fallback with a 2-minute per-attempt timeout, preventing sessions from hanging indefinitely
2593- `CLAUDE_CODE_PLUGIN_SEED_DIR` now supports multiple seed directories separated by the platform path delimiter (`:` on Unix, `;` on Windows)
2594- [VSCode] Added `/remote-control` — bridge your session to claude.ai/code to continue from a browser or phone
2595- [VSCode] Session tabs now get AI-generated titles based on your first message
2596- [VSCode] Fixed the thinking pill showing "Thinking" instead of "Thought for Ns" after a response completes
2597- [VSCode] Fixed missing session diff button when opening sessions from the left sidebar
2598
2599## 2.1.78
2600
2601- Added `StopFailure` hook event that fires when the turn ends due to an API error (rate limit, auth failure, etc.)
2602- Added `${CLAUDE_PLUGIN_DATA}` variable for plugin persistent state that survives plugin updates; `/plugin uninstall` prompts before deleting it
2603- Added `effort`, `maxTurns`, and `disallowedTools` frontmatter support for plugin-shipped agents
2604- Terminal notifications (iTerm2/Kitty/Ghostty popups, progress bar) now reach the outer terminal when running inside tmux with `set -g allow-passthrough on`
2605- Response text now streams line-by-line as it's generated
2606- Fixed `git log HEAD` failing with "ambiguous argument" inside sandboxed Bash on Linux, and stub files polluting `git status` in the working directory
2607- Fixed `cc log` and `--resume` silently truncating conversation history on large sessions (>5 MB) that used subagents
2608- Fixed infinite loop when API errors triggered stop hooks that re-fed blocking errors to the model
2609- Fixed `deny: ["mcp__servername"]` permission rules not removing MCP server tools before sending to the model, allowing it to see and attempt blocked tools
2610- Fixed `sandbox.filesystem.allowWrite` not working with absolute paths (previously required `//` prefix)
2611- Fixed `/sandbox` Dependencies tab showing Linux prerequisites on macOS instead of macOS-specific info
2612- **Security:** Fixed silent sandbox disable when `sandbox.enabled: true` is set but dependencies are missing — now shows a visible startup warning
2613- Fixed `.git`, `.claude`, and other protected directories being writable without a prompt in `bypassPermissions` mode
2614- Fixed ctrl+u in normal mode scrolling instead of readline kill-line (ctrl+u/ctrl+d half-page scroll moved to transcript mode only)
2615- Fixed voice mode modifier-combo push-to-talk keybindings (e.g. ctrl+k) requiring a hold instead of activating immediately
2616- Fixed voice mode not working on WSL2 with WSLg (Windows 11); WSL1/Win10 users now get a clear error
2617- Fixed `--worktree` flag not loading skills and hooks from the worktree directory
2618- Fixed `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` and `includeGitInstructions` setting not suppressing the git status section in the system prompt
2619- Fixed Bash tool not finding Homebrew and other PATH-dependent binaries when VS Code is launched from Dock/Spotlight
2620- Fixed washed-out Claude orange color in VS Code/Cursor/code-server terminals that don't advertise truecolor support
2621- Added `ANTHROPIC_CUSTOM_MODEL_OPTION` env var to add a custom entry to the `/model` picker, with optional `_NAME` and `_DESCRIPTION` suffixed vars for display
2622- Fixed `ANTHROPIC_BETAS` environment variable being silently ignored when using Haiku models
2623- Fixed queued prompts being concatenated without a newline separator
2624- Improved memory usage and startup time when resuming large sessions
2625- [VSCode] Fixed a brief flash of the login screen when opening the sidebar while already authenticated
2626- [VSCode] Fixed "API Error: Rate limit reached" when selecting Opus — model dropdown no longer offers 1M context variant to subscribers whose plan tier is unknown
2627
2628## 2.1.77
2629
2630- Increased default maximum output token limits for Claude Opus 4.6 to 64k tokens, and the upper bound for Opus 4.6 and Sonnet 4.6 models to 128k tokens
2631- Added `allowRead` sandbox filesystem setting to re-allow read access within `denyRead` regions
2632- `/copy` now accepts an optional index: `/copy N` copies the Nth-latest assistant response
2633- Fixed "Always Allow" on compound bash commands (e.g. `cd src && npm test`) saving a single rule for the full string instead of per-subcommand, leading to dead rules and repeated permission prompts
2634- Fixed auto-updater starting overlapping binary downloads when the slash-command overlay repeatedly opened and closed, accumulating tens of gigabytes of memory
2635- Fixed `--resume` silently truncating recent conversation history due to a race between memory-extraction writes and the main transcript
2636- Fixed PreToolUse hooks returning `"allow"` bypassing `deny` permission rules, including enterprise managed settings
2637- Fixed Write tool silently converting line endings when overwriting CRLF files or creating files in CRLF directories
2638- Fixed memory growth in long-running sessions from progress messages surviving compaction
2639- Fixed cost and token usage not being tracked when the API falls back to non-streaming mode
2640- Fixed `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` not stripping beta tool-schema fields, causing proxy gateways to reject requests
2641- Fixed Bash tool reporting errors for successful commands when the system temp directory path contains spaces
2642- Fixed paste being lost when typing immediately after pasting
2643- Fixed Ctrl+D in `/feedback` text input deleting forward instead of the second press exiting the session
2644- Fixed API error when dragging a 0-byte image file into the prompt
2645- Fixed Claude Desktop sessions incorrectly using the terminal CLI's configured API key instead of OAuth
2646- Fixed `git-subdir` plugins at different subdirectories of the same monorepo commit colliding in the plugin cache
2647- Fixed ordered list numbers not rendering in terminal UI
2648- Fixed a race condition where stale-worktree cleanup could delete an agent worktree just resumed from a previous crash
2649- Fixed input deadlock when opening `/mcp` or similar dialogs while the agent is running
2650- Fixed Backspace and Delete keys not working in vim NORMAL mode
2651- Fixed status line not updating when vim mode is toggled on or off
2652- Fixed hyperlinks opening twice on Cmd+click in VS Code, Cursor, and other xterm.js-based terminals
2653- Fixed background colors rendering as terminal-default inside tmux with default configuration
2654- Fixed iTerm2 session crash when selecting text inside tmux over SSH
2655- Fixed clipboard copy silently failing in tmux sessions; copy toast now indicates whether to paste with `⌘V` or tmux `prefix+]`
2656- Fixed `←`/`→` accidentally switching tabs in settings, permissions, and sandbox dialogs while navigating lists
2657- Fixed IDE integration not auto-connecting when Claude Code is launched inside tmux or screen
2658- Fixed CJK characters visually bleeding into adjacent UI elements when clipped at the right edge
2659- Fixed teammate panes not closing when the leader exits
2660- Fixed iTerm2 auto mode not detecting iTerm2 for native split-pane teammates
2661- Faster startup on macOS (~60ms) by reading keychain credentials in parallel with module loading
2662- Faster `--resume` on fork-heavy and very large sessions — up to 45% faster loading and ~100-150MB less peak memory
2663- Improved Esc to abort in-flight non-streaming API requests
2664- Improved `claude plugin validate` to check skill, agent, and command frontmatter plus `hooks/hooks.json`, catching YAML parse errors and schema violations
2665- Background bash tasks are now killed if output exceeds 5GB, preventing runaway processes from filling disk
2666- Sessions are now auto-named from plan content when you accept a plan
2667- Improved headless mode plugin installation to compose correctly with `CLAUDE_CODE_PLUGIN_SEED_DIR`
2668- Show a notice when `apiKeyHelper` takes longer than 10s, preventing it from blocking the main loop
2669- The Agent tool no longer accepts a `resume` parameter — use `SendMessage({to: agentId})` to continue a previously spawned agent
2670- `SendMessage` now auto-resumes stopped agents in the background instead of returning an error
2671- Renamed `/fork` to `/branch` (`/fork` still works as an alias)
2672- [VSCode] Improved plan preview tab titles to use the plan's heading instead of "Claude's Plan"
2673- [VSCode] When option+click doesn't trigger native selection on macOS, the footer now points to the `macOptionClickForcesSelection` setting
2674
2675## 2.1.76
2676
2677- Added MCP elicitation support — MCP servers can now request structured input mid-task via an interactive dialog (form fields or browser URL)
2678- Added new `Elicitation` and `ElicitationResult` hooks to intercept and override responses before they're sent back
2679- Added `-n` / `--name <name>` CLI flag to set a display name for the session at startup
2680- Added `worktree.sparsePaths` setting for `claude --worktree` in large monorepos to check out only the directories you need via git sparse-checkout
2681- Added `PostCompact` hook that fires after compaction completes
2682- Added `/effort` slash command to set model effort level
2683- Added session quality survey — enterprise admins can configure the sample rate via the `feedbackSurveyRate` setting
2684- Fixed deferred tools (loaded via `ToolSearch`) losing their input schemas after conversation compaction, causing array and number parameters to be rejected with type errors
2685- Fixed slash commands showing "Unknown skill"
2686- Fixed plan mode asking for re-approval after the plan was already accepted
2687- Fixed voice mode swallowing keypresses while a permission dialog or plan editor was open
2688- Fixed `/voice` not working on Windows when installed via npm
2689- Fixed spurious "Context limit reached" when invoking a skill with `model:` frontmatter on a 1M-context session
2690- Fixed "adaptive thinking is not supported on this model" error when using non-standard model strings
2691- Fixed `Bash(cmd:*)` permission rules not matching when a quoted argument contains `#`
2692- Fixed "don't ask again" in the Bash permission dialog showing the full raw command for pipes and compound commands
2693- Fixed auto-compaction retrying indefinitely after consecutive failures — a circuit breaker now stops after 3 attempts
2694- Fixed MCP reconnect spinner persisting after successful reconnection
2695- Fixed LSP plugins not registering servers when the LSP Manager initialized before marketplaces were reconciled
2696- Fixed clipboard copying in tmux over SSH — now attempts both direct terminal write and tmux clipboard integration
2697- Fixed `/export` showing only the filename instead of the full file path in the success message
2698- Fixed transcript not auto-scrolling to new messages after selecting text
2699- Fixed Escape key not working to exit the login method selection screen
2700- Fixed several Remote Control issues: sessions silently dying when the server reaps an idle environment, rapid messages being queued one-at-a-time instead of batched, and stale work items causing redelivery after JWT refresh
2701- Fixed bridge sessions failing to recover after extended WebSocket disconnects
2702- Fixed slash commands not found when typing the exact name of a soft-hidden command
2703- Improved `--worktree` startup performance by reading git refs directly and skipping redundant `git fetch` when the remote branch is already available locally
2704- Improved background agent behavior — killing a background agent now preserves its partial results in the conversation context
2705- Improved model fallback notifications — now always visible instead of hidden behind verbose mode, with human-friendly model names
2706- Improved blockquote readability on dark terminal themes — text is now italic with a left bar instead of dim
2707- Improved stale worktree cleanup — worktrees left behind after an interrupted parallel run are now automatically cleaned up
2708- Improved Remote Control session titles — now derived from your first prompt instead of showing "Interactive session"
2709- Improved `/voice` to show your dictation language on enable and warn when your `language` setting isn't supported for voice input
2710- Updated `--plugin-dir` to only accept one path to support subcommands — use repeated `--plugin-dir` for multiple directories
2711- [VSCode] Fixed gitignore patterns containing commas silently excluding entire filetypes from the @-mention file picker
2712
2713## 2.1.75
2714
2715- Added 1M context window for Opus 4.6 by default for Max, Team, and Enterprise plans (previously required extra usage)
2716- Added `/color` command for all users to set a prompt-bar color for your session
2717- Added session name display on the prompt bar when using `/rename`
2718- Added last-modified timestamps to memory files, helping Claude reason about which memories are fresh vs. stale
2719- Added hook source display (settings/plugin/skill) in permission prompts when a hook requires confirmation
2720- Fixed voice mode not activating correctly on fresh installs without toggling `/voice` twice
2721- Fixed the Claude Code header not updating the displayed model name after switching models with `/model` or Option+P
2722- Fixed session crash when an attachment message computation returns undefined values
2723- Fixed Bash tool mangling `!` in piped commands (e.g., `jq 'select(.x != .y)'` now works correctly)
2724- Fixed managed-disabled plugins showing up in the `/plugin` Installed tab — plugins force-disabled by your organization are now hidden
2725- Fixed token estimation over-counting for thinking and `tool_use` blocks, preventing premature context compaction
2726- Fixed corrupted marketplace config path handling
2727- Fixed `/resume` losing session names after resuming a forked or continued session
2728- Fixed Esc not closing the `/status` dialog after visiting the Config tab
2729- Fixed input handling when accepting or rejecting a plan
2730- Fixed footer hint in agent teams showing "↓ to expand" instead of the correct "shift + ↓ to expand"
2731- Improved startup performance on macOS non-MDM machines by skipping unnecessary subprocess spawns
2732- Suppressed async hook completion messages by default (visible with `--verbose` or transcript mode)
2733- Breaking change: Removed deprecated Windows managed settings fallback at `C:\ProgramData\ClaudeCode\managed-settings.json` — use `C:\Program Files\ClaudeCode\managed-settings.json`
2734
2735## 2.1.74
2736
2737- Added actionable suggestions to `/context` command — identifies context-heavy tools, memory bloat, and capacity warnings with specific optimization tips
2738- Added `autoMemoryDirectory` setting to configure a custom directory for auto-memory storage
2739- Fixed memory leak where streaming API response buffers were not released when the generator was terminated early, causing unbounded RSS growth on the Node.js/npm code path
2740- Fixed managed policy `ask` rules being bypassed by user `allow` rules or skill `allowed-tools`
2741- Fixed full model IDs (e.g., `claude-opus-4-5`) being silently ignored in agent frontmatter `model:` field and `--agents` JSON config — agents now accept the same model values as `--model`
2742- Fixed MCP OAuth authentication hanging when the callback port is already in use
2743- Fixed MCP OAuth refresh never prompting for re-auth after the refresh token expires, for OAuth servers that return errors with HTTP 200 (e.g. Slack)
2744- Fixed voice mode silently failing on the macOS native binary for users whose terminal had never been granted microphone permission — the binary now includes the `audio-input` entitlement so macOS prompts correctly
2745- Fixed `SessionEnd` hooks being killed after 1.5 s on exit regardless of `hook.timeout` — now configurable via `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`
2746- Fixed `/plugin install` failing inside the REPL for marketplace plugins with local sources
2747- Fixed marketplace update not syncing git submodules — plugin sources in submodules no longer break after update
2748- Fixed unknown slash commands with arguments silently dropping input — now shows your input as a warning
2749- Fixed Hebrew, Arabic, and other RTL text not rendering correctly in Windows Terminal, conhost, and VS Code integrated terminal
2750- Fixed LSP servers not working on Windows due to malformed file URIs
2751- Changed `--plugin-dir` so local dev copies now override installed marketplace plugins with the same name (unless that plugin is force-enabled by managed settings)
2752- [VSCode] Fixed delete button not working for Untitled sessions
2753- [VSCode] Improved scroll wheel responsiveness in the integrated terminal with terminal-aware acceleration
2754
2755## 2.1.73
2756
2757- Added `modelOverrides` setting to map model picker entries to custom provider model IDs (e.g. Bedrock inference profile ARNs)
2758- Added actionable guidance when OAuth login or connectivity checks fail due to SSL certificate errors (corporate proxies, `NODE_EXTRA_CA_CERTS`)
2759- Fixed freezes and 100% CPU loops triggered by permission prompts for complex bash commands
2760- Fixed a deadlock that could freeze Claude Code when many skill files changed at once (e.g. during `git pull` in a repo with a large `.claude/skills/` directory)
2761- Fixed Bash tool output being lost when running multiple Claude Code sessions in the same project directory
2762- Fixed subagents with `model: opus`/`sonnet`/`haiku` being silently downgraded to older model versions on Bedrock, Vertex, and Microsoft Foundry
2763- Fixed background bash processes spawned by subagents not being cleaned up when the agent exits
2764- Fixed `/resume` showing the current session in the picker
2765- Fixed `/ide` crashing with `onInstall is not defined` when auto-installing the extension
2766- Fixed `/loop` not being available on Bedrock/Vertex/Foundry and when telemetry was disabled
2767- Fixed SessionStart hooks firing twice when resuming a session via `--resume` or `--continue`
2768- Fixed JSON-output hooks injecting no-op system-reminder messages into the model's context on every turn
2769- Fixed voice mode session corruption when a slow connection overlaps a new recording
2770- Fixed Linux sandbox failing to start with "ripgrep (rg) not found" on native builds
2771- Fixed Linux native modules not loading on Amazon Linux 2 and other glibc 2.26 systems
2772- Fixed "media_type: Field required" API error when receiving images via Remote Control
2773- Fixed `/heapdump` failing on Windows with `EEXIST` error when the Desktop folder already exists
2774- Improved Up arrow after interrupting Claude — now restores the interrupted prompt and rewinds the conversation in one step
2775- Improved IDE detection speed at startup
2776- Improved clipboard image pasting performance on macOS
2777- Improved `/effort` to work while Claude is responding, matching `/model` behavior
2778- Improved voice mode to automatically retry transient connection failures during rapid push-to-talk re-press
2779- Improved the Remote Control spawn mode selection prompt with better context
2780- Changed default Opus model on Bedrock, Vertex, and Microsoft Foundry to Opus 4.6 (was Opus 4.1)
2781- Deprecated `/output-style` command — use `/config` instead. Output style is now fixed at session start for better prompt caching
2782- VSCode: Fixed HTTP 400 errors for users behind proxies or on Bedrock/Vertex with Claude 4.5 models
2783
2784## 2.1.72
2785
2786- Fixed tool search to activate even with `ANTHROPIC_BASE_URL` as long as `ENABLE_TOOL_SEARCH` is set.
2787- Added `w` key in `/copy` to write the focused selection directly to a file, bypassing the clipboard (useful over SSH)
2788- Added optional description argument to `/plan` (e.g., `/plan fix the auth bug`) that enters plan mode and immediately starts
2789- Added `ExitWorktree` tool to leave an `EnterWorktree` session
2790- Added `CLAUDE_CODE_DISABLE_CRON` environment variable to immediately stop scheduled cron jobs mid-session
2791- Added `lsof`, `pgrep`, `tput`, `ss`, `fd`, and `fdfind` to the bash auto-approval allowlist, reducing permission prompts for common read-only operations
2792- Restored the `model` parameter on the Agent tool for per-invocation model overrides
2793- Simplified effort levels to low/medium/high (removed max) with new symbols (○ ◐ ●) and a brief notification instead of a persistent icon. Use `/effort auto` to reset to default
2794- Improved `/config` — Escape now cancels changes, Enter saves and closes, Space toggles settings
2795- Improved up-arrow history to show current session's messages first when running multiple concurrent sessions
2796- Improved voice input transcription accuracy for repo names and common dev terms (regex, OAuth, JSON)
2797- Improved bash command parsing by switching to a native module — faster initialization and no memory leak
2798- Reduced bundle size by ~510 KB
2799- Changed CLAUDE.md HTML comments (`<!-- ... -->`) to be hidden from Claude when auto-injected. Comments remain visible when read with the Read tool
2800- Fixed slow exits when background tasks or hooks were slow to respond
2801- Fixed agent task progress stuck on "Initializing…"
2802- Fixed skill hooks firing twice per event when a hooks-enabled skill is invoked by the model
2803- Fixed several voice mode issues: occasional input lag, false "No speech detected" errors after releasing push-to-talk, and stale transcripts re-filling the prompt after submission
2804- Fixed `--continue` not resuming from the most recent point after `--compact`
2805- Fixed bash security parsing edge cases
2806- Added support for marketplace git URLs without `.git` suffix (Azure DevOps, AWS CodeCommit)
2807- Improved marketplace clone failure messages to show diagnostic info even when git produces no stderr
2808- Fixed several plugin issues: installation failing on Windows with `EEXIST` error in OneDrive folders, marketplace blocking user-scope installs when a project-scope install exists, `CLAUDE_CODE_PLUGIN_CACHE_DIR` creating literal `~` directories, and `plugin.json` with marketplace-only fields failing to load
2809- Fixed feedback survey appearing too frequently in long sessions
2810- Fixed `--effort` CLI flag being reset by unrelated settings writes on startup
2811- Fixed backgrounded Ctrl+B queries losing their transcript or corrupting the new conversation after `/clear`
2812- Fixed `/clear` killing background agent/bash tasks — only foreground tasks are now cleared
2813- Fixed worktree isolation issues: Task tool resume not restoring cwd, and background task notifications missing `worktreePath` and `worktreeBranch`
2814- Fixed `/model` not displaying results when run while Claude is working
2815- Fixed digit keys selecting menu options instead of typing in plan mode permission prompt's text input
2816- Fixed sandbox permission issues: certain file write operations incorrectly allowed without prompting, and output redirections to allowlisted directories (like `/tmp/claude/`) prompting unnecessarily
2817- Improved CPU utilization in long sessions
2818- Fixed prompt cache invalidation in SDK `query()` calls, reducing input token costs up to 12x
2819- Fixed Escape key becoming unresponsive after cancelling a query
2820- Fixed double Ctrl+C not exiting when background agents or tasks are running
2821- Fixed team agents to inherit the leader's model
2822- Fixed "Always Allow" saving permission rules that never match again
2823- Fixed several hooks issues: `transcript_path` pointing to the wrong directory for resumed/forked sessions, agent `prompt` being silently deleted from settings.json on every settings write, PostToolUse block reason displaying twice, async hooks not receiving stdin with bash `read -r`, and validation error message showing an example that fails validation
2824- Fixed session crashes in Desktop/SDK when Read returned files containing U+2028/U+2029 characters
2825- Fixed terminal title being cleared on exit even when `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` was set
2826- Fixed several permission rule matching issues: wildcard rules not matching commands with heredocs, embedded newlines, or no arguments; `sandbox.excludedCommands` failing with env var prefixes; "always allow" suggesting overly broad prefixes for nested CLI tools; and deny rules not applying to all command forms
2827- Fixed oversized and truncated images from Bash data-URL output
2828- Fixed a crash when resuming sessions that contained Bedrock API errors
2829- Fixed intermittent "expected boolean, received string" validation errors on Edit, Bash, and Grep tool inputs
2830- Fixed multi-line session titles when forking from a conversation whose first message contained newlines
2831- Fixed queued messages not showing attached images, and images being lost when pressing ↑ to edit a queued message
2832- Fixed parallel tool calls where a failed Read/WebFetch/Glob would cancel its siblings — only Bash errors now cascade
2833- VSCode: Fixed scroll speed in integrated terminals not matching native terminals
2834- VSCode: Fixed Shift+Enter submitting input instead of inserting a newline for users with older keybindings
2835- VSCode: Added effort level indicator on the input border
2836- VSCode: Added `vscode://anthropic.claude-code/open` URI handler to open a new Claude Code tab programmatically, with optional `prompt` and `session` query parameters
2837
2838## 2.1.71
2839
2840- Added `/loop` command to run a prompt or slash command on a recurring interval (e.g. `/loop 5m check the deploy`)
2841- Added cron scheduling tools for recurring prompts within a session
2842- Added `voice:pushToTalk` keybinding to make the voice activation key rebindable in `keybindings.json` (default: space) — modifier+letter combos like `meta+k` have zero typing interference
2843- Added `fmt`, `comm`, `cmp`, `numfmt`, `expr`, `test`, `printf`, `getconf`, `seq`, `tsort`, and `pr` to the bash auto-approval allowlist
2844- Fixed stdin freeze in long-running sessions where keystrokes stop being processed but the process stays alive
2845- Fixed a 5–8 second startup freeze for users with voice mode enabled, caused by CoreAudio initialization blocking the main thread after system wake
2846- Fixed startup UI freeze when many claude.ai proxy connectors refresh an expired OAuth token simultaneously
2847- Fixed forked conversations (`/fork`) sharing the same plan file, which caused plan edits in one fork to overwrite the other
2848- Fixed the Read tool putting oversized images into context when image processing failed, breaking subsequent turns in long image-heavy sessions
2849- Fixed false-positive permission prompts for compound bash commands containing heredoc commit messages
2850- Fixed plugin installations being lost when running multiple Claude Code instances
2851- Fixed claude.ai connectors failing to reconnect after OAuth token refresh
2852- Fixed claude.ai MCP connector startup notifications appearing for every org-configured connector instead of only previously connected ones
2853- Fixed background agent completion notifications missing the output file path, which made it difficult for parent agents to recover agent results after context compaction
2854- Fixed duplicate output in Bash tool error messages when commands exit with non-zero status
2855- Fixed Chrome extension auto-detection getting permanently stuck on "not installed" after running on a machine without local Chrome
2856- Fixed `/plugin marketplace update` failing with merge conflicts when the marketplace is pinned to a branch/tag ref
2857- Fixed `/plugin marketplace add owner/repo@ref` incorrectly parsing `@` — previously only `#` worked as a ref separator, causing undiagnosable errors with `strictKnownMarketplaces`
2858- Fixed duplicate entries in `/permissions` Workspace tab when the same directory is added with and without a trailing slash
2859- Fixed `--print` hanging forever when team agents are configured — the exit loop no longer waits on long-lived `in_process_teammate` tasks
2860- Fixed "❯ Tool loaded." appearing in the REPL after every `ToolSearch` call
2861- Fixed prompting for `cd <cwd> && git ...` on Windows when the model uses a mingw-style path
2862- Improved startup time by deferring native image processor loading to first use
2863- Improved bridge session reconnection to complete within seconds after laptop wake from sleep, instead of waiting up to 10 minutes
2864- Improved `/plugin uninstall` to disable project-scoped plugins in `.claude/settings.local.json` instead of modifying `.claude/settings.json`, so changes don't affect teammates
2865- Improved plugin-provided MCP server deduplication — servers that duplicate a manually-configured server (same command/URL) are now skipped, preventing duplicate connections and tool sets. Suppressions are shown in the `/plugin` menu.
2866- Updated `/debug` to toggle debug logging on mid-session, since debug logs are no longer written by default
2867- Removed startup notification noise for unauthenticated org-registered claude.ai connectors
2868
2869## 2.1.70
2870
2871- Fixed API 400 errors when using `ANTHROPIC_BASE_URL` with a third-party gateway — tool search now correctly detects proxy endpoints and disables `tool_reference` blocks
2872- Fixed `API Error: 400 This model does not support the effort parameter` when using custom Bedrock inference profiles or other model identifiers not matching standard Claude naming patterns
2873- Fixed empty model responses immediately after `ToolSearch` — the server renders tool schemas with system-prompt-style tags at the prompt tail, which could confuse models into stopping early
2874- Fixed prompt-cache bust when an MCP server with `instructions` connects after the first turn
2875- Fixed Enter inserting a newline instead of submitting when typing over a slow SSH connection
2876- Fixed clipboard corrupting non-ASCII text (CJK, emoji) on Windows/WSL by using PowerShell `Set-Clipboard`
2877- Fixed extra VS Code windows opening at startup on Windows when running from the VS Code integrated terminal
2878- Fixed voice mode failing on Windows native binary with "native audio module could not be loaded"
2879- Fixed push-to-talk not activating on session start when `voiceEnabled: true` was set in settings
2880- Fixed markdown links containing `#NNN` references incorrectly pointing to the current repository instead of the linked URL
2881- Fixed repeated "Model updated to Opus 4.6" notification when a project's `.claude/settings.json` has a legacy Opus model string pinned
2882- Fixed plugins showing as inaccurately installed in `/plugin`
2883- Fixed plugins showing "not found in marketplace" errors on fresh startup by auto-refreshing after marketplace installation
2884- Fixed `/security-review` command failing with `unknown option merge-base` on older git versions
2885- Fixed `/color` command having no way to reset back to the default color — `/color default`, `/color gray`, `/color reset`, and `/color none` now restore the default
2886- Fixed a performance regression in the `AskUserQuestion` preview dialog that re-ran markdown rendering on every keystroke in the notes input
2887- Fixed feature flags read during early startup never refreshing their disk cache, causing stale values to persist across sessions
2888- Fixed `permissions.defaultMode` settings values other than `acceptEdits` or `plan` being applied in Claude Code Remote environments — they are now ignored
2889- Fixed skill listing being re-injected on every `--resume` (~600 tokens saved per resume)
2890- Fixed teleport marker not rendering in VS Code teleported sessions
2891- Improved error message when microphone captures silence to distinguish from "no speech detected"
2892- Improved compaction to preserve images in the summarizer request, allowing prompt cache reuse for faster and cheaper compaction
2893- Improved `/rename` to work while Claude is processing, instead of being silently queued
2894- Reduced prompt input re-renders during turns by ~74%
2895- Reduced startup memory by ~426KB for users without custom CA certificates
2896- Reduced Remote Control `/poll` rate to once per 10 minutes while connected (was 1–2s), cutting server load ~300×. Reconnection is unaffected — transport loss immediately wakes fast polling.
2897- [VSCode] Added spark icon in VS Code activity bar that lists all Claude Code sessions, with sessions opening as full editors
2898- [VSCode] Added full markdown document view for plans in VS Code, with support for adding comments to provide feedback
2899- [VSCode] Added native MCP server management dialog — use `/mcp` in the chat panel to enable/disable servers, reconnect, and manage OAuth authentication without switching to the terminal
2900
2901## 2.1.69
2902
2903- Added the `/claude-api` skill for building applications with the Claude API and Anthropic SDK
2904- Added Ctrl+U on an empty bash prompt (`!`) to exit bash mode, matching `escape` and `backspace`
2905- Added numeric keypad support for selecting options in Claude's interview questions (previously only the number row above QWERTY worked)
2906- Added optional name argument to `/remote-control` and `claude remote-control` (`/remote-control My Project` or `--name "My Project"`) to set a custom session title visible in claude.ai/code
2907- Added Voice STT support for 10 new languages (20 total) — Russian, Polish, Turkish, Dutch, Ukrainian, Greek, Czech, Danish, Swedish, Norwegian
2908- Added effort level display (e.g., "with low effort") to the logo and spinner, making it easier to see which effort setting is active
2909- Added agent name display in terminal title when using `claude --agent`
2910- Added `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`
2911- Added `includeGitInstructions` setting (and `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` env var) to remove built-in commit and PR workflow instructions from Claude's system prompt
2912- Added `/reload-plugins` command to activate pending plugin changes without restarting
2913- Added a one-time startup prompt suggesting Claude Code Desktop on macOS and Windows (max 3 showings, dismissible)
2914- Added `${CLAUDE_SKILL_DIR}` variable for skills to reference their own directory in SKILL.md content
2915- Added `InstructionsLoaded` hook event that fires when CLAUDE.md or `.claude/rules/*.md` files are loaded into context
2916- Added `agent_id` (for subagents) and `agent_type` (for subagents and `--agent`) to hook events
2917- Added `worktree` field to status line hook commands with name, path, branch, and original repo directory when running in a `--worktree` session
2918- Added `pluginTrustMessage` in managed settings to append organization-specific context to the plugin trust warning shown before installation
2919- Added policy limit fetching (e.g., remote control restrictions) for Team plan OAuth users, not just Enterprise
2920- Added `pathPattern` to `strictKnownMarketplaces` for regex-matching file/directory marketplace sources alongside `hostPattern` restrictions
2921- Added plugin source type `git-subdir` to point to a subdirectory within a git repo
2922- Added `oauth.authServerMetadataUrl` config option for MCP servers to specify a custom OAuth metadata discovery URL when standard discovery fails
2923- Fixed a security issue where nested skill discovery could load skills from gitignored directories like `node_modules`
2924- Fixed trust dialog silently enabling all `.mcp.json` servers on first run. You'll now see the per-server approval dialog as expected
2925- Fixed `claude remote-control` crashing immediately on npm installs with "bad option: --sdk-url" (anthropics/claude-code#28334)
2926- Fixed `--model claude-opus-4-0` and `--model claude-opus-4-1` resolving to deprecated Opus versions instead of current
2927- Fixed macOS keychain corruption when using multiple OAuth MCP servers. Large OAuth metadata blobs could overflow the `security -i` stdin buffer, silently leaving stale credentials behind and causing repeated `/login` prompts.
2928- Fixed `.credentials.json` losing `subscriptionType` (showing "Claude API" instead of "Claude Pro"/"Claude Max") when the profile endpoint transiently fails during token refresh (anthropics/claude-code#30185)
2929- Fixed ghost dotfiles (`.bashrc`, `HEAD`, etc.) appearing as untracked files in the working directory after sandboxed Bash commands on Linux
2930- Fixed Shift+Enter printing `[27;2;13~` instead of inserting a newline in Ghostty over SSH
2931- Fixed stash (Ctrl+S) being cleared when submitting a message while Claude is working
2932- Fixed ctrl+o (transcript toggle) freezing for many seconds in long sessions with lots of file edits
2933- Fixed plan mode feedback input not supporting multi-line text entry (backslash+Enter and Shift+Enter now insert newlines)
2934- Fixed cursor not moving down into blank lines at the top of the input box
2935- Fixed `/stats` crash when transcript files contain entries with missing or malformed timestamps
2936- Fixed a brief hang after a streaming error on long sessions (the transcript was being fully rewritten to drop one line; it is now truncated in place)
2937- Fixed `--setting-sources user` not blocking dynamically discovered project skills
2938- Fixed duplicate CLAUDE.md, slash commands, agents, and rules when running from a worktree nested inside its main repo (e.g. `claude -w`)
2939- Fixed plugin Stop/SessionEnd/etc hooks not firing after any `/plugin` operation
2940- Fixed plugin hooks being silently dropped when two plugins use the same `${CLAUDE_PLUGIN_ROOT}/...` command template
2941- Fixed memory leak in long-running SDK/CCR sessions where conversation messages were retained unnecessarily
2942- Fixed API 400 errors in forked agents (autocompact, summarization) when resuming sessions that were interrupted mid-tool-batch
2943- Fixed "unexpected tool_use_id found in tool_result blocks" error when resuming conversations that start with an orphaned tool result
2944- Fixed teammates accidentally spawning nested teammates via the Agent tool's `name` parameter
2945- Fixed `CLAUDE_CODE_MAX_OUTPUT_TOKENS` being ignored during conversation compaction
2946- Fixed `/compact` summary rendering as a user bubble in SDK consumers (Claude Code Remote web UI, VSCode extension)
2947- Fixed voice space bar getting stuck after a failed voice activation (module loading race, cold GrowthBook)
2948- Fixed worktree file copy on Windows
2949- Fixed global `.claude` folder detection on Windows
2950- Fixed symlink bypass where writing new files through a symlinked parent directory could escape the working directory in `acceptEdits` mode
2951- Fixed sandbox prompting users to approve non-allowed domains when `allowManagedDomainsOnly` is enabled in managed settings — non-allowed domains are now blocked automatically with no bypass
2952- Fixed interactive tools (e.g., `AskUserQuestion`) being silently auto-allowed when listed in a skill's allowed-tools, bypassing the permission prompt and running with empty answers
2953- Fixed multi-GB memory spike when committing with large untracked binary files in the working tree
2954- Fixed Escape not interrupting a running turn when the input box has draft text. Use Up arrow to pull queued messages back for editing, or Ctrl+U to clear the input line.
2955- Fixed Android app crash when running local slash commands (`/voice`, `/cost`) in Remote Control sessions
2956- Fixed a memory leak where old message array versions accumulated in React Compiler `memoCache` over long sessions
2957- Fixed a memory leak where REPL render scopes accumulated over long sessions (~35MB over 1000 turns)
2958- Fixed memory retention in in-process teammates where the parent's full conversation history was pinned for the teammate's lifetime, preventing GC after `/clear` or auto-compact
2959- Fixed a memory leak in interactive mode where hook events could accumulate unboundedly during long sessions
2960- Fixed hang when `--mcp-config` points to a corrupted file
2961- Fixed slow startup when many skills/plugins are installed
2962- Fixed `cd <outside-dir> && <cmd>` permission prompt to surface the chained command instead of only showing "Yes, allow reading from <dir>/"
2963- Fixed conditional `.claude/rules/*.md` files (with `paths:` frontmatter) and nested CLAUDE.md files not loading in print mode (`claude -p`)
2964- Fixed `/clear` not fully clearing all session caches, reducing memory retention in long sessions
2965- Fixed terminal flicker caused by animated elements at the scrollback boundary
2966- Fixed UI frame drops on macOS when using MCP servers with OAuth (regression from 2.1.x)
2967- Fixed occasional frame stalls during typing caused by synchronous debug log flushes
2968- Fixed `TeammateIdle` and `TaskCompleted` hooks to support `{"continue": false, "stopReason": "..."}` to stop the teammate, matching `Stop` hook behavior
2969- Fixed `WorktreeCreate` and `WorktreeRemove` plugin hooks being silently ignored
2970- Fixed skill descriptions with colons (e.g., "Triggers include: X, Y, Z") failing to load from SKILL.md frontmatter
2971- Fixed project skills without a `description:` frontmatter field not appearing in Claude's available skills list
2972- Fixed `/context` showing identical token counts for all MCP tools from a server
2973- Fixed literal `nul` file creation on Windows when the model uses CMD-style `2>nul` redirection in Git Bash
2974- Fixed extra blank lines appearing below each tool call in the expanded subagent transcript view (Ctrl+O)
2975- Fixed Tab/arrow keys not cycling Settings tabs when `/config` search box is focused but empty
2976- Fixed service key OAuth sessions (CCR containers) spamming `[ERROR]` logs with 403s from profile-scoped endpoints
2977- Fixed inconsistent color for "Remote Control active" status indicator
2978- Fixed Voice waveform cursor covering the first suffix letter when dictating mid-input
2979- Fixed Voice input showing all 5 spaces during warmup instead of capping at ~2 (aligning with the "keep holding…" hint)
2980- Improved spinner performance by isolating the 50ms animation loop from the surrounding shell, reducing render and CPU overhead during turns
2981- Improved UI rendering performance in native binaries with React Compiler
2982- Improved `--worktree` startup by eliminating a git subprocess on the startup path
2983- Improved macOS startup by eliminating redundant settings-file reloads when managed settings resolve
2984- Improved macOS startup for Claude.ai enterprise/team users by skipping an unnecessary keychain lookup
2985- Improved MCP `-p` startup by pipelining claude.ai config fetch with local connections and using a concurrency pool instead of sequential batching
2986- Improved voice startup by removing imperceptible warmup pulse animations that were causing re-render stutter
2987- Improved MCP binary content handling: tools returning PDFs, Office documents, or audio now save decoded bytes to disk with the correct file extension instead of dumping raw base64 into the conversation context. WebFetch also saves binary responses alongside its summary.
2988- Improved memory usage in long sessions by stabilizing `onSubmit` across message updates
2989- Improved LSP tool rendering and memory context building to no longer read entire files
2990- Improved session upload and memory sync to avoid reading large files into memory before size/binary checks
2991- Improved file operation performance by avoiding reading file contents for existence checks (6 sites)
2992- Improved documentation to clarify that `--append-system-prompt-file` and `--system-prompt-file` work in interactive mode (the docs previously said print mode only)
2993- Reduced baseline memory by ~16MB by deferring Yoga WASM preloading
2994- Reduced memory footprint for SDK and CCR sessions using stream-json output
2995- Reduced memory usage when resuming large sessions (including compacted history)
2996- Reduced token usage on multi-agent tasks with more concise subagent final reports
2997- Changed Sonnet 4.5 users on Pro/Max/Team Premium to be automatically migrated to Sonnet 4.6
2998- Changed the `/resume` picker to show your most recent prompt instead of the first one. This also resolves some titles appearing as `(session)`.
2999- Changed claude.ai MCP connector failures to show a notification instead of silently disappearing from the tool list
3000- Changed example command suggestions to be generated deterministically instead of calling Haiku
3001- Changed resuming after compaction to no longer produce a preamble recap before continuing
3002- [SDK] Changed task creation to no longer require the `activeForm` field — the spinner falls back to the task subject
3003- [VSCode] Added compaction display as a collapsible "Compacted chat" card with the summary inside
3004- [VSCode] The permission mode picker now respects `permissions.disableBypassPermissionsMode` from your effective Claude Code settings (including managed/policy settings) — when set to `disable`, bypass permissions mode is hidden from the picker
3005- [VSCode] Fixed RTL text (Arabic, Hebrew, Persian) rendering reversed in the chat panel (regression in v2.1.63)
3006
3007## 2.1.68
3008
3009- Opus 4.6 now defaults to medium effort for Max and Team subscribers. Medium effort works well for most tasks — it's the sweet spot between speed and thoroughness. You can change this anytime with `/model`
3010- Re-introduced the "ultrathink" keyword to enable high effort for the next turn
3011- Removed Opus 4 and 4.1 from Claude Code on the first-party API — users with these models pinned are automatically moved to Opus 4.6
3012
3013## 2.1.66
3014
3015- Reduced spurious error logging
3016
3017## 2.1.63
3018
3019- Added `/simplify` and `/batch` bundled slash commands
3020- Fixed local slash command output like /cost appearing as user-sent messages instead of system messages in the UI
3021- Project configs & auto memory now shared across git worktrees of the same repository
3022- Added `ENABLE_CLAUDEAI_MCP_SERVERS=false` env var to opt out from making claude.ai MCP servers available
3023- Improved `/model` command to show the currently active model in the slash command menu
3024- Added HTTP hooks, which can POST JSON to a URL and receive JSON instead of running a shell command
3025- Fixed listener leak in bridge polling loop
3026- Fixed listener leak in MCP OAuth flow cleanup
3027- Added manual URL paste fallback during MCP OAuth authentication. If the automatic localhost redirect doesn't work, you can paste the callback URL to complete authentication.
3028- Fixed memory leak when navigating hooks configuration menu
3029- Fixed listener leak in interactive permission handler during auto-approvals
3030- Fixed file count cache ignoring glob ignore patterns
3031- Fixed memory leak in bash command prefix cache
3032- Fixed MCP tool/resource cache leak on server reconnect
3033- Fixed IDE host IP detection cache incorrectly sharing results across ports
3034- Fixed WebSocket listener leak on transport reconnect
3035- Fixed memory leak in git root detection cache that could cause unbounded growth in long-running sessions
3036- Fixed memory leak in JSON parsing cache that grew unbounded over long sessions
3037- VSCode: Fixed remote sessions not appearing in conversation history
3038- Fixed a race condition in the REPL bridge where new messages could arrive at the server interleaved with historical messages during the initial connection flush, causing message ordering issues.
3039- Fixed memory leak where long-running teammates retained all messages in AppState even after conversation compaction
3040- Fixed a memory leak where MCP server fetch caches were not cleared on disconnect, causing growing memory usage with servers that reconnect frequently
3041- Improved memory usage in long sessions with subagents by stripping heavy progress message payloads during context compaction
3042- Added "Always copy full response" option to the `/copy` picker. When selected, future `/copy` commands will skip the code block picker and copy the full response directly.
3043- VSCode: Added session rename and remove actions to the sessions list
3044- Fixed `/clear` not resetting cached skills, which could cause stale skill content to persist in the new conversation
3045
3046## 2.1.62
3047
3048- Fixed prompt suggestion cache regression that reduced cache hit rates
3049
3050## 2.1.61
3051
3052- Fixed concurrent writes corrupting config file on Windows
3053
3054## 2.1.59
3055
3056- Claude automatically saves useful context to auto-memory. Manage with /memory
3057- Added `/copy` command to show an interactive picker when code blocks are present, allowing selection of individual code blocks or the full response.
3058- Improved "always allow" prefix suggestions for compound bash commands (e.g. `cd /tmp && git fetch && git push`) to compute smarter per-subcommand prefixes instead of treating the whole command as one
3059- Improved ordering of short task lists
3060- Improved memory usage in multi-agent sessions by releasing completed subagent task state
3061- Fixed MCP OAuth token refresh race condition when running multiple Claude Code instances simultaneously
3062- Fixed shell commands not showing a clear error message when the working directory has been deleted
3063- Fixed config file corruption that could wipe authentication when multiple Claude Code instances ran simultaneously
3064
3065## 2.1.58
3066
3067- Expand Remote Control to more users
3068
3069## 2.1.56
3070
3071- VS Code: Fixed another cause of "command 'claude-vscode.editor.openLast' not found" crashes
3072
3073## 2.1.55
3074
3075- Fixed BashTool failing on Windows with EINVAL error
3076
3077## 2.1.53
3078
3079- Fixed a UI flicker where user input would briefly disappear after submission before the message rendered
3080- Fixed bulk agent kill (ctrl+f) to send a single aggregate notification instead of one per agent, and to properly clear the command queue
3081- Fixed graceful shutdown sometimes leaving stale sessions when using Remote Control by parallelizing teardown network calls
3082- Fixed `--worktree` sometimes being ignored on first launch
3083- Fixed a panic ("switch on corrupted value") on Windows
3084- Fixed a crash that could occur when spawning many processes on Windows
3085- Fixed a crash in the WebAssembly interpreter on Linux x64 & Windows x64
3086- Fixed a crash that sometimes occurred after 2 minutes on Windows ARM64
3087
3088## 2.1.52
3089
3090- VS Code: Fixed extension crash on Windows ("command 'claude-vscode.editor.openLast' not found")
3091
3092## 2.1.51
3093
3094- Added `claude remote-control` subcommand for external builds, enabling local environment serving for all users.
3095- Updated plugin marketplace default git timeout from 30s to 120s and added `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` to configure.
3096- Added support for custom npm registries and specific version pinning when installing plugins from npm sources
3097- BashTool now skips login shell (`-l` flag) by default when a shell snapshot is available, improving command execution performance. Previously this required setting `CLAUDE_BASH_NO_LOGIN=true`.
3098- Fixed a security issue where `statusLine` and `fileSuggestion` hook commands could execute without workspace trust acceptance in interactive mode.
3099- Tool results larger than 50K characters are now persisted to disk (previously 100K). This reduces context window usage and improves conversation longevity.
3100- Fixed a bug where duplicate `control_response` messages (e.g. from WebSocket reconnects) could cause API 400 errors by pushing duplicate assistant messages into the conversation.
3101- Added `CLAUDE_CODE_ACCOUNT_UUID`, `CLAUDE_CODE_USER_EMAIL`, and `CLAUDE_CODE_ORGANIZATION_UUID` environment variables for SDK callers to provide account info synchronously, eliminating a race condition where early telemetry events lacked account metadata.
3102- Fixed slash command autocomplete crashing when a plugin's SKILL.md description is a YAML array or other non-string type
3103- The `/model` picker now shows human-readable labels (e.g., "Sonnet 4.5") instead of raw model IDs for pinned model versions, with an upgrade hint when a newer version is available.
3104- Managed settings can now be set via macOS plist or Windows Registry. Learn more at https://code.claude.com/docs/en/settings#settings-files
3105
3106## 2.1.50
3107
3108- Added support for `startupTimeout` configuration for LSP servers
3109- Added `WorktreeCreate` and `WorktreeRemove` hook events, enabling custom VCS setup and teardown when agent worktree isolation creates or removes worktrees.
3110- Fixed a bug where resumed sessions could be invisible when the working directory involved symlinks, because the session storage path was resolved at different times during startup. Also fixed session data loss on SSH disconnect by flushing session data before hooks and analytics in the graceful shutdown sequence.
3111- Linux: Fixed native modules not loading on systems with glibc older than 2.30 (e.g., RHEL 8)
3112- Fixed memory leak in agent teams where completed teammate tasks were never garbage collected from session state
3113- Fixed `CLAUDE_CODE_SIMPLE` to fully strip down skills, session memory, custom agents, and CLAUDE.md token counting
3114- Fixed `/mcp reconnect` freezing the CLI when given a server name that doesn't exist
3115- Fixed memory leak where completed task state objects were never removed from AppState
3116- Added support for `isolation: worktree` in agent definitions, allowing agents to declaratively run in isolated git worktrees.
3117- `CLAUDE_CODE_SIMPLE` mode now also disables MCP tools, attachments, hooks, and CLAUDE.md file loading for a fully minimal experience.
3118- Fixed bug where MCP tools were not discovered when tool search is enabled and a prompt is passed in as a launch argument
3119- Improved memory usage during long sessions by clearing internal caches after compaction
3120- Added `claude agents` CLI command to list all configured agents
3121- Improved memory usage during long sessions by clearing large tool results after they have been processed
3122- Fixed a memory leak where LSP diagnostic data was never cleaned up after delivery, causing unbounded memory growth in long sessions
3123- Fixed a memory leak where completed task output was not freed from memory, reducing memory usage in long sessions with many tasks
3124- Improved startup performance for headless mode (`-p` flag) by deferring Yoga WASM and UI component imports
3125- Fixed prompt suggestion cache regression that reduced cache hit rates
3126- Fixed unbounded memory growth in long sessions by capping file history snapshots
3127- Added `CLAUDE_CODE_DISABLE_1M_CONTEXT` environment variable to disable 1M context window support
3128- Opus 4.6 (fast mode) now includes the full 1M context window
3129- VSCode: Added `/extra-usage` command support in VS Code sessions
3130- Fixed memory leak where TaskOutput retained recent lines after cleanup
3131- Fixed memory leak in CircularBuffer where cleared items were retained in the backing array
3132- Fixed memory leak in shell command execution where ChildProcess and AbortController references were retained after cleanup
3133
3134## 2.1.49
3135
3136- Improved MCP OAuth authentication with step-up auth support and discovery caching, reducing redundant network requests during server connections
3137- Added `--worktree` (`-w`) flag to start Claude in an isolated git worktree
3138- Subagents support `isolation: "worktree"` for working in a temporary git worktree
3139- Added Ctrl+F keybinding to kill background agents (two-press confirmation)
3140- Agent definitions support `background: true` to always run as a background task
3141- Plugins can ship `settings.json` for default configuration
3142- Fixed file-not-found errors to suggest corrected paths when the model drops the repo folder
3143- Fixed Ctrl+C and ESC being silently ignored when background agents are running and the main thread is idle. Pressing twice within 3 seconds now kills all background agents.
3144- Fixed prompt suggestion cache regression that reduced cache hit rates.
3145- Fixed `plugin enable` and `plugin disable` to auto-detect the correct scope when `--scope` is not specified, instead of always defaulting to user scope
3146- Simple mode (`CLAUDE_CODE_SIMPLE`) now includes the file edit tool in addition to the Bash tool, allowing direct file editing in simple mode.
3147- Permission suggestions are now populated when safety checks trigger an ask response, enabling SDK consumers to display permission options
3148- Sonnet 4.5 with 1M context is being removed from the Max plan in favor of our frontier Sonnet 4.6 model, which now has 1M context. Please switch in /model.
3149- Fixed verbose mode not updating thinking block display when toggled via `/config` — memo comparators now correctly detect verbose changes
3150- Fixed unbounded WASM memory growth during long sessions by periodically resetting the tree-sitter parser
3151- Fixed potential rendering issues caused by stale yoga layout references
3152- Improved performance in non-interactive mode (`-p`) by skipping unnecessary API calls during startup
3153- Improved performance by caching authentication failures for HTTP and SSE MCP servers, avoiding repeated connection attempts to servers requiring auth
3154- Fixed unbounded memory growth during long-running sessions caused by Yoga WASM linear memory never shrinking
3155- SDK model info now includes `supportsEffort`, `supportedEffortLevels`, and `supportsAdaptiveThinking` fields so consumers can discover model capabilities.
3156- Added `ConfigChange` hook event that fires when configuration files change during a session, enabling enterprise security auditing and optional blocking of settings changes.
3157- Improved startup performance by caching MCP auth failures to avoid redundant connection attempts
3158- Improved startup performance by reducing HTTP calls for analytics token counting
3159- Improved startup performance by batching MCP tool token counting into a single API call
3160- Fixed `disableAllHooks` setting to respect managed settings hierarchy — non-managed settings can no longer disable managed hooks set by policy (#26637)
3161- Fixed `--resume` session picker showing raw XML tags for sessions that start with commands like `/clear`. Now correctly falls through to the session ID fallback.
3162- Improved permission prompts for path safety and working directory blocks to show the reason for the restriction instead of a bare prompt with no context
3163
3164## 2.1.47
3165
3166- Fixed FileWriteTool line counting to preserve intentional trailing blank lines instead of stripping them with `trimEnd()`.
3167- Fixed Windows terminal rendering bugs caused by `os.EOL` (`\r\n`) in display code — line counts now show correct values instead of always showing 1 on Windows.
3168- Improved VS Code plan preview: auto-updates as Claude iterates, enables commenting only when the plan is ready for review, and keeps the preview open when rejecting so Claude can revise.
3169- Fixed a bug where bold and colored text in markdown output could shift to the wrong characters on Windows due to `\r\n` line endings.
3170- Fixed compaction failing when conversation contains many PDF documents by stripping document blocks alongside images before sending to the compaction API (anthropics/claude-code#26188)
3171- Improved memory usage in long-running sessions by releasing API stream buffers, agent context, and skill state after use
3172- Improved startup performance by deferring SessionStart hook execution, reducing time-to-interactive by ~500ms.
3173- Fixed an issue where bash tool output was silently discarded on Windows when using MSYS2 or Cygwin shells.
3174- Improved performance of `@` file mentions - file suggestions now appear faster by pre-warming the index on startup and using session-based caching with background refresh.
3175- Improved memory usage by trimming agent task message history after tasks complete
3176- Improved memory usage during long agent sessions by eliminating O(n²) message accumulation in progress updates
3177- Fixed the bash permission classifier to validate that returned match descriptions correspond to actual input rules, preventing hallucinated descriptions from incorrectly granting permissions
3178- Fixed user-defined agents only loading one file on NFS/FUSE filesystems that report zero inodes (anthropics/claude-code#26044)
3179- Fixed plugin agent skills silently failing to load when referenced by bare name instead of fully-qualified plugin name (anthropics/claude-code#25834)
3180- Search patterns in collapsed tool results are now displayed in quotes for clarity
3181- Windows: Fixed CWD tracking temp files never being cleaned up, causing them to accumulate indefinitely (anthropics/claude-code#17600)
3182- Use `ctrl+f` to kill all background agents instead of double-pressing ESC. Background agents now continue running when you press ESC to cancel the main thread, giving you more control over agent lifecycle.
3183- Fixed API 400 errors ("thinking blocks cannot be modified") that occurred in sessions with concurrent agents, caused by interleaved streaming content blocks preventing proper message merging.
3184- Simplified teammate navigation to use only Shift+Down (with wrapping) instead of both Shift+Up and Shift+Down.
3185- Fixed an issue where a single file write/edit error would abort all other parallel file write/edit operations. Independent file mutations now complete even when a sibling fails.
3186- Added `last_assistant_message` field to Stop and SubagentStop hook inputs, providing the final assistant response text so hooks can access it without parsing transcript files.
3187- Fixed custom session titles set via `/rename` being lost after resuming a conversation (anthropics/claude-code#23610)
3188- Fixed collapsed read/search hint text overflowing on narrow terminals by truncating from the start.
3189- Fixed an issue where bash commands with backslash-newline continuation lines (e.g., long commands split across multiple lines with `\`) would produce spurious empty arguments, potentially breaking command execution.
3190- Fixed built-in slash commands (`/help`, `/model`, `/compact`, etc.) being hidden from the autocomplete dropdown when many user skills are installed (anthropics/claude-code#22020)
3191- Fixed MCP servers not appearing in the MCP Management Dialog after deferred loading
3192- Fixed session name persisting in status bar after `/clear` command (anthropics/claude-code#26082)
3193- Fixed crash when a skill's `name` or `description` in SKILL.md frontmatter is a bare number (e.g., `name: 3000`) — the value is now properly coerced to a string (anthropics/claude-code#25837)
3194- Fixed /resume silently dropping sessions when the first message exceeds 16KB or uses array-format content (anthropics/claude-code#25721)
3195- Added `chat:newline` keybinding action for configurable multi-line input (anthropics/claude-code#26075)
3196- Added `added_dirs` to the statusline JSON `workspace` section, exposing directories added via `/add-dir` to external scripts (anthropics/claude-code#26096)
3197- Fixed `claude doctor` misclassifying mise and asdf-managed installations as native installs (anthropics/claude-code#26033)
3198- Fixed zsh heredoc failing with "read-only file system" error in sandboxed commands (anthropics/claude-code#25990)
3199- Fixed agent progress indicator showing inflated tool use count (anthropics/claude-code#26023)
3200- Fixed image pasting not working on WSL2 systems where Windows copies images as BMP format (anthropics/claude-code#25935)
3201- Fixed background agent results returning raw transcript data instead of the agent's final answer (anthropics/claude-code#26012)
3202- Fixed Warp terminal incorrectly prompting for Shift+Enter setup when it supports it natively (anthropics/claude-code#25957)
3203- Fixed CJK wide characters causing misaligned timestamps and layout elements in the TUI (anthropics/claude-code#26084)
3204- Fixed custom agent `model` field in `.claude/agents/*.md` being ignored when spawning team teammates (anthropics/claude-code#26064)
3205- Fixed plan mode being lost after context compaction, causing the model to switch from planning to implementation mode (anthropics/claude-code#26061)
3206- Fixed `alwaysThinkingEnabled: true` in settings.json not enabling thinking mode on Bedrock and Vertex providers (anthropics/claude-code#26074)
3207- Fixed `tool_decision` OTel telemetry event not being emitted in headless/SDK mode (anthropics/claude-code#26059)
3208- Fixed session name being lost after context compaction — renamed sessions now preserve their custom title through compaction (anthropics/claude-code#26121)
3209- Increased initial session count in resume picker from 10 to 50 for faster session discovery (anthropics/claude-code#26123)
3210- Windows: fixed worktree session matching when drive letter casing differs (anthropics/claude-code#26123)
3211- Fixed `/resume <session-id>` failing to find sessions whose first message exceeds 16KB (anthropics/claude-code#25920)
3212- Fixed "Always allow" on multiline bash commands creating invalid permission patterns that corrupt settings (anthropics/claude-code#25909)
3213- Fixed React crash (error #31) when a skill's `argument-hint` in SKILL.md frontmatter uses YAML sequence syntax (e.g., `[topic: foo | bar]`) — the value is now properly coerced to a string (anthropics/claude-code#25826)
3214- Fixed crash when using `/fork` on sessions that used web search — null entries in search results from transcript deserialization are now handled gracefully (anthropics/claude-code#25811)
3215- Fixed read-only git commands triggering FSEvents file watcher loops on macOS by adding --no-optional-locks flag (anthropics/claude-code#25750)
3216- Fixed custom agents and skills not being discovered when running from a git worktree — project-level `.claude/agents/` and `.claude/skills/` from the main repository are now included (anthropics/claude-code#25816)
3217- Fixed non-interactive subcommands like `claude doctor` and `claude plugin validate` being blocked inside nested Claude sessions (anthropics/claude-code#25803)
3218- Windows: Fixed the same CLAUDE.md file being loaded twice when drive letter casing differs between paths (anthropics/claude-code#25756)
3219- Fixed inline code spans in markdown being incorrectly parsed as bash commands (anthropics/claude-code#25792)
3220- Fixed teammate spinners not respecting custom spinnerVerbs from settings (anthropics/claude-code#25748)
3221- Fixed shell commands permanently failing after a command deletes its own working directory (anthropics/claude-code#26136)
3222- Fixed hooks (PreToolUse, PostToolUse) silently failing to execute on Windows by using Git Bash instead of cmd.exe (anthropics/claude-code#25981)
3223- Fixed LSP `findReferences` and other location-based operations returning results from gitignored files (e.g., `node_modules/`, `venv/`) (anthropics/claude-code#26051)
3224- Moved config backup files from home directory root to `~/.claude/backups/` to reduce home directory clutter (anthropics/claude-code#26130)
3225- Fixed sessions with large first prompts (>16KB) disappearing from the /resume list (anthropics/claude-code#26140)
3226- Fixed shell functions with double-underscore prefixes (e.g., `__git_ps1`) not being preserved across shell sessions (anthropics/claude-code#25824)
3227- Fixed spinner showing "0 tokens" counter before any tokens have been received (anthropics/claude-code#26105)
3228- VSCode: Fixed conversation messages appearing dimmed while the AskUserQuestion dialog is open (anthropics/claude-code#26078)
3229- Fixed background tasks failing in git worktrees due to remote URL resolution reading from worktree-specific gitdir instead of the main repository config (anthropics/claude-code#26065)
3230- Fixed Right Alt key leaving visible `[25~` escape sequence residue in the input field on Windows/Git Bash terminals (anthropics/claude-code#25943)
3231- The `/rename` command now updates the terminal tab title by default (anthropics/claude-code#25789)
3232- Fixed Edit tool silently corrupting Unicode curly quotes (\u201c\u201d \u2018\u2019) by replacing them with straight quotes when making edits (anthropics/claude-code#26141)
3233- Fixed OSC 8 hyperlinks only being clickable on the first line when link text wraps across multiple terminal lines.
3234
3235## 2.1.46
3236
3237- Fixed orphaned CC processes after terminal disconnect on macOS
3238- Added support for using claude.ai MCP connectors in Claude Code
3239
3240## 2.1.45
3241
3242- Added support for Claude Sonnet 4.6
3243- Added support for reading `enabledPlugins` and `extraKnownMarketplaces` from `--add-dir` directories
3244- Added `spinnerTipsOverride` setting to customize spinner tips — configure `tips` with an array of custom tip strings, and optionally set `excludeDefault: true` to show only your custom tips instead of the built-in ones
3245- Added `SDKRateLimitInfo` and `SDKRateLimitEvent` types to the SDK, enabling consumers to receive rate limit status updates including utilization, reset times, and overage information
3246- Fixed Agent Teams teammates failing on Bedrock, Vertex, and Foundry by propagating API provider environment variables to tmux-spawned processes (anthropics/claude-code#23561)
3247- Fixed sandbox "operation not permitted" errors when writing temporary files on macOS by using the correct per-user temp directory (anthropics/claude-code#21654)
3248- Fixed Task tool (backgrounded agents) crashing with a `ReferenceError` on completion (anthropics/claude-code#22087)
3249- Fixed autocomplete suggestions not being accepted on Enter when images are pasted in the input
3250- Fixed skills invoked by subagents incorrectly appearing in main session context after compaction
3251- Fixed excessive `.claude.json.backup` files accumulating on every startup
3252- Fixed plugin-provided commands, agents, and hooks not being available immediately after installation without requiring a restart
3253- Improved startup performance by removing eager loading of session history for stats caching
3254- Improved memory usage for shell commands that produce large output — RSS no longer grows unboundedly with command output size
3255- Improved collapsed read/search groups to show the current file or search pattern being processed beneath the summary line while active
3256- [VSCode] Improved permission destination choice (project/user/session) to persist across sessions
3257
3258## 2.1.44
3259
3260- Fixed ENAMETOOLONG errors for deeply-nested directory paths
3261- Fixed auth refresh errors
3262
3263## 2.1.43
3264
3265- Fixed AWS auth refresh hanging indefinitely by adding a 3-minute timeout
3266- Fixed spurious warnings for non-agent markdown files in `.claude/agents/` directory
3267- Fixed structured-outputs beta header being sent unconditionally on Vertex/Bedrock
3268
3269## 2.1.42
3270
3271- Improved startup performance by deferring Zod schema construction
3272- Improved prompt cache hit rates by moving date out of system prompt
3273- Added one-time Opus 4.6 effort callout for eligible users
3274- Fixed /resume showing interrupt messages as session titles
3275- Fixed image dimension limit errors to suggest /compact
3276
3277## 2.1.41
3278
3279- Added guard against launching Claude Code inside another Claude Code session
3280- Fixed Agent Teams using wrong model identifier for Bedrock, Vertex, and Foundry customers
3281- Fixed a crash when MCP tools return image content during streaming
3282- Fixed /resume session previews showing raw XML tags instead of readable command names
3283- Improved model error messages for Bedrock/Vertex/Foundry users with fallback suggestions
3284- Fixed plugin browse showing misleading "Space to Toggle" hint for already-installed plugins
3285- Fixed hook blocking errors (exit code 2) not showing stderr to the user
3286- Added `speed` attribute to OTel events and trace spans for fast mode visibility
3287- Added `claude auth login`, `claude auth status`, and `claude auth logout` CLI subcommands
3288- Added Windows ARM64 (win32-arm64) native binary support
3289- Improved `/rename` to auto-generate session name from conversation context when called without arguments
3290- Improved narrow terminal layout for prompt footer
3291- Fixed file resolution failing for @-mentions with anchor fragments (e.g., `@README.md#installation`)
3292- Fixed FileReadTool blocking the process on FIFOs, `/dev/stdin`, and large files
3293- Fixed background task notifications not being delivered in streaming Agent SDK mode
3294- Fixed cursor jumping to end on each keystroke in classifier rule input
3295- Fixed markdown link display text being dropped for raw URL
3296- Fixed auto-compact failure error notifications being shown to users
3297- Fixed permission wait time being included in subagent elapsed time display
3298- Fixed proactive ticks firing while in plan mode
3299- Fixed clear stale permission rules when settings change on disk
3300- Fixed hook blocking errors showing stderr content in UI
3301
3302## 2.1.39
3303
3304- Improved terminal rendering performance
3305- Fixed fatal errors being swallowed instead of displayed
3306- Fixed process hanging after session close
3307- Fixed character loss at terminal screen boundary
3308- Fixed blank lines in verbose transcript view
3309
3310## 2.1.38
3311
3312- Fixed VS Code terminal scroll-to-top regression introduced in 2.1.37
3313- Fixed Tab key queueing slash commands instead of autocompleting
3314- Fixed bash permission matching for commands using environment variable wrappers
3315- Fixed text between tool uses disappearing when not using streaming
3316- Fixed duplicate sessions when resuming in VS Code extension
3317- Improved heredoc delimiter parsing to prevent command smuggling
3318- Blocked writes to `.claude/skills` directory in sandbox mode
3319
3320## 2.1.37
3321
3322- Fixed an issue where /fast was not immediately available after enabling /extra-usage
3323
3324## 2.1.36
3325
3326- Fast mode is now available for Opus 4.6. Learn more at https://code.claude.com/docs/en/fast-mode
3327
3328## 2.1.34
3329
3330- Fixed a crash when agent teams setting changed between renders
3331- Fixed a bug where commands excluded from sandboxing (via `sandbox.excludedCommands` or `dangerouslyDisableSandbox`) could bypass the Bash ask permission rule when `autoAllowBashIfSandboxed` was enabled
3332
3333## 2.1.33
3334
3335- Fixed agent teammate sessions in tmux to send and receive messages
3336- Fixed warnings about agent teams not being available on your current plan
3337- Added `TeammateIdle` and `TaskCompleted` hook events for multi-agent workflows
3338- Added support for restricting which sub-agents can be spawned via `Task(agent_type)` syntax in agent "tools" frontmatter
3339- Added `memory` frontmatter field support for agents, enabling persistent memory with `user`, `project`, or `local` scope
3340- Added plugin name to skill descriptions and `/skills` menu for better discoverability
3341- Fixed an issue where submitting a new message while the model was in extended thinking would interrupt the thinking phase
3342- Fixed an API error that could occur when aborting mid-stream, where whitespace text combined with a thinking block would bypass normalization and produce an invalid request
3343- Fixed API proxy compatibility issue where 404 errors on streaming endpoints no longer triggered non-streaming fallback
3344- Fixed an issue where proxy settings configured via `settings.json` environment variables were not applied to WebFetch and other HTTP requests on the Node.js build
3345- Fixed `/resume` session picker showing raw XML markup instead of clean titles for sessions started with slash commands
3346- Improved error messages for API connection failures — now shows specific cause (e.g., ECONNREFUSED, SSL errors) instead of generic "Connection error"
3347- Errors from invalid managed settings are now surfaced
3348- VSCode: Added support for remote sessions, allowing OAuth users to browse and resume sessions from claude.ai
3349- VSCode: Added git branch and message count to the session picker, with support for searching by branch name
3350- VSCode: Fixed scroll-to-bottom under-scrolling on initial session load and session switch
3351
3352## 2.1.32
3353
3354- Claude Opus 4.6 is now available!
3355- Added research preview agent teams feature for multi-agent collaboration (token-intensive feature, requires setting CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)
3356- Claude now automatically records and recalls memories as it works
3357- Added "Summarize from here" to the message selector, allowing partial conversation summarization.
3358- Skills defined in `.claude/skills/` within additional directories (`--add-dir`) are now loaded automatically.
3359- Fixed `@` file completion showing incorrect relative paths when running from a subdirectory
3360- Updated --resume to re-use --agent value specified in previous conversation by default.
3361- Fixed: Bash tool no longer throws "Bad substitution" errors when heredocs contain JavaScript template literals like `${index + 1}`, which previously interrupted tool execution
3362- Skill character budget now scales with context window (2% of context), so users with larger context windows can see more skill descriptions without truncation
3363- Fixed Thai/Lao spacing vowels (สระ า, ำ) not rendering correctly in the input field
3364- VSCode: Fixed slash commands incorrectly being executed when pressing Enter with preceding text in the input field
3365- VSCode: Added spinner when loading past conversations list
3366
3367## 2.1.31
3368
3369- Added session resume hint on exit, showing how to continue your conversation later
3370- Added support for full-width (zenkaku) space input from Japanese IME in checkbox selection
3371- Fixed PDF too large errors permanently locking up sessions, requiring users to start a new conversation
3372- Fixed bash commands incorrectly reporting failure with "Read-only file system" errors when sandbox mode was enabled
3373- Fixed a crash that made sessions unusable after entering plan mode when project config in `~/.claude.json` was missing default fields
3374- Fixed `temperatureOverride` being silently ignored in the streaming API path, causing all streaming requests to use the default temperature (1) regardless of the configured override
3375- Fixed LSP shutdown/exit compatibility with strict language servers that reject null params
3376- Improved system prompts to more clearly guide the model toward using dedicated tools (Read, Edit, Glob, Grep) instead of bash equivalents (`cat`, `sed`, `grep`, `find`), reducing unnecessary bash command usage
3377- Improved PDF and request size error messages to show actual limits (100 pages, 20MB)
3378- Reduced layout jitter in the terminal when the spinner appears and disappears during streaming
3379- Removed misleading Anthropic API pricing from model selector for third-party provider (Bedrock, Vertex, Foundry) users
3380
3381## 2.1.30
3382
3383- Added `pages` parameter to the Read tool for PDFs, allowing specific page ranges to be read (e.g., `pages: "1-5"`). Large PDFs (>10 pages) now return a lightweight reference when `@` mentioned instead of being inlined into context.
3384- Added pre-configured OAuth client credentials for MCP servers that don't support Dynamic Client Registration (e.g., Slack). Use `--client-id` and `--client-secret` with `claude mcp add`.
3385- Added `/debug` for Claude to help troubleshoot the current session
3386- Added support for additional `git log` and `git show` flags in read-only mode (e.g., `--topo-order`, `--cherry-pick`, `--format`, `--raw`)
3387- Added token count, tool uses, and duration metrics to Task tool results
3388- Added reduced motion mode to the config
3389- Fixed phantom "(no content)" text blocks appearing in API conversation history, reducing token waste and potential model confusion
3390- Fixed prompt cache not correctly invalidating when tool descriptions or input schemas changed, only when tool names changed
3391- Fixed 400 errors that could occur after running `/login` when the conversation contained thinking blocks
3392- Fixed a hang when resuming sessions with corrupted transcript files containing `parentUuid` cycles
3393- Fixed rate limit message showing incorrect "/upgrade" suggestion for Max 20x users when extra-usage is unavailable
3394- Fixed permission dialogs stealing focus while actively typing
3395- Fixed subagents not being able to access SDK-provided MCP tools because they were not synced to the shared application state
3396- Fixed a regression where Windows users with a `.bashrc` file could not run bash commands
3397- Improved memory usage for `--resume` (68% reduction for users with many sessions) by replacing the session index with lightweight stat-based loading and progressive enrichment
3398- Improved `TaskStop` tool to display the stopped command/task description in the result line instead of a generic "Task stopped" message
3399- Changed `/model` to execute immediately instead of being queued
3400- [VSCode] Added multiline input support to the "Other" text input in question dialogs (use Shift+Enter for new lines)
3401- [VSCode] Fixed duplicate sessions appearing in the session list when starting a new conversation
3402
3403## 2.1.29
3404
3405- Fixed startup performance issues when resuming sessions that have `saved_hook_context`
3406
3407## 2.1.27
3408
3409- Added tool call failures and denials to debug logs
3410- Fixed context management validation error for gateway users, ensuring `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` avoids the error
3411- Added `--from-pr` flag to resume sessions linked to a specific GitHub PR number or URL
3412- Sessions are now automatically linked to PRs when created via `gh pr create`
3413- Fixed /context command not displaying colored output
3414- Fixed status bar duplicating background task indicator when PR status was shown
3415- Windows: Fixed bash command execution failing for users with `.bashrc` files
3416- Windows: Fixed console windows flashing when spawning child processes
3417- VSCode: Fixed OAuth token expiration causing 401 errors after extended sessions
3418
3419## 2.1.25
3420
3421- Fixed beta header validation error for gateway users on Bedrock and Vertex, ensuring `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` avoids the error
3422
3423## 2.1.23
3424
3425- Added customizable spinner verbs setting (`spinnerVerbs`)
3426- Fixed mTLS and proxy connectivity for users behind corporate proxies or using client certificates
3427- Fixed per-user temp directory isolation to prevent permission conflicts on shared systems
3428- Fixed a race condition that could cause 400 errors when prompt caching scope was enabled
3429- Fixed pending async hooks not being cancelled when headless streaming sessions ended
3430- Fixed tab completion not updating the input field when accepting a suggestion
3431- Fixed ripgrep search timeouts silently returning empty results instead of reporting errors
3432- Improved terminal rendering performance with optimized screen data layout
3433- Changed Bash commands to show timeout duration alongside elapsed time
3434- Changed merged pull requests to show a purple status indicator in the prompt footer
3435- [IDE] Fixed model options displaying incorrect region strings for Bedrock users in headless mode
3436
3437## 2.1.22
3438
3439- Fixed structured outputs for non-interactive (-p) mode
3440
3441## 2.1.21
3442
3443- Added support for full-width (zenkaku) number input from Japanese IME in option selection prompts
3444- Fixed shell completion cache files being truncated on exit
3445- Fixed API errors when resuming sessions that were interrupted during tool execution
3446- Fixed auto-compact triggering too early on models with large output token limits
3447- Fixed task IDs potentially being reused after deletion
3448- Fixed file search not working in VS Code extension on Windows
3449- Improved read/search progress indicators to show "Reading…" while in progress and "Read" when complete
3450- Improved Claude to prefer file operation tools (Read, Edit, Write) over bash equivalents (cat, sed, awk)
3451- [VSCode] Added automatic Python virtual environment activation, ensuring `python` and `pip` commands use the correct interpreter (configurable via `claudeCode.usePythonEnvironment` setting)
3452- [VSCode] Fixed message action buttons having incorrect background colors
3453
3454## 2.1.20
3455
3456- Added arrow key history navigation in vim normal mode when cursor cannot move further
3457- Added external editor shortcut (Ctrl+G) to the help menu for better discoverability
3458- Added 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
3459- Added support for loading `CLAUDE.md` files from additional directories specified via `--add-dir` flag (requires setting `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1`)
3460- Added ability to delete tasks via the `TaskUpdate` tool
3461- Fixed session compaction issues that could cause resume to load full history instead of the compact summary
3462- Fixed agents sometimes ignoring user messages sent while actively working on a task
3463- Fixed wide character (emoji, CJK) rendering artifacts where trailing columns were not cleared when replaced by narrower characters
3464- Fixed JSON parsing errors when MCP tool responses contain special Unicode characters
3465- Fixed up/down arrow keys in multi-line and wrapped text input to prioritize cursor movement over history navigation
3466- Fixed draft prompt being lost when pressing UP arrow to navigate command history
3467- Fixed ghost text flickering when typing slash commands mid-input
3468- Fixed marketplace source removal not properly deleting settings
3469- Fixed duplicate output in some commands like `/context`
3470- Fixed task list sometimes showing outside the main conversation view
3471- Fixed syntax highlighting for diffs occurring within multiline constructs like Python docstrings
3472- Fixed crashes when cancelling tool use
3473- Improved `/sandbox` command UI to show dependency status with installation instructions when dependencies are missing
3474- Improved thinking status text with a subtle shimmer animation
3475- Improved task list to dynamically adjust visible items based on terminal height
3476- Improved fork conversation hint to show how to resume the original session
3477- Changed collapsed read/search groups to show present tense ("Reading", "Searching for") while in progress, and past tense ("Read", "Searched for") when complete
3478- Changed `ToolSearch` results to appear as a brief notification instead of inline in the conversation
3479- Changed the `/commit-push-pr` skill to automatically post PR URLs to Slack channels when configured via MCP tools
3480- Changed the `/copy` command to be available to all users
3481- Changed background agents to prompt for tool permissions before launching
3482- Changed permission rules like `Bash(*)` to be accepted and treated as equivalent to `Bash`
3483- Changed config backups to be timestamped and rotated (keeping 5 most recent) to prevent data loss
3484
3485## 2.1.19
3486
3487- Added env var `CLAUDE_CODE_ENABLE_TASKS`, set to `false` to keep the old system temporarily
3488- Added shorthand `$0`, `$1`, etc. for accessing individual arguments in custom commands
3489- Fixed crashes on processors without AVX instruction support
3490- Fixed dangling Claude Code processes when terminal is closed by catching EIO errors from `process.exit()` and using SIGKILL as fallback
3491- Fixed `/rename` and `/tag` not updating the correct session when resuming from a different directory (e.g., git worktrees)
3492- Fixed resuming sessions by custom title not working when run from a different directory
3493- Fixed pasted text content being lost when using prompt stash (Ctrl+S) and restore
3494- Fixed agent list displaying "Sonnet (default)" instead of "Inherit (default)" for agents without an explicit model setting
3495- Fixed backgrounded hook commands not returning early, potentially causing the session to wait on a process that was intentionally backgrounded
3496- Fixed file write preview omitting empty lines
3497- Changed skills without additional permissions or hooks to be allowed without requiring approval
3498- Changed indexed argument syntax from `$ARGUMENTS.0` to `$ARGUMENTS[0]` (bracket syntax)
3499- [SDK] Added replay of `queued_command` attachment messages as `SDKUserMessageReplay` events when `replayUserMessages` is enabled
3500- [VSCode] Enabled session forking and rewind functionality for all users
3501
3502## 2.1.18
3503
3504- Added customizable keyboard shortcuts. Configure keybindings per context, create chord sequences, and personalize your workflow. Run `/keybindings` to get started. Learn more at https://code.claude.com/docs/en/keybindings
3505
3506## 2.1.17
3507
3508- Fixed crashes on processors without AVX instruction support
3509
3510## 2.1.16
3511
3512- Added new task management system, including new capabilities like dependency tracking
3513- [VSCode] Added native plugin management support
3514- [VSCode] Added ability for OAuth users to browse and resume remote Claude sessions from the Sessions dialog
3515- Fixed out-of-memory crashes when resuming sessions with heavy subagent usage
3516- Fixed an issue where the "context remaining" warning was not hidden after running `/compact`
3517- Fixed session titles on the resume screen not respecting the user's language setting
3518- [IDE] Fixed a race condition on Windows where the Claude Code sidebar view container would not appear on start
3519
3520## 2.1.15
3521
3522- Added deprecation notification for npm installations - run `claude install` or see https://code.claude.com/docs/en/setup for more options
3523- Improved UI rendering performance with React Compiler
3524- Fixed the "Context left until auto-compact" warning not disappearing after running `/compact`
3525- Fixed MCP stdio server timeout not killing child process, which could cause UI freezes
3526
3527## 2.1.14
3528
3529- Added history-based autocomplete in bash mode (`!`) - type a partial command and press Tab to complete from your bash command history
3530- Added search to installed plugins list - type to filter by name or description
3531- Added support for pinning plugins to specific git commit SHAs, allowing marketplace entries to install exact versions
3532- Fixed a regression where the context window blocking limit was calculated too aggressively, blocking users at ~65% context usage instead of the intended ~98%
3533- Fixed memory issues that could cause crashes when running parallel subagents
3534- Fixed memory leak in long-running sessions where stream resources were not cleaned up after shell commands completed
3535- Fixed `@` symbol incorrectly triggering file autocomplete suggestions in bash mode
3536- Fixed `@`-mention menu folder click behavior to navigate into directories instead of selecting them
3537- Fixed `/feedback` command generating invalid GitHub issue URLs when description is very long
3538- Fixed `/context` command to show the same token count and percentage as the status line in verbose mode
3539- Fixed an issue where `/config`, `/context`, `/model`, and `/todos` command overlays could close unexpectedly
3540- Fixed slash command autocomplete selecting wrong command when typing similar commands (e.g., `/context` vs `/compact`)
3541- Fixed inconsistent back navigation in plugin marketplace when only one marketplace is configured
3542- Fixed iTerm2 progress bar not clearing properly on exit, preventing lingering indicators and bell sounds
3543- Improved backspace to delete pasted text as a single token instead of one character at a time
3544- [VSCode] Added `/usage` command to display current plan usage
3545
3546## 2.1.12
3547
3548- Fixed message rendering bug
3549
3550## 2.1.11
3551
3552- Fixed excessive MCP connection requests for HTTP/SSE transports
3553
3554## 2.1.10
3555
3556- Added new `Setup` hook event that can be triggered via `--init`, `--init-only`, or `--maintenance` CLI flags for repository setup and maintenance operations
3557- Added keyboard shortcut 'c' to copy OAuth URL when browser doesn't open automatically during login
3558- Fixed a crash when running bash commands containing heredocs with JavaScript template literals like `${index + 1}`
3559- Improved startup to capture keystrokes typed before the REPL is fully ready
3560- Improved file suggestions to show as removable attachments instead of inserting text when accepted
3561- [VSCode] Added install count display to plugin listings
3562- [VSCode] Added trust warning when installing plugins
3563
3564## 2.1.9
3565
3566- Added `auto:N` syntax for configuring the MCP tool search auto-enable threshold, where N is the context window percentage (0-100)
3567- Added `plansDirectory` setting to customize where plan files are stored
3568- Added external editor support (Ctrl+G) in AskUserQuestion "Other" input field
3569- Added session URL attribution to commits and PRs created from web sessions
3570- Added support for `PreToolUse` hooks to return `additionalContext` to the model
3571- Added `${CLAUDE_SESSION_ID}` string substitution for skills to access the current session ID
3572- Fixed long sessions with parallel tool calls failing with an API error about orphan tool_result blocks
3573- Fixed MCP server reconnection hanging when cached connection promise never resolves
3574- Fixed Ctrl+Z suspend not working in terminals using Kitty keyboard protocol (Ghostty, iTerm2, kitty, WezTerm)
3575
3576## 2.1.7
3577
3578- Added `showTurnDuration` setting to hide turn duration messages (e.g., "Cooked for 1m 6s")
3579- Added ability to provide feedback when accepting permission prompts
3580- Added inline display of agent's final response in task notifications, making it easier to see results without reading the full transcript file
3581- Fixed security vulnerability where wildcard permission rules could match compound commands containing shell operators
3582- Fixed false "file modified" errors on Windows when cloud sync tools, antivirus scanners, or Git touch file timestamps without changing content
3583- Fixed orphaned tool_result errors when sibling tools fail during streaming execution
3584- Fixed context window blocking limit being calculated using the full context window instead of the effective context window (which reserves space for max output tokens)
3585- Fixed spinner briefly flashing when running local slash commands like `/model` or `/theme`
3586- Fixed terminal title animation jitter by using fixed-width braille characters
3587- Fixed plugins with git submodules not being fully initialized when installed
3588- Fixed bash commands failing on Windows when temp directory paths contained characters like `t` or `n` that were misinterpreted as escape sequences
3589- Improved typing responsiveness by reducing memory allocation overhead in terminal rendering
3590- Enabled MCP tool search auto mode by default for all users. When MCP tool descriptions exceed 10% of the context window, they are automatically deferred and discovered via the MCPSearch tool instead of being loaded upfront. This reduces context usage for users with many MCP tools configured. Users can disable this by adding `MCPSearch` to `disallowedTools` in their settings.
3591- Changed OAuth and API Console URLs from console.anthropic.com to platform.claude.com
3592- [VSCode] Fixed `claudeProcessWrapper` setting passing the wrapper path instead of the Claude binary path
3593
3594## 2.1.6
3595
3596- Added search functionality to `/config` command for quickly filtering settings
3597- Added Updates section to `/doctor` showing auto-update channel and available npm versions (stable/latest)
3598- Added date range filtering to `/stats` command - press `r` to cycle between Last 7 days, Last 30 days, and All time
3599- Added automatic discovery of skills from nested `.claude/skills` directories when working with files in subdirectories
3600- Added `context_window.used_percentage` and `context_window.remaining_percentage` fields to status line input for easier context window display
3601- Added an error display when the editor fails during Ctrl+G
3602- Fixed permission bypass via shell line continuation that could allow blocked commands to execute
3603- Fixed false "File has been unexpectedly modified" errors when file watchers touch files without changing content
3604- Fixed text styling (bold, colors) getting progressively misaligned in multi-line responses
3605- Fixed the feedback panel closing unexpectedly when typing 'n' in the description field
3606- Fixed rate limit warning appearing at low usage after weekly reset (now requires 70% usage)
3607- Fixed rate limit options menu incorrectly auto-opening when resuming a previous session
3608- Fixed numpad keys outputting escape sequences instead of characters in Kitty keyboard protocol terminals
3609- Fixed Option+Return not inserting newlines in Kitty keyboard protocol terminals
3610- Fixed corrupted config backup files accumulating in the home directory (now only one backup is created per config file)
3611- Fixed `mcp list` and `mcp get` commands leaving orphaned MCP server processes
3612- Fixed visual artifacts in ink2 mode when nodes become hidden via `display:none`
3613- Improved the external CLAUDE.md imports approval dialog to show which files are being imported and from where
3614- Improved the `/tasks` dialog to go directly to task details when there's only one background task running
3615- Improved @ autocomplete with icons for different suggestion types and single-line formatting
3616- Updated "Help improve Claude" setting fetch to refresh OAuth and retry when it fails due to a stale OAuth token
3617- Changed task notification display to cap at 3 lines with overflow summary when multiple background tasks complete simultaneously
3618- Changed terminal title to "Claude Code" on startup for better window identification
3619- Removed ability to @-mention MCP servers to enable/disable - use `/mcp enable <name>` instead
3620- [VSCode] Fixed usage indicator not updating after manual compact
3621
3622## 2.1.5
3623
3624- Added `CLAUDE_CODE_TMPDIR` environment variable to override the temp directory used for internal temp files, useful for environments with custom temp directory requirements
3625
3626## 2.1.4
3627
3628- Added `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` environment variable to disable all background task functionality including auto-backgrounding and the Ctrl+B shortcut
3629- Fixed "Help improve Claude" setting fetch to refresh OAuth and retry when it fails due to a stale OAuth token
3630
3631## 2.1.3
3632
3633- Merged slash commands and skills, simplifying the mental model with no change in behavior
3634- Added release channel (`stable` or `latest`) toggle to `/config`
3635- Added detection and warnings for unreachable permission rules, with warnings in `/doctor` and after saving rules that include the source of each rule and actionable fix guidance
3636- Fixed plan files persisting across `/clear` commands, now ensuring a fresh plan file is used after clearing a conversation
3637- Fixed false skill duplicate detection on filesystems with large inodes (e.g., ExFAT) by using 64-bit precision for inode values
3638- Fixed mismatch between background task count in status bar and items shown in tasks dialog
3639- Fixed sub-agents using the wrong model during conversation compaction
3640- Fixed web search in sub-agents using incorrect model
3641- Fixed trust dialog acceptance when running from the home directory not enabling trust-requiring features like hooks during the session
3642- Improved terminal rendering stability by preventing uncontrolled writes from corrupting cursor state
3643- Improved slash command suggestion readability by truncating long descriptions to 2 lines
3644- Changed tool hook execution timeout from 60 seconds to 10 minutes
3645- [VSCode] Added clickable destination selector for permission requests, allowing you to choose where settings are saved (this project, all projects, shared with team, or session only)
3646
3647## 2.1.2
3648
3649- Added source path metadata to images dragged onto the terminal, helping Claude understand where images originated
3650- Added clickable hyperlinks for file paths in tool output in terminals that support OSC 8 (like iTerm)
3651- Added support for Windows Package Manager (winget) installations with automatic detection and update instructions
3652- Added Shift+Tab keyboard shortcut in plan mode to quickly select "auto-accept edits" option
3653- Added `FORCE_AUTOUPDATE_PLUGINS` environment variable to allow plugin autoupdate even when the main auto-updater is disabled
3654- Added `agent_type` to SessionStart hook input, populated if `--agent` is specified
3655- Fixed a command injection vulnerability in bash command processing where malformed input could execute arbitrary commands
3656- Fixed a memory leak where tree-sitter parse trees were not being freed, causing WASM memory to grow unbounded over long sessions
3657- Fixed binary files (images, PDFs, etc.) being accidentally included in memory when using `@include` directives in CLAUDE.md files
3658- Fixed updates incorrectly claiming another installation is in progress
3659- Fixed crash when socket files exist in watched directories (defense-in-depth for EOPNOTSUPP errors)
3660- Fixed remote session URL and teleport being broken when using `/tasks` command
3661- Fixed MCP tool names being exposed in analytics events by sanitizing user-specific server configurations
3662- Improved Option-as-Meta hint on macOS to show terminal-specific instructions for native CSIu terminals like iTerm2, Kitty, and WezTerm
3663- Improved error message when pasting images over SSH to suggest using `scp` instead of the unhelpful clipboard shortcut hint
3664- Improved permission explainer to not flag routine dev workflows (git fetch/rebase, npm install, tests, PRs) as medium risk
3665- Changed large bash command outputs to be saved to disk instead of truncated, allowing Claude to read the full content
3666- Changed large tool outputs to be persisted to disk instead of truncated, providing full output access via file references
3667- Changed `/plugins` installed tab to unify plugins and MCPs with scope-based grouping
3668- Deprecated Windows managed settings path `C:\ProgramData\ClaudeCode\managed-settings.json` - administrators should migrate to `C:\Program Files\ClaudeCode\managed-settings.json`
3669- [SDK] Changed minimum zod peer dependency to ^4.0.0
3670- [VSCode] Fixed usage display not updating after manual compact
3671
3672## 2.1.0
3673
3674- Added automatic skill hot-reload - skills created or modified in `~/.claude/skills` or `.claude/skills` are now immediately available without restarting the session
3675- Added support for running skills and slash commands in a forked sub-agent context using `context: fork` in skill frontmatter
3676- Added support for `agent` field in skills to specify agent type for execution
3677- Added `language` setting to configure Claude's response language (e.g., language: "japanese")
3678- Changed Shift+Enter to work out of the box in iTerm2, WezTerm, Ghostty, and Kitty without modifying terminal configs
3679- Added `respectGitignore` support in `settings.json` for per-project control over @-mention file picker behavior
3680- Added `IS_DEMO` environment variable to hide email and organization from the UI, useful for streaming or recording sessions
3681- Fixed security issue where sensitive data (OAuth tokens, API keys, passwords) could be exposed in debug logs
3682- Fixed files and skills not being properly discovered when resuming sessions with `-c` or `--resume`
3683- Fixed pasted content being lost when replaying prompts from history using up arrow or Ctrl+R search
3684- Fixed Esc key with queued prompts to only move them to input without canceling the running task
3685- Reduced permission prompts for complex bash commands
3686- Fixed command search to prioritize exact and prefix matches on command names over fuzzy matches in descriptions
3687- Fixed PreToolUse hooks to allow `updatedInput` when returning `ask` permission decision, enabling hooks to act as middleware while still requesting user consent
3688- Fixed plugin path resolution for file-based marketplace sources
3689- Fixed LSP tool being incorrectly enabled when no LSP servers were configured
3690- Fixed background tasks failing with "git repository not found" error for repositories with dots in their names
3691- Fixed Claude in Chrome support for WSL environments
3692- Fixed Windows native installer silently failing when executable creation fails
3693- Improved CLI help output to display options and subcommands in alphabetical order for easier navigation
3694- Added wildcard pattern matching for Bash tool permissions using `*` at any position in rules (e.g., `Bash(npm *)`, `Bash(* install)`, `Bash(git * main)`)
3695- Added unified Ctrl+B backgrounding for both bash commands and agents - pressing Ctrl+B now backgrounds all running foreground tasks simultaneously
3696- Added support for MCP `list_changed` notifications, allowing MCP servers to dynamically update their available tools, prompts, and resources without requiring reconnection
3697- Added `/teleport` and `/remote-env` slash commands for claude.ai subscribers, allowing them to resume and configure remote sessions
3698- Added support for disabling specific agents using `Task(AgentName)` syntax in settings.json permissions or the `--disallowedTools` CLI flag
3699- Added hooks support to agent frontmatter, allowing agents to define PreToolUse, PostToolUse, and Stop hooks scoped to the agent's lifecycle
3700- Added hooks support for skill and slash command frontmatter
3701- Added new Vim motions: `;` and `,` to repeat f/F/t/T motions, `y` operator for yank with `yy`/`Y`, `p`/`P` for paste, text objects (`iw`, `aw`, `iW`, `aW`, `i"`, `a"`, `i'`, `a'`, `i(`, `a(`, `i[`, `a[`, `i{`, `a{`), `>>` and `<<` for indent/dedent, and `J` to join lines
3702- Added `/plan` command shortcut to enable plan mode directly from the prompt
3703- Added slash command autocomplete support when `/` appears anywhere in input, not just at the beginning
3704- Added `--tools` flag support in interactive mode to restrict which built-in tools Claude can use during interactive sessions
3705- Added `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` environment variable to override the default file read token limit
3706- Added support for `once: true` config for hooks
3707- Added support for YAML-style lists in frontmatter `allowed-tools` field for cleaner skill declarations
3708- Added support for prompt and agent hook types from plugins (previously only command hooks were supported)
3709- Added Cmd+V support for image paste in iTerm2 (maps to Ctrl+V)
3710- Added left/right arrow key navigation for cycling through tabs in dialogs
3711- Added real-time thinking block display in Ctrl+O transcript mode
3712- Added filepath to full output in background bash task details dialog
3713- Added Skills as a separate category in the context visualization
3714- Fixed OAuth token refresh not triggering when server reports token expired but local expiration check disagrees
3715- Fixed session persistence getting stuck after transient server errors by recovering from 409 conflicts when the entry was actually stored
3716- Fixed session resume failures caused by orphaned tool results during concurrent tool execution
3717- Fixed a race condition where stale OAuth tokens could be read from the keychain cache during concurrent token refresh attempts
3718- Fixed AWS Bedrock subagents not inheriting EU/APAC cross-region inference model configuration, causing 403 errors when IAM permissions are scoped to specific regions
3719- Fixed API context overflow when background tasks produce large output by truncating to 30K chars with file path reference
3720- Fixed a hang when reading FIFO files by skipping symlink resolution for special file types
3721- Fixed terminal keyboard mode not being reset on exit in Ghostty, iTerm2, Kitty, and WezTerm
3722- Fixed Alt+B and Alt+F (word navigation) not working in iTerm2, Ghostty, Kitty, and WezTerm
3723- Fixed `${CLAUDE_PLUGIN_ROOT}` not being substituted in plugin `allowed-tools` frontmatter, which caused tools to incorrectly require approval
3724- Fixed files created by the Write tool using hardcoded 0o600 permissions instead of respecting the system umask
3725- Fixed commands with `$()` command substitution failing with parse errors
3726- Fixed multi-line bash commands with backslash continuations being incorrectly split and flagged for permissions
3727- Fixed bash command prefix extraction to correctly identify subcommands after global options (e.g., `git -C /path log` now correctly matches `Bash(git log:*)` rules)
3728- Fixed slash commands passed as CLI arguments (e.g., `claude /context`) not being executed properly
3729- Fixed pressing Enter after Tab-completing a slash command selecting a different command instead of submitting the completed one
3730- Fixed slash command argument hint flickering and inconsistent display when typing commands with arguments
3731- Fixed Claude sometimes redundantly invoking the Skill tool when running slash commands directly
3732- Fixed skill token estimates in `/context` to accurately reflect frontmatter-only loading
3733- Fixed subagents sometimes not inheriting the parent's model by default
3734- Fixed model picker showing incorrect selection for Bedrock/Vertex users using `--model haiku`
3735- Fixed duplicate Bash commands appearing in permission request option labels
3736- Fixed noisy output when background tasks complete - now shows clean completion message instead of raw output
3737- Fixed background task completion notifications to appear proactively with bullet point
3738- Fixed forked slash commands showing "AbortError" instead of "Interrupted" message when cancelled
3739- Fixed cursor disappearing after dismissing permission dialogs
3740- Fixed `/hooks` menu selecting wrong hook type when scrolling to a different option
3741- Fixed images in queued prompts showing as "[object Object]" when pressing Esc to cancel
3742- Fixed images being silently dropped when queueing messages while backgrounding a task
3743- Fixed large pasted images failing with "Image was too large" error
3744- Fixed extra blank lines in multiline prompts containing CJK characters (Japanese, Chinese, Korean)
3745- Fixed ultrathink keyword highlighting being applied to wrong characters when user prompt text wraps to multiple lines
3746- Fixed collapsed "Reading X files…" indicator incorrectly switching to past tense when thinking blocks appear mid-stream
3747- Fixed Bash read commands (like `ls` and `cat`) not being counted in collapsed read/search groups, causing groups to incorrectly show "Read 0 files"
3748- Fixed spinner token counter to properly accumulate tokens from subagents during execution
3749- Fixed memory leak in git diff parsing where sliced strings retained large parent strings
3750- Fixed race condition where LSP tool could return "no server available" during startup
3751- Fixed feedback submission hanging indefinitely when network requests timeout
3752- Fixed search mode in plugin discovery and log selector views exiting when pressing up arrow
3753- Fixed hook success message showing trailing colon when hook has no output
3754- Multiple optimizations to improve startup performance
3755- Improved terminal rendering performance when using native installer or Bun, especially for text with emoji, ANSI codes, and Unicode characters
3756- Improved performance when reading Jupyter notebooks with many cells
3757- Improved reliability for piped input like `cat refactor.md | claude`
3758- Improved reliability for AskQuestion tool
3759- Improved sed in-place edit commands to render as file edits with diff preview
3760- Improved Claude to automatically continue when response is cut off due to output token limit, instead of showing an error message
3761- Improved compaction reliability
3762- Improved subagents (Task tool) to continue working after permission denial, allowing them to try alternative approaches
3763- Improved skills to show progress while executing, displaying tool uses as they happen
3764- Improved skills from `/skills/` directories to be visible in the slash command menu by default (opt-out with `user-invocable: false` in frontmatter)
3765- Improved skill suggestions to prioritize recently and frequently used skills
3766- Improved spinner feedback when waiting for the first response token
3767- Improved token count display in spinner to include tokens from background agents
3768- Improved incremental output for async agents to give the main thread more control and visibility
3769- Improved permission prompt UX with Tab hint moved to footer, cleaner Yes/No input labels with contextual placeholders
3770- Improved the Claude in Chrome notification with shortened help text and persistent display until dismissed
3771- Improved macOS screenshot paste reliability with TIFF format support
3772- Improved `/stats` output
3773- Updated Atlassian MCP integration to use a more reliable default configuration (streamable HTTP)
3774- Changed "Interrupted" message color from red to grey for a less alarming appearance
3775- Removed permission prompt when entering plan mode - users can now enter plan mode without approval
3776- Removed underline styling from image reference links
3777- [SDK] Changed minimum zod peer dependency to ^4.0.0
3778- [VSCode] Added currently selected model name to the context menu
3779- [VSCode] Added descriptive labels on auto-accept permission button (e.g., "Yes, allow npm for this project" instead of "Yes, and don't ask again")
3780- [VSCode] Fixed paragraph breaks not rendering in markdown content
3781- [VSCode] Fixed scrolling in the extension inadvertently scrolling the parent iframe
3782- [Windows] Fixed issue with improper rendering
3783
3784## 2.0.76
3785
3786- Fixed issue with macOS code-sign warning when using Claude in Chrome integration
3787
3788## 2.0.75
3789
3790- Minor bugfixes
3791
3792## 2.0.74
3793
3794- Added LSP (Language Server Protocol) tool for code intelligence features like go-to-definition, find references, and hover documentation
3795- Added `/terminal-setup` support for Kitty, Alacritty, Zed, and Warp terminals
3796- Added ctrl+t shortcut in `/theme` to toggle syntax highlighting on/off
3797- Added syntax highlighting info to theme picker
3798- Added guidance for macOS users when Alt shortcuts fail due to terminal configuration
3799- Fixed skill `allowed-tools` not being applied to tools invoked by the skill
3800- Fixed Opus 4.5 tip incorrectly showing when user was already using Opus
3801- Fixed a potential crash when syntax highlighting isn't initialized correctly
3802- Fixed visual bug in `/plugins discover` where list selection indicator showed while search box was focused
3803- Fixed macOS keyboard shortcuts to display 'opt' instead of 'alt'
3804- Improved `/context` command visualization with grouped skills and agents by source, slash commands, and sorted token count
3805- [Windows] Fixed issue with improper rendering
3806- [VSCode] Added gift tag pictogram for year-end promotion message
3807
3808## 2.0.73
3809
3810- Added clickable `[Image #N]` links that open attached images in the default viewer
3811- Added alt-y yank-pop to cycle through kill ring history after ctrl-y yank
3812- Added search filtering to the plugin discover screen (type to filter by name, description, or marketplace)
3813- Added support for custom session IDs when forking sessions with `--session-id` combined with `--resume` or `--continue` and `--fork-session`
3814- Fixed slow input history cycling and race condition that could overwrite text after message submission
3815- Improved `/theme` command to open theme picker directly
3816- Improved theme picker UI
3817- Improved search UX across resume session, permissions, and plugins screens with a unified SearchBox component
3818- [VSCode] Added tab icon badges showing pending permissions (blue) and unread completions (orange)
3819
3820## 2.0.72
3821
3822- Added Claude in Chrome (Beta) feature that works with the Chrome extension (https://claude.ai/chrome) to let you control your browser directly from Claude Code
3823- Reduced terminal flickering
3824- Added scannable QR code to mobile app tip for quick app downloads
3825- Added loading indicator when resuming conversations for better feedback
3826- Fixed `/context` command not respecting custom system prompts in non-interactive mode
3827- Fixed order of consecutive Ctrl+K lines when pasting with Ctrl+Y
3828- Improved @ mention file suggestion speed (~3× faster in git repositories)
3829- Improved file suggestion performance in repos with `.ignore` or `.rgignore` files
3830- Improved settings validation errors to be more prominent
3831- Changed thinking toggle from Tab to Alt+T to avoid accidental triggers
3832
3833## 2.0.71
3834
3835- Added /config toggle to enable/disable prompt suggestions
3836- Added `/settings` as an alias for the `/config` command
3837- Fixed @ file reference suggestions incorrectly triggering when cursor is in the middle of a path
3838- Fixed MCP servers from `.mcp.json` not loading when using `--dangerously-skip-permissions`
3839- Fixed permission rules incorrectly rejecting valid bash commands containing shell glob patterns (e.g., `ls *.txt`, `for f in *.png`)
3840- Bedrock: Environment variable `ANTHROPIC_BEDROCK_BASE_URL` is now respected for token counting and inference profile listing
3841- New syntax highlighting engine for native build
3842
3843## 2.0.70
3844
3845- Added Enter key to accept and submit prompt suggestions immediately (tab still accepts for editing)
3846- Added wildcard syntax `mcp__server__*` for MCP tool permissions to allow or deny all tools from a server
3847- Added auto-update toggle for plugin marketplaces, allowing per-marketplace control over automatic updates
3848- Added `current_usage` field to status line input, enabling accurate context window percentage calculations
3849- Fixed input being cleared when processing queued commands while the user was typing
3850- Fixed prompt suggestions replacing typed input when pressing Tab
3851- Fixed diff view not updating when terminal is resized
3852- Improved memory usage by 3x for large conversations
3853- Improved resolution of stats screenshots copied to clipboard (Ctrl+S) for crisper images
3854- Removed # shortcut for quick memory entry (tell Claude to edit your CLAUDE.md instead)
3855- Fix thinking mode toggle in /config not persisting correctly
3856- Improve UI for file creation permission dialog
3857
3858## 2.0.69
3859
3860- Minor bugfixes
3861
3862## 2.0.68
3863
3864- Fixed IME (Input Method Editor) support for languages like Chinese, Japanese, and Korean by correctly positioning the composition window at the cursor
3865- Fixed a bug where disallowed MCP tools were visible to the model
3866- Fixed an issue where steering messages could be lost while a subagent is working
3867- Fixed Option+Arrow word navigation treating entire CJK (Chinese, Japanese, Korean) text sequences as a single word instead of navigating by word boundaries
3868- Improved plan mode exit UX: show simplified yes/no dialog when exiting with empty or missing plan instead of throwing an error
3869- Add support for enterprise managed settings. Contact your Anthropic account team to enable this feature.
3870
3871## 2.0.67
3872
3873- Thinking mode is now enabled by default for Opus 4.5
3874- Thinking mode configuration has moved to /config
3875- Added search functionality to `/permissions` command with `/` keyboard shortcut for filtering rules by tool name
3876- Show reason why autoupdater is disabled in `/doctor`
3877- Fixed false "Another process is currently updating Claude" error when running `claude update` while another instance is already on the latest version
3878- Fixed MCP servers from `.mcp.json` being stuck in pending state when running in non-interactive mode (`-p` flag or piped input)
3879- Fixed scroll position resetting after deleting a permission rule in `/permissions`
3880- Fixed word deletion (opt+delete) and word navigation (opt+arrow) not working correctly with non-Latin text such as Cyrillic, Greek, Arabic, Hebrew, Thai, and Chinese
3881- Fixed `claude install --force` not bypassing stale lock files
3882- Fixed consecutive @~/ file references in CLAUDE.md being incorrectly parsed due to markdown strikethrough interference
3883- Windows: Fixed plugin MCP servers failing due to colons in log directory paths
3884
3885## 2.0.65
3886
3887- Added ability to switch models while writing a prompt using alt+p (linux, windows), option+p (macos).
3888- Added context window information to status line input
3889- Added `fileSuggestion` setting for custom `@` file search commands
3890- Added `CLAUDE_CODE_SHELL` environment variable to override automatic shell detection (useful when login shell differs from actual working shell)
3891- Fixed prompt not being saved to history when aborting a query with Escape
3892- Fixed Read tool image handling to identify format from bytes instead of file extension
3893
3894## 2.0.64
3895
3896- Made auto-compacting instant
3897- Agents and bash commands can run asynchronously and send messages to wake up the main agent
3898- /stats now provides users with interesting CC stats, such as favorite model, usage graph, usage streak
3899- Added named session support: use `/rename` to name sessions, `/resume <name>` in REPL or `claude --resume <name>` from the terminal to resume them
3900- Added support for .claude/rules/`. See https://code.claude.com/docs/en/memory for details.
3901- Added image dimension metadata when images are resized, enabling accurate coordinate mappings for large images
3902- Fixed auto-loading .env when using native installer
3903- Fixed `--system-prompt` being ignored when using `--continue` or `--resume` flags
3904- Improved `/resume` screen with grouped forked sessions and keyboard shortcuts for preview (P) and rename (R)
3905- VSCode: Added copy-to-clipboard button on code blocks and bash tool inputs
3906- VSCode: Fixed extension not working on Windows ARM64 by falling back to x64 binary via emulation
3907- Bedrock: Improve efficiency of token counting
3908- Bedrock: Add support for `aws login` AWS Management Console credentials
3909- Unshipped AgentOutputTool and BashOutputTool, in favor of a new unified TaskOutputTool
3910
3911## 2.0.62
3912
3913- Added "(Recommended)" indicator for multiple-choice questions, with the recommended option moved to the top of the list
3914- Added `attribution` setting to customize commit and PR bylines (deprecates `includeCoAuthoredBy`)
3915- Fixed duplicate slash commands appearing when ~/.claude is symlinked to a project directory
3916- Fixed slash command selection not working when multiple commands share the same name
3917- Fixed an issue where skill files inside symlinked skill directories could become circular symlinks
3918- Fixed running versions getting removed because lock file incorrectly going stale
3919- Fixed IDE diff tab not closing when rejecting file changes
3920
3921## 2.0.61
3922
3923- Reverted VSCode support for multiple terminal clients due to responsiveness issues.
3924
3925## 2.0.60
3926
3927- Added background agent support. Agents run in the background while you work
3928- Added --disable-slash-commands CLI flag to disable all slash commands
3929- Added model name to "Co-Authored-By" commit messages
3930- Enabled "/mcp enable [server-name]" or "/mcp disable [server-name]" to quickly toggle all servers
3931- Updated Fetch to skip summarization for pre-approved websites
3932- VSCode: Added support for multiple terminal clients connecting to the IDE server simultaneously
3933
3934## 2.0.59
3935
3936- Added --agent CLI flag to override the agent setting for the current session
3937- Added `agent` setting to configure main thread with a specific agent's system prompt, tool restrictions, and model
3938- VS Code: Fixed .claude.json config file being read from incorrect location
3939
3940## 2.0.58
3941
3942- Pro users now have access to Opus 4.5 as part of their subscription!
3943- Fixed timer duration showing "11m 60s" instead of "12m 0s"
3944- Windows: Managed settings now prefer `C:\Program Files\ClaudeCode` if it exists. Support for `C:\ProgramData\ClaudeCode` will be removed in a future version.
3945
3946## 2.0.57
3947
3948- Added feedback input when rejecting plans, allowing users to tell Claude what to change
3949- VSCode: Added streaming message support for real-time response display
3950
3951## 2.0.56
3952
3953- Added setting to enable/disable terminal progress bar (OSC 9;4)
3954- VSCode Extension: Added support for VS Code's secondary sidebar (VS Code 1.97+), allowing Claude Code to be displayed in the right sidebar while keeping the file explorer on the left. Requires setting sidebar as Preferred Location in the config.
3955
3956## 2.0.55
3957
3958- Fixed proxy DNS resolution being forced on by default. Now opt-in via `CLAUDE_CODE_PROXY_RESOLVES_HOSTS=true` environment variable
3959- Fixed keyboard navigation becoming unresponsive when holding down arrow keys in memory location selector
3960- Improved AskUserQuestion tool to auto-submit single-select questions on the last question, eliminating the extra review screen for simple question flows
3961- Improved fuzzy matching for `@` file suggestions with faster, more accurate results
3962
3963## 2.0.54
3964
3965- Hooks: Enable PermissionRequest hooks to process 'always allow' suggestions and apply permission updates
3966- Fix issue with excessive iTerm notifications
3967
3968## 2.0.52
3969
3970- Fixed duplicate message display when starting Claude with a command line argument
3971- Fixed `/usage` command progress bars to fill up as usage increases (instead of showing remaining percentage)
3972- Fixed image pasting not working on Linux systems running Wayland (now falls back to wl-paste when xclip is unavailable)
3973- Permit some uses of `$!` in bash commands
3974
3975## 2.0.51
3976
3977- Added Opus 4.5! https://www.anthropic.com/news/claude-opus-4-5
3978- Introducing Claude Code for Desktop: https://claude.com/download
3979- To give you room to try out our new model, we've updated usage limits for Claude Code users. See the Claude Opus 4.5 blog for full details
3980- Pro users can now purchase extra usage for access to Opus 4.5 in Claude Code
3981- Plan Mode now builds more precise plans and executes more thoroughly
3982- Usage limit notifications now easier to understand
3983- Switched `/usage` back to "% used"
3984- Fixed handling of thinking errors
3985- Fixed performance regression
3986
3987## 2.0.50
3988
3989- Fixed bug preventing calling MCP tools that have nested references in their input schemas
3990- Silenced a noisy but harmless error during upgrades
3991- Improved ultrathink text display
3992- Improved clarity of 5-hour session limit warning message
3993
3994## 2.0.49
3995
3996- Added readline-style ctrl-y for pasting deleted text
3997- Improved clarity of usage limit warning message
3998- Fixed handling of subagent permissions
3999
4000## 2.0.47
4001
4002- Improved error messages and validation for `claude --teleport`
4003- Improved error handling in `/usage`
4004- Fixed race condition with history entry not getting logged at exit
4005- Fixed Vertex AI configuration not being applied from `settings.json`
4006
4007## 2.0.46
4008
4009- Fixed image files being reported with incorrect media type when format cannot be detected from metadata
4010
4011## 2.0.45
4012
4013- Added support for Microsoft Foundry! See https://code.claude.com/docs/en/azure-ai-foundry
4014- Added `PermissionRequest` hook to automatically approve or deny tool permission requests with custom logic
4015- Send background tasks to Claude Code on the web by starting a message with `&`
4016
4017## 2.0.43
4018
4019- Added `permissionMode` field for custom agents
4020- Added `tool_use_id` field to `PreToolUseHookInput` and `PostToolUseHookInput` types
4021- Added skills frontmatter field to declare skills to auto-load for subagents
4022- Added the `SubagentStart` hook event
4023- Fixed nested `CLAUDE.md` files not loading when @-mentioning files
4024- Fixed duplicate rendering of some messages in the UI
4025- Fixed some visual flickers
4026- Fixed NotebookEdit tool inserting cells at incorrect positions when cell IDs matched the pattern `cell-N`
4027
4028## 2.0.42
4029
4030- Added `agent_id` and `agent_transcript_path` fields to `SubagentStop` hooks.
4031
4032## 2.0.41
4033
4034- Added `model` parameter to prompt-based stop hooks, allowing users to specify a custom model for hook evaluation
4035- Fixed slash commands from user settings being loaded twice, which could cause rendering issues
4036- Fixed incorrect labeling of user settings vs project settings in command descriptions
4037- Fixed crash when plugin command hooks timeout during execution
4038- Fixed: Bedrock users no longer see duplicate Opus entries in the /model picker when using `--model haiku`
4039- Fixed broken security documentation links in trust dialogs and onboarding
4040- Fixed issue where pressing ESC to close the diff modal would also interrupt the model
4041- ctrl-r history search landing on a slash command no longer cancels the search
4042- SDK: Support custom timeouts for hooks
4043- Allow more safe git commands to run without approval
4044- Plugins: Added support for sharing and installing output styles
4045- Teleporting a session from web will automatically set the upstream branch
4046
4047## 2.0.37
4048
4049- Fixed how idleness is computed for notifications
4050- Hooks: Added matcher values for Notification hook events
4051- Output Styles: Added `keep-coding-instructions` option to frontmatter
4052
4053## 2.0.36
4054
4055- Fixed: DISABLE_AUTOUPDATER environment variable now properly disables package manager update notifications
4056- Fixed queued messages being incorrectly executed as bash commands
4057- Fixed input being lost when typing while a queued message is processed
4058
4059## 2.0.35
4060
4061- Improve fuzzy search results when searching commands
4062- Improved VS Code extension to respect `chat.fontSize` and `chat.fontFamily` settings throughout the entire UI, and apply font changes immediately without requiring reload
4063- Added `CLAUDE_CODE_EXIT_AFTER_STOP_DELAY` environment variable to automatically exit SDK mode after a specified idle duration, useful for automated workflows and scripts
4064- Migrated `ignorePatterns` from project config to deny permissions in the localSettings.
4065- Fixed menu navigation getting stuck on items with empty string or other falsy values (e.g., in the `/hooks` menu)
4066
4067## 2.0.34
4068
4069- VSCode Extension: Added setting to configure the initial permission mode for new conversations
4070- Improved file path suggestion performance with native Rust-based fuzzy finder
4071- Fixed infinite token refresh loop that caused MCP servers with OAuth (e.g., Slack) to hang during connection
4072- Fixed memory crash when reading or writing large files (especially base64-encoded images)
4073
4074## 2.0.33
4075
4076- Native binary installs now launch quicker.
4077- Fixed `claude doctor` incorrectly detecting Homebrew vs npm-global installations by properly resolving symlinks
4078- Fixed `claude mcp serve` exposing tools with incompatible outputSchemas
4079
4080## 2.0.32
4081
4082- Un-deprecate output styles based on community feedback
4083- Added `companyAnnouncements` setting for displaying announcements on startup
4084- Fixed hook progress messages not updating correctly during PostToolUse hook execution
4085
4086## 2.0.31
4087
4088- Windows: native installation uses shift+tab as shortcut for mode switching, instead of alt+m
4089- Vertex: add support for Web Search on supported models
4090- VSCode: Adding the respectGitIgnore configuration to include .gitignored files in file searches (defaults to true)
4091- Fixed a bug with subagents and MCP servers related to "Tool names must be unique" error
4092- Fixed issue causing `/compact` to fail with `prompt_too_long` by making it respect existing compact boundaries
4093- Fixed plugin uninstall not removing plugins
4094
4095## 2.0.30
4096
4097- Added helpful hint to run `security unlock-keychain` when encountering API key errors on macOS with locked keychain
4098- Added `allowUnsandboxedCommands` sandbox setting to disable the dangerouslyDisableSandbox escape hatch at policy level
4099- Added `disallowedTools` field to custom agent definitions for explicit tool blocking
4100- Added prompt-based stop hooks
4101- VSCode: Added respectGitIgnore configuration to include .gitignored files in file searches (defaults to true)
4102- Enabled SSE MCP servers on native build
4103- Deprecated output styles. Review options in `/output-style` and use --system-prompt-file, --system-prompt, --append-system-prompt, CLAUDE.md, or plugins instead
4104- Removed support for custom ripgrep configuration, resolving an issue where Search returns no results and config discovery fails
4105- Fixed Explore agent creating unwanted .md investigation files during codebase exploration
4106- Fixed a bug where `/context` would sometimes fail with "max_tokens must be greater than thinking.budget_tokens" error message
4107- Fixed `--mcp-config` flag to correctly override file-based MCP configurations
4108- Fixed bug that saved session permissions to local settings
4109- Fixed MCP tools not being available to sub-agents
4110- Fixed hooks and plugins not executing when using --dangerously-skip-permissions flag
4111- Fixed delay when navigating through typeahead suggestions with arrow keys
4112- VSCode: Restored selection indicator in input footer showing current file or code selection status
4113
4114## 2.0.28
4115
4116- Plan mode: introduced new Plan subagent
4117- Subagents: claude can now choose to resume subagents
4118- Subagents: claude can dynamically choose the model used by its subagents
4119- SDK: added --max-budget-usd flag
4120- Discovery of custom slash commands, subagents, and output styles no longer respects .gitignore
4121- Stop `/terminal-setup` from adding backslash to `Shift + Enter` in VS Code
4122- Add branch and tag support for git-based plugins and marketplaces using fragment syntax (e.g., `owner/repo#branch`)
4123- Fixed a bug where macOS permission prompts would show up upon initial launch when launching from home directory
4124- Various other bug fixes
4125
4126## 2.0.27
4127
4128- New UI for permission prompts
4129- Added current branch filtering and search to session resume screen for easier navigation
4130- Fixed directory @-mention causing "No assistant message found" error
4131- VSCode Extension: Add config setting to include .gitignored files in file searches
4132- VSCode Extension: Bug fixes for unrelated 'Warmup' conversations, and configuration/settings occasionally being reset to defaults
4133
4134## 2.0.25
4135
4136- Removed legacy SDK entrypoint. Please migrate to @anthropic-ai/claude-agent-sdk for future SDK updates: https://platform.claude.com/docs/en/agent-sdk/migration-guide
4137
4138## 2.0.24
4139
4140- Fixed a bug where project-level skills were not loading when --setting-sources 'project' was specified
4141- Claude Code Web: Support for Web -> CLI teleport
4142- Sandbox: Releasing a sandbox mode for the BashTool on Linux & Mac
4143- Bedrock: Display awsAuthRefresh output when auth is required
4144
4145## 2.0.22
4146
4147- Fixed content layout shift when scrolling through slash commands
4148- IDE: Add toggle to enable/disable thinking.
4149- Fix bug causing duplicate permission prompts with parallel tool calls
4150- Add support for enterprise managed MCP allowlist and denylist
4151
4152## 2.0.21
4153
4154- Support MCP `structuredContent` field in tool responses
4155- Added an interactive question tool
4156- Claude will now ask you questions more often in plan mode
4157- Added Haiku 4.5 as a model option for Pro users
4158- Fixed an issue where queued commands don't have access to previous messages' output
4159
4160## 2.0.20
4161
4162- Added support for Claude Skills
4163
4164## 2.0.19
4165
4166- Auto-background long-running bash commands instead of killing them. Customize with BASH_DEFAULT_TIMEOUT_MS
4167- Fixed a bug where Haiku was unnecessarily called in print mode
4168
4169## 2.0.17
4170
4171- Added Haiku 4.5 to model selector!
4172- Haiku 4.5 automatically uses Sonnet in plan mode, and Haiku for execution (i.e. SonnetPlan by default)
4173- 3P (Bedrock and Vertex) are not automatically upgraded yet. Manual upgrading can be done through setting `ANTHROPIC_DEFAULT_HAIKU_MODEL`
4174- Introducing the Explore subagent. Powered by Haiku it'll search through your codebase efficiently to save context!
4175- OTEL: support HTTP_PROXY and HTTPS_PROXY
4176- `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` now disables release notes fetching
4177
4178## 2.0.15
4179
4180- Fixed bug with resuming where previously created files needed to be read again before writing
4181- Fixed bug with `-p` mode where @-mentioned files needed to be read again before writing
4182
4183## 2.0.14
4184
4185- Fix @-mentioning MCP servers to toggle them on/off
4186- Improve permission checks for bash with inline env vars
4187- Fix ultrathink + thinking toggle
4188- Reduce unnecessary logins
4189- Document --system-prompt
4190- Several improvements to rendering
4191- Plugins UI polish
4192
4193## 2.0.13
4194
4195- Fixed `/plugin` not working on native build
4196
4197## 2.0.12
4198
4199- **Plugin System Released**: Extend Claude Code with custom commands, agents, hooks, and MCP servers from marketplaces
4200- `/plugin install`, `/plugin enable/disable`, `/plugin marketplace` commands for plugin management
4201- Repository-level plugin configuration via `extraKnownMarketplaces` for team collaboration
4202- `/plugin validate` command for validating plugin structure and configuration
4203- Plugin announcement blog post at https://www.anthropic.com/news/claude-code-plugins
4204- Plugin documentation available at https://code.claude.com/docs/en/plugins
4205- Comprehensive error messages and diagnostics via `/doctor` command
4206- Avoid flickering in `/model` selector
4207- Improvements to `/help`
4208- Avoid mentioning hooks in `/resume` summaries
4209- Changes to the "verbose" setting in `/config` now persist across sessions
4210
4211## 2.0.11
4212
4213- Reduced system prompt size by 1.4k tokens
4214- IDE: Fixed keyboard shortcuts and focus issues for smoother interaction
4215- Fixed Opus fallback rate limit errors appearing incorrectly
4216- Fixed /add-dir command selecting wrong default tab
4217
4218## 2.0.10
4219
4220- Rewrote terminal renderer for buttery smooth UI
4221- Enable/disable MCP servers by @mentioning, or in /mcp
4222- Added tab completion for shell commands in bash mode
4223- PreToolUse hooks can now modify tool inputs
4224- Press Ctrl-G to edit your prompt in your system's configured text editor
4225- Fixes for bash permission checks with environment variables in the command
4226
4227## 2.0.9
4228
4229- Fix regression where bash backgrounding stopped working
4230
4231## 2.0.8
4232
4233- Update Bedrock default Sonnet model to `global.anthropic.claude-sonnet-4-5-20250929-v1:0`
4234- IDE: Add drag-and-drop support for files and folders in chat
4235- /context: Fix counting for thinking blocks
4236- Improve message rendering for users with light themes on dark terminals
4237- Remove deprecated .claude.json allowedTools, ignorePatterns, env, and todoFeatureEnabled config options (instead, configure these in your settings.json)
4238
4239## 2.0.5
4240
4241- IDE: Fix IME unintended message submission with Enter and Tab
4242- IDE: Add "Open in Terminal" link in login screen
4243- Fix unhandled OAuth expiration 401 API errors
4244- SDK: Added SDKUserMessageReplay.isReplay to prevent duplicate messages
4245
4246## 2.0.1
4247
4248- Skip Sonnet 4.5 default model setting change for Bedrock and Vertex
4249- Various bug fixes and presentation improvements
4250
4251## 2.0.0
4252
4253- New native VS Code extension
4254- Fresh coat of paint throughout the whole app
4255- /rewind a conversation to undo code changes
4256- /usage command to see plan limits
4257- Tab to toggle thinking (sticky across sessions)
4258- Ctrl-R to search history
4259- Unshipped claude config command
4260- Hooks: Reduced PostToolUse 'tool_use' ids were found without 'tool_result' blocks errors
4261- SDK: The Claude Code SDK is now the Claude Agent SDK
4262- Add subagents dynamically with `--agents` flag
4263
4264## 1.0.126
4265
4266- Enable /context command for Bedrock and Vertex
4267- Add mTLS support for HTTP-based OpenTelemetry exporters
4268
4269## 1.0.124
4270
4271- Set `CLAUDE_BASH_NO_LOGIN` environment variable to 1 or true to to skip login shell for BashTool
4272- Fix Bedrock and Vertex environment variables evaluating all strings as truthy
4273- No longer inform Claude of the list of allowed tools when permission is denied
4274- Fixed security vulnerability in Bash tool permission checks
4275- Improved VSCode extension performance for large files
4276
4277## 1.0.123
4278
4279- Bash permission rules now support output redirections when matching (e.g., `Bash(python:*)` matches `python script.py > output.txt`)
4280- Fixed thinking mode triggering on negation phrases like "don't think"
4281- Fixed rendering performance degradation during token streaming
4282- Added SlashCommand tool, which enables Claude to invoke your slash commands. https://code.claude.com/docs/en/slash-commands#SlashCommand-tool
4283- Enhanced BashTool environment snapshot logging
4284- Fixed a bug where resuming a conversation in headless mode would sometimes enable thinking unnecessarily
4285- Migrated --debug logging to a file, to enable easy tailing & filtering
4286
4287## 1.0.120
4288
4289- Fix input lag during typing, especially noticeable with large prompts
4290- Improved VSCode extension command registry and sessions dialog user experience
4291- Enhanced sessions dialog responsiveness and visual feedback
4292- Fixed IDE compatibility issue by removing worktree support check
4293- Fixed security vulnerability where Bash tool permission checks could be bypassed using prefix matching
4294
4295## 1.0.119
4296
4297- Fix Windows issue where process visually freezes on entering interactive mode
4298- Support dynamic headers for MCP servers via headersHelper configuration
4299- Fix thinking mode not working in headless sessions
4300- Fix slash commands now properly update allowed tools instead of replacing them
4301
4302## 1.0.117
4303
4304- Add Ctrl-R history search to recall previous commands like bash/zsh
4305- Fix input lag while typing, especially on Windows
4306- Add sed command to auto-allowed commands in acceptEdits mode
4307- Fix Windows PATH comparison to be case-insensitive for drive letters
4308- Add permissions management hint to /add-dir output
4309
4310## 1.0.115
4311
4312- Improve thinking mode display with enhanced visual effects
4313- Type /t to temporarily disable thinking mode in your prompt
4314- Improve path validation for glob and grep tools
4315- Show condensed output for post-tool hooks to reduce visual clutter
4316- Fix visual feedback when loading state completes
4317- Improve UI consistency for permission request dialogs
4318
4319## 1.0.113
4320
4321- Deprecated piped input in interactive mode
4322- Move Ctrl+R keybinding for toggling transcript to Ctrl+O
4323
4324## 1.0.112
4325
4326- Transcript mode (Ctrl+R): Added the model used to generate each assistant message
4327- Addressed issue where some Claude Max users were incorrectly recognized as Claude Pro users
4328- Hooks: Added systemMessage support for SessionEnd hooks
4329- Added `spinnerTipsEnabled` setting to disable spinner tips
4330- IDE: Various improvements and bug fixes
4331
4332## 1.0.111
4333
4334- /model now validates provided model names
4335- Fixed Bash tool crashes caused by malformed shell syntax parsing
4336
4337## 1.0.110
4338
4339- /terminal-setup command now supports WezTerm
4340- MCP: OAuth tokens now proactively refresh before expiration
4341- Fixed reliability issues with background Bash processes
4342
4343## 1.0.109
4344
4345- SDK: Added partial message streaming support via `--include-partial-messages` CLI flag
4346
4347## 1.0.106
4348
4349- Windows: Fixed path permission matching to consistently use POSIX format (e.g., `Read(//c/Users/...)`)
4350
4351## 1.0.97
4352
4353- Settings: /doctor now validates permission rule syntax and suggests corrections
4354
4355## 1.0.94
4356
4357- Vertex: add support for global endpoints for supported models
4358- /memory command now allows direct editing of all imported memory files
4359- SDK: Add custom tools as callbacks
4360- Added /todos command to list current todo items
4361
4362## 1.0.93
4363
4364- Windows: Add alt + v shortcut for pasting images from clipboard
4365- Support NO_PROXY environment variable to bypass proxy for specified hostnames and IPs
4366
4367## 1.0.90
4368
4369- Settings file changes take effect immediately - no restart required
4370
4371## 1.0.88
4372
4373- Fixed issue causing "OAuth authentication is currently not supported"
4374- Status line input now includes `exceeds_200k_tokens`
4375- Fixed incorrect usage tracking in /cost.
4376- Introduced `ANTHROPIC_DEFAULT_SONNET_MODEL` and `ANTHROPIC_DEFAULT_OPUS_MODEL` for controlling model aliases opusplan, opus, and sonnet.
4377- Bedrock: Updated default Sonnet model to Sonnet 4
4378
4379## 1.0.86
4380
4381- Added /context to help users self-serve debug context issues
4382- SDK: Added UUID support for all SDK messages
4383- SDK: Added `--replay-user-messages` to replay user messages back to stdout
4384
4385## 1.0.85
4386
4387- Status line input now includes session cost info
4388- Hooks: Introduced SessionEnd hook
4389
4390## 1.0.84
4391
4392- Fix tool_use/tool_result id mismatch error when network is unstable
4393- Fix Claude sometimes ignoring real-time steering when wrapping up a task
4394- @-mention: Add ~/.claude/\* files to suggestions for easier agent, output style, and slash command editing
4395- Use built-in ripgrep by default; to opt out of this behavior, set USE_BUILTIN_RIPGREP=0
4396
4397## 1.0.83
4398
4399- @-mention: Support files with spaces in path
4400- New shimmering spinner
4401
4402## 1.0.82
4403
4404- SDK: Add request cancellation support
4405- SDK: New additionalDirectories option to search custom paths, improved slash command processing
4406- Settings: Validation prevents invalid fields in .claude/settings.json files
4407- MCP: Improve tool name consistency
4408- Bash: Fix crash when Claude tries to automatically read large files
4409
4410## 1.0.81
4411
4412- Released output styles, including new built-in educational output styles "Explanatory" and "Learning". Docs: https://code.claude.com/docs/en/output-styles
4413- Agents: Fix custom agent loading when agent files are unparsable
4414
4415## 1.0.80
4416
4417- UI improvements: Fix text contrast for custom subagent colors and spinner rendering issues
4418
4419## 1.0.77
4420
4421- Bash tool: Fix heredoc and multiline string escaping, improve stderr redirection handling
4422- SDK: Add session support and permission denial tracking
4423- Fix token limit errors in conversation summarization
4424- Opus Plan Mode: New setting in `/model` to run Opus only in plan mode, Sonnet otherwise
4425
4426## 1.0.73
4427
4428- MCP: Support multiple config files with `--mcp-config file1.json file2.json`
4429- MCP: Press Esc to cancel OAuth authentication flows
4430- Bash: Improved command validation and reduced false security warnings
4431- UI: Enhanced spinner animations and status line visual hierarchy
4432- Linux: Added support for Alpine and musl-based distributions (requires separate ripgrep installation)
4433
4434## 1.0.72
4435
4436- Ask permissions: have Claude Code always ask for confirmation to use specific tools with /permissions
4437
4438## 1.0.71
4439
4440- Background commands: (Ctrl-b) to run any Bash command in the background so Claude can keep working (great for dev servers, tailing logs, etc.)
4441- Customizable status line: add your terminal prompt to Claude Code with /statusline
4442
4443## 1.0.70
4444
4445- Performance: Optimized message rendering for better performance with large contexts
4446- Windows: Fixed native file search, ripgrep, and subagent functionality
4447- Added support for @-mentions in slash command arguments
4448
4449## 1.0.69
4450
4451- Upgraded Opus to version 4.1
4452
4453## 1.0.68
4454
4455- Fix incorrect model names being used for certain commands like `/pr-comments`
4456- Windows: improve permissions checks for allow / deny tools and project trust. This may create a new project entry in `.claude.json` - manually merge the history field if desired.
4457- Windows: improve sub-process spawning to eliminate "No such file or directory" when running commands like pnpm
4458- Enhanced /doctor command with CLAUDE.md and MCP tool context for self-serve debugging
4459- SDK: Added canUseTool callback support for tool confirmation
4460- Added `disableAllHooks` setting
4461- Improved file suggestions performance in large repos
4462
4463## 1.0.65
4464
4465- IDE: Fixed connection stability issues and error handling for diagnostics
4466- Windows: Fixed shell environment setup for users without .bashrc files
4467
4468## 1.0.64
4469
4470- Agents: Added model customization support - you can now specify which model an agent should use
4471- Agents: Fixed unintended access to the recursive agent tool
4472- Hooks: Added systemMessage field to hook JSON output for displaying warnings and context
4473- SDK: Fixed user input tracking across multi-turn conversations
4474- Added hidden files to file search and @-mention suggestions
4475
4476## 1.0.63
4477
4478- Windows: Fixed file search, @agent mentions, and custom slash commands functionality
4479
4480## 1.0.62
4481
4482- Added @-mention support with typeahead for custom agents. @<your-custom-agent> to invoke it
4483- Hooks: Added SessionStart hook for new session initialization
4484- /add-dir command now supports typeahead for directory paths
4485- Improved network connectivity check reliability
4486
4487## 1.0.61
4488
4489- Transcript mode (Ctrl+R): Changed Esc to exit transcript mode rather than interrupt
4490- Settings: Added `--settings` flag to load settings from a JSON file
4491- Settings: Fixed resolution of settings files paths that are symlinks
4492- OTEL: Fixed reporting of wrong organization after authentication changes
4493- Slash commands: Fixed permissions checking for allowed-tools with Bash
4494- IDE: Added support for pasting images in VSCode MacOS using ⌘+V
4495- IDE: Added `CLAUDE_CODE_AUTO_CONNECT_IDE=false` for disabling IDE auto-connection
4496- Added `CLAUDE_CODE_SHELL_PREFIX` for wrapping Claude and user-provided shell commands run by Claude Code
4497
4498## 1.0.60
4499
4500- You can now create custom subagents for specialized tasks! Run /agents to get started
4501
4502## 1.0.59
4503
4504- SDK: Added tool confirmation support with canUseTool callback
4505- SDK: Allow specifying env for spawned process
4506- Hooks: Exposed PermissionDecision to hooks (including "ask")
4507- Hooks: UserPromptSubmit now supports additionalContext in advanced JSON output
4508- Fixed issue where some Max users that specified Opus would still see fallback to Sonnet
4509
4510## 1.0.58
4511
4512- Added support for reading PDFs
4513- MCP: Improved server health status display in 'claude mcp list'
4514- Hooks: Added CLAUDE_PROJECT_DIR env var for hook commands
4515
4516## 1.0.57
4517
4518- Added support for specifying a model in slash commands
4519- Improved permission messages to help Claude understand allowed tools
4520- Fix: Remove trailing newlines from bash output in terminal wrapping
4521
4522## 1.0.56
4523
4524- Windows: Enabled shift+tab for mode switching on versions of Node.js that support terminal VT mode
4525- Fixes for WSL IDE detection
4526- Fix an issue causing awsRefreshHelper changes to .aws directory not to be picked up
4527
4528## 1.0.55
4529
4530- Clarified knowledge cutoff for Opus 4 and Sonnet 4 models
4531- Windows: fixed Ctrl+Z crash
4532- SDK: Added ability to capture error logging
4533- Add --system-prompt-file option to override system prompt in print mode
4534
4535## 1.0.54
4536
4537- Hooks: Added UserPromptSubmit hook and the current working directory to hook inputs
4538- Custom slash commands: Added argument-hint to frontmatter
4539- Windows: OAuth uses port 45454 and properly constructs browser URL
4540- Windows: mode switching now uses alt + m, and plan mode renders properly
4541- Shell: Switch to in-memory shell snapshot to fix file-related errors
4542
4543## 1.0.53
4544
4545- Updated @-mention file truncation from 100 lines to 2000 lines
4546- Add helper script settings for AWS token refresh: awsAuthRefresh (for foreground operations like aws sso login) and awsCredentialExport (for background operation with STS-like response).
4547
4548## 1.0.52
4549
4550- Added support for MCP server instructions
4551
4552## 1.0.51
4553
4554- Added support for native Windows (requires Git for Windows)
4555- Added support for Bedrock API keys through environment variable AWS_BEARER_TOKEN_BEDROCK
4556- Settings: /doctor can now help you identify and fix invalid setting files
4557- `--append-system-prompt` can now be used in interactive mode, not just --print/-p.
4558- Increased auto-compact warning threshold from 60% to 80%
4559- Fixed an issue with handling user directories with spaces for shell snapshots
4560- OTEL resource now includes os.type, os.version, host.arch, and wsl.version (if running on Windows Subsystem for Linux)
4561- Custom slash commands: Fixed user-level commands in subdirectories
4562- Plan mode: Fixed issue where rejected plan from sub-task would get discarded
4563
4564## 1.0.48
4565
4566- Fixed a bug in v1.0.45 where the app would sometimes freeze on launch
4567- Added progress messages to Bash tool based on the last 5 lines of command output
4568- Added expanding variables support for MCP server configuration
4569- Moved shell snapshots from /tmp to ~/.claude for more reliable Bash tool calls
4570- Improved IDE extension path handling when Claude Code runs in WSL
4571- Hooks: Added a PreCompact hook
4572- Vim mode: Added c, f/F, t/T
4573
4574## 1.0.45
4575
4576- Redesigned Search (Grep) tool with new tool input parameters and features
4577- Disabled IDE diffs for notebook files, fixing "Timeout waiting after 1000ms" error
4578- Fixed config file corruption issue by enforcing atomic writes
4579- Updated prompt input undo to Ctrl+\_ to avoid breaking existing Ctrl+U behavior, matching zsh's undo shortcut
4580- Stop Hooks: Fixed transcript path after /clear and fixed triggering when loop ends with tool call
4581- Custom slash commands: Restored namespacing in command names based on subdirectories. For example, .claude/commands/frontend/component.md is now /frontend:component, not /component.
4582
4583## 1.0.44
4584
4585- New /export command lets you quickly export a conversation for sharing
4586- MCP: resource_link tool results are now supported
4587- MCP: tool annotations and tool titles now display in /mcp view
4588- Changed Ctrl+Z to suspend Claude Code. Resume by running `fg`. Prompt input undo is now Ctrl+U.
4589
4590## 1.0.43
4591
4592- Fixed a bug where the theme selector was saving excessively
4593- Hooks: Added EPIPE system error handling
4594
4595## 1.0.42
4596
4597- Added tilde (`~`) expansion support to `/add-dir` command
4598
4599## 1.0.41
4600
4601- Hooks: Split Stop hook triggering into Stop and SubagentStop
4602- Hooks: Enabled optional timeout configuration for each command
4603- Hooks: Added "hook_event_name" to hook input
4604- Fixed a bug where MCP tools would display twice in tool list
4605- New tool parameters JSON for Bash tool in `tool_decision` event
4606
4607## 1.0.40
4608
4609- Fixed a bug causing API connection errors with UNABLE_TO_GET_ISSUER_CERT_LOCALLY if `NODE_EXTRA_CA_CERTS` was set
4610
4611## 1.0.39
4612
4613- New Active Time metric in OpenTelemetry logging
4614
4615## 1.0.38
4616
4617- Released hooks. Special thanks to community input in https://github.com/anthropics/claude-code/issues/712. Docs: https://code.claude.com/docs/en/hooks
4618
4619## 1.0.37
4620
4621- Remove ability to set `Proxy-Authorization` header via ANTHROPIC_AUTH_TOKEN or apiKeyHelper
4622
4623## 1.0.36
4624
4625- Web search now takes today's date into context
4626- Fixed a bug where stdio MCP servers were not terminating properly on exit
4627
4628## 1.0.35
4629
4630- Added support for MCP OAuth Authorization Server discovery
4631
4632## 1.0.34
4633
4634- Fixed a memory leak causing a MaxListenersExceededWarning message to appear
4635
4636## 1.0.33
4637
4638- Improved logging functionality with session ID support
4639- Added prompt input undo functionality (Ctrl+Z and vim 'u' command)
4640- Improvements to plan mode
4641
4642## 1.0.32
4643
4644- Updated loopback config for litellm
4645- Added forceLoginMethod setting to bypass login selection screen
4646
4647## 1.0.31
4648
4649- Fixed a bug where ~/.claude.json would get reset when file contained invalid JSON
4650
4651## 1.0.30
4652
4653- Custom slash commands: Run bash output, @-mention files, enable thinking with thinking keywords
4654- Improved file path autocomplete with filename matching
4655- Added timestamps in Ctrl-r mode and fixed Ctrl-c handling
4656- Enhanced jq regex support for complex filters with pipes and select
4657
4658## 1.0.29
4659
4660- Improved CJK character support in cursor navigation and rendering
4661
4662## 1.0.28
4663
4664- Slash commands: Fix selector display during history navigation
4665- Resizes images before upload to prevent API size limit errors
4666- Added XDG_CONFIG_HOME support to configuration directory
4667- Performance optimizations for memory usage
4668- New attributes (terminal.type, language) in OpenTelemetry logging
4669
4670## 1.0.27
4671
4672- Streamable HTTP MCP servers are now supported
4673- Remote MCP servers (SSE and HTTP) now support OAuth
4674- MCP resources can now be @-mentioned
4675- /resume slash command to switch conversations within Claude Code
4676
4677## 1.0.25
4678
4679- Slash commands: moved "project" and "user" prefixes to descriptions
4680- Slash commands: improved reliability for command discovery
4681- Improved support for Ghostty
4682- Improved web search reliability
4683
4684## 1.0.24
4685
4686- Improved /mcp output
4687- Fixed a bug where settings arrays got overwritten instead of merged
4688
4689## 1.0.23
4690
4691- Released TypeScript SDK: import @anthropic-ai/claude-code to get started
4692- Released Python SDK: pip install claude-code-sdk to get started
4693
4694## 1.0.22
4695
4696- SDK: Renamed `total_cost` to `total_cost_usd`
4697
4698## 1.0.21
4699
4700- Improved editing of files with tab-based indentation
4701- Fix for tool_use without matching tool_result errors
4702- Fixed a bug where stdio MCP server processes would linger after quitting Claude Code
4703
4704## 1.0.18
4705
4706- Added --add-dir CLI argument for specifying additional working directories
4707- Added streaming input support without require -p flag
4708- Improved startup performance and session storage performance
4709- Added CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR environment variable to freeze working directory for bash commands
4710- Added detailed MCP server tools display (/mcp)
4711- MCP authentication and permission improvements
4712- Added auto-reconnection for MCP SSE connections on disconnect
4713- Fixed issue where pasted content was lost when dialogs appeared
4714
4715## 1.0.17
4716
4717- We now emit messages from sub-tasks in -p mode (look for the parent_tool_use_id property)
4718- Fixed crashes when the VS Code diff tool is invoked multiple times quickly
4719- MCP server list UI improvements
4720- Update Claude Code process title to display "claude" instead of "node"
4721
4722## 1.0.11
4723
4724- Claude Code can now also be used with a Claude Pro subscription
4725- Added /upgrade for smoother switching to Claude Max plans
4726- Improved UI for authentication from API keys and Bedrock/Vertex/external auth tokens
4727- Improved shell configuration error handling
4728- Improved todo list handling during compaction
4729
4730## 1.0.10
4731
4732- Added markdown table support
4733- Improved streaming performance
4734
4735## 1.0.8
4736
4737- Fixed Vertex AI region fallback when using CLOUD_ML_REGION
4738- Increased default otel interval from 1s -> 5s
4739- Fixed edge cases where MCP_TIMEOUT and MCP_TOOL_TIMEOUT weren't being respected
4740- Fixed a regression where search tools unnecessarily asked for permissions
4741- Added support for triggering thinking non-English languages
4742- Improved compacting UI
4743
4744## 1.0.7
4745
4746- Renamed /allowed-tools -> /permissions
4747- Migrated allowedTools and ignorePatterns from .claude.json -> settings.json
4748- Deprecated claude config commands in favor of editing settings.json
4749- Fixed a bug where --dangerously-skip-permissions sometimes didn't work in --print mode
4750- Improved error handling for /install-github-app
4751- Bugfixes, UI polish, and tool reliability improvements
4752
4753## 1.0.6
4754
4755- Improved edit reliability for tab-indented files
4756- Respect CLAUDE_CONFIG_DIR everywhere
4757- Reduced unnecessary tool permission prompts
4758- Added support for symlinks in @file typeahead
4759- Bugfixes, UI polish, and tool reliability improvements
4760
4761## 1.0.4
4762
4763- Fixed a bug where MCP tool errors weren't being parsed correctly
4764
4765## 1.0.1
4766
4767- Added `DISABLE_INTERLEAVED_THINKING` to give users the option to opt out of interleaved thinking.
4768- Improved model references to show provider-specific names (Sonnet 3.7 for Bedrock, Sonnet 4 for Console)
4769- Updated documentation links and OAuth process descriptions
4770
4771## 1.0.0
4772
4773- Claude Code is now generally available
4774- Introducing Sonnet 4 and Opus 4 models
4775
4776## 0.2.125
4777
4778- Breaking change: Bedrock ARN passed to `ANTHROPIC_MODEL` or `ANTHROPIC_SMALL_FAST_MODEL` should no longer contain an escaped slash (specify `/` instead of `%2F`)
4779- Removed `DEBUG=true` in favor of `ANTHROPIC_LOG=debug`, to log all requests
4780
4781## 0.2.117
4782
4783- Breaking change: --print JSON output now returns nested message objects, for forwards-compatibility as we introduce new metadata fields
4784- Introduced settings.cleanupPeriodDays
4785- Introduced CLAUDE_CODE_API_KEY_HELPER_TTL_MS env var
4786- Introduced --debug mode
4787
4788## 0.2.108
4789
4790- You can now send messages to Claude while it works to steer Claude in real-time
4791- Introduced BASH_DEFAULT_TIMEOUT_MS and BASH_MAX_TIMEOUT_MS env vars
4792- Fixed a bug where thinking was not working in -p mode
4793- Fixed a regression in /cost reporting
4794- Deprecated MCP wizard interface in favor of other MCP commands
4795- Lots of other bugfixes and improvements
4796
4797## 0.2.107
4798
4799- CLAUDE.md files can now import other files. Add @path/to/file.md to ./CLAUDE.md to load additional files on launch
4800
4801## 0.2.106
4802
4803- MCP SSE server configs can now specify custom headers
4804- Fixed a bug where MCP permission prompt didn't always show correctly
4805
4806## 0.2.105
4807
4808- Claude can now search the web
4809- Moved system & account status to /status
4810- Added word movement keybindings for Vim
4811- Improved latency for startup, todo tool, and file edits
4812
4813## 0.2.102
4814
4815- Improved thinking triggering reliability
4816- Improved @mention reliability for images and folders
4817- You can now paste multiple large chunks into one prompt
4818
4819## 0.2.100
4820
4821- Fixed a crash caused by a stack overflow error
4822- Made db storage optional; missing db support disables --continue and --resume
4823
4824## 0.2.98
4825
4826- Fixed an issue where auto-compact was running twice
4827
4828## 0.2.96
4829
4830- Claude Code can now also be used with a Claude Max subscription (https://claude.ai/upgrade)
4831
4832## 0.2.93
4833
4834- Resume conversations from where you left off from with "claude --continue" and "claude --resume"
4835- Claude now has access to a Todo list that helps it stay on track and be more organized
4836
4837## 0.2.82
4838
4839- Added support for --disallowedTools
4840- Renamed tools for consistency: LSTool -> LS, View -> Read, etc.
4841
4842## 0.2.75
4843
4844- Hit Enter to queue up additional messages while Claude is working
4845- Drag in or copy/paste image files directly into the prompt
4846- @-mention files to directly add them to context
4847- Run one-off MCP servers with `claude --mcp-config <path-to-file>`
4848- Improved performance for filename auto-complete
4849
4850## 0.2.74
4851
4852- Added support for refreshing dynamically generated API keys (via apiKeyHelper), with a 5 minute TTL
4853- Task tool can now perform writes and run bash commands
4854
4855## 0.2.72
4856
4857- Updated spinner to indicate tokens loaded and tool usage
4858
4859## 0.2.70
4860
4861- Network commands like curl are now available for Claude to use
4862- Claude can now run multiple web queries in parallel
4863- Pressing ESC once immediately interrupts Claude in Auto-accept mode
4864
4865## 0.2.69
4866
4867- Fixed UI glitches with improved Select component behavior
4868- Enhanced terminal output display with better text truncation logic
4869
4870## 0.2.67
4871
4872- Shared project permission rules can be saved in .claude/settings.json
4873
4874## 0.2.66
4875
4876- Print mode (-p) now supports streaming output via --output-format=stream-json
4877- Fixed issue where pasting could trigger memory or bash mode unexpectedly
4878
4879## 0.2.63
4880
4881- Fixed an issue where MCP tools were loaded twice, which caused tool call errors
4882
4883## 0.2.61
4884
4885- Navigate menus with vim-style keys (j/k) or bash/emacs shortcuts (Ctrl+n/p) for faster interaction
4886- Enhanced image detection for more reliable clipboard paste functionality
4887- Fixed an issue where ESC key could crash the conversation history selector
4888
4889## 0.2.59
4890
4891- Copy+paste images directly into your prompt
4892- Improved progress indicators for bash and fetch tools
4893- Bugfixes for non-interactive mode (-p)
4894
4895## 0.2.54
4896
4897- Quickly add to Memory by starting your message with '#'
4898- Press ctrl+r to see full output for long tool results
4899- Added support for MCP SSE transport
4900
4901## 0.2.53
4902
4903- New web fetch tool lets Claude view URLs that you paste in
4904- Fixed a bug with JPEG detection
4905
4906## 0.2.50
4907
4908- New MCP "project" scope now allows you to add MCP servers to .mcp.json files and commit them to your repository
4909
4910## 0.2.49
4911
4912- Previous MCP server scopes have been renamed: previous "project" scope is now "local" and "global" scope is now "user"
4913
4914## 0.2.47
4915
4916- Press Tab to auto-complete file and folder names
4917- Press Shift + Tab to toggle auto-accept for file edits
4918- Automatic conversation compaction for infinite conversation length (toggle with /config)
4919
4920## 0.2.44
4921
4922- Ask Claude to make a plan with thinking mode: just say 'think' or 'think harder' or even 'ultrathink'
4923
4924## 0.2.41
4925
4926- MCP server startup timeout can now be configured via MCP_TIMEOUT environment variable
4927- MCP server startup no longer blocks the app from starting up
4928
4929## 0.2.37
4930
4931- New /release-notes command lets you view release notes at any time
4932- `claude config add/remove` commands now accept multiple values separated by commas or spaces
4933
4934## 0.2.36
4935
4936- Import MCP servers from Claude Desktop with `claude mcp add-from-claude-desktop`
4937- Add MCP servers as JSON strings with `claude mcp add-json <n> <json>`
4938
4939## 0.2.34
4940
4941- Vim bindings for text input - enable with /vim or /config
4942
4943## 0.2.32
4944
4945- Interactive MCP setup wizard: Run "claude mcp add" to add MCP servers with a step-by-step interface
4946- Fix for some PersistentShell issues
4947
4948## 0.2.31
4949
4950- Custom slash commands: Markdown files in .claude/commands/ directories now appear as custom slash commands to insert prompts into your conversation
4951- MCP debug mode: Run with --mcp-debug flag to get more information about MCP server errors
4952
4953## 0.2.30
4954
4955- Added ANSI color theme for better terminal compatibility
4956- Fixed issue where slash command arguments weren't being sent properly
4957- (Mac-only) API keys are now stored in macOS Keychain
4958
4959## 0.2.26
4960
4961- New /approved-tools command for managing tool permissions
4962- Word-level diff display for improved code readability
4963- Fuzzy matching for slash commands
4964
4965## 0.2.21
4966
4967- Fuzzy matching for /commands