← Back to all releases
v2.1.328 Claude Code Release Notes
Claude's Analysisby Sonnet 5.5
Full AnalysisStability pass across Code Mode, terminals, Remote Control and cloud sessions, plus auto mode now on Bedrock, Foundry and Agent Platform for Opus 4.6 and Sonnet 4.6.
Changes
144
Total Changes (vs Average)
6.4×
Version Type
Patch
Release Focus
Bug Fixes
Day Since Prior Release
1
Release # This Month
#10 of 10
Bug Fix Ratio
63%
Post-Release Edits
—
How does this release compare? Release pace, fix share and issue trends since April 2025.See all-time statistics
Change Category
Ecosystem Impact
Self-Hosted Runner appeared in 9 of the last 10 releases and accounts for 25 items here. Remote Control and Cloud Sessions also appeared in 9 of 10, showing sustained attention to remote and hosted execution.
Key Themes
13Code Mode gets a deep cleanup|8Auto mode reaches third-party providers|25Self-hosted runner hardening|16Terminal input and clipboard polish|11Remote and cloud session reliability|15Slash command and plugin UI fixes
May Help If You've Noticed
Bash commands in zsh fail with a "not found" error on text like
echo ====Changes in Claude Code v2.1.328
Added14 changes
- •Added auto mode for Claude Opus 4.6 and Sonnet 4.6 on Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry and Claude apps gateway; interactive sessions with no permission mode start in it
- •Added
"onFailure": "block"formcp_toolhooks, as for command and HTTP hooks: a hook whose call fails blocks the action - •Added a warning when a message from a session that skips permission prompts may be held and dropped by a cloud session
- •Added a notice in
/statusandclaude doctorwhen an OpenTelemetry exporter has no endpoint and its data would likely be lost - •Added
CLAUDE_CODE_DISABLE_DEFERRED_TOOL_RESUME, which lets a host stopclaude -p --resumeand--continuefrom running a tool call that a hook deferred - •Added support for apps that embed Claude Code to switch on the policy plugin's
allowManagedModsOnlyoption; an admin's managed settings still win - •Added a startup warning to the Claude apps gateway when a policy's
maxEffortLevelis not a valid effort level - •Self-hosted runner: Added
--repository-folderto name the folder that sessions use for a repository at--capacity 1, in place of its path under the base folder, which can't be a symbolic link - •Self-hosted runner: Added a start-up warning when the host's settings.json sets a default permission mode that sessions ignore
- •Self-hosted runner: Added
--hook-labeltoclaude self-hosted-runner orchestrator, to hand chosen session labels to thespawn-runnerhook - •Self-hosted runner: Added
--metadata key=valuetoclaude --environment, to label a session for thespawn-runnerhook - •Self-hosted runner: Added
claude_code_self_hosted_orchestrator_session_queue_wait_by_reason_secondsto the orchestrator's/metrics, so a re-opened session's wait can be told from a new one's - •Self-hosted runner: Added an orchestrator metric,
claude_code_self_hosted_orchestrator_sessions_given_up_total, that counts by cause how often Anthropic gave up starting a runner for a session - •[VSCode] Added a notice when a message from another session is held, with a link to the settings file that can allow it
Improved19 changes
- •Improved
claude -pand SDK sessions to fetch managed-settings plugins that have their own git repository, in the background, for a later session - •Improved how soon managed-settings plugins from a git marketplace load on a fresh machine in
claude -p, SDK and Claude Desktop sessions; a short run may exit up to 30 seconds later - •Improved the time to resume large sessions
- •Improved memory use when resuming a session with many images
- •Improved memory use and response time in long SDK and desktop sessions that run slow commands or tools
- •Improved Code Mode's speed in auto and bypass-permissions modes by removing a 0.75 second pause after most scripts
- •Improved prompt caching for new Code Mode sessions that have MCP servers, and Claude is now told when a server is still connecting and when the list of servers changes
- •Improved Code Mode's token use with shorter tool descriptions
- •Improved Code Mode to show the command a script is running, and its output, while it runs
- •Improved Code Mode edits: an edit that changes nothing no longer stops a script, and Claude is told where a failed edit matches or comes closest
- •Improved Code Mode: Claude is now told which tool calls were still running when a script failed
- •Improved how Claude starts dev servers in Code Mode's auto and bypass modes: Claude is told to run them as background tasks that show in
/tasks - •Windows: Improved Code Mode by telling Claude that scripts' shell commands run in Git Bash and that PowerShell aliases run instead of functions with the same name
- •Improved starting several in-process teammates at once: far fewer now fail with "Lock file is already being held"
- •Improved the computer use approval dialog: it now shows each app's level of access and plainer warnings
- •Improved cross-session messaging: Claude now explains that Remote Control is off when a cloud session or another computer is not listed
- •Improved
claude -ptext output to say on stderr when a message from another session is held or dropped, and how to allow it - •Improved Claude's answers on who can open an artifact it published: Claude is now told to check the artifact again instead of repeating the last publish's answer
- •Improved resumed self-hosted runner sessions: Claude now checks whether its earlier work is still there, and says what is missing
Fixed91 changes
- •Fixed Bash commands in zsh stopping with a "not found" error at a word that starts with
=, such asecho ====or[ a == b ];=cmdno longer expands to a command's path - •Fixed automatic compaction reusing the session's earlier system prompt instead of rebuilding it the way
/compactdoes - •Fixed markdown rendering freezing on some very long or malformed input
- •Fixed rare screen freezes
- •Fixed Esc often being lost at a permission prompt or question when you typed straight after it; in terminals that send Alt as Esc and a key, an unused Alt or Option key now declines there
- •Fixed a paste or a terminal's reply being typed into the prompt when a slow connection cut it in two
- •Fixed saving a scheduled task erasing the project's other saved tasks when the scheduled tasks file can't be read, on third-party providers or with telemetry or feature flags turned off
- •Fixed a scheduled task with a typo in the project's scheduled tasks file being deleted the next time that file was saved
- •Fixed a case where a resumed cloud session could lose its compaction summary or recent messages when a message was saved late
- •Fixed the token counts on the spinner and for subagents counting a retried reply twice, missing replies that were not streamed, and standing still while Claude thinks
- •Fixed the error shown when usage credits run out mid-response, which named a rate limit
- •Fixed auto mode failing every turn outside Claude Desktop with
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASset behind a gateway rejecting betas, on Bedrock, Agent Platform, Foundry or Claude apps gateway - •Fixed
CLAUDE_STREAM_IDLE_TIMEOUT_MSnot lengthening the 5-minute connection limit on gateways, custom base URLs and cloud providers - •Fixed some Claude Desktop sessions on third-party providers, other than scheduled tasks, ending for good with "Prompt is too long" after large tool results; the largest are now left out
- •Fixed MCP tools whose input schema starts with
anyOf,oneOforallOfgoing missing on third-party providers or with telemetry or feature flags turned off - •Fixed an MCP tool with an invalid input schema failing requests on third-party providers or with telemetry or feature flags turned off; the tool is now left out and Claude is told why
- •Fixed effort being turned off for a subagent's model for the session if Bedrock, Google Cloud's Agent Platform or Foundry refused its progress summary's effort setting (regression in 2.1.327)
- •Fixed Code Mode stopping a script when a permission prompt outside auto or bypass mode, a plan approval or a question stayed open for ten minutes
- •Fixed Code Mode scripts in auto and bypass-permissions modes failing to call an MCP server that had connected while the previous script was running
- •Fixed Code Mode scripts not running in the background in auto or bypass permissions mode in a session chosen in the
claude --resumepicker - •Fixed Code Mode losing a loaded skill, hook context or a note typed with a permission approval when resuming a session in which one reply ran several scripts
- •Fixed Claude not being told that a Code Mode script was cut off when the session was resumed from the picker or in a mode that asks for permission
- •Fixed Code Mode silently using
undefinedfor top-level variables that an earlier failed script never set - •Fixed Code Mode scripts not being told when a failing command's long output was cut
- •Fixed Code Mode refusing valid scripts that start with a
{block - •Fixed Code Mode refusing scripts that use both a top-level
awaitand a top-levelreturn - •Fixed an @-mentioned small file not being attached in Code Mode after a script had read or written it
- •Fixed Code Mode offering
write()andedit()to read-only subagents that can't call them - •Fixed Claude starting a turn by itself in Code Mode when Esc was followed by a command such as
/model - •Fixed Claude in Code Mode not being told to run workflows only when you ask, or the workflow size you set in
/config - •Fixed Remote Control repeating the same disconnect message, and telling you to retry a session that can't reconnect
- •Fixed a waiting permission prompt being lost, and its answer ignored, when a remote session restarted while the service was slow
- •Fixed cloud sessions resuming a cleared conversation after a rewind followed by
/clear - •Fixed a remote session losing a turn's tool calls and results when its runner or worker was lost after a dropped model stream had been retried
- •Fixed cloud and Remote Control sessions that just started, or have an @ in their title, being unreachable in cross-session messaging from a session with Remote Control on
- •Fixed Claude being told that cloud sessions can never reply; it now learns when a reply can come and how else to get the result
- •Fixed
/diff, the Changes pane of Remote Control sessions and the diff beside an edit leaving out committed work after a command moved into another repository - •Fixed Remote Control not showing a running workflow's agents when a session run by an IDE extension or other SDK app is opened over an hour after the workflow last made progress
- •Remote Control: Fixed an idle Desktop or VS Code session showing as running after Remote Control is turned on
- •Fixed the model saying background agents were still running after an SDK interrupt had stopped them
- •Fixed Send now in the desktop app and SDK hosts telling Claude that a stopped web search found no results
- •Fixed Cmd+letter being typed into the prompt in terminals that report Cmd
- •Fixed Ctrl+click opening a link twice in GNOME Terminal, side mouse buttons acting as clicks, and the first wheel notch in the other direction being ignored after a pause, in fullscreen mode
- •Fixed Shift+Enter in Konsole outside tmux and ssh, and Alt shortcuts on non-Latin keyboard layouts in terminals that speak the kitty keyboard protocol
- •Linux: Fixed pasting in other apps freezing while Claude Code is suspended with Ctrl+Z, when
xcliporwl-copyis installed - •Linux: Fixed Ctrl+V missing the clipboard image, pasting an old one or hanging
- •Fixed text copied in fullscreen mode including the quote bar, losing spaces at line wraps when a drag scrolled upward, or missing words under the "Jump to bottom" pill
- •Fixed an image path pasted into a
!command becoming an attachment - •Fixed Ctrl+C showing no exit warning while the
?shortcuts list is open - •Fixed Ctrl+R search in fullscreen mode and the
/themecolor editor picking the wrong row when keys arrive together, and keys being dropped there and in the search of/configand/plugin - •Fixed wrong or missing colors inside GNU screen
- •Fixed many background notifications cutting into the top border of open dialogs in fullscreen mode
- •Fixed a message to a background agent showing a long file path in place of a pasted image
- •Fixed
/goalremoving a skill's Stop hook, or ending early on another hook's result, when both had the same wording - •Fixed
/bugsaying cancelled after the report was sent - •Fixed Esc not dismissing the transcript share question for Pro and Max users
- •Fixed
/hookslosing your place when going back - •Fixed
/exportwriting a file named.txtwhen the name was left empty - •Fixed
/terminal-setupin Zed replacing a symlinkedkeymap.jsonwith a plain file - •Fixed
/install-github-appadding a code review workflow when asked to update the existing workflow file - •Fixed
/pluginreopening a skill, or closing the open page, when a slow save or removal finished after you went back - •Fixed
/pluginasking to uninstall the wrong plugin, or ignoring Esc, after leaving a plugin while a change was still running - •Fixed typing and arrow keys not working on the
/pluginInstalled tab after a search with no results or a click on the tab row - •Fixed holding Enter in
/pluginturning off several installed plugins - •Fixed the
/usageplugin total stopping at 2,000 tokens on 1M context models, and low token estimates in/usageand/pluginwhen no model is picked - •Fixed Esc on the Bedrock access keys step closing
/logininstead of going back - •Fixed
/exitand Ctrl+D describing running work differently, and/exitwarning about a workflow that had stopped - •Fixed Claude calling an artifact private after reading one in a shared folder or publishing to another organization's, and saying only named people can open one when its folder's people can too
- •Fixed a plugin's toast sometimes showing another plugin's text
- •Fixed a mod saved just after a turn began sometimes reloading mid-turn instead of at the turn's end
- •Fixed one malformed
OTEL_RESOURCE_ATTRIBUTESentry dropping the variable's other labels from metric points, events, and spans. Now only that entry is left off - •Fixed agent hooks running past their timeout while compacting after a request was refused as too large
- •Fixed a crash at startup when
FORCE_COLORis set to a negative number - •Fixed a crash in secret masking when the machine is almost out of memory
- •Fixed the Bash sandbox on Linux renaming
.git/HEADafter each command when the branch name is not valid UTF-8 - •Self-hosted runner: Fixed all running sessions being stopped when a proxy or web filter answered a poll with HTTP 200 and a body such as
{}; the runner now retries such a poll - •Self-hosted runner: Fixed deletion of a kept clone's objects or refs, and of commits that existed only there, after a temporary disk error; that start now fails instead
- •Fixed self-hosted runners stopping when their token ran out on a host whose clock is slow or was set back
- •Self-hosted runner: Fixed sessions with Anthropic-managed git losing git access to GitHub after a script or hook in the session ran
claudeagain - •Fixed self-hosted runners with Anthropic-managed git being unable to fetch or push where the machine's git config sets
http.proactiveAuth - •Self-hosted runner: Fixed a runner that exited without telling the server when setup failed after it had registered; it now deregisters with a reason, and an on-demand runner reports the failed start
- •Self-hosted runner: Fixed archiving or requeueing a session not taking effect while it waited for another session to prepare the same repository (
--capacityabove 1) - •Self-hosted runner: Fixed a session with a damaged
.claude.jsonfailing every later start under--trust-workspace false; it now starts on defaults, with MCP servers turned off there on again - •Self-hosted runner: Fixed a failed start's message losing the words that say what failed when a checkout hook or git printed a lot
- •Fixed the self-hosted runner skipping its post-session hook when a disk stalled for a few seconds; on a dead disk a session's end can take 25 seconds longer by default
- •Fixed self-hosted runners: a session that resumes in a new Claude config directory no longer loses its task list
- •Fixed Claude not being told when a self-hosted session starts without one of its repositories, and why
- •Self-hosted runner: Fixed
--correlation-idofclaude --environmentnot reaching thespawn-runnerhook - •Fixed the self-hosted runner setup wizard's key rotation advice, which now warns that revoking a key stops the sessions running under it
- •[VSCode] Fixed the permission prompt cutting off its No button, reply field or title when the panel is low or a command, URL or description is long
- •[VSCode] Fixed failed or blocked tool calls showing no reason or a reason cut short, and Glob and Grep counting an error as results
Changed20 changes
- •Changed plan mode and Bash prompts for Opus 4.6 and Sonnet 4.6 on third-party providers to use and offer auto mode, as on newer models;
disableAutoModeturns both off - •Changed Code Mode to no longer run UserPromptSubmit hooks, managed ones included, on scripts' output; to redact that output, use a PostToolUse hook with
updatedToolOutput - •Changed
/code-reviewon most models to report only bugs and CLAUDE.md violations; run/simplifyfor reuse, simplification and efficiency cleanups - •Changed
/code-reviewto mark each finding Important, Pre-existing or Nit on most models, and to end each summary with a suggested fix; a clean review's list now reads "Code review found no issues." - •Changed
deniedMcpServersentries of the formclaude.ai <name>to apply to that connector in cloud and self-hosted runner sessions too - •Changed managed
PostToolUsehooks to no longer fire for calls refused before they ran: no log entry, rewrite, block or stop there;PostToolBatchgets most, not marked as refused - •Changed
/bugto ask Yes or No before sending, so repeated Enters no longer send a report or open GitHub - •Changed subagents in
claude -p, the Agent SDK, desktop and VS Code to wait for their own subagents by default whenCLAUDE_CODE_FORK_SUBAGENT=0is set - •Changed
claude -pwithCLAUDE_CODE_FORK_SUBAGENT=0to count a background subagent and those it waits for against one 10-minute wait; raiseCLAUDE_CODE_PRINT_BG_WAIT_CEILING_MSfor longer chains - •Changed a shell command rewritten by a PermissionRequest hook to a sandbox-excluded command to run outside the sandbox
- •Changed the Claude in Chrome welcome screen and
/chrometo say that Claude Code asks before Claude acts on a site, unless your permission mode or a rule in/permissionsanswers - •Changed Claude Desktop and Agent SDK sessions on third-party providers or with telemetry or feature flags off to end the turn when closed with a question open, instead of continuing without an answer
- •Changed pasted text to be marked for Claude as pasted, on third-party providers or with telemetry or feature flags turned off
- •Changed subagent progress summaries in terminal sessions on the Anthropic API to be written by the default small fast model from short notes, also with telemetry off, using far fewer tokens
- •Changed how a sandbox that can't start is reported, unless
sandbox.failIfUnavailableis set: the next sandboxed Bash command is refused and says that the sandbox is off for the session - •Changed
/list-agentsto show its list to you alone; Claude lists sessions itself when needed - •Self-hosted runner: Changed the built-in
gh apito be off by default where settings guard Claude's GitHub tools by name;--use-anthropic-gh trueturns it on - •Self-hosted runner: Changed a
claudethat a wrapper script runs before the session's ownclaudeis up, or after it has ended, to have no Anthropic-managed git - •Self-hosted runner: Changed
CLAUDE_RUNNER_SESSION_UUIDandCLAUDE_CODE_REMOTE_SESSION_UUIDto both be set for the session and itscheckout,post-sessionandspawn-runnerhooks - •Changed self-hosted runners at
--capacity 1to refuse a session earlier when the path of a repository it pushes to is a symbolic link