Claude Code 2.1.295

Changelog: v2.1.295

What's changed

• 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
• Added Program Status Protocol (OSC 7501) support: terminals that implement it can show whether Claude Code is working, waiting on you, or done
• Added quoted text to the /copy picker, so a drafted message copies without its > markers
• Added a warning to claude plugin install, enable, disable and marketplace add when the settings file they write to does not load
• 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
• 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
• Added a "Backgrounding cancelled" message when you stop the turn while ← is waiting for the current tool to finish
• 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
• 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
• 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
• 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
• Added $.ui.notify for mods: raises a native notification through your own notification setting and says which channel sent it
• 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
• 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
• 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
• 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
• Fixed claude -p text output dropping earlier responses when background work started another turn; each turn's response now prints when the turn ends
• 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
• Fixed remote MCP connections being dropped when a server's error reply happened to contain a network error name
• Fixed MCP servers that repeat a pagination cursor being asked for the same page up to 20 times at every connect
• 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
• Fixed Bash tool calls failing when the model passes command_description instead of description
• Fixed Claude in Chrome not applying a site deny rule written with port 80 (host:80) to plain http:// pages on that host
• Fixed /plugin's Errors tab removing a marketplace that failed to load, and uninstalling its plugins, on Enter without asking first
• Fixed claude plugin marketplace add reporting success for a marketplace whose name no plugin can be installed under; such an add is now refused
• 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
• 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
• Fixed files sent from remote sessions being refused as "could not be vouched for" when more than 256 were sent at once
• Fixed a rare failure to load managed settings at startup right after a login refresh
• Fixed /tui exiting without a message, or with a raw system error, when Claude Code could not be started again
• 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
• 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
• Fixed the Claude apps gateway's admin spend view showing a developer's old groups and group cap after their session stopped carrying groups
• 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
• Fixed subagents in their own linked worktree being shown the parent session's git branch, status and recent commits
• 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
• 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
• Fixed an interrupt not ending the turn until a timeout while Claude waited for an MCP server's resource list
• 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
• Fixed Esc not stopping a self-paced /loop that was moved to the background with ←; cancelling a pending wakeup now shows a notice
• Fixed commands and hooks in background sessions inheriting FORCE_COLOR=3, which put color escape codes into the output Claude reads
• 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
• Fixed a custom agent named worker being shown as "Agent" in auto-mode denial notices and in the activity lists of task detail views
• Fixed Bash permission checks for for-loops over glob patterns, improving permission-check accuracy
• Fixed forked skills invoked from Workflow subagents delivering their results to the main conversation instead of the invoking agent
• Fixed in-process agent teammates failing their first SendMessage call until they loaded the tool through tool search
• Fixed Claude being told on resume that an unfinished background workflow may have been stopped by TaskStop, which can never be the cause
• Fixed Claude not being told when you stop a long-running MCP tool call from the tasks panel or a connected client
• 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
• Fixed raw terminal hyperlink bytes in a reply or a teammate's message being drawn as a clickable link with a hidden address
• Fixed plugin marketplaces whose repository has large git submodules failing to add or refresh: only the submodules that hold plugin files are now fetched
• Fixed the /advisor dialog showing a checkmark on a saved advisor model that is no longer available; it now opens on "No advisor"
• Fixed the notification for an MCP tool call that moved to the background showing a shortened task id
• 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
• 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
• Fixed the terminal freezing, with ctrl+c ignored, when a response ran to tens of thousands of lines
• 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
• Fixed plugins whose hooks module nests code thousands of levels deep failing to load or validate with a bare stack-overflow message
• Fixed claude plugin test passing a session.append hook that removes tool call, tool result or thinking blocks that a real session keeps
• Fixed Claude not being told it can resume background subagents with SendMessage after a session was killed and resumed a second time
• Fixed a file being treated as already read after a Bash command such as cat ran without printing it
• Fixed plugin options named constructor or prototype always reading as their default and never reloading the plugin when edited
• Fixed a mod's hot reload missing a save made while /reload-plugins or session start was reading the mod's files
• Fixed the mod hot-reloading question being asked again every turn for the whole session when it is approved without picking an answer
• Fixed /model, /fast and /output-style saving their setting without asking a plugin's config.set hook
• Fixed bold text being drawn faint in piped output when it directly follows dim text
• Fixed replies whose quotes nest deeper every few lines freezing the terminal for seconds and using gigabytes of memory
• 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
• Fixed claude mcp serve background Bash results not naming the output file, and its tool description promising a notification that never arrives
• Fixed an async SessionStart hook's unchanged context being added to the conversation again on every resume
• Fixed variables a SessionStart hook writes to CLAUDE_ENV_FILE not reaching the Bash tool after an in-app /resume or /branch
• 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
• 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
• Fixed Claude 3 Opus and Claude 3.x Sonnet sessions being offered tool search, which those models reject, where feature flags are unavailable
• 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
• Fixed text with tabs or bidirectional control characters losing its end at the edge of the screen or drawing over nearby rows
• Fixed /model saying a Max effort pick was saved as your default for new sessions; Max applies to the current session only
• Fixed an async hook's JSON output being ignored when it is printed over several lines
• Fixed the Read tool rejecting calls with an empty pages parameter instead of treating it as omitted
• Fixed project-scope plugins not loading in VS Code on Windows due to drive-letter casing (anthropics/claude-code#74612)
• 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
• Fixed a queued message being lost when pulled back into the prompt with ↑ or Esc just after ←: prompt history now keeps it
• 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
• 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
• Fixed non-interactive sessions telling you about MCP servers that need authentication when your request doesn't use them
• 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
• Fixed a plugin that adds very large interfaces getting another plugin unloaded when the plugin hooks worker stalls
• Fixed Edit treating a file as fully read when its contents changed without its modification time advancing
• Fixed short command output with Windows line endings (CRLF) being drawn on a single line
• 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
• 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
• Fixed temporary files left under ~/.claude/seed-admin by an interrupted /ultrareview upload never being removed by the retention cleanup
• Fixed Desktop and SDK sessions refusing to switch back to auto mode until restart after disableAutoMode was removed from settings
• Fixed claude.ai-synced plugin hooks failing with "Plugin directory does not exist" in long-running sessions after another session synced a plugin update
• 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
• Fixed cloud sessions hanging when a mod's session.receive hook asked for permission before passing a message on
• Fixed macOS background sessions that restart together after an update sometimes running outside the stable app wrapper, so folder-access prompts could reappear
• Fixed an MCP sign-in or reconnect that finishes late in headless and SDK sessions relisting a server set with setMcpServers() as your own
• Fixed changing the auto-update channel in /config saving before a plugin's config.set hook was asked
• 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
• 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
• 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
• 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
• 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
• 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
• Improved headless rate_limit_event usage-limit warnings to say whether the account has extra usage turned on
• 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
• Improved Grep input handling: a search sent with grep's -l, -c or -r flag now runs instead of failing the call
• 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
• 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
• 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
• Changed MCP tool descriptions the model loads through tool search to be cut at 16,384 characters instead of 2,048
• 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
• 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
• 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
• Changed claude.ai connectors to negotiate MCP protocol version 2026-07-28 by default on installs that fetch no flags; MCP_PROTOCOL_NEGOTIATION=legacy opts out
• Changed Artifact pages with no background of their own to show on white instead of off-white
• 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
• 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
• 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
• 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
• Changed toasts from your organization's mods to show ahead of other mods' toasts instead of waiting behind them
• 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
• 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
• [VSCode] 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
• [VSCode] 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] 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] Fixed keyboard focus bouncing between two Claude views visible at once, which could send typed text to the wrong conversation
• 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
• 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] Fixed a message sent right after unarchiving a cloud session sometimes getting no reply because no container could start for it
• [Cloud sessions] Fixed some older routines starting their runs without ever giving Claude their saved prompt; those routines now run their prompt again
• [Cloud sessions] 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] 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] Changed the settings confirmation cards Claude posts in a Slack channel to stay open for 30 minutes instead of 10
• [Claude Tag] 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
• [Claude Tag] Fixed channel links and @-mentions in a forked thread's "Continued from" card showing as raw Slack codes
• [Claude Tag] Fixed Slack's Working status spinning on under a thread after @Claude !restart had already confirmed the restart
• [Claude Tag] Fixed another app's or bot's @Claude going unanswered in a busy channel where Claude had stopped reading untagged messages
• [Claude Tag] 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
• [Code Review] 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] Fixed Code Review still skipping a large CLAUDE.md's rules when the pull request edits that file
• Fixed web searches and agent hook evaluations taking much longer at xhigh and max effort