Claude Code 学习站

更新动态

从 npm + GitHub 同步官方发布,AI 提炼中文亮点。最近同步:3 小时前 · 100 个版本,83 个已生成中文摘要。

最近 12 个版本

v2.1.316Latest2026/10/31 · 2 天前
中文摘要待生成,可查看官方原文 ↓
官方原文
## 2.1.316

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

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

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

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

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

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

常规修复与稳定性改进

本版本为常规 bug 修复与稳定性改进,官方未列出具体条目。

官方原文
## 2.1.308

- Bug fixes and reliability improvements
v2.1.3072026/10/22 · 11 天前
中文摘要待生成,可查看官方原文 ↓
官方原文
## 2.1.307

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

- Fixed `claude -p` inside cloud sessions reporting "Not logged in" when started without the session's environment variables
- Fixed an API error being replaced by "prompt is too long", and an unneeded compaction, in sessions with many MCP tools
v2.1.3052026/10/21 · 12 天前
中文摘要待生成,可查看官方原文 ↓
官方原文
## 2.1.305

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

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

无具体条目的维护版,集中修缺陷、提稳定性

稳定性加固
亮点
  • 官方 changelog 只写了 "Bug fixes and reliability improvements",未列出具体修复项,无法提炼更细的特性或修复点(原文仅此一条,未达 3-6 条)。
展开官方原文 ↓
## 2.1.303

- Bug fixes and reliability improvements

历史版本(88 个)

v2.1.300-3093 个版本 · 1 已摘要
v2.1.302默认值大调整:fork 子代理默认开启,第三方 -p 不再默认 auto 模式破坏性
  • 新增 CLAUDE_CODE_AUTO_MODE_MODEL,可单独指定客户端 auto mode 分类器使用的模型;服务端 auto mode 不受影响。
  • /config 新增 Idle compaction 开关,可随时关闭或重新开启空闲压缩;压缩后的提示也会说明如何关闭。
  • 修复会话中途新增的工具经 ToolSearch 或压缩后重新加载时的 prompt cache miss,减少重复计费。
  • 插件较多时启动更快:插件命令和 agent 文件加载时的文件系统调用大幅减少,Windows 上提升最明显。Windows 用户
  • Read 工具不再把任意大小的图片整体读入内存,图片源超过 128 MB 会被直接拒绝。
  • 修复 prompt suggestions 在按积分计费的模型上消耗积分的问题:若上一条回复已计入积分,则跳过建议。
破坏性变化
  • fork 子代理(subagent_type: "fork")在 claude -p、Agent SDK、桌面端和 VS Code 中默认开启(终端中原本即如此)。↳ 升级后:不希望使用的话设置环境变量 CLAUDE_CODE_FORK_SUBAGENT=0;claude mcp serve 从不提供 fork 子代理。
  • 第三方 provider 上,未指定权限模式的 claude -p 和 Agent SDK 会话改为 default 模式而非 auto;遥测关闭或全新安装时生效。↳ 升级后:依赖 auto 模式的调用需显式传入 --permission-mode auto。
  • 桌面端和 VS Code 中主会话的子代理总是在后台运行;在 claude -p、Agent SDK、桌面端和 VS Code 中,子代理自身发起的 Agent 调用默认改为前台运行。↳ 升级后:依赖原有后台/阻塞行为的脚本或 SDK 调用需检查等待逻辑;changelog 未提供对应开关,如需回退请查阅官方文档。
v2.1.301无公开发布说明
v2.1.300无公开发布说明
v2.1.290-2996 个版本 · 6 已摘要
v2.1.299收紧 MCP 规则与 hook 时机语义,并批量修复边角稳定性问题破坏性
  • 新增 CLAUDE_CODE_DISABLE_FILE_MENTIONS:@ 文件提及只把路径交给 Claude,由它用文件工具自行读取,而不是直接注入内容。
  • 终端空闲压缩:200K+ token 的会话空闲约 54 分钟后自动压缩,赶在一小时提示缓存过期前完成,下一条消息不再整段重算。可用 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS 调阈值,或在 settings.json 设 "idleCompaction": false 关闭(需 v2.1.290+)。
  • agent 视图内可直接用 /effort 和 /fast 设定新会话的默认值;裸 /model、/effort、/fast 会打开选择器。
  • /usage 新增对 max effort、workflow、常驻上下文和超大工具结果的提醒,便于定位 token 消耗来源。
  • mod 的 prompt.submit hook 现可读取提示词中附带的图片或文档字节(需 managed settings 安装的 mod),并可通过 $.session.identity() 获取登录方式与组织信息。插件作者
破坏性变化
  • MCP allow 规则由子串/前缀匹配改为精确匹配:mcp__a 不再放行名为 a__b 或 a_ 的服务器;deny 与 ask 规则中名称含双下划线的服务器也按完整名生效。Agent 的 tools: 列表同理,只接受所列服务器的工具。↳ 升级后:将规则改为 mcp__<服务器完整规范化名>__*,例如含 __ 的服务器写成 mcp__<完整名>__*;检查 settings 与 agent 定义中的 MCP 规则。
  • UserPromptSubmit hook 改为在 skill 或自定义斜杠命令展开之前运行,因此 hook 拦截提示后,其内嵌的 shell 命令也会被一并阻止。skill frontmatter 中声明的 UserPromptSubmit hook 改为从调用该 skill 之后的下一条提示才开始生效。↳ 升级后:若 hook 依赖原始提示展开后的内容,需按展开前的文本重新适配;若 skill 自带的 hook 需在当前这条提示就生效,需改为在 settings 中配置。
  • 文件名或目录名含隐藏字符、方向控制字符、空白类字符或 < > 的 skill 与命令不再加载;其 frontmatter 中的 name: 也会被忽略,且不会报错提示。↳ 升级后:升级后用 /reload-skills 核对技能列表,将相关文件或目录重命名为普通字符后再使用。
v2.1.296托管策略与 hook 语义收紧,顺带修补大量边角问题破坏性
  • managed.policies[] 新增 code 键,设置与 cli 相同并同时作用于 Claude Desktop 的 Code 标签页;与 desktop 并列时开启 Desktop 网关模式。企业管理员
  • subagent frontmatter 与 --agents 定义新增 autoCompactWindow,可让子 agent 比主会话更早自动压缩上下文。
  • 新增 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL,可让 workflow 中所有 agent 统一使用一个模型,其他 subagent 保持各自模型。
  • Read 工具新增 allow_large 选项,在上下文有余量时可一次读取超过常规大小限制的文本文件。
  • 新增 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS,可为 529 过载请求的退避重试设置更长的最大延迟。
  • 修复托管 PreToolUse hook 用 "continue": false 拒绝工具调用时会结束整轮的问题,现在只拒绝该次调用、不终止 turn。hook 用户
破坏性变化
  • 切换到后台(←)时,正在进行的 turn 或 ! 命令会被直接停止,不再在后台静默跑完。↳ 升级后:如需长任务在后台完成,请在切换前等待其结束,或改用其他方式保持运行。
  • MCP 工具描述及服务端 instructions 发送的默认上限由 2,048 字符提高到 4,096 字符,默认会发送更多内容。↳ 升级后:上下文占用会相应增加;若对上下文敏感,可精简 MCP server 的描述与 instructions。
  • /cost、状态栏、--max-budget-usd 与 SDK 费用统计中,Sonnet 5.5 缓存读取单价由 $0.20 降为 $0.10 每百万 token,费用数字变低,同样的预算可消耗更多 token 才触发上限。↳ 升级后:依赖 --max-budget-usd 做成本控制的脚本或 CI,请按新单价重新核算预算阈值。
v2.1.295hook 失败可改为阻断,gateway 与 MCP 连接层同步加固破坏性
  • command 与 HTTP hook 新增 onFailure: "block":hook 启动失败、超时或异常退出时阻断操作,而不是放行,适合安全守卫类 hook。hook 用户
  • 远程 MCP 在 headless 与 SDK 会话中断线后会退避重连(最长 30 秒),不再在断线后紧循环重连;重复游标的分页不再每次连接都反复请求 20 次。SDK 用户
  • Claude apps gateway 新增 timeouts.upstream_ttfb_ms,限制 Bedrock、Vertex、Foundry 等上游开始出流的时间,超时即故障转移或返回 502;每个上游还可配 models 列表,仅发送列出的模型(支持 * 通配)。企业 gateway 用户
  • claude -p 在后台任务触发新一轮时不再丢失前面的文本输出,每轮结束时打印该轮回复;在终端中保持打开时,stderr 会提示它在等待什么。CI 用户
  • 支持 OSC 7501 Program Status Protocol 的终端可显示 Claude Code 当前是在工作、等待你操作还是已完成。终端用户
破坏性变化
  • claude.ai connectors 在未获取 flags 的安装上默认协商 MCP 协议版本 2026-07-28。↳ 升级后:若所连 MCP 服务不兼容新协议,设置环境变量 MCP_PROTOCOL_NEGOTIATION=legacy 回退到旧协商方式。
  • Claude apps gateway 的后台请求改用 Haiku 4.5 而非会话所用模型;仅当 gateway 不提供 Haiku 4.5 时才回退到会话模型。↳ 升级后:升级后核对账单与审计日志中的后台请求模型;如需固定模型,检查 gateway 的 models 配置。
  • 空闲提示符下,对 attached 后台会话按 Ctrl+C 不再停止待执行的 /loop 唤醒,连按两次只会 detach,循环继续运行。↳ 升级后:要停止 /loop,改按 Esc。
v2.1.293消息不丢、权限更清、子代理更稳破坏性
  • 修复工作流会话中 SendMessage 权限被移除时无法继续通信的问题;新增 mock.session 让测试能读取追加的会话行
  • 修复子代理不能正确识别 SendMessage 等工具真实状态的问题(权限或工具列表隐藏时被误认为全局禁用)
  • 修复后台移动(←)时消息丢失,以及云会话流式响应中断现象
  • Claude Haiku 5.5 发布并成为默认模型,百万上下文支持,100K+ tokens 按 5 倍溢价计费
  • 脚本 API 增强:新增 agentType 识别自定义代理类型,isDeferred 控制工具 schema 延迟加载
  • 修复权限系统中技能描述编辑、工具列表移除、设置文件作用域等多处权限链路问题
破坏性变化
  • 云会话容器重启后,待处理的 /loop 或定时任务不再被唤醒通知,会话保持休眠↳ 升级后:关键的 /loop 工作流应考虑外部监控或手动恢复机制
v2.1.292权限隔离强化与系统稳定性全面加固破坏性
  • plugin install 新增 --marketplace 参数,自动添加并从指定 marketplace 安装插件
  • Agent tool 支持 effort 参数,可指定子代理的计算强度级别
  • $.model.complete 支持 prompt caching:prompt 和 system 参数可缓存,降低 token 消耗
  • 新增 prompt.autocomplete hook 事件,mod 可自定义提示框的自动完成项
  • workflow agents 集成到 agent.spawn hook,mod 可选择拒绝工作流代理的生成
  • 权限隔离全面强化:修复 PreToolUse 权限绕过、UNC 路径权限检查、网络文件读取权限等安全漏洞
破坏性变化
  • 本地 stdio MCP server 默认协商协议版本 2026-07-28,旧版 server 可能连接失败↳ 升级后:设置环境变量 MCP_PROTOCOL_NEGOTIATION=legacy 以兼容旧协议
  • claude plugin test 中失败的 expect 现在导致测试失败,不再静默通过↳ 升级后:审查现有 plugin test,修复依赖静默通过行为的测试用例
  • 名称长度限制 256 字符:agent 名称被拒绝,skill/plugin 名称被忽视↳ 升级后:检查现有名称,缩短超过 256 字符的部分
v2.1.291修复权限提示与会话消息的回归问题
  • 修复 cloud sessions 权限提示答案被丢弃的回归(2.1.290 引入)
  • 修复会话退出时最后消息丢失的回归(2.1.288 引入)
v2.1.280-28910 个版本 · 10 已摘要
v2.1.289权限规则与插件稳定性修复
  • 修复 Bash deny/ask 规则在环境变量前缀和变量赋值前的命令中失效的问题
  • 修复从本地文件夹安装的插件显示过期副本,升级后首次未加载,以及符号链接热加载失效插件作者
  • 修复会话因插件渲染异常或异步异常导致的冻结、强退和界面错误插件用户
  • 提升大文件在插件代码面板中打开的速度
  • 新增 agent.spawn for teammates,支持在 plugin 钩子中统一 agent id,以及 idle/waiting 状态
  • [VSCode] 修复 claude auth status 导致登出频率过高的问题VSCode 用户
v2.1.288Session 恢复与流式处理的大量修复,加固整体稳定性破坏性
  • Session 恢复大幅改进:修复超时后继续流式输出、Ctrl+C 清空提示词后可恢复草稿、断网重连保留上下文等多项问题CI 和自动化用户
  • 新增 --max-findings 参数控制 /code-review 返回的问题数量,可指定具体数值或 all,选择会被记住直到重置
  • 新增 $.ui.selection() 方法供 mod 访问用户在全屏模式下的选中文本和所在行信息mod 开发者
  • Ctrl+F 快速按名称查找 Session,Alt+↑/↓ 在 Agent 分组间快速跳转,都可在 keybindings.json 中自定义
  • MCP 工具、Plugin hooks 及无人值守会话的稳定性全面改进,修复重复执行、文件访问错误、超时挂起等多项问题
破坏性变化
  • 后台命令时间限制现在仅在无人值守会话(-p、Agent SDK、CI、cloud)中生效,终端/桌面/VS Code 会话无时间限制↳ 升级后:依赖超时保护的 CI 脚本需要添加显式的超时控制或调整期望行为
  • 自动压缩窗口现在按模型分别保存,切换模型时不再共享同一设置↳ 升级后:如果需要所有模型使用相同的自动压缩策略,需要在每个模型上重新配置 /autocompact
  • 危险 rm 命令(如 rm / 或 rm ~)在 bash -c 脚本和 allow rule 下现在需要确认,而非无提示执行↳ 升级后:自动化脚本需要处理新的交互提示,或明确在权限设置中允许该操作
v2.1.287Claude Mods 重塑插件定制,稳定性与模型能力全面升级破坏性
  • 引入 Claude Mods,插件可修改更深层系统行为,拓展定制空间插件作者
  • 新增"You should know"内置智能监督,后台标记工作中容易遗漏的问题
  • Opus/Sonnet/Fable 默认启用 1M 上下文窗口,模型推理能力显著提升
  • Agent 视图增强搜索:n: 过滤器支持会话名称和任务的模糊匹配,导航更高效
  • MCP 协议支持 URL prompts,改进服务器认证和用户交互流程MCP 服务器作者
  • 修复百余项稳定性问题,涵盖权限、屏幕阅读、多平台和云会话等场景
破坏性变化
  • MCP 协议升级至 2025-11-25;不兼容的服务器升级后可能无法连接↳ 升级后:若 MCP 服务器连接失败,检查是否需要升级;或在其配置中添加 "bareElicitationCapability": true 以保持兼容
  • Opus 4.7+/Fable 在 Bedrock/Vertex/Foundry 上默认使用 1M 上下文(之前 200K),可能影响成本与模型行为↳ 升级后:如需保持 200K 上下文,设置环境变量 CLAUDE_CODE_DISABLE_1M_CONTEXT=1
v2.1.286修复认证重复登录、会话崩溃丢失数据、API 拒绝处理,列表导航和权限 UI 优化破坏性
  • 权限提示栏添加计数显示(如 "2 of 5"),多请求堆叠时便于批量确认
  • 全屏列表鼠标支持:点击 "N more" 行快速跳转,新增可点击的滚动条箭头
  • 修复 --resume 会话在并行工具调用后崩溃恢复时丢失后续 turn 的数据丢失 bug
  • 修复 GCP/AWS 认证过期时多个 Claude Code 进程和 IDE 扩展重复打开登录窗口
  • VSCode 扩展新增书签功能保存回复,问题卡片显示选项预览和对话问题历史记录VSCode 用户
  • /hooks 命令简化为按事件分组的单层列表,查看配置无需多层导航
破坏性变化
  • --bare 标志行为改变:仅连接命令行指定的 MCP 服务器,不发送系统提醒、不启动后台任务;超时 shell 命令改为停止而非移到后台↳ 升级后:检查依赖 --bare 的脚本,如需后台任务或系统提醒需调整脚本逻辑
  • Theme picker 和 output style picker 不再支持数字键选择,改为滚动列表导航↳ 升级后:改用上下箭头键导航,更新任何依赖数字键快捷方式的自动化配置
  • Plugin 安装严格限制源类型:拒绝 npm git 仓库和本地文件夹源,仅接受 registry 包↳ 升级后:更新 plugin 配置,改用 registry 源而非 git 仓库或本地路径
v2.1.285插件配置、权限管理与云端操作多重完善破坏性
  • 插件安装支持直接配置 MCP server 参数(<server>.<key>=<value>),无需额外操作;新增 claude plugin configure <plugin> 命令查看和修改选项
  • 新增 allowedProviders 设置限制 API 供应商(Anthropic/Bedrock/Vertex 等),增强企业安全管理能力
  • 新增 CLAUDE_CODE_DISABLE_WEB_FETCH 环境变量关闭 WebFetch;CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES 控制超时重试次数
  • 修复 /ultrareview 的 SSH 密钥提示阻塞、WSL 文件路径、凭证文件检查等多项跨平台问题,强化自动化稳定性CI 用户
  • 新增 claude --desktop 命令,支持在 Desktop 应用中打开当前目录或继续指定会话
  • 修复 artifact 重新发布覆盖、cloud session 对话压缩后的引用丢失、Remote Control 消息处理等问题,强化发布和会话持久性
破坏性变化
  • MCP server 名称 widgets 在云端会话和自托管运行器上现为保留名,现有的 widgets server 将无法加载↳ 升级后:将自定义 widgets server 重命名为 widgets_ 或其他名称
  • 后台 Bash 和 PowerShell 命令现会在超时后自动停止(默认 30 分钟,最大 2 小时),旧有的长时间运行命令会被中断↳ 升级后:长于 30 分钟的自动化脚本需调整流程或迁移至系统任务调度器
  • macOS 和 Linux 上 /ultrareview 现要求 git 2.31+;使用 --separate-git-dir 创建的检出不再支持上传↳ 升级后:升级 git 至 2.31+;迁移 --separate-git-dir 创建的仓库至标准检出方式
v2.1.284Sonnet 5.5 成默认、Ultracode 独立切换、网关和集成普遍加固破坏性
  • Claude Sonnet 5.5 成默认 Sonnet 模型,支持 1M 上下文,价格降至 $2/$10 每百万词元。
  • Ultracode 从 effort 中独立成开关,可在任意 effort 级别启用,用 Tab 或 /effort ultracode on/off 控制。
  • 修复响应流损坏问题,不再显示"JSON Parse error"等原始错误;过载和故障现在自动重试。
  • 新增 /mcp reconnect all 命令,支持一次重连所有异常 MCP 服务器;修复连接等待超时等问题。
  • 权限流程新增'是的,但下次再问'选项,允许单次操作而保留后续提示。
  • VSCode 集成新增消息时间戳、插件错误提示与禁用选项、Ultracode 独立开关。VSCode 用户
破坏性变化
  • 默认权限模式改为 auto,不再默认询问文件读取等操作的权限。↳ 升级后:在 settings.json 中显式设置 permissions.defaultMode 为需要的模式以保持原有行为。
  • CLAUDE_CONFIG_DIR 环境变量现仅支持绝对路径,相对路径被静默忽略。↳ 升级后:将 CLAUDE_CONFIG_DIR 改为绝对路径。
  • 非交互模式首回合 MCP 等待行为改变:CLAUDE_CODE_MCP_STARTUP_WAIT_MS=0 现被忽略,仍会等待最多 2 秒。↳ 升级后:如需快速启动,改为设置该环境变量为较小的正数。
v2.1.283模型管理精细化,30+ bug 通盘修复破坏性
  • 新增 availableModelsMatch: exact 和 deniedModels 配置,实现模型版本精确匹配和单独屏蔽——企业级模型可用性管理管理员
  • /doctor prompt-audit 检查 CLAUDE.md、skill、命令中的旧模型 prompting pattern,自动识别需升级的部分
  • MCP 工具输出可流向 OpenTelemetry 追踪,工具返回的图像自动保存为文件供其他工具访问
  • plugin 相关 20+ bug 修复覆盖加载、验证、版本迁移、缓存恢复等,跨平台兼容性改进插件作者
  • 启动和首应答延迟优化:交互会话延迟加载 UI,首请求复用 API 连接减少往返
破坏性变化
  • availableModelsMatch 设为 exact 时,模型版本必须精确匹配,新 release 默认被屏蔽直到显式添加到白名单↳ 升级后:若需自动跟进新模型版本,保持默认值(模糊匹配)或逐一添加版本号到 availableModels
  • 第三方 provider 或禁用 telemetry 的交互会话现默认以 auto 模式启动(此前行为由其他因素决定)↳ 升级后:需固定权限模式时在 permissions.defaultMode 中明确指定
v2.1.282会话恢复、思考块保留和权限规则的精准应用破坏性
  • --continue 和 --resume 不再重新发送早期消息或丢弃 extended thinking,恢复会话的完整性
  • 修复 web 搜索结果无法解密导致所有请求返回 400 错误的问题,使历史包含搜索结果的对话能正常继续
  • 修复 Bash 权限规则中的 :* 模式被 settings 文件跳过的问题,所有配置源现在都能正确应用hook 用户
  • 修复 managed 设置嵌套值无效时整个块被忽略的问题,其他有效配置现在仍正常生效企业用户
  • 优化大型会话的恢复时间,包括从未压缩过的会话文件启动更快
破坏性变化
  • 在 anthropic-skills 或 claude-ai 命名空间下配置的 skill 文件夹、MCP servers 将不再加载或列出 skills/prompts,虽然 MCP tools 仍可用↳ 升级后:将相关配置和 servers 重命名或移到其他命名空间;或在 MCP 配置中使用不同的名称
  • 关闭遥测时,自动模式在直接 Anthropic API 连接上默认改用服务器端分类器而非本地分类器↳ 升级后:如需保持本地分类器行为,设置环境变量 CLAUDE_CODE_AUTO_MODE_SERVER=0
  • project 和 local settings 文件中的 OpenTelemetry 变量(如 CLAUDE_CODE_ENABLE_TELEMETRY、OTEL_LOG_*)现在被忽略↳ 升级后:这些变量应设置为环境变量而非 settings 文件,或改用 managed settings 来控制遥测
v2.1.281会话恢复与网络稳定性多重加固破坏性
  • 会话恢复稳定性大幅提升:修复历史被改变、缓存丢失、大会话只恢复部分等多个关键问题。
  • 网络连接韧性增强:修复代理/网关导致的流截断、重复执行、响应丢失等问题。
  • MCP 服务器连接完善:修复双重连接、连接中缓存丢失等问题,添加 URL-mode elicitation 支持。
  • 权限系统加固:改进危险 rm 检查,修复权限规则中的 NUL 字节处理问题。
  • 插件系统完善:修复插件更新、卸载流程问题,添加 MCP 配置检查(undeclared 变量、不安全 URL)。
  • VS Code 和 Slack 集成稳定性:修复会话挂起、消息丢失、无法恢复等多个问题。VS Code 用户、Slack 用户
破坏性变化
  • Self-hosted runners 不再通过 --system-prompt / --append-system-prompt 传递系统提示,改为 --system-prompt-file / --append-system-prompt-file↳ 升级后:更新所有 wrapper 或 hook 使用新的文件参数方式
  • Claude apps gateway 现在拒绝启动包含非法 envHelper 路径(\??\ 或 /??/ 前缀)的 managedMcpServers 条目↳ 升级后:检查并更新网关配置中的 envHelper 路径
v2.1.280对话框交互和自动模式的广泛修复破坏性
  • 新增 Claude Opus 5.5 为默认 Opus 模型,支持 100 万 context,缓存读取成本降至 $0.20/Mtok。
  • 修复对话框键盘输入、鼠标交互、快捷键冲突等 50+ 项 UI 问题,改进 fullscreen 模式下的列表导航。
  • 改进 auto mode 的重试逻辑:避免 safety check 拒绝后的无限重试,加入指数退避和次数限制。
  • 修复后台 subagent 和 shell 任务的消息丢失、LSP 支持、MCP 工具刷新等问题。
  • VSCode 集成新增状态对话框、沙箱模式、对话导出等功能,改进粘贴文本处理和提示词处理。
  • 修复云会话的文件访问、auto mode 权限重录、GitHub 认证轮换等问题;Slack 集成增加原生工作指示器。
破坏性变化
  • Y/N 快捷键对对话框的内置支持被移除;这些按键不再确认或取消对话框,只有 Enter/Esc 生效。↳ 升级后:如需恢复 y/n 快捷键,在 ~/.claude/keybindings.json 中手动绑定到 confirm:yes 和 confirm:no。
  • Effort 级别不再自动应用到新发布的模型(如 Opus 5.5);新模型从默认 effort 开始,不继承之前的保存设置。↳ 升级后:为新模型在 /effort 中重新设置所需的 effort 级别。
  • Opus 4.7、4.8 和 Fable 5 不再保留发布时的默认 effort 级别,在 settings 中需显式指定才能应用。↳ 升级后:在项目或全局 settings.json 中为这些模型设置 effortLevel。
  • PermissionRequest hooks 中移除了 agent 类型 hook 的支持,因其无法用于权限决策。↳ 升级后:将 PermissionRequest 中的 agent hook 改为 command 或 http 类型。
  • 自托管运行器 lifecycle hooks 中的 git 命令现在忽略 shared git 文件中的 hook 程序;本地路径和 git:// 远程需要 GIT_ALLOW_PROTOCOL 环境变量。↳ 升级后:在自托管运行器配置中为所需的 Git 协议设置 GIT_ALLOW_PROTOCOL。
v2.1.270-2797 个版本 · 7 已摘要
v2.1.278Auto Mode 分类器默认迁至服务端,消除分类开销破坏性
  • Claude API 和企业用户的自动模式分类器默认改为服务端执行,无需支付分类器费用。Claude API 用户、企业用户
  • Bedrock、Vertex、Foundry、gateway 等云平台的分类器同步迁至服务端,减少客户端计算开销。
  • /status 新增「Auto mode server」行,清晰显示当前会话分类器的运行位置。
破坏性变化
  • 所有平台自动模式的分类器默认改为服务端执行,客户端分类器不再是默认方式。↳ 升级后:Bedrock、Vertex、Foundry、gateway 用户可通过设置环境变量 CLAUDE_CODE_AUTO_MODE_SERVER=0 恢复客户端分类器。
v2.1.277稳定性深度加固,修复 crash、hang、边界情况和静默失败破坏性
  • 新增 AGENTS.md 支持:项目无 CLAUDE.md 时自动读取 AGENTS.md 作为项目指令,可在 /config 中修改(Bedrock/Vertex/Foundry 尚不支持)。
  • 修复对话持续失败:当前面助手回复含有空文本块时,后续请求报 'text content blocks must be non-empty' 错,现已修复;恢复会话后也不再出现。
  • 修复意外登出:旧版 Claude Code 构建(如 IDE 插件内置 CLI)与当前构建共存时会导致意外登出,现已修复。
  • 修复插件安装破坏:重新安装已装插件时,若会话或其他程序正使用该版本,之前会破坏已安装副本,现保留未修改的副本。插件作者
  • 改进 Write 工具可靠性:目标路径为目录时,之前静默拒绝权限,现报错明确提示;Edit 工具也修复了 \uXXXX 转义错误处理。
  • 改进提示处理:自动移除提示中的隐形 Unicode 格式字符,发送前显示清理后内容供审查。
破坏性变化
  • TaskOutput 工具已移除,taskOutputMaxChars 配置和 TASK_MAX_OUTPUT_LENGTH 环境变量不再生效。↳ 升级后:改用 Read 工具读取后台任务的输出文件。
  • 非交互模式下 /ultrareview 现会拒绝执行,当仓库没有基分支或共享历史时。
v2.1.276代理网关兼容性修复
  • 修复在代理/网关环境下请求失败问题,恢复 2.1.275 回归前的兼容性。代理网关用户
v2.1.274卡顿修复与错误提示精进破坏性
  • 修复会话因 tool_use_id 验证错误而无限重试卡顿的问题;损坏转录现自动修复,否则给出 /rewind 恢复提示
  • MCP 权限不足错误现显示缺失权限名单并指向 /mcp 重认证,不再误报为签名过期MCP 用户
  • 新增内存关键时的可见警告及释放内存、安全重启的操作步骤
  • 修复 Streamable HTTP MCP 调用在 5 分钟后超时的问题,现在尊重自定义超时配置MCP 用户
  • 修复 Hook 驱动会话(如 /goal)上下文溢出后的处理:改为自动压缩而非结束并报 'Prompt is too long'Hook 用户
  • [VSCode] 窗口重载中断后自动继续步骤,可通过设置关闭此行为VSCode 用户
破坏性变化
  • MCP 默认从 v1 升级至 v2 客户端和新协议协商(Bedrock/Vertex/Foundry 及遥测禁用安装)↳ 升级后:若需保持 v1 行为,设置环保变量 MCP_SDK_GENERATION=v1 或 MCP_PROTOCOL_NEGOTIATION=legacy
  • type: "sdk" MCP 条目在配置中被跳过;进程内服务器注册仅限官方 SDK 宿主应用↳ 升级后:删除 .mcp.json、settings 等文件中的 type: sdk 条目,改用官方支持的 MCP 配置方式
  • /code-review 改用精简内联审查提示而非生成多个审查子代理↳ 升级后:若依赖旧的多子代理审查方式,需调整工作流或联系支持
v2.1.273权限隔离、会话连接、可靠性综合加强
  • 修复权限检查在 eval、env -C 等复杂 Bash 命令中的误判,防止危险操作被误放行
  • Remote Control 会话支持 fork 后台分支,修复后台代理结果丢失导致任务失败Remote Control 用户
  • MCP 服务器断开时自动通知,修复 OAuth、Bedrock、Vertex 等多种认证连接问题
  • Artifact 发布网络中断后安全重发,单字段更新,改进文件类型错误提示
  • 登录、Gateway、SSL 证书等错误消息现指出具体原因和解决方案,加快问题排查
  • 长会话中 hook 进度和子代理活动不再全量重新处理,响应性大幅提升
v2.1.272修复与稳定性改进
  • 修复了多项已知问题,提升产品稳定性与可靠性。
v2.1.270修复长时间 Session 中只读 Git 命令权限缓存失效
  • 修复 session 运行一段时间后,只读 Git 命令无故触发权限提示的回归(2.1.269 引入)
v2.1.260-2698 个版本 · 7 已摘要
v2.1.269会话恢复、权限规则、终端适配等多项缺陷修复破坏性
  • 新增 claude plugin eval 命令,运行插件 eval suite 获得可重现的评分结果(JSON+HTML 报告)
  • 新增 /output-style [name] 命令列表和切换输出样式,支持 Remote Control 和 headless session
  • Bash 工具在处理文件编辑时输出变更文件的 diff(启用 bashEditDiffEnabled 时)
  • 新增 CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS 环境变量(1–256)提高 Workflow 单次运行并发 agent 上限
  • 修复 session 恢复后 prompt cache 被部分失效的问题,改进缓存重用效率
  • VSCode:新增 agent map、Hooks dialog、Permission rules dialog,改进 agent 可视化和权限配置VSCode 用户
破坏性变化
  • Permission rules 中以 ! 开头的 deny/ask 规则现在仅在其所在设置源内生效,不再跨源全局应用↳ 升级后:如需 deny/ask 规则跨源全局生效,需在所有相关设置源(用户/项目/本地)中各配置一次
v2.1.268权限规则精细化与安全边界强化破坏性
  • Plugin命令现支持--json输出,包括errorDetails和noteDetails字段,便于脚本集成和CI自动化。插件作者/CI用户
  • MCP和Plugin的错误消息、列表输出不再泄露${VAR}占位符中的秘密值,提升安全性。MCP用户
  • WebFetch添加300秒超时防止无限挂起,可用CLAUDE_CODE_WEBFETCH_DEADLINE_MS环变量自定义。
  • 权限规则现对符号链接目录的实际路径也生效,deny/ask规则行为更一致。hook用户
  • 修复长期运行会话的CPU busy loop导致核心占用过高的问题。
  • 发布的Artifact现自带浏览器标签图标,由Claude自动匹配页面风格。
破坏性变化
  • 任务工具(TaskCreate/Get/Update/List、TodoWrite)现仅在Claude 3.x、Opus 4.0-4.7、Sonnet 4.0-4.6、Haiku 4.5上可用。↳ 升级后:其他模型版本需设置环变量CLAUDE_CODE_ENABLE_TODO_TOOLS=1才能使用任务工具。
  • WebFetch的deny/ask规则不再应用于Artifact工具的读写操作,两类权限现已独立。↳ 升级后:需要控制Artifact访问时,改用Artifact规则或WebFetch(domain:claude.ai)规则。
v2.1.267Prompt cache 和工具定义一致性修复破坏性
  • 新增 maxEffortLevel 配置,跨所有提供商(Bedrock、Vertex、Foundry)统一限制最大努力级别,用户仍可选择更低级别
  • 模型切换、会话恢复、MCP 工具变更等场景不再触发 prompt-cache miss,显著提升响应速度,避免 extended thinking 丢失
  • 修复超过 5MB 会话恢复时并行工具调用和 hook 输出丢失,修复 compact 命令后的虚假 turn 插入
  • 防止工具消失、重复定义、中途添加等情况导致的 thinking 丢失和 prompt-cache break
  • 修复 VSCode 扩展宿主进程 CPU 占用飙升、WSL 粘贴失效、RTL 文本错序、CRLF 行尾处理等问题
  • 新增 --system-prompt-snapshot off 选项,每次请求重新渲染系统提示词,便于迭代调试提示词内容
破坏性变化
  • Managed settings 不可读时的权限默认值改变:allowedHttpHookUrls、httpHookAllowedEnvVars、allowedChannelPlugins 从默认'允许全部'改为'阻止全部'↳ 升级后:审查并修正组织的 managed settings 配置,确保这些项正确配置且可读;否则 hook 和插件功能将被阻止
v2.1.266修复 gateway 环境变量与 API 认证的冲突
  • 修复 CLAUDE_CODE_USE_GATEWAY 环境变量的回归,恢复其单独设置时被忽略的行为,解决与 API key、apiKeyHelper 或自定义认证同时使用时导致的 gateway 登录失败gateway 和代理用户
v2.1.265Agent resume 缓存修复、Plugin 文件夹支持及多项稳定性加固破坏性
  • 修复 subagent 和 teammates resume 时泄露 prompt prefix 导致缓存失效,agent 执行成本显著下降
  • --plugin-dir 支持指向文件夹,子文件夹自动作为 plugin 加载,支持运行时动态添加/移除plugin 作者
  • 新增 tool results 磁盘保存 1GB 上限,超大文件截断时在预览中标记,节省存储成本
  • Slash commands 匹配改进,多个结果以列表展示,Tab 打开外层列表,plugin skill 支持裸名称查找
  • Workflow 代理详情优化,tool calls 实时标记状态(运行中/失败/完成),展开时显示输入和结果
  • 修复进程崩溃后 resume 的中断 tool call 处理,中断调用被正确保留并标记,支持恢复继续执行
破坏性变化
  • 带有 forceLoginGatewayUrl 的机器现在强制使用 Claude apps gateway 会话,不再回退到 claude.ai login 或 API key↳ 升级后:检查受管设置中 forceLoginGatewayUrl 的配置;如依赖 API key 或 claude.ai login 回退功能,需调整配置或删除该设置
  • Plugin 元数据优先使用 marketplace 条目而非 plugin.json,本地自定义元数据可能被 marketplace 条目覆盖↳ 升级后:检查自定义 plugin 的元数据来源;如需保证 plugin.json 的优先级,需在 marketplace 同步更新或调整策略
v2.1.263缺陷修复与稳定性增强
  • 修复多项影响可靠性的缺陷,提升系统稳定性。
v2.1.261多端稳定性深度加固与编辑器完善破坏性
  • 新增 /skill-doctor 检查未使用技能与上下文成本占用。
  • 命令和后台任务的内联输出大小限制可配置至 128K(bashOutputMaxChars、taskOutputMaxChars)。
  • Remote Control 多项修复:权限显示准确、停止状态同步、代理环境兼容性、跨设备 session 同步等。
  • VS Code 编辑器大幅完善:session list 状态保持、model picker 重组、MCP 服务器管理界面等。
  • 修复 cloud sessions 插件同步丢失、中断丢失钩子输出、会话恢复混乱等关键问题。
  • 流式传输不再重复检查已渲染块,Vertex AI 启动消除多余发现流程,性能提升明显。
破坏性变化
  • 提示词编辑快捷键改为 Bash 风格:Ctrl+W 删除至空格、Alt+F/Alt+D 停在词尾、标点作分词符。↳ 升级后:通过 keybindings.json 自定义快捷键以保留旧行为。
  • 自动模式不再自动批准公开图表渲染器 URL 中的内容上传。↳ 升级后:涉及图表链接时需手动确认上传。
  • 配置 forceLoginMethod: "gateway" 的机器现在忽略残留 API 密钥/claude.ai 登录,强制使用 /login。↳ 升级后:使用 /login 重新认证。
v2.1.260无公开发布说明
v2.1.250-2596 个版本 · 6 已摘要
v2.1.259并发会话冲突修复与权限管理体系完善破坏性
  • 组织管理员可通过 managedMcpServers 为所有用户集中配置 MCP 服务器,实现统一的工具生态组织管理员
  • 修复并发会话互相覆盖 ~/.claude.json 的问题,工作区信任和 MCP 配置不再丢失
  • --permission-prompts none 支持无人值守模式,自动拒绝所有权限提示,适合 CI/headless 环境CI 用户
  • GitLab 合并请求现已识别(MR !N),在工具摘要和页脚徽章中正确显示GitLab 用户
  • Bash Read() 权限检查扩展覆盖选项值、git 命令操作数和复合命令,权限拦截更全面
  • 修复思考被拒一次后在后续轮次继续被拒的问题,多轮对话流程稳定性提升
破坏性变化
  • allowedMcpServers 不再过滤 managed MCP 服务器——升级后 managed 服务器会自动加载↳ 升级后:若需屏蔽特定 managed 服务器,改用 deniedMcpServers 配置
v2.1.258启动和远程会话通信修复
  • 修复 Claude Code 在 macOS 12(Monterey)上启动失败的回归问题macOS 用户
  • 修复远程和计划会话在权限申批后无法通信的问题自动化用户
v2.1.257Fable 5.1 新默认、权限升级、后台会话大修复破坏性
  • Claude Fable 5.1 作为新默认 Fable 模型,1M 上下文,输入/缓存读取各 $10/$50/$0.25 per Mtok。
  • 权限升级:新增 Containment Escape 规则到自动模式,云元数据获取、出站回避、跨租户操作需明确授权。
  • 修复后台会话多项稳定性问题,包括会话转发、消息同步、状态恢复、worktree 隔离等。终端用户
  • 添加时间格式与时区配置:支持 12/24 小时制、UTC、自定义 strftime 模式用于时间戳显示。
  • 新增 CLAUDE_CODE_SUBAGENT_MODEL_FORCE 环境变量,全局锁定子代理模型选择,覆盖单独配置。脚本用户
  • VSCode 扩展增强:会话列表面板新增可收起的账户区域、模型选择器、输出样式选项。VSCode 用户
破坏性变化
  • .claude/settings.json 中 defaultMode: "bypassPermissions" 不再生效,行为同 "auto"。↳ 升级后:在用户级或托管设置中配置此项,或使用 --permission-mode 命令行参数。
  • --add-dir、/add-dir 和 additionalDirectories 拒绝网络路径(UNC 共享、/net/<host> 自动挂载)。↳ 升级后:Windows 用户改用映射驱动器字母代替网络共享。
  • /btw 历史浏览快捷键从 ←/→ 改为 Shift+←/Shift+→(或 [/])。↳ 升级后:更新快捷键使用习惯,或在 keybindings.json 中重新绑定。
v2.1.252多场景稳定性修复:命令执行、权限保存、远程连接、输出大小
  • 修复 Mac 上 Bash 命令因 task output swap 拒绝而失败的问题。Mac 用户
  • 修复在无 .claude/settings.local.json 的项目中,「always allow」权限设置无法保存的问题。
  • 修复 Remote Control 会话在 claude.ai 连接降级时卡顿数分钟的问题。Remote Control 用户
  • 修复大型任务输出(如满盘 git 报错)导致后台通知使对话超过 API 请求大小限制的问题。
v2.1.251安全补强与可观测性完善破坏性
  • Hook 系统扩展:新增 PreModelSwitch 和 PostModelSwitch 事件拦截模型切换;SessionStart resume 钩子获取会话陈旧度和重缓存成本。
  • 前台子代理工具调用和结果实时流式传输到 Remote Control;修复 agent team 中队友最终回复无法传达给 team lead 的问题。
  • /cost 命令新增每会话缓存行展示命中率、缺失、重缓存 tokens,Spend limit 条形图直观展示花费限制。
  • 修复 5+ 项安全漏洞:文件工具符号链接绕过、插件命令路径遍历、Workflow 脚本路径检查绕过、beta 日志权限泄露、算术赋值权限提升。
  • 后台会话现在支持在 git worktree 中编辑文件;修复 MCP 握手丢失导致无限挂起,改为 70 秒超时。
破坏性变化
  • CLAUDE_CODE_SUBAGENT_MODEL 从覆盖所有子代理模型改为仅设置默认值;agent definition 的 model: 和显式指定的模型现在优先。↳ 升级后:若依赖该环境变量覆盖子代理模型,改用 agent definition 中的 model: 字段或 spawn() 显式参数。
  • 项目级 .claude/settings.json 的 env 不再支持设置 CLAUDE_CONFIG_DIR、CLAUDE_CODE_TMPDIR、TMPDIR/TMP/TEMP。↳ 升级后:这些环境变量需在 shell、用户设置或托管设置中配置。
v2.1.250bug 修复与可靠性加固
  • 修复多项已知 bug,增强整体稳定性
v2.1.240-2495 个版本 · 3 已摘要
v2.1.247键盘导航修复与 Claude API 工具扩展
  • 修复快速键盘导航:arrow-key + Enter 快速序列在历史搜索、/config 等菜单不再误作用到上一行;非拉丁键盘的 Ctrl 快捷键恢复可用
  • 新增 /claude-api cost-optimize 命令,逐项测试缓存、token 优化、batch、effort、模型选择等成本杠杆API 用户
  • Claude API Admin API 覆盖扩展:组织成员、邀请、工作区、API 密钥、速率限制报告、CMEK 支持管理员
  • 新增 SendFeedback 工具,会话出错时自动起草反馈报告供审核发送
  • 修复后台任务大量输出溢出卡住会话的问题;子代理模型 404 改用 fallback 链
v2.1.246长行卡顿、后台崩溃、权限漏洞修复
  • 修复长行(如 base64)导致的严重渲染卡顿,超长行现已截断显示
  • 修复后台 session 启动失败(目录删除、机器休眠等情况)后台会话用户
  • 修复 MCP 工具参数在 schema 为空时被错误转换为 JSON 字符串MCP 工具开发者
  • Bash 权限检查加强:悬挂的 && || 和通配符规则现在更严格
  • 修复 fullscreen 和 Ctrl+O 视图的内存泄漏,长会话不再逐渐变慢
  • Auto mode 现支持超大会话,不再因安全检查超时而拒绝工具调用auto mode 用户
v2.1.245Linux glibc 2.44 启动崩溃修复
  • 修复 Arch Linux、CachyOS、Fedora Rawhide 等搭载 glibc 2.44 的系统启动时崩溃的问题Linux 用户
v2.1.241无公开发布说明
v2.1.240无公开发布说明
v2.1.230-2399 个版本 · 9 已摘要
v2.1.239大规模稳定性修复与云会话、跨平台功能增强
  • 成本估算现纳入 US-only inference 1.1× 溢价,精确反映实际成本
  • 新增 /claude-api upgrade 命令,帮助自动迁移 Python 项目从 anthropic 0.x 到 1.x SDK
  • 云会话插件同步改进:synced 插件显示为 name@synced,不覆盖同名本地插件,独立控制云端用户
  • 修复 Bedrock 代理流式传输问题,解决 Content-Type 丢失导致的静默重复计费 bugBedrock 用户
  • Alpine/musl 原生支持图片粘贴、剪贴板、音频录制等插件功能Linux 用户
  • Windows 跨会话消息传递现已可用,支持 SendMessage 和 ListAgents 跨机器通信
v2.1.238长会话稳定性加固与 Remote Control 连接优化破坏性
  • 修复长会话中的无限制内存增长,子任务工具结果现在会及时释放
  • Remote Control 连接稳定性大幅提升,网络中断恢复更好、错误报告更明确、登出流程更清晰Remote Control 用户
  • Plugin marketplace 新增 headersHelper,支持动态生成临时 HTTP 认证头(如短期 token)
  • Self-hosted runner 新增 --defer-shutdown-max-min 和 --proxy-authorization-* 配置,支持优雅关闭和代理认证自托管用户
  • 修复 MCP stdio 服务器初始化顺序,避免在 server/discover 前发送 initialize 导致的不必要启动
  • 权限提示和终端显示改进,修复超长 URL 显示、宽字符换行、以及 Backspace 在高延迟链接上失效的问题
破坏性变化
  • Ctrl+L/Cmd+K 在全屏模式的行为变更:移除了双按触发 /clear 的快捷方式,现在仅刷新屏幕↳ 升级后:需要使用其他方式(如直接输入 /clear 命令)触发屏幕清空
  • Project .mcp.json 中的 headersHelper 和 inline MCP servers 现在需要用户先接受该目录的信任对话才能运行↳ 升级后:运行 claude -p 或重新配置时接受相关目录的信任
  • MCP headersHelper 不再继承父进程的凭证环境变量,改为从 Claude config 目录运行↳ 升级后:在 helper 脚本中显式传递所需凭证参数,或切换到其他认证机制
v2.1.237修复缓存兼容性,新增简洁输出风格
  • 修复了使用 LLM 网关或自定义 base URL 时 prompt cache 失效的问题LLM 网关用户
  • 新增'Concise'输出风格,跳过前置说明和叙述、直达结果,同时保证工作质量,可在 /config 中选择
v2.1.236修复渲染和会话问题,新增跨会话通知和模型环境变量
  • 新增 ANTHROPIC_DEFAULT_MODEL 环境变量为新会话设置默认模型,/model 命令可覆盖
  • 新增跨会话 notify_when_idle 功能,当同机另一个会话空闲时接收一次性通知
  • macOS:通配符读取禁止规则现取得最高优先级,防止文件重命名绕过
  • 全屏渲染器启动失败时自动回退经典模式,不再永久退出
  • 修复会话目录删除后剪贴板、后台任务、MCP 日志的崩溃问题
  • 改进 slash-command 错误处理:拼写错误命令现报错而非尝试模糊匹配,前缀仍可用
v2.1.235UI 交互打磨与后台性能优化破坏性
  • 新增 spellcheck 设置,在 prompt 输入时用 aspell/hunspell/ispell 标记拼写错误
  • 修复 prompt 高亮显示偏移、嵌套列表缩进、slash 命令中的 HTML 实体等多项 UI 细节问题
  • 后台会话(/ultrareview、/autofix-pr 等)内存和 CPU 使用优化,事件流不再重复扫描渲染
  • 权限对话框显示内容和授权范围完全对齐,防止内容截断导致的误导
  • Vim 模式下切换转录视图或关闭面板时保留光标位置和 NORMAL 模式状态
  • 嵌入式 grep 性能改进,病态正则表达式快速失败而非耗尽内存
破坏性变化
  • SendMessage 现在拒绝超大消息并立即抛出错误,不再静默丢弃↳ 升级后:检查跨会话消息大小,超大消息需分割为多条发送
  • Agent 工具移除通用默认值:omitted subagent_type 现返回错误列表可用代理↳ 升级后:显式指定 subagent_type 参数,或从错误消息的列表中选择
v2.1.234多项修复与安全加强破坏性
  • footer 和 statusline 新增 GitLab merge request 徽章,显示 MR !N 及状态(draft/pending/green)GitLab 用户
  • 使用量限制重置时自动继续会话,可在 /config 关闭此行为
  • account email 仅用于身份识别,不再发送给无关服务关注隐私的用户
  • claude-api skill 的上下文成本从 200k+ tokens 降至 25k,大幅降低加载开销
  • 支持在 Claude 工作时打开 /permissions 对话,权限规则改变即时生效
  • 修复权限答案丢失、Remote Control 消息丢弃、markdown 渲染缓慢等多项稳定性 bug
破坏性变化
  • /config 中的 "Default teammate model" 设置已移除;agent-team teammates 现在默认使用 leader 的 model(除非在 spawn 时明确指定)↳ 升级后:如果依赖此设置控制 teammates model,需要在调用 agent 时明确指定 model,或接受自动使用 leader 的 model
  • remote file reads、session restore、CLAUDE.md includes、workflow scripts、file uploads 现在拒绝 Windows NT-namespace (\?\?) 路径↳ 升级后:如果工作流使用了 Windows NT-namespace 路径格式,需要改用标准路径
v2.1.233MCP 长连接与权限系统修复破坏性
  • 修复 MCP v2 服务器无限重新打开 subscriptions/listen 流的问题,解决与长连接超时服务器的兼容性。
  • 修复 Windows 上 Bash 权限检查过严的问题,恢复对 Cygwin 符号链接和输入重定向的支持。
  • 修复 Linux 沙箱环境下闲置时 CPU 占用 100% 的问题。
  • 支持 GitLab merge request URL,在 claude agents 视图中以 !N 格式展示。
  • 修复权限提示 hooks 在 Claude Desktop 和 VS Code 下不触发的问题。
  • 新增 CLAUDE_CODE_TOOL_MEMORY_LIMIT 环境变量支持(Linux),防止 Bash 命令失控导致会话卡顿。Linux 用户
破坏性变化
  • task-tracking tools (TaskCreate/Get/Update/List, TodoWrite) 在 Opus 4.8、Sonnet 5、Fable 5、Mythos 5 及更新模型上不可用。↳ 升级后:如需保留工具,设置环境变量 CLAUDE_CODE_ENABLE_TODO_TOOLS=1。
v2.1.232Subagent 默认后台执行,跨会话协作便利,安全体系加固破坏性
  • Subagent forking 默认启用,非队友代理在交互会话中后台运行,完整继承对话和 prompt cache
  • Prompt 中输入 @ 提及其他会话,通过 SendMessage 直接通讯;精确名称匹配时无需确认
  • GitLab 完整支持:嵌套子组、token 秘密检测(glrt-、gloas- 等),glab CLI 获得 gh 级沙箱保护
  • 修复多个权限绕过:PowerShell 变量、Git Bash symlinks、嵌套仓库信任、Bash 重定向权限检查
  • RemoteControl 稳定性升级:会话复用、消息套接字加固、30 分钟连接重试、设备冲突处理
  • Fullscreen streaming 性能优化,长对话无整体重新标准化;插件发布后即时安装
破坏性变化
  • sandbox.ripgrep 仅从用户、managed 和 --settings 配置生效,项目设置中的配置被忽略↳ 升级后:项目 .claude/settings.json 中的 sandbox.ripgrep 迁移至用户级设置 ~/.claude/settings.json
  • Gateway managed 配置验证严格化:empty groups/admin_groups 或格式错误的 email_domain 导致启动失败,不再静默失效↳ 升级后:检查 managed 策略配置,修正或移除 policies[].match.groups、admin_groups 中的空值和格式错误的 email_domain
  • 嵌套 Git 仓库不再从父目录继承信任,每个仓库需独立信任确认↳ 升级后:首次进入嵌套仓库时重新确认仓库信任
v2.1.231MCP OAuth 登录重定向 URI 修复
  • 修复 MCP OAuth 登录的重定向 URI 不匹配问题,预注册 OAuth 客户端(如 Slack)现可正常登录
v2.1.220-2299 个版本 · 8 已摘要
v2.1.229流媒体稳定性加固、Remote Control 增强、生态工具链完善破坏性
  • Plugin marketplace 新增 command 源,让本地命令动态提供插件目录,mode: "link" 支持无需重启应用。
  • 修复长响应流媒体问题:消息不再部分消失和重复打印,大幅提升生成文本的稳定输出。
  • Remote Control 新增 server-supplied hooks 支持,自托管 runner 会话行为与托管环境对齐。
  • Gateway 流响应添加 SSE keepalive pings,防止 Vertex/Bedrock 后端在长思考期间空闲断连。
  • VSCode 新增会话分组功能,支持右键创建/重命名/删除,Cmd/Ctrl+Click 或 Shift+Click 实现批量移动。
  • MCP OAuth 兼容严格授权服务器,重定向 URI 改用 127.0.0.1 替代 localhost。
破坏性变化
  • /commit-push-pr 不再自动批准包含危险标志(--force、--amend、--no-verify 等)的 git/gh 命令。↳ 升级后:若脚本需使用这些标志,升级后需手动确认或调整工作流避免危险操作。
  • self-hosted runner Windows 启动移除默认检出目录,现需显式指定 --base-dir 参数。↳ 升级后:Windows self-hosted runner 启动命令需添加 --base-dir 参数指定工作目录。
v2.1.228会话交互稳定性加固破坏性
  • 修复交互会话因内部布局错误停止重绘、进程卡住的罕见问题
  • 修复会话清理误删项目 memory 文件夹内容的 bug
  • 修复 /tui 命令误将会话模型回退到之前版本的问题
  • 修复 Windows 上从父文件夹启动时 Git/Git Bash 查找失败的问题Windows 用户
  • 修复跨会话消息有时无收件箱的问题,改进消息展示为内联形式
  • 修复自托管 runner 在 checkout 失败时导致会话异常结束的问题CI 用户
破坏性变化
  • 从 claude.ai 同步的 skills 不再覆盖本地命令和 MCP prompts↳ 升级后:若需 synced skills 覆盖本地命令,改为在本地 settings.json 中定义这些 skills
v2.1.227登录、Bash、菜单、性能多处补丁
  • 修复过期令牌导致 feature flags 误评,Max 用户不被错误提示启用积分。Max 用户
  • 修复 GitHub Actions 运行器上 Bash 命令全部失败的问题。GitHub Actions 用户
  • 修复 /tui 命令错误恢复已回退的对话。
  • 改进 slash 命令菜单:选中行蓝色标记、匹配字符加粗、保留表情符号和重音。
  • 性能优化:减少文件检查和 @-mention 检查的事件循环阻塞。
v2.1.226无公开发布说明
v2.1.224自托管环境与跨会话协作升级
  • 自托主机部署:通过 claude self-hosted-runner 在本地机器或容器上运行 Claude Code 会话(Team/Enterprise 计划)企业用户
  • 插件存档安装:支持从 HTTPS zip 直接安装插件,可选 SHA-256 校验,无需 git 或 npm
  • 跨会话消息:同机器会话间可相互发送消息,支持权限审批和自动递送团队协作用户
  • 沙箱凭证掩蔽:新增 JWT 感知掩蔽(maskClaims)、AWS SigV4 重签名、结构化环境变量掩蔽等选项
  • Remote Control 可靠性改进:连接失败显示详细提示和重连快捷键,compaction 实时显示进度边界
  • 会话目录隔离修复:长路径项目的会话操作(列表、重命名、删除)不再与其他项目混淆
v2.1.223权限加固与命令优化升级破坏性
  • 修复三个权限绕过漏洞:Bash 命令隐藏、tab/Unicode 隐藏审批框、workflow 动态 import() 逃逸沙箱
  • Marketplace 通配符支持:strictKnownMarketplaces 和 blockedMarketplaces 支持 "owner/*" 批量管理组织下的仓库
  • Workflow 代理安全强化:模型受限时显示警告、修复 bypassPermissions 绕过组织管理策略的漏洞
  • /code-review 自动记忆上次 effort level 减少重复输入;新增 /teleport 提示快速切换到本地会话
  • 修复会话稳定性问题:resumed 会话失败、model discovery 遗漏 provider-prefixed 模型、Linux sandbox 命令启动失败
破坏性变化
  • /review 改为 /code-review 别名,参数和行为可能不同↳ 升级后:更新脚本为 /code-review;支持 /code-review ultra 进行深度审查
  • modelOverrides 中非 Anthropic 模型 ID 不再当作 canonical model ID,现被忽略↳ 升级后:检查 modelOverrides 配置,确保模型 ID 符合 Anthropic 命名规范
  • CLAUDE_CODE_DISABLE_1M_CONTEXT 对所有原生 1M 模型应用 200K 自动压缩,不限于固定列表↳ 升级后:需要禁用此行为,设置 CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1
v2.1.222隔离强化与权限系统加固破坏性
  • 工作树隔离扩展到所有会话类型,子代理和文件编辑不能对主仓库执行破坏性 git 命令
  • 修复 PreToolUse hook 在后台任务中绕过工具限制的问题,权限检查对摘要、压缩等背景操作生效
  • 通过 SendMessage 跨会话的消息现在接受权限评估,多代理工作流安全性提升
  • 启动连接检查和 stream 超时现在感知 proxy 配置,支持自定义网关,虚假超时错误大幅减少
  • /usage 统计准确性提升,MCP 服务器使用量仅计算实际消耗工具结果的请求
  • 屏幕阅读器模式下删除字符仅播报删除部分,避免重复朗读整行终端用户
破坏性变化
  • ultraplan 功能已移除↳ 升级后:若依赖此功能,需要评估替代方案或回滚版本
  • Remote Control auto-start:repo-local 设置不再能启用,仅能禁用↳ 升级后:若项目需启用 Remote Control auto-start,通过 /config 在用户级别配置
v2.1.221UI 聚焦降噪、沙箱凭证隐秘、权限检查全面修复破坏性
  • 新增 Focus view:Ctrl+Alt+F 切换,隐藏工具活动在可展开的运行摘要后,专注于核心交互
  • 沙箱凭证隐藏(mode:"mask"):Linux/WSL 上凭证文件内容对沙箱命令不可见,增强隐私安全Linux/WSL 用户
  • 权限检查修复:修复权限检查绕过(zsh [[ ]] 隐含命令、PowerShell 含引号路径等),这些命令现在正确提示权限
  • MCP 与会话管理稳定性提升:修复 print mode 下 MCP 连接顺序、会话重命名跨平台同步、思考模式切换等问题
  • 后台会话自动保存:自动 commit 和 push 工作成果,遵循 CLAUDE.md 指引,只在需要时打开 draft PR
破坏性变化
  • 后台会话(background session)现在自动执行 commit 和 push 保存工作,默认不打开 draft PR,除非任务明确要求↳ 升级后:如果后台任务的工作流依赖原有的行为(保持未提交状态或其他 commit 策略),需要调整脚本或 CLAUDE.md 的 git 指引
  • /fork 创建的会话现在使用独立的新 worktree,而不是在原会话的检出中工作;文件系统不再共享↳ 升级后:依赖原 fork 行为共享文件系统的脚本需要重新设计,改为使用独立 worktree 的工作模式
  • 权限检查修复堵上了 Bash/PowerShell/zsh 的绕过漏洞:zsh [[ ]] 正则中的隐含命令、含引号的 PowerShell 路径等现在需要明确授权↳ 升级后:自动化脚本如果依赖这些命令无声执行,需要预先授权对应权限或修改权限策略(如在 settings.json 中配置 allowlist)
v2.1.220稳定性加固
  • 修复多项已知问题,改进系统稳定性。
v2.1.210-2199 个版本 · 9 已摘要
v2.1.219Opus 5成新默认,工作流大小优化破坏性
  • Claude Opus 5成为新默认模型,1M超大context,fast mode年费$10/$50/Mtok
  • 动态工作流默认大小改为medium(~15 agents),自动防止编排过度Workflow用户
  • Subagent最大嵌套深度从1扩至3,支持更复杂的多层编排场景Workflow开发者
  • 新增DirectoryAdded hook,支持mid-session动态注册新工作目录Hook用户
  • MCP服务器连接故障现显示HTTP状态和错误详情,排查更清晰MCP用户
  • Self-hosted runner故障分类细化,能区分hook错误、runner崩溃、配置问题Self-hosted runner用户
破坏性变化
  • Opus 4.7不再支持fast mode(现仅Opus 5和Opus 4.8支持)↳ 升级后:若依赖Opus 4.7的fast mode,请切换到Opus 5或Opus 4.8
  • Subagent默认最大嵌套深度从1改为3,大型编排可能生成超预期数量的嵌套agent↳ 升级后:需保持旧行为可设置环境变量 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1
  • 动态工作流默认大小从无限制改为medium(~15 agents),大规模工作流可能受限↳ 升级后:需更大规模或无限制,在 /config 的 Dynamic workflow size 中调整
v2.1.218代码审查后台化、路径修复与稳定性加固破坏性
  • 代码审查改为后台子代理运行,不再填满对话,允许继续堆叠其他斜杠命令。
  • 修复 Windows 路径中 \u 前缀段在工具输入中被损坏为 CJK 字符的问题。Windows 用户
  • 屏幕阅读器改进:删除文本时播报、空格回显正确、导航面板光标跟随。屏幕阅读器用户
  • MCP 连接失败时显示 HTTP 状态和错误文本,配置的隐藏空格现显示警告。
  • /ultrareview 支持描述性参数(如'review my auth changes'),修复云审查在非交互会话的启动。
破坏性变化
  • Agent markdown 文件名不再接受包含冒号 : 的名称。↳ 升级后:重命名现有的包含冒号的 agent 文件,冒号现保留用于插件命名空间。
  • fork context 的 skills 现在默认后台运行。↳ 升级后:如果 skill 需要同步运行,在 frontmatter 中添加 background: false。
  • /deep-research 不再自动启动,仅在手动调用时运行。↳ 升级后:依赖自动启动的工作流改为手动调用 /deep-research。
v2.1.217稳定性加固与 subagent 并发管理破坏性
  • Emoji 快捷码自动完成:输入 :heart: 快速插入表情,可通过 emojiCompletionEnabled 关闭
  • Transcript 写入失败或会话保存禁用时给出警告,防止数据无声丢失
  • 修复 MCP 工具输出内存泄漏,截断后的输出不再保留完整副本在内存中
  • 修复 CLAUDE.md/SKILL.md 中大量 brace group 导致 CLI 启动 OOM 的问题
  • 修复企业配置被忽略:mTLS、TLS 验证、OAuth 作用域、代理设置在 Desktop 端现已生效企业用户
  • Subagent 并发上限(默认 20)和预算管理改进,防止无限扇出和资源耗尽
破坏性变化
  • Subagent 不再默认允许嵌套生成其他 subagent↳ 升级后:若需嵌套,设置环境变量 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH
  • 预算上限 --max-budget-usd 现在正确停止后台 subagent(之前未生效)↳ 升级后:检查依赖后台代理无限运行的工作流,确保预算限制符合预期
  • 并发 subagent 数量新增默认上限 20(超过时排队)↳ 升级后:若需更高并发,设置环境变量 CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS
v2.1.216长会话加速、后台会话修复、隔离和认证加强
  • 修复长会话消息规范化二次方成本问题,消除多秒卡顿和恢复延迟
  • 后台会话恢复时保留原 agent 的 prompt 和工具限制,避免重置为默认值
  • 修复 worktree 隔离子 agent 通过 git 命令重定向到共享仓库的安全漏洞
  • OAuth 令牌过期中途不再拒绝命令,MCP 重新认证不再提前撤销有效凭证
  • 修复 Windows 网络路径权限检查缺失、Bash 非 ASCII 字符解析、PowerShell 隐形 Unicode 处理等跨平台问题Windows 用户
  • 解决会话恢复挂起、@-mention 附加失败、快捷键失效等多个 UX 问题
v2.1.215验证技能改为按需调用破坏性
破坏性变化
  • /verify 和 /code-review 技能不再自动调用,需要显式触发↳ 升级后:升级后若需要验证代码,请使用 /verify 或 /code-review 命令手动调用
v2.1.214权限检查的多项安全修复与工具稳定性加固破坏性
  • 修复 Bash 权限检查中 glob 模式匹配、长命令、zsh 变量等多个安全漏洞
  • 修复 Windows PowerShell 中的权限绕过,以及 UTF-16LE 输出、编码错误等问题Windows 用户
  • 添加 EndConversation 工具,可结束与滥用用户或越狱尝试相关的会话
  • 修复后台会话的无限期保活、删除失败、恢复失败等生命周期管理问题
  • 修复超大配置文件(>2 MiB)导致的内存泄漏,启动时给出清晰错误提示
  • 对 docker daemon-redirect flags(--url、--connection 等)添加权限检查
破坏性变化
  • 单段 dir/** allow 规则现在只匹配 <cwd>/dir/,不再匹配树中任意深度的该目录↳ 升级后:如需任意深度匹配改用 **/dir/**;deny/ask 规则保持不变
  • file 命令的 -m/--magic-file 或 -f/--files-from 参数现在需要权限,之前自动允许
  • SessionStart hook 的 source 字段在 fork 会话时改为 "fork",不再是 "resume"
v2.1.212后台会话独立、自动限流、稳定性修复破坏性
  • /fork 改为复制会话到后台独立运行;原有子代理启动功能改用新命令 /subtask
  • WebSearch 和 subagent 新增自动限流(各上限 200 次),防止失控迭代
  • MCP 工具运行超 2 分钟自动切后台,会话保持实时可用性
  • /resume 新增会话选择器,可恢复已删除的后台会话
  • 修复计划模式无权限提示执行文件命令、worktree 符号链接安全漏洞、hook 异常处理等关键问题
  • 优化代理间消息令牌使用(避免重复),改进缓存在网关和自定义 URL 上的兼容性
破坏性变化
  • /fork 语义改变:原在当前会话启动子代理,现复制会话到后台独立运行↳ 升级后:需在当前会话启动子代理时改用 /subtask 命令
  • Task tool 的 mode 参数已弃用(现被忽略),子代理自动继承父会话的权限模式↳ 升级后:从代码中移除 Task tool 的 mode 参数设置
v2.1.211权限与系统稳定性多项加固破坏性
  • 权限预览防可视化注入,修复特殊字符可能改变审批消息显示的安全漏洞
  • MCP 服务器自动重连,修复 web 会话唤醒后连接丢失问题MCP 用户
  • 并发会话登出修复,多个会话共享凭证时不再同时登出
  • Subagent 模型配置保留,显式指定的模型不再被覆盖
  • 后台任务结果改进,现在等待实际完成而不是虚假报告结果
  • 异步加载性能优化,设置和 diff 视图的加载延迟减少
破坏性变化
  • 文件上传规则变化:现在拒绝硬链接文件(之前接受)↳ 升级后:若需上传硬链接文件,请先复制为独立文件后上传
  • 'always allow' 权限规则保存位置变化:从工作树本地改为仓库根目录保存↳ 升级后:权限规则现在在工作树间自动同步;如有旧位置的规则,检查是否需要迁移
v2.1.210修复 worktree 隔离漏洞与自动化误触发破坏性
  • 修复 isolation: 'worktree' 子代理能访问主仓库 git 命令的安全漏洞,现完全隔离工作树
  • 修复 ultracode 关键词在 webhook/自动 PR 评论等非人工输入中误触发自动化模式
  • 修复 hook callback 超时被误报为用户拒绝,导致无人值守会话错误停止等待
  • 工具调用时新增实时流逝计时器,长耗时操作过程可见,不再显示卡住假象
  • 权限分类模型升级为 Sonnet 5,Bedrock/Vertex/Foundry 移除 auto 模式 opt-in 要求
  • 修复 Skills/Commands 中未匹配占位符 $1/$2 被静默剥离,现保留为原文
破坏性变化
  • isolation: 'worktree' 子代理现真正隔离,无法运行 git 命令修改主仓库↳ 升级后:工作流若依赖子代理能修改主仓库代码,改为在主代理中执行,或向子代理显式授予权限
  • ultracode 关键词不再在 webhook、自动 PR 评论等非人工输入上触发自动模式↳ 升级后:自动化流程需触发 ultracode 改用明确配置或 API 调用,不要依赖关键词检测
  • Skills 和 commands 中未匹配占位符 $1/$2 现保留为原文,不再被静默剥离↳ 升级后:检查现有 skills/commands 的占位符使用,确保被正确替换,避免占位符原文泄露到执行
v2.1.200-20910 个版本 · 10 已摘要
v2.1.209修复后台会话对话框误阻的问题
  • 修复了 /model 等对话框在 claude agents 后台会话中被误阻的问题。
v2.1.208后台稳定性加固、内存泄漏消除、Vim 快捷键登场
  • 消除多源内存泄漏:修复 MCP server stderr 积压、LSP 文档无界增长、hook 输出滞留、大工具结果未释放等问题(会话转录最多压缩 79 倍)。
  • 后台 Session 稳定性大幅提升:修复 HTTP/2 GOAWAY 导致崩溃、binary 更新后启动失败、请求在途时连接断开等 10+ 个问题。
  • 新增 Screen reader 模式:运行 claude --ax-screen-reader 或设置 CLAUDE_AX_SCREEN_READER=1,为屏幕阅读器用户提供纯文本渲染。无障碍用户
  • Vim Insert Mode 快捷键映射:新增 vimInsertModeRemaps 设置,支持将 jj 等两键序列映射到 Escape。
  • 工具调用性能优化:MCP 工具池缓存复用减少 CPU 开销(高工具数量场景性能提升 7 倍),修复 Edit 文件修改后失效、Grep 无效正则沉默失败等问题。
  • 企业启动器支持:新增 CLAUDE_CODE_PROCESS_WRAPPER 环境变量,让 agent 和后台服务通过企业指定的启动器运行。企业用户
v2.1.207稳定性修复与配置规范化,插件安全加强破坏性
  • Auto mode 在 Bedrock、Vertex AI、Foundry 默认启用,可通过 settings 禁用Bedrock/Vertex AI 用户
  • 修复流式输出超长列表、表格或代码时导致的终端冻结和键盘延迟
  • 修复远程管理设置被永久记录为已同意但不显示安全对话框
  • 修复虚假的提示词注入警告
  • 修复更新器覆盖自定义启动脚本或符号链接,/doctor 现报告外部管理的启动器
  • 插件 hooks/monitors 加强参数验证,拒绝不安全的 shell 形式 ${user_config.*} 命令插件作者
破坏性变化
  • autoMode 不再从项目级 .claude/settings.local.json 读取,改为仅读用户级 ~/.claude/settings.json↳ 升级后:检查项目 .claude/settings.local.json 中的 autoMode 设置,移至用户级 ~/.claude/settings.json
  • pluginConfigs 不再从项目级 .claude/settings.json 读取,仅支持用户级、--settings 和管理设置↳ 升级后:将插件配置从项目级 settings 移至用户级 ~/.claude/settings.json 或通过 --settings 指定
  • 插件 hooks/monitors/MCP headersHelper 中 shell 形式的 ${user_config.*} 命令被拒绝(安全修复)↳ 升级后:改用 exec 形式(args 数组)或通过 $CLAUDE_PLUGIN_OPTION_<KEY> 环境变量读取配置
v2.1.206修复 MCP、登录、后台任务的核心问题,完善开发工具链
  • 修复 MCP 服务器 per-server 超时配置被忽略、OAuth 认证失败需手动重新认证等问题,提升 MCP 集成稳定性MCP 用户
  • 修复过期登录显示"选中的模型有问题"的误导错误,改为提示运行 /login
  • 后台 agent 在 Claude Code 更新后自动升级,无需等待 reattach 时的 stale session 升级CI 用户
  • 新增 /doctor 检查,可建议清理 CLAUDE.md 中从代码库可推导的冗余内容
  • 改进 /code-review 在 claude-opus-4-8 上的检测质量,修复模型选择器的价格显示
  • 改进 agents 视图状态列显示宽度,修复 claude --resume 启动时的键盘输入响应
v2.1.205Agent 和会话管理稳定性集中修复破坏性
  • Auto mode 改进:运行 rm -rf 前会询问确认,防止变量无法解析时的误删
  • Agent view 改进:任务状态用彩色关键词显示,标题由分类器生成;支持链接已有 PR
  • 后台任务通知改进:明确说明未发生人工输入,防止虚假批准被执行
  • 自动更新内存优化:二进制下载改为流式写入磁盘,峰值内存占用减少约 400MB
  • JSON schema 修复:无效 schema 不再静默失效生成非结构化输出,现支持 format 关键字
破坏性变化
  • User-configured MCP 服务器不能再注册为 "Claude Browser" 或 "Claude Preview" 这两个名称↳ 升级后:如果现有自定义 MCP 服务器使用了这两个名称,需要改为其他名称重新配置
v2.1.204修复无头会话 Hook 事件流中断问题
  • 修复无头会话中 SessionStart Hook 期间事件流中断,防止 remote workers 被误判为空闲而遭重启CI 用户
v2.1.203后台 Session 稳定性大修,登录过期保护与自动恢复破坏性
  • 新增登录过期警告,让用户在后台 session 中断前及时重新认证
  • Session token 过期时自动恢复,解决后台 agent 永久无响应的问题后台 agent 用户
  • 修复 macOS 后台 agent 启动卡顿 15-20 秒的回归问题
  • 优化 context 分析逻辑,交互式 session 性能显著提升,不再每轮全量扫描 transcript
  • 修复 worktree 隔离 subagent 在错误工作目录执行命令的问题
破坏性变化
  • 左箭头不再关闭后台任务、diff 和 workflow 详情视图↳ 升级后:改用 Esc 键关闭这些视图
v2.1.202多模块稳定性修复与功能增强破坏性
  • 修复 Remote Control 移动/网页端命令执行、文件和图片发送失败Remote Control 用户
  • 修复语音录制在麦克风或录音器故障时无限重试,现改为暂停输入语音输入用户
  • 修复 Workflow 脚本中 unicode 转义字符被破坏;脚本错误现显示具体行号
  • 优化大型 Git Worktree 仓库中 Session resume 的性能和内存占用
  • 新增 Dynamic workflow size 配置选项,可在 /config 中调整 Workflow 代理规模
破坏性变化
  • /review <pr> 改为单速评审;多代理评审功能被移除↳ 升级后:需多代理评审改用 /code-review <level> <pr#> 命令
v2.1.201Sonnet 5 会话系统角色管理优化
  • Claude Sonnet 5 会话不再在中途对话中使用系统角色发送 harness 提示
v2.1.200权限默认改为严格模式,后台会话与守护进程稳定性重铸破坏性
  • 默认权限模式从"default"改为"Manual",所有权限操作现在需显式确认;接受 --permission-mode manual 和 "defaultMode": "manual" 配置。所有用户
  • 后台会话修复:sleep/wake 后不再静默中断、stall 不再重放已取消的步骤、崩溃后守护进程握手避免版本混乱。后台代理用户
  • AskUserQuestion 对话框不再默认自动继续;需通过 /config 启用空闲超时来恢复旧行为。脚本作者
  • 语音输入改进:移除误导性的"Voice connection failed"消息(当录音为空时不再显示)。
  • 后台代理稳定性加固:修复守护进程名册损坏、版本混用导致字段丢失、速率限制断裂时静默返回等 7 项问题。后台代理用户
  • 无障碍全面改进:屏幕阅读器隐藏装饰符、MCP 列表焦点跟踪、嵌套表格格式优化;Tmux 3.4+ 同步输出消除闪烁。无障碍用户
破坏性变化
  • 默认权限模式改为"Manual"(严格模式),之前依赖宽松默认值自动通过的操作现在需显式确认。↳ 升级后:配置中显式指定 "defaultMode": "manual";CLI 使用 --permission-mode manual;旧的 --permission-mode default 仍接受但行为已改变,需重新评估自动化脚本。
  • AskUserQuestion 对话框不再默认自动继续;默认的空闲超时功能被禁用。↳ 升级后:依赖自动继续的脚本应通过 /config 启用空闲超时功能。
v2.1.190-1996 个版本 · 6 已摘要
v2.1.199后台Agent与流式处理稳定性全面加固
  • 支持一次堆叠调用多个slash-skill,如 /skill-a /skill-b do XYZ,最多5个
  • SSL/TLS证书错误现在立即失败并给出修复提示,避免浪费重试次数
  • API中途报错时现在保留已接收的部分流式输出,不再静默丢弃
  • Subagent现在正确报告API限流和错误,不再误报为成功结果
  • 后台Agent在SSH/macOS上冷启动不再失败,Linux守护进程不再意外自杀SSH用户
  • 长命令运行时进度显示不再卡顿,低内存环境给出明确提示而非通用错误
v2.1.198Chrome 正式可用、代理自动化、稳定性优化破坏性
  • Claude in Chrome 正式可用,云端能力直接集成浏览器
  • 后台代理完成代码工作时自动 commit、push、打开 draft PR,无需用户二次确认
  • 新增 /dataviz skill 提供图表和仪表板设计指导,含可运行的配色验证工具
  • 后台代理新增通知机制:agent 需要输入或完成时触发 Notification hook,便于自动化集成CI / 自动化用户
  • Explore agent 继承 session 的模型配置(最多 opus),替代固定 haiku,推理质量提升
  • 修复网络中断、AWS 连接、macOS 权限、symlink 路径、agent teams 等 20+ 稳定性问题
破坏性变化
  • /agents 向导被移除↳ 升级后:改为手动编辑 .claude/agents/ 或让 Claude 帮助创建代理
  • 后台代理完成代码工作时不再询问用户,直接自动 commit、push、打开 draft PR↳ 升级后:验证自动化流程符合预期,必要时调整工作流程和权限配置
v2.1.197Sonnet 5 成为新默认,原生百万 token 上下文
  • Claude Sonnet 5 成为默认模型,推理和理解能力大幅提升
  • 原生 1M token 上下文窗口,处理长代码和复杂文档无需截断
  • 限时优惠价格 $2/$10 per Mtok,截至 2026 年 8 月 31 日
v2.1.196后台会话稳定加固与多处修复完善破坏性
  • MCP 安全强化:claude mcp list/get 不再自动启动未批准服务器,改由已提交的 .claude/settings.json 显式控制MCP 用户
  • 后台任务可靠性飙升:长时任务/工作流支持进程意外停止/重启后自动恢复,Windows 系统也已加强
  • Agent 面板多处修复:焦点卡住、后台任务丢失子代理类型、状态错显等问题全部解决
  • 会话交互提升:可读的默认会话名称方便识别;文件附件支持 Cmd/Ctrl 点击快速在 Finder/Explorer 中打开
  • 代码审查性能优化:五个清理检查器合并为一,token 消耗下降约 25%
  • PowerShell 命令行修复:git diff/grep、egrep/fgrep、带管道字符的模式现与 Bash 行为一致Windows 用户
破坏性变化
  • Remote Control 在 ANTHROPIC_BASE_URL 指向非 Anthropic 端点时被禁用,改为遵循 Bedrock/Vertex/Foundry 策略↳ 升级后:若需自定义端点支持 Remote Control,检查环境变量配置或切换至 Anthropic 官方端点
  • 流媒体空闲看门狗默认全局启用:5 分钟无输出事件则自动中止重试↳ 升级后:若需支持超长空闲流或特殊网络场景,设置环境变量 CLAUDE_ENABLE_STREAM_WATCHDOG=0
v2.1.195Hook 精确匹配、语音输入三修及后台任务加固破坏性
  • Hook 匹配改为精确而非子串,提升 hook 规则精度
  • 修复语音输入三项问题:macOS 长会话静音捕获、无空格语言自动提交失效、Linux 区分麦克风状态
  • 修复插件启用/禁用失效、项目设置启用的插件重复确认问题
  • 修复后台任务消失、重启显示空白、守护进程卡住等稳定性问题
  • 新增 CLAUDE_CODE_DISABLE_MOUSE_CLICKS 环境变量禁用全屏模式的鼠标操作
  • 改进 Remote 会话启动显示预配清单
破坏性变化
  • Hook matchers 从子串匹配改为精确匹配;带连字符的 tool 名称(如 code-reviewer、mcp__brave-search)现在只精确匹配,不再子串模糊匹配↳ 升级后:如需匹配同一 MCP 服务的多个工具,改用正则表达式如 mcp__brave-search__.*
v2.1.193增强自动化模式、改进后台代理稳定性和 MCP 认证流程破坏性
  • 设置 autoMode.classifyAllShell 让所有 Bash/PowerShell 命令都通过自动化分类器检查,不仅限于特定模式
  • 自动化模式拒绝时显示具体原因,在转录、拒绝提示和权限页面都能看到为什么被拒绝
  • Bash mode 新增实时文件路径自动补全,在 ! 后快速访问系统文件
  • MCP 服务器需要认证时自动显示启动提示,点击 /mcp 快速配置
  • 自动清理空闲的后台 shell 命令释放内存压力,可用 CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1 禁用
  • 修复多个后台代理问题:自动更新后不再反复提示继续工作、后台化时不生成多余 subagent、不会被误取消
破坏性变化
  • OpenTelemetry 日志行为变化:默认开始记录模型响应内容(跟随 OTEL_LOG_USER_PROMPTS 设置),若需仅记录提示内容须设置 OTEL_LOG_ASSISTANT_RESPONSES=0