Claude Code 2.1.225

Saturday, 8 August 20262 new9 fixes3 other

AI summary

Written by AI from the official notes. Check them for exact details.

Claude Code 2.1.225 introduces new features for usage warnings and workspace trust prompts, along with several bug fixes.

Added gateway spend-limit support with detailed usage warnings.
Introduced workspace trust prompt for untrusted directories.
Fixed OAuth token issues causing session disruptions.
Improved Remote Control photo handling directly from the app.
Enhanced SendMessage to initiate conversations with Remote Control sessions.

Why it matters: Users of Claude Code should update to benefit from improved functionality and resolved issues.

Official notes on github.com

Full release notes14 changes

What's changed

Added gateway spend-limit support to Claude Code's usage warning; the limit-reached message now names the cap, its reset time, and the operator's message (requires the gateway on 2.1.225)
Added a workspace trust prompt to claude agents for untrusted directories, matching the behavior of claude
Fixed a transient 401 replacing a long-lived CLAUDE_CODE_OAUTH_TOKEN with a stored login's short-lived token, breaking headless sessions until restart
Fixed MCP OAuth servers on macOS intermittently failing with a burst of 401 errors, as if never authenticated, after a keychain read timed out
Fixed auto mode counting a safety-filter refusal of its own permission check toward the consecutive-block limit; the action is still denied, but the model is now told to move on rather than retry
Fixed cross-session messages staying parked without a notice or expiry in headless sessions and during startup
Fixed conversation history breaking on Remote Control session resume after very large conversations were compacted
Fixed hovering over a session in another project in the agents list changing the directory the next agent starts in
Fixed claude self-hosted-runner registering and then failing every session when --base-dir cannot be created or written; it now exits at startup with a clear error
Fixed Claude Code on the web sessions being misreported as stuck, re-sending a growing event backlog on every reconnect
Improved Remote Control: photos attached from the Claude app are now shown to Claude directly instead of being read from disk with a separate tool call
[VSCode] Fixed Focus view folding away the latest to-do list, a pending question's context, and settled answers; thinking-only folds show "Thought for Ns" and re-collapse when their turn completes
SendMessage can now start a conversation with your Remote Control sessions on other machines by name (ListAgents shows them as name [ref]), instead of only replying after they message you first
SendMessage: a Remote Control recipient you already confirmed is never swapped for a same-named session on this machine when its own list couldn't be checked

Full release notes14 changes

What's changed

Added gateway spend-limit support to Claude Code's usage warning; the limit-reached message now names the cap, its reset time, and the operator's message (requires the gateway on 2.1.225)
Added a workspace trust prompt to claude agents for untrusted directories, matching the behavior of claude
Fixed a transient 401 replacing a long-lived CLAUDE_CODE_OAUTH_TOKEN with a stored login's short-lived token, breaking headless sessions until restart
Fixed MCP OAuth servers on macOS intermittently failing with a burst of 401 errors, as if never authenticated, after a keychain read timed out
Fixed auto mode counting a safety-filter refusal of its own permission check toward the consecutive-block limit; the action is still denied, but the model is now told to move on rather than retry
Fixed cross-session messages staying parked without a notice or expiry in headless sessions and during startup
Fixed conversation history breaking on Remote Control session resume after very large conversations were compacted
Fixed hovering over a session in another project in the agents list changing the directory the next agent starts in
Fixed claude self-hosted-runner registering and then failing every session when --base-dir cannot be created or written; it now exits at startup with a clear error
Fixed Claude Code on the web sessions being misreported as stuck, re-sending a growing event backlog on every reconnect
Improved Remote Control: photos attached from the Claude app are now shown to Claude directly instead of being read from disk with a separate tool call
[VSCode] Fixed Focus view folding away the latest to-do list, a pending question's context, and settled answers; thinking-only folds show "Thought for Ns" and re-collapse when their turn completes
SendMessage can now start a conversation with your Remote Control sessions on other machines by name (ListAgents shows them as name [ref]), instead of only replying after they message you first
SendMessage: a Remote Control recipient you already confirmed is never swapped for a same-named session on this machine when its own list couldn't be checked