Changelog

Every Claude Code release. Bolted straight to the record.

⌕

●

v2.1.322 Nov 10, 2026

v2.1.322

What's changed

Added fast mode on Vertex in the global, us and eu regions, falling back to standard speed if Vertex refuses it

●

v2.1.321 Nov 9, 2026

v2.1.321

What's changed

Added Claude Fable 5.2 (claude-fable-5-2), now the default Fable model — 1M context, $8/$40 per Mtok with $0.20/Mtok cache reads
Added --settings <file> to claude remote-control, which applies a settings file to every session it starts; if the file changes, no new session starts until you restart claude remote-control
Fixed MCP OAuth requests sending secrets such as refresh tokens to another host when a server redirected them
Fixed a case where a read-only Bash command ran outside the sandbox without a permission prompt
Fixed a case where Bash permission checks judged a file write from the wrong folder and didn't prompt
Fixed deny rules and protected-file prompts not applying to the file that a cp or mv into a directory writes
Fixed the "Draws from usage credits" note showing after a switch to Fable on Enterprise seats whose plan includes Fable
Fixed the fallback model sometimes declining a request or mentioning a stopped response when the first model was blocked before replying
Fixed claude mcp login printing a SEP-2352 issuer warning each time you sign in again to a server that Claude Code registered with
Fixed NotebookEdit deleting or overwriting a notebook's first cell when the call named no cell, on network paths (UNC shares, WSL folders, /net mounts)
Fixed Edit changing the first of several matches, replacing a whole file on an empty old_string, or editing a notebook as text, on network paths (UNC shares, WSL folders, /net mounts)
Fixed /config showing Manual as the default permission mode when new sessions start in auto mode; pressing Space on "Auto (default)" now saves Don't Ask, not Plan
Windows: Fixed FileChanged hooks stopping for paths set through watchPaths after the first shell command, when the session's working directory had a lowercase drive letter
Fixed --plugin-dir . and --plugin-dir ./builtin writing generated type files for Claude Code's built-in plugins into a builtin folder
Fixed context usage estimates overcounting tool definitions when exact token counts are unavailable
Fixed /compact showing twice in Remote Control on web and mobile
Fixed plugin auto-updates and /plugin marketplace updates downloading a plugin again for each worktree or folder of a repository
Fixed auto mode losing a background subagent's report that had started a turn when the conversation was compacted before Claude answered it
Fixed project skills, commands and agents staying missing after their folder was removed and came back mid-session, such as with git stash, including after entering a worktree
Fixed claude -p sometimes telling Claude that background commands get 30 minutes when they are stopped after 10
Fixed pkill, pgrep and pidwait in cloud sessions matching the session's own parent processes
Fixed Claude in Chrome and computer use server processes staying alive after their parent exits behind a proxy that stalls connections
Fixed a large hook output pointing Claude to a file that held another hook's output from the same tool call
Fixed apps that embed Claude Code getting their own PreToolUse hook's ask reason instead of another hook's when both asked
Fixed a PreToolUse hook's ask being lost when another hook's defer finished first and could not be honored
Fixed a rare crash on permission prompts and background tasks
Fixed project skills, commands and agents disappearing from the menu in SDK and desktop sessions after Claude entered a worktree
Fixed /desktop on macOS saying Claude Desktop is not installed when it is in ~/Applications
Fixed OpenTelemetry repository attributes (vcs.*) missing from Claude Desktop sessions that start on a pre-started process
Fixed WebFetch passing "No response from model" to Claude as page content when the model reading the page returned no text; the call now fails with a clear error
Fixed screen reader mode delaying the prompt at startup when the system clock moved back while Claude Code was starting
Fixed a command's panel sometimes not coming back after a dialog closed, leaving no panel or prompt on screen until the next redraw
Fixed a project's MCP server being disconnected after the first message in a Claude Desktop Code tab session when the desktop app has an MCP server or extension of the same name
Fixed a turn ending with "API Error: EPROTO: The TLS handshake failed" when the connection broke partway through a reply; the partial reply is kept or the request is retried, as before 2.1.302
Fixed high memory use in long sessions that repeatedly read single lines from large files
Fixed fast mode losing replies, switching models or retrying for minutes when fast serving is rate-limited, overloaded or failing; it now tries standard speed on the same model first
Fixed one request carrying far more background agent reports than intended after Claude was stopped while several were waiting
Fixed messages from a Claude Desktop Code tab session to your other sessions staying paused after you typed while Claude was still working
Fixed claude agents ignoring --permission-mode, --dangerously-skip-permissions, --model, --effort or --agent typed before agents when a flag such as --verbose was also on the line
Fixed a case where Remote Control showed as off with "login expired" in the desktop app while its connection was still up, because the app was briefly unable to hand over a sign-in token
Fixed a Remote Control message sent with "Queue for later" reaching Claude in the middle of the running turn
Fixed the git status given to Claude at session start reading as clean when git status failed; it now reads as unavailable
Fixed the git status given to Claude at session start showing the first listed file as staged when its changes were not staged
Fixed a hang or out-of-memory crash when a connector in a cloud session lists resources with very long names
Fixed Remote Control showing as connected after its connection closed for good while the session's history was still uploading
Fixed screen reader mode turning off when you return to a conversation from agent view
Fixed screen reader mode y/n questions taking as yes a stray "y" at the end of text typed as the question opened
Fixed cloud sessions telling Claude that a host is probably not allowed when it is allowed and the network proxy could not connect to it
Fixed an MCP server sometimes showing as connected with no tools after it was reconnected or the session's directory changed while its tools were still loading
Fixed Bash commands sometimes running in the wrong folder when Claude sent several at once and an earlier one changed folders
Fixed files Claude sends from cloud and Remote Control sessions failing at once when an upload gets an HTTP 507 from a proxy; the upload now gets a second try
Fixed new messages not being saved, and claude -p, SDK and VS Code sessions hanging, when memory ran out while the transcript was being read
Fixed sign-in, token refresh and logout waiting indefinitely when something on the network accepts the connection but never answers the TLS handshake
Fixed a sent file showing under a different name in the Claude apps when its name hid text-direction or control characters; Claude now refuses to send such a file
Fixed sub-agent progress summaries running a request to its end after the model replied with a tool call
Fixed Bash reads such as grep -r foo "$PWD/src" asking for permission when the same command with the path typed out runs without asking
Fixed Claude apps gateway refusing to start when a desktop setting holds a field newer than the gateway, such as a managed MCP server's oauth.omitResource; it now warns and serves it
Fixed Bash commands coming back empty for zsh users whose .zshrc sets KSH_OPTION_PRINT
macOS: Fixed "Unable to read managed policy settings" at startup when a valid MDM profile was slow to read: the read is retried once, and a timeout is now reported as a timeout
Fixed agent view erasing another agent view's saved input text when it restarted for an update with nothing typed
Fixed remote sessions giving no reply after a restart when a UserPromptSubmit hook blocked a replayed permission answer; these hooks no longer run on that replay
Fixed claude remote-control accepting a y typed without Enter at its first-run question when the terminal's input ended
Fixed Claude Desktop not showing spend limit warnings behind a Claude apps gateway whose policy has no code: rules
Fixed fullscreen sessions with some plugins ending with an error when a tool result that had got shorter scrolled off the top of the screen
Fixed prompt suggestions making extra API requests when the model replied with a tool call
Fixed PreToolUse mcp_tool hooks on stdio and HTTP MCP servers being skipped when their answer was over 16 MiB; the tool call is now refused
Fixed skill and command names holding a Bamum letter that some fonts draw as blank: they are now refused
Fixed claude -p on Linux exiting 0 in silence when a full NFS export or a used-up NFS quota lost transcript lines: it now prints an error and, in text and json output, exits 1
Fixed background agents being reported as stopped by the user, and refused a resume, when a service interrupted a cloud session and nobody pressed Stop
Fixed NotebookEdit reporting success to hooks and telemetry when the edit failed, for example when the notebook changed while the permission prompt was open
Fixed a blank screen or no answer at startup, and empty claude mcp list output, when a stored MCP sign-in record was null
Fixed the Artifact tool telling Claude to add filters when an artifact's database collection is too large to sort; it now says to read the collection page by page and sort the results
Fixed a restarted cloud session dropping a message with a large image when the restart came before Claude's first reply to it
Fixed a restarted cloud session leaving a subagent's message to the main conversation unanswered
Fixed Claude not being told when you stop or pause a running workflow, so it no longer says the workflow is still running
Improved the /model picker: "More models" is now an unnumbered row below every other, and older models open under it without renumbering the rest
Gateway: Improved spend limits on a busy replica, which now skips fewer checks and records spend sooner
Improved the Claude apps gateway's sign-in limit messages in Claude Code and on the /device page: they no longer name gateway settings, which the gateway's own log still names
Improved claude install and the install scripts: they finish 2 to 4 seconds sooner
Improved how soon a Remote Control session whose process crashed can pick up a new message
Windows: Improved startup and first-command time by finding programs on PATH without starting a helper process
Improved auto mode in headless sessions, the desktop app and VS Code: reports from background subagents that wait together are answered in one model call, as in the terminal
Improved the agent view's row for a claude --bg --worktree session that couldn't set up its worktree: it now shows the error from its beginning, not an internal tag or its last 200 characters
Improved the messages shown when an artifact is in another organization: /login is offered only if it's one of yours, and Claude now says where a copy may be after an account move
Improved sessions with more images than fit in one request: Claude is told whether it has already seen a dropped image, and repeat reads of an unchanged image are limited
Improved claude remote-control's messages for an unanswered first-run question: each now says what to do next
Improved start-up time by loading trusted TLS certificates faster
Improved Claude apps gateway error messages to show the gateway's address without any user name or password
Improved the Claude apps gateway's spend limit error: the reset now shows in your local time, such as "resets 4pm (America/Los_Angeles)"
Windows: Improved startup time with a standard Git for Windows install by no longer checking which git.exe to run on every launch
Updated the session-feedback message and the allowedProviders setting description to name Ultra alongside Pro and Max, and the forceLoginMethod description to cover every paid Claude plan
Updated the bundled dataviz skill to suggest a list of meters, one row per item, for several ratios that each have their own limit
Updated the "Upgrade to Max" options to say "Upgrade to Max or Ultra"
Changed mods Claude writes to turn on without asking in auto and bypass modes, even with managed allowUnsandboxedCommands: false or allowManagedDomainsOnly, and not to load in dontAsk mode
Changed mods' own tool calls ($.tool.call, $.mcp.call) to raise no permission prompt, even under your own ask rules or in dontAsk and -p runs; deny rules and organization policy still apply
Changed saved Fable 5.1 model picks to move to fable: on Pro and Max plans at once, on Team and Enterprise plans once your organization allows it; use /model claude-fable-5-1 to switch back
Changed the fast mode labels in /fast, /config and /model to name your current model when it supports fast mode, and removed "(Opus only)" from the VS Code row
Changed nested skill loading: .claude/skills folders inside ~/.claude/plugins no longer load when Claude works on files there
Self-hosted runner: Changed an on-demand runner that the server refuses because it is not needed (session ended or paused, work order superseded) to exit 0 instead of 1
Windows: Changed how Claude Code finds programs it starts itself, such as git, to skip relative and UNC PATH entries and links onto a network share, and to pick up PATH changes from settings
Changed OpenTelemetry hook events in non-interactive sessions to leave two built-in hooks out of num_hooks and num_success after Bash and PowerShell calls
Changed the number of messages a Claude Desktop Code tab session can send to your other sessions before it waits for you to type again from 10 to 20
Changed AskUserQuestion in claude -p and SDK sessions to deny a host's permission answer that sets the undocumented afkTimeoutMs input field
Changed managed extraKnownMarketplaces: a declared name can't be added from another source, an entry from elsewhere is hidden, and plugins the declared marketplace lists are reinstalled from it
Changed Claude in Chrome tools that an app running Claude Code provides, such as the Claude desktop app's Code tab, to follow your organization's Claude in Chrome policy
Changed policy_mode: layered in the Claude apps gateway: managed MCP servers now add up over every matching policy, match: {} included, so a gateway already on it serves more after the upgrade
Gateway: Changed Bedrock, Vertex and Foundry upstreams to ignore the ANTHROPIC_*_BASE_URL variables in the gateway's environment. Set base_url on the upstream to use another endpoint
Changed headless sessions to reload mods in .claude/skills when their files change; set CLAUDE_CODE_PLUGIN_DIR_WATCH=0 to turn this off
Changed the Cyber Verification Program sentence on a cyber safeguard block to use the same words as claude.ai
Changed Cowork cloud sessions: a PostToolUse hook can no longer replace the answer to AskUserQuestion or the plan in ExitPlanMode's result; Claude reads the originals
Changed cp and mv spelled by a path, such as /bin/cp, to get the same path checks as cp and mv
Changed background command notifications and TaskStop results to show Claude only the start and end of a command over 1,000 characters, which saves context
Changed artifact design guidance to treat Inter and Space Grotesk as good default typefaces
Changed the account email check to refuse only a shell command that holds your email and names a User-Agent, without asking, so other commands and scheduled runs no longer stop at its prompt
Changed Remote Control sessions to keep the folder they were started in: a connected client can no longer move a session to another folder
Changed managed extraKnownMarketplaces take-overs from an undeclared source: saved data is set aside for cleanupPeriodDays, and options and secrets until claude plugin restore-set-aside
[VSCode] Added a warning above the prompt box when both an auth token and an API key are set, matching the terminal's startup warning
[VSCode] Fixed a plugin's permission request showing a name with hidden characters: it now reads "a plugin"

●

v2.1.319 Nov 6, 2026

v2.1.319

What's changed

Changed auto mode with telemetry or feature flags off, including behind LLM gateways: calls the server can't check are asked about or denied, with no fallback to the built-in classifier; set CLAUDE_CODE_AUTO_MODE_SERVER=0 to keep using it (Bedrock, Vertex and Foundry are unchanged)
Changed auto mode behind an LLM gateway: CLAUDE_CODE_AUTO_MODE_SERVER=1 turns on the server-side check even with CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS set; if managed settings set the latter, they must set the 1 too
Added support for MCP tasks in the terminal: when an MCP server runs a tool call as a task, Claude Code moves it to the background right away and tells Claude the result when it finishes
Added the CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND environment variable to make Claude Code wait for an MCP task inside its tool call instead of moving it to the background right away
Added permissions.denyInsteadOfPrompting setting: a tool call that would wait on a permission prompt is denied and the turn continues, in terminal sessions, subagents and teammates
Added /claude-api latency-optimize to find where your Claude API code makes people wait and try faster settings against your eval
Added the CLAUDE_CODE_DISABLE_FEATURE_FLAGS environment variable, which stops feature-flag fetching without turning off telemetry; every flag then uses its built-in default
Added spend for today, this week and this month to /usage for developers behind a Claude apps gateway who have no spend limit, when the gateway runs this version or later
Added admin.pooled_conflict_rule and admin.pooled_priority_order to the Claude apps gateway, to set which pooled group budget pays first for a developer in several groups
Added an optional login_notice setting to the Claude apps gateway that shows an operator-defined message on the gateway's browser verification page and on Claude Code's sign-in screen
Added CLAUDE_GATEWAY_LOG_FORMAT=json to the Claude apps gateway: operational log lines become JSON with severity, time and message, for log collectors that read the level from a field
Added a Claude apps gateway boot warning for a case where another policy's availableModels also allows a custom model id that one policy lists by name
Added start-up warnings to the Claude apps gateway for policies with no desktopHome that rely on coworkTabEnabled: false or chatSessionRetentionDays, ahead of Claude Desktop's November 10 change
Added a warning when your claude.ai login ends and Claude Code continues on the sign-in from ant auth login, which bills usage to your Claude Console organization
Added a line at startup naming the Claude Console organization that is billed in a case where Claude Code uses the sign-in from ant auth login
Added an "Earlier in this session" row to /tasks that lists finished subagents, so you can reopen one and message it even after it leaves the list or you restart
Added a note to /loop confirmations in cloud sessions that a timer stops with its container, with an offer of a loop that survives
Fixed MCP servers on the older handshake failing to connect, or returning empty results, because Claude Code declared an extension that it only uses with newer servers
Fixed a long-running MCP tool call on a claude.ai connector sometimes never reporting its result after --resume
Fixed a session's diff failing to load on claude.ai and the mobile apps when the folder Claude Code runs in has a file or folder named HEAD
Fixed /diff showing "Diff unavailable" when a git repository has a file or folder named HEAD at its top level
Fixed the /diff pane opening blank in sessions where 64 or more turns edited files
Fixed slash commands typed after a leading space, tab or newline being sent to Claude as plain text instead of running
Fixed a request that kept failing with a 401 refreshing your login on every retry and causing 401s in your other sessions
Fixed /context sending its full visual grid to Claude on every later turn; Claude now reads only the table
Fixed claude -p exiting 0 in auto mode when its actions were refused because no safety check was available: text and JSON output now exit 1
Fixed a case where Claude Code listed every project file at start on Linux for projects on a network file system (NFS, SMB, Lustre and similar)
Fixed a case where auto mode was wrongly refused when a client sent a model change and a request for auto mode back to back
Fixed /status showing "Auto mode server: Enabled" when the server-side review isn't reaching the session, for example behind an LLM gateway that drops it
Fixed Claude-drafted feedback, surveys and /feedback continuing to appear after the server refused feedback for your organization
Fixed Claude drafting feedback on third-party gateways, where it can't be sent
Fixed auto mode refusing actions without saying why when permission rules or autoMode settings are very large: it now explains and, unless autoMode deny rules are set, asks you in the terminal
Fixed a case where Bash deny and ask rules missed commands written with quoted words
Fixed subagent hand-back reports showing an internal marker and provenance note when expanded outside verbose mode
Fixed claude -p --resume with a prompt losing a deferred tool call when its MCP server is missing: the run now exits 1, keeps the call and refuses later input
Fixed a case where text was dropped from informational messages sent to SDK clients
Fixed a case where Agent SDK hosts got a generic exit-code error instead of a failed run's own error message when the disk was full
Fixed CLAUDE_CODE_RESUME_INTERRUPTED_TURN re-running a turn that was interrupted in plan mode when the session resumes in another permission mode
Fixed edits to a settings file being ignored when made within a few seconds of Claude Code writing that file
Fixed a config file left at the legacy name hiding your setup with no warning: Claude Code now says on stderr when a home holds two config files, and which is in use
Fixed ~/.claude.json, settings and edited files ending up empty or cut off when the disk fills during a save in a read-only folder or to a bind-mounted file (one session saving at a time)
Fixed Write ending the turn as a refusal when it couldn't read the file to overwrite
Fixed background Bash commands that finish almost instantly losing their output while being reported as completed
Fixed the Bash tool's diff of changed files missing a file that the command wrote just before it ended
Fixed a mistyped model name, such as opus-5-5, telling you to update Claude Code instead of suggesting the model you meant
Fixed a case where NotebookEdit changed the wrong cell when the notebook changed while a permission prompt was open
Fixed a ~0.5s hang after pressing Enter on the /login success screen: the dialog now dismisses immediately and the post-login refresh runs in the background
Fixed Ctrl+G not opening the external editor while typing an "Other" answer to a question in screen reader mode
Fixed Monitor's WebSocket watch failing with "could not resolve" behind a proxy when CLAUDE_CODE_PROXY_RESOLVES_HOSTS is set and the machine has no DNS of its own
Fixed claude plugin eval warnings suggesting max: 0 for a tool that must not be called, which could never pass
Fixed background plugin auto-update not installing a dependency added by the updated plugin version
Fixed Cmd+click not opening links in Ghostty over tmux in sessions opened from the agents view
Fixed a mod's hot reload in .claude/skills missing a file that was deleted just after it appeared, and missing its return
Fixed /rewind failing with "No files were restored" when restoring code to a checkpoint from before /branch
Fixed the /claude-api skill saying Console web settings don't apply to Managed Agents sessions, and tightened its credential and permission examples
Fixed needless permission prompts for read-only commands wrapped in a plain timeout DURATION, such as timeout 30 rg foo
Fixed WebFetch describing claude.ai shared-chat links as empty pages; it now says shared chats can't be read and to paste the conversation instead
Fixed Artifact database calls being re-sent to artifacts without a database; errors now say whether republishing helps
Fixed a case where artifact database reads that save to a folder (out_dir) were refused
Fixed detailed beta tracing not presenting CLAUDE_CODE_CLIENT_CERT to collectors that require a client certificate
Fixed the OpenTelemetry claude_code.session.count metric counting Agent SDK prewarm() processes that were never claimed; a pre-started process now counts once, when it is claimed
Fixed /clear killing running commands of background agents, teammates and workflows that keep running, and foreground subagents of background agents and teammates
Fixed a terminal whose Claude apps gateway sign-in had expired sending telemetry and managed-settings requests that the gateway refused and logged as invalid_token
Fixed the agents view appearing to send a reply to a background session waiting on a permission prompt; the reply now stays in the box with a hint to open the session and answer
Fixed agent view removing a draft saved by another agent view in the same directory when exiting
Fixed a case where agent view came back with another agent view's input text after restarting itself for an update
Fixed the agents view preview cutting off long commands, results and status lines without an ellipsis, and dropping **, backticks and tags from commands waiting for approval
Fixed Claude in Chrome reporting the extension as not connected when the connection dropped mid-action; Claude now checks the page before repeating an action that may have run
Fixed Remote Control sessions still showing "Limit reached" on other devices after a usage limit was lifted outside the session
Fixed the file card sometimes missing in the Claude iOS app when Claude sent a single file
Fixed self-hosted runner sessions failing with no explanation when the server keeps refusing to renew model access: the runner now retries sooner and posts a warning in the session
Fixed /permissions in cloud sessions replying only that it isn't available; it now says where the session's rules live and how to change them
Fixed cloud sessions losing session-scoped deny and ask permission rules, such as those a PermissionRequest hook adds, when the session moves to a new worker
Fixed mod hot-reloading turning off for the session when you typed three messages instead of answering its question in a cloud session
Fixed background tasks that keep running after /clear disappearing from the task list in Claude Code on the web until another task started or ended
Fixed hidden commands appearing in the slash command menu of cloud sessions on mobile and web
Fixed a case where /rewind could restore or delete a file through a directory symlink
Fixed a case where a sed command could skip the permission check in accept-edits and auto mode
Fixed a case where CLAUDE_CODE_AUTO_MODE_SERVER=1 in managed settings was ignored behind an LLM gateway when the gateway's URL is set only there and server-managed settings can't be fetched
Fixed a Bash permission bypass where a crafted environment prefix could hide part of a command from permission checks
Fixed a case where deny and ask rules, hook matchers and disallowedTools entries written with a claude.ai connector's terminal name (mcp__claude_ai_Slack) were ignored in Claude Desktop (takes effect once Claude Desktop includes this version)
Fixed a sandbox escape when creating a worktree
Fixed self-hosted runners: --trust-workspace false now also stops hooks in the repository's settings files and skills from running
Fixed a case where idle background sessions started through a shell-exported LLM gateway left the gateway after an update
Fixed help links in /status and the auto mode billing notice opening only part of the address when they wrap
Fixed a case where certificate errors behind a TLS-inspecting proxy persisted when CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC was set. With it set, Claude Code now makes a TLS handshake with the configured API host after a certificate failure, through your http:// proxy if one is set; it sends no API request
Fixed claude remote-control exiting silently with status 0 when a first-run question gets no answer (scripts, services, batch jobs, Ctrl+C); it now says why and exits 1
Fixed claude remote-control ignoring a piped y that has no newline after it at the first-run question; it now counts as a yes
Fixed /rename reporting plain success when the new name could not be saved to the session transcript; it now warns that the new name may not last
Fixed ${CLAUDE_PLUGIN_ROOT} not being substituted in a plugin-provided subagentStatusLine command, which can now reference the plugin's own scripts
Fixed claude plugin update and /plugin "Update now" not installing dependencies added by the new plugin version
Fixed subagents being told after compaction to expect a completion notice for background agents they neither started nor took over
Fixed a case where a background agent's later report was lost silently: the notification now says it was refused and how to ask for it
Improved config saves on Windows: Claude Code waits longer for a file another program has open, so a kill during a save is less likely to leave ~/.claude.json empty
Improved Claude in Chrome after a brief disconnect: it waits up to 6 seconds for the session's own browser to return before picking another
Improved Claude in Chrome: javascript_tool results of up to 60,000 characters now stay in the conversation instead of being saved to a file
Improved claude purge and the clean-up of old sessions to retry a folder that could not be fully deleted, and to report it as an error if it remains
Improved the refusal for a path outside the working directories on macOS and Windows: when only its letter case differs from a path inside them, the message names that spelling
Improved the contrast of faint gray secondary text, such as hints, details in /stats, /model and /sandbox, and rejected-action messages
Improved the artifact database error when an update targets a document that does not exist, and when the service pauses repeated refused writes
Improved the Claude apps gateway's warnings about a failed upstream call: each now names the upstream, not only its provider
Improved the Claude apps gateway's spend limit error: it reads "spend limit reached · resets Dec 1", then admin.blocked_message if one is set
Improved the /model picker: older models are now grouped under a "More models" row instead of being listed after the current ones
Improved /context at the terminal so the table Claude reads stays short: each list keeps its 10 largest rows, and MCP tools that load on demand share one row per server until they're called
Improved /usage in cloud sessions: it now links to Settings → Usage on claude.ai in a case where plan limits can't be shown
[VSCode] Improved the confirmation for removing a plugin marketplace: it now checks which of its plugins are installed at that moment
Changed MCP tasks to work in the terminal without feature-flag fetching (Bedrock, Vertex, Foundry, LLM gateways, DISABLE_TELEMETRY); set CLAUDE_CODE_DISABLE_MCP_TASKS=1 to turn them off
Changed auto mode so that a project's settings files or a plugin can no longer switch its server-side check back on once you have switched it off outside the project
Changed Monitor's WebSocket watch to follow a rule on every Bash command: a deny refuses it, and under an ask rule an allow on Monitor, bypass mode or auto mode no longer skips the prompt
Changed CLAUDE_CODE_PROXY_RESOLVES_HOSTS so that settings files can no longer set it where the host manages the network; set it in the process environment
Changed a session's exact Bash or PowerShell ask rule to be refused, not asked about, when a broader deny rule covers the command
Changed the Bash tool to ask for permission before running which with flags outside a lookup/display set
Changed --add-dir directories to register plugin marketplaces only once that directory's own trust dialog has been accepted
Changed nested skill loading: with the Bash sandbox on, skills in .claude/skills folders below the starting folder load only if you start Claude Code there or /cd there
Changed self-paced /loop to end when a turn finishes without rescheduling, instead of scheduling a fallback wakeup; set CLAUDE_CODE_LOOP_KEEPALIVE=1 to keep the old behavior
Changed PostToolUse hooks to run, with up to 10 seconds to finish, on tool calls that finish after a new message interrupts the turn
Changed what Claude is told after safeguards stop a subagent: retry with a narrower prompt or tell you, instead of doing the work itself
Changed cloud sessions to drop session-scoped allow rules at a move to a new worker when their deny and ask rules can't all be kept, so you may be asked again
Changed the automatic certificate repair behind a TLS-inspecting proxy: it no longer runs when ALL_PROXY is the only proxy variable set. Set HTTPS_PROXY to the proxy's http:// URL instead
Changed artifact database saves of rows others may have written: each file gets a hidden marker file, and existing files without one, earlier versions' exports among them, are left alone and reported
Updated /claude-api managed-agents-onboard templates to match the Claude Console: removed Performance tuner, renamed two, and turned off web search and fetch in five whose prompts don't use them
Removed shortcuts_list and shortcuts_execute, which listed and started shortcuts saved in the extension, from Claude Code's built-in Claude in Chrome tools
Gateway: Added startup warnings for upstreams that mix AWS GovCloud with other upstreams, and for base URL variables in the gateway's environment
Gateway: Added a start-up log warning when managed settings name an Amazon Bedrock guardrail in a header, which the gateway doesn't forward, and no bedrock upstream sets a guardrail
Gateway: Fixed Claude Desktop offering a web search tool that always failed when every upstream is Amazon Bedrock
Self-hosted runner: Fixed a runner started with --use-anthropic-git-proxy or --configure-git registering before a failed startup check made it exit; it now exits first
Self-hosted runner: Changed CLAUDE_RUNNER_CHECKOUT_PATH so that each repository in a session gets its own folder: a folder name already taken in the session gets -2, -3, … at the end
Self-hosted runner: Removed the end-of-session upload of a session's debug log; a failed session's log stays on the runner host unless --remove-session-state is set
[VSCode] Fixed prompts over 50,000 characters being cut off silently: the prompt now stays in the chat box with a notice, and a paste over the limit is refused with a notice
[VSCode] Fixed a click on the survey or "Report a problem" buttons sending the unfinished prompt
[VSCode] Fixed cloud sessions opened from the extension's Web tab bringing back turns that /clear, or Retry or Edit of a typed prompt, had removed
[VSCode] Fixed a deleted session's file coming back when that session was renamed in the extension
[VSCode] Fixed Claude carrying out an unapproved plan after a window reload: a step interrupted in plan mode now stops with a notice when the session comes back in another permission mode
[VSCode] Improved the "not signed in" message behind a Claude apps gateway: it now looks like an error and has a Sign in link
[VSCode] Changed links in Claude's replies that point at Claude sign-in, connector or API addresses to show as text with the address, instead of opening in the browser
[VSCode] Fixed a possible chat panel freeze when a dropped item's path contains a very long run of "/" characters
[VSCode] Fixed the claude-vscode.toggleDictation command starting dictation in every open Claude view at once; it now acts only in the view you are using, and a second press stops it
[VSCode] Fixed the chat panel slowing down while a reply with many unclosed $$ math fences, each shorter than the last, streams in
[VSCode] Improved the chat panel's diagnostics tool for large workspaces: it leaves out files with no problems, returns compact JSON, and accepts an optional minimum severity
[Cloud sessions] Fixed scheduled tasks silently dropping a connector named memory: runs now keep it, mounted under that name plus a short suffix
[Cloud sessions] Fixed Send now on a waiting message in cloud sessions ending running background agents; they now keep running
[Cloud sessions] Improved the stalled-setup warning on self-hosted environments: its link now prefers your organization's default or an environment with a live runner, and names it
[Code Review] Changed unlinking a GitHub organization to also turn off its All repositories setting in Code Review; it stays off after you relink until you turn it back on
[Claude Tag] Fixed Claude Tag setup blocking launch when the channel list couldn't fully load; admins can now launch without picking a channel
[Claude Tag] Added a Claude Tag row to the Models admin page for Enterprise orgs with Claude Tag connected, linking to where its model defaults are managed
[Claude Tag] Fixed saving auto mode allow rules in Claude Tag admin settings overwriting another admin's changes; the save is now refused with a message

●

v2.1.318 Nov 4, 2026

v2.1.318

What's changed

Added a record of your answer when Claude Code asks to turn on the mods it writes in a session
Added assume_role on mantle upstreams of the Claude apps gateway, for a role in another AWS account and for per-developer AWS cost attribution
Added an effort option to a mod's $.model.fork, so a quick side job can run at low whatever effort the session uses; the result reports the effort sent
Added the date a stored claude.ai sign-in ends to claude auth status (loginExpiresAt) and to claude -p JSON results (credential_expires_at)
Added a one-line stderr warning to claude -p text output, starting 10 days before a stored claude.ai sign-in ends
Fixed --continue sometimes losing the earlier conversation after a malformed tool call's retries ran out (regression in 2.1.314)
Fixed macOS sessions with many running Bash commands stalling while memory grew
Fixed permission prompts being answered by keys typed just after sending a message, or before a slow prompt appeared
Fixed /logout, claude auth logout and claude mcp remove reporting success, and changes to trust, consent or MCP settings being dropped with no word, when the config file could not be updated on a shared network home directory
Fixed jobs exiting with Not logged in when another terminal or host signs in again to the same account and organization on the same home
Fixed claude mcp add and remove writing the config without its lock: they now wait for it or exit 1, though another job's save can still replace a saved server
Fixed claude plugin commands exiting before a slow token refresh was saved, which could sign you out on the next run
Fixed claude plugin validate passing a custom-named marketplace file that claude plugin marketplace add rejects
Fixed stdio MCP servers that exit on the version probe being re-probed on every start; a server that dies in under 3s for its own reason is also pinned to the legacy handshake for 7 days
Fixed sessions being refused at startup by an allowedProviders list that another login on the same machine had stored
Fixed idle compaction replacing a conversation with a reply that was not a summary
Fixed the "Now using usage credits" notice reappearing about every 30 seconds while a background subagent is running
Fixed custom slash commands that fail, or that only Claude can invoke, printing nothing in claude -p and SDK sessions
Fixed claude -p and Agent SDK sessions reporting success when an API error cut off a reply while a mod hooked turn.step
Fixed a message sent right after a model change still running after Stop in headless sessions: Stop now cancels or stops it as it would a queued message
Fixed a deleted session transcript being re-created with its last prompt when an idle non-interactive session exited
Fixed claude remote-control hosts, the background daemon and self-hosted runners failing to start new sessions (spawn ENOENT) after an update or version cleanup removed the binary of a still-running process
Fixed a running Claude Code process owned by another user (for example one left by sudo claude) being treated as dead by version cleanup, which could delete its binary
Fixed /remote-control showing a session as available after a failed connection
Fixed /design revoke reporting success when the request failed with a 404
Fixed a shell command approved after a self-hosted runner or cloud session restart running in the session's start folder, not the folder it was asked in; if that folder can't be entered, it is not run
Fixed Claude not being told when an approved connector tool was unavailable after a cloud session restart
Fixed cloud sessions being stopped in the middle of a turn when the service refuses uploads for several minutes
Fixed variables a Setup hook writes to CLAUDE_ENV_FILE not reaching the Bash tool in some cloud sessions
Fixed the iPhone app showing a cloud session's turn as finished while it kept running, after a response was cut off at a tool call or a refused image or document was removed
Fixed a restarted session re-sending a message that failed with an API error, ahead of the newer message waiting behind it
Fixed a restarted session dropping its interrupted turn when the restart came right after Claude read a large image or retried a tool call
Fixed every connection failing when the NODE_EXTRA_CA_CERTS file is empty, not PEM, or starts with a damaged certificate: readable certificates are now used, with a warning on stderr
Fixed workflows re-running finished agents when resumed after a usage limit
Fixed /mcp in cloud sessions counting tools the model can't use; a server's row now shows how many of its tools are available
Fixed a duplicate notification when Claude left the status field out of a PushNotification call
Fixed the error for a too-large image in a request with more than 20 images always saying the limit was 2000px; it now shows the API's limit
Fixed the runtime in background shell details not updating while the dialog is open
Fixed a mod's turn.step hook making a stopped reply finish as a success in headless runs
Fixed retention cleanup leaving a home that only runs claude -p with no ~/.claude.json backup: it now takes a fresh backup before deleting the last good one
Fixed the stored login being replaced by an empty file when a network home directory has no room left for data but still takes new files
Fixed tokens from setup-token being refused at start on machines with forceLoginOrgUUID, when the token belongs to a permitted organization
Fixed non-interactive launches replacing a ~/.claude.json that isn't valid JSON with defaults; the start now fails, says how to restore the file, and leaves it as is (anthropics/claude-code#87551)
Fixed an empty ~/.claude.json with no backup being reported as corrupted; Claude Code now starts as it does when the file is missing
Fixed the restore command printed for a damaged or missing ~/.claude.json naming an empty or cut-off backup, or failing on a read-only file
Fixed the sign-in failure when a stored claude.ai login reaches its time limit: it now says so, and in claude -p names claude auth login and claude setup-token
Improved how ~/.claude.json, settings files and the stored login survive saves on shared network home directories: they are less often deleted, briefly emptied or replaced by a near-empty or older copy
Improved sessions on network file systems to look again when the configuration file is wrongly reported as missing, so fewer start without your MCP servers and trusted folders
Improved MCP tool errors: a call made before the tool is loaded now returns its input schema
Improved the reliability of git commits and pull request creation when the Bash tool runs macOS's built-in /bin/bash
Improved "Ask your admin for more usage" in the usage limit menu to send the request in one step
Improved how fast remote sessions reconnect after a pause or sleep
Improved You should know toasts to say "try again" instead of "press 2", which only works in the terminal
Improved auto-update reliability: a brief network failure while verifying a release is now retried right away instead of waiting for the next check
Improved unattended runs (claude -p, SDK apps) to stop rewriting ~/.claude.json on every run when nothing in it changed
Changed Claude Code to no longer install or update the IDE extension when started in an IDE terminal; use /ide from an outside terminal or your editor's extensions view
Changed subagents to stop instead of switching models when "Switch models when a message is flagged" is set to "Ask each time"
Changed background subagents to move a shell command to the background after 3 minutes on all providers, so the prompt cache doesn't expire while it runs
Changed subagent progress summaries on Bedrock, Vertex, Foundry, or with telemetry off: on a cold prompt cache, one can now wait up to 5 minutes for the subagent's pending response
Changed what a mod attaches at prompt.submit to stay in the user's turn rather than go out as a system message
Changed deniedMcpServers URL entries to also block Anthropic-provided servers whose upstream URL matches, and connectors in cloud sessions and on self-hosted runners, where the session is given the connector's own URL; otherwise deny a connector by name
Changed the /permissions rule details, built-in rules and delete confirmation views to use the standard dialog; pressing Ctrl+C twice there now goes back or cancels instead of quitting
Changed /claude-api managed-agents-onboard to give a new agent's built-in tools, and a quickstart template's MCP tools, the auto permission policy ("Judge risky actions") by default, matching the Claude Console; say "run without asking" to opt out
Removed the 2.1.288 fix that kept the model's earlier thinking when resuming a conversation started on 2.1.286 or earlier; that thinking can now be dropped
Gateway: Added a log warning when the Google access token from a federation (external_account) credentials file is about to expire
Gateway: Improved the log hints about listen.trusted_proxies: they now say to list only a proxy that adds the connecting address to X-Forwarded-For itself
Gateway: Improved the warning when AWS CountTokens fails on Amazon Bedrock: it says Claude Code, not the gateway, counts after the 501, and points at IAM only when AWS denies access
Self-hosted runner: Added CLAUDE_RUNNER_SPAWN_REASON to the orchestrator's spawn-runner hook environment: why Anthropic sent the request (e.g. runner_lost, resumed); unset when none was sent
Self-hosted runner: Added a startup warning when --release-idle-session-min is the last argument with no value (still ignored) or has a value of only spaces (still read as 0)
Self-hosted runner: Changed the orchestrator's log lines: ok session=… now prints at every log level on stdout (was debug only, stderr) with reason=… after jti=…, and nack session=… ends its fields with reason=… after retryable=…; update scripts that match retryable=true: or retryable=false:
Remote Control: Fixed a misleading "spawn error: ENOENT" when a session's working folder is missing; the error now names the folder
Remote Control: Improved the title a fork of a terminal fork is created with when the app doesn't set one: "Name (fork 2)"
[VSCode] Fixed a window whose sign-in the organization's settings refuse starting a new Claude Code process in the background every minute
[VSCode] Fixed a long word in the chat panel's error banner pushing its close button out of view
[VSCode] Improved the sign-in screen to show what Claude Code printed when its sign-in status check fails
[Cloud sessions] Added a No repository option: a cloud session on an Anthropic-hosted environment can now start without picking a repository
[Cloud sessions] Added the usual Chrome names to cloud sessions, so tools other than Playwright can find the built-in Chromium through google-chrome and CHROME_PATH
[Cloud sessions] Added a New session button to the card shown when a cloud session's environment was deleted, where the message box is hidden
[Cloud sessions] Fixed reading GitHub Actions logs in cloud sessions: gh run view --log and gh api log requests now get the log in most environments, not an unreachable redirect
[Cloud sessions] Improved most Create PR failure messages in cloud and Remote Control sessions: they now give the reason or a link to GitHub instead of saying Try again
[Cloud sessions] Changed connector search results to tell Claude that the search covers only part of the connector directory
[Remote Control] Fixed side-by-side checkouts of one repository looking identical in the environment menu's Remote Control rows; each now shows its own folder name
[Claude Tag] Fixed keyboard focus and screen reader announcements in Claude Tag admin setup; pressing Escape in the connect form no longer also closes the Add dialog
[Code Review] Improved the Code Review analytics page to retry once after a server or network failure, then show a Try again banner instead of empty cards

●

v2.1.317 Nov 3, 2026

v2.1.317

What's changed

Added a warning to /schedule when a new cloud scheduled task gets connectors you did not ask for, with how to remove them
Added a check that asks before a web or shell tool call sends your account email address to the network
Added onFailure: "block" for Agent SDK hook callbacks, so a callback that fails blocks the action instead of letting it run
Added a notice in Claude Desktop's Code tab when your organization's remote managed settings haven't loaded for the session, and another once they do
Added a notice when auto mode's check has no answer for a subagent's tool call, which used to leave nothing in the main view
Added anthropic.plan, anthropic.seat_type, anthropic.provider and anthropic.custom_base_url to OTel metrics, events and spans
Added a cost report to the Claude apps gateway admin API, GET /v1/organizations/analytics/cost, for reading past spend over a date range in total, per developer, per day or per IdP group
Added a daily record of each developer's IdP groups on Claude apps gateways with admin: set, kept for admin.identity_retention_days, which the cost report groups by
Added CLAUDE_CODE_DISABLE_NESTED_SESSION_ID: set it to 1 on a self-hosted runner to have claude -p run inside a session use that session's ID and transcript, as in earlier versions
Fixed project and local MCP servers disconnecting after the first turn in some Claude desktop sessions
Fixed auto mode failing every turn when an LLM gateway set as the base URL answers 403 or 422 to its server-side safety check (a 403 with an apiKeyHelper is unchanged)
Fixed claude auth status exiting before a slow token refresh was saved, which could sign you out on the next run
Fixed a project's effortLevel setting being ignored by sessions that an app starts ahead of time and then opens in the project, such as new sessions in the desktop app's Code tab
Fixed claude --from-pr reporting "No conversations found" in projects with many sessions when the linked session was older than the first page
Fixed the second of two simultaneous permission prompts showing no file path or command on claude.ai and the mobile apps
Fixed Remote Control and SDK hosts offering "don't ask again" on a mod's tool calls
Fixed session titles being lost in cloud and SDK sessions when a new message or Stop arrived while the title was generating
Fixed self-paced /loop wakeups sometimes not being scheduled when Claude left a field out of its request
Fixed auto mode in cloud sessions stopping for approval when the Artifact tool uploaded, wrote to a database or saved a file through the outputs folder
Fixed skills synced from claude.ai being lost or downloaded again every ten minutes when they can't be written to disk
Fixed /schedule leaving a cloud scheduled task's next run time and link out of its results after creating or updating it
Fixed screen readers speaking a running subagent's elapsed time and token count on every change in screen reader mode
Fixed a region or network block (HTTP 403) being shown as a sign-in failure; the error now explains the block
Fixed Claude saying a working claude.ai connector needed authorization or had failed in cloud sessions when a synced plugin included the same server
Fixed claude -p exiting 0 when a full disk or quota lost its transcript or ~/.claude.json writes; it now prints an error and, in text and json output, exits 1. Full NFS exports may be missed
Fixed edits to settings files made in the first second or so after launch not taking effect until a settings file changed again
Fixed old transcripts not being cleaned up on machines where some runs skip cleanup, such as runs using --setting-sources
Fixed deleted agent team inboxes being re-created by a teammate's late message
Fixed a re-created agent teammate being removed from its team by an earlier shutdown approval
Fixed stored scheduled tasks being impossible to list or delete after scheduled tasks were turned off
Fixed Claude deleting your most recently updated /team-onboarding guide when asked to delete one without naming which
Fixed Claude saying a /team-onboarding guide was deleted when the server refused the delete
Fixed the Claude apps gateway hiding Amazon Bedrock's "Input is too long." error, which left sessions failing every turn with "upstream rejected the request" instead of compacting
Fixed self-hosted runner sessions losing recent turns or the whole conversation when restarted while a plan waited for approval
Fixed "Prompt is too long" after automatic compaction in sessions whose very large CLAUDE.md changed since it was last sent
Fixed high memory use and slow startup in headless sessions with many plugins that register commands
Fixed stdio MCP servers receiving an empty AWS_BEARER_TOKEN_BEDROCK when their env config sets it to empty; the variable is now unset, so the server can use the machine's own AWS credentials
Fixed API requests failing with "unable to get local issuer certificate" behind some TLS-inspecting proxies after a root certificate renewal
Fixed very long conversations losing their earlier summary when compaction had to shorten its own request
Fixed a PDF's own metadata being able to make Read and @-mentions under-count its pages
Fixed DISABLE_PROMPT_CACHING_OPUS and DISABLE_PROMPT_CACHING_SONNET having no effect on [1m], other-region and undated spellings of the default model
Fixed /artifacts and the Artifact tool's shared list showing no shared artifacts when you have 200 or more of your own
Fixed Claude treating partial Grep and Glob results as complete when a search hit its time limit
Fixed OpenTelemetry exports to an https:// endpoint through a proxy never being sent when they started while another export was still in progress
Fixed a flood of connection attempts to a proxy that blocks (HTTP 403) OpenTelemetry exports to an http:// endpoint
Fixed OpenTelemetry exports hanging indefinitely behind a proxy that never answers; they now time out after 10 seconds, or OTEL_EXPORTER_OTLP_TIMEOUT up to 30 seconds
Fixed resumed sessions telling Claude again about a file change it already knew about
Fixed Claude sometimes not using a built-in tool in a resumed session after an earlier call failed because the tool was switched off
Fixed /remote-control answering "Unknown command" instead of saying that Remote Control is turned off by the disableRemoteControl setting
Fixed agent team teammates in tmux or iTerm2 panes starting in auto mode when the lead session was in manual mode
Fixed a background session sometimes losing a just-made change of permission mode when it was upgraded or retired
Fixed Ctrl+C stopping all running background agents when pressed to clear typed text at the prompt
Fixed /feedback showing "Enter to confirm" while a report is being sent
Fixed child processes of a stopped shell command sometimes being sent SIGTERM twice, which could make some programs skip their cleanup
Fixed claude -p run inside a cloud or self-hosted runner session sharing that session's ID: it wrote into the session's transcript, and a restart could resume the wrong conversation
Fixed claude -p run inside a cloud or self-hosted runner session generating a title of its own and sending it to that session
Improved the error shown on Microsoft Foundry when Azure credentials can't be loaded: it now says to check or refresh them, and reports as cloud_credential_error
Improved /design-sync to say up front when your design system has moved to Claude, and stop before building instead of failing at upload
Improved the startup error when a required Claude apps gateway can't be reached: it points to the network instead of a sign-in, and says when the gateway's TLS certificate can't be verified
Improved the "Resume this session with" hint shown at exit to repeat the flags you launched with (for example --chrome --debug) ahead of --resume
Improved how self-hosted runners recover from server errors: after a 5xx other than 501 or 529, a runner's next poll now opens a new connection instead of reusing the one that failed
Improved how self-hosted runner sessions recover from server errors: after a 5xx other than 501 or 529, a session now opens new connections instead of reusing the one that failed
Improved how self-hosted runner sessions recover when connections stop answering: after a heartbeat gets no answer, a session now opens new connections instead of trying each idle one in turn
Changed SendMessage so a message to a running background agent arrives earlier: its running command moves to the background, without being stopped
Changed subagents and teammates on a different model from the main conversation to use that model's saved effort level or its default, instead of the session's effort level
Changed exit to skip the "Background work is running" prompt for plugin monitors
Changed the built-in plugin-authoring skill to offer once, after a mod you built works, to help share the mod
Removed the Read tool's "file unchanged since your last Read" stub: reading an unchanged file again returns its content
Windows: Fixed every tool call being refused on some volumes where the native path lookup fails; the working-directory check now compares the folder's identity instead
Windows: Fixed the session scratchpad and other temporary paths growing with your project's path length in sessions not started by Claude Desktop, which made repositories cloned into them hit the 260-character path limit
Gateway: Fixed the status line and /usage showing a developer's own spend limit as 100% used after their group's pooled budget ran out
Self-hosted runner: Fixed Claude not seeing the interrupted tool call when a session moves to a new runner and the turn is older than CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS
Self-hosted runner: Fixed an MCP server that was switched off coming back on after the session moved to a new machine, when the session service had refused to save the switch
Remote Control: Improved fork names when the app doesn't set one: a long name keeps its "(fork)" ending, and in sessions started with claude remote-control a fork of "Name (fork)" is "Name (fork 2)"
[VSCode] Fixed forked conversations dropping messages: only one of the tool calls Claude ran in parallel was kept, and the last messages a compaction kept were lost, which could leave Claude's answer without the question it answered
[VSCode] Fixed a message being lost when Claude did not finish starting in time: the extension now starts Claude once more before showing the error
[VSCode] Fixed the sign-in screen opening when a request is blocked for its region or network
[VSCode] Fixed the Account panel showing the plan name with a lower-cased second word
[VSCode] Fixed file links in a Claude tab opening on top of the chat instead of in another editor group
[VSCode] Fixed attachment chips, menus, banners and dialogs in the Claude panel staying small when chat.fontSize is raised
[VSCode] Fixed ultrathink not raising effort for its turn or showing its rainbow when telemetry is off
[Cloud sessions] Added a link card to cloud sessions, so you can open or decline a link an MCP server asks you to visit instead of the request going unseen
[Cloud sessions] Changed the organization environment dialog in admin settings to the personal dialogs' short layout: each section opens from a row, and unsaved input asks before closing
[Cloud sessions] Fixed adding a network secret for a host that already has one silently replacing it; the Add secret form now refuses and points you to the existing secret
[Cloud sessions] Fixed new scheduled tasks ignoring your organization's default environment: the form now starts on the one an admin chose instead of the Anthropic-hosted default
[Remote Control] Fixed the next message to an idle session going unanswered after you restart claude remote-control, when you sent it within a minute of your previous message
[Claude Tag] Changed newly pasted artifact links in Slack to show a simpler card with an Open button that opens the artifact in Claude, instead of Slack's side panel

●

v2.1.316 Oct 31, 2026

v2.1.316

What's changed

Added CLAUDE_CODE_DISABLE_ULTRATHINK, which turns the ultrathink keyword off
Added pooled group budgets to the Claude apps gateway: one monthly budget that a group's members share, on top of each member's own limit, set with pooled_budget on the spend limits admin API
Added CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP to keep system cross-certificates that certify each other in a loop, for servers whose private CA needs one
Added CLAUDE_CODE_SUBAGENT_EFFORT to set the effort level subagents run at when nothing else names one, instead of inheriting the session's
Added managed.policy_mode: layered to the Claude apps gateway: every policy that matches a developer applies, each merged over the ones listed below it, not only the first
Added guardrail.input_tagging on Claude apps gateway Bedrock upstreams, which wraps prompts in the input tags that an Amazon Bedrock guardrail's prompt attacks filter needs; all_messages_and_system also tags the system prompt
Deprecated fast mode for Opus 4.8 as of October 30, 2026; it will be removed on November 30, 2026. After removal, fast mode requests on Opus 4.8 return an error and do not fall back to standard Opus 4.8. Migrate to Opus 5.5 to keep the speedup
Fixed shell commands being left running on macOS and Linux when Claude Code exits by itself, for example when credentials are refused or a cloud session is archived
Fixed bash aliases with line breaks in their value (except in Git Bash), and functions whose names start with a dash, being garbled or lost in the Bash tool's shell
Fixed bash scripts started from the Bash tool stopping after their first command when SHELLOPTS is exported
Fixed PowerShell hooks not blocking on exit code 2 when the command begins with a type cast, param, using or an attribute
Fixed some network requests hanging when a compressed response was cut off or corrupted
Fixed sonnet, opus and haiku on Vertex AI and Amazon Bedrock showing an error mid-session instead of switching to an older model when the newest is not yet available to the account or region
Fixed the Claude apps gateway not checking every model a request names against availableModels, deniedModels and models; a request that names a blocked model now gets a 400 naming the field
Fixed claude auth login refusing to run where managed settings require a Claude apps gateway; in a terminal it now shows the gateway sign-in
Fixed --restricted sessions uploading files from outside the working directories when a Read allow rule covered them
Fixed prompts containing invisible characters needing a second Enter to send; plain prompts now send cleaned on the first Enter, and commands still wait for review
Fixed sub-agents that inherited a parent sub-agent's model moving to the main model when a background job or message woke them
Fixed a managed autoMode.allow list without "$defaults" getting the built-in exceptions back from a host app's --settings, a first rule added in /permissions, or /auto-mode-setup
Fixed cloud sessions and cloud scheduled tasks not being marked as failed when auto mode stopped a turn because the server returned no safety verdict
Fixed claude -p text output sometimes not saying why auto mode stopped a turn when a background agent was still running
Fixed CLAUDE_CODE_AUTO_MODE_SERVER=1 being ignored in sessions started by a host application (such as Claude Desktop) behind a proxy or LLM gateway with experimental betas turned off
Fixed plugin MCP headersHelper scripts receiving a corrupted CLAUDE_PLUGIN_ROOT and server URL when a credential-named environment variable was set to a switch value such as 1
Fixed the SDK register_repo_root control request not loading the CLAUDE.md of a directory outside the working directory (with CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1)
Fixed the Artifact tool showing ? for artifact database access rules at the self level, and not quoting those rules back when it refuses a republish that would drop them
Fixed /model <id> not warning when the model isn't recognized by this version and auto-compact will assume a 200K context window
Fixed the "hold space to speak" hint using up its three showings in one session, and showing an empty key when push-to-talk is unbound
Fixed Grep and Glob never returning when the search process is killed at the timeout but does not exit, seen on Windows
Fixed a rare case where resuming a conversation did not restore its plan, when /clear or /resume had been run while part of that conversation was still being saved
Fixed first-run setup dropping words from the security notes and the terminal-setup explanation in narrow terminals
Fixed the Enterprise survey card taking a typed 1 or 0 after a short pause; a typed answer now needs Enter
Self-hosted runner: Fixed a message sent while Claude was working being answered after a Stop, once the session's process had been replaced
Self-hosted runner: Fixed an MCP server's on/off switch sometimes being lost when a session moved to a new machine
Windows: Fixed the Bash tool losing your aliases and functions in Git Bash when the rc file sets errexit and pipefail and only winpty aliases, or none, are defined
Improved /code-review started from the Code tab in Claude Desktop or on the web: cloud and claude remote-control sessions now show the findings card, not a plain-text list
Improved /diff on large repositories: each refresh usually runs one fewer full-repository git command, and refreshes are spaced out when git is slow
Improved the messages shown when /ultrareview, a cloud session or a cloud agent finds no GitHub remote: they now say to create a repository at https://github.com/new, and /ultrareview no longer suggests a gh command that gh rejects
Improved SSL certificate errors to name the likely causes, among them a server that leaves out an intermediate certificate, and the fix for each
Changed auto mode so that an autoMode.allow list without "$defaults" no longer removes the built-in rule on scheduled-task prompts
Changed server-managed settings for Team and Enterprise logins: settings fetched from Anthropic's API now apply without an approval prompt, and a stored copy that doesn't verify is refused
[VSCode] Added sign-in to a Claude apps gateway from the chat panel, with no terminal needed
[VSCode] Changed ultrathink to run its turn at xhigh effort and show in a rainbow in the chat box, as in the terminal
[VSCode] Fixed the missing Effort slider, Ultracode switch and model name when the model setting has the [1m] tag, such as opus[1m]
[VSCode] Fixed saved /btw side-question history being deleted too early while a settings file has errors
[VSCode] Fixed a conversation coming back in Auto mode after a reload or restart when its plan was approved with "Yes, and manually approve edits"
[Cloud sessions] Added a form card to cloud sessions, so you can fill in or decline a form an MCP server asks for instead of the request being canceled without you seeing it
[Cloud sessions] Added a "Catching up…" line that shows while a cloud or Remote Control session you switch back to is still bringing its messages up to date
[Cloud sessions] Changed network secrets so Enterprise members can add and delete them on their own cloud environments, instead of only viewing them
[Cloud sessions] Improved the Changes pane for cloud sessions: the note about what the list leaves out is now a badge beside the branch name, not a row above the diff
[Cloud sessions] Fixed file search in a cloud session's Files pane showing folders as ../.. paths after Claude changed directory; results now show their path from the project's root
[Claude Tag] Fixed Claude refusing to edit or append to a canvas it made in a Slack channel, from that channel, once the canvas was also shared to another channel or a DM
[Claude Tag] Fixed untagged replies going unanswered in a Slack Connect thread when both organizations have installed Claude and Slack delivered the reply to the other organization's app
[Claude Tag] Fixed a cloud scheduled task's live status checklist in Slack staying half-done; a run can now edit the top-level messages it posted during that run
[Claude Tag] Changed a Slack channel's Respond automatically switch to a "How Claude participates" choice on the channel's Configure page and in Claude Tag admin settings
[Code Review] Added a findings-by-severity card to the Code Review analytics page, showing the period's total findings, a daily chart stacked by severity, and each severity's count

●

v2.1.314 Oct 30, 2026

v2.1.314

What's changed

Added permissions.blockWritesOutsideWorkingDirectories: Write, Edit and NotebookEdit refuse paths outside the working directories in every permission mode
Added an optional groups list to Claude apps gateway upstreams: only developers in the listed IdP groups are sent to that upstream, on failover too
Added guardrail_trace to Claude apps gateway Bedrock upstreams, to log which Amazon Bedrock guardrail filter fired on a request, without the matched text
Added idle compaction to VS Code and Claude Desktop's Code tab: a 200K+ token conversation left idle is summarized, and the summary is used on your next message if the prompt cache has expired
Fixed sessions failing turn after turn with "Invalid effort level" when an organization's admin caps a model's effort: Claude Code now lowers the effort, retries, and says which level it uses
Fixed claude -p exiting with code 0 and no output when startup failed; it now prints the error and exits 1
Fixed Bedrock sessions with many images failing every turn and /compact with "400 Input is too long." instead of removing older images and compacting
Fixed Microsoft Foundry sessions failing when the resource has no deployment for the default Sonnet, Opus or Haiku model: Claude Code now falls back to an older model of that family
Fixed repeated refused requests behind a gateway that doesn't accept tool search's tool_reference blocks: the request is sent again once without tool search, and the session remembers
Fixed TLS connections failing with UNABLE_TO_GET_ISSUER_CERT when the system certificate store holds a renewed root certificate that is cross-signed with its predecessor
Fixed MCP servers that also work without sign-in showing "needs authentication" after their stored sign-in stopped working; they are now used signed out
Fixed claude mcp logout reporting success when the MCP sign-in was not removed, for example while the macOS keychain is locked over SSH
Fixed extra sign-in renewals when several sessions share an Anthropic profile login and the credentials lock is busy
Fixed claude ultrareview and claude remote-control asking the workspace trust question in a CI job that has a terminal; with CI set they now refuse an untrusted folder at once
Fixed an administrator's TLS trust settings in managed settings not being applied in Claude Desktop sessions
Fixed model switching being refused on machines with managed plugin settings when one of your own --plugin-dir or --plugin-url plugins had a broken manifest or failed to download
Fixed the Bedrock and Vertex model upgrade offer coming back at every start when managed settings pin the model
Fixed forceRemoteSettingsRefresh set only in remote managed settings no longer applying once the stored copy had expired, which let sessions start without policy when the server could not be reached
Fixed "Continue automatically at usage limit" continuing more than three times without a prompt from you when a task restarted itself between waits (a /goal check-in, a background or scheduled task)
Fixed background and cloud sessions started with Ultracode turning it back on at their next start after it had been switched off
Fixed the last broken reply and its retry prompts staying in the conversation after Claude gave up on a tool call that could not be parsed
Fixed a PreCompact hook with very large output making compaction fail or repeat; each hook's output is now cut at 10,000 characters
Fixed background diff refreshes briefly taking the repository's index lock, which could make a git command run at the same moment fail with "Unable to create '.git/index.lock': File exists"
Fixed markdown tables jumping between grid and stacked layouts on half-typed rows while streaming, and long tables falling back to raw pipes
Fixed the /resume picker showing the text of CLAUDE.md or CLAUDE.local.md as a session's title when the session only ran slash commands
Fixed /btw answering from the main conversation when asked from a subagent's open transcript
Fixed pasting an image over SSH to a Linux machine doing nothing silently; the prompt now says to copy the file over and paste its path
Fixed claude remote-control sessions that failed to start when the session service was slow for a moment: the worker's registration is now retried with growing waits
Fixed model switches over Remote Control that take over 8 seconds getting a "still pending" error instead of the final result
Fixed the sandbox.excludedCommands setting description saying listed commands always run outside the sandbox; it now says every command in a call must match an entry
Fixed shell and MCP calls that auto mode, a deny rule or a PreToolUse hook blocked, or that otherwise did not run, reading as if they ran in a collapsed tool group
Fixed sandbox protections not applying to a worktree entered by claude -p --resume or --continue
Fixed hooks matching Bash not running on shell commands started by the Monitor tool; such hooks can block or ask, but not approve or rewrite those commands
Fixed a settings file excluded with --setting-sources still supplying some settings, such as auto mode rules and saved permission consents
Fixed auto mode reporting a call as blocked, and listing it in /permissions, when its safety check gave no verdict
Fixed a Claude apps gateway Vertex upstream hanging for minutes when a Google token endpoint accepts the connection and never answers
Fixed the Claude apps gateway's start-up warning for a deprecated Claude Desktop key that it still serves as written saying "stops being accepted" after the key's end date
Fixed /upgrade opening the browser and starting a new login for plans billed through the App Store or Google Play; it now says where to change the plan
Fixed --resume, and rewinding past a switch to another model after a refusal, moving a session on a model name Claude Code doesn't recognize to a different model
Fixed requests failing when a gateway or cloud provider refuses one of Claude Code's beta headers by name: the request is sent again without it
Fixed model IDs spelled with a dot behind an LLM gateway, such as claude-opus-4.8, being treated as an older model with the wrong context window, output limit, effort, thinking mode and cost
Fixed Remote Control clients showing a stray "Compacted (ctrl+o to see full summary)" row after /compact
Fixed the cloud sessions tip and the Remote Control idle notice showing when an organization's policy turns those features off
Fixed a resumed claude.ai cloud session making a model call nobody asked for when the previous worker stopped just after receiving a new chat's files
Fixed WebFetch in Cowork cloud sessions silently dropping a PDF's text past 100,000 characters; it now says how much was unread and where to read on
Fixed Claude being told only that a command was declined after you stopped it with Esc or Stop in a cloud session or the IDE; it now also hears that the command may have run
Fixed blank lines at the top of a code block disappearing when the code block opens a quote
Fixed a blank line appearing above some ⎿ rows in the transcript view (Ctrl+O)
Fixed vim mode dw, dW, yw and yW carrying on past the end of the line, and made w and W stop on empty lines
Fixed x and Enter in the agent panel sometimes acting on the wrong agent when another agent started or finished
Fixed pasted text and dragged-in files being lost in Claude's question dialog unless the "Other" row had focus
Fixed pasted text being lost when a row in the prompt footer was selected
Fixed vim mode p over a character selection ignoring whether the yanked text was whole lines
Fixed vim mode aw and iw taking the line break at the end of a line
Fixed ↓ selecting footer items hidden by the ? help menu, the command list or a paste hint
Fixed Esc on a command's panel, such as /btw, also interrupting the subagent whose transcript is open
Fixed the welcome header in fullscreen mode showing the session's model while viewing a subagent or teammate that runs on a different model
Fixed the fullscreen transcript being left mid-conversation after "Restore conversation" in the rewind menu while scrolled up
Fixed a rare case where a deleted session could reappear in the resume list as an almost empty entry
Fixed prompts containing tags such as <bash-stdout> or <local-command-stdout> not being acknowledged to a local stream-json host
Fixed sessions staying untitled when the first prompt failed (for example on a usage limit) and the conversation continued afterward
Fixed the skill file watcher checking every removed skill kept in ~/.claude/skills/.trash, which added file system load that grew with each removal
Fixed the session name from /rename disappearing while Claude asks for permission or a plan decision, so side-by-side sessions stay identifiable
Fixed background sessions that fail to start being reported as a deleted daemon binary when the binary is still on disk
Fixed the tip and idle reminder about push notifications appearing when the push settings in /config are hidden or your organization has turned off Remote Control
Fixed ~/.claude/skills/.trash and ~/.claude/plugins/.trash growing without limit: each now holds about 1024 entries, whatever cleanupPeriodDays says
Fixed the Bash edit diff listing a whole file as changed when a CRLF file under git's line-ending conversion was re-saved unchanged or had one line edited
Self-hosted runner: Fixed an idle session moving to another runner instead of pausing when the runner's request to pause it lost its connection before Anthropic answered
Improved memory use in long headless and SDK turns that run many subagents: the parent session no longer keeps each subagent's tool results until the turn ends
Improved prompt history: Ctrl+R now matches text inside collapsed [Pasted text] pills
Improved the /design-sync upload prompt to show the folder, the project and the files it will upload or delete
Improved /permissions review tab, now called Recently blocked: the footer says what Esc will do with marked rows
Improved auto mode's blocked calls: messages name the command, say Claude may retry and auto mode checks again, and point to /permissions to review
Improved permission prompts: a long reason takes fewer rows, so it pushes the command being approved off the screen on fewer terminals
Improved the cloud session error shown while a request refused for your claude.ai login is still being retried: it now also suggests claude auth login
Improved the behavior of stored claude.ai, Team, and Enterprise logins when MDM and remote settings differ on base URL or apiKeyHelper
Improved /config in agent view to say how to stop agent view opening by default
Improved session auto-titles: a session that starts with a skill or a prompt-based command such as /security-review now gets a title from it instead of staying untitled
Improved --resume speed and memory use on damaged transcripts
Improved /context speed in sessions with ten thousand or more MCP tools
Self-hosted runner: Improved the error shown when a session's branch isn't on the git remote: it now covers a never-pushed branch, says how to fix each case, and no longer suggests retrying
Updated the /claude-api skill: its Datadog setup for API tracing now sends the dd-llmobs-enabled: true header, as the Console does, and its ant install instructions drop the outdated macOS xattr step
Updated the bundled dataviz skill to advise printing y-axis tick labels in full under 10,000, and horizontal ones in full under a million where they fit
Updated the bundled dataviz skill to answer donut and pie chart requests with ranked bars or a segmented bar that prints its values
Changed Claude's file tools to ask before editing the local copy of your organization's server-managed settings, as they do for your settings files
Changed /ultrareview to check workspace trust before it runs git, as claude ultrareview does
Changed the Bash tool's shell to clear any inherited which alias or function and to stop passing exported which/unsetenv functions to commands, so which is the system command or zsh builtin
Changed /permissions Recently blocked to refuse approving a call you can't read in full, including one the terminal is too short to show
Changed auto mode in Cowork cloud sessions: a hook's allow of an MCP tool call now counts as no answer, so the classifier or a permission prompt decides
Changed hook if conditions such as Monitor(tail *) to match the Monitor tool's shell commands as Bash(tail *) matches Bash's
Changed the claude-api skill to ask to read a Managed Agents workflow run's workflow before changing the agent to improve that run
Changed flagged requests to retry on another model, not end in a refusal, when ANTHROPIC_DEFAULT_OPUS_MODEL, availableModels or deniedModels leaves only an older Opus model, or none
Changed idle compaction to also run for subscribers with telemetry turned off, and on Bedrock, Vertex, Foundry and LLM gateways once the one-hour prompt cache is on
Changed FORCE_HYPERLINK=false (also no and off) to turn hyperlinks off instead of on
macOS: Changed git grep in most commands that Claude runs to use the C locale, to avoid a reported memory leak in macOS's regex library on files that aren't valid UTF-8
[VSCode] Fixed "Clear authentication" for MCP servers reporting success when the saved sign-in could not be removed
[VSCode] Fixed missing spinner and Stop button while a queued message's hooks run
[VSCode] Fixed session group changes that cannot be saved, such as a delete, failing silently; an error notification now appears
[VSCode] Fixed Cmd+F / Ctrl+F not opening the find widget in the plan preview tab
[VSCode] Fixed the voice dictation shortcut (Ctrl+D) doing nothing under non-Latin keyboard layouts such as Russian, Greek or Hebrew
[VSCode] Fixed missed one-time saved scheduled tasks being deleted without asking when the extension opened without a chat
[VSCode] Changed CLAUDE_CODE_DISABLE_CFC_PROMPT to also stop the extension adding the Claude in Chrome instructions to a session's messages; the browser tools stay available
[Cloud sessions] Added an Include completed button to the Scheduled tasks page when finished one-off tasks are the only ones hidden, so you can show them without opening the Sort menu
[Cloud sessions] Fixed recently used self-hosted environments never appearing among the recent environments on the new session card
[Cloud sessions] Fixed cloud sessions reporting uncommitted changes every turn after Claude moved a branch to a commit it had pushed from another worktree
[Cloud sessions] Fixed the self-hosted environment details dialog in admin settings squeezing its content out of view in very short windows or at high zoom; the dialog now scrolls
[Cloud sessions] Fixed the permission mode picker staying on Auto after a running cloud or Remote Control session refused the switch; it now shows the mode in use and tells you
[Cloud sessions] Improved scheduled tasks: runs in Anthropic's cloud now load the plugins enabled on your claude.ai account
[Cloud sessions] Improved Test connection for GitHub Enterprise in admin settings to also connect the way cloud sessions do, and to warn you when that second test fails
[Cloud sessions] Improved cloud session transcripts: a rename row now names the new title, and repository and environment lists show as a table instead of one line of JSON
[Cloud sessions] Changed cloud sessions from the web, desktop and mobile apps to start even when a setup script exits with an error, instead of failing to start
[Remote Control] Fixed the permission mode button in Remote Control sessions showing the wrong mode until you typed; while your computer is online it now shows the real mode on open
[Claude Tag] Added a dismissible link to the Claude Tag API docs on the Bundles and Channels tabs in admin settings, for Enterprise organizations with Slack connected
[Claude Tag] Fixed @Claude !restart giving up after one failed workspace check in channels shared across Enterprise Grid workspaces; it now retries, then asks you to run it again
[Claude Tag] Fixed a second confirmation DM and channel note when you connect your Claude account from Slack twice from the same link within a few minutes
[Claude Tag] Fixed follow-up messages in Slack showing no sign of progress while Claude's session waits for a self-hosted runner; Claude now posts a wait notice in the thread
[Claude Tag] Fixed Claude sometimes not answering a tag in its own thread in Slack Connect channels where both organizations have installed Claude
[Claude Tag] Fixed Retry on plugin and skill pages in Claude Tag admin settings discarding unsaved access changes after a failed load; your edits now stay in place
[Claude Tag] Fixed the repositories control in Claude Tag admin settings showing the same action twice; its menu now lists only what the button doesn't already do

●

v2.1.312 Oct 27, 2026

v2.1.312

What's changed

Added oidc.user_id_claim to the Claude apps gateway, to identify people by an id_token claim other than sub, such as Microsoft Entra ID's oid
Added click to send: in fullscreen, clicking the "to send now" hint under a queued message sends it right away, as its key does
Fixed managed settings and organization policy not being fetched for the rest of the session after signing in from the VS Code extension
Fixed Claude overwriting a very large CLAUDE.md, rules file or @-included file in a subdirectory after seeing only its start; Write now asks Claude to read it all or edit in place
Fixed per-directory and paths: skills not being found after a Bash cd deeper into a git repository
Fixed a rare case where the first reply after resuming a session in the terminal could be missing the next time the session was resumed
Fixed a command with an invalid name stopping all commands from loading, which could leave claude -p with no output
Fixed the Read tool sometimes failing on PDF pages with "pdftoppm failed: Could not write image" when the clean-up of old session files ran at the same time
Fixed the spinner, OpenTelemetry effort values and transcripts naming a newly picked effort level during a task before the model applied it; they now show the level in force
Fixed the /model and /effort cache warning saying the re-read waits for your next message; a change made while Claude is working can trigger it sooner
Fixed some sessions showing as waiting on you when the last message only mentioned items waiting on you mid-sentence
Fixed agent view restoring input text on the next launch after it was cleared with Ctrl+C just before exiting
Fixed agent view reopening in shell mode after exiting with Ctrl+D from an empty ! input
Fixed vim mode d, c and y with a gj or gk count larger than the lines left deleting or copying text; like Vim, they now only move the cursor
Fixed /verify showing a long description meant for Claude in /help and the / command menu instead of a short one
Improved the prompt's effort indicator: a change made mid-task now says it may wait for your next message, and the note clears when it no longer applies
Improved WebFetch errors in cloud sessions: a host that does not resolve is now explained as possibly outside the allowed network domains, so Claude names the host to allow
Changed Bedrock, Vertex, Foundry and Mantle to use the shorter system prompt for model names Claude Code doesn't recognize, such as custom deployment names and inference profile ARNs, even when they front Sonnet or Haiku; set CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0 to keep the full prompt
Changed automatic model switches after a flagged message to also cover model names Claude Code doesn't recognize, such as custom deployment names; set CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1 to turn them off
Changed usage limit messages to call the 5-hour window the "5-hour limit" instead of the "session limit"
Changed cloud sessions started from the CLI to get their names and branch names from the server
Changed prompt and agent hooks to run at most 24 at a time per session, sub-agents included, plus at most 12 that have waited longer than their event's timeout; a timeout under 1 second now counts as 1 second
Changed a subagent's autoCompactWindow to lower the window set by CLAUDE_CODE_AUTO_COMPACT_WINDOW, where it had no effect before; it still never raises that window
Changed OpenTelemetry mcp_server.name to report the real name of fixed-URL remote MCP servers declared by plugins from the official Anthropic marketplace, instead of custom
Changed Claude Code to stop sending the claude_code.safety_event OpenTelemetry event
[VSCode] Fixed sessions ending on a bare exit code when your organization's settings couldn't be loaded or were refused at startup; the tab now says why and offers Retry or Sign in again
[VSCode] Changed usage limit resets to show a clock time ("Resets at 3:10 PM") and to say "5-hour limit"
[Cloud sessions] Added an effort level to the model picker when you create or edit a routine that runs in the cloud
[Cloud sessions] Added a Bash editor with colors, line numbers and a Copy button to the setup script box in cloud environment settings
[Cloud sessions] Improved the step shown when Claude adds a repository to a cloud session: opening it now shows a short table of what happened instead of raw JSON
[Cloud sessions] Fixed resending an unchanged message after a failed send in a cloud session sometimes running it twice
[Cloud sessions] Fixed a failed cloud environment creation showing its error only as a toast outside the open dialog; it now appears inside the dialog
[Cloud sessions] Fixed Edit in a routine's menu on the Routines page going to the routine's page without opening its edit dialog
[Remote Control] Fixed an unarchived Remote Control session showing as working until a computer reconnected; it now shows as idle
[Claude Tag] Improved Claude Tag's retry notice in Slack to name the model in use, or say rate limits were hit, instead of a generic API error
[Claude Tag] Fixed a Claude Tag channel's on/off switch and agent settings falling back to workspace defaults when an older private Slack channel goes public and gets a new ID
[Claude Tag] Fixed Claude in Slack not replying in channels whose environment has network access set to None
[Claude Tag] Fixed Claude in Slack sometimes posting a file in the wrong thread when it was answering in another thread of the same channel
[Code Review] Fixed Code Review reviewing an outdated commit, or none at all, when GitHub delivered a push event late; it now reviews the pull request's current commit

●

v2.1.311 Oct 26, 2026

v2.1.311

What's changed

Added --hold-idle-file and --max-hold-min to self-hosted-runner, to keep an idle session while your host reports processes it left running
Added a tip for the Explanatory output style, shown when you ask Claude for explanations
Fixed long freezes at startup and after reading or editing files when a CLAUDE.md file holds a very long list item
Fixed interrupting Claude not taking effect until a timeout while an MCP server had not answered a resource read or a skill was still downloading
Fixed standard-context sessions stopping with "Usage credits required for 1M context" when a request ran over 200K tokens; Claude Code now compacts the conversation and continues
Fixed Write and Edit stalling for up to 5 seconds after they ran, and reporting 0 lines changed, when changing thousands of lines in a file
Fixed subagents being unable to use MCP tools from servers that finish connecting after the subagent starts
Fixed Claude seeing stale MEMORY.md and CLAUDE.md content right after automatic compaction when those files were edited earlier in the session
Fixed claude -p and SDK sessions saving transcript messages out of order or keeping messages that were taken back
Fixed SubagentStop hooks running about twice a minute for each running subagent instead of once when it finishes
Fixed the @ file picker ignoring .ignore/.rgignore negation rules that re-include git-ignored files
Fixed a subagent's isolated worktree being removed while a background subagent it started was still working in it
Fixed background agents in auto mode that wait on their own shells starting a new main conversation turn on every wake
Fixed the Bash tool description claiming the working directory always persists between calls
Fixed the environment block naming a shell commands don't run in, such as fish when the Bash tool uses zsh
Fixed claude mcp add, claude mcp remove and /mcp naming the current folder instead of the project entry in ~/.claude.json that holds a local-scope server when run below a repository root
Fixed claude mcp list and claude mcp get showing the error code twice on failed-connection lines (for example ENOENT: ENOENT: …)
Fixed Remote Control sessions staying on "Connecting" for about two minutes when a network proxy blocks a startup request
Fixed messages that Claude sends to a cloud or Remote Control session appearing as your own message in the Claude mobile apps
Fixed Claude not being told the cause when a file attached to a message sent over Remote Control or to a cloud session could not be saved because the disk was full, or that a message's attachments past the first 20 were left out
Fixed WebFetch and WebSearch hanging on a stalled response in Cowork cloud sessions; an unfinished request now fails after 300 seconds
Fixed a background session that crashed between turns not being restarted while it was attached, pinned, or had a scheduled task or wake-up set
Fixed the "background service did not respond" error suggesting the disabled claude daemon restart; it now suggests claude daemon stop --any and says it ends background sessions
Fixed claude respawn <id> starting the background service before reporting that no background session matches the id
Fixed /effort not warning about a prompt cache miss in plan mode when the plan model differs from the session model
Fixed /ide saying the VS Code extension was installed before the install finished or when it failed
Fixed the Write tool's file preview skipping rows and miscounting hidden lines when a line is wider than the terminal
Fixed ↑ in an agent's chat tab recalling a message that was still waiting to be delivered, so resending it sent a second copy
Fixed Cowork cloud sessions losing their connectors and most tools after a restart when a plugin or your settings named an agent; Cowork cloud sessions now ignore that setting
Fixed agent teams sessions showing an empty task list when coming back with --resume, --continue, /resume or --session-id, including after /clear or a crash, and /branch writing to the original session's list
Fixed pasting text that mentions an image file, such as ! open /tmp/shot.png or /review look at /tmp/shot.png, attaching the image and dropping its path from the prompt
Fixed the feedback draft card showing its 1/2/0 and Esc shortcuts while the prompt has text, when those keys act on the prompt instead of the card
Fixed a lone backslash in quotes or brackets, like "\" or (\), disappearing from Claude's responses
Fixed agent teammates compacting their history when DISABLE_COMPACT is set
Fixed the rewind menu offering "Summarize from here" and "Summarize up to here" when DISABLE_COMPACT is set
Fixed a finished /code-review, or another skill that runs in a sub-agent, running a second time when a cloud or background session restarts
Fixed long hidden thinking being cut off as idle on Google Vertex AI, Microsoft Foundry and Claude Platform on AWS, where the endpoint sends thinking progress updates
Fixed /ide saying it had installed the JetBrains plugin when nothing was installed
Fixed Claude Pro and Max subscribers being told to ask their admin when their subscription can't be used; the message now points to billing settings
Fixed the diff pane opening by itself after an edit in wide fullscreen terminals when it had nothing to show
Fixed /mcp showing a remote server as failed after "Clear authentication" when the server works without sign-in
Fixed /mcp showing "authenticated" for a remote server that Claude Code sends no credentials to
Fixed a --plugin-dir folder of plugins loading as one plugin when an empty .mcp.json was at its top
Fixed /usage never showing large prompt-cache misses under "What's contributing to your limits usage?"
Fixed status line links staying plain text in background sessions after you open them from a terminal that supports links
Fixed the /rewind confirmation saying the conversation "will be forked" when the later messages are removed from the conversation
Fixed the /rewind warning that wrongly said manual and Bash edits are never affected by a code restore
Fixed plan approval in screen reader mode sending feedback you had dismissed with Escape
Fixed Claude Code retrying requests the API marked not to retry, which could hold a turn for minutes or, in unattended retry mode (CLAUDE_CODE_RETRY_WATCHDOG), indefinitely
Linux: Fixed sandboxed Bash commands failing with bwrap: Can't create file when a --plugin-dir folder was also an added directory and permissions.blockReadsOutsideWorkingDirectories was on
Self-hosted runner: Fixed a session failing to start when a rate limit (HTTP 429, or a git wrapper that exits 75) blocks an added read-only repository; it now starts without that repository
Improved startup time for Pro and Max accounts by skipping two network requests on launches within an hour of the last check
Improved /teleport and claude --teleport to warn when a compacted cloud session loads from its last compaction, so the messages it summarized aren't in the local copy
Improved the messages shown when a background session's process exits: they no longer promise a restart that isn't coming, and they say how to resume the session
Improved artifacts with several views: Claude now routes each view on the link's #name and no longer says the address bar stays the same as you switch views
Improved shell commands that reach their timeout: the result now shows the output so far and says the command is still running in the background
Improved compaction: when the model's reply has no summary in it, Claude Code now usually asks for the summary once more before it replaces the conversation
Improved the Artifact tool's choice between a page and a document: explainers and visual or interactive work become artifact pages; documents are for writing people keep editing or pass around
Improved startup time for launches whose only arguments are options and their values, such as claude --model opus
Improved the "Connection dropped" API error: it now says where to look first (the proxy or gateway in use, else VPN or firewall; Anthropic API only, Bedrock, Vertex and Foundry are unchanged)
Improved screen reader mode: deleting a rule in /permissions says "Deleted allow rule …" right away
Improved the message shown when a pasted sign-in code is refused: it now says the code may have expired or been used, and to sign in again
Improved Slack connector sends: Claude now checks a channel's topic for posting rules before messaging a channel you didn't name
Improved screen reader mode: Claude's questions are listed as "Questions: Color (answered), Pages", without arrows or symbols
Changed ultrathink in the interactive terminal to run its turn at xhigh effort on Opus 5.5, Sonnet 5.5, Haiku 5.5 and Fable 5.1 through Anthropic's API; typed while Claude is working, it raises the rest of that turn
Changed the ultrathink rainbow to appear only where the keyword can raise effort, and not when the word is quoted or part of a file path
Changed Ctrl+D in agent view to match the prompt: on an empty input, pressing it twice exits
Changed --output-format json and stream-json output to write DEL, C1 control and Unicode format characters inside strings as \uXXXX escapes; parsed values are unchanged
Changed model names and IDs to drop the [1m] suffix and its label on models where the suffix has no effect; the suffix is still accepted
Changed startup warnings about permission rules in settings files to show once per user until the rule changes
Changed /code-review to tell Claude to put the effort level first and use max only when asked
Changed DISABLE_COMPACT in settings files and in a mod's $.env.set so they can only turn compaction off, not back on
Changed Claude Code on Bedrock, Mantle, Vertex, and Foundry to load model settings from a signed file on downloads.claude.ai; set CLAUDE_CODE_MODEL_CATALOG=off to turn this off
Changed sessions that set CLAUDE_CODE_SYNC_SKILLS with feature-flag fetching off to reuse a claude.ai skills list up to 10 minutes old that another session on the machine fetched
Changed clicks on scrollbar arrows and bars in fullscreen lists to act when the mouse button is released, so moving off the scrollbar before letting go cancels the click
Changed claude purge to say it deletes data only on this computer, not anything stored by Anthropic
[VSCode] Added syntax coloring to code blocks in Claude's replies, in light, dark and high contrast dark themes
[VSCode] Added a "Running UserPromptSubmit hooks" spinner status and screen reader announcement for slow UserPromptSubmit hooks
[VSCode] Fixed custom skills and custom slash commands sent from the VS Code or JetBrains panel leaving out the open file or selected lines that ordinary messages include (anthropics/claude-code#102799)
[VSCode] Fixed the extension host freezing while the login shell ran its start-up files to read PATH on macOS and Linux
[VSCode] Fixed clicking an image in a tool result, or closing its preview, also opening the result's text in an editor tab
[VSCode] Fixed voice dictation continuing to record after a message was sent with the Send button; sending now stops dictation first, as pressing Enter already did
[VSCode] Changed the extension to start Claude Code sessions with DISABLE_TELEMETRY set while VS Code's telemetry setting is off, so they send no usage metrics or error reports and fetch no feature flags
[VSCode] Changed the session list side bar to load Web sessions when the Web tab is first opened, not at startup
[Cloud sessions] Fixed routines in Anthropic-hosted environments staying locked after their owner left the organization and rejoined; the owner can now turn them back on
[Cloud sessions] Fixed a failed routine API token delete or regenerate showing nothing if the edit dialog had already closed; it now shows an error toast
[Cloud sessions] Fixed cloud environment dialogs, including the admin dialog, accepting duplicate names; they now refuse a name another listed environment already has
[Claude Tag] Added a Skills view to Claude Tag analytics showing how often Claude runs each attached skill in Slack channels and which go unused, with Usage links in admin settings
[Claude Tag] Improved Claude Tag routines that run in a new session: a run with nothing to report can now end without posting a throwaway message to the channel
[Claude Tag] Changed Claude Tag admin settings to show a lock instead of # for private Slack channels that your own Slack account can see
[Code Review] Improved Code Review's check run to say no further automatic review will start when the model still can't analyze a change on the automatic retry
[Code Review] Improved Code Review reliability: a review whose session fails to start because of a transient server fault is now retried once automatically, and its check run says so

●

v2.1.310 Oct 23, 2026

v2.1.310

What's changed

Added the Monitor tool and plugin monitors on Bedrock, Vertex, and Foundry, and when telemetry or nonessential traffic is disabled; long foreground sleeps are now blocked there too
Fixed requests failing behind some gateways and compatible servers that reject the effort-2025-11-24 beta value or mid-conversation system messages; Claude Code now retries without them
Fixed background cleanup deleting some recent files, such as pasted images, when cleanupPeriodDays is set to a very large value
Fixed compaction after a "Prompt is too long" error keeping too much of a conversation with dense text, such as base64 or SVG, so the next request could fail again
Fixed file read permission prompts not showing where a symbolic link leads
Fixed a question's auto-continue timeout firing the moment the external editor closed after a long edit
Windows: Fixed PreToolUse and PermissionRequest hooks letting a tool call through when Git Bash is missing and the hook's command is only quoted strings, such as a quoted path
Improved auto mode's prompt before the first read outside the working directories: it now says when blocking those reads makes shell commands ask for permission
Improved memory use of non-interactive sessions (-p, Agent SDK) during compaction when the transcript file is very large
Improved a mod's Image to draw inside tmux with allow-passthrough and focus-events on, in kitty, Ghostty, and iTerm2 3.5+ with fullscreen rendering, where it showed only its alt text
Linux: Improved /sandbox and the sandbox startup warning to name Ubuntu's AppArmor restriction on user namespaces, and how to lift it, when it keeps bubblewrap from starting the sandbox
Changed the error for an MCP tool call that times out in a non-interactive session while the server's elicitation is unanswered: it now tells Claude that no answer came and not to repeat the call
[VSCode] Fixed pressing Enter on the plan review card's "Send feedback and keep planning" button approving the plan instead of sending your comments back
[VSCode] Fixed the panel showing "Something went wrong" after "Switch branch & continue" on a cloud session opened from Session history's Web tab
[Cloud sessions] Added Claude Code cloud sessions and Remote Control permissions to Enterprise custom roles, so Owners can control access to each by role
[Cloud sessions] Added a Choose file button to load a cloud environment's setup script from a file
[Cloud sessions] Fixed failed saves and archives in the cloud environment edit dialog showing no error inside the dialog
[Cloud sessions] Fixed failed routine API token actions showing only a toast; the error now appears in the routine edit dialog
[Cloud sessions] Improved the session start checklist to show a cloud environment's setup script output in a scrolling box
[Cloud sessions] Changed turning on Cloud sessions or Remote Control in admin settings to ask for confirmation and list the custom roles that have that permission
[Cloud sessions] Changed the cloud environment dialog to open network access, setup script and environment variables from rows instead of listing every editor at once
[Claude Tag] Fixed Claude Tag treating ! commands such as !restart and !help as ordinary messages when sent in bold, italic or strikethrough
[Claude Tag] Fixed Claude Tag admin channel and workspace pages being replaced by a load error when a background refresh of the bundle list fails
[Claude Tag] Fixed Claude Tag's spend limits page in admin settings reporting that no channels match a filter while channel names are still loading
[Code Review] Fixed the Code Review admin section hiding its repositories and switches after a failed refresh of the repository list
[Code Review] Improved the Code Review admin section to retry the first load and show one Try again banner when it still fails

●

v2.1.309 Oct 22, 2026

v2.1.309

What's changed

Fixed sandboxed Bash commands on macOS and Linux running the shell's startup files outside the sandbox before each command
Fixed macOS sandbox denyWrite glob patterns not applying at a path's real location when the pattern's folder is reached through a symlink
Fixed sandboxed commands and auto-accepted edits being able to modify the MCP config file passed with --mcp-config
Fixed a disabled MCP server being reconnected by a later permission prompt in print and SDK sessions
Fixed the Bash permission check trusting a variable set by a command whose redirect can fail to open
Fixed Bash permission checks not prompting for some compound commands that change directory before running git when the cd is wrapped or prefixed, as they do for a plain cd
Fixed an Edit(path) deny rule not blocking a Bash redirect to that path in some commands that also held a subshell
Fixed worktree-isolated sessions accepting some locale-prefixed commands the isolation guard should refuse
Fixed worktree-isolated sessions on zsh accepting some arithmetic commands that the isolation guard should refuse
Fixed worktrees and branch checkouts that Claude Code creates so they ignore git replace refs, as its other git operations already do
Fixed profile store write protection not applying when the config directory is reached through a symlink
Fixed sessions compacting repeatedly after reading files under a very large nested CLAUDE.md; a nested CLAUDE.md over the size limit now loads only its start
Fixed ctrl+enter (send now) only queuing a message when pressed before the response had started, and restarting a prompt's hooks while leaving the message queued when pressed while those hooks were running
Fixed key-bound slash commands running in the shell from ! mode
Fixed ctrl+o not showing messages from other agents and sessions that are still waiting to be delivered; they now appear in full under the transcript, marked as waiting
Fixed long tool output previews being cut through an emoji, leaving session transcripts that jq could not parse
Fixed Read reporting "File does not exist" for PDF page ranges in Linux sandboxes that share the parent's /proc
Fixed messages from a Claude Desktop-hosted session sometimes being lost when its connection refreshed
Fixed features missing from Claude Code sessions in the Claude desktop app when the terminal on the same computer was signed in to a different account or organization
Fixed the claude remote-control status line showing HEAD as the branch for a folder that is not in a git repository
Fixed split-pane agent teammates not inheriting the tool deny and --tools rules given on the leader's command line
Fixed sessions renamed with /rename appearing to other sessions under a generated name after a VS Code window reload or a non-interactive --resume
Fixed the /rewind list showing "No code changes" for a turn that changed checkpointed files through /code-review --fix, a subagent or a shell command
Fixed /privacy-settings showing an out-of-date "Help improve our AI models" value; it now also says when the setting can't be fetched
Fixed feedback saying "try again later" when your organization does not accept feedback; it now shows the server's reason and where to report a bug
Fixed oversized /feedback reports failing instead of being resent without the transcript
Fixed a skill in an --add-dir folder being unreachable when another skill already held its name; it is now offered as <folder>:<name>
Fixed /verify and /code-review not finding a nested package's own skill when its files were changed from the shell
Fixed the /claude-api skill saying that ant beta:worker poll --on-work passes trace context to the command
Fixed the /claude-api skill's C# tracing setup missing spans from the cloud platform clients
Fixed the /claude-api skill saying that API spans for requests to Claude Platform on AWS can't join the caller's trace
Fixed hooks that run in PowerShell not blocking when the hook's program exits with code 2, and on Windows PreToolUse and PermissionRequest hooks with "shell": "powershell" failing open when Git for Windows isn't installed
Fixed a mod's turn.step hook that names a model by alias, such as haiku, failing every request with a model error: the alias now resolves to its model
Fixed plugins and skills synced from claude.ai being removed, sometimes mid-session, after a disk read error
Fixed artifact publishes and updates being refused for some ordinary pages, such as pages with certain minified scripts or artifacts Claude could not read first
Fixed Claude asking for permission on each artifact update for the rest of a turn after the conversation was compacted in that turn
Fixed fine-grained tool streaming staying off on Amazon Bedrock when ANTHROPIC_BEDROCK_BASE_URL is set to the default bedrock-runtime.<region>.amazonaws.com endpoint
Fixed the "Waiting for API response" hint flickering behind gateways that send only keepalive pings: routes off Anthropic's backend now wait 45 seconds
Fixed Claude notifying unrelated GitHub users by writing role names and placeholders as mentions in PRs, issues and comments
Linux: Fixed sandbox write denies lifting when a background command outlived the session
Windows: Fixed PowerShell permission checks auto-approving some Set-Location or cd commands that target the current directory and carry extra arguments; these now prompt for approval
macOS: Fixed the "Install Command Line Developer Tools" dialog opening each time Claude Code starts on a Mac without Xcode or the Command Line Tools
Self-hosted runner: Fixed --startup-timeout-min stopping a session whose first prompt, such as /code-review, was still working in a subagent; a frozen process is still stopped
Improved the speed of many git commands Claude Code runs for itself on Windows; on every platform, errors from those commands now show in English even when git is set to another language
Improved the error when a hooks module is nested too deep to load: it now names the file instead of showing a bare stack-overflow message
Improved disk-full handling: a Bash command cut off by a full disk now says so and names the folder to free up, and starting on a full temp volume prints a clear message, not a raw ENOSPC error
Improved the /claude-api skill to offer API tracing alongside SDK tracing when asked to add OpenTelemetry
Improved the /claude-api skill to check the live docs before saying a feature is unsupported
Self-hosted runner: Improved sessions that move to a new runner: Claude now sees the tool call that was interrupted, marked as outcome unknown
Updated the bundled dataviz skill to accept APCA as a text-contrast measure (keeping WCAG 2 ratios where AA conformance is required), add an apca(text, background) function to its palette validator scripts, and say whether a label inside a colored chart fill should be white or near-black
Updated the /claude-api skill: service account keys and Workload Identity Federation tokens can now manage OpenTelemetry destinations
Changed sed -i to get the standard Bash prompt and run as written, not a simulated file-edit preview; like other Bash edits, it is no longer restored by /rewind
Changed claude ultrareview to require workspace trust: it asks on a terminal, else refuses; scripts pass --trust-workspace, which takes no value (put a PR number or base branch before it), or set CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1
Changed the dangerous rm and rmdir prompt in bypass permissions mode in the Desktop app and VS Code to deny the command at once with a rewrite hint, so unattended sessions keep going
Changed commands the settings exclude from the sandbox to ask before writing to its write-list paths while the sandbox is enabled but cannot run; the unsandboxed fallback is refused there
Changed worktree creation and reuse so git no longer fetches objects on demand, in ordinary clones and in partial clones with a Bash sandbox configured; such a partial clone fetches them first
Changed the /claude-api skill to build Managed Agents subagent teams on multiagent_20261001 with dynamic workflows on by default, instead of coordinator
[VSCode] Added a log warning that says what to do when dictation or the extension's own requests fail certificate verification, such as behind a TLS-inspecting proxy
[VSCode] Fixed the Claude panel staying blank after the editor cached an incomplete copy of its files; it now recovers by itself, or says what went wrong and how to fix it
[VSCode] Fixed Session history filling up with empty "Untitled" sessions each time you start a new session without sending a message
[VSCode] Fixed long slash-command messages such as /goal filling the chat panel; they now fold behind Show more like other prompts (anthropics/claude-code#97469)
[VSCode] Fixed long messages not folding behind Show more after the chat panel is made narrower
[VSCode] Fixed Ctrl+J in the chat input always inserting a newline: it is now left to VS Code and the OS when "ctrl+j" is set to null in the Chat context of ~/.claude/keybindings.json
[VSCode] Fixed a mod's "From the … plugin" label above the prompt being drawn over the slash command and @-mention menus (anthropics/claude-code#102981)
[VSCode] Fixed an empty list item, paragraph or code block, and list items renumbered from 1, when pasting copied LaTeX math
[VSCode] Fixed the feedback error showing only an HTTP status when your organization does not accept feedback
[VSCode] Improved Edit and Write speed in the chat panel: the wait for new problems after each edit is now 0.75 seconds in most cases, down from 1 to 1.5 seconds
[Cloud sessions] Fixed the Add connector list in routine forms saying no connectors were available while they were still loading
[Cloud sessions] Fixed the cloud environment editor shuffling environment variables and adding backslashes to values that contain both kinds of quote
[Cloud sessions] Fixed the self-hosted environment details dialog in admin settings so its title, tabs and buttons stay in view while only the content scrolls
[Cloud sessions] Fixed the "read documentation" tool row in cloud sessions, which showed escaped JSON instead of a readable page
[Cloud sessions] Improved a cloud session's Changes pane, which now says when it lists only pushed commits or only Claude's edits
[Claude Tag] Fixed Claude in Slack posting a draft you approved for a channel into your DM by mistake; a post with no channel is now refused so it can go to the approved channel
[Claude Tag] Fixed Allow and Deny on Claude's approval cards in Slack doing nothing when the session had stopped; your answer now restarts the session
[Claude Tag] Fixed Claude ignoring untagged messages in a Slack channel after its workspace moved to a different Claude organization, including unshared channels on Enterprise Grid
[Claude Tag] Fixed Claude in a Slack channel posting a threaded reply before reading a newer message someone had just added to that thread
[Claude Tag] Fixed the Slack page in Claude Tag admin settings saying no workspaces were connected when the list failed to load; it now shows an error with a Retry button
[Code Review] Fixed a finished review showing no check on the pull request when earlier tries to create it failed; a final try now adds a completed check
[Code Review] Fixed a push queued behind a running review still starting a review after @claude review stop; its check now closes and says why

●

v2.1.308 Oct 22, 2026

v2.1.308

What's changed

Bug fixes and reliability improvements

●

v2.1.307 Oct 21, 2026

v2.1.307

What's changed

Added /claude-api api-version to move Claude API code to API version 2026-10-21
Added the claude_code.safety_event OpenTelemetry event for each tool call a permission rule, auto mode, a safety check, a hook or the sandbox stopped, prompted or sent back
Fixed requests failing with a model-not-found error when CLAUDE_CODE_DISABLE_1M_CONTEXT is set and the model is an alias with the [1m] suffix, such as opus[1m]
Fixed the prompt-caching-scope beta header being sent behind custom ANTHROPIC_BASE_URL gateways and on Foundry, where it has no effect
Fixed MCP servers showing "needs authentication" in claude -p on macOS while the login keychain was locked; they now say why, and the next run after an unlock connects without a new sign-in
Fixed MCP servers being reported as timed out, and staying failed in headless runs, when a macOS or Linux computer went to sleep while they were connecting
Fixed HTTP MCP tool calls being sent twice when the connection closed mid-call; only read-only or idempotent tools are now retried
Fixed a turn sometimes starting without an SDK MCP server's latest tools when a background task was running
Fixed some "Autocompact is thrashing" errors in turns that read many PDF pages, images or other large tool results
Fixed /autocompact in cloud sessions going back to the default window after the session restarted
Fixed a conversation cleared with /clear sometimes coming back when a cloud or self-hosted runner session restarted
Fixed CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS being ignored in Claude apps gateway sessions
Fixed telemetry from Claude Desktop sessions behind a Claude apps gateway being rejected when OTEL_EXPORTER_OTLP_HEADERS is set
Fixed /permissions > Recently denied not showing the denied shell command, and auto mode's local classifier ignoring an approval from there when it checks a retried command; approving a row now names the command, not its description
Fixed /help and the / command menu showing long model-facing descriptions for bundled skills such as /claude-api instead of their short descriptions
Fixed subagent transcripts recording placeholder token usage and an empty stop reason for streamed responses
Fixed model switches through the Agent SDK's setModel(), and apps built on it, being refused when the API took more than 5 seconds to confirm the model; Claude Code now waits up to 15 seconds
Fixed a background command stopped through a connected app (such as the desktop app archiving an idle session) being reported to Claude as stopped by the user; the notice now names its output file
Fixed WebFetch in Cowork cloud sessions reporting a tool error when a site answered with a 4xx status or a robots.txt refusal; it is now a normal result, as in local sessions
Fixed write tools on a directly configured GitHub MCP server showing a form that closed without creating anything in the desktop app's Code tab
Fixed Artifact tool reads failing with a connection reset when the server had closed a reused connection
Self-hosted runner: Fixed sessions with --use-anthropic-git-proxy committing a .claude/settings.local.json left in the clone by an earlier session
Self-hosted runner: Fixed archiving or requeueing a session, or stopping the runner, during its checkout hook leaving the hook's processes running and the runner's slot held
Improved recovery from unparseable tool calls: Claude Code now retries the call up to twice before ending the turn with an error
Improved fork subagents launched together: each is now told which launch is its own, so forks are much less likely to try to start each other's work
Improved browser sign-in: the success page now appears as soon as sign-in completes, without waiting for your account profile to load
Improved web search errors in cloud and self-hosted runner sessions: a search refused with a 403 that gives a reason now shows that reason instead of a generic "Authentication error"
Improved the time to the first reply in cloud sessions when one of the desktop app's MCP servers can't connect
Improved Remote Control connect time for sessions whose transcript contains large pasted images or PDF reads
Changed the notice Claude gets when the WebSearch budget is used up to also tell it not to query search engines in a browser or through computer use
Changed the axScreenReader setting and CLAUDE_AX_SCREEN_READER in a settings env block to apply only from user, managed or --settings settings (since 2.1.305)
Self-hosted runner: Changed checkout hooks to be stopped after 30 minutes by default, failing the session's setup; if yours needs longer, raise --checkout-hook-timeout-min or set it to 0
Self-hosted runner: Changed the certificate file built for Anthropic-managed git to filter its trusted certificates as the CLI does; a [runner:warn] line gives the number left out
[VSCode] Added a notice on the microphone button when voice dictation stops by itself (15 seconds without recognized speech, or the 2-minute limit), saying why and that the text so far is kept
[VSCode] Fixed a long prompt expanded with Show more covering the whole chat panel: a pinned prompt is now capped at 40% of the panel and scrolls
[VSCode] Fixed part of a list item or table cell with LaTeX math pasting as a new list or table in rich text editors
[VSCode] Fixed dictation failing behind a TLS-inspecting proxy when NODE_EXTRA_CA_CERTS is set only in ~/.claude/settings.json; it now also follows CLAUDE_CODE_CERT_STORE
[VSCode] Changed the "still open somewhere else" notice to also cover a Claude process left over from an extension restart, which usually ends on its own within about 10 minutes
[VSCode] Changed voice dictation to filter its trusted certificates as the CLI does
[VSCode] Changed the extension's own requests to filter their trusted certificates as the CLI does, and to trust the NODE_EXTRA_CA_CERTS file named in the environment or in user settings
[Cloud sessions] Fixed the repository picker saying "No repositories match" while a search was still running; it now shows "Searching…" until the results arrive
[Cloud sessions] Fixed the "Waiting for a runner" status on self-hosted environments being cut off; with on-demand runners it now counts up from your last message and shows failed attempts
[Code Review] Added @claude review stop (also off and pause) to Code Review, ending an @claude review always subscription on a pull request without starting a new review

●

v2.1.306 Oct 21, 2026

v2.1.306

What's changed

Fixed claude -p inside cloud sessions reporting "Not logged in" when started without the session's environment variables
Fixed an API error being replaced by "prompt is too long", and an unneeded compaction, in sessions with many MCP tools

●

v2.1.305 Oct 20, 2026

v2.1.305

What's changed

Added sandbox.allowNestedUserNamespaces so sandboxed commands on Linux can create user namespaces (Chromium, rootless podman); this lets them get around the sandbox's file protections
Added CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS so unattended retry mode (CLAUDE_CODE_RETRY_WATCHDOG) notices a usage limit that was lifted before its reset
Fixed every request failing on Vertex, Bedrock and other providers when the endpoint or a gateway rejects tool search, and behind gateways with ToolSearch disallowed or left out of --tools (a 2.1.304 regression): Claude Code now retries without it
Fixed /effort and /autocompact settings not applying when the model name differed from a modelOverrides value by letter case or a [1m] tag
Fixed new worktrees in a bare repository sometimes starting from local HEAD instead of the default branch, and unchanged subagent worktrees sometimes not being cleaned up
Fixed Bash commands on a full disk failing with a raw ENOSPC file path: the error now says the disk is full and that nothing ran
Fixed an MCP server passed by a cloud session or by the SDK's setMcpServers being replaced later in the session by a same-named server from your own settings
Fixed Claude naming the wrong model for a subagent's work after the subagent switched to a fallback model
Fixed cloud sessions and teammates not telling Claude when a compaction had to leave the oldest messages out of its summary to fit
Fixed more cases of scheduled Cowork cloud sessions waiting five minutes for each subagent whose WebFetch needed a URL approval that nobody was there to give
Fixed Workflow resume re-running already-completed pipeline() and parallel() agents instead of serving them from the run's journal
Fixed Remote Control leaving empty "(session)" entries in /resume after switching conversations with /resume
Fixed /usage rows being cut off in narrow terminals
Fixed startup warnings printing as raw text above the logo: they now go to the debug log, and permission rules that restrict nothing show as warning rows under the banner
Fixed screen reader mode: search boxes now say "Search:" instead of a symbol VoiceOver read as "telephone recorder", and highlighted prompt text, such as Ctrl+R search matches and "ultrathink", no longer has spaces inside words
Self-hosted runner: Fixed a start script that shares only its stdout with the runner or orchestrator failing with Resource temporarily unavailable when TERM is set (a 2.1.300 regression)
Self-hosted runner: Fixed repository access failing since 2.1.296 when a git credential helper or askpass program reads its settings through GIT_CONFIG
Self-hosted runner: Fixed the orchestrator reporting a spawn-runner hook as timed out when a runner it started in the background kept its output open
Improved /usage: each warning is now a one-line fix that names its source, and f applies the fixes; the same fixes appear in VS Code and /doctor
Improved MCP consent dialogs so an Enter meant for the prompt is less likely to be taken as Accept
Improved a mod's Image to draw its picture in iTerm2 3.5 and later with fullscreen rendering, where it showed only its alt text
Remote Control: Improved the spawn-mode messages: pressing w now says the new mode is saved for the folder, and a later claude remote-control start that uses the saved mode says where it came from
Changed allowedMcpServers to stop filtering managed-mcp.json stdio servers that use ${VAR} only in env: one your allowlist left out now loads on upgrade; use deniedMcpServers to keep it off
Changed plugins that Claude Desktop mounts by path to no longer keep their allowed-tools when your organization's managed settings set allowManagedPermissionRulesOnly
Changed the /artifacts delete confirmation to take 1 or Enter to keep, 2 to delete, and Esc to cancel; y and n no longer answer it
Changed a mod's docked pane to stay within 45% of the terminal's width, including a width kept from a wider terminal
[VSCode] Added a "Running start-up hooks" spinner status, with a screen reader announcement, while SessionStart or Setup hooks run
[VSCode] Fixed the spinner cutting off "Compacting..." when your spinnerVerbs setting replaces the built-in verbs with short ones
[VSCode] Changed the message shown when a session does not start in time and no hook is running: it now leads with the output logs and lists causes instead of pointing to sign-in and network first
[Cloud sessions] Fixed the Cloud environments admin page wrongly refusing to save an existing environment with an "installs packages" error
[Cloud sessions] Improved deleting a self-hosted environment so the dialog and error messages say what blocks the delete and what it will affect
[Claude Tag] Added public Slack channels Claude hasn't joined to the Claude Tag admin Add place search, so admins can set one up from there
[Claude Tag] Fixed Claude Tag access bundles so a repository that moved to another GitHub account can be added again
[Claude Tag] Fixed a routine set up in a Slack DM thread no longer posting after another routine in that thread restarted the conversation; both now keep posting there
[Claude Tag] Fixed routines set up in a Slack thread reporting success without posting after the conversation ended; those runs are now skipped and the creator is told
[Claude Tag] Improved Claude Tag admin pages in large organizations so plugin, skill and bundle edits work while the channel list is still loading
[Code Review] Fixed Code Review sometimes not reviewing the newest commit when several pushes landed on a pull request during a review
[Code Review] Changed Code Review re-reviews so they no longer open with LGTM while earlier blocking findings are still open

●

v2.1.304 Oct 19, 2026

v2.1.304

What's changed

Added a transcript line when a plugin that runs first skips one of your mod's hooks, naming the event and the plugin
Added decider: "person" to a mod's tool.check answer: only the permission dialog or a host's callback can approve the ask, and it is refused with the mod's reason where nobody can be asked
Added e.isReadOnly to a mod's tool.check event, set when the tool call is read-only
Added /auto-mode-setup: a guided setup that reads your project and recent sessions to teach auto mode about your environment, now also available on Bedrock, Vertex, Foundry, Claude apps gateway and telemetry-disabled sessions
Added /claude-api managed-agents-secure, which compares a Managed Agents agent's settings with Anthropic's published security guide, without changing anything
Added the names of the tools called earlier to the compaction summary in the transcript view (Ctrl+O)
Added a warning on Pro and Max plans when resuming an inactive conversation would use a noticeable share of your 5-hour usage limit: resume anyway, or start a new conversation and Claude can look up the previous one if you refer to it
Fixed the organization policy not refreshing until the hourly check after approving an ANTHROPIC_API_KEY at startup or switching "Use custom API key" in /config
Fixed sandboxed commands failing to start on Linux when a sandbox.filesystem.denyRead glob contains brackets that are not a character class, such as a [user-id] route folder
Fixed rm -r of a mounted drive or a folder at its top level (/Volumes, /media, WSL's /mnt/c) not getting the safety prompt that rm -rf /Applications gets
Fixed CLAUDE_CODE_TRANSCRIPT_LOCAL_GC dropping messages from the saved transcript when the disk filled up while the file was being trimmed
Fixed a plugin keeping a headless run going past --max-turns, Stop, or ended input by spawning subagents or re-running a finished one
Fixed a failed mod reload removing the tools and commands of the version that stays loaded, and its messages being wrong or silent about whether the previous version is still loaded
Fixed a click on a mod's button being lost when buttons with the same label and no key were redrawn unchanged
Fixed mod sharing in the built-in plugin-authoring skill stopping at the secret scan on machines with managed settings and on Team and Enterprise plans
Fixed scheduled Cowork cloud sessions waiting five minutes again for each subagent whose WebFetch needed a URL approval that nobody was there to give
Fixed Write results and rejected edits showing a file outside the working directory as ../../…; they now show ~/… or the full path
Fixed a claude.ai Directory plugin's skills not running as commands when picked from the "/" menu in Cowork cloud sessions
Fixed Remote Control permanently withholding a desktop conversation's history when a different account was signed in to the terminal
Fixed Remote Control failing to start from Claude Desktop when DISABLE_TELEMETRY or DO_NOT_TRACK is set on a paid plan
Fixed model switches, messages and interrupts waiting behind a context usage check in SDK and desktop sessions
Fixed context_management: Extra inputs are not permitted errors behind LLM gateways; Claude Code now resends the request without that field
Fixed OpenTelemetry settings delivered through server-managed settings being ignored for the whole session after signing in during first-run setup or the first start after /logout
Fixed unsandboxed Bash commands in Claude Desktop Code tab sessions on macOS and Linux not seeing environment variables exported in shell startup files such as ~/.zshrc
Fixed the Consumer Terms notice being skipped for a day or longer after a server error
Fixed /privacy-settings offering choices that may not apply to you after a network or server error
Fixed a "Context limit reached" or "Prompt is too long" error after stopping a turn while Claude Code was compacting a conversation the API had rejected as too long
Fixed subagents sometimes forgetting their most recent work when they were messaged or resumed right after finishing
Fixed claude --help text for --tools, --resume, --debug, --json-schema, --disable-slash-commands, --system-prompt-snapshot and claude update to match actual behavior
Fixed claude --worktree removing the worktree and its branch without asking at exit when HEAD was detached or on another branch, which could lose commits
Fixed resumed and cloud sessions sending Claude the whole skill list again each time plugins reloaded at startup
Fixed an interrupt not ending a Read that waits on an idle pipe or device named like an image
Fixed /effort status, /effort ultracode and the prompt's effort indicator showing a guessed effort level when CLAUDE_CODE_EFFORT_LEVEL is auto or unset and no level is sent
Fixed a PreToolUse hook's deny reason being replaced by a timeout error when an Agent SDK callback hook on the same tool call timed out
Fixed Bash and PowerShell deleting a large command's output file when it could not be copied to the session's tool-results folder, unless the disk is full
Fixed notes typed into a multiple-choice question with previews being cut off with "…" in terminals under about 100 columns, hiding what was typed (anthropics/claude-code#82768)
Fixed self-paced /loop wakeups scheduled at the 1-hour maximum firing just after the 1-hour prompt cache expired, so those wakeups no longer re-read the conversation uncached
Fixed agent teams: approving a shutdown request from the main session no longer exits the whole CLI
Fixed a skill's once hook also removing another skill's identical hook after it ran
Fixed transcript mode's { and } landing the prompt on an inconsistent row, or off screen, instead of the transcript's first row
Fixed CLAUDE_CODE_AUTO_COMPACT_WINDOW=200k silently setting a 100K window: the variable now accepts k and M suffixes like --autocompact, and warns when a value is out of range or ignored
Fixed Ctrl+C in the agents view clearing a text selection without copying it when pressed before the mouse button was released
Improved /usage to say when a rate limit on usage data ends instead of "try again in a moment"
Improved the lines shown when a mod written in the session loads, reloads or fails to load
Improved artifacts with several views: when you ask for links to them, Claude now writes out each view's link and explains that the address bar stays the same as you switch views
Improved cloud sessions: a new conversation's first turn no longer waits for the local (stdio) MCP servers of plugins synced from claude.ai, unless a server sets alwaysLoad: true
Improved how a remote session recovers its status when the server refuses a status update that carried other session data
Improved session file size in auto mode: the safety classifier's context is no longer stored with every request
Improved the claude -p invalid-settings warning: a file that did not load lists only what stopped it, and long lists are capped per file
Improved resume of large compacted sessions in SDK and headless mode: the first request after resuming is sent sooner
Improved responsiveness and throughput when many subagents are running at the same time
Improved memory use when sending requests in long or resumed conversations
Self-hosted runner: Improved the error shown when the git host answers "not found" for a session's repository: it now names the repository and whom to ask
Windows: Improved git command start-up with a standard Git for Windows install by running its git.exe directly instead of through its cmd launcher
Changed mods' settings.read hooks to receive each settings layer and rewrite the merged settings, so a managed mod can make an organization's setting a ceiling, including the cleanupPeriodDays the retention sweep uses
Changed the /artifacts delete confirmation to show numbered choices: 1 or Enter keeps the artifact, 2 deletes it, and y, n and Esc still work
Changed the question that turns on the mods Claude writes in a session to plain text with no link or session id; it stays up when a new turn starts, and Claude tells you what loaded when you turn them on
Changed tool search to be on by default behind a custom ANTHROPIC_BASE_URL; a 400 or 422 from the gateway is retried without it
Changed compaction to send Claude the skill list again afterwards; /reload-skills now sends only new or changed skills
Changed skill hooks: the skills of one source (a repo, your own folder, or a plugin) can register at most 1,024 hooks and 16,384 matcher characters per session
Changed skills under a policy that allows hooks from plugins only: a skill used in the main conversation whose hooks are kept out no longer gets its allowed-tools
Updated the /claude-api skill to use the ant CLI on Claude Platform on AWS instead of falling back to the SDK or curl
Removed the notes from claude plugin validate that predicted where a mod's hooks would run
Removed the "(research preview)" label from the /fast dialog title on Opus 5.5
[VSCode] Added mod drawing in the chat panel for sessions on Amazon Bedrock, Google Vertex AI and Microsoft Foundry, behind an LLM gateway, or with telemetry turned off
[VSCode] Fixed one cause of sessions failing to start with "Subprocess initialization did not complete within 60000ms": time a SessionStart command hook spends running no longer counts toward the limit, up to 10 minutes in total
[VSCode] Fixed a session closed while it was starting keeping its Claude Code process running until the start ended
[VSCode] Fixed a mod's drawings disappearing from a long-open panel until the next turn on machines that also run an older Claude Code
[VSCode] Fixed Past conversations hiding sessions when claudeCode.claudeProcessWrapper is set
[VSCode] Changed background sub-agents to show as one status line under their Agent card instead of streaming every step into the chat; the full transcript stays in /tasks
[Cloud sessions] Fixed folders in the composer's @ list showing no name in cloud sessions, where picking one added only a space instead of a mention
[Claude Tag] Fixed Claude going silent in a thread when its channel becomes shared across Enterprise Grid workspaces mid-task; it now posts a one-time note to @-mention it in a new thread
[Claude Tag] Fixed @Claude !fork typed outside a thread getting no visible reply; Claude now shows you a private note saying to run it from inside a thread
[Code Review] Added review levels to Code Review: Owners choose Quick, Standard (the default), or Deep for the organization, and can give individual repositories their own level
[Code Review] Added an option in Code Review admin settings to review every repository in a GitHub organization, including ones added later, without selecting them one by one
[Code Review] Fixed pull requests opened within a minute or two of an admin turning on Code Review being silently skipped; they are now retried and reviewed

●

v2.1.303 Oct 18, 2026

v2.1.303

What's changed

Bug fixes and reliability improvements

●

v2.1.302 Oct 16, 2026

v2.1.302

What's changed

Added CLAUDE_CODE_AUTO_MODE_MODEL to choose the model the client-side auto mode classifier uses; it does not change the model for server-side auto mode
Added an Idle compaction row to /config for turning idle compaction off or back on; the notices shown after an idle compaction now say how to turn it off
Added a notice to /design-sync and /design-login that standalone Claude Design (claude.ai/design) closes by December 14, 2026
Fixed a "Prompt is too long" error when stopping a turn while the conversation was being compacted
Fixed requests failing with "diagnostics: Extra inputs are not permitted" after switching to Vertex or Bedrock mid-session
Fixed the Read tool loading an image file of any size, or a pipe or device named like an image, entirely into memory; image sources over 128 MB are now refused
Fixed /autocompact and /effort saving to the wrong model when a gateway names Opus 4 or 4.1 with a prefix, such as anthropic/claude-opus-4-1
Fixed a prompt cache miss when a tool added mid-session was loaded again through ToolSearch or after compaction
Fixed claude plugin and other subcommands sometimes exiting before a queued settings or config write finished, which could lose the change or leave a .tmp file behind
Fixed plugin marketplaces re-cloning on every refresh, and newly installed git plugins showing version "unknown", when git defaults to the reftable ref format
Fixed the PowerShell tool not finding commands in a plugin's bin/ folder, and reporting an error when a search that finds nothing (rg, grep, findstr, git grep) is piped into Select-Object or another formatting cmdlet
Fixed Claude in the desktop app pointing you to claude.ai settings or /mcp to authorize or reconnect an MCP server where that option isn't available
Fixed artifact publishes sometimes failing when Claude sent an empty list of edits, and Claude retrying an artifact update the wrong way after a newer version of the artifact turned it away
Fixed classifier_category missing from OpenTelemetry tool_decision events for most auto mode classifier blocks, and new tool_decision attributes pushing out tool_use_id, tool_source and tool_parameters when OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT is low
Fixed rows in the agents view staying blank after moving down a long list or folding a section
Fixed claude remote-control --help not printing its usage and exiting when not signed in
Fixed /design consent and /design revoke suggesting /design-login when they fail in a cloud session, where it isn't available; the message now points to claude.ai/design/settings
Fixed MCP servers showing no tools, or every tool call failing, when the server negotiates protocol version 2026-07-28 but omits resultType, ttlMs or cacheScope
Fixed prompt suggestions spending usage credits on models your plan pays for only with credits: they are now skipped after a reply billed to credits
Fixed URLs written in backticks being clickable only on their first row when they wrap; the whole URL is now one link in terminals that support hyperlinks
Fixed claude plugin details <name>@builtin suggesting claude plugin list, which never shows built-in plugins, when the plugin isn't found; it now points to /plugin
Fixed an emoji that a link starts inside wrapping one column too wide, which hid it in question previews and turned tables into lists
Fixed worktree isolation refusing to create or resume worktrees under git 2.56 or later when a stray .git file points at a directory that doesn't exist
Fixed a cloud session's cost and usage restarting from zero after the session resumed in a new process
Self-hosted runner: Fixed git fetches failing with "bad object refs/heads" in sessions that reuse a checkout stored in git's reftable format
Windows: Fixed every file write being refused or asked about for projects on exFAT or FAT32 drives, including in sessions started with --plugin-dir
Improved startup time with many plugins enabled: plugin command and agent files now take far fewer file system calls to load, most of all on Windows
Improved auto mode with the server-side classifier: a conversation too long for the safety check is now compacted, instead of every checked tool call being denied
Improved the message when a background session reopened from another folder has no LLM gateway: it now says why, instead of "Not logged in"
Changed claude -p and Agent SDK sessions with no permission mode to start in default mode on third-party providers, with telemetry off or on a fresh install; --permission-mode auto keeps auto
Changed fork subagents (subagent_type: "fork") to be on by default in claude -p, the Agent SDK, the desktop app and VS Code, as they already are in the terminal; CLAUDE_CODE_FORK_SUBAGENT=0 turns them off, and claude mcp serve never offers them
Changed the desktop app and VS Code to always run the main conversation's subagents in the background, as the terminal does, rather than let Claude choose; a subagent's own Agent calls in claude -p, the Agent SDK, the desktop app and VS Code now run in the foreground by default
Changed the ← for agents footer hint to hide 10 seconds after a session opens; the count of agents waiting on you still shows
Changed where the Claude in Chrome instructions sit in the system prompt so that new conversations can read them from the shared prompt cache
Changed prompt and agent hooks so that at most 12 of one event run at a time; the rest wait their turn
Changed the message shown when your organization's policy turns off /feedback: it now points to GitHub issues instead of an organization admin
[VSCode] Fixed text after an unclosed code block in a list showing as plain text while a reply streams, then turning into code
[VSCode] Fixed MCP server sign-in from the panel opening a broken authorization page when the server URL contains a query string
[VSCode] Fixed the @browser banner saying "Browser connected" when no browser with the Claude extension can be reached
[Cloud sessions] Added a banner on a routine's page that says why its last run didn't start, such as your organization reaching its limit on concurrent cloud sessions
[Cloud sessions] Fixed "Rewind to here" failing on every message except the newest in cloud sessions; self-hosted runners need Claude Code v2.1.246 or later
[Cloud sessions] Fixed the pull request status bar in cloud sessions flipping a pull request with merge conflicts back to ready while GitHub rechecked it
[Cloud sessions] Fixed routine runs showing as Completed after their cloud session stopped unexpectedly, and as Cancelled when archived before they started, instead of failed
[Cloud sessions] Fixed the diff view in cloud sessions missing changes or failing to load after the session's GitHub repository was renamed or moved
[Cloud sessions] Fixed a scheduled routine run that failed partway being run again from the start an hour or more later, which could repeat work such as posting the same report twice
[Cloud sessions] Fixed an open cloud session sometimes not showing messages sent from another device until you reloaded the page or clicked away and back
[Cloud sessions] Improved the error shown when a cloud session fails to start: it now says "Connection lost" or "Server error" instead of "Something went wrong"
[Remote Control] Fixed a subagent's pane spinning forever in a Remote Control session after your computer goes offline; it now says Remote Control is disconnected
[Claude Tag] Fixed "is thinking…" staying up under a mention in a Slack channel or DM after Claude answered it by editing one of its earlier messages
[Claude Tag] Fixed URLs in code blocks under a numbered or bulleted step of Claude's Slack replies being wrapped in angle brackets, which broke copied commands
[Claude Tag] Fixed HEIC, SVG, TIFF and BMP images attached in Slack never reaching Claude; they now arrive as files in its working files, like other file types
[Claude Tag] Fixed new channel managers losing access to Claude in Slack in organizations that restrict Claude Tag by role; the manager role now also grants Claude Tag in Slack
[Claude Tag] Fixed custom connectors whose MCP servers share one host showing as a single connector in Claude Tag admin settings; each server is now its own connector
[Claude Tag] Fixed Claude in Slack sometimes answering a direct message with "DMs are temporarily unavailable" and dropping it when a single Slack lookup stalled; it now retries first
[Claude Tag] Fixed direct messages with Claude on a Slack Enterprise Grid ignoring Slack's workspace dropdown; they now run under the connected workspace you last opened Claude in
[Claude Tag] Fixed Claude in Slack's notice for a channel's monthly spend limit saying a channel manager can raise it; it now names an organization owner and links the usage page
[Claude Tag] Fixed links in Claude's Slack replies absorbing the closing bold or italic marks, or full-width punctuation, right after them, which broke the link and the formatting
[Claude Tag] Improved repository search in Claude Tag admin settings to cover up to 100 connected GitHub accounts and find private repositories past the first 5,000 of a GitHub App install
[Claude Tag] Improved Add place in Claude Tag admin settings to list a channel you type or paste right away, instead of only after your organization's full channel list has loaded
[Claude Tag] Improved Add > Domain on a workspace's or channel's page in Claude Tag admin settings to be available once that page loads, not only after every channel has loaded
[Claude Tag] Changed Claude Tag admin settings to organize Claude's access into four tabs: Bundles, Connectors, Skills and plugins, and Channels
[Claude Tag] Changed the Roles page in organization settings to group the roles created for Claude Tag channel managers in a collapsed section below your organization's own roles
[Code Review] Fixed Code Review setup not resuming after you leave to connect GitHub; back in admin settings, it now reopens at the repository picker

●

v2.1.301 Oct 15, 2026

v2.1.301

What's changed

Added CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS so unattended retry mode (CLAUDE_CODE_RETRY_WATCHDOG) ends a request at a usage limit that resets too far away instead of waiting
Added OpenTelemetry tracing guidance to the claude-api skill, including setting up trace destinations with the ant CLI
Added the % motion to vim mode: jump to the matching bracket, alone or with d/c/y
Added rows to a mod's Input: a text field of several lines in the terminal, where Enter submits and Shift+Enter or a backslash before Enter starts a new line
Added classifier_verdict and permission_mode to OpenTelemetry tool_decision events, so auto mode classifier decisions can be told apart from permission rules
Added classifier_category to OpenTelemetry tool_decision events, naming the built-in rule a classifier block matched, when OTEL_LOG_TOOL_DETAILS=1
Fixed quitting removing a worktree made by a WorktreeCreate hook without asking when it may hold unpushed commits
Fixed the fable (and best) model alias erroring on the Anthropic API when the newest Fable model is not available to your organization: Claude Code now retries once on the previous Fable model
Fixed a misleading "Please run /login" error when a full disk keeps the login from being refreshed; the error now names the disk and says to delete files
Fixed Grep and Glob reporting no matches when the search program failed unexpectedly before returning any results; they now return an error saying the search failed
Fixed workflow agents sometimes skipping their step, and the run still reporting success, after reading the harness note that their task text carries no user authority
Fixed artifact updates being refused where a PreToolUse hook covers Edit or Write; Claude now edits the file and then republishes instead of changing it in the publish call
Fixed skills and commands with very many or very long argument names stalling for seconds when invoked; only the first 64 names, each up to 64 characters, are now filled in
Fixed skills, commands and hooks using very large amounts of memory when their arguments fill many placeholders
Fixed stray characters such as >0q covering the folder trust prompt, and >4m before the shell prompt at exit, in terminals built on VTE older than 0.53 such as MATE Terminal on RHEL 8
Fixed stray GOK text appearing in the prompt at startup in some versions of iTerm2
Fixed switching to a model whose name contains application-inference-profile running your awsAuthRefresh command and delaying model-switch hooks when the provider is not Bedrock
Fixed sign-in refresh timeouts and unexpected sign-outs after a short command such as claude auth status or claude plugin list exited in the middle of a token refresh
Fixed a tool call cut off by a message sent mid-turn during its permission check being reported to the model as rejected by the user
Fixed a case where switching to a model with a smaller context window could spend usage credits on a summary by the previous model without asking first
Fixed conversations being compacted over and over, on a model you didn't pick, behind an LLM gateway whose responses name a different model than the one requested
Fixed vim mode sometimes staying in INSERT after Escape on a slow or busy machine
Fixed Esc discarding a typed AskUserQuestion answer in vim mode: the free-text field now supports vim NORMAL mode, and Esc cancels only from NORMAL
Fixed the Read tool reading binary files such as .xlsm, .parquet, .epub and .heic as text
Fixed a Markdown table with only a header row drawing nothing when too wide for the terminal, including in plans on the plan approval card
Fixed the /claude-api skill saying CMEK external-key endpoints aren't available on Claude Platform on AWS
Fixed skills no longer being listed to the model after using /rewind
Fixed the compaction row in a resumed session offering ctrl+o for history that is not loaded; it now says where the earlier messages are saved, and also shows in fullscreen
Fixed the "new task? /clear to save tokens" hint coming back right after you interrupt a response
Fixed the permission prompt for a plugin or skill hook's ask decision not showing which plugin or skill the hook comes from
Fixed /diff not noticing a conflicted cherry-pick or revert in reftable repositories when one of its git checks timed out or failed
Fixed workflow scripts asking for permission or being refused when read, edited or re-run after a Bash cd in the same session
Fixed dim text on the dark ANSI theme and 16-color terminals: faint inside filled boxes, not faint under selection and search highlights, and list descriptions dimmed like other secondary text
Fixed a mod's $.model.fork returning nothing-to-fork when called before the first response of a new Claude Code process had finished, as in claude -p runs and cloud sessions
Fullscreen mode: Fixed /compact and auto-compact briefly freezing the UI while the visible transcript is rebuilt
Self-hosted runner: Fixed sessions started from Slack being unable to find or attach a repository when managed settings restrict MCP servers; use deniedMcpServers to keep those tools off
Self-hosted runner: Fixed sessions being reported as having a deleted source branch, and not retried, when an unrelated setup or session failure quoted git's missing-ref wording
Self-hosted runner: Fixed the log promising a retry of a failed or declined session release for a session that is ending; repeated failures now show a count
Windows: Fixed stopped background PowerShell commands missing the closing [killed] line in their output file
Improved switching to a model with a smaller context window: a conversation too long for the new model is now summarized by the previous model first
Improved rendering performance while a long-running subagent works: its progress trail now updates incrementally instead of being reprocessed in full on every render
Improved artifacts: pages Claude writes now paint the band above a sticky header, so scrolled text no longer shows there in the mobile apps
Improved mods: in VS Code and the desktop and mobile apps, a tree drawn above the question dialog can now hold Markdown and up to 48 rows; the terminal keeps 12 plain rows
Changed a mod hook's .catch handler to run only when the hook throws or times out; events raised beneath the hook's own calls now skip that hook without asking its .catch
Changed a mod's $.env.set to resolve with {} once the variable is set or unset, or with { deny } saying why when the write is not made
[VSCode] Added LaTeX math rendering in Claude's responses, including $$ and multi-line \[ … \] blocks and inline $…$ and $…$ math
[VSCode] Added a "Get more usage" link to the usage-limit banner for Pro and Max plans in the VS Code and JetBrains panels
[VSCode] Fixed a conversation that crashes or freezes the panel being reopened on every reload
[VSCode] Fixed the chat panel slowing down during long thinking: it no longer re-parses the whole thinking text on every update
[VSCode] Fixed diagnostics showing "[object Object]" instead of the rule code (e.g. MD013) for some language servers
[VSCode] Fixed the native dictation audio module being loaded, to check microphone permission, where dictation is not offered (non-claude.ai sign-ins, remote windows)

●

v2.1.300 Oct 14, 2026

v2.1.300

What's changed

Added virtualText to a mod's prompt decorations: text drawn in the prompt box that never enters the draft or the submitted prompt
Added cache_creation_5m_tokens and cache_creation_1h_tokens to the OpenTelemetry api_request event, splitting cache writes by lifetime
Added $.ui.view({ agentId }) for mods: shows an agent's transcript in the main view when you ask, and $.ui.view({}) goes back
Added a dir prop on a mod's Text for right-to-left text: on Windows and in VS Code's terminal its rows read in that direction and sit flush right
Added /advisor on Claude Platform on AWS; no advisor runs until you pick one with /advisor, advisorModel or --advisor, and CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 turns it off
Added OpenTelemetry GenAI semantic-convention attributes to trace spans, such as gen_ai.provider.name, gen_ai.conversation.id, gen_ai.tool.name and error.type
Added support for rewriting a workflow agent's prompt and model in the agent.spawn mod hook, which could only refuse workflow agents before
Added the prompt.change mod hook, raised when the prompt box's text changes without a typed edit: a recalled history entry, a clear, an undo, or a plugin's fill
Fixed cloud sessions telling Claude that an organization policy blocked a host when the session's own network settings did
Fixed /autocompact warning about high token usage when you choose a smaller auto-compact window
Fixed SessionEnd hooks sometimes not running when you exit while a background command is still running
Fixed claude --help naming a removed tool in its description of --restricted
Fixed claude agents not refreshing any pull request's status when the data for one of them came back incomplete
Fixed Claude being told a background agent was lost, not resumable, after a cloud session's container was replaced, when the agent had already been resumed once
Fixed subagents you had typed messages to disappearing from /tasks shortly after finishing, leaving no way back to the conversation
Fixed a completed parent agent dropping off the breadcrumb (its child shown re-rooted at top level) while you were viewing the child
Fixed the agents view taking a typed word such as "up", "down" or "escape" for that key when input arrived in a burst, which could move the peek mid-reply or clear a draft
Fixed automatic tool search (ENABLE_TOOL_SEARCH=auto) turning off part-way through a conversation, for example while MCP servers reconnect after a resume
Fixed a login refused by forceLoginOrgUUID leaving the refused organization's token stored, or live after /login
Fixed the diff view in Claude Desktop and Remote Control sessions not noticing a conflicted cherry-pick or revert in reftable repositories
Fixed the Artifact tool's verbose and ctrl+o line reading Artifact("(unprintable path)") while a call's input arrives; its row now shows "Waiting…" and "Running…" as Bash's does
Fixed the first transcript entry written after resuming a session being lost when a crash had cut the transcript's last line short
Fixed /branch dropping messages, and claude purge skipping subfolder projects, when they contain a Unicode line or paragraph separator (U+2028, U+2029)
Fixed plugin WorktreeCreate and WorktreeRemove hooks not running when Claude Code starts with --worktree (not yet with --tmux)
Fixed OpenTelemetry tool_result events missing git_commit_id after git commit -q in repositories using reftable ref storage
Fixed a prompt that a mod's prompt.submit hook rewrote or dropped still being recorded as typed in the OpenTelemetry user_prompt event and interaction span, and in session title requests
Fixed a note meant for Claude about mod hot-reloading appearing in the transcript as if you had typed it
Fixed agent hooks ignoring their model: aliases like haiku now resolve, a subagent's model no longer overrides it, and an unavailable model falls back to the caller's instead of allowing the action
Fixed --worktree sessions sometimes starting from the wrong commit when a tag or branch was named like a commit ID, and their starting git status naming a branch other than the new worktree's
Fixed the branch showing as ".invalid" and --worktree failing to reopen a worktree in repositories using git's reftable ref storage
Fixed Claude naming files in the session scratchpad by a bare filename or relative path instead of their full path
Fixed claude remote-control servers giving up on renewing their connection after a brief sign-in error, such as a locked keychain; they now retry, and warn when you need to run claude /login
Fixed --worktree failing in a worktree of a bare repository when origin's default branch can't be fetched; the fallback base is now the current checkout's HEAD, not the main repository's
Fixed starting Claude Code in a VS Code, Cursor or Devin Desktop integrated terminal launching the editor's command-line tool twice to check for the extension; it now launches it once
Fixed a mod's prompt.edit hook not being raised for a newline entered with the chat:newline keybinding (Ctrl+J, or a rebound Enter)
Fixed a conversation failing on every turn with a 400 error when the API rejected an MCP tool's input schema; Claude Code now sends that tool without parameters for the rest of the conversation
Fixed resuming a headless or Agent SDK session losing the recent messages a compaction had kept, when the compaction followed a reply cut at the output token limit (compactions from this version on)
Fixed Claude not being told about an MCP server's tools and instructions until its next tool call, when the server finished connecting after a compaction
Fixed Remote Control sessions being marked stopped while still running, on a computer serving several sessions at once
Fixed resuming a headless or Agent SDK session losing its compaction summary or bringing back pre-compaction history, when the compaction followed a retried or unfinished reply in the same turn
Fixed Claude polling a background command's output file or sleeping while it runs
Fixed feature flags and staged rollouts staying stale behind a TLS-inspecting proxy whose certificate is trusted only through the OS certificate store
Fixed claude daemon stop --any printing "stopped" while a stuck background service kept running: it now waits, force-kills the service, and says so with exit 1 if it is still there
Fixed claude daemon stop exiting with no output, and leaving sessions listed as running, when telemetry is turned off
Fixed Write, Edit and NotebookEdit in Cowork cloud sessions reporting success for a path on your own computer, where the file never arrived
Fixed Claude searching for deferred tools already loaded earlier in the conversation when a session resumes a history that never listed them
Fixed secondary (dim) text looking the same as normal text under the dark ANSI theme and on 16-color terminals
Fixed cloud sessions hanging 5 minutes per turn when the organization's policy can't be read; the turn now ends promptly and says why
Fixed a cloud session sometimes running an already answered message a second time after the session restarted during a long reply
Self-hosted runner: Fixed the runner and orchestrator freezing (no polls, /healthz or SIGTERM shutdown) while nobody reads their output; logs keep the latest 256 KiB and count drops (not on Windows)
Improved WebFetch in Cowork cloud sessions to tell Claude that a page failed moments ago instead of fetching it again
Improved mod sharing in the built-in plugin-authoring skill: Claude scans a mod's files for keys before opening them, and asks before scanning a folder outside the project
Improved the note Claude 3 models get about an @-mentioned PDF, so they less often answer without reading it
Improved artifact updates: Claude now applies a small change and republishes the artifact in one call, and makes larger edits and republishes within a single response
Changed CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST sessions to ignore CA-bundle, tool-proxy, git TLS and git config variables like SSL_CERT_FILE in settings; under Claude Desktop, only in project settings
Changed exit to force-kill background commands still running 1.5 seconds after being asked to stop; in fullscreen mode they could previously be left running
Changed Claude Desktop's Code tab to apply managed settings when forceLoginGatewayUrl names an Anthropic-operated gateway that serves the session's hostname; that gateway must be reachable at start
Changed claude gateway to stop at start, naming the key, on a desktop: policy key that Claude Desktop cannot use from a gateway, where it earlier started with a warning
Changed large requests to api.anthropic.com to use gzip compression even when telemetry is disabled; set CLAUDE_CODE_GZIP_REQUEST_BODIES=0 to turn it off
Changed the claude-api skill to leave Managed Agents sessions in place unless you ask to archive or delete them
Changed background sessions to resume a carried workflow through the Workflow tool's approval instead of running it from the handoff file
Changed local session transcripts to also record each API request's system prompt, tools and parameters, so a transcript you choose to share can reproduce a request exactly
Changed the /sandbox mode options to read "Sandbox commands" instead of "Sandbox BashTool"
Changed PermissionRequest hooks in Cowork cloud sessions: a setMode update in a hook's allow is now ignored; the rest of the approval still applies
Changed hooks: updatedInput from PreToolUse and PermissionRequest hooks is now validated like Claude's own input: unknown keys are dropped, and input the tool rejects denies the call
Removed the --sandbox and --no-sandbox flags from claude remote-control, which had no effect; passing either now exits with an error. Set sandbox.enabled in settings to sandbox sessions
[VSCode] Added the claudeCode.attachSelection setting to stop text selected in the editor from being added to your messages
[VSCode] Fixed fast mode staying on after usage credits ran out, which made each request be refused and re-sent; it now turns off until you turn it back on, with an error notice
[VSCode] Fixed the Thinking toggle switching to Off on models that always think; the toggle is no longer shown for those models
[VSCode] Fixed "Edit prompt" on a flagged message opening the file or command menu over the restored prompt; Enter now sends it as written
[VSCode] Fixed Shift+dragging a file onto the prompt on Windows inserting an unreadable /c:/… path instead of a mention relative to the working directory
[VSCode] Fixed changes to VS Code's chat font size settings needing a window reload or being undone by a theme change; diffs and the plan preview now follow them too
[VSCode] Fixed "Resume session" and tabs restored after a reload opening an empty new conversation instead of one that had moved into a git worktree
[VSCode] Fixed ↑ then Enter on a recalled slash command running it without its arguments; the command and file menus no longer open over a recalled prompt until you edit it
[VSCode] Fixed Shift+dragging a file from the Explorer or an editor tab onto the prompt inserting nothing in WSL, SSH and Dev Container windows
[VSCode] Fixed Ctrl+Alt+F toggling Focus view instead of opening Find in the Explorer, other tree views, or the Debug Console on Windows and Linux
[VSCode] Fixed the check for sessions open in other windows or terminals creating extra processes on macOS: it now starts /bin/ps directly instead of searching PATH for ps on every check
[VSCode] Windows: Fixed a conversation showing "still open somewhere else" after a crash or power loss, when Windows had since restarted and given the old process ID to another program
[Cloud sessions] Fixed "Allow for this task" missing from Cowork's approval prompts for connector tools where an organization turns off "Always allow" (regression in 2.1.292)
[Cloud sessions] Fixed most commands in the / menu losing their descriptions in cloud sessions once you sent a second message
[Remote Control] Fixed the diff view in Remote Control sessions on claude.ai and the desktop app showing deleted and renamed files as modified; requires Claude Code v2.1.296 or later on your machine
[Claude Tag] Added support for Slack Connect channels: an Owner or Claude Tag admin can let Claude in Slack answer in channels shared with another organization; it's off by default
[Claude Tag] Added a private Allow once / Deny card in Slack threads for connector actions that need your approval, so Claude asks instead of refusing; others only see that it's waiting on you
[Claude Tag] Added support for Slack voice clips in Claude in Slack: Claude reads Slack's transcript of a clip when Slack has one
[Claude Tag] Fixed Claude in Slack not answering another app that tags it in a thread under a message Claude itself posted to the channel
[Claude Tag] Changed access bundles an admin attached to a Slack channel to keep applying once the channel becomes a Slack Connect channel, with no need to remove and re-attach them
[Code Review] Fixed Code Review ignoring @claude review comments from people with write access whose GitHub organization membership is private; their comments now start a review
[Code Review] Fixed Code Review's "paused for this repository" comment sending admins to Code Review settings; it now says who can fix it and links the Git providers page

●

v2.1.299 Oct 14, 2026

v2.1.299

What's changed

Added CLAUDE_CODE_DISABLE_FILE_MENTIONS environment variable: Claude gets the paths of @ file mentions to read with its file tools, not the files' contents
Added idle compaction in the terminal: a 200K+ token conversation left idle for about 54 minutes is compacted before its one-hour prompt cache expires, so your next message doesn't reprocess it all
Added CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS to change idle compaction's 200K-token minimum; "idleCompaction": false in settings.json turns it off. Both need v2.1.290 or later
Added $.prompt.media so a prompt.submit hook of a mod installed by managed settings can read the bytes of an image or document attached to the prompt
Added $.session.identity() for mods installed by managed settings: how the session is signed in, and its organization and email when managed forceLoginOrgUUID lists that organization
Added size, weight, mono and tabular to a mod's Text and named spacing steps (xs to xl) to its Box; bold is deprecated in favor of weight
Added --shutdown-drain-sec to claude self-hosted-runner orchestrator: on SIGTERM it stops polling and gives the poll in flight and running spawn hooks up to that many seconds to finish
Added the skill's frontmatter, source, plugin name and file path to what a mod's skill.prompt hook receives
Added /effort and /fast in agent view to set what new sessions start with; a bare /model, /effort or /fast there now opens a picker
Added a "safe mode" line to the agents view peek panel for background sessions started with --safe-mode
Added a one-time note when plan mode won't ask before most edits or commands because bypass permissions is available
Added --disallow-tools and a disallowed_tools case field to claude plugin eval to keep specific built-in tools, such as Agent, out of eval runs
Added support for turning off the attribution block in Claude Desktop's Code tab: set CLAUDE_CODE_ATTRIBUTION_HEADER=0 in the env of a Claude apps gateway's code policy
Added a field to the attribution block in Claude Code sessions behind a Claude apps gateway; remove the block with CLAUDE_CODE_ATTRIBUTION_HEADER=0
Added a queue door to the session.append mod hook, so a mod can make the transcript's queue records differ from the prompt as sent
Added a note in /plugin and claude plugin validate naming a mod's hooks that are skipped where an organization manages Claude Code
Added /usage warnings for max effort, workflows, always-on context and large tool results
Fixed the error for a denied cloud session, which could point to the wrong organization when a key from apiKeyHelper was in use
Fixed sessions on a gateway-specific model name behind a custom ANTHROPIC_BASE_URL ending with "Prompt is too long · automatic compaction failed" near 200K tokens instead of sending the request
Fixed a mod that submits a prompt at the end of every turn keeping a headless run going past --max-turns, --max-budget-usd, an interrupt, or the end of the host's conversation
Fixed cloud sessions sometimes showing the model's follow-up text after a tool group's one-line label
Fixed the Write and Edit tools creating a mod in a session's mods folder without asking in accept-edits mode when the config directory's path has no .claude in it
Fixed installed mods that kept running in an open session after being turned off remotely; they now unload between turns
Fixed Edit and Retry in Cowork and claude.ai cloud sessions failing on a message stopped while its UserPromptSubmit or mod prompt.submit hooks were still running (regression in 2.1.296)
Fixed an agent teammate started without a description keeping part of a credential from its prompt in the task description shown for it
Fixed the claude.ai view of a Remote Control or cloud session freezing when a large batch of events could not finish uploading over a slow connection
Fixed a sandboxed shell command being able to write into a --plugin-dir folder, whose code Claude Code reloads and runs outside the sandbox
Fixed memory growth under heavy debug logging (--debug, --debug-file), and a hang on exit when the debug log is on a disk or network mount that stops accepting writes
Fixed memory growing without bound when debug output goes to stderr and the parent process stops reading it
Fixed rm prompts on shell -c scripts that don't run rm. An rm built at run time in a script Claude Code can't read no longer prompts unless CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1
Fixed double-clicking a word in an expanded transcript row in fullscreen mode collapsing the row instead of selecting the word
Fixed claude mcp list, claude doctor and /status reporting an empty .mcp.json as invalid
Fixed /btw jumping the transcript to the bottom when asked while scrolled up in fullscreen
Fixed sandboxed commands failing on WSL2 with bwrap: Can't mkdir /mnt/c/Program Files/ClaudeCode when the sandbox can write to the Windows drive
Fixed scheduled wakeups (ScheduleWakeup) not firing while a background task was running in Agent SDK, IDE and claude remote-control sessions
Fixed a mod's prompt.submit rewrite being silently dropped, sending the prompt as typed, for some prompts with a pasted image or an image that can't be read
Fixed a Remote Control prompt being lost when another queued prompt in the same batch failed to deliver
Fixed a Remote Control prompt that had passed its hooks being dropped from prompt history when Stop interrupted the next queued prompt's hook
Fixed sign-in, MCP servers and project trust appearing lost on Linux after a sandboxed command left an empty .config.json in the config directory
Fixed /sandbox reporting success when its setting could not be saved because the project folder is not writable; it now says nothing changed and why
Fixed SDK and headless sessions staying in auto mode after the host switched to a model that doesn't support auto mode
Fixed MCP servers named constructor or prototype in an MCP config never being connected
Fixed tools of an MCP server named constructor or toString asking for permission in auto mode and bypass permissions mode
Fixed a spurious "synced[0] commands path not found" plugin error at startup when another Claude Code process had just updated a claude.ai-synced plugin
Fixed the Artifact tool advising a retry when a publish that requests connectors or other access was refused by the server or a proxy (HTTP 403); it now says so and what to tell the user
Fixed Cowork cloud sessions staying on an old account plugin after a plugin reload that timed out or a restart that reused a recent sync
Fixed document blocks being dropped from your own message sent while Claude is working
Fixed Claude in Chrome asking for permission while no browser is connected; it now says the extension is not connected
Fixed the fullscreen "Update installed" notice being hidden behind the idle "/clear to save tokens" hint; it now shows beside the hint
Fixed a mod hook, with or without a .catch, being run again without end when it waits on another mod's noun that does its work outside the call
Fixed the Claude apps gateway serving models that a policy's availableModelsMatch: exact or deniedModels blocks; it now answers 400 and leaves them out of its model lists
Fixed the server-managed settings request to Anthropic carrying a third-party gateway's API key when a managed settings file sets ANTHROPIC_BASE_URL
Fixed streams through a custom ANTHROPIC_BASE_URL being aborted after 180 seconds with no data arriving; they now wait 300 seconds, whether or not feature flags are loaded
Fixed a mod's tool.describe or prompt.section answer that changed after $.ui.invalidate never reaching Claude; the new answer is now sent on the next turn
Fixed a settings file being ignored when enabledMcpjsonServers or disabledMcpjsonServers held a single server name (letters, digits, - or _) as a plain string
Fixed claude plugin test pausing a hook's time budget while a served $ method it had called kept making $ calls after answering
Fixed high memory use after resuming a cloud or Remote Control session that had run many subagents
Fixed plugin hooks being skipped when they pass a very deeply nested tool input or message on with next()
Fixed a value a mod's hook passes to next(), returns, or sends to a $ method being refused whole when one of its getters throws a RangeError; now only that key is refused
Fixed /usage, the approaching-limit warning (terminal and VS Code) and the status line sometimes showing more than 100% used (anthropics/claude-code#92238)
Fixed wrapped text mixing CJK or emoji with Latin words losing its last line or leaving a blank row at some terminal widths
Fixed a cloud session sometimes ignoring the answer to a permission prompt or a question when the answer was given while the session's worker was being replaced
Fixed bold, italic and other nested text styles running over table borders or being lost on wrapped rows
Fixed Cowork cloud sessions running the old version of an account plugin changed, removed or disabled from another device until the session restarted
Fixed deny and ask rules for an MCP server (mcp__<server>) not applying when the server's normalized name contains a double underscore
Fixed long conversations losing newly attached images on every turn after one oversized image was refused by the API
Fixed the plugin_loaded telemetry event reporting has_hooks as false for plugins whose hooks are a hooks module, built-in plugins included
Fixed images attached while Claude is working (VS Code, desktop app, SDK) being sent at full size, which led to repeated image errors in long conversations
Fixed the image coordinate hint being missing or slightly off for large near-square images on newer models
Fixed feature flag, startup, fast mode, profile and feedback requests to Anthropic carrying the API key configured for a third-party gateway (ANTHROPIC_BASE_URL); Anthropic API keys are still sent
Fixed a mod's hot reload ignoring a fix saved right after a failed reload; saving a mod file without changing it no longer reloads the mod
Fixed mods loaded from source files being refused when a hook hands $ to a function declaration imported from another file of the mod
Fixed a regression in 2.1.296 where cloud and headless sessions could run an approved tool call twice if a new message arrived as the session resumed after a restart
Fixed scheduled tasks being announced for the wrong minute: the scheduling tools now report each job's actual next run time
Fixed mods' hooks being handed values with __proto__ keys silently removed, which could skip a tool.check guard on a tool call another mod made
Fixed claude -p saying nothing when a settings file fails validation: text-output runs now list the file and the invalid entry on stderr
Fixed long pastes in terminals without bracketed paste losing all text after an invisible control character, such as a mis-decoded curly quote
Fixed managed settings and organization policy not being fetched when the stored login's plan was changed locally on machines whose MDM or managed-settings file sets forceLoginOrgUUID
Fixed MCP connections over HTTP hanging for 30 seconds and failing when a server never ends the body of its reply to a notification (anthropics/claude-code#99014)
Fixed MCP servers added to a running headless or SDK session being connected before some policy checks ran; a blocked server is now reported as failed without being contacted
Fixed claude mcp list, claude mcp get and subagent MCP servers starting a server that a policy check blocks; it is now reported as blocked without being started
Fixed /reload-plugins not loading a plugin installed from another terminal a moment earlier
Fixed blank rows appearing under CJK and emoji text squeezed into a one-cell column, as in a very narrow terminal
Fixed text cut in the middle beside wide characters leaving a cell unused or being cut twice, and an emoji vanishing where a color changed inside it
Fixed bare mode notices in background sessions telling you to restart without --bare, which keeps the mode; they now name /stop and claude --resume, as safe mode ones do
Fixed ← not saying why it stayed put over a queued message while Remote Control is on
Fixed $.http.fetch in mods refusing a 304, 204 or 205 response that declares a Content-Length over the 4 MiB body limit
Fixed /config push notification toggles sending your account the previous setting instead of the one you just chose
Fixed a cloud session leaving a reply unfinished when its worker was replaced just after the reply hit the output token limit
Fixed Read failing on PDF page ranges in remote sessions on Linux that run without elevated privileges
Fixed Enter answering a question or permission prompt that had been held back while you typed an unsent message
Fixed a file attached to a message in a remote session being left out when its download stalled part way; the download is now tried again
Fixed queued prompts sent as content blocks over --input-format stream-json running together without a line break when merged into one turn
Fixed self-hosted runner sessions shutting down MCP servers added through an --exec-path wrapper's own --mcp-config when connectors change mid-session
Fixed claude plugin eval passing runs that the API refused: a run that ends on an API error now scores 0 without grading and makes the suite exit 1
Fixed permission prompts cutting off or wrapping too early when the reason text contains keycap or joined emoji
Fixed forceLoginOrgUUID and forceLoginMethod from MDM or the managed-settings file being hidden or replaced by server-managed settings
Fixed --bare sessions leaving out an MCP server named constructor or prototype that --channels asked for
Fixed resuming a conversation from before /clear reattaching to the Remote Control session of the conversation after it
Fixed a prompt starting with /, sent with the Agent SDK's verbatimPrompts option, running as a slash command when CLAUDE_CODE_RESUME_INTERRUPTED_TURN re-ran it after a restart
Fixed background sessions started with --safe-mode silently leaving safe mode when the session was woken or restarted
Fixed scheduled tasks and loops firing again after every turn, or firing early, during the repeated hour when daylight saving time ends
Fixed the diff view listing a new file whose name begins or ends with a space under the wrong name
Fixed MCP tool calls in headless and SDK sessions sometimes failing or running twice when a background reconnect closed the connection they were running on
Fixed /btw side questions in non-interactive sessions not being cancelled when the session ends, and running a second time when the same request arrived again mid-run
Fixed sandboxed commands on macOS being able to read or write a denied path by its real location when the denied path passes through a symlink
Fixed sandbox denyRead and allowRead globs with braces, parentheses or backslashes in a folder's name being read differently by Claude Code's settings checks than by the sandbox
Fixed sandbox glob allowRead and allowWrite entries not being re-checked when the directory they start from is replaced by a symlink
Fixed worktree-isolated sessions accepting some awk programs the isolation guard should refuse
Fixed claude mcp add <name> -- <command> --background being started as a background session
Fixed a prompt or reply of --bg or --background to a background session being taken for the flag, which could start new sessions over and over instead of delivering it
Fixed a custom slash command's embedded shell line running twice when a newer message interrupted the command while its prompt was being checked
Fixed --worktree sessions leaving a folder behind in .git/worktrees in repositories using git's reftable ref storage
Fixed claude self-hosted-runner sessions using Anthropic-managed git showing tracked files as staged deletions when starting in a reused clone whose remote is still empty
Fixed Ultracode not being announced to scheduled tasks and other delivered headless turns when ultracode is on in settings
Fixed MCP OAuth sign-in, token refresh and sign-out not sending configured headers/headersHelper values, which broke servers behind an authenticating proxy
Fixed the Artifact tool reporting a spurious one-line difference against the live page, and refusing the publish, when a large page with a line break after <head> is published again unchanged
Fixed $.ui.open reporting a mod's pane as placed in sessions where no surface draws it, such as Claude Code for VS Code and claude -p
Fixed the agent.spawn mod hook not running when a finished subagent or a killed teammate is resumed: the hook's event now carries resume, and a mod can refuse it
Fixed claude plugin validate rejecting a mod's $.state references when plugin.json has no types key and the contract is at ./types/index.d.ts
Fixed a mod's dimColor text looking the same as plain text under the dark ANSI theme and on 16-color terminals
Fixed plan mode running a write (an MCP tool's, a file's, a shell command's) that a PreToolUse hook or a mod's tool.check hook allowed
Fixed background subagents in auto mode sometimes sending their final report twice, once as the result and once as a message
Fixed SendMessage not finding a subagent by name after the CLI restarted and resumed the session (names given before the last compaction still need the agent ID)
Fixed replies cut off at the output token limit ending the turn silently, with no retry or error, after a request fell back to non-streaming mode
Fixed Read garbling UTF-16LE files with a byte-order mark, and Write dropping byte-order marks or silently converting Windows-1252, Shift-JIS, GBK or UTF-16BE files to UTF-8 (now refused)
Fixed cloud sessions sometimes leaving a message unanswered when the worker was replaced right after a compaction
Fixed cloud sessions and CLAUDE_CODE_RESUME_INTERRUPTED_TURN sometimes answering a finished turn again after a restart, when a tool ended the turn and a skill loaded in the same step
Fixed photos sent over Remote Control being dropped when their copy could not be saved on your computer; Claude now still sees the photo
Fixed files sent over Remote Control sometimes not arriving in long-running sessions
Fixed files of 30 to 35 MiB sent over Remote Control or to a cloud session not arriving
Fixed a user-installed mod's $.env.set changing the environment or shell prefix that command hooks from managed settings start with
Windows: Fixed the process-liveness check leaving orphaned PowerShell processes behind on busy machines until memory ran out
Windows: Fixed PreToolUse and PermissionRequest hooks that set no shell failing open when Git for Windows isn't installed; a guard that fails now blocks the call
Windows: Fixed Bash commands failing with "command not found" for a whole session when Git Bash did not report its PATH at startup
Self-hosted runner: Improved what setup and doctor say when the runner's machine has no git credentials
Self-hosted runner: Fixed sessions that wrote output before their first turn being left with no release timer, ignoring --retire-at and delaying shutdown
Improved the error shown when a cloud session is refused because your claude.ai login was rejected or has expired: it now tells you to sign in again with claude auth login
Improved enforcement of managed permission rules, managed hooks and organization MCP tool names against user-installed mods
Improved memory and disk use when PDFs are @-mentioned: their bytes are no longer kept in the session transcript
Improved sandboxed Bash on Linux: Esc and Ctrl-C now work while wildcard read rules are being expanded for a command
Improved the startup warning for an unrecognized model ID: it is now one short line under the welcome banner with a docs link, instead of a long raw message
Improved the plugin-authoring skill's steps for sharing a mod: Claude asks public or private and checks the files before creating a GitHub repository
Improved the Skill tool's "Unknown skill" error to suggest a skill's listed name when Claude wrongly adds the anthropic-skills: prefix to it
Improved /reload-skills to say it re-sends the full skill list to Claude, which is how to get skills back after compaction
Improved the error shown when a worktree cannot be created because its base commit does not resolve: it now says how the lookup ended and the likely reasons, such as a repository without a commit
Improved the error for creating a worktree at a bare-repository layout's root: it now explains the layout instead of an unrelated git error
Improved artifact watching: a local session can now watch up to 25 published artifacts at once, up from 10
Improved background agent notifications: they now say when an agent is only waiting on its own background work, got a message too late for its result, or was stopped by a usage limit
Changed plugin hooks and workflow scripts to refuse values they hand back that nest deeper than 28,000 levels, with an error naming the limit (workflow scripts allowed 100,000)
Changed actions a plugin hook can block to be refused, not let through, when the hook cannot be handed them or cannot hand back its answer; a tool that already ran has its result withheld
Changed requests to claude.ai's connector proxy and to Anthropic-hosted MCP servers to no longer follow HTTP redirects; redirects by a connector's own server are unaffected
Changed MCP requests in cloud and self-hosted runner sessions to no longer follow HTTP redirects from the session's MCP proxy
Changed skill and command loading: one whose file or folder name has hidden, direction-changing or blank-like characters, < or > is no longer offered until renamed; such a name: is ignored
Changed ui.render trees in claude plugin test: each mod's Box or Text root now carries part: { plugin } naming the mod, so exact-tree assertions must include it
Changed WebFetch page reads to pick their effort as web searches do: the caller's level on the caller's own model, otherwise the level settings give the small model
Changed claude plugin test to fail a call to a mod's served $ method that has not answered within ten seconds, as a session does
Changed MCP allow rules to reach only the server they name: mcp__a no longer allows a server named a__b or a_; write mcp__<server>__* with the server's whole normalized name
Changed agent tools: lists to take only the named MCP server's tools; list a server whose name contains __ as mcp__<whole name>__*
Changed Claude in Chrome in Cowork cloud sessions outside auto mode: an approved-site action the safety classifier flags now asks you instead of being refused, unless managed settings apply
Changed cloud session and Remote Control MCP connectors to negotiate MCP protocol version 2026-07-28 by default on installs that fetch no flags; MCP_PROTOCOL_NEGOTIATION=legacy opts out
Changed MCP tool descriptions and server instructions from Anthropic's first-party MCP servers at api.anthropic.com to reach Claude in full instead of being cut at 4,096 characters
Changed auto mode in Cowork cloud sessions: a PermissionRequest hook can no longer approve shell commands or subagents; those prompts wait or are denied
Changed the resume command printed at exit: it names the session by its ID and no longer by its name, so that nothing in a session name can run when the line is pasted
Changed the resume command printed at exit of a worktree session: it uses -w and -r if the long flags do not fit the terminal. If neither fits a kept worktree, rows above it say where to run it
Changed /btw side questions in non-interactive sessions to return a timeout error when still unanswered after 11 minutes
Changed UserPromptSubmit hooks to run before a skill or custom slash command expands, so a hook that blocks the prompt now also stops its embedded shell commands
Changed a skill's own front-matter UserPromptSubmit hook to first run on the prompt after the one that invokes the skill
Changed the turn.start mod hook to also hear subagents' and teammates' turns, not only the main loop's; tell them apart by e.agentId (absent on the main loop)
Changed the errors shown when /ultrareview can't upload a repository to stop suggesting git add ., which could stage or commit untracked files such as .env
Changed the cyber safeguard notice to no longer ask people to apply to the Cyber Verification Program
[VSCode] Fixed an unsent prompt and its attachments being lost when switching to another session and back
[VSCode] Fixed unused blank chats keeping a background Claude process running after starting a new conversation
[VSCode] Fixed the mic button showing an internal error message when you are signed out of claude.ai; it now offers to sign you in
[VSCode] Improved startup time in workspaces without a Python environment by starting Claude while the Python extension loads
[VSCode] Improved startup: the model picker and slash command menu now fill in right away in a new window on a folder you've opened before
[Cloud sessions] Fixed a memory spike that could crash a session when many of its existing output files were re-sent to it at once
[Cloud sessions] Fixed saving an edited routine silently moving it to a different environment when its own had been deleted or wasn't in the list; the routine now keeps its environment
[Cloud sessions] Fixed Sessions search in a self-hosted environment's admin details finding nothing when you paste the session ID from a session's link
[Cloud sessions] Fixed the Sessions and Runners lists in a self-hosted environment's admin details saying the list is empty when a search just has no matches
[Cloud sessions] Improved the deploy command shown when you create a self-hosted environment or environment key: it shows in full, wraps between arguments, and has a visible copy button
[Cloud sessions] Changed deleting a self-hosted environment to turn off its routines right away, with the reason shown on each routine, instead of leaving their runs to fail
[Remote Control] Fixed Remote Control sessions whose computer can't be reached still appearing to send your messages; your text now stays in the box and Send is off until it reconnects
[Claude Tag] Added the ability for Claude in Slack to delete a canvas it created in a channel when someone asks it to
[Claude Tag] Fixed Claude in Slack staying silent on untagged posts that a channel's own instructions tell it to answer, such as posts that tag someone else, in channels with guests
[Claude Tag] Fixed Claude in Slack reporting a reply to another channel's thread as posted when it isn't a member there; it now says the reply wasn't delivered and how to fix that
[Claude Tag] Fixed Claude in Slack sometimes ending a turn without posting its answer when a self-hosted runner's image has no python3
[Claude Tag] Changed how Claude in Slack corrects a message it got wrong: it edits the message in place and adds a short "Edited" note instead of striking through the old text
[Claude Tag] Changed Claude in Slack to join channels with more than 100 members quietly, with no intro message
[Code Review] Fixed Code Review's monthly spend-limit comment and check-run card sending admins to Claude Code settings; they now link the Usage page, where that limit is set

⚡

v2.1.296 Oct 9, 2026 Breaking

v2.1.296

What's changed

Added a code key to the Claude apps gateway's managed.policies[]: the same settings as cli, also applied in Claude Desktop's Code tab; beside desktop, it turns on Claude Desktop's gateway mode
Added autoCompactWindow to subagent frontmatter and --agents definitions, so a subagent can auto-compact earlier than the main conversation's window
Added CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL to run every workflow agent on one model while other subagents keep theirs
Added CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS environment variable to set a longer maximum delay for the backoff when retrying an overloaded (529) request
Added a note in /plugin on a plugin whose hooks are left out because another enabled plugin has the same name
Added an allow_large option to the Read tool so Claude can read a text file past the usual size limits in one call when it needs the whole file and the context has room
Fixed managed-settings PreToolUse hooks that deny a tool call with "continue": false, and managed prompt hooks that block one, refusing the call but not ending the turn
Fixed PostToolUse hooks in managed settings not applying updatedMCPToolOutput in some sessions
Fixed headless sessions starting a folder's .mcp.json or plugin MCP server that was switched off for that folder, after changing directory or reloading plugins
Fixed a Claude apps gateway that serves allowedProviders with "gateway" locking out laptops that name that gateway in user settings
Fixed a saved Claude apps gateway sign-in being ignored on machines whose managed settings set forceLoginMethod to gateway with no forceLoginGatewayUrl (regression in 2.1.295)
Fixed --teleport opening an empty conversation when the session's history could not be read
Fixed token counts for Haiku 5.5 and other models that take only adaptive thinking, which failed behind some gateways and were counted with budget thinking elsewhere
Fixed resumed subagents being told that the user rejected a tool call that a session shutdown had interrupted
Fixed hook output being altered when it contained text resembling a plugin hint tag
Fixed secret redaction in shared transcripts and debug logs missing some values that follow a key with no value, including in JSON written inside a shell string
Fixed a stray 52;c;… escape sequence printed on screen after copying in older VTE-based terminals such as MATE Terminal
Fixed toasts and notifications waiting unseen for as long as the /diff panel or dialog was open
Fixed Esc or an interrupt during a UserPromptSubmit hook or a mod's prompt.submit hook ending headless sessions, clearing the typed prompt, or letting the unchecked prompt through
Fixed SessionStart hooks of a plugin loaded after a headless session starts being skipped when a different plugin with the same name, or another spelling of it, had already run
Fixed claude self-hosted-runner printing misleading errors when registration is refused: it now names the org admin setting, or says a restarted on-demand runner needs a fresh work order
Fixed a self-hosted runner session's git fetch, pull and push failing while another session of the same repository starts on a runner with --capacity above 1
Fixed workflow scripts silently truncating results, agent options and other values nested deeper than about 20,000 levels, and deeply nested results writing huge task output files
Fixed a plugin's served $ methods running in the main session's working directory instead of the calling agent's, and ignoring the turn their calling hook holds
Fixed $.agent.register succeeding from a mod's hook that was still running after the mod was reloaded or removed; the call is now refused
Fixed $.http.fetch in mods refusing a HEAD request when the response declares a Content-Length over the 4 MiB body limit
Fixed claude plugin marketplace add, marketplace update and plugin install failing with an internal error for a marketplace named like constructor; add now refuses such names clearly
Fixed a plugin secret named constructor or prototype being deleted by the next save of that plugin's options
Fixed cloud sessions skipping auto mode's checks on Claude in Chrome actions that a saved permission allows when their feature flags had not loaded
Fixed CLAUDE_CODE_RESUME_INTERRUPTED_TURN re-running a finished turn after a restart when an MCP tool result had ended that turn
Fixed Bash permission checks auto-approving some commands that assign the BASH_ARGV0 shell variable and then use it; these now prompt for approval
Fixed Edit and NotebookEdit replacing every non-ASCII character in files that are not valid UTF-8 (Windows-1252, Shift-JIS, GBK); such edits are now refused
Fixed a prompt sent just after ← being run twice, once unseen in the foreground, when the background service was slow to answer
Fixed a prompt sent while SessionStart hooks were still running vanishing when ← moved the session to the background; it is still not sent, but ↑ now brings it back
Fixed a late-loading plugin's SessionStart hook output reaching the new conversation after /clear in headless sessions
Fixed PowerShell commands not seeing variables that hooks write to CLAUDE_ENV_FILE (when the file holds only plain assignments)
Fixed Claude calling cloud sessions non-interactive and suggesting /mcp or claude mcp when an MCP server needs authentication
Fixed /code-review ending on a raw JSON array in cloud sessions, the Agent SDK and IDE integrations; the findings now print as a numbered list
Fixed auto mode occasionally refusing one update to your own artifact, saying its sharing had changed when it had not
Fixed skills synced from claude.ai never finishing their install, and being downloaded again at every sync, when several sessions share a config directory
Fixed a plugin synced from claude.ai being disabled when the marketplace dependency it declares was also synced from claude.ai
Fixed a startup hang on macOS when plugin paths copied from a Linux machine pointed under /home
Fixed the Workflow tool refusing script files with CRLF line endings, such as files checked out on Windows
Fixed OpenTelemetry tool_result events missing git_commit_id after git commit -q or git -C <dir> commit
Fixed CLAUDE_CODE_TRANSCRIPT_LOCAL_GC dropping a message from the saved transcript when its text held a Unicode line or paragraph separator (U+2028, U+2029)
Fixed claude purge leaving a prompt in the history file when its text held a Unicode line or paragraph separator (U+2028, U+2029)
Windows: Fixed PowerShell commands longer than about 1 KB always asking for permission, so allow rules and read-only detection now apply up to 32 KB
Windows: Fixed stdio MCP servers being force-killed at shutdown; stdin now closes first and the process tree is killed only if the server is still running after 300 ms
Windows: Fixed claude plugin install failing for GitHub owner/repo plugin sources on machines with no GitHub SSH key; the clone is now retried over HTTPS
Windows: Fixed rm -rf /c/Users/<name> in Git Bash not asking in bypass permissions mode
Improved fullscreen mode: the link under the mouse pointer is now underlined to show it can be opened
Improved transcript toggle (ctrl+o) responsiveness in code-heavy conversations by caching syntax-highlighted code blocks
Improved Claude Desktop's Code tab behind a Claude apps gateway: when a session can't start, including on a machine not set up for the gateway's code settings, the reason shows as a reply
Improved the errors for a refused cloud session: they now say why your organization's policy couldn't be loaded, and name an API key or auth token that overrides your claude.ai login
Improved --debug output to name unrecognized frontmatter fields in custom agent files, with a hint for likely typos
Improved auto mode: a tool call that wasn't run because auto mode's check had no usable answer now shows as a dim "Not run" row instead of a red error
Improved --debug output for hooks: command hooks on tool calls, prompts, SessionStart and Stop now log their command, plugin, outcome and duration when they finish, so a slow hook is identifiable
Improved CLAUDE_CODE_TRANSCRIPT_LOCAL_GC: a large transcript file is no longer rewritten when that would free under 10% of it
Updated /cost, the status line, --max-budget-usd and the SDK's cost figures to price Sonnet 5.5 cache reads at $0.10 per million tokens (was $0.20)
Updated the bundled dataviz skill: lighter violet for the seventh series in light mode, softer primary text in dark mode, and compact y-axis labels like 1K
Changed the default limit on MCP tool descriptions sent up front and on MCP server instructions from 2,048 to 4,096 characters
Changed ←: a turn or ! command started while the session moves to the background is now stopped instead of finishing out of sight
[VSCode] Fixed claudeCode.spinnerVerbs missing from the extension's settings, so settings.json now completes and validates it; a malformed value no longer breaks the chat panel
[VSCode] Changed Claude in Chrome to ask before browser actions in every session, including one connected with @browser, as the terminal does; allowing a site for the session stops repeat asks
[VSCode] Fixed chat links written as a full Windows path, such as C:\repo\file.ts or file:///C:/repo/file.ts, not opening the file on Windows
[VSCode] Fixed the working indicator still animating when reduced motion is turned on in your OS, in VS Code, or with the prefersReducedMotion setting
[VSCode] Fixed the prompt cache clock reading warm after the panel caught up on messages late, such as after the display was off or a remote window reconnected
[Cloud sessions] Added a status filter to the Sessions and Runners lists on a self-hosted environment's Activity tab in admin settings; you can pick several statuses at once
[Cloud sessions] Fixed every cloud session waiting for a self-hosted runner showing the same queue position; each now shows how many sessions are ahead of it
[Cloud sessions] Fixed a message you send while Claude is still replying in a cloud session jumping above that reply when it finishes; it now stays below it, including after a reload
[Claude Tag] Changed Claude in Slack to show the footer with the session link, model and cost only on its newest reply in a thread; the reply before it drops the footer
[Claude Tag] Fixed links to URLs that contain parentheses breaking in some of Claude's Slack replies and task checklists, which showed stray bracket text and opened the wrong page
[Claude Tag] Fixed Claude's Slack replies drawing color swatches beside codes that only look like hex colors, such as six-digit pull request numbers
[Claude Tag] Added creating, editing and deleting workspace and channel memory files on the Activity page's Memory tab for members with the Claude Tag Admin permission
[Claude Tag] Fixed the plugin confirmation card Claude posts in a Slack channel showing a plugin's ID instead of its name
[Claude Tag] Fixed Claude in Slack posting a card to remove a plugin the channel's own settings don't include; it now explains where the plugin comes from instead
[Claude Tag] Fixed Claude in Slack sometimes losing its reply when a session in a self-hosted environment moved to a new runner partway through a task
[Code Review] Fixed the Code Review check sometimes staying "in progress" on a pull request after the review finished; it now shows the review's result
[Code Review] Improved Code Review admin settings to say why a setting couldn't be saved, such as a policy restriction, instead of a generic failure message

●

v2.1.295 Oct 8, 2026

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

●

v2.1.294 Oct 8, 2026

v2.1.294

What's changed

Fixed prompt and agent hooks written as instructions (such as "Block commands that...") allowing what they should block
Improved how prompt hooks on Stop and SubagentStop written as instructions (such as "Carry on if the build is broken") are judged, so Claude is less likely to stop early

●

v2.1.293 Oct 7, 2026

v2.1.293

What's changed

Added Claude Haiku 5.5 (claude-haiku-5-5), now the default Haiku model on the Anthropic API — 1M context, $0.10/$0.50 per Mtok ($0.50/$2.50 for prompts over 100K)
Added agentType to the subagentStatusLine payload, so scripts can tell custom subagent types apart
Added isDeferred to $.tool.register for mods: false lists the tool's schema in the prompt from the start instead of behind tool search
Fixed Claude sometimes treating its own last actions before a context compaction as done after it, and retracting or redoing finished work
Fixed a memory leak where an HTTP MCP connection kept every request it had sent until it closed
Fixed a message sent while Claude was working being lost when ← moved the session to the background; if a queued message can't move, ← now stays put and says so
Fixed /model effort ←/→ wrapping past the highest or lowest level, which could accidentally save Low as a model's default effort
Fixed /tui disconnecting Claude in Chrome in a session started with --chrome, and ignoring --no-chrome
Fixed Claude being told to continue or message subagents with SendMessage in sessions, including resumed ones, where a host, a permission rule or a --tools list removed that tool
Fixed subagents and --agent sessions being told a built-in tool was disabled for the whole session when only their own tool list left it out
Fixed a claude.ai-synced skill's edited description sometimes not reaching the model until a new conversation or /clear
Fixed claude logs, stop, kill, rm and claude daemon status, stop, uninstall sometimes signing you out when your login had expired or was about to
Fixed the footer's agents count disappearing after a momentary failure to read the sessions folder (for example, too many open files)
Fixed a custom agent named worker being shown as "Agent" when it starts, and the agent detail dialog's title losing the agent type once the agent finishes
Fixed the Artifact tool's transcript row briefly reading Artifact("(unprintable path)") while a publish call was still streaming in
Fixed the /ultrareview upload on Linux wrongly refusing some repositories, such as one inside another checkout, over a settings file that "could not be parsed" while a sandboxed command was running
Fixed the /ultrareview upload's refusal over split-index files advising a git command that could leave git unable to read its index
Fixed replies in very long Remote Control and cloud sessions that could still appear a block at a time instead of streaming in
Fixed Remote Control uploading a session's starting history again after every credential recovery
Fixed PushNotification reporting "Remote Control inactive" in sessions started with claude remote-control
Fixed a mod's hooks on classic.* events being skipped while the plugin hooks worker restarts, which left settings hooks to answer without them
Fixed claude plugin test failing for mods that call $.session.append; tests can read the appended rows back with the new mock.session
Fixed claude plugin eval refusing every Bash-granting run on Macs with Docker Desktop (links under ~/.docker/bin); the refusal now names which part of a credential store held the link
Fixed the Claude apps gateway refusing to start when a desktop policy sets Claude Desktop's built-in browser keys, such as builtinBrowserEnabled
Fixed claude agents offering bypass permissions that background sessions then ignored when consent was saved only in .claude/settings.local.json or a --settings file; it now asks for consent first, and a session that ignores bypass shows a short notice that stays
Fixed ← backgrounding a session after 10 seconds while the prompt held unsent text (it now cancels the move) or a question was waiting for your answer
Fixed Esc, or No without feedback, on a permission prompt not stopping the turn when ← had just been pressed to move the session to the background
Fixed the agents view briefly replacing the session list with placeholder rows when the sessions folder could not be read (for example, too many open files)
Fixed path-scoped rules and nested CLAUDE.md files not loading when Claude views a file with a single-file cat, head, tail, sed -n or grep command in the Bash tool instead of the Read tool
Fixed pasted text that begins and ends with the same words sometimes being sent to Claude as if it had been typed
Fixed a skill name in pasted text being treated as typed when an accent typed or pasted right after the paste merged into its last letter
Fixed /feedback returning to the drafts list after Ctrl+O or Ctrl+Z while a report was sending, leaving the send impossible to cancel
Fixed claude purge stopping silently (exit 0, or a hang in a terminal) when a file or folder could not be deleted; it now deletes the rest, lists what it could not delete, and exits 1
Fixed keybindings.json checks: a lone " " (space key) is no longer reported as an error, and keys like "ctrl+ k" now get a warning
Fixed vim mode >> and << on a line of only spaces leaving the cursor past the end of the line, where a following x deleted nothing
Fixed vim mode: after deleting whole lines in Visual mode (V then d) the cursor lands on the first non-blank, and . after it acts on the cursor's line
Windows: Fixed stopping a status line, hook, or shell command sometimes terminating an unrelated process that had been given the same process ID
Reverted the auto mode denial message change from 2.1.281 that told Claude a denial covers the outcome, not only the exact command
Reverted the 2.1.290 fix for cloud sessions staying asleep after a container restart lost a pending /loop wakeup or scheduled task; Claude is no longer told, and the session stays asleep
Improved startup for Team and Enterprise organizations: policy and managed settings are fetched earlier, and a stalled request is retried after 3 seconds
Improved Claude in Chrome: fewer page actions are refused when the browser is slow to report its tabs
Improved the Claude in Chrome message in cloud sessions when the browser can't be reached: if you belong to more than one organization, it now says the extension must be signed in to the same one, and how to change that
Improved the Bash edit diff note to say the listed files changed while the command ran, which can include writes by other processes
Improved artifacts: Claude pins libraries to exact versions two weeks old or older
Changed claude.ai skill syncing to check for changes about every 40 minutes, instead of every 10, while no session is in use
Changed the order of agent lists and of MCP servers announced to the model: names with non-ASCII characters now sort after ASCII names
Changed OpenTelemetry claude_code.at_mention logging to emit at most 100 agent and 100 MCP-resource events each time a prompt is read
Self-hosted runner: Changed the orchestrator to sleep 4 to 6 seconds between polls instead of a constant 5, so several replicas for one environment stop polling at the same moment
[Claude Tag] Fixed Claude in Slack saying a workspace isn't set up in Enterprise Grid channels shared across workspaces when Slack labels a message with a workspace that isn't connected
[Claude Tag] Fixed Claude in Slack stopping mid-task in a channel when an admin changed the channel's connectors, plugins, skills or rules; the change now applies once Claude finishes
[Claude Tag] Fixed asking Claude in Slack to run a thread's routine now with extra notes starting a separate run that couldn't post back; the run now continues in that thread
[Claude Tag] Fixed an access bundle's Add a connector dialog in Claude Tag admin settings showing every Google connector as connected after one Google sign-in
[Claude Tag] Improved Claude Tag admin settings to list an Enterprise Grid that isn't connected yet, with a Connect button
[Claude Tag] Changed Claude in Slack to join announcement channels, where only admins can post, without posting its intro
[Claude Tag] Changed the limit on channel rules in Claude Tag admin settings from 20 to 50 for each workspace and for the organization-wide Slack page
[Code Review] Improved Code Review's Add a repository dialog to list each repository that couldn't be added and why, such as missing GitHub write access

●

v2.1.292 Oct 6, 2026

v2.1.292

What's changed

Added --marketplace <source> to claude plugin install: adds the marketplace if needed, under the same policy checks as claude plugin marketplace add, then installs the plugin from it
Added an effort parameter to the Agent tool, so Claude runs a sub-agent at the effort level you ask for
Added CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS environment variable to set a longer base delay for the backoff when retrying an overloaded (529) request
Added prompt.autocomplete, an event a mod hooks to add its own rows to the prompt box's autocomplete list
Added prompt caching to $.model.complete for mods: prompt and system take blocks of text, and cache: true on a block caches the request up to it
Added workflow agents to the agent.spawn mod hook, with their run and index, so a mod can refuse them
Fixed subagent definitions with permissionMode: auto entering auto mode when auto mode is unavailable (disabled by settings, circuit breaker, or a model that doesn't support it)
Fixed sandboxed commands being able to read the staged file copies of /ultrareview uploads under ~/.claude/seed-admin
Fixed a managed sandbox read-deny path (and user ones beside it) that appears or re-points mid-session not dropping project grants inside it or ending credential injection from files it covers
Fixed a notebook or PDF read on macOS and Windows being able to return a file outside what was approved, through a link swapped in mid-read
Fixed a tampered on-disk cache of server-managed settings being able to switch off or unseat the built-in policy plugin while the settings fetch failed
Fixed rm -rf on the 8.3 short name or another alternate Windows spelling of the home folder or a drive not being treated as removing it
Security: Fixed PreToolUse hook approvals and auto mode bypassing the permission prompt for file reads from network (UNC) paths
Fixed a skill's or slash command's allowed-tools rule coming back in a later turn when you leave auto mode or plan mode partway through that turn
Fixed NO_PROXY being ignored for Claude Code's own API requests (sign-in, policy, feedback, artifacts) when HTTPS_PROXY is set
Fixed an MCP tool with a name longer than 128 characters making every request fail; that tool is now left out and an MCP error names it
Fixed claude plugin commands such as marketplace add and install running before an organization's managed settings had loaded on a first run
Fixed one-shot claude -p and Agent SDK runs stopping a background command 5 seconds after the final result, and one-shot claude -p runs dropping a scheduled wakeup; both are now waited for
Fixed plan mode not being restored when resuming a session from the claude --resume session picker or with /resume
Fixed saved scheduled tasks created after /resume, /branch or /clear never firing, and saved tasks ignoring later creates and deletes after two writes to the tasks file milliseconds apart
Fixed a background session's /loop silently stopping when the session's process restarted (for example after a crash), because its pending wakeup was lost
Fixed Grep and Glob reporting no matches when the file or folder they were given could not be read; Claude now retries once or tells you
Fixed the Read tool returning only the first entry, with no error, when a PDF's pages was a list such as "6,9,15"; it now returns an error saying to read each page or range separately
Fixed @-mentioned text files over 256KB being left out silently: Claude is now told the file's size and to read it in portions
Fixed the usage limit alert repeating once per background agent when agents failed on a limit that had already stopped the main conversation
Fixed Remote Control viewers seeing an empty subagent pane for background subagents in sessions hosted by the desktop app or an IDE
Fixed cross-session delivery notices showing two sessions with similar names as one recipient, and the expiry notice blaming the desktop app when a terminal session let the message lapse
Fixed Send now in the desktop app ending the subagent a turn was waiting on when another message was already queued
Fixed /bug, /share and /feedback <text> starting over after Ctrl+O or Ctrl+Z while a report was being sent, and closing as cancelled after it had been sent
Fixed /remote-env replacing your saved default environment when you pressed Enter right away: the list now opens on your default, and no row has a check mark when no default is in effect
Fixed some pasted text reaching Claude as typed text when several pastes overlapped in one prompt
Fixed vim mode leaving the cursor past the end of a line, j/k losing their column on shorter lines, and f/t/F/T/;/, jumping to, or deleting up to, a match on another line of the prompt
Fixed /add-dir path box letting Shift+Enter or a paste add a line break, and treating fast-typed "tab", "up" or "down" as those keys
Fixed fast typing, input-method text and decomposed accents being dropped while a prompt footer row was selected, and ! leaving the row selected
Fixed fullscreen mode sending a full-screen clear on every window resize and Ctrl+L when iTerm2 is detected, which may be what filled iTerm2's scrollback with stale pages
Fixed a spurious "could not be examined" note for @-words that name no file when a Read deny rule is set and the working directory is under a symlink
Fixed "instruction file not loaded" lines going stale or missing after /cd or a permission change, and added a transcript line when a nested one isn't loaded
Fixed a compaction summary that repeated /name letting Claude invoke a skill that is reserved for the user
Fixed Write, Edit, NotebookEdit and LSP rows, and single Read, Grep and Glob rows, hiding why a mod denied the call: the row now shows the reason
Fixed a cloud session showing a turn that never ended when its worker was stopped just as the turn finished
Fixed cloud sessions with a large transcript sometimes asking for a permission again after it was approved
Fixed scheduled tasks and other queued notifications being lost in cloud sessions when a message was retried or edited while Claude was reading them
Fixed cloud sessions forgetting the thinking setting chosen in the client when the session's container restarted
Fixed Cowork cloud sessions saying a proxy blocked artifacts when Anthropic couldn't confirm the organization's settings
Fixed plugins whose hooks module makes many $.state calls through one const taking minutes to load or validate
Fixed claude plugin validate listing a matcher or state value for a hooks module that the engine reads from elsewhere
Fixed claude plugin validate listing a $.state value read through a top-level var that was declared again or reassigned; such a module is now refused
Fixed a plugin's served $ method restarting the hook origin, which could run a guard hook with a .catch above it again without end
Fixed plugin interface calls made while the plugin hooks worker restarts running without the hooks other plugins put on them
Fixed a mod's config.set, state.set, env.set or agent.spawn hook that denies after calling next(e) being answered as a refusal: the hook is now reported as failed, by name
Fixed /theme, the /config Theme menu and the first-run theme step saving a theme before a plugin's config.set hook was asked
Fixed a plugin's tool.check hook answering allow running a tool that requires your answer (a question, a plan approval) without showing its dialog
Fixed a mod's start-up prompt, command or subagent being queued a second time when the hooks worker was replaced
Fixed a mod's hook that called next(e) and then failed while the turn was interrupted letting the call through; the call is now rejected
Fixed a plugin's prompt drop or setting deny being ignored when its reason was longer than 4,096 characters
Fixed an organization's plugin being unloaded on its own reload, or after another plugin crashed, when it returned a $ name that a user-installed mod had added; the mod is now unloaded instead
Fixed tool calls made while the plugin hooks worker restarts being answered without the plugins' permission hooks
Fixed plugin tool.call hooks seeing some tool calls before misnamed parameters were repaired; a hook now sees the arguments the tool will run with
Fixed a mod's guard hook with a .catch being skipped silently for calls another mod's hook makes beneath the guard's own $ call; its .catch is now asked
Improved startup of claude -p and SDK sessions: the first turn no longer waits for HTTP and SSE MCP servers to answer resources/list
Improved rendering speed of long bulleted or numbered replies: they stream, resize and re-open in the transcript (ctrl+o) much faster
Improved Ctrl+C draft recovery: a cleared prompt now stays reachable with Up after a slash command or a sent message
Improved hook output handling: <system-reminder> tags written in a hook's output are escaped before they reach Claude
Improved tool input handling: Grep accepts file_path for path, and Write, WebFetch and Read ignore a few stray parameters instead of failing the call
Improved the steps shown when a marketplace declared in a settings file has a name that looks like an official Anthropic marketplace
Improved sandbox auto-allow: with strict sandbox mode set in user, managed or --settings settings, an interpreter command with an env var prefix like FOO=bar python3 app.py runs unprompted
Improved the Artifact tool's listing: Claude now sees how many published artifacts you have and can list up to 200 at once instead of 50
Improved cloud sessions after a restart: Claude is now told which stopped background agents it can resume by id
Improved the Claude in Chrome message in claude.ai cloud sessions when the browser can't be reached: Claude is now told it may continue with alternatives if the user prefers
Improved the /focus tip: it now invites you to try focus view mid-turn and shows how to switch back
Improved startup with local (stdio) MCP servers that ignore the newer protocol check: after one slow connect they are remembered for 7 days and connected the older way without the wait
Changed local (stdio) MCP server connections to negotiate protocol version 2026-07-28 by default on every install, including Bedrock, Vertex and Foundry; MCP_PROTOCOL_NEGOTIATION=legacy opts out
Changed claude plugin test: a failed expect inside a hook the test registered, or a stub answer the engine refuses, now fails the test instead of passing silently
Changed usage limit messages to write claude.ai settings links with https:// so terminals and apps can make them clickable
Changed scheduled and Run now routine runs to publish a new artifact only you can see without asking for approval; artifacts that request connectors or other access still ask
Changed agent names to allow at most 256 characters: a longer one is rejected, and a skill's or a plugin file's name longer than that is ignored
[Cloud sessions] Fixed routine runs occasionally staying listed as running for hours after they had finished
[Cloud sessions] Fixed editing or duplicating a routine turning off its push notifications when the routine had no saved notification setting
[Cloud sessions] Fixed SVG, HEIC, TIFF and other less common image files failing to attach; they now attach as regular files
[Cloud sessions] Fixed approval prompts offering "Always allow" for connector tools that an organization set to require approval; the choice had no effect
[Remote Control] Fixed the first message of a new Remote Control session started from claude.ai/code accepting only images; it now accepts PDFs and other files like later messages
[Claude Tag] Added an Edit button to the Allowed domains card on a channel's Configure page, so Enterprise admins can open the access bundle that sets the channel's domains
[Claude Tag] Fixed replies sent in a Slack thread while Claude was still on its first request there being held until that request finished, or missed when sent seconds apart
[Claude Tag] Fixed Slack threads woken only by GitHub pull request activity or a routine staying on their original model after an admin changed the channel or workspace default model
[Claude Tag] Fixed Claude sometimes posting a spend limit notice in Slack when the real cause was that your organization had run out of usage credits
[Claude Tag] Fixed a session hanging until interrupted when a permission prompt that can't be answered from Slack was denied automatically
[Claude Tag] Improved @Claude !status in a channel to say when Claude has stopped reading its untagged messages, why, and that an @-mention starts it reading again
[Claude Tag] Changed the first message of a Slack thread continued with !fork to a card showing where it came from, the request, and who asked, with a link to the original thread
[Claude Tag] Changed the organization-wide and default spend limit boxes on Claude Tag's spend limits page in admin settings to save only when you press Save or Enter, not when you click away
[Code Review] Added the period's total with its change from the previous period, and a breakdown by repository, to the PRs reviewed chart in Code Review analytics
[Code Review] Fixed a queued review failing when the pull request moved to a new base branch and the old one was deleted; the commit is now re-queued for review
[Code Review] Fixed reviews ignoring a CLAUDE.md's rules when the pull request edits that file; reviews now use its version from the base branch

●

v2.1.291 Oct 6, 2026

v2.1.291

What's changed

Fixed a regression in 2.1.290 where cloud sessions could drop answers to permission prompts
Fixed a regression in 2.1.288 where the last messages of a session could be lost when quitting

●

v2.1.290 Oct 5, 2026

v2.1.290

What's changed

Added serverToolUses to the result of a mod's turn.step hook: the tool calls the API ran itself (the advisor), each with its id, name, input, start and end
Added agentId to the tool.check event of plugin hooks, so a hook can tell a subagent's permission check from the main session's
Added ceiling to the question and verdict a mod's tool.check hook reads, naming the approval an organization requires for a tool
Added ThemeKey and Color types to the plugin hooks typings, so an editor lists the theme colors a mod's drawing can name
Added to claude plugin validate: each hook a mod registers at a gating site is listed with whether it has a .catch (gatingHooks under --json)
Added a Deny button to the Claude apps gateway's sign-in approval page: it ends the pending sign-in, so the waiting terminal stops within seconds
Added claude attach <name> and claude logs <name>: part of a session name works in place of the id
Added /claude-api managed-agents-onboard <url> to set up the Managed Agents pattern a page describes as ant apply files
Added /claude-api managed-agents-onboard <quickstart-name> to build a Console quickstart template, such as deep-researcher, with the ant CLI
Added a warning when a managed settings file is a link to a file outside the managed settings folder
Added a /status and doctor warning when managed settings ignore user-configured sandbox allowRead paths or allowed domains
Fixed requests failing behind proxies and gateways that reject one of Claude Code's beta headers with a status other than 400, or together with a second beta
Fixed long sessions with hundreds of images getting stuck on "Request rejected as unprocessable by the model" errors
Fixed a turn ending at once when the API's output content filter stopped a reply while Claude was still thinking; the request is now retried once before the error is shown
Fixed resumed subagents and teammates losing their earlier thinking and prompt cache after receiving a message mid-run
Fixed WebFetch silently dropping page text past 100,000 characters; it now says how much was unread and takes an offset to read on
Fixed a crash ("Maximum call stack size exceeded") when a response nested lists or quotes thousands of levels deep
Fixed /rewind not listing a prompt sent while Claude was still working
Fixed scheduled tasks (/loop with an interval, reminders) silently not coming back on resume once the conversation was compacted; covers compactions made from this version on
Fixed scheduled tasks set in the foreground never firing after a ← or /background hand-off, and recurring ones firing an extra run on every resume, respawn or fork
Fixed headless --json-schema runs exiting non-zero with is_error: true on a success result when the connection dropped after the structured output was already delivered
Fixed plan mode letting the auto mode classifier approve non-read-only connector tools that carry a server-pushed ask policy
Fixed a project CLAUDE.md, rule or AGENTS.md symlinked outside the working directories loading under permissions.blockReadsOutsideWorkingDirectories or a Read deny rule
Fixed URL allow and deny patterns with a wildcard inside an xn-- host label matching differently from one process to the next
Fixed an MCP server provided by your organization being relisted as your own after signing in or reconnecting, including from a late result in headless and SDK sessions
Fixed /ultrareview dropping uncommitted changes without a warning on Windows when git stash create failed, and refusing them after a git add -N file was deleted or moved
Fixed the plansDirectory setting's project-root check for paths that contain a backslash on macOS and Linux
Fixed replies in very long Remote Control and cloud sessions that could appear a block at a time instead of streaming in
Fixed the background daemon's log passing terminal control characters to the screen under claude daemon run and claude daemon logs; they now show as \uXXXX escapes
Self-hosted runner: Fixed a crafted, very long line of a session's error output freezing the runner for several seconds
Fixed a plugin hook with a .catch being unloaded, and its .catch skipped, when the hook kept the hooks worker busy on a prompt or tool call
Fixed a mod's turn.step result listing a tool call that a mid-response model fallback had discarded
Fixed a Cowork cloud session's reply sometimes never finishing when its container restarted just after Claude sent a message or a file
Fixed claude plugin validate and plugin loading refusing a hooks module that destructures an option named like one of its top-level functions
Fixed /ultrareview failing to upload uncommitted changes when core.safecrlf=true is set in git's configuration
Fixed the effort level changing when a flagged message is retried on a fallback model that has a different level saved in settings
Windows: Fixed multi-line ! shell blocks in skills and commands failing when the file is saved with CRLF line endings
Fixed Claude Code hanging until killed when a /permissions tab was clicked while searching in fullscreen mode
Fixed conversation compaction sometimes failing with a "null is not an object" error
Fixed plugin hooks reading an empty answer on turn.complete for a subagent that hands its report back in auto mode
Fixed a mod being unloaded without a message when a refresh followed its failed reload; its failure line now says the version loaded before is unloaded
Fixed a mod's prompt.submit hook that drops a prompt after calling next(e) being ignored silently: the hook is now reported as failed, by name
Fixed a mod's pane or band being redrawn without end when it followed its end over a tree that changed height at every drawing
Fixed an image read on macOS and Windows being able to return a file outside what was approved, through a link swapped in mid-read
Fixed a case where a user-installed mod could get an organization's plugin unloaded; the mod is now the one unloaded
Fixed disableClaudeAiConnectors and allowedMcpServers URL rules not being applied to some MCP entries declared in .mcp.json, plugins or agents
Fixed a mod's inline pane being redrawn without end when its tree changed height at every drawing
Fixed an @-mention under the read block or --restricted being able to read a file outside the working directories through a link changed mid-read
Fixed Esc in the agents view confirming "Press enter again to restart this session — it isn't responding"; Esc now just reopens the session
Fixed agent view losing a background session's /loop run count, countdown and live status line after the session enters a worktree that it creates
Fixed claude agents sessions in manual permission mode asking for approval to read an image pasted into a reply or a new agent's prompt
Fixed a deny or ask rule missing a command or path whose name came from a variable set as a prefix on declare, typeset, export or readonly
Fixed Read deny rules not applying to image paths pasted or dragged into the prompt, or to file names listed for an @-mentioned folder
Fixed a case where a user-installed mod could make an organization's guard skip its check; such a mod is now unloaded
Fixed plugin hooks stalling each redraw when a mod draws a long multi-line text holding non-Latin characters
Fixed repeated Ctrl+X in the agents view deleting the whole next section after the bottom session of a section was deleted
Fixed You should know writing its notes in English regardless of the language setting
Fixed a freeze after sending some very long messages
Fixed a slowdown when expanding the transcript (ctrl+o) or resizing over large tool output that contains non-ASCII characters such as arrows, dashes or box-drawing
Fixed claude respawn re-sending an earlier message to a backgrounded session that has no saved transcript instead of starting it with an empty conversation
Fixed Esc after an n: or Ctrl+F search in the agents view moving focus to a section header, where Ctrl+X twice would delete every session in the section
Fixed claude agents saving a slash command it could not deliver to a stopped session and then running it by itself the next time that session restarted
Fixed /ultrareview uploading uncommitted changes unfiltered for files under a git filter driver named unset or unspecified; the upload now stops and asks you to rename the driver
Fixed auto mode denials suggesting a permission rule that would skip the classifier for a whole tool or that Claude Code would ignore
Fixed claude --teleport and /teleport deleting the files in a folder that had replaced a tracked file of the same name when you chose to stash: the stash is now refused, and says why
Fixed Esc confirming agent view's "Press enter again to restart this session fresh" prompt
Fixed agent view's /loop run count freezing and its countdown disappearing after /clear; the count now restarts with the new conversation
Fixed --channels permission relay: a reply ID that repeats within a session is now ignored instead of approving a different prompt
Fixed /chrome "Reconnect extension" not restoring browser tools after a failed Chrome connection, and added an explanation when it can't (anthropics/claude-code#98135)
Fixed mods staying off for people who reach Claude through a gateway (ANTHROPIC_BASE_URL with ANTHROPIC_AUTH_TOKEN) and have no Anthropic account
Fixed replies sent from claude agents just after a background session crashed being refused after 2 seconds: they are now retried for up to 12 seconds while the session restarts
Fixed slash commands and answers to a multiple-choice question that claude agents could not deliver to a running session being saved and sent by themselves the next time it was restarted
Fixed sandboxed commands that pipe a heredoc into another command (cat <<EOF | python3) asking for approval on every run
Fixed claude agents failing with "Couldn't restart the background service" and background sessions stopping after a Homebrew upgrade (takes effect from the upgrade after this one)
Fixed agent view's "restart this session fresh" re-sending an earlier message from the session instead of starting with an empty conversation
Fixed Bash permission checks auto-approving some read-only commands (such as rg or git grep) whose arguments the shell would still expand as wildcards; these now prompt for approval
Fixed claude plugin test refusing to run after an upgrade because of an out-of-date saved setting
Fixed Bash permission checks auto-approving certain commands whose variable names zsh reads differently from bash; these now prompt for approval
Fixed a short form of a git clone option keeping the sandbox exemption from a git pattern such as git * in sandbox.excludedCommands; it is now treated like the long form
Fixed the first feature-flag request of a session ignoring a proxy or API endpoint set in a project's settings
Fixed /ultrareview of a local branch silently leaving uncommitted work out of the upload in a repository that keeps its branches outside .git (git 2.54+); it now refuses with an explanation
Fixed cloud sessions staying asleep after a container restart lost a pending /loop wakeup or scheduled task; Claude is now told and can schedule it again
Fixed the Claude apps gateway's retention sweep deleting a returning developer's identity row refreshed at the same moment, on PostgreSQL versions without the November 2025 fixes
Fixed sandboxed Monitor tool commands skipping the permission prompt under sandbox auto-allow; they now follow your permission rules
Fixed the Claude apps gateway failing to start when the certificate it presents to the identity provider has an empty subject
Fixed the Claude apps gateway exiting with a bare "Invalid URL" when store.postgres_url can't be parsed; the error now names the setting and says what the URL may hold
Fixed background agents failing with "Agent stalled" and Workflow tool subagents restarting from their prompt when a Mac woke from sleep
Fixed slow or failed startup since 2.1.285 under SDK hosts such as the VS Code extension when managed settings deny reads of many paths on a slow filesystem (notably Windows drives under WSL)
Fixed a response interrupted by computer sleep being treated as a stalled stream on Bedrock, Vertex, Foundry, and custom gateways
Fixed a freeze before the first request and in the /sandbox Config tab on Linux and WSL when a sandbox read rule such as ~/**/.env covers a large folder
Fixed skills not being found when asked for by the name in SKILL.md when their folder has a different name (for example a non-English name): the skill listing now shows both names
Fixed a plan written in plan mode being lost when a cloud session's container restarted before the plan was presented
Fixed the Bash tool occasionally losing shell aliases, functions and plugin PATH entries for a whole session when its first command ran seconds after startup on a new config directory
Fixed unbounded memory use when an HTTP MCP server sends a very large response
Fixed artifact operations failing in a Claude Code run started from inside a cloud session (for example claude -p run from the Bash tool)
Fixed files sent from remote sessions sometimes being refused as "not the one approved" when four or more were sent at once
Fixed plan mode not being restored when resuming a session with --continue or --resume <session-id> in the terminal
Fixed a marketplace named after another GitHub marketplace's download folder stopping that marketplace from downloading
Fixed automatic compaction giving up with "Prompt is too long" when a Mac went to sleep while it was running
Fixed the rewind menu (Esc Esc / /rewind) freezing for hundreds of milliseconds per keypress when the conversation contains a very large pasted stack trace or source file
Fixed a subdirectory's AGENTS.md not being attached when a file under it is @-mentioned
Fixed self-hosted runner sessions resumed after a stopped runner failing with "missing but already registered worktree" when the sessions folder is a relative symlink
Fixed a freeze when the secret scan or a permission prompt met long token-like text
Fixed Bash permission checks not applying Read deny rules or the outside-directory read block to a wildcard in some option values of read-only commands
Fixed CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=5m being read as 5 ms and cancelling remote dialogs at once; values with a unit suffix now fall back to dialogExpiry
Fixed a stall when an MCP server's tool listing contains very long runs of combining characters
Fixed two pastes that overlap in one prompt being sent to the model partly as typed text instead of as one pasted block
Fixed Claude in Chrome's browser picker showing a message meant for Claude when the chosen browser is no longer connected, and the VS Code dialog's list going stale after a switch
Fixed background subagents losing write and Bash access in their worktree after the main session enters or exits a different worktree
Fixed background commands, the agents view and daemon workers sending telemetry and a feature-flag request to Anthropic behind a Claude apps gateway when no managed settings on the machine force gateway login
Fixed --restricted (and CLAUDE_CODE_RESTRICTED=1) sessions opening the cross-session messaging socket
Fixed sessions moved to the background while idle reopening as "no saved transcript" after a restart or idle cleanup; they now resume their conversation
Fixed background workers honoring --allow-dangerously-skip-permissions on respawn without the bypass-permissions disclaimer having been accepted
Fixed Claude replying in an endless loop when a plugin's async Stop hook passes an unquoted script path under a folder with a space, such as Application Support
Fixed a freeze of several seconds when secret masking met very long unbroken text
Fixed some permission rules and safety checks not being applied to a tool call after a PreToolUse hook rewrote its input
Fixed first launch asking to pick a login method again after claude auth login or with a credentials file already in the config directory
Fixed file names containing line breaks being displayed incorrectly in file tool errors and permission prompts
Fixed a large paste expanded in place being sent to the model as typed text after the next keystroke when it held accents stored as separate characters, as macOS file names do
Fixed macOS /login reporting success when the keychain refused the new login and kept an old one it could not remove
Fixed SDK hosts using --include-partial-messages seeing a reply stay open after the turn ended when its stream was cut, interrupted or fell back to non-streaming
Fixed sandboxed Bash commands on Linux running ConfigChange hooks and reloading settings mid-command when .claude/settings.json or .claude/settings.local.json does not exist
Fixed errors reading "Premature close" instead of naming the missing program when a tool Claude Code runs, such as git or gh, is not installed (macOS, Linux)
Fixed /loop and other recurring session-only scheduled tasks running an extra time after a sandboxed Bash command on Linux or after .claude/scheduled_tasks.json was deleted
Fixed edits to the file a symlinked settings file points at running without the settings-file permission question
Improved MCP startup behind a network proxy: a server the proxy blocks (HTTP 403) is no longer retried three times
Improved permission prompts from background agents to show the Ctrl+X Ctrl+K shortcut that stops all background agents
Improved the built-in plugin-authoring skill: Claude now gives the one command another person runs to install a mod you made, and writes it in a README's install section
Improved the reply to /plugin in the desktop app's Code tab: it now says where to install and manage plugins there
Improved the Bash changed-files view: when a chained command includes git merge, pull or checkout, it lists the files without full diffs
Improved the Claude apps gateway's log when an upstream's cloud credentials or connection fail: the warning now ends with the underlying cause
Improved the error shown when a cloud session is started without a claude.ai sign-in: it now names claude auth login and /login and no longer blames API-key authentication
Improved the Read tool's message for binary files: it now points Claude to a skill or a shell command that can read the format
Improved the error shown when a git config file stops the /ultrareview upload: it is about half as long and says what kind of file is the problem
Improved the errors shown when the /ultrareview upload refuses a checkout: each known cause now has its own message, with a way to fix it
Improved the Claude apps gateway to log a warning during the last 30 days before the certificate it presents to the identity provider expires
Improved Claude in Chrome: a browser_batch call now gets 90 seconds, up from 60, before it is reported as timed out
Improved the Claude apps gateway's browser sign-in pages: brand fonts, centered layout, and dark mode
Improved responsiveness while resuming large sessions: timers, input and rendering keep running while the transcript loads
Improved the / and @ suggestion lists: the selected row now starts with a ❯ pointer, so you can see it without color
Changed CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC to also skip the startup connection warm-up
Changed Claude in Chrome so that a project's settings files can no longer turn it on; use --chrome, /chrome or your user settings
Changed the Bash tool to ask for permission before running pyright, which is no longer treated as a read-only command
Changed what a mod's $.process.spawn rejects with when another mod denies it after the child ran: it now says the call ran and a plugin withheld its result
Changed the background daemon's log to write a multi-line message as one JSON-quoted line
Changed skills and custom commands to refuse a ! shell command that contains raw control characters other than tab and newline, with a message that shows where they are
Changed /artifacts: opening an artifact in your browser now closes the list
Changed Bash permission checks so that more forms of the ps command ask for approval instead of running without asking
Changed plugin hooks so long text is clipped and logged instead of being refused or dropped silently
Changed background sessions whose scheduled task is gone: they now move to Completed about 20 seconds later and can be updated or shut down when idle
Changed the "Press ← again" confirm on a just-cleared prompt: a second ← no longer has to wait a second before it switches, and holding ← down now switches too
Changed the errors shown when the /ultrareview upload fails at a git step: they name the step and what to try, and no longer repeat git's own error text
Changed /code-review at medium effort to also report cleanup and CLAUDE.md conventions findings on models without tuned review settings, including Opus 5.5 and Sonnet 5.5
Changed an in-process teammate's agent_id in Agent results to its agent ID (its name@team address stays in teammate_id); TeammateIdle hooks no longer fire from its subagents or forks
Changed background sessions waiting on a scheduled wakeup (/loop): they are now left running through updates and low memory, where being restarted or shut down could silently lose the wakeup
Changed /model, /effort and /rename sent from claude agents to a busy background session to apply right away, without a confirmation, instead of when the turn ends
Changed the Claude apps gateway's minimum supported PostgreSQL version from 14 to 11
Changed the interactive session's WebSearch budget to refill over time (100 calls/hour; CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR sets the rate, 0 turns it off) instead of ending after 200 calls
Changed CLAUDE_CODE_DISABLE_ATTACHMENTS so a repository's .claude/settings.json or .claude/settings.local.json can no longer set it; shell, user and managed settings still can
Changed claude plugin update on a plugin loaded from a directory to print just its reason, without the "Failed to update plugin" prefix, as for built-in plugins
Changed the built-in gh api in cloud sessions: a host other than github.com set in GH_HOST or GH_REPO is now refused (use --hostname or a full URL), and stderr notes requests to other hosts
Changed the claude-api skill's Managed Agents examples to turn off the web tools unless the agent needs them and to use the auto permission policy
Self-hosted runners: Changed claude --environment <id> to create its session through the current Sessions API; printed and JSON session ids keep their session_… form
[VSCode] Added a screen reader announcement, "Message queued.", when you send a message while Claude is working
[VSCode] Added a way to review and run a plugin marketplace's install or update command from the Manage plugins dialog
[VSCode] Fixed a blank chat you never typed into keeping a background Claude process running after you open a saved conversation in its place
[VSCode] Fixed settings dialogs blaming a timeout when Claude Code stopped unexpectedly during a save
[VSCode] Fixed the branch switch dialog offering to switch when it could not check for uncommitted changes
[VSCode] Fixed a permission prompt that arrived behind an open dialog taking keyboard focus, so a key pressed in the dialog could answer it
[VSCode] Fixed sign-in and new sessions giving no clear reason when Claude Code cannot find or start its program
[VSCode] Fixed the agent map showing a nested sub-agent with "Tool calls (0)" and placing the agents it starts under the main agent
[VSCode] Improved Continue After Reload: tabs reopened after VS Code restarts its extensions now also finish a step the restart interrupted
[VSCode] Improved file pills in messages: hovering one now shows the file's path from the project folder, so same-named files can be told apart
[VSCode] Changed message timestamps to show by default (turn them off with the Claude Code: Show Message Timestamps setting)
[Cloud sessions] Fixed turning off prompt suggestions through a cloud environment's environment variables having no effect in new cloud sessions
[Cloud sessions] Fixed the working indicator in a cloud session spinning on for several seconds after Claude's reply had finished; it now stops with the reply
[Cloud sessions] Fixed History on a never-run routine's page still saying "No runs yet" after you pressed Run now; it now shows the new run
[Cloud sessions] Fixed an unarchived cloud session looking as if Claude were still working until you sent another message
[Remote Control] Fixed a computer that just started Remote Control taking up to a minute to appear in the Remote Control menu of a new session; it now appears within seconds
[Claude Tag] Added fast mode in Slack: mention Claude with !fast to switch a thread to fast mode, moving it to Opus if needed, and !fast off to switch back; replies show (fast) while it's on
[Claude Tag] Added the optional Path prefixes field when creating a custom connection in an access bundle, so its allow rule can cover only those paths instead of the whole host
[Claude Tag] Fixed members with the Claude Tag Admin permission getting "Couldn't load memory files" on the Activity page's Memory tab; they can now read workspace and channel memory
[Claude Tag] Fixed a workspace guest's Confirm on a Claude settings card in Slack removing its buttons for everyone; only the guest sees the refusal, and members can still confirm or cancel
[Claude Tag] Fixed scheduled routines in Slack channels running on a model other than the channel's default; each run that starts a new session now uses the current default model
[Claude Tag] Fixed GitHub repositories in an access bundle attached by a channel-name rule being refused in the channels the rule covers; Claude can now add, list and clone them there
[Claude Tag] Improved Claude's notice in your direct messages when your own Claude plan's usage limit is reached: it shows within seconds and says when the limit resets
[Claude Tag] Improved the earlier Claude in Slack app's reply when it can't start a session: it now says what failed and who can fix it, in full only once per thread
[Claude Tag] Changed the channel instructions limit to 8,192 characters instead of bytes, so non-English text gets the same room, and added a character count beside Save on the Configure page
[Code Review] Fixed blocking review comments sometimes opening with a "nit" label that contradicted their severity
[Code Review] Fixed tips to comment "@claude review" being posted on fork and Manual-mode pull requests in organizations that have turned Code Review off

●

v2.1.289 Oct 3, 2026

v2.1.289

What's changed

Fixed a deny or ask rule on a nested part of a compound shell command not holding over a user-installed mod's approval on managed machines
Fixed the terminal freezing on short code blocks with many unclosed <script> tags or deeply nested ${ substitutions
Fixed Read deny rules not applying to files @-mentioned, changed, or selected in the IDE through a symlink
[VSCode] Reverted a 2.1.288 change to claude auth status that may have made sign-outs more frequent
Improved how quickly large files open in a plugin code pane by laying the highlighted view out once at its final width
Fixed plugin list, plugin eval and plugin update showing a stale copy of a plugin installed from a local folder marketplace, and hot reload for a symlinked --plugin-dir
Fixed installed mods not loading in the first session after an upgrade
Fixed a plugin's rows above the prompt showing a stale row while the Background tasks dialog was open in fullscreen
Fixed plugin panes drawing nothing when a link used a localhost address, an @ in its path, an uppercase host or a file: path
Fixed a user-installed plugin being able to rewrite the descriptions of an organization-managed MCP server's sign-in tools
Fixed a freeze or forced quit at launch when a plugin drew a Box with a border style the terminal does not know
Fixed supervised and background sessions ending when a plugin's on-screen handler threw asynchronously
Fixed sessions ending with an interface error when a plugin region with no height kept growing
Fixed Bash deny and ask rules missing a command behind an environment variable prefix with an expanded value (e.g. TZ="$HOME" rm -rf build) when the sandbox auto-allows commands
Fixed a Bash deny or ask rule being skipped under sandbox auto-allow when a bare variable assignment came before the command
Fixed claude plugin validate skipping the plugin when the folder also holds a marketplace manifest
Added agent.spawn for teammates, one agent id across plugin hook events, and idle and waiting states in $.agent.list()
Fixed sessions ending with "unrecoverable interface error" when a value a mod's ui.render hook wrote made a row throw while drawn; the engine now draws its own row instead
Fixed text with a tab, a stray escape and a C1 control, or a short text with a tab and CRLF line endings, drawing over the rows below it
Fixed right-aligned content in a mod's pane or band drawing under the close mark or [-], which now also keep one column in from the terminal's edge
Fixed a mod's Client that fails while drawn taking down everything the mod drew around it; it now fails alone and raises ui.fault
Fixed claude plugin validate failing an Anthropic marketplace's own plugin and listing a clean plugin.json in --json
Fixed a mod's band that fails to draw briefly telling the cards under it to step aside
Fixed a failed plugin component showing Error or nothing as its reason when the failure carried no message
Improved the line a mod's author sees when its band or pane fails to draw: it names the mod and says nothing was drawn
Fixed published artifact pages freezing or crashing the reader's browser tab on short code blocks with many unclosed <script> tags
Fixed a mod's Client region staying failed for the whole session after the terminal threw while drawing it

●

v2.1.288 Oct 2, 2026

v2.1.288

What's changed

Added $.ui.selection() for mods: returns the text you last selected in fullscreen mode and, when the selection lies within one transcript row, that row
Added a built-in gh api to cloud sessions whose image has no GitHub CLI, and fixed the built-in sending control characters from file names, jq filters or GitHub errors to the terminal
Added recovery for a prompt cleared with Ctrl+C: pressing Up on the empty prompt brings the draft back, including pasted text and images
Added a re-authenticate prompt when an MCP server asks for more OAuth scope during a tool call
Added --max-findings <n>|all to /code-review to report more or fewer findings than the usual limit; the choice is reused until you pass --max-findings default
Added Ctrl+F to find a session by name and Alt+↑/↓ to jump between groups in the agents view; both, and rename, can be rebound in keybindings.json
Added a screen reader mode announcement of the new permission mode when you approve a plan, including with Shift+Tab
Fixed mid-response API timeouts failing the turn: non-interactive sessions and subagents now continue from the partial response, and thinking-only responses are retried
Fixed long conversations failing with "Prompt is too long" instead of auto-compacting when the last reply reported zero token usage
Fixed --resume sometimes dropping files and other context that a compaction had just restored
Fixed a resumed session sometimes not saving the last response of a turn, so that the next --resume showed the prompt unanswered
Fixed resume occasionally loading a transcript cut short when the same session rewrote the file during the load
Fixed resuming a conversation started on 2.1.286 or earlier dropping the model's earlier thinking
Fixed session titles, memory recall and prompt hooks failing on Mantle or behind gateways that reject structured outputs; added CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS to turn structured outputs off
Fixed auto mode denials pointing Claude at a Bash permission rule when the blocked tool was not Bash
Fixed auto mode on Bedrock and Mantle switching to the local classifier for the rest of the session after a request to an older model, such as a WebFetch summary or a sonnet subagent
Fixed cloud sessions that restarted on a newly picked model replying with that model after the server refused it
Fixed Cowork cloud sessions staying marked as waiting for input after a WebFetch permission prompt for an unapproved URL went unanswered for five minutes
Fixed prompt suggestions not appearing on a phone that joins a Cowork cloud session started on another device
Fixed a mod's button sometimes running a different button's action when pressed on a view drawn before Claude Code restarted
Fixed a plugin's pane showing nothing when one Code element held a diff that does not parse; it now draws as plain code
Fixed plugin LSP servers receiving literal ${user_config.*} and ${CLAUDE_PLUGIN_ROOT} placeholders in initializationOptions and settings instead of substituted values or manifest defaults
Fixed a plugin's tool.call hook making Bash fail and file searches read the wrong folder in subagents that run in a worktree
Fixed git-subdir plugin installs failing, or caching an incomplete plugin, on older git (before 2.39, e.g. Ubuntu 22.04's 2.34)
Fixed plugins loaded with --plugin-dir not showing "Configure options" in /plugin
Fixed background sessions ending when a plugin was reloaded or disabled while one of its timers or reads was still running
Fixed sandboxed heredocs with an unquoted delimiter (python3 <<EOF) asking for approval on every run under sandbox auto-allow when the body holds only plain text and simple $VAR references
Fixed Bash tool permission check to prompt before a BASHPID assignment whose value the shell would evaluate as arithmetic, instead of allowing it silently
Fixed fullscreen sessions exiting with "unrecoverable interface error" when opening the background tasks dialog while a plugin or mod showed rows above the prompt
Fixed Claude reporting a message to another session as delivered when that session held it: the notice now says it wasn't delivered and names the session, and in SDK sessions Claude can now learn of it mid-turn
Fixed OpenTelemetry claude_code.tool.blocked_on_user spans reporting unknown source or decision in -p and SDK sessions and for PreToolUse hook approvals
Fixed permission asks that ended unanswered, in -p or on an interrupted turn, emitting no tool_decision event
Fixed Edit and Retry in Cowork cloud sessions refusing a message sent before /compact even though its history was still saved
Fixed unattended sessions (CLAUDE_CODE_RETRY_WATCHDOG) retrying for hours after a very long response stream failed; Claude Code now streams again, and gives up after three timeouts
Fixed /login reporting "Login successful" when credentials could not be saved to secure storage; it now shows the failure, and offers a retry when the new login didn't take effect (anthropics/claude-code#73861)
Fixed a Stop during Bedrock credential lookup sometimes moving the session to a fallback model instead of ending the request
Fixed a second gcpAuthRefresh/awsAuthRefresh browser sign-in opening when a laptop wakes from sleep while another Claude Code process is signing in
Fixed agent teams: a plugin-defined agent spawned by name now runs with its own prompt, tools, disallowedTools and effort instead of the defaults
Fixed headless (-p / SDK) sessions occasionally ignoring SIGTERM when a supervisor such as timeout or systemd sends SIGCONT alongside it
Fixed restarted cloud sessions restoring a model that the organization's enforced model list refuses
Fixed MCP tool calls sometimes running twice when a remote server's result was over 16 MB or could not be parsed
Fixed subagents in Claude Desktop's Code tab getting none of the tools of a user-configured MCP server named memory
Fixed Claude in Chrome asking before every screenshot and page read on a site you allowed when auto mode is unavailable (such as with disableAutoMode or an older model); typing, navigation and JavaScript still ask
Fixed claude plugin install failing for GitHub-source plugins on macOS and Linux machines with no GitHub SSH key: the clone now falls back to HTTPS and prints a notice
Fixed sandbox.credentials.files entries on git config files not taking effect while permissions.blockReadsOutsideWorkingDirectories is on
Fixed Claude leaving out your organization's design systems when starting slides or a design with the Artifact tool on Team and Enterprise plans or machines with managed settings
Fixed the keyboard not working on Windows after Claude Code restarts itself (first sign-in to a Claude apps gateway, provider setup, /tui)
Fixed a stall when launching an agent whose tools: lists very many Agent(...) entries
Fixed sessions on Claude 3 Opus and Claude 3 Sonnet failing on every turn after a whole PDF entered the conversation
Fixed the npm auto-updater reporting success when the platform-native binary failed to download and only the placeholder claude stub was installed
Fixed Remote Control cleanup archiving a session that is still connected or was just re-attached by another Claude Code process
Fixed owner/repo plugin marketplaces showing only the second attempt's error when both the SSH and HTTPS fetch fail; both errors are now shown, with the transport tried first on top
Fixed path-scoped .claude/rules and nested CLAUDE.md files not loading when Write or Edit creates or changes a file in their scope (previously only Read loaded them)
Fixed a dangerous rm (such as one on / or the home directory) inside a bash -c or sh -c script running without a prompt in bypassPermissions mode or under a shell allow rule (anthropics/claude-code#96300)
Fixed LSP tool calls hanging indefinitely when a language server uses dynamic capability registration or stops responding; requests now time out after 60s (per-server requestTimeout)
Fixed idle_prompt notification hooks firing while background agents are still running (anthropics/claude-code#93672)
Fixed PreToolUse and PermissionRequest hooks being skipped when matching them failed or the tool's input could not be serialized to JSON; the call is now blocked
Fixed the first request in a fresh environment or after a model switch using the built-in output limit and auto-compact window, not the server's; that request may now wait up to 1.5 seconds
Fixed the "What should Claude do instead?" hint showing on the Interrupted row after sending queued messages with ctrl+enter
Fixed /login in a --bare session running a sign-in the session never reads, which could replace your saved login; it now says which credentials work
Fixed the InstructionsLoaded hook omitting agent_id and agent_type when a subagent's file access loads a rule or nested CLAUDE.md; rules and nested CLAUDE.md files loaded on file access now also report effort
Fixed the Agent tool in claude mcp serve always reporting no available agents and rejecting every subagent_type
Fixed the terminal cursor not following the typed text in the fullscreen transcript viewer's search and in /theme's custom color search
Fixed /permissions in screen reader mode: typing a rule's number now picks it instead of opening the search box
Improved auto mode: when a conversation grows too long for the client-side safety classifier to review, it is now compacted instead of prompting for, or failing, every tool call
Improved screen reader mode: short announcements, such as a deleted word, now stay on screen until your next key press or until something above them on screen changes
Improved screen reader mode: answered questions in question dialogs now say "answered" beside their box
Improved the /usage-credits message shown to Team and Enterprise members whose organization has turned off usage credit requests
Improved cloud sessions: a new conversation's first turn no longer waits for a stdio MCP server whose config sets alwaysLoad: false
Improved "You should know" notes to say "we", "the main agent" or "you" depending on who was responsible for a decision
Improved the error for an artifact database write refused at the database's size limit: it now states the limit and what frees space
Improved Bash permission prompts to give a shorter reason when part of a command can't be checked before it runs
Self-hosted runner: Improved the built-in gh api: a refused gh command now prints its gh api equivalent, --paginate follows every page of a repository's lists, and a nested claude no longer removes it
Improved Remote Control's recovery from an expired server credential: sessions stay connected during renewal and are kept if it gives up after a server outage
Changed the background command time limit to apply only in unattended sessions (-p, Agent SDK, CI, cloud); terminal, desktop app and VS Code sessions have no limit
Changed the client-side auto mode classifier to ignore an ANTHROPIC_DEFAULT_SONNET_MODEL pin that names Claude Sonnet 5.5 or Opus 5.5 and use Claude Sonnet 5 instead
Changed claude project purge to claude purge; the old name still works and prints a notice
Changed the agents view n: filter (and Ctrl+F search) so Enter opens the session whose name matches best instead of the top row
Changed /autocompact to save the auto-compact window per model, so each model keeps its own setting when you switch
Changed MCP URL prompts from servers that can't report when you're done to wait for "I'm done, continue" before the tool call continues, so you can finish in the browser first
[VSCode] Fixed a claude.ai connector staying on "Needs authentication" after you authorize it: the MCP servers dialog now offers Check connection
[VSCode] Fixed the opt-in New Conversation shortcut (Cmd/Ctrl+N) starting a conversation in every visible Claude view instead of only the one you are in
[VSCode] Fixed the chat view resuming the next saved session after you archive the one it shows; it now starts a new conversation instead
[Cloud sessions] Fixed the Cloud sessions switch in Claude Code admin settings staying locked off while an unrelated security setting was loading or had failed to load
[Cloud sessions] Fixed pressing Stop while a self-hosted runner was still starting not cancelling the queued message, which could then run once the runner was up
[Claude Tag] Fixed Claude Tag admin settings offering a "Remove this scope" option, which always failed, on channels whose settings were created automatically
[Claude Tag] Improved Claude to also follow a related Slack thread in another channel that it only read, so updates there reach the conversation that depends on them
[Claude Tag] Improved save errors on a channel's Configure page: too-long channel instructions now say to shorten them, and a save refused for lost access no longer says to try again
Fixed claude plugin test reporting mods as turned off remotely when it had only read an out-of-date saved setting