Claude Code 2.1.285
136changes- Open the Claude desktop app on the current directory or an existing session with claude --desktop.
- Resume a session that's still running in the background instead of being refused.
- Run claude -p and Python Agent SDK sessions on third-party providers or with telemetry off in auto mode by default.
- Fix an Artifact allow rule that let files publish outside the working directories without asking.
- Fix the PowerShell tool's permission check skipping deny and ask rules when its command parser failed to start.
New features
10Add claude --desktop flag
Added claude --desktop to open the Claude desktop app on the current directory, or on a session with --continue / --resume <id>
Add claude plugin configure command
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
[VSCode] Add on-demand diagnostics tool
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
Add CLAUDE_CODE_DISABLE_WEB_FETCH flag
Added CLAUDE_CODE_DISABLE_WEB_FETCH environment variable to turn off the WebFetch tool
More changes (6) Fewer changes
Set MCP server config at plugin install
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
Add allowedProviders managed setting
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)
Cap non-streaming fallback retries
Added CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES environment variable to cap re-sends of a non-streaming fallback request that timed out
[VSCode] Note interrupted replies on reload
Added a note under a restored tab's last message when a window reload interrupted it and no reply will follow
[VSCode] Add plugin options form
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
[Claude Tag] Add DMs for Chat-seat members
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
Improvements
40Open background sessions from /resume
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
Default headless sessions to auto 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
Add a time limit for background commands
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
More changes (37) Fewer changes
Label Chrome browsers by computer name
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"
Fall back to an older model when access is removed
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
Explain why a marketplace git address is refused
Improved plugin marketplace errors to name why a git address is refused instead of citing enterprise policy
Improve git URL validation
Improved validation of git URLs for plugins, marketplaces and the current repository's remote
Suggest publishing alongside Artifact edits
Improved Artifact tool results: they now suggest publishing in the same step as writing or editing the page, which can save a round trip
Show in-progress turns to /btw questions
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
Preview unsupported image formats
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
End subagent runs right after reporting
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
Cache unavailable model checks for a day
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
Shrink Artifact publish result tokens
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
Send periodic pings during fallback requests
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
Speed up turns with many deny rules
Improved per-turn performance when many permission deny rules and MCP tools are configured
Speed up leaving the transcript view
Improved responsiveness when leaving the ctrl+o transcript view in long sessions when fullscreen rendering is off
Match headers on start-up model checks
Improved Bedrock, Vertex and Mantle start-up model checks to send the same User-Agent, x-app and session ID headers as regular requests
Honor per-tool alwaysLoad opt-out
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
Run reviews despite local disableWorkflows
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)
Use 1M context behind custom base URLs
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
Withhold WebFetch until org policy loads
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
Restrict enabling Auto-memory in background
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
Show auto mode offer on more providers
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
Include custom ports in SigV4 signing
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
Reserve the widgets MCP server name
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
Refuse uploads with symbolic ref branches
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
Restrict env overrides for system variables
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
Group internal work under System tasks
Changed /tasks to fold background work Claude Code runs for itself under one "System tasks" row; press Enter on it to show those tasks
Require git 2.31+ for /ultrareview uploads
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
Send partial clones as snapshots on new git
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
Refuse incomplete partial clones on old git
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
Identify start-up model checks as Claude Code
Changed Bedrock, Vertex and Mantle start-up model checks to identify themselves as Claude Code, like other Claude Code requests
Hide plugin MCP server command details
Changed claude mcp get to hide the command, arguments, and environment values of stdio MCP servers provided by plugins; variable names are still shown
Block /claude-api from Remote Control
Changed /claude-api so it can no longer be run from Remote Control clients
Direct chrome=true to the config panel
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
Lock admin sandbox settings from projects
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] Explain failed plugin actions
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] Confirm removing project-enabled plugins
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] Scope MCP_DISCOVERY_CACHE to connectors
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
[Code Review] Report unapplied REVIEW.md
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
Bug fixes
86Fix brief freeze in long sessions
Fixed a brief freeze (up to a second) partway through long sessions outside fullscreen mode, which came back after /clear or /compact
Fix Artifact allow rule outside working dirs
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
Fix fork subagents skipping plan mode
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
Fix auto mode classifier skip for Artifacts
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
Fix PowerShell permission check bypass
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)
Fix agents reply approving pending prompts
Fixed a reply sent from claude agents to a background session waiting on a permission prompt sometimes approving the pending command
Load org policy for ANTHROPIC_AUTH_TOKEN sessions
Fixed sessions that authenticate with ANTHROPIC_AUTH_TOKEN against the Anthropic API never loading the organization's policy
More changes (79) Fewer changes
Fix fork subagent's Agent call result
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
Fix SSH program ignored on plugin installs
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
Start despite unreadable managed settings
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
Fix artifact updates after cloud compaction restart
Fixed cloud sessions that restarted after their conversation was compacted refusing the next update to an artifact the session had already read or published
Fix plugin enable/disable case mismatch
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
Retry Remote Control attachment downloads
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
Fix stale limits after mid-session model switch
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
Fix URL password leaking in redacted logs
Fixed redacted logs and transcripts showing part of a URL password that contains @, or all of it when the URL writes its @ as %40
Stop worktree fetches hijacking the terminal
Fixed SSH passphrase and new-host prompts from worktree and /teleport fetches taking over the terminal; these fetches now fail fast instead of asking
Fix mid-session MCP server tools staying on
Fixed switching off an MCP server added mid-session in SDK and -p sessions leaving its tools available
Route background subagent prompts correctly
Fixed claude -p --permission-prompt-tool: a background subagent's permission request now goes to the prompt tool instead of being auto-denied
Sanitize MCP names in CLI output
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
Fix unneeded prompts for inline scripts
Fixed sandbox auto-allow asking for approval on every run of many inline scripts (python3 -c, node -e) just because they contain =
Fix --chrome help text mismatch
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
Fix redundant auto mode reply prompt
Fixed background subagents in auto mode prompting a second, redundant reply after each report
Fix cloud environment list cap
Fixed cloud session creation and /remote-env reading only the newest 20 of an account's environments
Fix Remote Control read status and lost messages
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)
Refuse plugin installs with confusable ids
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
Fix stale plan seen by ExitPlanMode hooks
Fixed hooks and SDK permission callbacks seeing a missing or outdated plan on ExitPlanMode when the plan was written in the same response
Fix cloud session first-reply delay
Fixed the first reply in cloud sessions arriving tens of milliseconds late, a regression in 2.1.283
Fix unhandled rejection ending workflows
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
Fix hooks hanging on background process output
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
Fix WebFetch rate-limit error message
Fixed WebFetch reporting a rate-limited domain safety check as a network or enterprise policy block
Fix transcript freeze on heavy turns
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
Fix raw JSON shown for Bedrock stream errors
Fixed Amazon Bedrock mid-stream modelTimeoutException and serviceUnavailableException errors showing a raw JSON body instead of the error message
Fix false GitHub App not-installed 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
Fix /artifacts row dismissal unlinking files
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
Refuse stale Artifact publishes after rewind
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
Fix wrong model in cost reporting
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
Require re-read before overwriting Artifact source
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
Fix misleading worktree error in /ultrareview
Fixed a misleading "core.worktree is set" error from /ultrareview when the project folder briefly could not be read
Fix /ultrareview upload with core.longpaths
Fixed /ultrareview on macOS and Linux failing to upload the working tree from a git worktree whose per-worktree config sets core.longpaths
Fix false publish conflict after retry
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
Exclude colon-named credential files from uploads
Fixed /ultrareview uploads including uncommitted changes to credential files whose name has a colon before the extension, such as server:8443.key
Fix rare auth failure on lock recovery
Fixed a rare auth failure when two sessions recover a login refresh lock left by a crashed process at the same time
Speed up /ultrareview uploads on odd filenames
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
Fix cancelled commands still running
Fixed a cancelled shell command or hook still starting, and running to its end, when the cancel arrived while it was being set up
Fix vim NORMAL mode breaking paste placeholder
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
Fix retries after content filter blocks
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
Announce unconfigured bundled MCP servers
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
Fix crash on malformed compaction markers
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
Fix /ultrareview refusal on special filenames
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
Fix resume re-running max-turns limit
Fixed CLAUDE_CODE_RESUME_INTERRUPTED_TURN re-running a turn that had ended at --max-turns
Fix sign-in hanging after browser success
Fixed sign-in that could wait forever after the browser showed success
Fix /ultrareview upload from home-rooted worktrees
Windows: Fixed /ultrareview uploading a linked worktree of a repository rooted at your home folder in some cases
Fix false missing uploads folder
Fixed cloud sessions reporting the uploads folder as missing before any file had been uploaded
Fix agent commands starting sessions on options
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
Show WebSocket servers in mcp list
Fixed claude mcp list leaving out WebSocket (ws) MCP servers; each is now listed with its URL and health status
Show details for stdio servers missing type
Fixed claude mcp get showing no Type, Command, Args, or Environment for stdio servers whose config entry omits the type field
Fix allow rules held back outside git repos
Fixed .claude/settings.local.json allow rules being held back outside a git repository when git's trace2 output is configured
Fix eval runner writing through planted links
Fixed the /claude-api eval runner scaffold and report builder writing through a symlink or hard link planted at an output file
Exclude truncated responses from eval averages
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
Render nbsp instead of showing it literally
Fixed showing as literal text in the terminal when a reply uses it to indent text, such as row labels in a markdown table
Fix approved device-target edits not applying
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
Cap retries shared across streaming fallback
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
[VSCode] Fix Enter on slash commands
Fixed pressing Enter after typing a slash command running an unrelated menu item picked by fuzzy match, or doing nothing
[VSCode] Fix transcript losing new messages
Fixed an open agent transcript losing the agent's newer messages during a long session
[VSCode] Fix tag quotes truncating messages
Fixed a message that quotes a Claude Code or IDE tag losing the rest of its text in the chat
[VSCode] Fix messages disappearing on reopen
Fixed a message sent while Claude was working disappearing from the conversation after the session was reopened
[VSCode] Fix Web tab showing old account sessions
Fixed the session list's Web tab showing the previous account's sessions after an account switch
[VSCode] Fix restored tabs re-running turns
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] Fix Escape stopping turns over menu
Fixed Escape stopping the running turn instead of closing the command menu after clicking one of its rows
[VSCode] Fix Past conversations replacing live chat
Fixed opening Past conversations replacing a live conversation with its saved copy
[VSCode] Explain blank tabs after restart
Fixed a Claude tab reloaded after an extension restart staying blank instead of saying how to recover
[VSCode] Warn before opening a duplicate session
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] Preserve hook block reasons on reload
Fixed a hook's reason for blocking or stopping a prompt disappearing after a window reload
[VSCode] Explain unresumable conversations
Fixed tabs stuck on a conversation that can't be resumed: the error now says so and offers to start a new conversation
[VSCode] Fix file tools stalling on save timeout
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] Fix agent map showing wrong model
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] Fix plugin uninstall targeting wrong copy
Fixed uninstalling a plugin from the Manage plugins dialog, which removed the wrong installation or failed for a plugin installed for the project
[VSCode] Fix sign-in stuck after going back
Fixed sign-in staying on the authorization-code step after going back and choosing the same sign-in method again
[VSCode] Fix chat panel stalling on row trim
Fixed the chat panel stalling when a long session trims its oldest rows
[VSCode] Fix conversation disappearing with many agents
Fixed the conversation disappearing from a session when many agents run
[VSCode] Fix editor tab keeping old session name
Fixed the editor tab keeping an old name after a session was renamed with /rename, by a SessionStart hook, or on claude.ai
[VSCode] Fix transcript hiding sent messages
Fixed the agent map's transcript view leaving out messages sent to a running agent
[Cloud sessions] Fix Run now internal error text
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
[Claude Tag] Fix default model offering unusable models
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] Preserve fallback model note on edits
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] Fix organization menu missing entries
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