Claude Code Updates & Release Notes

• Added requiredMinimumVersion and requiredMaximumVersion managed settings — Claude Code refuses to start if its version is outside the allowed range and directs the user to an approved version

• Added /plugin list command to list installed plugins, with --enabled/--disabled filters

• Added a "c to copy" shortcut to /btw that copies the raw markdown answer to the clipboard, preserving formatting when pasted elsewhere

• Hooks: Stop and SubagentStop hooks can now return hookSpecificOutput.additionalContext to give Claude feedback and keep the turn going without being labeled a hook error

• Skills: added \$ escape syntax to include a literal $ before a digit in command bodies

• stdio MCP servers now receive the same CLAUDE_CODE_SESSION_ID as hooks/Bash on --resume

• Fixed claude -p hanging forever after its final result when a backgrounded command never exits — background shells are now stopped ~5s after the result once stdin closes

• Fixed claude -p failing with "ANTHROPIC_API_KEY required" on Bedrock/Vertex/Foundry when CI=true and no Anthropic API key is set

• Fixed bash commands failing under bazel and EDR-protected Go workflows: $TMPDIR was overridden to /tmp/claude-{uid} for all commands instead of only sandboxed ones (regression in 2.1.154)

• Fixed Bash commands failing on Windows with "EEXIST: file already exists" on the session-env directory when it has the read-only attribute or is inside OneDrive

• Fixed org-managed permission rules not applying for the entire session when the managed settings fetch completed during startup on a fresh config directory

• Fixed background sessions in claude agents losing their running background tasks when reattached after a Claude Code update

• Fixed terminal misalignment and a multi-second hang when exiting the agent view by pressing Esc

• Fixed clicking Stop on a background-task chip in the desktop app not clearing the chip when the underlying process was already gone

• Fixed keyboard input becoming permanently unresponsive after a paste operation whose end marker is dropped by the terminal

• Fixed hook if: "Bash(...)" conditions firing on every Bash command containing $() or $VAR; the pattern now matches against commands inside subshells and backticks too

• Fixed deny rules on home-directory paths (e.g. Read(~/Desktop/**)) not blocking Bash commands that reference the path via $HOME

• Fixed a stray "(no content)" line left in the transcript after closing panel dialogs like /mcp and /plugins

• Background agent sessions now update to a new Claude Code version in the background, so opening a session after an update no longer waits on a cold restart

• Clearer descriptions for built-in commands and skills in the / menu

• The subscription-switch suggestion now shows in the startup announcement slot instead of a toast

• claude agents dispatching from the state-grouped view now starts the session in the directory the agent view was opened from

Original source

Release notes

• claude agents --json now includes waitingFor showing what a waiting session is blocked on (e.g. permission prompt)
• --tools: explicitly listing Grep/Glob now provides the dedicated search tools on native builds with embedded search (previously these names were silently ignored)
• /effort now confirms when your chosen level will persist as the default for new sessions
• Clicking a slash command in the autocomplete menu now fills it into your prompt instead of running it immediately; press Enter to run
• Remote Control now shows as a persistent footer pill (with a link to the session) instead of a startup message
• Renamed Windsurf to Devin Desktop in the /ide menu, /terminal-setup, and /scroll-speed, following the editor's rebrand
• Fixed a silent startup hang when the config directory is read-only or unwritable — Claude Code now starts with in-memory config and surfaces startup errors instead of showing a blank screen
• Fixed WebFetch permission rules not being applied to built-in preapproved domains; explicit WebFetch(domain:...) deny/ask/allow rules now take precedence over the preapproved-host auto-allow
• Fixed Windows permission rules never matching when spelled with backslashes (~\, \\server\share) or case-variant paths, and Read deny rules not hiding files from Glob/Grep results
• Fixed an interrupt (Esc) sent at the very start of a turn being silently dropped in stream-json/SDK sessions, leaving the turn running with no "Interrupted" feedback
• Fixed API 400 no low surrogate in string errors for classifier side-queries and MCP server descriptions containing emoji near a truncation boundary
• Fixed MCP per-server timeout config values below 1000 ms being floored to a 1-second watchdog that aborted every tool call; sub-1000 ms values are now ignored (falling back to MCP_TOOL_TIMEOUT or default), and claude mcp get annotates them accordingly
• Fixed the LSP tool's workspaceSymbol operation returning no results; it now accepts a query parameter and passes it to the language server
• Fixed claude agents cutting live status text (tool args, replies, prompts, exec output) at 60–120 columns on wide terminals; the status detail now uses the full terminal width
• Fixed claude agents truncating long session names at 40 columns; the name column now grows with terminal width
• Fixed claude agents attach occasionally bouncing straight back to the session list on the first try after a background-service restart
• Fixed claude agents Ctrl+V image paste doing nothing in the dispatch input and the session reply box; pasting with no image now shows a hint
• Fixed backgrounding a session with
  silently losing the conversation when the background service cannot start; the session stays in the list as a failed row you can wake with Enter
• Fixed replies from the agents view that fail to send being lost; they are now queued for delivery on the next session start
• Fixed cross-session messaging (SendMessage) silently breaking when CLAUDE_CODE_TMPDIR or $TMPDIR points at a deep directory
• Fixed opening a running background session from claude agents stalling for 5 seconds before attaching
• Quieter startup: notices group by severity, and session info and announcements share a single line per launch
• Startup warnings rewritten to be shorter and clearer, each with a concrete fix
• Launch-prompt warnings (deep link/pre-filled prompt) now stay pinned below the input until you act instead of scrolling away
• Failed turns now show a compact warning line instead of a multi-line red error block
• Improved background service startup and claude update verification to wait out endpoint-security scanning of new binaries instead of failing after 5 seconds
• Background dispatch spawn failures now report the error class name when no errno is available
• Removed the "Claude in Chrome enabled" and "marketplace installed" startup messages; model auto-updates and the team-onboarding tip now show as quiet notices under the logo

Original source

• OTEL_RESOURCE_ATTRIBUTES values are now included as labels on metric datapoints, so you can slice usage metrics by custom dimensions like team or repo
• claude agents rows now show done/total before the detail when work is fanned out; peek shows the longest-running item
• /mcp now collapses claude.ai connectors you've never signed in to behind a "Show unused connectors" row
• Parallel tool calls: a failed Bash command no longer cancels other calls in the same batch 94 each tool returns its own result independently
• Fullscreen mode: clipboard now uses wl-copy/xclip/xsel on Linux when available, copies to both the clipboard and PRIMARY selection for middle-click paste, and the "hold {key} for native selection" hint now shows the correct key per terminal
• Fixed the /effort dialog, workflow animations, and prompt keyword shimmer not honoring the "Reduce motion" setting
• Fixed forceLoginOrgUUID/forceLoginMethod managed-settings policies blocking third-party provider sessions (Bedrock, Vertex, Foundry, Mantle) alongside the org pin (regression in 2.1.146)
• Fixed background subagent output corrupting claude -p stdout when using --output-format text or json
• Fixed /usage-credits starting a re-login for Team and Enterprise admins instead of pointing to the organization's usage settings page
• Fixed /autofix-pr reporting "cannot run on the default branch" when the session is inside a git worktree or another repository
• Fixed --resume picker not showing sessions from the current directory when it isn't a git worktree (e.g., jj workspaces)
• Fixed Windows hooks that invoke bash explicitly (e.g., /usr/bin/bash script.sh) failing with "command not found" or "cannot execute binary file"
• Fixed OpenTelemetry log events (user_prompt, api_request, tool_result, tool_decision) being silently dropped when emitted before telemetry initialization completed
• Fixed claude mcp list/get/add printing secrets to the terminal: ${VAR} references are no longer expanded, and credential headers and URL secrets are redacted
• Fixed Workflow agents spawned with isolation: "worktree" in background sessions being blocked from editing files inside their own worktree
• Fixed background sessions dispatched from claude agents booting on a stale model from the daemon's environment instead of the model in settings.json
• Fixed a potential crash when rendering Write tool results after resuming a session
• Fixed completed subagents getting stuck showing as running when an error occurs while finalizing their result
• Fixed EADDRINUSE errors from tools that bind Unix sockets under $TMPDIR when CLAUDE_CODE_TMPDIR is set to a deep path
• Improved terminal rendering performance by stabilizing the layout engine's JIT compilation profile
• Improved rendering performance for large file writes
• [VSCode] Added a tip suggesting disabling terminal GPU acceleration (or running /terminal-setup) to fix garbled glyphs

Original source

• Added a prompt before writing to shell startup files (.zshenv, .zlogin, .bash_login) and ~/.config/git/, which could otherwise lead to unintended command execution
• acceptEdits mode now prompts before writing build-tool config files that grant code execution (.npmrc, .yarnrc*, bunfig.toml, .bazelrc, .pre-commit-config.yaml, .devcontainer/, etc.)
• Edit no longer requires a separate Read after viewing a file with grep: single-file grep/egrep/fgrep commands now satisfy the read-before-edit check
• Fixed copy-on-select not writing to the Windows clipboard on WSL 94 now uses PowerShell interop instead of OSC 52, which terminals like MobaXterm don't support
• Fixed restoring a completed session from claude agents dropping chat history and re-running the original prompt
• Fixed background sessions re-attached after overnight retire losing their conversation and re-running the original prompt
• Fixed claude --bg occasionally failing with "socket missing" when the background daemon was cold-starting on a loaded machine
• Fixed an issue on Windows where the directory a background session was started in could not be deleted after claude rm until the background daemon exited
• Fixed background agents that resumed work being shown under Completed in the agents list
• Fixed claude agents freezing for several seconds when returning to the session list due to the auto-updater re-checking on every exit
• Fixed Esc, arrow keys, and typing becoming unresponsive on Windows when attached to a background session or in the agent view while the host is under heavy CPU load
• Fixed background agents emitting terminal sync-output markers to terminals that don't support them (Apple Terminal, tmux), causing render artifacts when entering a running agent
• Fixed mouse wheel scrolling prompt history instead of the transcript right after opening a session from the agents list
• Fixed CJK IME composition appearing at the bottom-left of the screen instead of at the input caret in the claude agents view
• Fixed valid file:///C:/... links being rewritten to a broken path on Windows terminals with hyperlink support
• Fixed voice mode failing to connect when the project directory or branch name contains non-ASCII or special characters
• Fixed the auto mode unavailability message on third-party providers (Bedrock/Vertex/Foundry) to point to the CLAUDE_CODE_ENABLE_AUTO_MODE opt-in instead of incorrectly blaming the model
• Fixed /effort ultracode incorrectly blaming the dynamic workflows setting when the model cannot run xhigh; ultracode is no longer offered on models that do not support it
• Fixed model-not-found errors suggesting --model when running via the SDK or other hosts where the CLI flag doesn't apply
• Fixed Claude's past replies disappearing from scrollback when resuming a brief mode session with brief mode turned off
• Fixed vim mode p pasting on the line below instead of at the cursor when the register was yanked with v$
• Improved performance of opening recently-inactive background agent sessions in claude agents
• Improved auto mode classifier latency by reducing reasoning on routine actions, lowering the chance of "could not evaluate this action" blocks
• Improved background-session teardown (claude rm/stop, idle reap) to send SIGTERM to running shell subprocesses before SIGKILL, so cleanup handlers run
• Removed CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE; the environment variable is now a no-op
• Removed the JetBrains plugin install suggestion from startup
• Renamed the dynamic-workflow trigger keyword from workflow to ultracode. The word "workflow" no longer triggers a run; asking for one in your own words still works. The trigger keyword is highlighted in violet in the prompt input

Original source

• OTEL_RESOURCE_ATTRIBUTES values are now included as labels on metric datapoints, so you can slice usage metrics by custom dimensions like team or repo
• claude agents rows now show done/total before the detail when work is fanned out; peek shows the longest-running item
• /mcp now collapses claude.ai connectors you've never signed in to behind a "Show unused connectors" row
• Parallel tool calls: a failed Bash command no longer cancels other calls in the same batch; each tool returns its own result independently
• Fullscreen mode: clipboard now uses wl-copy/xclip/xsel on Linux when available, copies to both the clipboard and PRIMARY selection for middle-click paste, and the "hold {key} for native selection" hint now shows the correct key per terminal
• Fixed the /effort dialog, workflow animations, and prompt keyword shimmer not honoring the "Reduce motion" setting
• Fixed forceLoginOrgUUID/forceLoginMethod managed-settings policies blocking third-party provider sessions (Bedrock, Vertex, Foundry, Mantle) alongside the org pin (regression in 2.1.146)
• Fixed background subagent output corrupting claude -p stdout when using --output-format text or json
• Fixed /usage-credits starting a re-login for Team and Enterprise admins instead of pointing to the organization's usage settings page
• Fixed /autofix-pr reporting "cannot run on the default branch" when the session is inside a git worktree or another repository
• Fixed --resume picker not showing sessions from the current directory when it isn't a git worktree (e.g., jj workspaces)
• Fixed Windows hooks that invoke bash explicitly (e.g., /usr/bin/bash script.sh) failing with "command not found" or "cannot execute binary file"
• Fixed OpenTelemetry log events (user_prompt, api_request, tool_result, tool_decision) being silently dropped when emitted before telemetry initialization completed
• Fixed claude mcp list/get/add printing secrets to the terminal: ${VAR} references are no longer expanded, and credential headers and URL secrets are redacted
• Fixed Workflow agents spawned with isolation: "worktree" in background sessions being blocked from editing files inside their own worktree
• Fixed background sessions dispatched from claude agents booting on a stale model from the daemon's environment instead of the model in settings.json
• Fixed a potential crash when rendering Write tool results after resuming a session
• Fixed completed subagents getting stuck showing as running when an error occurs while finalizing their result
• Fixed EADDRINUSE errors from tools that bind Unix sockets under $TMPDIR when CLAUDE_CODE_TMPDIR is set to a deep path
• Improved terminal rendering performance by stabilizing the layout engine's JIT compilation profile
• Improved rendering performance for large file writes
• [VSCode] Added a tip suggesting disabling terminal GPU acceleration (or running /terminal-setup) to fix garbled glyphs

Original source

• Added a prompt before writing to shell startup files (.zshenv, .zlogin, .bash_login) and ~/.config/git/, which could otherwise lead to unintended command execution
• acceptEdits mode now prompts before writing build-tool config files that grant code execution (.npmrc, .yarnrc*, bunfig.toml, .bazelrc, .pre-commit-config.yaml, .devcontainer/, etc.)
• Edit no longer requires a separate Read after viewing a file with grep: single-file grep/egrep/fgrep commands now satisfy the read-before-edit check
• Fixed copy-on-select not writing to the Windows clipboard on WSL — now uses PowerShell interop instead of OSC 52, which terminals like MobaXterm don't support
• Fixed restoring a completed session from claude agents dropping chat history and re-running the original prompt
• Fixed background sessions re-attached after overnight retire losing their conversation and re-running the original prompt
• Fixed claude --bg occasionally failing with "socket missing" when the background daemon was cold-starting on a loaded machine
• Fixed an issue on Windows where the directory a background session was started in could not be deleted after claude rm until the background daemon exited
• Fixed background agents that resumed work being shown under Completed in the agents list
• Fixed claude agents freezing for several seconds when returning to the session list due to the auto-updater re-checking on every exit
• Fixed Esc, arrow keys, and typing becoming unresponsive on Windows when attached to a background session or in the agent view while the host is under heavy CPU load
• Fixed background agents emitting terminal sync-output markers to terminals that don't support them (Apple Terminal, tmux), causing render artifacts when entering a running agent
• Fixed mouse wheel scrolling prompt history instead of the transcript right after opening a session from the agents list
• Fixed CJK IME composition appearing at the bottom-left of the screen instead of at the input caret in the claude agents view
• Fixed valid file:///C:/... links being rewritten to a broken path on Windows terminals with hyperlink support
• Fixed voice mode failing to connect when the project directory or branch name contains non-ASCII or special characters
• Fixed the auto mode unavailability message on third-party providers (Bedrock/Vertex/Foundry) to point to the CLAUDE_CODE_ENABLE_AUTO_MODE opt-in instead of incorrectly blaming the model
• Fixed /effort ultracode incorrectly blaming the dynamic workflows setting when the model cannot run xhigh; ultracode is no longer offered on models that do not support it
• Fixed model-not-found errors suggesting --model when running via the SDK or other hosts where the CLI flag doesn't apply
• Fixed Claude's past replies disappearing from scrollback when resuming a brief mode session with brief mode turned off
• Fixed vim mode p pasting on the line below instead of at the cursor when the register was yanked with v$
• Improved performance of opening recently-inactive background agent sessions in claude agents
• Improved auto mode classifier latency by reducing reasoning on routine actions, lowering the chance of "could not evaluate this action" blocks
• Improved background-session teardown (claude rm/stop, idle reap) to send SIGTERM to running shell subprocesses before SIGKILL, so cleanup handlers run
• Removed CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE; the environment variable is now a no-op
• Removed the JetBrains plugin install suggestion from startup
• Renamed the dynamic-workflow trigger keyword from workflow to ultracode. The word "workflow" no longer triggers a run; asking for one in your own words still works. The trigger keyword is highlighted in violet in the prompt input

Original source

• Plugins in .claude/skills directories are now automatically loaded, no marketplace required
• Added claude plugin init <name> to scaffold a new plugin in .claude/skills
• Added autocomplete for /plugin arguments: subcommands, installed plugin names, and plugins from known marketplaces
• claude agents: the agent field in settings.json is now honored for dispatched sessions, with --agent <name> to override it
• EnterWorktree can now switch between Claude-managed worktrees mid-session
• tool_decision telemetry events now include tool_parameters (bash commands, MCP/skill names) when OTEL_LOG_TOOL_DETAILS=1
• Worktrees managed by Claude are now left unlocked when the agent finishes, so git worktree remove/prune can clean them up
• Fixed unprocessable images (zero-byte, corrupt) attached via paste, MCP, or dialog crashing the request instead of becoming a text placeholder
• Fixed sandbox network permission prompts appearing in auto and bypass-permissions mode when using the desktop app, IDE extensions, or SDK
• Fixed claude agents completed sessions not retiring when an idle subagent was still parked or had leaked a backgrounded shell
• Fixed claude agents pressing Esc not cancelling a slow "opening…", leaving the list unresponsive
• Fixed background agent worktrees under .claude/worktrees/ being orphaned after the 30-day job retention sweep
• Fixed background sessions re-attached after a sleep/wake not telling the model the correct date
• Fixed copy-on-select in claude agents not reaching the system clipboard inside tmux with set-clipboard on (regression in 2.1.153)
• Fixed --resume not reporting background subagents that were running when the previous Claude Code process exited
• Fixed the --resume session picker leaving its contents on the terminal after exiting in fullscreen mode
• Fixed --worktree and --worktree --tmux returning to the canonical repo root instead of the current linked worktree
• Fixed the /model picker showing an incorrect "Newer version available" hint when the selected model is already the newest in its family; the pinned-model row now shows the model's description instead of its raw ID
• Fixed literal markdown markers (backticks, asterisks) appearing in the in-progress message text in fullscreen mode
• Fixed the terminal freezing after approving the managed-settings security dialog at startup
• Fixed a rare duplicate line appearing in scrollback after the terminal UI redraws
• Fixed right-click paste duplicating the clipboard in the VS Code, Cursor, and Windsurf integrated terminals
• WSL: fixed image paste (alt+v keybinding), screenshot paste on Windows 11, and added support for dragging images from Windows Explorer
• Improved performance of long and resumed conversations by eliminating redundant message-rendering recomputations
• /terminal-setup now disables GPU acceleration in VS Code/Cursor/Windsurf integrated terminals to prevent garbled-text rendering
• The Feature of the Week credit-claim status now appears as a notification in the status area instead of a line above the prompt
• claude agents: slash-command autocomplete in the dispatch input now matches substrings
• Removed the "bash commands will be sandboxed" startup banner — sandbox status still shows in /status and when a command is blocked
• Removed the "/ide for …" startup hint toast
• [IDE] Fixed clicking Stop while a background subagent is running not actually stopping it
• [VSCode] Fixed the fast mode indicator not appearing on Opus 4.8
• Pressing backspace right after a workflow trigger keyword now dismisses the workflow request (same as alt+w) instead of deleting a character
• Added a "Workflow keyword trigger" setting in /config to stop the word "workflow" in a prompt from triggering a dynamic workflow

Original source

Run Claude Code on Claude Opus 4.8, orchestrate large tasks with dynamic workflows, catch security issues with the security-guidance plugin, and use fast mode on Opus 4.8 at a lower price.

Claude Opus 4.8

new model

Opus 4.8 is now the default on Max, Team Premium, Enterprise pay-as-you-go, and the Anthropic API. It defaults to high effort; use /effort xhigh for harder tasks. Requires v2.1.154 or later.

Switch to Opus 4.8 by name, or pick it from the model picker:

/model claude-opus-4-8

Dynamic workflows

research preview

A workflow is an orchestration script Claude writes for your task and runs across many subagents in the background. Use one when a task is too large for one conversation to coordinate: a codebase-wide audit, a large migration, a research question that needs cross-checking. Manage runs with /workflows.

Describe the task and include the word workflow:

create a workflow that migrates every internal fetch() call to the new HttpClient wrapper

Security guidance plugin

plugin

The security-guidance plugin reviews Claude’s code changes for vulnerabilities and fixes them in the same session. It runs a fast pattern check on each edit, a model review at the end of each turn, and a deeper agentic review on commit or push. Add project rules in .claude/claude-security-guidance.md.

Install it from the official Anthropic marketplace:

/plugin install security-guidance@claude-plugins-official

Then activate it in the current session:

/reload-plugins

Fast mode on Opus 4.8

research preview

Fast mode now defaults to Opus 4.8 at $10/$50 per MTok: 2x the standard rate for about 2.5x the speed. Opus 4.7 and 4.6 stay at $30/$150. Opus 4.6 fast mode is deprecated.

Toggle fast mode, now on Opus 4.8:

/fast

Other wins

In claude agents, prefix a shell command with ! to run it as a background job you can attach to and detach from; also available as claude —bg —exec ‘pytest -x’.

Plugins in .claude/skills directories are now loaded automatically, no marketplace required, and claude plugin init scaffolds a new plugin.

New /reload-skills command re-scans skill directories without restarting, and SessionStart hooks can return reloadSkills: true to make skills they install available in the same session.

Skills and commands can set disallowed-tools in frontmatter to remove tools from the model while the skill is active.

New MessageDisplay hook event lets hooks transform or hide assistant message text as it is displayed.

Claude Code now switches to your configured —fallback-model for the rest of the session when the primary model is not found, instead of failing every request.

Plugins can declare defaultEnabled: false in plugin.json or a marketplace entry, so they install without turning on until you enable them.

Vim mode: / in NORMAL mode opens reverse history search, matching Bash and Zsh vi-mode.

Streaming tool execution is now always enabled, including with telemetry disabled and on Bedrock, Vertex, and Foundry.

←← to open the agents view now works on Bedrock, Vertex, Foundry, and with telemetry disabled.

Claude in Chrome: pick which connected browser to use via /chrome → “Select browser…”, or in-chat when a browser action runs with multiple connected.

claude mcp list and claude mcp get now show unapproved .mcp.json servers as pending approval instead of auto-approving and connecting when output is piped.

Original source

Use auto mode on the Pro plan and with Sonnet 4.6, see which skills, subagents, and MCP servers drive your plan limits in /usage, and review diffs with the new /code-review command.

Auto mode on the Pro plan

CLI

Auto mode is now available on the Pro plan and supports Sonnet 4.6 alongside Opus. It replaces permission prompts with background safety checks: routine actions run without interrupting you, and destructive or suspicious ones are blocked and surfaced.

Update Claude Code, then cycle modes with Shift+Tab; auto mode appears once your account meets the requirements:

terminal

Auto mode

Other wins

/usage now shows a per-category breakdown of what’s driving your plan limits, attributing recent usage to skills, subagents, plugins, and individual MCP servers

”Extra usage” is renamed to “usage credits” across the CLI, and /extra-usage is now /usage-credits. The old name still works.

New /code-review command reports correctness bugs at a chosen effort level such as /code-review high, and —comment posts findings as inline GitHub PR comments. /simplify remains as a separate cleanup-only review.

Background sessions now appear in /resume alongside interactive ones, marked with bg, and sessions pinned with Ctrl+T in claude agents stay alive when idle

claude agents —json lists live sessions as JSON for scripting, such as status bars and session pickers

The PowerShell tool is now enabled by default on Windows for Bedrock, Vertex, and Foundry users; opt out with CLAUDE_CODE_USE_POWERSHELL_TOOL=0

claude plugin disable now refuses when another enabled plugin depends on the target, and claude plugin enable force-enables transitive dependencies

The /plugin marketplace browse pane shows projected context cost, and the Discover and Browse screens list a plugin’s commands, agents, skills, hooks, and MCP/LSP servers before installation

New worktree.bgIsolation: “none” setting lets background sessions edit the working copy directly without EnterWorktree, for repos where worktrees are impractical

Markdown output renders GFM task list checkboxes, and the /diff detail view scrolls with the keyboard

Status line JSON input now includes GitHub repo and PR information when detected

Enterprise: the allowAllClaudeAiMcps managed setting loads claude.ai cloud MCP connectors alongside managed-mcp.json

Original source

• Opus 4.8 is here! Now defaults to high effort /effort xhigh for your hardest tasks
• Introducing dynamic workflows: ask Claude to create a workflow and it orchestrates work across tens to hundreds of agents in the background, so you can take on larger, more complex tasks. Run /workflows to view your runs
• Fast mode on Opus 4.8 is now available at a fraction of its previous cost: 2x the standard rate for 2.5x the speed
• The lean system prompt is now the default for all models except Haiku, Sonnet, and Opus 4.7 and earlier
• Claude now reserves the multiple-choice question prompt for decisions it genuinely cannot make itself, instead of asking when it already has enough context to proceed
• /simplify now runs a cleanup-only review (reuse, simplification, efficiency, altitude) and applies the fixes, instead of running the full /code-review --fix bug-hunting review
• Renamed the /effort slider labels from "Speed"/"Intelligence" to "Faster"/"Smarter" for clarity
• claude agents: type ! <command> to run a shell command as a background session you can attach to and detach from. Also available as claude --bg --exec '<command>'
• claude agents: /logout now signs you out instead of being sent to a background session
• 11 to open the agents view now works on Bedrock, Vertex, Foundry, and with telemetry disabled
• Claude in Chrome: pick which connected browser to use via /chrome 1 "Select browser6hellip;", or in-chat when a browser action runs with multiple connected
• Plugins can now declare defaultEnabled: false in plugin.json or a marketplace entry; enable them with /plugin or claude plugin enable. Dependencies of enabled plugins are still enabled automatically
• The /plugin Discover tab now pins plugins whose relevance signals match the current directory with a "suggested for this directory" annotation
• Streaming tool execution is now always enabled, including when telemetry is disabled or on Bedrock/Vertex/Foundry (previously behind a feature flag)
• Stdio MCP server subprocesses now receive CLAUDE_CODE_SESSION_ID and CLAUDECODE=1 in their environment
• claude mcp list/get now show unapproved .mcp.json servers as 3 Pending approval instead of auto-approving and connecting when output is piped
• /remote-control autocomplete now shows "Disconnect Remote Control" when Remote Control is already active
• Added Claude Opus 4.8 support and 4.7 1 4.8 migration guidance to the /claude-api skill
• Deprecated CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE (will be removed on 06/01). To use fast mode on Opus 4.6, switch with /model claude-opus-4-6[1m] and then /fast on
• Improved the auto-mode classifier's detection of data exfiltration, particularly bulk transfers of repository contents
• Fixed rm -rf $HOME not being blocked as a dangerous path when HOME has a trailing slash
• Fixed $TMPDIR resolving to different directories in sandboxed vs unsandboxed Bash commands within the same session
• Fixed unreadable highlighted-row text in claude agents when the Claude Code theme doesn't match the terminal background
• Fixed background-agent completion notifications triggering premature "out of context" behavior on some 1M-context models
• Fixed background-session classifier losing the user's goal when a scheduled /command fires
• Fixed pinned background sessions respawning every minute after a Claude Code update, causing repeated agent-start notifications and process churn at idle
• Fixed background sessions stuck at "blocked", "running", or "working" not retiring after the idle grace period
• Fixed subagents in background sessions bypassing the worktree-isolation guard and writing to the shared checkout
• Fixed orphaned claude --bg-pty-host processes spinning at 100% CPU after the daemon exits on macOS
• Fixed number key shortcuts not working for options shown below the divider in option dialogs
• Fixed worktree.baseRef: "head" resolving to the main checkout's HEAD instead of the current worktree's HEAD when spawning subagents or calling EnterWorktree from inside a linked worktree
• Fixed a stray leading space on wrapped lines when the previous line ended exactly at the terminal width
• Fixed intermittent terminal rendering corruption in VS Code by capping the number of distinct colors the thinking spinner produces
• Fixed plan file names including [Image #N] / [Pasted text #N] placeholders when a plan-mode prompt starts with pasted images or text
• Fixed a phantom expand/click affordance on colored tool output: short ANSI-colored lines that fit on screen no longer show a "ctrl+o to expand" hint
• Fixed a single invalid allowedMcpServers/deniedMcpServers entry in managed settings discarding all managed-settings policy; the bad entry is now dropped with a claude doctor warning
• Fixed API 400 errors on models that don't support the effort parameter when CLAUDE_CODE_ALWAYS_ENABLE_EFFORT is set
• Windows: Fixed update failures caused by claude.exe being in use showing a generic error instead of telling you to close other sessions and retry
• Removed the stale "& for background" hint from the shortcuts help panel
• [VSCode] Auto mode no longer requires the bypass-permissions setting to appear in the mode picker, and a dismissable notice on the new-session screen explains auto mode the first time it's active
• Fixed the task panel below the prompt showing a stray unselectable "main" row when only a workflow is running
• Fixed /mcp tools list and tool detail rendering when MCP servers have long or multi-line tool names or long descriptions
• Fixed the /model picker not showing fast mode pricing on the Default option for API (pay-as-you-go) users when fast mode is on
• Fixed auto mode incorrectly blocking actions with "could not evaluate this action" when the safety classifier ran out of output tokens while reasoning

Original source

• Opus 4.8 is here! Now defaults to high effort · /effort xhigh for your hardest tasks
• Introducing dynamic workflows: ask Claude to create a workflow and it orchestrates work across tens to hundreds of agents in the background, so you can take on larger, more complex tasks. Run /workflows to view your runs
• Fast mode on Opus 4.8 is now available at a fraction of its previous cost: 2x the standard rate for 2.5x the speed
• The lean system prompt is now the default for all models except Haiku, Sonnet, and Opus 4.7 and earlier
• Claude now reserves the multiple-choice question prompt for decisions it genuinely cannot make itself, instead of asking when it already has enough context to proceed
• /simplify now runs a cleanup-only review (reuse, simplification, efficiency, altitude) and applies the fixes, instead of running the full /code-review --fix bug-hunting review
• Renamed the /effort slider labels from "Speed"/"Intelligence" to "Faster"/"Smarter" for clarity
• claude agents: type ! <command> to run a shell command as a background session you can attach to and detach from. Also available as claude --bg --exec '<command>'
• claude agents: /logout now signs you out instead of being sent to a background session
• ←← to open the agents view now works on Bedrock, Vertex, Foundry, and with telemetry disabled
• Claude in Chrome: pick which connected browser to use via /chrome → "Select browser…", or in-chat when a browser action runs with multiple connected
• Plugins can now declare defaultEnabled: false in plugin.json or a marketplace entry; enable them with /plugin or claude plugin enable. Dependencies of enabled plugins are still enabled automatically
• The /plugin Discover tab now pins plugins whose relevance signals match the current directory with a "suggested for this directory" annotation
• Streaming tool execution is now always enabled, including when telemetry is disabled or on Bedrock/Vertex/Foundry (previously behind a feature flag)
• Stdio MCP server subprocesses now receive CLAUDE_CODE_SESSION_ID and CLAUDECODE=1 in their environment
• claude mcp list/get now show unapproved .mcp.json servers as ⏸ Pending approval instead of auto-approving and connecting when output is piped
• /remote-control autocomplete now shows "Disconnect Remote Control" when Remote Control is already active
• Added Claude Opus 4.8 support and 4.7 → 4.8 migration guidance to the /claude-api skill
• Deprecated CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE (will be removed on 06/01). To use fast mode on Opus 4.6, switch with /model claude-opus-4-6[1m] and then /fast on
• Improved the auto-mode classifier's detection of data exfiltration, particularly bulk transfers of repository contents
• Fixed rm -rf $HOME not being blocked as a dangerous path when HOME has a trailing slash
• Fixed $TMPDIR resolving to different directories in sandboxed vs unsandboxed Bash commands within the same session
• Fixed unreadable highlighted-row text in claude agents when the Claude Code theme doesn't match the terminal background
• Fixed background-agent completion notifications triggering premature "out of context" behavior on some 1M-context models
• Fixed background-session classifier losing the user's goal when a scheduled /command fires
• Fixed pinned background sessions respawning every minute after a Claude Code update, causing repeated agent-start notifications and process churn at idle
• Fixed background sessions stuck at "blocked", "running", or "working" not retiring after the idle grace period
• Fixed subagents in background sessions bypassing the worktree-isolation guard and writing to the shared checkout
• Fixed orphaned claude --bg-pty-host processes spinning at 100% CPU after the daemon exits on macOS
• Fixed number key shortcuts not working for options shown below the divider in option dialogs
• Fixed worktree.baseRef: "head" resolving to the main checkout's HEAD instead of the current worktree's HEAD when spawning subagents or calling EnterWorktree from inside a linked worktree
• Fixed a stray leading space on wrapped lines when the previous line ended exactly at the terminal width
• Fixed intermittent terminal rendering corruption in VS Code by capping the number of distinct colors the thinking spinner produces
• Fixed plan file names including [Image #N] / [Pasted text #N] placeholders when a plan-mode prompt starts with pasted images or text
• Fixed a phantom expand/click affordance on colored tool output: short ANSI-colored lines that fit on screen no longer show a "ctrl+o to expand" hint
• Fixed a single invalid allowedMcpServers/deniedMcpServers entry in managed settings discarding all managed-settings policy; the bad entry is now dropped with a claude doctor warning
• Fixed API 400 errors on models that don't support the effort parameter when CLAUDE_CODE_ALWAYS_ENABLE_EFFORT is set
• Windows: Fixed update failures caused by claude.exe being in use showing a generic error instead of telling you to close other sessions and retry
• Removed the stale "& for background" hint from the shortcuts help panel
• [VSCode] Auto mode no longer requires the bypass-permissions setting to appear in the mode picker, and a dismissable notice on the new-session screen explains auto mode the first time it's active
• Fixed the task panel below the prompt showing a stray unselectable "main" row when only a workflow is running
• Fixed /mcp tools list and tool detail rendering when MCP servers have long or multi-line tool names or long descriptions
• Fixed the /model picker not showing fast mode pricing on the Default option for API (pay-as-you-go) users when fast mode is on
• Fixed auto mode incorrectly blocking actions with "could not evaluate this action" when the safety classifier ran out of output tokens while reasoning

Original source

• Added skipLfs option to github/git plugin marketplace sources to skip Git LFS downloads during clone and update
• Claude Code now shows a one-time notice when your npm global install can't auto-update; /doctor lists the fixes
• Status line commands now receive COLUMNS and LINES environment variables so scripts can size output to the terminal width
• claude agents: autocomplete in the dispatch input now suggests native slash commands and bundled skills, not just project skills
• claude agents: PR column now shows PR #N for a single PR or N PRs for multiple
• claude doctor now shows the result of your last update attempt
• Combined the separate "needs authentication" startup notifications for MCP servers and connectors into a single message
• macOS: background agents now appear as "Claude Code" in Privacy & Security and keep their permission grants across upgrades
• Fixed stateful MCP servers without the optional GET SSE stream reconnect-looping on tools/list (regression in v2.1.147)
• Fixed a regression where a custom API gateway could receive the user's Anthropic OAuth credential instead of the gateway's own token
• Fixed subagent (Agent tool) frontmatter MCP servers ignoring --strict-mcp-config, --bare, remote mode, enterprise managed MCP config, and managed-settings MCP server allow/deny policies
• --strict-mcp-config no longer strips inline mcpServers from explicitly-passed agent definitions (--agents / SDK agents), and blocked subagent MCP servers now surface a visible warning
• Fixed the Windows PowerShell installer reporting "Installation complete!" when installation actually failed
• Fixed claude update installing the latest version instead of the configured release channel's version for npm installations
• Fixed excessive memory usage (multiple GB) when resuming a session by transcript file path on machines with many stored sessions
• Fixed claude agents and claude --bg running on a stale daemon started before binary-takeover support, even after upgrading
• Fixed a hang where the CLI could fail to exit when stdin was closed without EOF in stream-json mode, leaving a stale session marker behind
• Fixed malformed file:// links in Claude's responses not being clickable in the terminal
• Fixed claude --help rendering unwrapped output on terminals narrower than 92 columns
• Fixed MCP tool progress notifications not rendering in the collapsed tool view
• Fixed Agent tool with subagent_type: 'claude' running in an undocumented temporary worktree, which could silently discard outputs written to gitignored paths
• /bg while Claude is responding now continues the response in the background session instead of dropping it
• Fixed /btw keyboard shortcuts becoming unresponsive in background sessions while a task is running
• Fixed background sessions writing temp files to $CLAUDE_JOB_DIR triggering a "sensitive file" permission prompt
• Fixed recovering a background agent whose working directory was deleted showing a truncated stack trace instead of a clear error message
• Fixed EnterWorktree not being available immediately in background sessions (previously required ToolSearch first)
• Fixed cmd+k in iTerm2/Terminal.app not repainting attached background sessions
• Fixed the IME candidate window appearing at the bottom of the screen instead of next to the input caret in attached background sessions on Windows
• Fixed background-color bleed when attaching to a background agent from 256-color-only terminals after the agent had rendered file diffs
• Fixed /copy and copy-on-select silently failing to update the system clipboard when attached to a background session inside tmux
• Fixed opening claude agents with Remote Control enabled leaving zombie session entries on the Code tab after exiting
• Fixed /rename in background sessions not updating the session banner immediately
• Fixed Windows update rollback: if a Windows update fails, Claude Code now restores the original executable by copy and tells you how to recover
• [VSCode] Fixed Claude Code processes not shutting down cleanly when VS Code closed on Windows, causing false "unclean exit" reports and orphaned MCP servers
• /model now saves your selection as the default for new sessions (matching the IDE). Press s in the picker to switch models for the current session only.
• If you customized the modelPicker:setAsDefault keybinding, rename it to modelPicker:thisSessionOnly in keybindings.json (the d action was replaced by s)

Original source