Release notes from claude-code

v2.1.294

2026-10-08T05:03:54Z

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

2026-10-07T18:10:20Z

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

2026-10-06T18:59:30Z

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

2026-10-06T03:55:19Z

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

2026-10-05T23:33:17Z

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 (#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

2026-10-03T23:07:17Z

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

2026-10-02T20:19:57Z

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 (#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 (#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 (#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

v2.1.287

2026-10-01T18:43:19Z

What's changed

Added Claude Mods: plugins may now modify deeper behavior
Added You should know, a built-in mod where a side agent watches your back and flags things you or Claude might miss. Turn it on with /plugin enable cc-plugin-you-should-know@builtin (for first-party sessions with telemetry on)
Added an n:<text> filter to the agents view that matches session names and tasks; a filter now shows matches in collapsed sections and Enter opens the first match
Added prompt_text to the OpenTelemetry user_prompt event, a copy of prompt for backends that nest dotted keys; drop or mask it wherever you drop or mask prompt (#70763)
Added URL prompts from MCP servers on the 2025-11-25 protocol, for example to sign in. If a server no longer connects after this update, add "bareElicitationCapability": true to its MCP config entry
Windows: Added a startup warning when denying the Bash tool also turns off the PowerShell tool, so Claude has no shell tool
Self-hosted runner: Added a built-in gh api (REST only) for sessions that use Anthropic-managed git on macOS and Linux machines where the GitHub CLI is not installed
Fixed fast mode staying off in remote sessions owned by an agent with no user account, even when the organization allows it
Fixed Remote Control not receiving messages for minutes at a time when a reconnect request got no response; it now gives up after 30 seconds and retries
Fixed hooks configured with asyncRewake waking Claude over and over with "found issues" notifications when the hook's script file is missing; the broken hook is now reported once
Fixed tool heartbeats not reaching SDK hosts while the model's response stream was stalled with no data arriving
Fixed Bedrock and Vertex startup model checks ignoring an enforced availableModels list, which could collapse /model to one Opus row
Fixed the Claude in Chrome browser picker showing a JSON parse error when Chrome could not be reached
Fixed picking Fable in /model on a claude.ai login saving the current version's id, so your saved default now follows the newest Fable like Opus and Sonnet do
Fixed switching between Opus 5.5 and Sonnet 5.5 (/model, opusplan) rewriting earlier MCP tool announcements, which could drop earlier extended thinking
Fixed Amazon Bedrock Guardrails blocks that arrive mid-response ending the turn with an API error instead of the guardrail's message when the reply began with thinking
Fixed a dangerous rm (such as one on / or the home directory) losing its always-ask safeguard when the same command also redirected output to a ~ or wildcard path
Fixed claude -p and SDK sessions repeating a model fallback on every later message after the model was switched while a reply was running
Fixed a folder's CLAUDE.md being attached a second time after resuming a session or after a compaction
Fixed background sessions that could not be reopened from claude agents after the agent exited and removed the worktree the session was started in
Fixed /advisor pairing checks: Sonnet 5.5 can now advise Opus 4.7 and 4.8, and advisors the API would refuse are flagged up front instead of being silently dropped
Fixed Bash permission prompts showing internal parser names such as "Contains simple_expansion" instead of a plain explanation
Fixed a cause of fullscreen sessions on slow or busy machines exiting with "Claude Code exited after an unrecoverable interface error" while a scroll key was held in a long conversation
Fixed organization per-tool permission ceilings being silently dropped for an MCP tool named __proto__
Fixed Claude being told to page large MCP results saved as JSON with Read's offset and limit, which cannot split one long line
Fixed the commit attribution reminder being delivered inside a tool result after a compaction
Fixed screen reader mode leaving the cursor away from the typed text in search boxes (such as /resume and /permissions) and sign-in code fields
Fixed screen reader mode refusing Enter with nothing typed on /rewind's summarize options, whose added context is optional
Fixed screen reader mode showing a "Tab to amend" hint on approval prompts, where Tab does nothing
Fixed screen reader mode listing arrow keys that do nothing in /permissions and /mcp, and saying "Select with numbers" in empty menus or while a search box has the keys
Fixed screen reader mode leaving out the changed lines in file edit approval prompts and other diffs
Fixed screen reader mode sending the claude --teleport progress screen, and an MCP form field while it is being checked, to the screen reader again on every spinner frame
Fixed CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS not removing the structured-output format from session-title and prompt-hook requests, which Bedrock-backed gateways reject
Fixed screen reader mode leaving out the top lines of a second approval prompt, a changed /config row or the rejected-plan line when the previous screen was taller than the terminal window
Fixed --include-partial-messages sending a cut-short reply's message_stop late or never, so apps could show the reply as still in progress
Fixed claude agents sometimes not showing the permission prompt a background session is waiting on
Fixed /ultrareview giving advice about .git/info/attributes when the upload stops on a committed .gitattributes it cannot read, such as one saved as UTF-16
Fixed claude remote-control failing to register behind an HTTP proxy with a misleading "Check your organization permissions" error (#97352)
Fixed sandboxed Bash commands on Linux inheriting an open handle on the Claude Code executable
Fixed the running-tool dot and three spinners still moving with the "Reduce motion" setting on, and /rewind's confirm screen updating its "ago" time while you type a note
Fixed times in claude agents changing every second in screen reader mode; they now change at most every 10 seconds
Fixed a revoked claude.ai login showing a generic API Error: 401 instead of "OAuth token revoked"; in -p mode the error now starts with "Failed to authenticate"
Fixed /ultrareview upload refusals advising you to copy a variable named by a repository's settings file into your own user settings
Fixed --output-format stream-json and the SDK not streaming the turns of a context: fork skill run by typing /<skill> as the prompt, as they do for the Skill tool's fork
Fixed /feedback and /bug: the pre-filled GitHub issue no longer includes your recent error messages, and the confirmation screen now lists them as part of the report
Fixed claude plugin marketplace add --sparse and git-subdir plugin installs failing with "transport 'http' not allowed" when the repository is served over plain http
Fixed cloud sessions sometimes losing the earlier conversation when the session restarted while it was being compacted
Fixed a plugin reload that overlapped the startup --plugin-url download corrupting the session's cached copy of the plugin archive
Fixed /desktop quoting partial output when opening Claude Desktop timed out or printed too much output; the error now names the cause
Fixed an MCP connector tool call occasionally running twice, or the connector's calls failing until restart, when its server changed which MCP protocol version it supports
Fixed SessionStart hooks from synced plugins not running in new cloud sessions
Fixed the transcript's "N hooks ran" summary and the verbose debug log's matched-hooks count including Claude Code's internal callbacks, so one configured hook no longer shows as two
Fixed files Claude sends from cloud and Remote Control sessions failing when the upload finished just after the 30-second timeout; it now waits 35 seconds
Fixed repositories added mid-session in cloud and SDK sessions not loading their skills and plugins, and loading CLAUDE.md late, after Claude changed directory
Fixed PNG, JPEG and WebP images over 8,000 pixels on a side failing to send from a remote session; Claude now sends a scaled-down copy
Fixed messages sent from the Claude apps with 17 to 20 attached files delivering only the first 16
Fixed headless sessions reporting an MCP server as needing authentication after one refused call, even though later calls succeed
macOS: Fixed Remote Control sessions started with claude remote-control stopping mid-turn when the Mac went to idle sleep
Windows: Fixed interactive claude hanging or crashing with "Raw mode is not supported" when its input is piped or redirected; it now says why and exits (use -p for piped input)
Bedrock, Vertex, Mantle: Fixed model availability checks under CLAUDE_CODE_SKIP_*_AUTH sending a different Authorization header than real requests when ANTHROPIC_CUSTOM_HEADERS repeats it
Improved /config: settings that cycle show ‹ › and step both ways with ←/→, narrow terminals stack each value under its label, and PgUp/PgDn page the list
Improved plugin marketplace errors to say in plain words why a marketplace was ignored or refused, and what to do
Improved plugin listings to note when a plugin's dependencies were not installed, and updating a plugin now retries an install that did not finish
Improved the Claude apps gateway's error when Amazon Bedrock rejects a model ID: developers now see which model is unavailable, and the gateway log names the ID that was sent
Improved SDK sessions so a message sent with priority "now" no longer cancels a running web fetch or web search; it keeps loading in the background
Improved /memory: the left and right arrow keys now flip its on/off settings, such as Auto-memory
Improved /skill names typed mid-message: Claude is now told they are skills, including disable-model-invocation ones
Improved the contrast of the prompt input border in light themes and of the ❯ before your earlier messages
Improved delivery of files Claude sends from cloud sessions and Remote Control: an upload that fails on a timeout, a network error or a 502, 503 or 504 is now retried once
Improved what Claude says when a file cannot be sent for a reason that may be temporary: it now mentions that you can ask for the file again in a few minutes
Improved the prompt for a held message from another session to show the message between dashed lines, matching other permission prompts
Improved MCP and other tool permission prompts to show the tool call between dashed lines, matching file edit prompts
Improved MCP startup in headless mode: a remote server whose first connect fails transiently is now retried without waiting for the slowest server to finish connecting
Improved files Claude sends from a remote session: large files now stream from disk instead of being read into memory, and a file over the size limit is refused with the server's limit named
Improved the explanation Claude gives when the server refuses a file it sends from a Remote Control or cloud session, such as an oversized image
Improved handling of large MCP tool results: less memory, smaller session files, and no extra upload to count tokens for results far over the limit
Windows: Improved Bash tool speed by removing a subshell that ran before every command
Changed a shell write through a repo-committed symlink onto a sensitive file or out of the working tree to name where it lands and wait for a person, on lines with a ~ target too
Changed Opus 4.7+ and Fable to use a 1M context window by default on Bedrock, Vertex, Foundry and the Claude apps gateway, with no [1m] suffix (CLAUDE_CODE_DISABLE_1M_CONTEXT=1 keeps 200K)
Changed replies from claude agents to arrive as queued messages; slash commands other than /stop sent while a turn is running now run when it ends
Changed whole-tool Bash allow rules and allowing hooks to prompt for, not run, shell writes to files Claude Code's file tools refuse outright (the Anthropic profile store, the host credentials file)
Changed right-click paste on Windows and Linux, and middle-click paste on Linux, to happen when the button is released; moving the pointer away before releasing cancels it
Changed MCP server alwaysLoad: false to defer all of that server's tools behind tool search
Changed screen reader mode to write new or changed lines without first pausing with the cursor at the start of the line; set CLAUDE_AX_PREPARK_MS=50 to restore the pause
Changed automatic model switches after a flagged message to keep your current effort level instead of the new model's default
Changed waiting permission prompts to show oldest first, so a new prompt no longer covers the one you're reading (prompts with a countdown still open on top)
[VSCode] Added "Run in background" to a running command or sub-agent, to move it to the background and keep working
[VSCode] Added the output of background shells and Monitors to their cards in the agent map
[VSCode] Fixed settings dialogs blaming a timeout when Claude Code's reply was too large to confirm a save
[VSCode] Fixed reopening a cloud session that the side bar already brought to this machine opening it again in a new tab; the side bar is shown instead
[VSCode] Fixed the side bar's Web tab not listing cloud sessions started after the window loaded; a failed load now says "Remote server is not connected" instead of "No web sessions yet"
[VSCode] Fixed a tab restored after a reload starting a second Claude process on a conversation the side bar already has open; it now shows the "still open somewhere else" notice
[VSCode] Fixed tool-row file links, session-list links and two hints showing in plain text
[VSCode] Fixed a background agent's still-running command showing as failed once the main turn ended
[VSCode] Fixed a user's own /usage or /context command opening the extension's dialog instead of running when picked from the command menu
[VSCode] Fixed file links in the plan preview tab doing nothing when clicked; they now open the file like links in chat replies
[VSCode] Fixed opening a tool's input or output in an editor tab failing with "Timeout waiting after 1000ms" on remote hosts such as WSL when the tab is slow to appear
[VSCode] Improved the Manage plugins dialog: a failed marketplace add, remove or refresh now says what went wrong
[VSCode] Changed the Claude in Chrome "Enabled by default" switch to also connect the editor's own sessions, which still ask before browser actions
[Cloud sessions] Fixed occasional failures to fetch from or push to GitHub when GitHub briefly refused a newly issued access token
[Claude Tag] Fixed Claude posting a failure warning, such as a spend limit notice, in a Slack thread when a background event like GitHub activity woke it and nobody was waiting on a reply
[Claude Tag] Fixed Claude Tag's spend limits page in admin settings leaving out recently created and private channels in organizations with many channels
[Claude Tag] Improved Claude's task list in long Slack threads: background work no longer reposts it as a new message on its own, so people following the thread aren't notified
[Code Review] Fixed finding comments and their "Why this was flagged" text stopping mid-sentence; they now end on a complete sentence
[Code Review] Fixed Code Review skipping a pull request after a new push when its review had failed twice on the previous commit; it now reviews the latest commit
[Code Review] Improved the failed-review card on a pull request whose conversation is locked: it now says the lock blocked the review and that nothing was posted or charged

v2.1.286

2026-09-30T19:10:13Z

What's changed

Added a count such as "2 of 5" to the permission prompt when several permission requests stack up
Added mouse support for the "N more" rows of lists in fullscreen mode: click one to jump to that end of the list, with hover and pressed states
Fixed several Claude Code processes and IDE extensions each opening a login browser when gcpAuthRefresh or awsAuthRefresh credentials expire
Fixed claude --resume and --continue sometimes losing every turn after a batch of parallel tool calls when the earlier session crashed or was killed
Fixed API 400 errors after a tool or hook returned an object, number or boolean instead of text, including in resumed sessions
Fixed cloud sessions with very large histories never waking up because the container was stopped while the transcript was still loading
Fixed the Claude apps gateway's spend meter pricing 1-hour prompt cache writes at the cheaper 5-minute rate, and counting only the first model call's input tokens on streamed turns that run a server-side tool such as web search
Fixed macOS sessions still showing "Not logged in" or "Login expired" after /login succeeds in another Claude Code window when a leftover ~/.claude/.credentials.json exists
Fixed every turn failing when the Anthropic API refuses the model your default or a model alias resolves to: Claude Code now retries once on the previous model of the same tier
Fixed Remote Control sessions (including claude remote-control) staying connected after your organization's policy turns Remote Control off; they now disconnect with a notice
Fixed refusal and --fallback-model retries failing when the fallback model can't run fast; they now run at standard speed, with a one-time notice in interactive sessions
Fixed headless sessions repeating the "MCP servers require authentication" reminder after a successful re-authentication when the MCP discovery cache is enabled
Fixed claude auth status reporting a Console sign-in's stored API key as claude.ai; it now reports api_key, and the VS Code extension treats that session as an API key session
Fixed /status listing an Anthropic profile beside an API key as if both were in effect; the profile is now marked as not in use
Fixed Claude not being told when a file attached to a message sent over Remote Control did not arrive, and a file sometimes getting only 10 seconds for its last download try
Fixed a Remote Control message that arrived while Claude Code was exiting being marked delivered and then never answered; it now stays queued for the session's next run
Fixed MCP error messages showing a credential's value when "Bearer" or "Basic" came before its key name
Fixed percent-encoded Bearer tokens being only partly masked in error messages
Fixed redacted logs and transcripts showing a secret whose key name has an invisible character inside, such as a zero-width space
Fixed logs and transcripts showing part of a URL password that contains punctuation such as ), quotes, ], & or a second @, or that runs past a / to a bracketed host such as [::1] in an ssh URL
Fixed the session transcript in the zip that /feedback saves to disk containing invalid JSON lines after secret redaction
Fixed MCP connectors listing no tools for up to a day after their server dropped the older MCP handshake
Fixed a repeat MCP sign-in request from Claude replacing the pending sign-in link, which could stop that link from working
Fixed /usage not crediting an MCP server for a tool call made while that server was still connecting or had only just connected, such as right after a restart
Fixed plugins enabled on claude.ai occasionally going missing from Claude Code for a session after a transient server error
Fixed a message typed into a running subagent showing twice in its transcript after the subagent read it
Fixed subagent hand-back messages showing a raw task id instead of the agent's name when the subagent had no registered name
Fixed foreground subagents sometimes missing the task-tracking tools (TaskCreate/Get/Update/List, TodoWrite) in sessions that have them enabled
Fixed subagents spawned with worktree isolation loading the project CLAUDE.md and its imports a second time from the worktree copy on their first file read
Fixed Workflow tool subagents being restarted from their original prompt when a connection stalled for a few minutes mid-response
Fixed /compact, /clear, and /rewind typed while viewing a background agent's or teammate's transcript silently acting on the main conversation: a dialog now names the target and asks first
Fixed background jobs showing done while waiting for your approval
Fixed the commit attribution reminder being re-sent inside tool output when a model fallback lasts only one turn
Fixed a click on the space between words of a collapsed row (such as "Thought for 4s") highlighting the row without expanding it in fullscreen mode
Fixed a row with no details, such as an action row with a long name, pushing every other row's details to the right in list screens
Fixed files with very long names not reaching a cloud session when attached to it
Fixed plugin errors for a marketplace Claude Code refuses to load: they now say why and how to fix it instead of "not found"
Fixed /plugin's Discover tab showing a marketplace name unquoted in its "Checking … for new plugins" line when its rows already show that name in quotes
Improved commit guidance: when your project or user skills include one named verify, Claude is now told to run it right before committing, except for docs-only and tests-only commits
Improved send now (ctrl+enter) in a subagent's view: it now moves the subagent's running command to the background so your message is read right away
Improved replies from background agents to your messages so they no longer open with a separate recap of what you said
Improved claude.ai artifact link reads: WebFetch now asks the same questions as the Artifact tool's read (no artifact prompt while the session's network access is on, one per artifact while it is off), and an auto-mode yes no longer counts where only you can answer
Improved fetch, skill, file read, sandbox network, Claude in Chrome, workflow script and notebook edit permission prompts to match the look of file edit prompts
Improved Bash, PowerShell and Monitor permission prompts to show the command between dashed lines, matching file edit prompts
Improved list scrollbars in fullscreen mode: in most lists the bar no longer shifts as the "N more" rows come and go, and it now has ↑/↓ arrows you can click or hold to scroll
Improved the external editor (Ctrl+G): editors that take a line number now open on the line your cursor is on in the prompt
Improved slash command suggestion responsiveness while typing when many skills or plugin commands are installed; command descriptions now match by word prefix
Improved the output style picker: it now opens on your current style instead of Default, with each style's description on the line under its name; number keys no longer pick a style
Improved /hooks: the closing line of a hook's detail screen now says "this hook" instead of "it"
Improved the model fallback notice and the autocompact-thrashing error to say when a fallback dropped the context window from 1M to 200K tokens
Improved responsiveness of SDK and -p sessions when a host re-sends an MCP server enable for a server that is already connected
Improved the protocol page a Claude apps gateway serves at /protocol: it now says not to reject unknown input and matches what Claude Code sends today
Changed prompts sent while nothing is running or queued to show in the normal text color right away instead of gray
Changed how failed API requests are retried: one limit now covers a whole model call, so with the default retry settings a failing call sends at most 14 requests
Changed --bare to connect only the MCP servers named on the command line, send the model no system reminders, and start no background tasks; under --bare, a shell command that reaches its timeout now stops instead of moving to the background
Changed the send-now key (ctrl+enter) to move a skill's own shell command to the background instead of ending it
Changed the WebFetch error for a rate-limited domain safety check to tell Claude not to retry it in a loop
Changed plugin installs to refuse npm sources that are git repositories or folders, and to install plugin dependencies only from registry packages
Changed list screens (/artifacts, /mcp, /skills, /hooks and others) to always line up each row's details in one column after the names
Changed the overflow rows of lists to read "↑ N more" / "↓ N more" instead of "N more above" / "N more below"
Changed /hooks to open on one list of your configured hooks grouped by event, so viewing a hook takes one Enter instead of three
Changed the theme picker to a scrolling list that fits your terminal instead of pushing the preview off screen; number keys no longer pick a theme
Changed /exit's Remove worktree to run after Claude Code stops the servers and shells it started there, which on Windows could keep the folder from being deleted
Changed the claude-api skill's Managed Agents examples to create environments with limited networking
Removed the browser link from /ultrareview and claude ultrareview output
Windows: Fixed claude --bg and the agents view refusing a folder that claude already trusts when its trust record was saved with different letter case
[VSCode] Added bookmarks: save Claude's responses and keep them in view in a Bookmarks side panel
[VSCode] Added the questions Claude asks and your answers to the conversation: after you answer a question card, a Questions row shows each question with your picks
[VSCode] Added option previews to question cards in the chat panel: the highlighted choice's mockup or snippet shows beside or under the options
[VSCode] Added rows under a message that open to the terminal output, browser tab, browser instructions and selected code sent with it
[VSCode] Fixed a second copy of a conversation opening in a tab when it was already open in the side bar; the side bar now switches to it
[VSCode] Fixed settings dialogs reporting a failed save, without re-checking, when Claude Code printed more than 1 MB of output
[VSCode] Fixed an endless "Teleporting session…" spinner when the extension stops responding
[VSCode] Improved the Manage plugins dialog: it says when a turned-off plugin is still on because of other settings, and explains a plugin folder clash
[VSCode] Changed Stop and Escape to end only the current turn; background agents keep running and can be stopped one by one from the agent map
[VSCode] Changed the "✻ Claude Code" status bar item to show in every window, so you can open Claude when no file is open
[Cloud sessions] Fixed an answered question card or approved tool call getting no reply when the session had gone idle after Claude sent a message
[Cloud sessions] Fixed clearing an organization environment's setup script in admin settings leaving new cloud sessions still running the old script
[Cloud sessions] Fixed the Runner actions menu on the self-hosted environments admin page closing on its own a few seconds after it opened
[Cloud sessions] Fixed routine runs whose cloud session never started showing as Succeeded in the Runs pane, the routine's page and the sidebar; they now show as Failed
[Cloud sessions] Fixed clicking an audio or video file in a cloud session's Outputs card opening an empty file search instead of playing the file
[Cloud sessions] Changed a routine's page to read "Due" with the scheduled time, instead of a next run time in the past, when a scheduled run is late and hasn't started
[Claude Tag] Added an Add channel button to Claude Tag's spend limits page in admin settings, so a limit can be set on any channel, including a private one, from its channel ID or Slack link
[Claude Tag] Fixed memory recall finding nothing in organizations that cannot use the default Sonnet model
[Claude Tag] Fixed a Slack channel losing its Claude settings when an Enterprise Grid admin moves it to another workspace and the first post afterward doesn't mention Claude
[Claude Tag] Fixed Claude in a Slack thread occasionally starting over on a fresh machine, losing work it hadn't pushed, when your reply answered a question it had just asked
[Claude Tag] Fixed public channel names on Claude Tag's spend limits page in admin settings showing as raw Slack IDs in larger organizations
[Claude Tag] Improved the titles of sessions started from Slack as shown on claude.ai: they now read as the words you typed, without Slack user IDs or escape codes

v2.1.285

2026-09-29T19:27:30Z

What's changed

Added CLAUDE_CODE_DISABLE_WEB_FETCH environment variable to turn off the WebFetch tool
Added claude --desktop to open the Claude desktop app on the current directory, or on a session with --continue / --resume <id>
Added claude plugin configure <plugin> to show a plugin's options and which are unset, or save new values read from stdin with --values-stdin
Added <server>.<key>=<value> to claude plugin install --config, so a bundled .mcpb MCP server's own settings can be set at install time and it starts without visiting /plugin → Configure
Added allowedProviders managed setting to limit which API providers a machine may use (Anthropic API, a custom endpoint, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform on AWS, or a Cloud gateway)
Added CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES environment variable to cap re-sends of a non-streaming fallback request that timed out
Fixed claude -p with CLAUDE_CODE_FORK_SUBAGENT=1: a subagent's own Agent call now runs in the foreground, so the subagent gets the child's result
Fixed plugin and marketplace installs and updates over SSH ignoring the ssh program set in GIT_SSH or in your git config's core.sshCommand
Fixed Claude Code refusing to start when the OS denies reading the managed settings file; it now warns and starts without that file's policies. Other read errors and unparseable files stop every session
Fixed cloud sessions that restarted after their conversation was compacted refusing the next update to an artifact the session had already read or published
Fixed claude plugin disable and enable with a full name@marketplace id changing a settings entry in another letter case instead of the installed plugin's own
Fixed files attached to a message sent over Remote Control being left out after a single failed download; a network error, timeout or server error is now retried up to twice
Fixed switching models mid-session with a set_model request (such as the Agent SDK's setModel) leaving the new model on the built-in output-token limit and auto-compact window until restart
Fixed redacted logs and transcripts showing part of a URL password that contains @, or all of it when the URL writes its @ as %40
Fixed SSH passphrase and new-host prompts from worktree and /teleport fetches taking over the terminal; these fetches now fail fast instead of asking
Fixed switching off an MCP server added mid-session in SDK and -p sessions leaving its tools available
Fixed claude -p --permission-prompt-tool: a background subagent's permission request now goes to the prompt tool instead of being auto-denied
Fixed claude mcp list and claude mcp get, and the not-found error of claude mcp remove, login and logout, printing line breaks and terminal escape sequences from MCP server names and values
Fixed sandbox auto-allow asking for approval on every run of many inline scripts (python3 -c, node -e) just because they contain =
Fixed fork subagents not keeping the session's plan mode or dontAsk mode: a fork now runs under its parent's permission mode and cannot exit plan mode
Fixed claude remote-control --help saying --[no-]chrome defaults to the machine's /chrome setting; spawned sessions keep Claude in Chrome off unless --chrome is passed
Fixed background subagents in auto mode prompting a second, redundant reply after each report
Fixed cloud session creation and /remote-env reading only the newest 20 of an account's environments
Fixed Remote Control marking a message as read as soon as it arrived instead of when Claude started on it, and losing a message still queued when the terminal quit (it now arrives on the next resume)
Fixed installing a plugin with claude plugin install or /plugin putting it into an installed plugin's cache or data folder when their ids differ only in ., -, @ or (macOS, Windows) capitals; the install is now refused
Fixed hooks and SDK permission callbacks seeing a missing or outdated plan on ExitPlanMode when the plan was written in the same response
Fixed the first reply in cloud sessions arriving tens of milliseconds late, a regression in 2.1.283
Fixed sessions that authenticate with ANTHROPIC_AUTH_TOKEN against the Anthropic API never loading the organization's policy
Fixed a failed agent(), parallel() or pipeline() call that a workflow script awaits later, or not at all, being treated as an unhandled promise rejection, which could end a background session
Fixed synchronous hooks hanging Claude Code while a background process the hook started (for example some-daemon &) kept its output open; the hook now finishes shortly after its own process exits
Fixed WebFetch reporting a rate-limited domain safety check as a network or enterprise policy block
Fixed the fullscreen ctrl+o transcript freezing briefly when opened on turns with hundreds of file reads or searches; tool calls still running when the transcript opens now show their results when they finish
Fixed Amazon Bedrock mid-stream modelTimeoutException and serviceUnavailableException errors showing a raw JSON body instead of the error message
Fixed /autofix-pr and /schedule saying the Claude GitHub App is not installed on a repository whose install status had not been checked yet
Fixed dismissing a row (x) in /artifacts unlinking its file from the artifact, so publishing the same file again created a new artifact instead of updating it
Fixed Artifact tool publishes after a conversation rewind (Esc Esc) overwriting a file's newer content that Claude had read only in the rewound turns; the publish is now refused until Claude re-reads the file
Fixed an Artifact allow rule ("don't ask again") letting the Artifact tool publish a file outside the working directories without asking; add the file's folder with --add-dir for the rule to cover it
Fixed /cost and SDK modelUsage reporting a turn under the wrong model when the server answered a refusal with a different fallback model than the client expected
Fixed the Artifact tool so that publishing a page no longer lets Claude overwrite its source file without re-reading it when Claude's earlier read was cut short or the file had changed since
Fixed auto mode skipping its classifier for Artifact tool asset uploads and reads of someone else's artifact when you had approved that artifact earlier in another permission mode
Fixed a misleading "core.worktree is set" error from /ultrareview when the project folder briefly could not be read
Fixed /ultrareview on macOS and Linux failing to upload the working tree from a git worktree whose per-worktree config sets core.longpaths
Fixed the Artifact tool sometimes reporting a publish as a conflict with another session after retrying a temporary server error, when the first attempt had actually succeeded
Fixed /ultrareview uploads including uncommitted changes to credential files whose name has a colon before the extension, such as server:8443.key
Fixed a rare auth failure when two sessions recover a login refresh lock left by a crashed process at the same time
Fixed the PowerShell tool's permission check skipping deny and ask rules, and caching that failure for later checks, when its command parser failed to start (for example when the machine was out of memory)
Fixed /ultrareview uploads on macOS and Linux running slowly on some unusual file names, and their credential-file check missing file or folder names with many backup or editor marks
Fixed a cancelled shell command or hook still starting, and running to its end, when the cancel arrived while it was being set up
Fixed vim mode: after editing in the external editor (Ctrl+G), x or r in NORMAL mode no longer breaks a pasted-text placeholder at the end of the prompt
Fixed responses blocked by the API's output content filter being re-sent and retried, sometimes for minutes, instead of showing the filter's error right away
Fixed plugins silently skipping a bundled .mcpb MCP server that still needs configuration: /plugin, the install message and claude plugin install now say so and point to Configure
Fixed compacting or resuming a session failing, opening without its history, or crashing when its saved transcript holds a compaction marker or loop wakeup entry with missing or malformed fields
WSL: Fixed /ultrareview refusing to upload a checkout on a Linux volume when a changed file's name has a colon or ends in a dot or space
Fixed CLAUDE_CODE_RESUME_INTERRUPTED_TURN re-running a turn that had ended at --max-turns
Fixed sign-in that could wait forever after the browser showed success
Windows: Fixed /ultrareview uploading a linked worktree of a repository rooted at your home folder in some cases
Fixed cloud sessions reporting the uploads folder as missing before any file had been uploaded
Fixed a reply sent from claude agents to a background session waiting on a permission prompt sometimes approving the pending command
Fixed claude attach, logs, stop, respawn and rm starting a new session with the command name as its prompt when options came before it, such as from a shell alias
Fixed claude mcp list leaving out WebSocket (ws) MCP servers; each is now listed with its URL and health status
Fixed claude mcp get showing no Type, Command, Args, or Environment for stdio servers whose config entry omits the type field
Fixed .claude/settings.local.json allow rules being held back outside a git repository when git's trace2 output is configured
Fixed the /claude-api eval runner scaffold and report builder writing through a symlink or hard link planted at an output file
Fixed the /claude-api eval runner scaffold counting responses cut off at max_tokens in the score averages; they are now marked truncated and counted separately
Fixed   showing as literal text in the terminal when a reply uses it to indent text, such as row labels in a markdown table
Fixed a brief freeze (up to a second) partway through long sessions outside fullscreen mode, which came back after /clear or /compact
Fixed an approved Edit never going through when its target is a device, such as a file symlinked to /dev/null, and the approval came from the IDE diff view or changed the edit
Fixed a failing API request being retried up to 21 times when streaming kept failing; the non-streaming fallback now shares the request's retry budget instead of getting a fresh set of retries
Improved Claude in Chrome: the native host now reports your computer's name, so connected browsers can be labeled by computer instead of "Browser 1" / "Browser 2"
Improved Bedrock and Vertex AI sessions to switch to an older available model of the same tier, instead of failing, when an admin removes access to the default model; session titles and summaries now fall back with it
Improved plugin marketplace errors to name why a git address is refused instead of citing enterprise policy
Improved validation of git URLs for plugins, marketplaces and the current repository's remote
Improved Artifact tool results: they now suggest publishing in the same step as writing or editing the page, which can save a round trip
Improved Remote Control: a /btw side question asked of a session hosted by an app such as Claude Desktop now sees the turn in progress, not only the last finished one
Improved pictures Claude sends as BMP, HEIC, HEIF, AVIF or TIFF files: the Claude apps now show a preview where Claude Code can convert them
Improved subagents in auto mode: a subagent's run now ends as soon as it hands its report back to its caller, instead of taking extra turns that reach no one
Improved Bedrock and Vertex start-up model checks: models your account cannot use are now remembered for up to a day instead of being re-checked on every launch
Improved Artifact tool publish results to use fewer tokens: the note on updating an artifact is shorter, and where to find your artifacts is no longer repeated after every publish
Improved SDK liveness during a non-streaming fallback request: with partial messages on, a ping stream event is now sent every 30 seconds on the Anthropic API, Claude Platform on AWS and gateways
Improved /resume and claude --resume on a session that is running in the background: they now open that session instead of refusing, and a prompt given with claude --resume <id> "prompt" is sent to it as its next turn
Improved per-turn performance when many permission deny rules and MCP tools are configured
Improved responsiveness when leaving the ctrl+o transcript view in long sessions when fullscreen rendering is off
Improved Bedrock, Vertex and Mantle start-up model checks to send the same User-Agent, x-app and session ID headers as regular requests
Changed MCP tools so a tool that sets its own _meta['anthropic/alwaysLoad'] to false stays deferred when its --mcp-config, Agent SDK or plugin server is set to alwaysLoad
Changed background Bash and PowerShell commands to stop after a time limit (their timeout with run_in_background, default 30 min, max 2 h); Claude is notified when one is stopped
Changed Code Review's pull request reviews and /ultrareview to run when disableWorkflows is on, unless the machine running the review has it set by its own administrator (MDM or the managed-settings file)
Changed sessions behind a custom ANTHROPIC_BASE_URL to use the 1M context window of models that have one (Opus 4.7+, Sonnet 5+, Fable); run /autocompact 200k if your gateway stops at 200K
Changed Team and Enterprise sessions, and sessions whose sign-in plan Claude Code can't determine, to withhold WebFetch until the organization policy loads if it couldn't be loaded at startup
Changed /memory so that Auto-memory can no longer be turned on from a background session or from a session one of Claude Code's own tools started; turning it off there still works
Changed the one-time offer to make auto mode your default permission mode to also show on third-party providers and with telemetry off, when your user settings default to another mode
Changed claude -p and Python Agent SDK sessions on third-party providers or with telemetry off to start in auto mode when no permission mode is configured, like interactive sessions; --permission-mode still overrides it
Changed Bedrock, Mantle and Claude Platform on AWS requests to a base URL with a non-default port to include the port in the SigV4-signed Host header
Changed the MCP server name widgets to be reserved in cloud sessions and on self-hosted runners: your own server under it, or a close spelling such as widgets_, no longer loads, so rename it
Changed /ultrareview on macOS and Linux to leave symbolic refs out when uploading a local checkout; a checkout whose current branch is a symbolic ref is now refused with an explanation
Windows: Changed project and local settings env to no longer set ALLUSERSPROFILE, SystemDrive, or the CommonProgramFiles variables; set them in user or managed settings instead
Changed /tasks to fold background work Claude Code runs for itself under one "System tasks" row; press Enter on it to show those tasks
Changed /ultrareview on macOS and Linux to require git 2.31 or newer to upload a local repository; checkouts made with --separate-git-dir are now refused instead of being uploaded with an older method
Changed /ultrareview uploads on macOS and Linux to send a partial clone as a working-tree snapshot on git 2.31 or newer, instead of falling back or refusing when git's version looked too old
Changed /ultrareview uploads on macOS and Linux to refuse, instead of fetching, a partial clone missing some of its working tree's files on older git versions; a clone made without --filter uploads
Changed Bedrock, Vertex and Mantle start-up model checks to identify themselves as Claude Code, like other Claude Code requests
Changed claude mcp get to hide the command, arguments, and environment values of stdio MCP servers provided by plugins; variable names are still shown
Changed /claude-api so it can no longer be run from Remote Control clients
Changed /config chrome=true to direct you to the /config panel instead of enabling Claude in Chrome by default; /config chrome=false still turns it off when it was on
Changed sandbox settings so project settings cannot widen or turn off an admin-required sandbox, replace the proxy behind a managed deny list, extend a strict allowlist, or reopen managed read-denies
[VSCode] Added a note under a restored tab's last message when a window reload interrupted it and no reply will follow
[VSCode] Added a plugin options form to Manage plugins: installing a plugin that has options asks for the unset ones, and a gear on its row changes them later
[VSCode] Added an on-demand diagnostics tool so Claude in the panel can read the Problems panel's current errors and warnings at any time, not only right after it edits a file
[VSCode] Fixed pressing Enter after typing a slash command running an unrelated menu item picked by fuzzy match, or doing nothing
[VSCode] Fixed an open agent transcript losing the agent's newer messages during a long session
[VSCode] Fixed a message that quotes a Claude Code or IDE tag losing the rest of its text in the chat
[VSCode] Fixed a message sent while Claude was working disappearing from the conversation after the session was reopened
[VSCode] Fixed the session list's Web tab showing the previous account's sessions after an account switch
[VSCode] Fixed restored tabs re-running an interrupted turn when VS Code was started with CLAUDE_CODE_RESUME_INTERRUPTED_TURN set, even with Continue After Reload off
[VSCode] Fixed Escape stopping the running turn instead of closing the command menu after clicking one of its rows
[VSCode] Fixed opening Past conversations replacing a live conversation with its saved copy
[VSCode] Fixed a Claude tab reloaded after an extension restart staying blank instead of saying how to recover
[VSCode] Fixed opening a conversation that is already open in another window or app starting a second copy of it without warning; it now asks first
[VSCode] Fixed a hook's reason for blocking or stopping a prompt disappearing after a window reload
[VSCode] Fixed tabs stuck on a conversation that can't be resumed: the error now says so and offers to start a new conversation
[VSCode] Fixed every file Read, Write and Edit stalling for ten minutes and then being skipped when the editor stops responding to the extension's automatic save before the tool runs
[VSCode] Fixed the agent map labeling a sub-agent with the session's model instead of the model it actually ran on (e.g. under CLAUDE_CODE_SUBAGENT_MODEL_FORCE or an agent's own model)
[VSCode] Fixed uninstalling a plugin from the Manage plugins dialog, which removed the wrong installation or failed for a plugin installed for the project
[VSCode] Fixed sign-in staying on the authorization-code step after going back and choosing the same sign-in method again
[VSCode] Fixed the chat panel stalling when a long session trims its oldest rows
[VSCode] Fixed the conversation disappearing from a session when many agents run
[VSCode] Fixed the editor tab keeping an old name after a session was renamed with /rename, by a SessionStart hook, or on claude.ai
[VSCode] Fixed the agent map's transcript view leaving out messages sent to a running agent
[VSCode] Improved the Manage plugins dialog: a failed plugin action now opens a popup that explains it and, where there is one, offers the fix
[VSCode] Changed the Manage plugins dialog to ask before removing a marketplace or turning off a plugin that your project's shared .claude/settings.json turns on
[Cloud sessions] Fixed Run now on a routine showing internal error text when the run is refused before it starts; it now shows the same explanation as the routine's failure notification
[Cloud sessions] Changed MCP_DISCOVERY_CACHE=1, when set in your cloud environment's variables rather than a settings file, to reuse your connectors' tool lists after a session restart; other MCP servers are no longer cached and connect at startup
[Claude Tag] Added direct messages with Claude for members on an Enterprise plan Standard or Usage-Based Chat seat who also have Cowork; a seat that includes Claude Code is no longer required
[Claude Tag] Fixed the Default model setting in admin settings and a channel's Configure page offering models your organization can't use, which made saves or new sessions fail
[Claude Tag] Fixed the note under Claude's Slack messages saying it answered on a fallback model, and why, disappearing when Claude later edited that message
[Code Review] Fixed the organization menu in Code Review's "Add a repository" dialog showing only a few of your GitHub organizations; it now loads more as you scroll
[Code Review] Improved the Code Review check run to say when your repository's REVIEW.md wasn't applied, for example on a very large pull request or when REVIEW.md is a symbolic link