Claude Code 2.1.325
139changes- Add Tab-accepted prompt suggestions in VS Code's integrated terminal.
- Fix sessions on many third-party gateways and Foundry failing every turn instead of compacting.
- Change sandboxed Bash commands to follow the normal permission flow by default.
- Fix deny and ask permission rules for the Artifact tool not applying in some cloud sessions.
- Fix a gap that let some compound Bash commands run without asking for permission.
New features
6[VSCode] Add Tab-accepted prompt suggestions
Added prompt suggestions wherever the terminal shows them: Tab accepts the suggested next prompt; promptSuggestionEnabled: false in Claude Code's settings.json turns them off
[VSCode] Add API-key-free Console sign-in
Added a Console sign-in that creates no API key
▤ In the docs[VSCode] Add redirect URL field for remote MCP sign-in
Added a field to paste the redirect URL when signing in to an MCP server from the panel in SSH, WSL and container windows
More changes (3) Fewer changes
Notebook cell re-run tip in VS Code
Added a spinner tip in VS Code and similar integrated terminals about re-running a notebook cell, shown once Claude has read or edited a Jupyter notebook
Show how to continue after a policy block
Added a line under the error shown when your organization's policy blocks a request, saying how to continue: run /rewind and change the message, or run /clear
Note sandboxed git limits on protected files
Added a note for Claude when a sandboxed git checkout, git stash or autostash pull cannot update protected files such as those in .claude
Improvements
44Speed up startup with a valid cached token
Improved startup with a keyless Console sign-in or other Anthropic profile login: a token that is still valid is read without waiting for the credentials lock
Sandboxed Bash now asks like normal commands
Changed sandboxed Bash commands to follow the normal permission flow by default; set sandbox.autoAllowBashIfSandboxed: true to keep running them without prompts
Protect .claude in added directories too
Changed the sandbox to refuse sandboxed writes to .claude settings, skills, agents, commands and hooks in added directories, as it does in the launch folder
Gate container allow rules on folder trust
Changed -p and SDK runs in a worktree or submodule mounted into a container to apply .claude/settings.local.json allow rules only once the folder is trusted
More changes (40) Fewer changes
Retry subagents cut off at the token limit
Improved subagents cut off at the output token limit: they are now asked for the whole answer again, more briefly, instead of returning only its end
Widen the account email check's reach
Improved the account email check: it now also refuses your email as a client's identity in scripts a command runs, file writes, web fetches and MCP calls
Clarify HTTPS auth failure for marketplaces
Improved the HTTPS authentication failed message for private plugin marketplaces: it now says git's terminal prompts and askpass programs are disabled, and it also appears with newer git versions
Warn that plugins can run code on your computer
Improved the add-marketplace confirmations, plugin recommendation prompts and plugin install warning to say that plugins can run code on your computer, with access to your files and shell
▤ In the docsName the cause of claude --desktop sign-in errors
Improved the claude --desktop sign-in error to name the API key, provider or setting that stops a Claude account sign-in from working
Guide mic selection in /voice error
Improved the /voice "No audio detected" message on macOS and Windows: it now says where to pick your microphone
Tell Claude when an MCP task needs an answer
Improved MCP tasks: Claude is now told when a task is waiting for your answer, and can point you to /tasks
Add service-manager exit codes to remote-control
Improved claude remote-control: it now exits with status 4 when it stops by itself (single-session runs still exit 0) and 69 when it can't register, so a service manager can start it again
Stop suggesting settings for session-only keys
Improved the messages shown when a background session can't use its session's API key or token: they no longer suggest adding the key to settings
Improve dataviz skill's part-to-whole guidance
Improved the bundled dataviz skill's part-to-whole advice for static images and for parts with a natural order, such as age bands
Add opt-out for managed sandbox auto-allow
Changed managed settings that turn the sandbox on: to keep commands running without prompts, set sandbox.autoAllowBashIfSandboxed: true in your highest-ranking managed source
Ask before read-only git in untrusted repos
Changed read-only git commands to ask first in a repository that isn't the project's or one you trusted; name it with --add-dir, not the additionalDirectories setting, to run them without prompts
Ask before running skills in scheduled tasks
Changed scheduled tasks and /loop to ask before running a skill that declares allowed-tools or hooks; add Skill(name) to permissions.allow to run it unattended
Limit when Always allow offers a rule
Changed "Always allow" in Desktop, IDE and SDK hosts: a rule alone is offered only when saving it would allow that command again, so a scheduled task that relied on one can now wait for you
Block more git setup commands in isolated worktrees
Changed worktree isolation: an isolated worktree session or agent is now refused git bisect run, git maintenance register|start and scalar's set-up commands, and is told what still works
Unpack plugin MCP bundles under plugins dir
Changed plugin MCP bundles (.mcpb, .dxt) to unpack under the plugins directory, not .mcpb-cache in the plugin's folder, so read-only plugin folders load; one fetched by URL downloads again once
Count prependPlugins/appendPlugins as org plugins
Changed plugins of a remote marketplace that managed settings declare, enable and list in prependPlugins or appendPlugins to count as the organization's; pluginDigests is deprecated and ignored
Flag unsafe paths and links in plugins
Changed plugin loading to skip, and claude plugin validate to report, some unsafe paths and links in a plugin's folder
Stop loading plugin skills from above the plugin
Changed nested skill loading: .claude/skills folders in --plugin-dir plugins no longer load from a session started above them; start Claude Code in the plugin folder instead
Require real paths for WorktreeCreate hooks
Changed EnterWorktree to refuse a WorktreeCreate hook path that goes through a symlink inside the project; have the hook print the real path
Start teammates in the session's own folder
Changed tmux and iTerm2 teammates, and new sessions from the agents view opened with ←, to start in the session's folder instead of where the shell last ran cd
Refresh prompt suggestions less during automation
Changed prompt suggestions in the terminal to refresh less often after 8 turns in a row started by background or scheduled tasks, saving usage until you press a key or return to the terminal
Add answer-later Esc for MCP task questions
Changed Esc on a background MCP task's question to "answer later": nothing is sent to the server, and the question stays in /tasks
Apply CLAUDE_CODE_MAX_CONTEXT_TOKENS more broadly
Changed CLAUDE_CODE_MAX_CONTEXT_TOKENS to also set the context window of unrecognized model IDs that start with claude-, such as a gateway's claude-sonnet-latest
▤ In the docsAsk before /login changes privacy settings
Changed /login to ask for permission to change your privacy settings
Count mod model calls in cost and token metrics
Changed /cost, $.session.usage(), --max-budget-usd and the cost and token metrics to count a mod's $.model.complete and $.model.classify calls
Keep tokens out of sandbox helper programs
Changed the programs that Claude Code's sandbox starts for its own use, such as its network bridge, to run without Claude Code's sign-in tokens and API keys in their environment
Keep mTLS passphrase out of helper environments
Changed ripgrep, local git commands and the sandbox runtime's own helper programs to run without the mTLS client key's passphrase in their environment
Disconnect /resume and /teleport from share links
Remote Control: Changed /resume and /teleport to disconnect first when the connected session has a share link, or when that can't be checked; run /remote-control to connect again
Start cloud sessions despite failIfUnavailable
Changed Claude Code on the web, cloud scheduled tasks and Cowork cloud sessions to start despite sandbox.failIfUnavailable: the hosted container has no command sandbox
Limit what cloud connections can request
Changed requests for settings, permission rules, hooks or status over a cloud or self-hosted session's connection to return less or be refused; what applies in the session is unchanged
Wait for cached account data before claude -p
Changed claude -p with no cached account data to wait for that data before its first request, so a first run in a clean environment can start a few seconds later
Warn that the scratchpad folder can be cleared
Changed Claude's instructions to keep files you'll want out of its temporary scratchpad folder, which can be cleared
Accept full commit IDs in marketplace ref
Changed marketplace ref to accept the full ID of any commit on a branch or tag; clients before this version can't clone such a pin, so a marketplace pinned this way stops loading there
Require CONNECT tunnels for ALL_PROXY downloads
Changed plugin marketplace and plugin downloads to use a CONNECT tunnel when ALL_PROXY is the only proxy set; a proxy that refuses CONNECT now fails them
Refuse symlinked session paths on self-hosted runners
Changed self-hosted runners to refuse a session whose session folder or repository path is a symbolic link, other than a checkout hook's checkout
[VSCode] Explain why the extension is off
Improved the note shown for an untrusted folder: it now says why the extension is off and how to turn it on
[VSCode] Point to IT for blocked launches
Improved the error shown when the system refuses to run Claude Code: it now says your IT team can allow a blocked program
[VSCode] Guide localhost sign-in errors
Improved the sign-in card to say what to do when the browser shows a connection error for localhost
[VSCode] Rename marketplace trust button
Changed the install link's marketplace confirmation button to "Trust marketplace and continue"
Bug fixes
88Fix gateway sessions failing instead of compacting
Fixed sessions on many third-party gateways and Foundry stopping with a context length error on every turn instead of compacting
Fix lost turns after an unclean exit
Fixed recent turns sometimes going missing from a resumed session after Claude Code stopped without a clean exit
Fix background sessions billing wrong account
Fixed background sessions started on your claude.ai login using (and billing) an API key or token from the shell that started the background service
Close a compound Bash permission check gap
Fixed a gap in Bash permission checks where some compound commands could run without asking; these now ask for permission
Fix Bash allow rule running wrong program
Fixed a case where a Bash allow rule could run a different program than the one it names
Fix deny/ask rules missed on some Bash commands
Fixed some deny and ask rules not applying to certain Bash commands
Fix Artifact deny/ask rules not applying
Fixed deny and ask permission rules and hooks for the Artifact tool not applying in some cloud sessions
Apply deny rules to post-restart approvals
Fixed deny rules not being applied to a permission approval that arrives after Claude Code restarts, in self-hosted runner and claude remote-control sessions
Fix relative deny rules lost after cd
Fixed relative deny and ask permission rules (e.g. Read(./.env)) no longer covering the project after a cd; they now also apply in added directories
Fix case-sensitive plugin MCP deny rules
Fixed deny and ask permission rules starting with mcp__plugin_*_ missing a plugin's MCP server or tool spelled in another letter case
Fix committed settings.local.json treated as yours
Fixed a case where a committed .claude/settings.local.json could be treated as the user's own when Claude Code was started in certain subfolders of a repository
Require asking for wider-audience artifact changes
Fixed some subagents changing an artifact that people outside your organization can see, or uploading files to it, without asking first when an allow rule is set or uploads were approved earlier
Require confirmation for wider-audience publishes
Fixed some artifact publishes skipping the confirmation for pages that people outside your organization can see when "don't ask again" had been chosen for Artifact
Block sandboxed writes to the updater's folder
Fixed sandboxed commands being able to write to the native updater's download folder in some cases
Protect worktree settings and hooks in sandbox
Fixed a case where the Bash sandbox did not fully protect a worktree's settings and hooks
Protect linked worktree's git folder in sandbox
Fixed a case where the Bash sandbox did not fully protect a linked worktree's shared git folder
Scope slash command tool grants to its turn
Fixed a slash command's allowed-tools grants applying to background agents woken during or after its turn
Stop connector prompts auto-answering early
Fixed a connector tool's approval prompt in cloud sessions being answered automatically while plugins were still loading
Scope auto mode's yes to one artifact change
Fixed auto mode judging only the first change to an artifact that people outside your organization can see; its yes now covers that change alone
Fix token counting bypassing allowedProviders
Fixed token counting on Amazon Bedrock sending the conversation to Bedrock when the allowedProviders managed setting does not allow it
Apply strictPluginOnlyCustomization to running sessions
Fixed a managed strictPluginOnlyCustomization lock on agents and skills not taking effect in sessions that were already running
More changes (67) Fewer changes
Fix zstd decoding security issue
Fixed a security issue in how zstd-compressed responses are decoded
Fix git commands failing in special worktrees
Fixed /security-review and skills' inline git commands stopping with an error in worktrees of bare repositories, --separate-git-dir checkouts and Android repo checkouts
Fix subagent model overridden in plan mode
Fixed subagents with their own model being moved to the plan-mode model when the model setting is opusplan or haiku
Fix subagent context sizing on wrong model
Fixed subagents on a different model sizing file reads and MCP results with the main session's model
Fail shell commands after dir deletion
Fixed shell commands running in the launch directory after the working directory was deleted; the command now fails with a message and can be re-issued
Preserve plans when plansDirectory fails
Fixed an approved plan edit being lost when the plansDirectory folder can't take it: the plan is now saved in the default plans folder, and a warning says where and why
Fix sonnet[1m] setting rewritten on install
Fixed a saved sonnet[1m] model setting being rewritten on a new install to a model id the API rejects
Fix focus view hiding prompt replies
Fixed focus view hiding the reply to your prompt when a scheduled task replied after it
Fix missing prompt in subagent view
Fixed the prompt sometimes missing from a background subagent's view when fullscreen is off
Fix wrapped option text and first-run screens
Fixed long options in lists and permission prompts being partly overwritten when they wrap, and first-run screens losing lines on narrow terminals
Fix warnings marked seen when off-screen
Fixed startup warnings about permission rules and the "N MCP servers need authentication" notice being recorded as seen when they were scrolled out of view
Fix welcome header with control characters
Fixed the welcome header showing control characters or splitting across lines when an agent's name or the working folder contains them or a line break
Clarify user-only command error
Fixed the red error shown when Claude tries a command only you can run: a dim line now says it runs only when you type it at the prompt
Fix /stats active days off by one
Fixed /stats showing an Active days total that was one day too high
Fix /insights false-ready report and escaping
Fixed /insights saying a report was ready when no session qualified for analysis, and writing two values into its HTML report without escaping them
Explain why /voice setting didn't change
Fixed /voice saying voice mode changed when managed settings, --settings, or the project's .claude/settings.json or .claude/settings.local.json kept it as it was; it now says what holds it
Fix Quick Launch key shown on Windows/Linux
Fixed the IDE welcome dialog showing Cmd+Esc for Quick Launch on Windows and Linux
Hide Slack tips when cloud sessions denied
Fixed Slack app tips showing when your organization's policy denies cloud sessions
Fix claude purge hangs with no terminal
Fixed claude purge hanging silently when there is no terminal to read keys from, and its project picker and -i prompts ignoring the keyboard when stdin is piped
Reject empty --output-dir in plugin eval
Fixed claude plugin eval --output-dir '' writing the report into the current folder; it now exits with an error
Filter control sequences from claude -p output
Fixed claude -p text output on a terminal passing control sequences other than text styling; pipes and files are unchanged
Clean up leftover oauth lock files
Fixed leftover .oauth_refresh.lock.owner.tmp.* files piling up in the config directory
Fix wrong /fast disabled-by-org message
Fixed /fast saying "Fast mode has been disabled by your organization" under the keyless Console sign-in, where Claude Code had not asked the server
Fix wrong /model org-restriction message
Fixed /model saying that your organization restricts a model when Claude Code could not check that, for example with no network
Fix Console sign-in overwriting existing login
Fixed "Sign in with your Console account" in /login replacing your existing login when you pressed Esc right after the browser step
Fix success page shown on failed sign-in
Fixed the browser showing the sign-in success page in some cases where sign-in failed or was canceled
Fix lingering lock after claude auth status
Fixed claude auth status and other short commands leaving a lock behind on a Console profile, which made the next session hang for about a minute
Block more background sign-in switches
Fixed more cases of a session moving to another sign-in in the background; these moves are now refused, with a message saying what works
Fix exit dialog stopping refused background work
Fixed a second Enter in the exit dialog stopping background work after the move to the background was refused
Fix cloud credentials failing without HOME
Fixed AWS credential_process helpers and Google Cloud default credentials failing when Claude Code is started without a HOME environment variable
Fix permission mode reverting after plan approval
Fixed a session sometimes going back to an earlier permission mode after a subagent's plan was approved
Reject invalid applyFlagSettings() values
Fixed one invalid value in an Agent SDK applyFlagSettings() call silently discarding all settings from earlier calls; a call that would do this is now refused with an error
Fix wrong waiting-for-input status on PRs
Fixed sessions showing as waiting for input when a finished pull request only needed your own review or merge
Warn on unrecognized teammateMode values
Fixed an unrecognized teammateMode settings value being ignored without a warning: claude -p, the startup warning and claude doctor now list it as a skipped entry (still not applied)
Fix skipped WorktreeCreate hook on first run
Fixed --worktree skipping a WorktreeCreate hook from a plugin in CLAUDE_CODE_PLUGIN_SEED_DIR on the first run in a new home directory
Fix duplicate replies in brief-mode sessions
Fixed brief-mode sessions, such as Dispatch, sending a reply again after the turn had already replied
Fix false connector-failed message in cloud
Fixed Claude saying a working Atlassian, Asana or Sentry connector had failed in cloud sessions when a plugin listed it at a different URL
Fix MCP server listing after folder move
Fixed Claude Desktop and SDK sessions listing a folder's own MCP servers (.mcp.json, local) as host-added or not at all, and not connecting WebSocket ones, after a folder move or pre-warmed start
Fix stale MCP server after plugin reload
Fixed /mcp still listing a plugin's MCP server after a plugin reload removed it while it was connecting
Fix stuck auth state after brief token refusal
Fixed an MCP server staying "needs authentication", and its mcp_tool hooks being skipped, after a token refresh that was refused only for a moment
Fix MCP elicitation cancelled in headless mode
Fixed MCP elicitation requests being cancelled without asking in headless mode after a server's connection was replaced during a tool call
Fix false Not connected after reconnect
Fixed MCP tool calls from an SDK host answering "Not connected" after a tool call had reconnected the MCP server
Fix stuck MCP task after Esc on question
Fixed an MCP task getting stuck after its question was closed with Esc or asked again: the footer now says it needs your input, and Enter in /tasks shows the question again
Resume stalled MCP tasks after reconnect
Fixed background MCP tasks that stopped updating after another call to the same server lost the connection, when a later call reconnects
Fix MCP task question interrupting typing
Fixed a background MCP task's question opening over a message you were still typing; it now waits until you send or clear the draft, and the spinner and turn timer keep running
Fix sparse clones missing root files
Fixed worktree.sparsePaths and sparse plugin and marketplace clones leaving out the repository's root files on older git versions, such as 2.34
Fix mid-session repo addition in runners
Fixed self-hosted runner sessions with several repositories being unable to use a repository added mid-session
Stop needless prompts for your own artifacts
Fixed Claude asking for permission before reading your own artifact or its data
Fix Code Mode worktree and MCP state bugs
Fixed Code Mode scripts ignoring a worktree entered with EnterWorktree, writing ~ paths into the project, and leaving /mcp showing an MCP server as connected after its sign-in expired
Fix typed words lost at approval in Code Mode
Fixed words typed with a Yes at a permission dialog or plan approval not reaching Claude in Code Mode
Stop Claude starting work on resume unasked
Fixed Claude starting work by itself when you resumed a session that ended during a Code Mode script; it now waits for your next prompt
Add mid-turn user_prompt OpenTelemetry event
Fixed a missing OpenTelemetry user_prompt event for a message sent while tool calls run. The event has delivery.mode: "mid_turn" and the running turn's prompt.id
Fix merged-turn text missing from telemetry
Fixed the OpenTelemetry user_prompt event leaving out earlier messages' text when queued messages merged into one turn in VS Code, or when one message had an image
Scope /feedback and /bug uploads to your account
Fixed /feedback and /bug to upload other sessions only when they were recorded by the signed-in account or organization
Stop and explain unusual /teleport stash states
Fixed /teleport's stash choice in some unusual git states: it now stops and says what to do
Fix Windows start-up stall on blocked PATH
Windows: Fixed a start-up stall that could last about a second when a PATH entry sits under a folder your account cannot open
Fix /resume on differing Windows drive letters
Fixed /resume on Windows refusing or hiding sessions whose folder was recorded with a different drive-letter case or slashes
Preserve trust across Windows drive-letter case
Fixed an in-session /resume on Windows dropping a project's saved trust when the session was recorded with a different drive-letter case
Fix Linux sandbox bwrap error under symlinks
Linux: Fixed sandboxed Bash commands failing with bwrap: Can't create file when the working directory was below an allowRead folder inside a denyRead, such as under a symlinked home directory
Fix Desktop deployments stuck on Stopping
Fixed Claude Desktop's third-party deployments staying on "Stopping" until a token renewal finished (once it includes this version)
[VSCode] Fix stale model picker check mark
Fixed the model picker's check mark staying on the old model after Claude Code restarted on another model or the model was switched over Remote Control
[VSCode] Cap effort selector at org limit
Fixed the effort selector offering levels above the effort cap set by your organization or the maxEffortLevel setting
[VSCode] Hide sign-ins blocked by allowedProviders
Fixed the sign-in screen offering sign-ins that the managed allowedProviders setting refuses
[VSCode] Explain MCP tool permission prompts
Fixed the permission prompt for MCP tools not saying why Claude Code asks when a safety check raises the question
[VSCode] Match retry wording across org errors
Fixed the message for organization settings that couldn't load saying to run a command again; it now says to try again, matching the tab's Retry link
[Claude Code on the web] Raise MCP description cap
Fixed new cloud sessions cutting MCP tool descriptions loaded through tool search at 4,096 characters; the limit is now 16,384, as in other Claude Code sessions
[Claude Tag] Show a plain card on expired sign-in
Fixed artifact links pasted in Slack getting no card when the poster's Claude sign-in had expired in a workspace their organization doesn't manage; a plain card now appears