Compare Versions - anthropics/claude-code
GitHub / anthropics/claude-code / Compare Versions
→
What's changed
- Added
managed-settings.d/drop-in directory alongsidemanaged-settings.json, letting separate teams deploy independent policy fragments that merge alphabetically - Added
CwdChangedandFileChangedhook events for reactive environment management (e.g., direnv) - Added
sandbox.failIfUnavailablesetting to exit with an error when sandbox is enabled but cannot start, instead of running unsandboxed - Added
disableDeepLinkRegistrationsetting to preventclaude-cli://protocol handler registration - Added
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1to strip Anthropic and cloud provider credentials from subprocess environments (Bash tool, hooks, MCP stdio servers) - Added transcript search — press
/in transcript mode (Ctrl+O) to search,n/Nto step through matches - Added
Ctrl+X Ctrl+Eas an alias for opening the external editor (readline-native binding;Ctrl+Gstill works) - Pasted images now insert an
[Image #N]chip at the cursor so you can reference them positionally in your prompt - Agents can now declare
initialPromptin frontmatter to auto-submit a first turn chat:killAgentsandchat:fastModeare now rebindable via~/.claude/keybindings.json- Fixed mouse tracking escape sequences leaking to shell prompt after exit
- Fixed Claude Code hanging on exit on macOS
- Fixed screen flashing blank after being idle for a few seconds
- Fixed a hang when diffing very large files with few common lines — diffs now time out after 5 seconds and fall back gracefully
- Fixed a 1–8 second UI freeze on startup when voice input was enabled, caused by eagerly loading the native audio module
- Fixed a startup regression where Claude Code would wait ~3s for claude.ai MCP config fetch before proceeding
- Fixed
--mcp-configCLI flag bypassingallowedMcpServers/deniedMcpServersmanaged policy enforcement - Fixed claude.ai MCP connectors (Slack, Gmail, etc.) not being available in single-turn
--printmode - Fixed
caffeinateprocess not properly terminating when Claude Code exits, preventing Mac from sleeping - Fixed bash mode not activating when tab-accepting
!-prefixed command suggestions - Fixed stale slash command selection showing wrong highlighted command after navigating suggestions
- Fixed
/configmenu showing both the search cursor and list selection at the same time - Fixed background subagents becoming invisible after context compaction, which could cause duplicate agents to be spawned
- Fixed background agent tasks staying stuck in "running" state when git or API calls hang during cleanup
- Fixed
--channelsshowing "Channels are not currently available" on first launch after upgrade - Fixed uninstalled plugin hooks continuing to fire until the next session
- Fixed queued commands flickering during streaming responses
- Fixed slash commands being sent to the model as text when submitted while a message is processing
- Fixed scrollback jumping when collapsed read/search groups finish after scrolling offscreen
- Fixed scrollback jumping to top when the model starts or stops thinking
- Fixed SDK session history loss on resume caused by hook progress/attachment messages forking the parentUuid chain
- Fixed copy-on-select not firing when you release the mouse outside the terminal window
- Fixed ghost characters appearing in height-constrained lists when items overflow
- Fixed
Ctrl+Binterfering with readline backward-char at an idle prompt — it now only fires when a foreground task can be backgrounded - Fixed tool result files never being cleaned up, ignoring the
cleanupPeriodDayssetting - Fixed space key being swallowed for up to 3 seconds after releasing voice hold-to-talk
- Fixed ALSA library errors corrupting the terminal UI when using voice mode on Linux without audio hardware (Docker, headless, WSL1)
- Fixed voice mode SoX detection on Termux/Android where spawning
whichis kernel-restricted - Fixed Remote Control sessions showing as Idle in the web session list while actively running
- Fixed footer navigation selecting an invisible Remote Control pill in config-driven mode
- Fixed memory leak in remote sessions where tool use IDs accumulate indefinitely
- Improved Bedrock SDK cold-start latency by overlapping profile fetch with other boot work
- Improved
--resumememory usage and startup latency on large sessions - Improved plugin startup — commands, skills, and agents now load from disk cache without re-fetching
- Improved Remote Control session titles: AI-generated titles now appear within seconds of the first message
- Improved
WebFetchto identify asClaude-Userso site operators can recognize and allowlist Claude Code traffic viarobots.txt - Reduced
WebFetchpeak memory usage for large pages - Reduced scrollback resets in long sessions from once per turn to once per ~50 messages
- Faster
claude -pstartup with unauthenticated HTTP/SSE MCP servers (~600ms saved) - Bash ghost-text suggestions now include just-submitted commands immediately
- Increased non-streaming fallback token cap (21k → 64k) and timeout (120s → 300s local) so fallback requests are less likely to be truncated
- Interrupting a prompt before any response now automatically restores your input so you can edit and resubmit
/statusnow works while Claude is responding, instead of being queued until the turn finishes- Plugin MCP servers that duplicate an org-managed connector are now suppressed instead of running a second connection
- Linux: respect
XDG_DATA_HOMEwhen registering theclaude-cli://protocol handler - Changed "stop all background agents" keybinding from
Ctrl+FtoCtrl+X Ctrl+Kto stop shadowing readline forward-char - Deprecated
TaskOutputtool in favor of usingReadon the background task's output file path - [VSCode] Spinner now turns red with "Not responding" when the backend hasn't responded for 60 seconds
- [VSCode] Fixed session history not loading correctly when reopening a session via URL or after restart
What's changed
- Added
--bareflag for scripted-pcalls — skips hooks, LSP, plugin sync, and skill directory walks; requiresANTHROPIC_API_KEYor anapiKeyHelpervia--settings(OAuth and keychain auth disabled); auto-memory fully disabled - Added
--channelspermission relay — channel servers that declare the permission capability can forward tool approval prompts to your phone - Fixed multiple concurrent Claude Code sessions requiring repeated re-authentication when one session refreshes its OAuth token
- Fixed voice mode silently swallowing retry failures and showing a misleading "check your network" message instead of the actual error
- Fixed voice mode audio not recovering when the server silently drops the WebSocket connection
- Fixed
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASnot suppressing the structured-outputs beta header, causing 400 errors on proxy gateways forwarding to Vertex/Bedrock - Fixed
--channelsbypass for Team/Enterprise orgs with no other managed settings configured - Fixed a crash on Node.js 18
- Fixed unnecessary permission prompts for Bash commands containing dashes in strings
- Fixed plugin hooks blocking prompt submission when the plugin directory is deleted mid-session
- Fixed a race condition where background agent task output could hang indefinitely when the task completed between polling intervals
- Resuming a session that was in a worktree now switches back to that worktree
- Fixed
/btwnot including pasted text when used during an active response - Fixed a race where fast Cmd+Tab followed by paste could beat the clipboard copy under tmux
- Fixed terminal tab title not updating with an auto-generated session description
- Fixed invisible hook attachments inflating the message count in transcript mode
- Fixed Remote Control sessions showing a generic title instead of deriving from the first prompt
- Fixed
/renamenot syncing the title for Remote Control sessions - Fixed Remote Control
/exitnot reliably archiving the session - Improved MCP read/search tool calls to collapse into a single "Queried {server}" line (expand with Ctrl+O)
- Improved
!bash mode discoverability — Claude now suggests it when you need to run an interactive command - Improved plugin freshness — ref-tracked plugins now re-clone on every load to pick up upstream changes
- Improved Remote Control session titles to refresh after your third message
- Updated MCP OAuth to support Client ID Metadata Document (CIMD / SEP-991) for servers without Dynamic Client Registration
- Changed plan mode to hide the "clear context" option by default (restore with
"showClearContextOnPlanAccept": true) - Disabled line-by-line response streaming on Windows (including WSL in Windows Terminal) due to rendering issues
- [VSCode] Fixed Windows PATH inheritance for Bash tool when using Git Bash (regression in v2.1.78)
What's changed
- Added
rate_limitsfield to statusline scripts for displaying Claude.ai rate limit usage (5-hour and 7-day windows withused_percentageandresets_at) - Added
source: 'settings'plugin marketplace source — declare plugin entries inline in settings.json - Added CLI tool usage detection to plugin tips, in addition to file pattern matching
- Added
effortfrontmatter support for skills and slash commands to override the model effort level when invoked - Added
--channels(research preview) — allow MCP servers to push messages into your session - Fixed
--resumedropping parallel tool results — sessions with parallel tool calls now restore all tool_use/tool_result pairs instead of showing[Tool result missing]placeholders - Fixed voice mode WebSocket failures caused by Cloudflare bot detection on non-browser TLS fingerprints
- Fixed 400 errors when using fine-grained tool streaming through API proxies, Bedrock, or Vertex
- Fixed
/remote-controlappearing for gateway and third-party provider deployments where it cannot function - Fixed
/sandboxtab switching not responding to Tab or arrow keys - Improved responsiveness of
@file autocomplete in large git repositories - Improved
/effortto show what auto currently resolves to, matching the status bar indicator - Improved
/permissions— Tab and arrow keys now switch tabs from within a list - Improved background tasks panel — left arrow now closes from the list view
- Simplified plugin install tips to use a single
/plugin installcommand instead of a two-step flow - Reduced memory usage on startup in large repositories (~80 MB saved on 250k-file repos)
- Fixed managed settings (
enabledPlugins,permissions.defaultMode, policy-set env vars) not being applied at startup whenremote-settings.jsonwas cached from a prior session
What's changed
- Added
--consoleflag toclaude auth loginfor Anthropic Console (API billing) authentication - Added "Show turn duration" toggle to the
/configmenu - Fixed
claude -phanging when spawned as a subprocess without explicit stdin (e.g. Pythonsubprocess.run) - Fixed Ctrl+C not working in
-p(print) mode - Fixed
/btwreturning the main agent's output instead of answering the side question when triggered during streaming - Fixed voice mode not activating correctly on startup when
voiceEnabled: trueis set - Fixed left/right arrow tab navigation in
/permissions - Fixed
CLAUDE_CODE_DISABLE_TERMINAL_TITLEnot preventing terminal title from being set on startup - Fixed custom status line showing nothing when workspace trust is blocking it
- Fixed enterprise users being unable to retry on rate limit (429) errors
- Fixed
SessionEndhooks not firing when using interactive/resumeto switch sessions - Improved startup memory usage by ~18MB across all scenarios
- Improved non-streaming API fallback with a 2-minute per-attempt timeout, preventing sessions from hanging indefinitely
CLAUDE_CODE_PLUGIN_SEED_DIRnow supports multiple seed directories separated by the platform path delimiter (:on Unix,;on Windows)- [VSCode] Added
/remote-control— bridge your session to claude.ai/code to continue from a browser or phone - [VSCode] Session tabs now get AI-generated titles based on your first message
- [VSCode] Fixed the thinking pill showing "Thinking" instead of "Thought for Ns" after a response completes
- [VSCode] Fixed missing session diff button when opening sessions from the left sidebar
What's changed
- Added
StopFailurehook event that fires when the turn ends due to an API error (rate limit, auth failure, etc.) - Added
${CLAUDE_PLUGIN_DATA}variable for plugin persistent state that survives plugin updates;/plugin uninstallprompts before deleting it - Added
effort,maxTurns, anddisallowedToolsfrontmatter support for plugin-shipped agents - Terminal notifications (iTerm2/Kitty/Ghostty popups, progress bar) now reach the outer terminal when running inside tmux with
set -g allow-passthrough on - Response text now streams line-by-line as it's generated
- Fixed
git log HEADfailing with "ambiguous argument" inside sandboxed Bash on Linux, and stub files pollutinggit statusin the working directory - Fixed
cc logand--resumesilently truncating conversation history on large sessions (>5 MB) that used subagents - Fixed infinite loop when API errors triggered stop hooks that re-fed blocking errors to the model
- Fixed
deny: ["mcp__servername"]permission rules not removing MCP server tools before sending to the model, allowing it to see and attempt blocked tools - Fixed
sandbox.filesystem.allowWritenot working with absolute paths (previously required//prefix) - Fixed
/sandboxDependencies tab showing Linux prerequisites on macOS instead of macOS-specific info - Security: Fixed silent sandbox disable when
sandbox.enabled: trueis set but dependencies are missing — now shows a visible startup warning - Fixed
.git,.claude, and other protected directories being writable without a prompt inbypassPermissionsmode - Fixed ctrl+u in normal mode scrolling instead of readline kill-line (ctrl+u/ctrl+d half-page scroll moved to transcript mode only)
- Fixed voice mode modifier-combo push-to-talk keybindings (e.g. ctrl+k) requiring a hold instead of activating immediately
- Fixed voice mode not working on WSL2 with WSLg (Windows 11); WSL1/Win10 users now get a clear error
- Fixed
--worktreeflag not loading skills and hooks from the worktree directory - Fixed
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONSandincludeGitInstructionssetting not suppressing the git status section in the system prompt - Fixed Bash tool not finding Homebrew and other PATH-dependent binaries when VS Code is launched from Dock/Spotlight
- Fixed washed-out Claude orange color in VS Code/Cursor/code-server terminals that don't advertise truecolor support
- Added
ANTHROPIC_CUSTOM_MODEL_OPTIONenv var to add a custom entry to the/modelpicker, with optional_NAMEand_DESCRIPTIONsuffixed vars for display - Fixed
ANTHROPIC_BETASenvironment variable being silently ignored when using Haiku models - Fixed queued prompts being concatenated without a newline separator
- Improved memory usage and startup time when resuming large sessions
- [VSCode] Fixed a brief flash of the login screen when opening the sidebar while already authenticated
- [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
What's changed
- 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
- Added
allowReadsandbox filesystem setting to re-allow read access withindenyReadregions /copynow accepts an optional index:/copy Ncopies the Nth-latest assistant response- 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 - Fixed auto-updater starting overlapping binary downloads when the slash-command overlay repeatedly opened and closed, accumulating tens of gigabytes of memory
- Fixed
--resumesilently truncating recent conversation history due to a race between memory-extraction writes and the main transcript - Fixed PreToolUse hooks returning
"allow"bypassingdenypermission rules, including enterprise managed settings - Fixed Write tool silently converting line endings when overwriting CRLF files or creating files in CRLF directories
- Fixed memory growth in long-running sessions from progress messages surviving compaction
- Fixed cost and token usage not being tracked when the API falls back to non-streaming mode
- Fixed
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASnot stripping beta tool-schema fields, causing proxy gateways to reject requests - Fixed Bash tool reporting errors for successful commands when the system temp directory path contains spaces
- Fixed paste being lost when typing immediately after pasting
- Fixed Ctrl+D in
/feedbacktext input deleting forward instead of the second press exiting the session - Fixed API error when dragging a 0-byte image file into the prompt
- Fixed Claude Desktop sessions incorrectly using the terminal CLI's configured API key instead of OAuth
- Fixed
git-subdirplugins at different subdirectories of the same monorepo commit colliding in the plugin cache - Fixed ordered list numbers not rendering in terminal UI
- Fixed a race condition where stale-worktree cleanup could delete an agent worktree just resumed from a previous crash
- Fixed input deadlock when opening
/mcpor similar dialogs while the agent is running - Fixed Backspace and Delete keys not working in vim NORMAL mode
- Fixed status line not updating when vim mode is toggled on or off
- Fixed hyperlinks opening twice on Cmd+click in VS Code, Cursor, and other xterm.js-based terminals
- Fixed background colors rendering as terminal-default inside tmux with default configuration
- Fixed iTerm2 session crash when selecting text inside tmux over SSH
- Fixed clipboard copy silently failing in tmux sessions; copy toast now indicates whether to paste with
⌘Vor tmuxprefix+] - Fixed
←/→accidentally switching tabs in settings, permissions, and sandbox dialogs while navigating lists - Fixed IDE integration not auto-connecting when Claude Code is launched inside tmux or screen
- Fixed CJK characters visually bleeding into adjacent UI elements when clipped at the right edge
- Fixed teammate panes not closing when the leader exits
- Fixed iTerm2 auto mode not detecting iTerm2 for native split-pane teammates
- Faster startup on macOS (~60ms) by reading keychain credentials in parallel with module loading
- Faster
--resumeon fork-heavy and very large sessions — up to 45% faster loading and ~100-150MB less peak memory - Improved Esc to abort in-flight non-streaming API requests
- Improved
claude plugin validateto check skill, agent, and command frontmatter plushooks/hooks.json, catching YAML parse errors and schema violations - Background bash tasks are now killed if output exceeds 5GB, preventing runaway processes from filling disk
- Sessions are now auto-named from plan content when you accept a plan
- Improved headless mode plugin installation to compose correctly with
CLAUDE_CODE_PLUGIN_SEED_DIR - Show a notice when
apiKeyHelpertakes longer than 10s, preventing it from blocking the main loop - The Agent tool no longer accepts a
resumeparameter — useSendMessage({to: agentId})to continue a previously spawned agent SendMessagenow auto-resumes stopped agents in the background instead of returning an error- Renamed
/forkto/branch(/forkstill works as an alias) - [VSCode] Improved plan preview tab titles to use the plan's heading instead of "Claude's Plan"
- [VSCode] When option+click doesn't trigger native selection on macOS, the footer now points to the
macOptionClickForcesSelectionsetting
What's changed
- Added MCP elicitation support — MCP servers can now request structured input mid-task via an interactive dialog (form fields or browser URL)
- Added new
ElicitationandElicitationResulthooks to intercept and override responses before they're sent back - Added
-n/--name <name>CLI flag to set a display name for the session at startup - Added
worktree.sparsePathssetting forclaude --worktreein large monorepos to check out only the directories you need via git sparse-checkout - Added
PostCompacthook that fires after compaction completes - Added
/effortslash command to set model effort level - Added session quality survey — enterprise admins can configure the sample rate via the
feedbackSurveyRatesetting - Fixed deferred tools (loaded via
ToolSearch) losing their input schemas after conversation compaction, causing array and number parameters to be rejected with type errors - Fixed slash commands showing "Unknown skill"
- Fixed plan mode asking for re-approval after the plan was already accepted
- Fixed voice mode swallowing keypresses while a permission dialog or plan editor was open
- Fixed
/voicenot working on Windows when installed via npm - Fixed spurious "Context limit reached" when invoking a skill with
model:frontmatter on a 1M-context session - Fixed "adaptive thinking is not supported on this model" error when using non-standard model strings
- Fixed
Bash(cmd:*)permission rules not matching when a quoted argument contains# - Fixed "don't ask again" in the Bash permission dialog showing the full raw command for pipes and compound commands
- Fixed auto-compaction retrying indefinitely after consecutive failures — a circuit breaker now stops after 3 attempts
- Fixed MCP reconnect spinner persisting after successful reconnection
- Fixed LSP plugins not registering servers when the LSP Manager initialized before marketplaces were reconciled
- Fixed clipboard copying in tmux over SSH — now attempts both direct terminal write and tmux clipboard integration
- Fixed
/exportshowing only the filename instead of the full file path in the success message - Fixed transcript not auto-scrolling to new messages after selecting text
- Fixed Escape key not working to exit the login method selection screen
- 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
- Fixed bridge sessions failing to recover after extended WebSocket disconnects
- Fixed slash commands not found when typing the exact name of a soft-hidden command
- Improved
--worktreestartup performance by reading git refs directly and skipping redundantgit fetchwhen the remote branch is already available locally - Improved background agent behavior — killing a background agent now preserves its partial results in the conversation context
- Improved model fallback notifications — now always visible instead of hidden behind verbose mode, with human-friendly model names
- Improved blockquote readability on dark terminal themes — text is now italic with a left bar instead of dim
- Improved stale worktree cleanup — worktrees left behind after an interrupted parallel run are now automatically cleaned up
- Improved Remote Control session titles — now derived from your first prompt instead of showing "Interactive session"
- Improved
/voiceto show your dictation language on enable and warn when yourlanguagesetting isn't supported for voice input - Updated
--plugin-dirto only accept one path to support subcommands — use repeated--plugin-dirfor multiple directories - [VSCode] Fixed gitignore patterns containing commas silently excluding entire filetypes from the @-mention file picker
What's changed
- Added actionable suggestions to
/contextcommand — identifies context-heavy tools, memory bloat, and capacity warnings with specific optimization tips - Added
autoMemoryDirectorysetting to configure a custom directory for auto-memory storage - 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
- Fixed managed policy
askrules being bypassed by userallowrules or skillallowed-tools - Fixed full model IDs (e.g.,
claude-opus-4-5) being silently ignored in agent frontmattermodel:field and--agentsJSON config — agents now accept the same model values as--model - Fixed MCP OAuth authentication hanging when the callback port is already in use
- 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)
- 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-inputentitlement so macOS prompts correctly - Fixed
SessionEndhooks being killed after 1.5 s on exit regardless ofhook.timeout— now configurable viaCLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS - Fixed
/plugin installfailing inside the REPL for marketplace plugins with local sources - Fixed marketplace update not syncing git submodules — plugin sources in submodules no longer break after update
- Fixed unknown slash commands with arguments silently dropping input — now shows your input as a warning
- Fixed Hebrew, Arabic, and other RTL text not rendering correctly in Windows Terminal, conhost, and VS Code integrated terminal
- Fixed LSP servers not working on Windows due to malformed file URIs
- Changed
--plugin-dirso local dev copies now override installed marketplace plugins with the same name (unless that plugin is force-enabled by managed settings) - [VSCode] Fixed delete button not working for Untitled sessions
- [VSCode] Improved scroll wheel responsiveness in the integrated terminal with terminal-aware acceleration
What's changed
- Added
modelOverridessetting to map model picker entries to custom provider model IDs (e.g. Bedrock inference profile ARNs) - Added actionable guidance when OAuth login or connectivity checks fail due to SSL certificate errors (corporate proxies,
NODE_EXTRA_CA_CERTS) - Fixed freezes and 100% CPU loops triggered by permission prompts for complex bash commands
- Fixed a deadlock that could freeze Claude Code when many skill files changed at once (e.g. during
git pullin a repo with a large.claude/skills/directory) - Fixed Bash tool output being lost when running multiple Claude Code sessions in the same project directory
- Fixed subagents with
model: opus/sonnet/haikubeing silently downgraded to older model versions on Bedrock, Vertex, and Microsoft Foundry - Fixed background bash processes spawned by subagents not being cleaned up when the agent exits
- Fixed
/resumeshowing the current session in the picker - Fixed
/idecrashing withonInstall is not definedwhen auto-installing the extension - Fixed
/loopnot being available on Bedrock/Vertex/Foundry and when telemetry was disabled - Fixed SessionStart hooks firing twice when resuming a session via
--resumeor--continue - Fixed JSON-output hooks injecting no-op system-reminder messages into the model's context on every turn
- Fixed voice mode session corruption when a slow connection overlaps a new recording
- Fixed Linux sandbox failing to start with "ripgrep (rg) not found" on native builds
- Fixed Linux native modules not loading on Amazon Linux 2 and other glibc 2.26 systems
- Fixed "media_type: Field required" API error when receiving images via Remote Control
- Fixed
/heapdumpfailing on Windows withEEXISTerror when the Desktop folder already exists - Improved Up arrow after interrupting Claude — now restores the interrupted prompt and rewinds the conversation in one step
- Improved IDE detection speed at startup
- Improved clipboard image pasting performance on macOS
- Improved
/effortto work while Claude is responding, matching/modelbehavior - Improved voice mode to automatically retry transient connection failures during rapid push-to-talk re-press
- Improved the Remote Control spawn mode selection prompt with better context
- Changed default Opus model on Bedrock, Vertex, and Microsoft Foundry to Opus 4.6 (was Opus 4.1)
- Deprecated
/output-stylecommand — use/configinstead. Output style is now fixed at session start for better prompt caching - VSCode: Fixed HTTP 400 errors for users behind proxies or on Bedrock/Vertex with Claude 4.5 models
What's changed
- Changed tool search to bypass the third-party proxy gate when the environment variable is set (replaces
CLAUDE_CODE_PROXY_SUPPORTS_TOOL_REFERENCE, now removed) - Added
wkey in/copyto write the focused selection directly to a file, bypassing the clipboard (useful over SSH) - Added optional description argument to
/plan(e.g.,/plan fix the auth bug) that enters plan mode and immediately starts - Added
claude pluginsas an alias forclaude plugin - Added
ExitWorktreetool to leave anEnterWorktreesession - Added
CLAUDE_CODE_DISABLE_CRONenvironment variable to immediately stop scheduled cron jobs mid-session - Added
lsof,pgrep,tput,ss,fd, andfdfindto the bash auto-approval allowlist, reducing permission prompts for common read-only operations - Added support for marketplace git URLs without
.gitsuffix (Azure DevOps, AWS CodeCommit) - Restored the
modelparameter on the Agent tool for per-invocation model overrides - Simplified effort levels to low/medium/high (removed max) with new symbols (○ ◐ ●) and a brief notification instead of a persistent icon. Use
/effort autoto reset to default - Improved
/config— Escape now cancels changes, Enter saves and closes, Space toggles settings - Improved up-arrow history to show current session's messages first when running multiple concurrent sessions
- Improved voice input transcription accuracy for repo names and common dev terms (regex, OAuth, JSON)
- Improved marketplace clone failure messages to show diagnostic info even when git produces no stderr
- Improved
claude plugin validateto explain that marketplace.json source paths are relative to the repo root when rejecting../paths - Improved bash command parsing by switching to a native module — faster initialization and no memory leak
- Reduced false-positive bash permission prompts — tree-sitter parsing now handles
find -exec, variable assignments, command substitutions, and many other patterns that previously triggered unnecessary prompts. Also fixed tree-sitter not loading in npm-installed versions - Reduced bundle size by ~510 KB
- Changed CLAUDE.md HTML comments (
<!-- ... -->) to be hidden from Claude when auto-injected. Comments remain visible when read with the Read tool - Fixed slow exits when background tasks or hooks were slow to respond
- Fixed agent task progress stuck on "Initializing…"
- Fixed skill hooks firing twice per event when a hooks-enabled skill is invoked by the model
- 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
- Fixed
--continuenot resuming from the most recent point after--compact - Fixed bash security parsing edge cases
- Fixed several plugin issues: installation failing on Windows with
EEXISTerror in OneDrive folders, marketplace blocking user-scope installs when a project-scope install exists,CLAUDE_CODE_PLUGIN_CACHE_DIRcreating literal~directories, andplugin.jsonwith marketplace-only fields failing to load - Fixed feedback survey appearing too frequently in long sessions
- Fixed
--effortCLI flag being reset by unrelated settings writes on startup - Fixed backgrounded Ctrl+B queries losing their transcript or corrupting the new conversation after
/clear - Fixed
/clearkilling background agent/bash tasks — only foreground tasks are now cleared - Fixed worktree isolation issues: Task tool resume not restoring cwd, and background task notifications missing
worktreePathandworktreeBranch - Fixed
/modelnot displaying results when run while Claude is working - Fixed digit keys selecting menu options instead of typing in plan mode permission prompt's text input
- Fixed sandbox permission issues: certain file write operations incorrectly allowed without prompting, and output redirections to allowlisted directories (like
/tmp/claude/) prompting unnecessarily - Improved CPU utilization in long sessions
- Fixed prompt cache invalidation in SDK
query()calls, reducing input token costs up to 12x - Fixed Escape key becoming unresponsive after cancelling a query
- Fixed double Ctrl+C not exiting when background agents or tasks are running
- Fixed team agents to inherit the leader's model
- Fixed "Always Allow" saving permission rules that never match again
- Fixed several hooks issues:
transcript_pathpointing to the wrong directory for resumed/forked sessions, agentpromptbeing silently deleted from settings.json on every settings write, PostToolUse block reason displaying twice, async hooks not receiving stdin with bashread -r, and validation error message showing an example that fails validation - Fixed session crashes in Desktop/SDK when Read returned files containing U+2028/U+2029 characters
- Fixed terminal title being cleared on exit even when
CLAUDE_CODE_DISABLE_TERMINAL_TITLEwas set - Fixed several permission rule matching issues: wildcard rules not matching commands with heredocs, embedded newlines, or no arguments;
sandbox.excludedCommandsfailing with env var prefixes; "always allow" suggesting overly broad prefixes for nested CLI tools; and deny rules not applying to all command forms - Fixed oversized and truncated images from Bash data-URL output
- Fixed a crash when resuming sessions that contained Bedrock API errors
- Fixed intermittent "expected boolean, received string" validation errors on Edit, Bash, and Grep tool inputs
- Fixed multi-line session titles when forking from a conversation whose first message contained newlines
- Fixed queued messages not showing attached images, and images being lost when pressing ↑ to edit a queued message
- Fixed parallel tool calls where a failed Read/WebFetch/Glob would cancel its siblings — only Bash errors now cascade
- VSCode: Fixed scroll speed in integrated terminals not matching native terminals
- VSCode: Fixed Shift+Enter submitting input instead of inserting a newline for users with older keybindings
- VSCode: Added effort level indicator on the input border
- VSCode: Added
vscode://anthropic.claude-code/openURI handler to open a new Claude Code tab programmatically, with optionalpromptandsessionquery parameters
What's changed
- Added
/loopcommand to run a prompt or slash command on a recurring interval (e.g./loop 5m check the deploy) - Added cron scheduling tools for recurring prompts within a session
- Added
voice:pushToTalkkeybinding to make the voice activation key rebindable inkeybindings.json(default: space) — modifier+letter combos likemeta+khave zero typing interference - Added
fmt,comm,cmp,numfmt,expr,test,printf,getconf,seq,tsort, andprto the bash auto-approval allowlist - Fixed stdin freeze in long-running sessions where keystrokes stop being processed but the process stays alive
- Fixed a 5–8 second startup freeze for users with voice mode enabled, caused by CoreAudio initialization blocking the main thread after system wake
- Fixed startup UI freeze when many claude.ai proxy connectors refresh an expired OAuth token simultaneously
- Fixed forked conversations (
/fork) sharing the same plan file, which caused plan edits in one fork to overwrite the other - Fixed the Read tool putting oversized images into context when image processing failed, breaking subsequent turns in long image-heavy sessions
- Fixed false-positive permission prompts for compound bash commands containing heredoc commit messages
- Fixed plugin installations being lost when running multiple Claude Code instances
- Fixed claude.ai connectors failing to reconnect after OAuth token refresh
- Fixed claude.ai MCP connector startup notifications appearing for every org-configured connector instead of only previously connected ones
- Fixed background agent completion notifications missing the output file path, which made it difficult for parent agents to recover agent results after context compaction
- Fixed duplicate output in Bash tool error messages when commands exit with non-zero status
- Fixed Chrome extension auto-detection getting permanently stuck on "not installed" after running on a machine without local Chrome
- Fixed
/plugin marketplace updatefailing with merge conflicts when the marketplace is pinned to a branch/tag ref - Fixed
/plugin marketplace add owner/repo@refincorrectly parsing@— previously only#worked as a ref separator, causing undiagnosable errors withstrictKnownMarketplaces - Fixed duplicate entries in
/permissionsWorkspace tab when the same directory is added with and without a trailing slash - Fixed
--printhanging forever when team agents are configured — the exit loop no longer waits on long-livedin_process_teammatetasks - Fixed "❯ Tool loaded." appearing in the REPL after every
ToolSearchcall - Fixed prompting for
cd <cwd> && git ...on Windows when the model uses a mingw-style path - Improved startup time by deferring native image processor loading to first use
- Improved bridge session reconnection to complete within seconds after laptop wake from sleep, instead of waiting up to 10 minutes
- Improved
/plugin uninstallto disable project-scoped plugins in.claude/settings.local.jsoninstead of modifying.claude/settings.json, so changes don't affect teammates - 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
/pluginmenu. - Updated
/debugto toggle debug logging on mid-session, since debug logs are no longer written by default - Removed startup notification noise for unauthenticated org-registered claude.ai connectors
What's changed
- Fixed API 400 errors when using
ANTHROPIC_BASE_URLwith a third-party gateway — tool search now correctly detects proxy endpoints and disablestool_referenceblocks - Fixed
API Error: 400 This model does not support the effort parameterwhen using custom Bedrock inference profiles or other model identifiers not matching standard Claude naming patterns - 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 - Fixed prompt-cache bust when an MCP server with
instructionsconnects after the first turn - Fixed Enter inserting a newline instead of submitting when typing over a slow SSH connection
- Fixed clipboard corrupting non-ASCII text (CJK, emoji) on Windows/WSL by using PowerShell
Set-Clipboard - Fixed extra VS Code windows opening at startup on Windows when running from the VS Code integrated terminal
- Fixed voice mode failing on Windows native binary with "native audio module could not be loaded"
- Fixed push-to-talk not activating on session start when
voiceEnabled: truewas set in settings - Fixed markdown links containing
#NNNreferences incorrectly pointing to the current repository instead of the linked URL - Fixed repeated "Model updated to Opus 4.6" notification when a project's
.claude/settings.jsonhas a legacy Opus model string pinned - Fixed plugins showing as inaccurately installed in
/plugin - Fixed plugins showing "not found in marketplace" errors on fresh startup by auto-refreshing after marketplace installation
- Fixed
/security-reviewcommand failing withunknown option merge-baseon older git versions - Fixed
/colorcommand having no way to reset back to the default color —/color default,/color gray,/color reset, and/color nonenow restore the default - Fixed a performance regression in the
AskUserQuestionpreview dialog that re-ran markdown rendering on every keystroke in the notes input - Fixed feature flags read during early startup never refreshing their disk cache, causing stale values to persist across sessions
- Fixed
permissions.defaultModesettings values other thanacceptEditsorplanbeing applied in Claude Code Remote environments — they are now ignored - Fixed skill listing being re-injected on every
--resume(~600 tokens saved per resume) - Fixed teleport marker not rendering in VS Code teleported sessions
- Improved error message when microphone captures silence to distinguish from "no speech detected"
- Improved compaction to preserve images in the summarizer request, allowing prompt cache reuse for faster and cheaper compaction
- Improved
/renameto work while Claude is processing, instead of being silently queued - Reduced prompt input re-renders during turns by ~74%
- Reduced startup memory by ~426KB for users without custom CA certificates
- Reduced Remote Control
/pollrate to once per 10 minutes while connected (was 1–2s), cutting server load ~300×. Reconnection is unaffected — transport loss immediately wakes fast polling. - [VSCode] Added spark icon in VS Code activity bar that lists all Claude Code sessions, with sessions opening as full editors
- [VSCode] Added full markdown document view for plans in VS Code, with support for adding comments to provide feedback
- [VSCode] Added native MCP server management dialog — use
/mcpin the chat panel to enable/disable servers, reconnect, and manage OAuth authentication without switching to the terminal
What's changed
- Added the
/claude-apiskill for building applications with the Claude API and Anthropic SDK - Added Ctrl+U on an empty bash prompt (
!) to exit bash mode, matchingescapeandbackspace - Added numeric keypad support for selecting options in Claude's interview questions (previously only the number row above QWERTY worked)
- Added optional name argument to
/remote-controlandclaude remote-control(/remote-control My Projector--name "My Project") to set a custom session title visible in claude.ai/code - Added Voice STT support for 10 new languages (20 total) — Russian, Polish, Turkish, Dutch, Ukrainian, Greek, Czech, Danish, Swedish, Norwegian
- Added effort level display (e.g., "with low effort") to the logo and spinner, making it easier to see which effort setting is active
- Added agent name display in terminal title when using
claude --agent - Added
sandbox.enableWeakerNetworkIsolationsetting (macOS only) to allow Go programs likegh,gcloud, andterraformto verify TLS certificates when using a custom MITM proxy withhttpProxyPort - Added
includeGitInstructionssetting (andCLAUDE_CODE_DISABLE_GIT_INSTRUCTIONSenv var) to remove built-in commit and PR workflow instructions from Claude's system prompt - Added
/reload-pluginscommand to activate pending plugin changes without restarting - Added a one-time startup prompt suggesting Claude Code Desktop on macOS and Windows (max 3 showings, dismissible)
- Added
${CLAUDE_SKILL_DIR}variable for skills to reference their own directory in SKILL.md content - Added
InstructionsLoadedhook event that fires when CLAUDE.md or.claude/rules/*.mdfiles are loaded into context - Added
agent_id(for subagents) andagent_type(for subagents and--agent) to hook events - Added
worktreefield to status line hook commands with name, path, branch, and original repo directory when running in a--worktreesession - Added
pluginTrustMessagein managed settings to append organization-specific context to the plugin trust warning shown before installation - Added policy limit fetching (e.g., remote control restrictions) for Team plan OAuth users, not just Enterprise
- Added
pathPatterntostrictKnownMarketplacesfor regex-matching file/directory marketplace sources alongsidehostPatternrestrictions - Added plugin source type
git-subdirto point to a subdirectory within a git repo - Added
oauth.authServerMetadataUrlconfig option for MCP servers to specify a custom OAuth metadata discovery URL when standard discovery fails - Fixed a security issue where nested skill discovery could load skills from gitignored directories like
node_modules - Fixed trust dialog silently enabling all
.mcp.jsonservers on first run. You'll now see the per-server approval dialog as expected - Fixed
claude remote-controlcrashing immediately on npm installs with "bad option: --sdk-url" (anthropics/claude-code#28334) - Fixed
--model claude-opus-4-0and--model claude-opus-4-1resolving to deprecated Opus versions instead of current - Fixed macOS keychain corruption when using multiple OAuth MCP servers. Large OAuth metadata blobs could overflow the
security -istdin buffer, silently leaving stale credentials behind and causing repeated/loginprompts. - Fixed
.credentials.jsonlosingsubscriptionType(showing "Claude API" instead of "Claude Pro"/"Claude Max") when the profile endpoint transiently fails during token refresh (anthropics/claude-code#30185) - Fixed ghost dotfiles (
.bashrc,HEAD, etc.) appearing as untracked files in the working directory after sandboxed Bash commands on Linux - Fixed Shift+Enter printing
[27;2;13~instead of inserting a newline in Ghostty over SSH - Fixed stash (Ctrl+S) being cleared when submitting a message while Claude is working
- Fixed ctrl+o (transcript toggle) freezing for many seconds in long sessions with lots of file edits
- Fixed plan mode feedback input not supporting multi-line text entry (backslash+Enter and Shift+Enter now insert newlines)
- Fixed cursor not moving down into blank lines at the top of the input box
- Fixed
/statscrash when transcript files contain entries with missing or malformed timestamps - 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)
- Fixed
--setting-sources usernot blocking dynamically discovered project skills - Fixed duplicate CLAUDE.md, slash commands, agents, and rules when running from a worktree nested inside its main repo (e.g.
claude -w) - Fixed plugin Stop/SessionEnd/etc hooks not firing after any
/pluginoperation - Fixed plugin hooks being silently dropped when two plugins use the same
${CLAUDE_PLUGIN_ROOT}/...command template - Fixed memory leak in long-running SDK/CCR sessions where conversation messages were retained unnecessarily
- Fixed API 400 errors in forked agents (autocompact, summarization) when resuming sessions that were interrupted mid-tool-batch
- Fixed "unexpected tool_use_id found in tool_result blocks" error when resuming conversations that start with an orphaned tool result
- Fixed teammates accidentally spawning nested teammates via the Agent tool's
nameparameter - Fixed
CLAUDE_CODE_MAX_OUTPUT_TOKENSbeing ignored during conversation compaction - Fixed
/compactsummary rendering as a user bubble in SDK consumers (Claude Code Remote web UI, VSCode extension) - Fixed voice space bar getting stuck after a failed voice activation (module loading race, cold GrowthBook)
- Fixed worktree file copy on Windows
- Fixed global
.claudefolder detection on Windows - Fixed symlink bypass where writing new files through a symlinked parent directory could escape the working directory in
acceptEditsmode - Fixed sandbox prompting users to approve non-allowed domains when
allowManagedDomainsOnlyis enabled in managed settings — non-allowed domains are now blocked automatically with no bypass - 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 - Fixed multi-GB memory spike when committing with large untracked binary files in the working tree
- 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.
- Fixed Android app crash when running local slash commands (
/voice,/cost) in Remote Control sessions - Fixed a memory leak where old message array versions accumulated in React Compiler
memoCacheover long sessions - Fixed a memory leak where REPL render scopes accumulated over long sessions (~35MB over 1000 turns)
- Fixed memory retention in in-process teammates where the parent's full conversation history was pinned for the teammate's lifetime, preventing GC after
/clearor auto-compact - Fixed a memory leak in interactive mode where hook events could accumulate unboundedly during long sessions
- Fixed hang when
--mcp-configpoints to a corrupted file - Fixed slow startup when many skills/plugins are installed
- Fixed
cd <outside-dir> && <cmd>permission prompt to surface the chained command instead of only showing "Yes, allow reading from/" - Fixed conditional
.claude/rules/*.mdfiles (withpaths:frontmatter) and nested CLAUDE.md files not loading in print mode (claude -p) - Fixed
/clearnot fully clearing all session caches, reducing memory retention in long sessions - Fixed terminal flicker caused by animated elements at the scrollback boundary
- Fixed UI frame drops on macOS when using MCP servers with OAuth (regression from 2.1.x)
- Fixed occasional frame stalls during typing caused by synchronous debug log flushes
- Fixed
TeammateIdleandTaskCompletedhooks to support{"continue": false, "stopReason": "..."}to stop the teammate, matchingStophook behavior - Fixed
WorktreeCreateandWorktreeRemoveplugin hooks being silently ignored - Fixed skill descriptions with colons (e.g., "Triggers include: X, Y, Z") failing to load from SKILL.md frontmatter
- Fixed project skills without a
description:frontmatter field not appearing in Claude's available skills list - Fixed
/contextshowing identical token counts for all MCP tools from a server - Fixed literal
nulfile creation on Windows when the model uses CMD-style2>nulredirection in Git Bash - Fixed extra blank lines appearing below each tool call in the expanded subagent transcript view (Ctrl+O)
- Fixed Tab/arrow keys not cycling Settings tabs when
/configsearch box is focused but empty - Fixed service key OAuth sessions (CCR containers) spamming
[ERROR]logs with 403s from profile-scoped endpoints - Fixed inconsistent color for "Remote Control active" status indicator
- Fixed Voice waveform cursor covering the first suffix letter when dictating mid-input
- Fixed Voice input showing all 5 spaces during warmup instead of capping at ~2 (aligning with the "keep holding…" hint)
- Improved spinner performance by isolating the 50ms animation loop from the surrounding shell, reducing render and CPU overhead during turns
- Improved UI rendering performance in native binaries with React Compiler
- Improved
--worktreestartup by eliminating a git subprocess on the startup path - Improved macOS startup by eliminating redundant settings-file reloads when managed settings resolve
- Improved macOS startup for Claude.ai enterprise/team users by skipping an unnecessary keychain lookup
- Improved MCP
-pstartup by pipelining claude.ai config fetch with local connections and using a concurrency pool instead of sequential batching - Improved voice startup by removing imperceptible warmup pulse animations that were causing re-render stutter
- 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.
- Improved memory usage in long sessions by stabilizing
onSubmitacross message updates - Improved LSP tool rendering and memory context building to no longer read entire files
- Improved session upload and memory sync to avoid reading large files into memory before size/binary checks
- Improved file operation performance by avoiding reading file contents for existence checks (6 sites)
- Improved documentation to clarify that
--append-system-prompt-fileand--system-prompt-filework in interactive mode (the docs previously said print mode only) - Reduced baseline memory by ~16MB by deferring Yoga WASM preloading
- Reduced memory footprint for SDK and CCR sessions using stream-json output
- Reduced memory usage when resuming large sessions (including compacted history)
- Reduced token usage on multi-agent tasks with more concise subagent final reports
- Changed Sonnet 4.5 users on Pro/Max/Team Premium to be automatically migrated to Sonnet 4.6
- Changed the
/resumepicker to show your most recent prompt instead of the first one. This also resolves some titles appearing as(session). - Changed claude.ai MCP connector failures to show a notification instead of silently disappearing from the tool list
- Changed example command suggestions to be generated deterministically instead of calling Haiku
- Changed resuming after compaction to no longer produce a preamble recap before continuing
- [SDK] Changed task creation to no longer require the
activeFormfield — the spinner falls back to the task subject - [VSCode] Added compaction display as a collapsible "Compacted chat" card with the summary inside
- [VSCode] The permission mode picker now respects
permissions.disableBypassPermissionsModefrom your effective Claude Code settings (including managed/policy settings) — when set todisable, bypass permissions mode is hidden from the picker - [VSCode] Fixed RTL text (Arabic, Hebrew, Persian) rendering reversed in the chat panel (regression in v2.1.63)
What's changed
- 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 - Re-introduced the "ultrathink" keyword to enable high effort for the next turn
- 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
What's changed
- Added
/simplifyand/batchbundled slash commands - Fixed local slash command output like /cost appearing as user-sent messages instead of system messages in the UI
- Project configs & auto memory now shared across git worktrees of the same repository
- Added
ENABLE_CLAUDEAI_MCP_SERVERS=falseenv var to opt out from making claude.ai MCP servers available - Improved
/modelcommand to show the currently active model in the slash command menu - Added HTTP hooks, which can POST JSON to a URL and receive JSON instead of running a shell command
- Fixed listener leak in bridge polling loop
- Fixed listener leak in MCP OAuth flow cleanup
- 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.
- Fixed memory leak when navigating hooks configuration menu
- Fixed listener leak in interactive permission handler during auto-approvals
- Fixed file count cache ignoring glob ignore patterns
- Fixed memory leak in bash command prefix cache
- Fixed MCP tool/resource cache leak on server reconnect
- Fixed IDE host IP detection cache incorrectly sharing results across ports
- Fixed WebSocket listener leak on transport reconnect
- Fixed memory leak in git root detection cache that could cause unbounded growth in long-running sessions
- Fixed memory leak in JSON parsing cache that grew unbounded over long sessions
- VSCode: Fixed remote sessions not appearing in conversation history
- 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.
- Fixed memory leak where long-running teammates retained all messages in AppState even after conversation compaction
- Fixed a memory leak where MCP server fetch caches were not cleared on disconnect, causing growing memory usage with servers that reconnect frequently
- Improved memory usage in long sessions with subagents by stripping heavy progress message payloads during context compaction
- Added "Always copy full response" option to the
/copypicker. When selected, future/copycommands will skip the code block picker and copy the full response directly. - VSCode: Added session rename and remove actions to the sessions list
- Fixed
/clearnot resetting cached skills, which could cause stale skill content to persist in the new conversation
What's changed
- Fixed prompt suggestion cache regression that reduced cache hit rates
What's changed
- Fixed concurrent writes corrupting config file on Windows
What's changed
- Claude automatically saves useful context to auto-memory. Manage with /memory
- Added
/copycommand to show an interactive picker when code blocks are present, allowing selection of individual code blocks or the full response. - 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 - Improved ordering of short task lists
- Improved memory usage in multi-agent sessions by releasing completed subagent task state
- Fixed MCP OAuth token refresh race condition when running multiple Claude Code instances simultaneously
- Fixed shell commands not showing a clear error message when the working directory has been deleted
What's changed
- Expand Remote Control to more users
What's changed
- VS Code: Fixed another cause of "command 'claude-vscode.editor.openLast' not found" crashes
What's changed
- Fixed BashTool failing on Windows with EINVAL error
What's changed
- Fixed a UI flicker where user input would briefly disappear after submission before the message rendered
- Fixed bulk agent kill (ctrl+f) to send a single aggregate notification instead of one per agent, and to properly clear the command queue
- Fixed graceful shutdown sometimes leaving stale sessions when using Remote Control by parallelizing teardown network calls
- Fixed
--worktreesometimes being ignored on first launch - Fixed a panic ("switch on corrupted value") on Windows
- Fixed a crash that could occur when spawning many processes on Windows
- Fixed a crash in the WebAssembly interpreter on Linux x64 & Windows x64
- Fixed a crash that sometimes occurred after 2 minutes on Windows ARM64
What's changed
- VS Code: Fixed extension crash on Windows ("command 'claude-vscode.editor.openLast' not found")
What's changed
- Added
claude remote-controlsubcommand for external builds, enabling local environment serving for all users. - Updated plugin marketplace default git timeout from 30s to 120s and added
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MSto configure. - Added support for custom npm registries and specific version pinning when installing plugins from npm sources
- BashTool now skips login shell (
-lflag) by default when a shell snapshot is available, improving command execution performance. Previously this required settingCLAUDE_BASH_NO_LOGIN=true. - Fixed a security issue where
statusLineandfileSuggestionhook commands could execute without workspace trust acceptance in interactive mode. - Tool results larger than 50K characters are now persisted to disk (previously 100K). This reduces context window usage and improves conversation longevity.
- Fixed a security issue where HTTP hooks could interpolate arbitrary environment variables from header values. Env var interpolation now requires an explicit
allowedEnvVarslist in the hook configuration. - Fixed a bug where duplicate
control_responsemessages (e.g. from WebSocket reconnects) could cause API 400 errors by pushing duplicate assistant messages into the conversation. - Added
CLAUDE_CODE_ACCOUNT_UUID,CLAUDE_CODE_USER_EMAIL, andCLAUDE_CODE_ORGANIZATION_UUIDenvironment variables for SDK callers to provide account info synchronously, eliminating a race condition where early telemetry events lacked account metadata. - Fixed slash command autocomplete crashing when a plugin's SKILL.md description is a YAML array or other non-string type
- HTTP hooks are now routed through the sandbox network proxy when sandboxing is enabled, enforcing the domain allowlist. HTTP hooks are not supported for SessionStart/Setup events.
- The
/modelpicker 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.
What's changed
- Added support for
startupTimeoutconfiguration for LSP servers - Added
WorktreeCreateandWorktreeRemovehook events, enabling custom VCS setup and teardown when agent worktree isolation creates or removes worktrees. - 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.
- Linux: Fixed native modules not loading on systems with glibc older than 2.30 (e.g., RHEL 8)
- Fixed memory leak in agent teams where completed teammate tasks were never garbage collected from session state
- Fixed
CLAUDE_CODE_SIMPLEto fully strip down skills, session memory, custom agents, and CLAUDE.md token counting - Fixed
/mcp reconnectfreezing the CLI when given a server name that doesn't exist - Fixed memory leak where completed task state objects were never removed from AppState
- Added support for
isolation: worktreein agent definitions, allowing agents to declaratively run in isolated git worktrees. CLAUDE_CODE_SIMPLEmode now also disables MCP tools, attachments, hooks, and CLAUDE.md file loading for a fully minimal experience.- Fixed bug where MCP tools were not discovered when tool search is enabled and a prompt is passed in as a launch argument
- Improved memory usage during long sessions by clearing internal caches after compaction
- Added
claude agentsCLI command to list all configured agents - Improved memory usage during long sessions by clearing large tool results after they have been processed
- Fixed a memory leak where LSP diagnostic data was never cleaned up after delivery, causing unbounded memory growth in long sessions
- Fixed a memory leak where completed task output was not freed from memory, reducing memory usage in long sessions with many tasks
- Improved startup performance for headless mode (
-pflag) by deferring Yoga WASM and UI component imports - Fixed prompt suggestion cache regression that reduced cache hit rates
- Fixed unbounded memory growth in long sessions by capping file history snapshots
- Added
CLAUDE_CODE_DISABLE_1M_CONTEXTenvironment variable to disable 1M context window support - Opus 4.6 (fast mode) now includes the full 1M context window
- VSCode: Added
/extra-usagecommand support in VS Code sessions - Fixed memory leak where TaskOutput retained recent lines after cleanup
- Fixed memory leak in CircularBuffer where cleared items were retained in the backing array
- Fixed memory leak in shell command execution where ChildProcess and AbortController references were retained after cleanup
What's changed
- 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.
- Fixed prompt suggestion cache regression that reduced cache hit rates.
- Fixed
plugin enableandplugin disableto auto-detect the correct scope when--scopeis not specified, instead of always defaulting to user scope - Simple mode (
CLAUDE_CODE_SIMPLE) now includes the file edit tool in addition to the Bash tool, allowing direct file editing in simple mode. - Permission suggestions are now populated when safety checks trigger an ask response, enabling SDK consumers to display permission options
- 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.
- Fixed verbose mode not updating thinking block display when toggled via
/config— memo comparators now correctly detect verbose changes - Fixed unbounded WASM memory growth during long sessions by periodically resetting the tree-sitter parser
- Fixed potential rendering issues caused by stale yoga layout references
- Improved performance in non-interactive mode (
-p) by skipping unnecessary API calls during startup - Improved performance by caching authentication failures for HTTP and SSE MCP servers, avoiding repeated connection attempts to servers requiring auth
- Fixed unbounded memory growth during long-running sessions caused by Yoga WASM linear memory never shrinking
- SDK model info now includes
supportsEffort,supportedEffortLevels, andsupportsAdaptiveThinkingfields so consumers can discover model capabilities. - Added
ConfigChangehook event that fires when configuration files change during a session, enabling enterprise security auditing and optional blocking of settings changes. - Improved startup performance by caching MCP auth failures to avoid redundant connection attempts
- Improved startup performance by reducing HTTP calls for analytics token counting
- Improved startup performance by batching MCP tool token counting into a single API call
- Fixed
disableAllHookssetting to respect managed settings hierarchy — non-managed settings can no longer disable managed hooks set by policy (#26637) - Fixed
--resumesession picker showing raw XML tags for sessions that start with commands like/clear. Now correctly falls through to the session ID fallback. - 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
What's changed
- Fixed FileWriteTool line counting to preserve intentional trailing blank lines instead of stripping them with
trimEnd(). - 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. - 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.
- Fixed a bug where bold and colored text in markdown output could shift to the wrong characters on Windows due to
\r\nline endings. - 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)
- Improved memory usage in long-running sessions by releasing API stream buffers, agent context, and skill state after use
- Improved startup performance by deferring SessionStart hook execution, reducing time-to-interactive by ~500ms.
- Fixed an issue where bash tool output was silently discarded on Windows when using MSYS2 or Cygwin shells.
- 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. - Improved memory usage by trimming agent task message history after tasks complete
- Improved memory usage during long agent sessions by eliminating O(n²) message accumulation in progress updates
- Fixed the bash permission classifier to validate that returned match descriptions correspond to actual input rules, preventing hallucinated descriptions from incorrectly granting permissions
- Fixed user-defined agents only loading one file on NFS/FUSE filesystems that report zero inodes (anthropics/claude-code#26044)
- Fixed plugin agent skills silently failing to load when referenced by bare name instead of fully-qualified plugin name (anthropics/claude-code#25834)
- Search patterns in collapsed tool results are now displayed in quotes for clarity
- Windows: Fixed CWD tracking temp files never being cleaned up, causing them to accumulate indefinitely (anthropics/claude-code#17600)
- Use
ctrl+fto 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. - 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.
- Simplified teammate navigation to use only Shift+Down (with wrapping) instead of both Shift+Up and Shift+Down.
- 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.
- Added
last_assistant_messagefield to Stop and SubagentStop hook inputs, providing the final assistant response text so hooks can access it without parsing transcript files. - Fixed custom session titles set via
/renamebeing lost after resuming a conversation (anthropics/claude-code#23610) - Fixed collapsed read/search hint text overflowing on narrow terminals by truncating from the start.
- 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. - 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) - Fixed MCP servers not appearing in the MCP Management Dialog after deferred loading
- Fixed session name persisting in status bar after
/clearcommand (anthropics/claude-code#26082) - Fixed crash when a skill's
nameordescriptionin SKILL.md frontmatter is a bare number (e.g.,name: 3000) — the value is now properly coerced to a string (anthropics/claude-code#25837) - Fixed /resume silently dropping sessions when the first message exceeds 16KB or uses array-format content (anthropics/claude-code#25721)
- Added
chat:newlinekeybinding action for configurable multi-line input (anthropics/claude-code#26075) - Added
added_dirsto the statusline JSONworkspacesection, exposing directories added via/add-dirto external scripts (anthropics/claude-code#26096) - Fixed
claude doctormisclassifying mise and asdf-managed installations as native installs (anthropics/claude-code#26033) - Fixed zsh heredoc failing with "read-only file system" error in sandboxed commands (anthropics/claude-code#25990)
- Fixed agent progress indicator showing inflated tool use count (anthropics/claude-code#26023)
- Fixed image pasting not working on WSL2 systems where Windows copies images as BMP format (anthropics/claude-code#25935)
- Fixed background agent results returning raw transcript data instead of the agent's final answer (anthropics/claude-code#26012)
- Fixed Warp terminal incorrectly prompting for Shift+Enter setup when it supports it natively (anthropics/claude-code#25957)
- Fixed CJK wide characters causing misaligned timestamps and layout elements in the TUI (anthropics/claude-code#26084)
- Fixed custom agent
modelfield in.claude/agents/*.mdbeing ignored when spawning team teammates (anthropics/claude-code#26064) - Fixed plan mode being lost after context compaction, causing the model to switch from planning to implementation mode (anthropics/claude-code#26061)
- Fixed
alwaysThinkingEnabled: truein settings.json not enabling thinking mode on Bedrock and Vertex providers (anthropics/claude-code#26074) - Fixed
tool_decisionOTel telemetry event not being emitted in headless/SDK mode (anthropics/claude-code#26059) - Fixed session name being lost after context compaction — renamed sessions now preserve their custom title through compaction (anthropics/claude-code#26121)
- Increased initial session count in resume picker from 10 to 50 for faster session discovery (anthropics/claude-code#26123)
- Windows: fixed worktree session matching when drive letter casing differs (anthropics/claude-code#26123)
- Fixed
/resume <session-id>failing to find sessions whose first message exceeds 16KB (anthropics/claude-code#25920) - Fixed "Always allow" on multiline bash commands creating invalid permission patterns that corrupt settings (anthropics/claude-code#25909)
- Fixed React crash (error #31) when a skill's
argument-hintin 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) - Fixed crash when using
/forkon sessions that used web search — null entries in search results from transcript deserialization are now handled gracefully (anthropics/claude-code#25811) - Fixed read-only git commands triggering FSEvents file watcher loops on macOS by adding --no-optional-locks flag (anthropics/claude-code#25750)
- 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) - Fixed non-interactive subcommands like
claude doctorandclaude plugin validatebeing blocked inside nested Claude sessions (anthropics/claude-code#25803) - Windows: Fixed the same CLAUDE.md file being loaded twice when drive letter casing differs between paths (anthropics/claude-code#25756)
- Fixed inline code spans in markdown being incorrectly parsed as bash commands (anthropics/claude-code#25792)
- Fixed teammate spinners not respecting custom spinnerVerbs from settings (anthropics/claude-code#25748)
- Fixed shell commands permanently failing after a command deletes its own working directory (anthropics/claude-code#26136)
- Fixed hooks (PreToolUse, PostToolUse) silently failing to execute on Windows by using Git Bash instead of cmd.exe (anthropics/claude-code#25981)
- Fixed LSP
findReferencesand other location-based operations returning results from gitignored files (e.g.,node_modules/,venv/) (anthropics/claude-code#26051) - Moved config backup files from home directory root to
~/.claude/backups/to reduce home directory clutter (anthropics/claude-code#26130) - Fixed sessions with large first prompts (>16KB) disappearing from the /resume list (anthropics/claude-code#26140)
- Fixed shell functions with double-underscore prefixes (e.g.,
__git_ps1) not being preserved across shell sessions (anthropics/claude-code#25824) - Fixed spinner showing "0 tokens" counter before any tokens have been received (anthropics/claude-code#26105)
- VSCode: Fixed conversation messages appearing dimmed while the AskUserQuestion dialog is open (anthropics/claude-code#26078)
- 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)
- Fixed Right Alt key leaving visible
[25~escape sequence residue in the input field on Windows/Git Bash terminals (anthropics/claude-code#25943) - The
/renamecommand now updates the terminal tab title by default (anthropics/claude-code#25789) - 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)
- Fixed OSC 8 hyperlinks only being clickable on the first line when link text wraps across multiple terminal lines.
What's changed
- Added support for Claude Sonnet 4.6
- Added support for reading
enabledPluginsandextraKnownMarketplacesfrom--add-dirdirectories - Added
spinnerTipsOverridesetting to customize spinner tips — configuretipswith an array of custom tip strings, and optionally setexcludeDefault: trueto show only your custom tips instead of the built-in ones - Added
SDKRateLimitInfoandSDKRateLimitEventtypes to the SDK, enabling consumers to receive rate limit status updates including utilization, reset times, and overage information - Fixed Agent Teams teammates failing on Bedrock, Vertex, and Foundry by propagating API provider environment variables to tmux-spawned processes (anthropics/claude-code#23561)
- Fixed sandbox "operation not permitted" errors when writing temporary files on macOS by using the correct per-user temp directory (anthropics/claude-code#21654)
- Fixed Task tool (backgrounded agents) crashing with a
ReferenceErroron completion (anthropics/claude-code#22087) - Fixed autocomplete suggestions not being accepted on Enter when images are pasted in the input
- Fixed skills invoked by subagents incorrectly appearing in main session context after compaction
- Fixed excessive
.claude.json.backupfiles accumulating on every startup - Fixed plugin-provided commands, agents, and hooks not being available immediately after installation without requiring a restart
- Improved startup performance by removing eager loading of session history for stats caching
- Improved memory usage for shell commands that produce large output — RSS no longer grows unboundedly with command output size
- Improved collapsed read/search groups to show the current file or search pattern being processed beneath the summary line while active
- [VSCode] Improved permission destination choice (project/user/session) to persist across sessions
What's changed
- Fixed auth refresh errors
What's changed
- Fixed /resume showing interrupt messages as session titles
- Fixed Opus 4.6 launch announcement showing for Bedrock/Vertex/Foundry users
- Improved error message for many-image dimension limit errors with /compact suggestion
What's changed
- Fixed AWS auth refresh hanging indefinitely by adding a 3-minute timeout
- Added
claude auth login,claude auth status, andclaude auth logoutCLI subcommands - Added Windows ARM64 (win32-arm64) native binary support
- Improved
/renameto auto-generate session name from conversation context when called without arguments - Improved narrow terminal layout for prompt footer
- Fixed file resolution failing for @-mentions with anchor fragments (e.g.,
@README.md#installation) - Fixed FileReadTool blocking the process on FIFOs,
/dev/stdin, and large files - Fixed background task notifications not being delivered in streaming Agent SDK mode
- Fixed cursor jumping to end on each keystroke in classifier rule input
- Fixed markdown link display text being dropped for raw URL
- Fixed auto-compact failure error notifications being shown to users
- Fixed permission wait time being included in subagent elapsed time display
- Fixed proactive ticks firing while in plan mode
- Fixed clear stale permission rules when settings change on disk
- Fixed hook blocking errors showing stderr content in UI
What's changed
- Improved terminal rendering performance
- Fixed fatal errors being swallowed instead of displayed
- Fixed process hanging after session close
- Fixed character loss at terminal screen boundary
- Fixed blank lines in verbose transcript view
What's changed
- Fixed VS Code terminal scroll-to-top regression introduced in 2.1.37
- Fixed Tab key queueing slash commands instead of autocompleting
- Fixed bash permission matching for commands using environment variable wrappers
- Fixed text between tool uses disappearing when not using streaming
- Fixed duplicate sessions when resuming in VS Code extension
- Improved heredoc delimiter parsing to prevent command smuggling
- Blocked writes to
.claude/skillsdirectory in sandbox mode
What's changed
- Fixed an issue where /fast was not immediately available after enabling /extra-usage
What's changed
- Fast mode is now available for Opus 4.6. Learn more at https://code.claude.com/docs/en/fast-mode
What's changed
- Fixed a crash when agent teams setting changed between renders
- Fixed a bug where commands excluded from sandboxing (via
sandbox.excludedCommandsordangerouslyDisableSandbox) could bypass the Bash ask permission rule whenautoAllowBashIfSandboxedwas enabled
What's changed
- Fixed agent teammate sessions in tmux to send and receive messages
- Fixed warnings about agent teams not being available on your current plan
- Added
TeammateIdleandTaskCompletedhook events for multi-agent workflows - Added support for restricting which sub-agents can be spawned via
Task(agent_type)syntax in agent "tools" frontmatter - Added
memoryfrontmatter field support for agents, enabling persistent memory withuser,project, orlocalscope - Added plugin name to skill descriptions and
/skillsmenu for better discoverability - Fixed an issue where submitting a new message while the model was in extended thinking would interrupt the thinking phase
- 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
- Fixed API proxy compatibility issue where 404 errors on streaming endpoints no longer triggered non-streaming fallback
- Fixed an issue where proxy settings configured via
settings.jsonenvironment variables were not applied to WebFetch and other HTTP requests on the Node.js build - Fixed
/resumesession picker showing raw XML markup instead of clean titles for sessions started with slash commands - Improved error messages for API connection failures — now shows specific cause (e.g., ECONNREFUSED, SSL errors) instead of generic "Connection error"
- Errors from invalid managed settings are now surfaced
- VSCode: Added support for remote sessions, allowing OAuth users to browse and resume sessions from claude.ai
- VSCode: Added git branch and message count to the session picker, with support for searching by branch name
- VSCode: Fixed scroll-to-bottom under-scrolling on initial session load and session switch
What's changed
- Claude Opus 4.6 is now available!
- Added research preview agent teams feature for multi-agent collaboration (token-intensive feature, requires setting CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1)
- Claude now automatically records and recalls memories as it works
- Added "Summarize from here" to the message selector, allowing partial conversation summarization.
- Skills defined in
.claude/skills/within additional directories (--add-dir) are now loaded automatically. - Fixed
@file completion showing incorrect relative paths when running from a subdirectory - Updated --resume to re-use --agent value specified in previous conversation by default.
- Fixed: Bash tool no longer throws "Bad substitution" errors when heredocs contain JavaScript template literals like
${index + 1}, which previously interrupted tool execution - Skill character budget now scales with context window (2% of context), so users with larger context windows can see more skill descriptions without truncation
- Fixed Thai/Lao spacing vowels (สระ า, ำ) not rendering correctly in the input field
- VSCode: Fixed slash commands incorrectly being executed when pressing Enter with preceding text in the input field
- VSCode: Added spinner when loading past conversations list
What's changed
- Added session resume hint on exit, showing how to continue your conversation later
- Added support for full-width (zenkaku) space input from Japanese IME in checkbox selection
- Fixed PDF too large errors permanently locking up sessions, requiring users to start a new conversation
- Fixed bash commands incorrectly reporting failure with "Read-only file system" errors when sandbox mode was enabled
- Fixed a crash that made sessions unusable after entering plan mode when project config in
~/.claude.jsonwas missing default fields - Fixed
temperatureOverridebeing silently ignored in the streaming API path, causing all streaming requests to use the default temperature (1) regardless of the configured override - Fixed LSP shutdown/exit compatibility with strict language servers that reject null params
- 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 - Improved PDF and request size error messages to show actual limits (100 pages, 20MB)
- Reduced layout jitter in the terminal when the spinner appears and disappears during streaming
- Removed misleading Anthropic API pricing from model selector for third-party provider (Bedrock, Vertex, Foundry) users
What's changed
- Added
pagesparameter 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. - Added pre-configured OAuth client credentials for MCP servers that don't support Dynamic Client Registration (e.g., Slack). Use
--client-idand--client-secretwithclaude mcp add. - Added
/debugfor Claude to help troubleshoot the current session - Added support for additional
git logandgit showflags in read-only mode (e.g.,--topo-order,--cherry-pick,--format,--raw) - Added token count, tool uses, and duration metrics to Task tool results
- Added reduced motion mode to the config
- Fixed phantom "(no content)" text blocks appearing in API conversation history, reducing token waste and potential model confusion
- Fixed prompt cache not correctly invalidating when tool descriptions or input schemas changed, only when tool names changed
- Fixed 400 errors that could occur after running
/loginwhen the conversation contained thinking blocks - Fixed a hang when resuming sessions with corrupted transcript files containing
parentUuidcycles - Fixed rate limit message showing incorrect "/upgrade" suggestion for Max 20x users when extra-usage is unavailable
- Fixed permission dialogs stealing focus while actively typing
- Fixed subagents not being able to access SDK-provided MCP tools because they were not synced to the shared application state
- Fixed a regression where Windows users with a
.bashrcfile could not run bash commands - 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 - Improved
TaskStoptool to display the stopped command/task description in the result line instead of a generic "Task stopped" message - Changed
/modelto execute immediately instead of being queued - [VSCode] Added multiline input support to the "Other" text input in question dialogs (use Shift+Enter for new lines)
- [VSCode] Fixed duplicate sessions appearing in the session list when starting a new conversation
What's changed
- Fixed startup performance issues when resuming sessions that have
saved_hook_context
What's changed
- Added tool call failures and denials to debug logs
- Fixed context management validation error for gateway users, ensuring
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1avoids the error - Added
--from-prflag to resume sessions linked to a specific GitHub PR number or URL - Sessions are now automatically linked to PRs when created via
gh pr create - Fixed /context command not displaying colored output
- Fixed status bar duplicating background task indicator when PR status was shown
- VSCode: Enabled Claude in Chrome integration
- Permissions now respect content-level
askover tool-levelallow. Previouslyallow: ["Bash"], ask: ["Bash(rm *)"]allowed all bash commands, but will now permission prompt forrm. - Windows: Fixed bash command execution failing for users with
.bashrcfiles - Windows: Fixed console windows flashing when spawning child processes
- VSCode: Fixed OAuth token expiration causing 401 errors after extended sessions
What's changed
- Fixed beta header validation error for gateway users on Bedrock and Vertex, ensuring
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1avoids the error
What's changed
- Added customizable spinner verbs setting (
spinnerVerbs) - Fixed mTLS and proxy connectivity for users behind corporate proxies or using client certificates
- Fixed per-user temp directory isolation to prevent permission conflicts on shared systems
- Fixed a race condition that could cause 400 errors when prompt caching scope was enabled
- Fixed pending async hooks not being cancelled when headless streaming sessions ended
- Fixed tab completion not updating the input field when accepting a suggestion
- Fixed ripgrep search timeouts silently returning empty results instead of reporting errors
- Improved terminal rendering performance with optimized screen data layout
- Changed Bash commands to show timeout duration alongside elapsed time
- Changed merged pull requests to show a purple status indicator in the prompt footer
- [IDE] Fixed model options displaying incorrect region strings for Bedrock users in headless mode
What's changed
- Fixed structured outputs for non-interactive (-p) mode
What's changed
- Added support for full-width (zenkaku) number input from Japanese IME in option selection prompts
- Fixed shell completion cache files being truncated on exit
- Fixed API errors when resuming sessions that were interrupted during tool execution
- Fixed auto-compact triggering too early on models with large output token limits
- Fixed task IDs potentially being reused after deletion
- Fixed file search not working in VS Code extension on Windows
- Improved read/search progress indicators to show "Reading…" while in progress and "Read" when complete
- Improved Claude to prefer file operation tools (Read, Edit, Write) over bash equivalents (cat, sed, awk)
- [VSCode] Added automatic Python virtual environment activation, ensuring
pythonandpipcommands use the correct interpreter (configurable viaclaudeCode.usePythonEnvironmentsetting) - [VSCode] Fixed message action buttons having incorrect background colors
What's changed
- Added arrow key history navigation in vim normal mode when cursor cannot move further
- Added external editor shortcut (Ctrl+G) to the help menu for better discoverability
- 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
- Added support for loading
CLAUDE.mdfiles from additional directories specified via--add-dirflag (requires settingCLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1) - Added ability to delete tasks via the
TaskUpdatetool - Fixed session compaction issues that could cause resume to load full history instead of the compact summary
- Fixed agents sometimes ignoring user messages sent while actively working on a task
- Fixed wide character (emoji, CJK) rendering artifacts where trailing columns were not cleared when replaced by narrower characters
- Fixed JSON parsing errors when MCP tool responses contain special Unicode characters
- Fixed up/down arrow keys in multi-line and wrapped text input to prioritize cursor movement over history navigation
- Fixed draft prompt being lost when pressing UP arrow to navigate command history
- Fixed ghost text flickering when typing slash commands mid-input
- Fixed marketplace source removal not properly deleting settings
- Fixed duplicate output in some commands like
/context - Fixed task list sometimes showing outside the main conversation view
- Fixed syntax highlighting for diffs occurring within multiline constructs like Python docstrings
- Fixed crashes when cancelling tool use
- Improved
/sandboxcommand UI to show dependency status with installation instructions when dependencies are missing - Improved thinking status text with a subtle shimmer animation
- Improved task list to dynamically adjust visible items based on terminal height
- Improved fork conversation hint to show how to resume the original session
- Changed collapsed read/search groups to show present tense ("Reading", "Searching for") while in progress, and past tense ("Read", "Searched for") when complete
- Changed teammate messages to render with rich Markdown formatting (bold, code blocks, lists, etc.) instead of plain text
- Changed
ToolSearchresults to appear as a brief notification instead of inline in the conversation - Changed the
/commit-push-prskill to automatically post PR URLs to Slack channels when configured via MCP tools - Changed the
/copycommand to be available to all users - Changed background agents to prompt for tool permissions before launching
- Changed permission rules like
Bash(*)to be accepted and treated as equivalent toBash - Changed config backups to be timestamped and rotated (keeping 5 most recent) to prevent data loss
What's changed
- Added env var
CLAUDE_CODE_ENABLE_TASKS, set tofalseto keep the old system temporarily - Added shorthand
$0,$1, etc. for accessing individual arguments in custom commands - Fixed crashes on processors without AVX instruction support
- Fixed dangling Claude Code processes when terminal is closed by catching EIO errors from
process.exit()and using SIGKILL as fallback - Fixed
/renameand/tagnot updating the correct session when resuming from a different directory (e.g., git worktrees) - Fixed resuming sessions by custom title not working when run from a different directory
- Fixed pasted text content being lost when using prompt stash (Ctrl+S) and restore
- Fixed agent list displaying "Sonnet (default)" instead of "Inherit (default)" for agents without an explicit model setting
- Fixed backgrounded hook commands not returning early, potentially causing the session to wait on a process that was intentionally backgrounded
- Fixed file write preview omitting empty lines
- Changed skills without additional permissions or hooks to be allowed without requiring approval
- Changed indexed argument syntax from
$ARGUMENTS.0to$ARGUMENTS[0](bracket syntax) - [SDK] Added replay of
queued_commandattachment messages asSDKUserMessageReplayevents whenreplayUserMessagesis enabled - [VSCode] Enabled session forking and rewind functionality for all users
What's changed
- Fixed crashes on processors without AVX instruction support
What's changed
- Added new task management system, including new capabilities like dependency tracking
- [VSCode] Added native plugin management support
- [VSCode] Added ability for OAuth users to browse and resume remote Claude sessions from the Sessions dialog
- Fixed out-of-memory crashes when resuming sessions with heavy subagent usage
- Fixed an issue where the "context remaining" warning was not hidden after running
/compact - Fixed session titles on the resume screen not respecting the user's language setting
- [IDE] Fixed a race condition on Windows where the Claude Code sidebar view container would not appear on start
What's changed
- Added deprecation notification for npm installations - run
claude installor see https://docs.anthropic.com/en/docs/claude-code/getting-started for more options - Improved UI rendering performance with React Compiler
- Fixed the "Context left until auto-compact" warning not disappearing after running
/compact - Fixed MCP stdio server timeout not killing child process, which could cause UI freezes
What's changed
- Added history-based autocomplete in bash mode (
!) - type a partial command and press Tab to complete from your bash command history - Added search to installed plugins list - type to filter by name or description
- Added support for pinning plugins to specific git commit SHAs, allowing marketplace entries to install exact versions
- Fixed a regression where the context window blocking limit was calculated too aggressively, blocking users at ~65% context usage instead of the intended ~98%
- Fixed memory issues that could cause crashes when running parallel subagents
- Fixed memory leak in long-running sessions where stream resources were not cleaned up after shell commands completed
- Fixed
@symbol incorrectly triggering file autocomplete suggestions in bash mode - Fixed
@-mention menu folder click behavior to navigate into directories instead of selecting them - Fixed
/feedbackcommand generating invalid GitHub issue URLs when description is very long - Fixed
/contextcommand to show the same token count and percentage as the status line in verbose mode - Fixed an issue where
/config,/context,/model, and/todoscommand overlays could close unexpectedly - Fixed slash command autocomplete selecting wrong command when typing similar commands (e.g.,
/contextvs/compact) - Fixed inconsistent back navigation in plugin marketplace when only one marketplace is configured
- Fixed iTerm2 progress bar not clearing properly on exit, preventing lingering indicators and bell sounds
- Improved backspace to delete pasted text as a single token instead of one character at a time
- [VSCode] Added
/usagecommand to display current plan usage
What's changed
- Fixed message rendering bug
What's changed
- Fixed excessive MCP connection requests for HTTP/SSE transports
What's changed
- Added
auto:Nsyntax for configuring the MCP tool search auto-enable threshold, where N is the context window percentage (0-100) - Added
plansDirectorysetting to customize where plan files are stored - Added external editor support (Ctrl+G) in AskUserQuestion "Other" input field
- Added session URL attribution to commits and PRs created from web sessions
- Added support for
PreToolUsehooks to returnadditionalContextto the model - Added
${CLAUDE_SESSION_ID}string substitution for skills to access the current session ID - Fixed long sessions with parallel tool calls failing with an API error about orphan tool_result blocks
- Fixed MCP server reconnection hanging when cached connection promise never resolves
- Fixed Ctrl+Z suspend not working in terminals using Kitty keyboard protocol (Ghostty, iTerm2, kitty, WezTerm)
What's changed
- Added
showTurnDurationsetting to hide turn duration messages (e.g., "Cooked for 1m 6s") - Added ability to provide feedback when accepting permission prompts
- Added inline display of agent's final response in task notifications, making it easier to see results without reading the full transcript file
- Fixed security vulnerability where wildcard permission rules could match compound commands containing shell operators
- Fixed false "file modified" errors on Windows when cloud sync tools, antivirus scanners, or Git touch file timestamps without changing content
- Fixed orphaned tool_result errors when sibling tools fail during streaming execution
- 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)
- Fixed spinner briefly flashing when running local slash commands like
/modelor/theme - Fixed terminal title animation jitter by using fixed-width braille characters
- Fixed plugins with git submodules not being fully initialized when installed
- Fixed bash commands failing on Windows when temp directory paths contained characters like
tornthat were misinterpreted as escape sequences - Improved typing responsiveness by reducing memory allocation overhead in terminal rendering
- 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
MCPSearchtodisallowedToolsin their settings. - Changed OAuth and API Console URLs from console.anthropic.com to platform.claude.com
- [VSCode] Fixed
claudeProcessWrappersetting passing the wrapper path instead of the Claude binary path
What's changed
- Added search functionality to
/configcommand for quickly filtering settings - Added Updates section to
/doctorshowing auto-update channel and available npm versions (stable/latest) - Added date range filtering to
/statscommand - pressrto cycle between Last 7 days, Last 30 days, and All time - Added automatic discovery of skills from nested
.claude/skillsdirectories when working with files in subdirectories - Added
context_window.used_percentageandcontext_window.remaining_percentagefields to status line input for easier context window display - Added an error display when the editor fails during Ctrl+G
- Fixed permission bypass via shell line continuation that could allow blocked commands to execute
- Fixed false "File has been unexpectedly modified" errors when file watchers touch files without changing content
- Fixed text styling (bold, colors) getting progressively misaligned in multi-line responses
- Fixed the feedback panel closing unexpectedly when typing 'n' in the description field
- Fixed rate limit warning appearing at low usage after weekly reset (now requires 70% usage)
- Fixed rate limit options menu incorrectly auto-opening when resuming a previous session
- Fixed numpad keys outputting escape sequences instead of characters in Kitty keyboard protocol terminals
- Fixed Option+Return not inserting newlines in Kitty keyboard protocol terminals
- Fixed corrupted config backup files accumulating in the home directory (now only one backup is created per config file)
- Fixed
mcp listandmcp getcommands leaving orphaned MCP server processes - Fixed visual artifacts in ink2 mode when nodes become hidden via
display:none - Improved the external CLAUDE.md imports approval dialog to show which files are being imported and from where
- Improved the
/tasksdialog to go directly to task details when there's only one background task running - Improved @ autocomplete with icons for different suggestion types and single-line formatting
- Updated "Help improve Claude" setting fetch to refresh OAuth and retry when it fails due to a stale OAuth token
- Changed task notification display to cap at 3 lines with overflow summary when multiple background tasks complete simultaneously
- Changed terminal title to "Claude Code" on startup for better window identification
- Removed ability to @-mention MCP servers to enable/disable - use
/mcp enable <name>instead - [VSCode] Fixed usage indicator not updating after manual compact
What's changed
- Added
CLAUDE_CODE_TMPDIRenvironment variable to override the temp directory used for internal temp files, useful for environments with custom temp directory requirements
What's changed
- Added
CLAUDE_CODE_DISABLE_BACKGROUND_TASKSenvironment variable to disable all background task functionality including auto-backgrounding and the Ctrl+B shortcut - Fixed "Help improve Claude" setting fetch to refresh OAuth and retry when it fails due to a stale OAuth token
What's changed
- Merged slash commands and skills, simplifying the mental model with no change in behavior
- Added release channel (
stableorlatest) toggle to/config - Added detection and warnings for unreachable permission rules, with warnings in
/doctorand after saving rules that include the source of each rule and actionable fix guidance - Fixed plan files persisting across
/clearcommands, now ensuring a fresh plan file is used after clearing a conversation - Fixed false skill duplicate detection on filesystems with large inodes (e.g., ExFAT) by using 64-bit precision for inode values
- Fixed mismatch between background task count in status bar and items shown in tasks dialog
- Fixed sub-agents using the wrong model during conversation compaction
- Fixed web search in sub-agents using incorrect model
- Fixed trust dialog acceptance when running from the home directory not enabling trust-requiring features like hooks during the session
- Improved terminal rendering stability by preventing uncontrolled writes from corrupting cursor state
- Improved slash command suggestion readability by truncating long descriptions to 2 lines
- Changed tool hook execution timeout from 60 seconds to 10 minutes
- [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)
What's changed
- Added source path metadata to images dragged onto the terminal, helping Claude understand where images originated
- Added clickable hyperlinks for file paths in tool output in terminals that support OSC 8 (like iTerm)
- Added support for Windows Package Manager (winget) installations with automatic detection and update instructions
- Added Shift+Tab keyboard shortcut in plan mode to quickly select "auto-accept edits" option
- Added
FORCE_AUTOUPDATE_PLUGINSenvironment variable to allow plugin autoupdate even when the main auto-updater is disabled - Added
agent_typeto SessionStart hook input, populated if--agentis specified - Fixed a command injection vulnerability in bash command processing where malformed input could execute arbitrary commands
- Fixed a memory leak where tree-sitter parse trees were not being freed, causing WASM memory to grow unbounded over long sessions
- Fixed binary files (images, PDFs, etc.) being accidentally included in memory when using
@includedirectives in CLAUDE.md files - Fixed updates incorrectly claiming another installation is in progress
- Fixed crash when socket files exist in watched directories (defense-in-depth for EOPNOTSUPP errors)
- Fixed remote session URL and teleport being broken when using
/taskscommand - Fixed MCP tool names being exposed in analytics events by sanitizing user-specific server configurations
- Improved Option-as-Meta hint on macOS to show terminal-specific instructions for native CSIu terminals like iTerm2, Kitty, and WezTerm
- Improved error message when pasting images over SSH to suggest using
scpinstead of the unhelpful clipboard shortcut hint - Improved permission explainer to not flag routine dev workflows (git fetch/rebase, npm install, tests, PRs) as medium risk
- Changed large bash command outputs to be saved to disk instead of truncated, allowing Claude to read the full content
- Changed large tool outputs to be persisted to disk instead of truncated, providing full output access via file references
- Changed
/pluginsinstalled tab to unify plugins and MCPs with scope-based grouping - Deprecated Windows managed settings path
C:\ProgramData\ClaudeCode\managed-settings.json- administrators should migrate toC:\Program Files\ClaudeCode\managed-settings.json - [SDK] Changed minimum zod peer dependency to ^4.0.0
- [VSCode] Fixed usage display not updating after manual compact
What's changed
- Fixed issue with macOS code-sign warning when using Claude in Chrome integration
What's changed
- Added LSP (Language Server Protocol) tool for code intelligence features like go-to-definition, find references, and hover documentation
- Added
/terminal-setupsupport for Kitty, Alacritty, Zed, and Warp terminals - Added ctrl+t shortcut in
/themeto toggle syntax highlighting on/off - Added syntax highlighting info to theme picker
- Added guidance for macOS users when Alt shortcuts fail due to terminal configuration
- Fixed skill
allowed-toolsnot being applied to tools invoked by the skill - Fixed Opus 4.5 tip incorrectly showing when user was already using Opus
- Fixed a potential crash when syntax highlighting isn't initialized correctly
- Fixed visual bug in
/plugins discoverwhere list selection indicator showed while search box was focused - Fixed macOS keyboard shortcuts to display 'opt' instead of 'alt'
- Improved
/contextcommand visualization with grouped skills and agents by source, slash commands, and sorted token count - [Windows] Fixed issue with improper rendering
- [VSCode] Added gift tag pictogram for year-end promotion message
What's changed
- Added clickable
[Image #N]links that open attached images in the default viewer - Added alt-y yank-pop to cycle through kill ring history after ctrl-y yank
- Added search filtering to the plugin discover screen (type to filter by name, description, or marketplace)
- Added support for custom session IDs when forking sessions with
--session-idcombined with--resumeor--continueand--fork-session - Fixed slow input history cycling and race condition that could overwrite text after message submission
- Improved
/themecommand to open theme picker directly - Improved theme picker UI
- Improved search UX across resume session, permissions, and plugins screens with a unified SearchBox component
- [VSCode] Added tab icon badges showing pending permissions (blue) and unread completions (orange)