Claude Code 2.1.295
143changes- Open files Claude sends you right from the VS Code chat.
- Show Claude Code's working, waiting, or done status in terminals that support OSC 7501.
- Fix a terminal freeze of seconds to minutes while syntax-highlighting very long or unusual code.
- Fix --tools and --restricted letting late-registering or deprecated-name tools run outside the allowed set.
- Fix a Chrome site deny rule on port 80 not blocking plain http pages on that host.
New features
17[VSCode] Open files Claude sends from chat
Added a chat row for files Claude sends you: click a file's name to open it in the editor; Claude's caption shows underneath, and the row stays visible in Focus view
Support OSC 7501 terminal status
Added Program Status Protocol (OSC 7501) support: terminals that implement it can show whether Claude Code is working, waiting on you, or done
Add $.ui.notify for mods
Added $.ui.notify for mods: raises a native notification through your own notification setting and says which channel sent it
Block actions on hook failure
Added onFailure: "block" for command and HTTP hooks: a hook that can't start, times out, or exits with an unexpected code blocks the action instead of letting it through
Add upstream_ttfb_ms gateway timeout
Added support for timeouts.upstream_ttfb_ms on the Claude apps gateway's Bedrock, Vertex, Foundry and other cloud upstreams: a value you set now limits how long a stream may take to start there, after which it fails over or gets a 502
Restrict gateway upstreams by model
Added an optional models list to every Claude apps gateway upstream: only the listed models are sent there, on failover too, and one * in an entry is a wildcard
▤ In the docsMore changes (11) Fewer changes
Copy quoted text without markers
Added quoted text to the /copy picker, so a drafted message copies without its > markers
Warn when plugin settings fail to load
Added a warning to claude plugin install, enable, disable and marketplace add when the settings file they write to does not load
Explain what claude -p is waiting for
Added a line on stderr, when it is a terminal, that says what a claude -p run is waiting for when it stays open after its last turn
Show message on cancelled backgrounding
Added a "Backgrounding cancelled" message when you stop the turn while ← is waiting for the current tool to finish
Force gateway login with no managed settings
Added support for forceLoginMethod: "gateway" and forceLoginGatewayUrl in your own user settings on machines with no managed settings, so /login opens on that Claude apps gateway
▤ In the docsAdvise on missing plugin install line
Added advice to claude plugin validate when a plugin's README has no install line: it prints the line to paste and never changes the exit code, even with --strict
Record upstream request ID in audit log
Added upstream_request_id to the Claude apps gateway's inference audit event: the request ID from Amazon Bedrock, the Anthropic API or another upstream, for support cases
Add children to mod Buttons
Added children to a mod's Button: strings and Text, so a row of a list is one pressable with a chip or a dim detail inside
Cap retry watchdog wait time
Added CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS to limit how long unattended retry mode (CLAUDE_CODE_RETRY_WATCHDOG) waits out 429 and 529 errors
Match gateway request IDs to telemetry
Added a request-id header to the Claude apps gateway's successful inference responses, so request_id in Claude Code telemetry matches the gateway's audit log
[Claude Tag] Confirm before changing manager roles
Added a confirmation in Claude Tag admin settings before adding a channel manager moves that member to Custom roles, which can remove their other access
Improvements
29More changes (28) Fewer changes
Use AWS CountTokens for token counts
Improved token counts behind a Claude apps gateway on Amazon Bedrock, which /context and large file reads use: the gateway now gets them from AWS's CountTokens API instead of a one-token model request. Grant bedrock:CountTokens to use it
Warn when the gateway database is read-only
Improved the Claude apps gateway to log a warning every 30 seconds while its PostgreSQL database is read-only, saying what fails and how to recover
Name MCP tools clearly in permission status
Improved the status shown in Remote Control, claude.ai and the desktop app for a session waiting on a permission prompt to name an MCP tool by its server and readable name instead of its mcp__server__tool identifier
Use Haiku 4.5 for background gateway requests
Improved background requests behind a Claude apps gateway to use Haiku 4.5 instead of the session's model, falling back to the session's model where the gateway does not serve Haiku 4.5
Try your own Bedrock region first
Improved how the Claude apps gateway handles models not listed under models: in Amazon Bedrock regions outside AWS's US geography. AWS always refused those requests; the gateway now tries the model in your own region, and a refusal names the model to add
Note extra usage status in limit warnings
Improved headless rate_limit_event usage-limit warnings to say whether the account has extra usage turned on
Refine the plugin-authoring skill's guidance
Improved the built-in plugin-authoring skill: it no longer tells a session with no terminal to run terminal commands, and explains sharing a mod only when asked
Accept grep-style flags in Grep calls
Improved Grep input handling: a search sent with grep's -l, -c or -r flag now runs instead of failing the call
Explain rebound var errors in plugin loading
Improved claude plugin validate and plugin loading: when a hooks module is refused over a rebound top-level var, the error now names the line that rebinds it, the cause, and a fix
Point to inline scripts on scriptPath refusal
Improved the Workflow tool's scriptPath refusal: it now says to pass the script inline via script, the route that works in sessions without a Read tool
Report failed uploads instead of shrinking files
Improved what Claude is told when a large file it sends fails to upload with no reason given, so it reports the failure instead of shrinking the file
Raise MCP tool description cap to 16,384
Changed MCP tool descriptions the model loads through tool search to be cut at 16,384 characters instead of 2,048
Cap preloaded subagent skills at 32
Changed subagents to preload at most 32 skills from the skills field, each once; a subagent with the Skill tool can still invoke the rest
Keep loop wakeups alive on first Ctrl+C
Changed Ctrl+C at the idle prompt of an attached background session to leave a pending /loop wakeup alone, so pressing it twice detaches and the loop keeps running; press Esc to stop it
Stop sessions a minute after agents halts
Changed claude agents stopped with its background service (macOS, or Linux without the service installed): running sessions now stop in about a minute unless it is run again, and a notice says so
Show Artifacts on white by default
Changed Artifact pages with no background of their own to show on white instead of off-white
Clarify post-run tool denials from mods
Changed what Claude and you read when a mod denies a tool call after the tool ran: it now says the tool ran and a plugin withheld its result
Fix tab stops in indented text
Changed tab stops to count from where a text starts instead of from the screen's left edge: an answer indented by 2 has its first stop 8 cells in, where it was 6
Match Artifact prompts with telemetry off
Changed the Artifact tool's permission prompts with telemetry disabled to the same five questions other installs get, instead of asking before each read of someone else's artifact and each data edit
Skip extra asks for telemetry-off routines
Changed scheduled and Run now routine runs in installs with telemetry disabled to publish new private artifacts, and update your own, without asking, as in other installs
Prioritize org mod toasts
Changed toasts from your organization's mods to show ahead of other mods' toasts instead of waiting behind them
Let unknown desktop policy keys through
Changed the Claude apps gateway to start with a warning and serve a desktop policy key its bundled Claude Desktop schema doesn't know, so new Desktop settings need no gateway upgrade
Cap WebSocket MCP messages at 16 MiB
Changed WebSocket (ws) MCP servers: a message over 16 MiB is no longer parsed and closes the connection, the limit the other transports already have
Self-hosted runner: stop passing CCR_AUTO_MODE vars
Self-hosted runner: Changed the runner to stop passing CCR_AUTO_MODE_ALLOW, CCR_AUTO_MODE_ENVIRONMENT and CCR_AUTO_MODE_SOFT_DENY into a session's environment
[Cloud sessions] Catch up activity all at once
Improved how quickly a cloud session catches up after its connection drops: activity you missed now appears all at once instead of row by row
[Cloud sessions] Resize the setup script box
Improved the setup script box in the cloud environment form: it starts taller, grows with your script, and can be resized by dragging
[Claude Tag] Keep settings cards open longer
Changed the settings confirmation cards Claude posts in a Slack channel to stay open for 30 minutes instead of 10
[Claude Tag] Limit Enterprise Grid default notices
Changed Claude's notice that a channel shared across Enterprise Grid workspaces uses organization defaults to post only when someone mentions Claude, at most once a month
Bug fixes
97Fix freezes during syntax highlighting
Fixed the terminal freezing for seconds or minutes while syntax highlighting code with very long lines, long runs of blank lines, or unclosed strings and heredocs
Apply tool restrictions to late tools
Fixed --tools and --restricted not applying to built-in tools that register after launch, and deprecated tool names reaching tools outside the caller's tool set
Apply Chrome deny rules to port 80
Fixed Claude in Chrome not applying a site deny rule written with port 80 (host:80) to plain http:// pages on that host
Block calls bypassing guards during reload
Fixed calls a mod makes while it reloads during a plugin hooks worker restart getting past another mod's guard hook that has a .catch; such calls are now refused
Stop truncated input from fooling guards
Fixed a mod's hook being handed a deeply nested tool input cut short with no error, so a guard could pass content it never saw
Reject tampered managed settings cache
Fixed a tampered cache of server-managed settings making a person's own plugin count as organization-managed on machines whose managed settings list or enable plugins
More changes (91) Fewer changes
Retry [1m] requests without the beta
Fixed every request failing on a [1m] model when a gateway, Bedrock, Vertex or Foundry refuses the context-1m beta; Claude Code now resends without it
Fix claude -p dropping earlier output
Fixed claude -p text output dropping earlier responses when background work started another turn; each turn's response now prints when the turn ends
Back off remote MCP reconnect attempts
Fixed remote MCP servers in headless and SDK sessions staying disconnected after an outage longer than 15 seconds, or reconnecting in a tight loop to a server that drops each connection right after it connects; repeated drops now back off, up to 30s
Stop MCP drops on misread error text
Fixed remote MCP connections being dropped when a server's error reply happened to contain a network error name
Stop repeated MCP pagination requests
Fixed MCP servers that repeat a pagination cursor being asked for the same page up to 20 times at every connect
Fix wrong extensions on MCP file output
Fixed CSS, JavaScript and XML files returned by MCP tools being saved as .bin, which the Read tool refuses; font and icon files now get their own extension too
Fix Bash calls with command_description
Fixed Bash tool calls failing when the model passes command_description instead of description
Confirm before removing failed marketplaces
Fixed /plugin's Errors tab removing a marketplace that failed to load, and uninstalling its plugins, on Enter without asking first
Refuse marketplaces with unusable names
Fixed claude plugin marketplace add reporting success for a marketplace whose name no plugin can be installed under; such an add is now refused
Fix background task race with pending calls
Fixed CLAUDE_AUTO_BACKGROUND_TASKS moving a subagent to the background while an edit or shell command waited behind it, which started that call before the subagent finished
Fix false push-not-sent warnings
Fixed PushNotification saying a push was not sent in claude remote-control sessions right after a phone message, without the /config toggle, or when started from inside Claude Code
Allow more than 256 remote file sends
Fixed files sent from remote sessions being refused as "could not be vouched for" when more than 256 were sent at once
Fix managed settings failing after login
Fixed a rare failure to load managed settings at startup right after a login refresh
Show a clear error when /tui can't restart
Fixed /tui exiting without a message, or with a raw system error, when Claude Code could not be started again
Fix hidden link text under reply styling
Fixed a link address shown as text being hidden by a colour or conceal style a reply left on, including where it wraps in a table or a question preview
Fix duplicate rows for Fable models
Fixed Fable models listed in availableModels not appearing in the /model picker for sessions signed in to a Claude apps gateway; such a model now shows its built-in row in place of a modelPicker row added for the same model
Refresh gateway spend view group data
Fixed the Claude apps gateway's admin spend view showing a developer's old groups and group cap after their session stopped carrying groups
Show spend limit with nonessential traffic off
Fixed CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC hiding the Claude apps gateway spend limit in /usage and the status line. The spend limit request goes to the gateway the session is signed in to
Fix worktree subagents showing parent git info
Fixed subagents in their own linked worktree being shown the parent session's git branch, status and recent commits
Keep working after cancelling backgrounding
Fixed Claude stopping at the end of the current tool when text typed in the prompt cancelled backgrounding with ←; Claude now keeps working in the foreground
Fix slow interrupt during MCP resource list
Fixed an interrupt not ending the turn until a timeout while Claude waited for an MCP server's resource list
Fix Esc not stopping backgrounded loops
Fixed Esc not stopping a self-paced /loop that was moved to the background with ←; cancelling a pending wakeup now shows a notice
Strip color codes from background output
Fixed commands and hooks in background sessions inheriting FORCE_COLOR=3, which put color escape codes into the output Claude reads
Fix claude agents restarting on shutdown
Fixed claude agents starting a new background service as it exited when both were stopped with a session open (for example at a reboot), which could delay shutdown and restart an interrupted session
Show custom agent names in denial notices
Fixed a custom agent named worker being shown as "Agent" in auto-mode denial notices and in the activity lists of task detail views
Improve glob for-loop permission checks
Fixed Bash permission checks for for-loops over glob patterns, improving permission-check accuracy
Fix forked skill results reaching wrong agent
Fixed forked skills invoked from Workflow subagents delivering their results to the main conversation instead of the invoking agent
Fix teammates' first SendMessage failing
Fixed in-process agent teammates failing their first SendMessage call until they loaded the tool through tool search
Fix wrong TaskStop blame on resume
Fixed Claude being told on resume that an unfinished background workflow may have been stopped by TaskStop, which can never be the cause
Tell Claude about stopped MCP tool calls
Fixed Claude not being told when you stop a long-running MCP tool call from the tasks panel or a connected client
Notice background loop stops on process down
Fixed a background session's /loop stopping without notice when its next wakeup came due while the session's process was down; the session now says so and Claude is told
Stop raw hyperlink bytes rendering as links
Fixed raw terminal hyperlink bytes in a reply or a teammate's message being drawn as a clickable link with a hidden address
Skip unneeded submodules on marketplace add
Fixed plugin marketplaces whose repository has large git submodules failing to add or refresh: only the submodules that hold plugin files are now fetched
Fix stale checkmark in advisor dialog
Fixed the /advisor dialog showing a checkmark on a saved advisor model that is no longer available; it now opens on "No advisor"
Show full task ID in MCP notifications
Fixed the notification for an MCP tool call that moved to the background showing a shortened task id
Fix vim tilde moving past line end
Fixed vim mode's ~ moving the cursor past the last character of a line, so x after it did nothing, and 3~ running on into the next line
Fix cursor offset after pasting accents
Fixed the cursor landing one character too far after pasting accented text copied from macOS (such as a file name) into the middle of the prompt
Fix freeze on very long responses
Fixed the terminal freezing, with ctrl+c ignored, when a response ran to tens of thousands of lines
Explain plugin load failures from deep nesting
Fixed plugins whose hooks module nests code thousands of levels deep failing to load or validate with a bare stack-overflow message
Fix plugin test keeping real session data
Fixed claude plugin test passing a session.append hook that removes tool call, tool result or thinking blocks that a real session keeps
Fix missing resume hint after double kill
Fixed Claude not being told it can resume background subagents with SendMessage after a session was killed and resumed a second time
Fix files wrongly marked as read
Fixed a file being treated as already read after a Bash command such as cat ran without printing it
Fix plugin options named constructor
Fixed plugin options named constructor or prototype always reading as their default and never reloading the plugin when edited
Fix hot reload missing concurrent saves
Fixed a mod's hot reload missing a save made while /reload-plugins or session start was reading the mod's files
Stop repeated hot-reload prompts
Fixed the mod hot-reloading question being asked again every turn for the whole session when it is approved without picking an answer
Ask config.set hook before saving settings
Fixed /model, /fast and /output-style saving their setting without asking a plugin's config.set hook
Fix bold text drawn faint after dim
Fixed bold text being drawn faint in piped output when it directly follows dim text
Fix freeze from deeply nested quotes
Fixed replies whose quotes nest deeper every few lines freezing the terminal for seconds and using gigabytes of memory
Fix hot reload missing rapid saves
Fixed a mod's hot reload missing a save made within a few milliseconds of its last reload, which left the mod on its old version until the next save
Name the output file in mcp serve results
Fixed claude mcp serve background Bash results not naming the output file, and its tool description promising a notification that never arrives
Stop duplicate SessionStart context on resume
Fixed an async SessionStart hook's unchanged context being added to the conversation again on every resume
Fix CLAUDE_ENV_FILE vars lost on resume
Fixed variables a SessionStart hook writes to CLAUDE_ENV_FILE not reaching the Bash tool after an in-app /resume or /branch
Preserve skill permissions in -p runs
Fixed a skill's allowed-tools and effort being dropped when the Skill tool finished before the response stream ended, which denied the skill's Bash commands in -p runs
Stop offering tool search to old models
Fixed Claude 3 Opus and Claude 3.x Sonnet sessions being offered tool search, which those models reject, where feature flags are unavailable
Keep generated types out of plugin folders
Fixed generated type files being written into a --plugin-dir plugin's folder in -p and SDK sessions; they are now written only where a mod is being developed
Fix tab and bidi text rendering glitches
Fixed text with tabs or bidirectional control characters losing its end at the edge of the screen or drawing over nearby rows
Fix Max effort wrongly saved as default
Fixed /model saying a Max effort pick was saved as your default for new sessions; Max applies to the current session only
Fix multi-line async hook output ignored
Fixed an async hook's JSON output being ignored when it is printed over several lines
Accept an empty pages parameter in Read
Fixed the Read tool rejecting calls with an empty pages parameter instead of treating it as omitted
Fix plugins failing on Windows drive casing
Fixed project-scope plugins not loading in VS Code on Windows due to drive-letter casing (anthropics/claude-code#74612)
Fix duplicate installs from drive casing
Fixed plugin install and uninstall at project or local scope on Windows missing the install record, or adding a second one, when only the drive letter's case differs
Fix queued message lost after backgrounding
Fixed a queued message being lost when pulled back into the prompt with ↑ or Esc just after ←: prompt history now keeps it
Retry hot-reload prompt on closed question
Fixed mod hot-reloading turning off for the whole session when an SDK host closed its enable question before anyone answered; the question is now asked up to three times
Fix hook-edited prompts saved as original
Fixed a prompt that a mod's prompt.submit hook rewrote or dropped still being saved as typed to prompt history and to the transcript's queued-prompt records
Skip unused MCP auth notices in headless
Fixed non-interactive sessions telling you about MCP servers that need authentication when your request doesn't use them
Emit auth events on gateway sign-in
Fixed the claude_code.auth OpenTelemetry login event not being emitted on Claude apps gateway sign-in. The event is exported when OpenTelemetry is configured on the machine or the session is already signed in to the gateway
Stop large plugins unloading others
Fixed a plugin that adds very large interfaces getting another plugin unloaded when the plugin hooks worker stalls
Detect file changes without new mtime
Fixed Edit treating a file as fully read when its contents changed without its modification time advancing
Fix CRLF output drawn on one line
Fixed short command output with Windows line endings (CRLF) being drawn on a single line
Fix scheduled tasks after rewind and resume
Fixed a stopped scheduled task coming back on resume after a rewind, and a scheduled task being lost on resume after Esc or a rewind following a compaction
Clean up leftover ultrareview temp files
Fixed temporary files left under ~/.claude/seed-admin by an interrupted /ultrareview upload never being removed by the retention cleanup
Fix auto mode staying off after setting removed
Fixed Desktop and SDK sessions refusing to switch back to auto mode until restart after disableAutoMode was removed from settings
Fix synced plugin hooks after remote update
Fixed claude.ai-synced plugin hooks failing with "Plugin directory does not exist" in long-running sessions after another session synced a plugin update
Fix lost prompts after rewind and resume
Fixed the prompt sent after a /rewind being lost, and the removed turns coming back, when the session was moved to the background or resumed after being killed
Fix cloud sessions hanging on receive hook
Fixed cloud sessions hanging when a mod's session.receive hook asked for permission before passing a message on
Fix folder prompts reappearing after updates
Fixed macOS background sessions that restart together after an update sometimes running outside the stable app wrapper, so folder-access prompts could reappear
Fix late MCP reconnect relisting servers
Fixed an MCP sign-in or reconnect that finishes late in headless and SDK sessions relisting a server set with setMcpServers() as your own
Ask config.set hook before channel change
Fixed changing the auto-update channel in /config saving before a plugin's config.set hook was asked
Fix other-apps access prompt at session start
macOS: Fixed a file count at session start that could reach other apps' data and raise the "access data from other apps" prompt when a session starts in the home folder or above it
[VSCode] Fix fork and rewind restore errors
Fixed "Fork conversation from here" and Rewind's conversation restore failing with "Message not found in session" after a background agent's activity or one of the panel's own status lines
[VSCode] Fix Tab shortcuts in chat input
Fixed Ctrl+Shift+Tab, Cmd+Shift+Tab and Alt+Shift+Tab in the chat input also switching the permission mode, and Ctrl+Tab accepting the suggested prompt
[VSCode] Fix focus bouncing between views
Fixed keyboard focus bouncing between two Claude views visible at once, which could send typed text to the wrong conversation
Self-hosted runner: fix fetch timeouts on progress
Self-hosted runner: Fixed git fetches being cut off while the git server was still reporting progress on a large repository; CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS tunes or turns off the wait
[Cloud sessions] Fix no reply after unarchiving
Fixed a message sent right after unarchiving a cloud session sometimes getting no reply because no container could start for it
[Cloud sessions] Rerun routines missing their prompt
Fixed some older routines starting their runs without ever giving Claude their saved prompt; those routines now run their prompt again
[Claude Tag] Render links in forked-thread cards
Fixed channel links and @-mentions in a forked thread's "Continued from" card showing as raw Slack codes
[Claude Tag] Stop spinner after restart confirms
Fixed Slack's Working status spinning on under a thread after @Claude !restart had already confirmed the restart
[Claude Tag] Answer @Claude from other bots
Fixed another app's or bot's @Claude going unanswered in a busy channel where Claude had stopped reading untagged messages
[Code Review] Report remaining open findings
Fixed Code Review re-reviews saying no issues were found while earlier findings were still open; the comment now says how many remain open
[Code Review] Apply CLAUDE.md edits immediately
Fixed Code Review still skipping a large CLAUDE.md's rules when the pull request edits that file
Speed up web search at high effort
Fixed web searches and agent hook evaluations taking much longer at xhigh and max effort