Claude Code 学习站

更新动态

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

最近 12 个版本

v2.1.274Latest破坏性变化2026/09/17 · 2 小时前

卡顿修复与错误提示精进

稳定性加固
亮点
  • 修复会话因 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 改用精简内联审查提示而非生成多个审查子代理↳ 升级后:若依赖旧的多子代理审查方式,需调整工作流或联系支持
展开官方原文 ↓
## 2.1.274

- Added a visible warning when memory usage is critical, with steps to free memory or restart safely
- Added `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` to bound how long the first non-interactive turn waits for connecting MCP servers (`0` = don't wait)
- Added `effort` attribute to the `claude_code.llm_request` OpenTelemetry trace span, matching the `api_request` event
- Added `claude_code.managed_settings_resolved` OTel event: managed-settings sources and policy helper state; redacted settings and digests with `OTEL_LOG_MANAGED_SETTINGS=1`
- Added `store.connect_timeout_seconds` to the Claude apps gateway config to lengthen the Postgres connect timeout (default 5 seconds), and improved the boot error when the database is unreachable to point to `store.postgres_url` and the configured timeout
- Added `enduser.sub`, the IdP subject, to the telemetry Claude Desktop and Cowork send through a Claude apps gateway
- Added a Claude apps gateway warning when a replica has more requests open than the 256 it sends upstream at once, and a startup log line showing that limit
- Added click-to-expand for collapsed teammate and agent messages in fullscreen mode
- Fixed sessions getting stuck endlessly retrying "unexpected tool_use_id" 400 errors: corrupted transcripts now self-heal where possible, and otherwise a clear error (with a `/rewind` hint) ends the loop
- Fixed MCP servers configured as `http` that only speak legacy HTTP+SSE failing to connect when they answer the first request with 422 or another 4xx error
- Fixed Streamable HTTP MCP tool calls timing out after about 5 minutes even when a longer per-server `timeout` was set
- Fixed MCP prompts and resources not refreshing when a server sends list-changed notifications without declaring `listChanged`
- Fixed MCP tool calls refused with 403 insufficient_scope being reported as an expired sign-in: the error now names the missing permissions and points to `/mcp` re-authentication
- Fixed hook-driven sessions (such as an active `/goal`) ending with "Prompt is too long" instead of compacting when the context overflowed again after a reactive compaction
- Fixed an active `/goal` being lost when resuming (`--continue` / `--resume`) a session that had compacted
- Fixed `claude agents` losing `--model`, `--effort`, `--permission-mode`, `--allow-dangerously-skip-permissions` and `--agent` after an auto-update relaunch
- Fixed a per-turn slowdown when a language server publishes project-wide diagnostics for thousands of files
- Fixed subagents with `model: "opus"` on Bedrock, Vertex or Foundry leaving the session's model when its id has no recognizable model family (unless `ANTHROPIC_DEFAULT_OPUS_MODEL` is set)
- Fixed self-hosted runner sessions failing every turn with a 401 after a few failed token refreshes, until the next scheduled refresh; the runner now keeps retrying, and fetches a new token after a 401
- Fixed clickable links to local file paths doing nothing in VS Code and other terminals that require a `file://` URI
- Fixed the transcript renumbering ordered lists in your own messages (typing "3. 2. 1." displayed "3. 4. 5."); numbers and "N)" markers now show as typed
- Fixed AskUserQuestion preview notes being attached to a previously chosen option instead of the highlighted one
- Fixed AskUserQuestion preview mode dropping the highlighted option when submitting a note with Enter
- Fixed a resumed background agent keeping half of an interrupted tool batch when one of its calls was approved with a message
- Fixed a local `claude -p --resume` started with `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` not reporting background tasks the previous process left unfinished
- Fixed the first turn of a cloud session sometimes starting without the tools of an SDK-hosted MCP server that was still connecting
- Fixed background agent notifications claiming the agent had no live background work when it was still waiting on its own background task and would resume
- Fixed error hints in Claude Desktop sessions to suggest slash commands like `/usage-credits` instead of CLI flags that cannot be used there
- Fixed `/schedule` saving a routine's prompt without its message role when Claude writes the routine in the shape that listing routines returns
- Fixed `/status` not showing the `apiKeyHelper` failure that its own error banner told you to check
- Fixed `/fast on` in non-interactive sessions reporting on and then turning off under an organization's managed fast mode policy; it now says the organization has disabled it
- Fixed the Artifact tool asking you to approve an update to an artifact that it then refused because the session had not read the latest version
- Fixed Cowork and claude.ai cloud sessions with network access on treating reads of a teammate's artifact as if network access were off
- Fixed a plugin or marketplace directory with no git repository of its own taking its version from an enclosing git repository, such as a git-managed `~/.claude`
- Fixed `--strict-mcp-config` with an empty `--mcp-config` holding the first non-interactive turn for up to `MCP_TIMEOUT` on incidental MCP servers
- Fixed Stop prompt hooks re-sending their whole prompt on every block in a conversation; repeat blocks now name the condition with a 500-character label
- Fixed extra empty editor windows opening at startup on Linux under Wayland when running inside the Cursor or VS Code terminal
- Fixed an unhandled promise rejection in the Claude apps gateway when Postgres drops a connection during a spend check
- Fixed Claude apps gateway cutting every open stream on SIGTERM: it now lets in-flight requests finish for up to 25 seconds before exiting (`CLAUDE_GATEWAY_DRAIN_TIMEOUT_MS`)
- Fixed `installed_plugins.json` being rewritten on nearly every start-up when plugin policy comes from remote managed settings, which made Claude Desktop reload every open session's plugins
- Fixed headless and SDK sessions making a separate model call for every background task that finished; completions already queued are now answered by one call
- Fixed the Bash tool re-sourcing the shell profile (a multi-second stall on the next command) after every plugin reload; it now does so only when the plugins' `bin/` directories changed
- Fixed plugins with a top-level `$schema` in `hooks/hooks.json` showing an "unknown key" notice
- Fixed MCP connection errors and the MCP login tool's description showing secrets resolved from `${VAR}` placeholders in MCP configs
- Fixed Bash permission checks for commands that loop over or assign certain special shell variables; these commands now ask for permission
- Fixed worktree-isolated sessions accepting Bash commands with certain nested shell expansions; these are now refused
- Fixed the Edit permission prompt preview sometimes showing a different location than the approved edit in files with multi-byte characters
- Fixed background commands being stopped after 30 idle minutes on machines under mild memory pressure; they're now stopped only when memory is critically low, and the debug log says why
- Fixed a message a subagent sends to the main session disappearing from the Claude Desktop transcript after a relaunch
- Fixed a plugin loaded from a `.zip` being served from a stale extraction after several overlapping reloads
- Fixed a sub-agent's progress summary being replaced by a runaway multi-paragraph reply
- Improved startup in `--input-format stream-json` sessions: the first turn no longer waits up to 2s for still-connecting MCP servers whose tools tool search defers; they arrive on a later turn
- Improved Monitor tool notifications: a script's final output and its exit now arrive as one notification instead of two, saving a model turn
- Improved Artifact tool errors: when you are not signed in to claude.ai the terminal now says so on the first attempt, and Claude is told to stop retrying a rejected call sooner
- Improved artifact publishing: a publish built on an older version is stopped before it is sent, with the newer page to merge
- Improved safety checks before removing an agent worktree that contains submodule checkouts
- Improved `OTEL_LOG_RAW_API_BODIES=file:<dir>` output: a new `index.jsonl` and `request_body_id` / `message.id` event attributes link each response to its request file and transcript message
- Improved Claude apps gateway boot: it now tries the first Postgres connection up to three times before exiting, so a database that is reachable a few seconds late no longer fails the boot
- Improved the Claude apps gateway's spend-limit check under load: it now takes one database round trip instead of four, so fewer checks time out on a busy gateway
- Improved Claude apps gateway sign-in rate limit errors: `/login` now explains the refusal, and the gateway log says which limit was hit and which setting to change
- Changed Bedrock, Vertex, Foundry and telemetry-disabled installs to use the v2 MCP client and MCP 2026-07-28 negotiation with direct HTTP servers by default, as other installs already do (opt out: `MCP_SDK_GENERATION=v1` or `MCP_PROTOCOL_NEGOTIATION=legacy`)
- Changed `/code-review` to use leaner inline review prompts for every model that has no tuned settings of its own, instead of spawning many review subagents
- Changed `"type": "sdk"` MCP entries in `.mcp.json`, settings, plugins and agent files to be skipped with a warning: only an SDK host application can register in-process servers
- Changed artifact watching in local sessions: a new version published elsewhere no longer starts a turn; Claude learns of it from a later Artifact tool result
- Changed plugin and marketplace clones to leave Git LFS files as pointers instead of downloading them; `git lfs pull` in the checkout fetches them
- Changed self-hosted runners to skip a read-only repository the git host refuses at the access check instead of failing the session start
- Changed the `/status` GitHub line to read "Cloud sessions", and `/web-setup`, `/ultrareview`, and teleport messages to say "cloud session" instead of "Claude Code on the web"
- [VSCode] Added continuation of the step a window reload interrupted, labeled in the chat, with a Claude Code: Continue After Reload setting to turn it off
- [VSCode] Added Memory and Instructions entries to the Customize menu: Memory shows the auto-memory toggles, the saved memories and the memory folders, and Instructions edits the CLAUDE.md files
- [VSCode] Added a `claudeCode.lockEditorGroups` setting to stop Claude from locking the editor groups it opens in
- [VSCode] Fixed a `/btw` side question asked in a new conversation's first seconds occasionally showing another session's side-question history
- [VSCode] Fixed a brief freeze when the extension first looks up your global gitignore file
- [VSCode] Fixed a message sent while Claude was running a tool disappearing from the conversation after a window reload
- [VSCode] Fixed the Manage Plugins enable toggle and MCP servers dialog rows being unreachable from the keyboard
- [VSCode] Fixed sign-ins and sign-outs made in a terminal not showing until a reload after `CLAUDE_CONFIG_DIR` changed in the Environment Variables setting
- [VSCode] Fixed Edit diffs in the chat being cut off at the bottom at some panel widths and for long wrapped lines; diff boxes now fit the rows shown
- [VSCode] Fixed overlapping settings writes from the extension leaving `~/.claude/settings.json` unparseable or dropping a setting
- [VSCode] Fixed Open in New Tab (Ctrl/Cmd+Shift+Esc) sometimes leaving the new tab's message box unfocused, so typing went nowhere until you clicked it
- [VSCode] Fixed reopening a closed Claude tab splitting the editor layout when its locked group still holds another Claude tab and a file
- [VSCode] Fixed New session opening another locked editor group whenever a file tab shared the group with your Claude tab
- [VSCode] Fixed session names shifting sideways in the session picker while typing a search query
- [VSCode] Fixed the plan review card cutting off its Send feedback button and reason field when a plan has several comments; the comment list now scrolls
- [VSCode] Fixed inline code and code blocks in chat replies being unreadable under the High Contrast themes
- [VSCode] Improved screen reader navigation of the conversation: each message is announced as "You" or "Claude", with the tool name for tool steps
- [VSCode] Changed the default global gitignore file to `$XDG_CONFIG_HOME/git/ignore` when `XDG_CONFIG_HOME` is an absolute path
- [Claude Code on the web] Added a "Compare against" branch picker to a cloud session's diff view, so you can diff its changes against any branch instead of only the base branch
- [Claude Code on the web] Fixed git operations in cloud sessions failing with "service unavailable" when GitHub's token renewal briefly errors
- [Claude Code on the web] Fixed editing a routine occasionally making it fire twice or re-enabling a routine that had just been paused
- [Claude Code on the web] Fixed commits in cloud sessions occasionally failing with a signing error for a few minutes after the session's credentials refreshed
- [Claude Code on the web] Fixed the toast after saving a routine whose GitHub trigger couldn't be linked to show the reason, such as a per-repository trigger limit, instead of only "edit to retry"
- [Claude Code on the web] Fixed sessions sometimes flipping back to unread right after you mark them read
- [Claude Code on the web] Changed routines to skip a run and retry for up to 72 hours when the owner's GitHub connection is missing, instead of switching the routine off at the first failed check
- [Claude Code on the web] Changed a routine's on-hold notice: when your subscription is paused it now tells you to turn the routine back on yourself instead of promising an automatic resume
- [Claude Tag] Added a Guests setting to the Add channel and Add workspace forms in Claude Tag admin settings, so owners can pick Inherit, Allow, Channel only or Restrict up front
- [Claude Tag] Fixed Claude not answering when another Slack app or bot @mentions it; the tag now gets a reply and wakes Claude in a channel it had stopped following after days of inactivity
- [Claude Tag] Fixed Claude missing another app's message that tagged @Claude right after a new Slack channel was created; it's now delivered once Claude has joined
- [Claude Tag] Fixed Claude folding a follow-up sent minutes after its last Slack message into it as a silent edit; late updates such as blockers now post as a new reply that notifies
- [Claude Tag] Fixed Claude's Slack search failing with an error whenever it searched within a single channel; it now returns that channel's matching messages
- [Claude Tag] Fixed a safety-filter stop silently resetting a Slack thread's context when nobody was waiting; Claude now always says so and no longer cancels background work still running
- [Claude Tag] Fixed email addresses in Claude's Slack replies rendering with a visible `mailto:` prefix; they now show as the plain, clickable address
- [Claude Tag] Fixed Claude refusing to watch an Enterprise Grid channel shared with the whole organization when asked from another workspace in the grid
- [Claude Tag] Fixed the Environment picker in Claude Tag admin settings showing a raw environment ID instead of the environment's name for archived or app-created environments
- [Claude Tag] Improved Claude's live progress checklist in Slack: capped at 2,000 characters, reposted at most every 15 minutes in busy threads, with older "Latest task list" links updated
- [Claude Tag] Removed the repeated guest-attribution note Claude appended to a Slack canvas each time it edited one in a channel using the "Channel only" guest setting
- [Code Review] Fixed re-reviews occasionally leaving a fixed finding's thread open when the new review also filed a lower-severity note under it
- [Code Review] Fixed rare reviews ending with "Code review encountered an error" when GitHub or an internal service failed transiently at launch; they now wait and retry
- [Code Review] Improved how Code Review words each posted finding: short plain sentences that say who is affected, where the code goes wrong, and the fix up front
- [Code Review] Improved the check-run card and PR comment when a review is skipped because of an organization limit: each cause now links the admin page that fixes it
v2.1.2732026/09/16 · 1 天前

权限隔离、会话连接、可靠性综合加强

稳定性加固
亮点
  • 修复权限检查在 eval、env -C 等复杂 Bash 命令中的误判,防止危险操作被误放行
  • Remote Control 会话支持 fork 后台分支,修复后台代理结果丢失导致任务失败Remote Control 用户
  • MCP 服务器断开时自动通知,修复 OAuth、Bedrock、Vertex 等多种认证连接问题
  • Artifact 发布网络中断后安全重发,单字段更新,改进文件类型错误提示
  • 登录、Gateway、SSL 证书等错误消息现指出具体原因和解决方案,加快问题排查
  • 长会话中 hook 进度和子代理活动不再全量重新处理,响应性大幅提升
展开官方原文 ↓
## 2.1.273

- Added `x-claude-code-request-class`, `x-claude-code-agent-type`, `x-claude-code-prev-tool-durations`, `x-claude-code-compaction` and `x-claude-code-context-compacted` request headers for LLM gateways; opt in with `CLAUDE_CODE_GATEWAY_HINT_HEADERS=1`
- Added a notification when an MCP server disconnects mid-session and automatic reconnection gives up, pointing at `/mcp`
- Added forking a session started with `claude --remote-control` or `/remote-control` from the Claude app; the fork runs as a background session on your computer
- Fixed Bash commands the permission checker cannot fully analyze skipping the prompt under `permissions.blockReadsOutsideWorkingDirectories`, and a subshell hiding a dangerous `rm` in bypass mode
- Fixed skills synced from claude.ai staying available after your organization turns Skills off; they now move to the recoverable trash
- Fixed `allowManagedMcpServersOnly`, `deniedMcpServers` and `disableClaudeAiConnectors` set via MDM or `managed-settings.json` being ignored when server-managed settings are also present
- Fixed 401/403 errors on Bedrock, Vertex and Foundry, and Claude apps gateway 403s, telling you to run `/login`; the message now names the credential to refresh or points to your gateway administrator
- Fixed `/login`, `/upgrade`, and `/extra-usage` discarding earlier thinking from the conversation, which forced a full prompt-cache rewrite on the next request
- Fixed auto mode stopping for approval when the Artifact tool uploads a file you attached to the chat in a cloud or Remote Control session
- Fixed a long-running session recreating a stub `.git/info/exclude` after the repository's `.git` directory was removed or moved away
- Fixed the main prompt dropping a `!` typed at the start while already in shell mode, so negated commands like `! grep …` can be typed
- Fixed Read on macOS refusing a dragged-in screenshot, or any file the system reports under a second path, with "symlink resolution changed after permission was checked"
- Fixed `permissions.blockReadsOutsideWorkingDirectories`: a memory directory chosen by a repository's settings is no longer loaded into the prompt, recalled, indexed, or used by memory extraction
- Fixed sub-agents and background agents being reported as failed, with their result never delivered, when the final streamed reply omitted token usage or carried no model id
- Fixed the context meter and auto-compact counting advisor-tool turns at roughly twice their real context size, which made auto-compact fire at about half the real window
- Fixed `/tui` refusing to restart because of an agent-team teammate that had already finished its work and was no longer shown in the agents panel
- Fixed saved scheduled tasks running in the wrong session after `.claude/scheduled_tasks.json` was copied into another folder, such as a new worktree
- Fixed SDK and `--output-format stream-json` output dropping a subagent's remaining messages and final report after it is moved to the background mid-run (e.g. by `CLAUDE_AUTO_BACKGROUND_TASKS`)
- Fixed `/install-github-app` reporting a SAML single sign-on block as "admin permissions required"
- Fixed Remote Control clients attached to a Claude Desktop, VS Code or JetBrains session being refused when they ask for the session's context window usage
- Fixed the spinner showing a doubled ellipsis ("……") on compaction status lines such as "Running PreCompact hooks…"
- Fixed a false-positive spinner tip suggesting the frontend-design plugin after reading or publishing Artifacts
- Reverted a 2.1.268 change that checked Read and Edit deny rules on Bash lines the permission checker can't analyze (`eval`, `env -C`); commands like `time -p make build` prompt again instead of being denied
- Improved responsiveness in long sessions: hook progress and sub-agent activity no longer re-process the whole conversation on every update
- Improved the Artifact tool's error when a publish includes a file type artifacts don't serve: Claude is told which types are served and what to do instead, and the terminal shows one plain line
- Improved the Artifact tool's page read to state the capabilities and database rules the artifact service holds for the page, for anyone who can publish to it
- Improved artifact database writes: an update can now remove a single field instead of rewriting the whole document
- Improved artifact publishing: a publish whose connection drops after reaching claude.ai is now re-sent safely instead of failing or creating a duplicate version
- Improved the cloud-session GitHub error for an IP allow list, a suspended app installation or SAML single sign-on to show the cause instead of a generic install hint
- Improved `/autofix-pr`: when `gh pr view` fails it now shows gh's own error (sign-in, SAML, rate limit) instead of a generic exit-code line
- Improved `/autofix-pr` to say why GitHub webhook delivery couldn't be set up for the PR (for example, no linked GitHub account) instead of a generic warning
- Improved `/web-setup` errors: a refused GitHub token now lists the likely reasons and the fix, and a connection failure names a configured proxy or TLS certificate problem
- Improved the in-session SSL certificate and proxy connection errors to name the error code and what to fix, such as `NODE_EXTRA_CA_CERTS` for an untrusted corporate CA
- Improved the error when a cloud session can't be created because your Claude login expired or was revoked: it now tells you to run `/login`
- Improved the error shown when an MCP server's sign-in expires mid-session to say how to re-authenticate (`/mcp`)
- Changed auto mode on Bedrock, Vertex and Foundry to use the local classifier by default for now; set `CLAUDE_CODE_AUTO_MODE_SERVER=1` to use the platform's server-side classifier
- Changed `OTEL_LOG_TOOL_DETAILS=1` to also include real agent, skill, plugin and MCP server names on cost and token metrics
- Changed sign-in with a Claude account to also request access to your claude.ai plugins
- Changed `/bug` and `/feedback` reports to include only model-behavior params (model, system prompt, tools) from the last API request, omitting request metadata and `CLAUDE_CODE_EXTRA_BODY` fields
- [VSCode] Fixed "Report a problem" still appearing, and `/bug` / `/feedback` opening a report form, for organizations that have product feedback disabled
- [VSCode] Fixed a red "Claude Code process exited with code 4294967295" banner appearing after completed turns on Windows
- Windows: Improved the network-path permission check for UNC paths when a mapped network drive was added with `--add-dir`
- [Claude Code on the web] Fixed routines losing access to an organization connector, and still calling the old one, after an admin removed and re-added that connector
- [Claude Code on the web] Fixed creating a self-hosted environment from organization settings occasionally failing with a server error and leaving a half-created environment behind
- [Claude Code on the web] Changed the admin "Share cloud sessions" setting to live under Data and privacy instead of the Claude Code page, where Data and privacy admins can also manage it
- [Claude Code on the web] Added a "Discard unsaved changes?" confirmation before the New routine page or the Edit routine dialog throws away a routine name, prompt or edit you typed
- [Claude Code on the web] Removed the full-page desktop-app download screen that new users without a cloud environment saw on Mac and Windows; they now go straight to setup
- [Claude Code on the web] Improved the routine detail page: menu and rename in the breadcrumb, the on/off switch and Run now at the top, and run history beside the routine's settings
- [Claude Tag] Fixed Claude going silent minutes after reinstalling the app when an Enterprise Grid was disconnected but one of its workspaces stayed connected
- [Claude Tag] Fixed scheduled tasks set up in an organization-shared private Slack channel silently never posting; they now keep running in the thread they were created in
- [Claude Tag] Fixed replying in an older Slack thread while Claude is mid-task sometimes restarting it from scratch and losing work it had not pushed yet
- [Claude Tag] Fixed Claude occasionally dropping a message with an incorrect "couldn't find a Claude Code environment" notice right after your account token refreshed
- [Claude Tag] Fixed AWS connections refusing region-less endpoints such as Budgets, Savings Plans, WAF Classic and Import/Export; Global Accelerator requests now sign correctly
- [Claude Tag] Improved AWS connection failures: when a request can't be signed, such as a hostname with no region, Claude is told why and how to fix it instead of a bare error
- [Claude Tag] Fixed OAuth client-credentials and JWT-bearer connections failing with providers that return a lowercase token type; requests now send the standard Bearer scheme
- [Claude Tag] Fixed adding a channel manager being refused on Enterprise Grid shared channels, on channels where Claude hasn't been used yet, and on legacy private channels
- [Claude Tag] Changed Claude to start watching related public channels on its own, such as an incident channel a conversation depends on, instead of only when asked
- [Claude Tag] Fixed the admin Memory page not listing Slack channels Claude set up on its own even when they had saved memory; admins can now open, edit and delete that memory
- [Code Review] Fixed merging the base branch into a PR whose earlier review listed "Additional findings" triggering a full re-review; these pushes now get the lighter follow-up review
- [Code Review] Fixed a whole REVIEW.md being ignored because of an @-mention, a code span wrapped across lines, or a backticked HTML tag; only lines linking to changed files are withheld
- [Code Review] Improved suggested fixes to say what the fix must keep working when other code depends on the behavior being changed
- [Code Review] Improved review comments that point to a second affected location to state that location's issue in a full sentence instead of a cut-off stub
- [Code Review] Fixed `/ultrareview --post` so a retry after a GitHub error posts the findings comment exactly once instead of never or twice; the comment now names the reviewed commit
- [Code Review] Fixed empty or content-identical pushes being re-reviewed on GitHub repositories whose owner or name contains a capital letter; these pushes are now skipped
v2.1.2722026/09/15 · 2 天前

修复与稳定性改进

稳定性加固
亮点
  • 修复了多项已知问题,提升产品稳定性与可靠性。
展开官方原文 ↓
## 2.1.272

- Bug fixes and reliability improvements
v2.1.2702026/09/13 · 4 天前

修复长时间 Session 中只读 Git 命令权限缓存失效

日常修复
亮点
  • 修复 session 运行一段时间后,只读 Git 命令无故触发权限提示的回归(2.1.269 引入)
展开官方原文 ↓
## 2.1.270

- Fixed read-only git commands in Bash unexpectedly asking for permission after a session had been running for a while (regression in 2.1.269)
v2.1.269破坏性变化2026/09/12 · 5 天前

会话恢复、权限规则、终端适配等多项缺陷修复

稳定性加固
亮点
  • 新增 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 规则跨源全局生效,需在所有相关设置源(用户/项目/本地)中各配置一次
展开官方原文 ↓
## 2.1.269

- Added `claude plugin eval`: run a plugin's eval suite against Claude Code and get scored, reproducible results (JSON + HTML report); see `claude plugin eval --help`
- Added `/output-style [name]` to list and switch output styles, including over Remote Control and in cloud and other headless sessions
- Added a diff of the files a Bash command changed to the Bash tool result when the Bash tool handles file edits (setting `bashEditDiffEnabled`)
- Added `OTEL_METRICS_INCLUDE_REPOSITORY` to tag OpenTelemetry metrics and events with `vcs.*` repository attributes; commit events get `vcs.ref.head.*` with `OTEL_LOG_TOOL_DETAILS`
- Added `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` to extend the LLM gateway `/v1/models` discovery timeout (default 3s)
- Added a spinner tip suggesting `/focus` for a view with just your prompt, a one-line work summary, and the response
- Added `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` (1–256) to raise the Workflow tool's per-run concurrent agent limit for inference-bound fan-outs
- Fixed the prompt cache being partially invalidated on the turn after a response was cut off at the output-token limit and automatically resumed
- Fixed a case where resuming a session after interrupting Claude mid-thought could change how earlier context was re-sent, hurting prompt-cache reuse
- Fixed F1/F2/F4 not working in kitty-protocol terminals and Delete in st, Alt+arrows acting as Escape in rxvt-unicode, and Shift+punctuation typing the unshifted key in WezTerm (regression in 2.1.247)
- Fixed remote and headless sessions reporting "waiting for your input" while background agents were still running (set `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING=0` to restore the old behavior)
- Fixed the terminal's replies to capability queries (`^[[?1;2c`) appearing as stray text at startup in some terminals
- Fixed rows at the top or bottom of the transcript going blank in fullscreen after resizing the terminal
- Fixed a deny or ask permission rule starting with `!` applying beyond the settings source that wrote it; such a rule now applies only within its own source, and a bare `!` negation is ignored
- Fixed the git status Claude is told after a compaction: it is now the current status, not the one from the start of the session
- Fixed synced plugin MCP servers not connecting when a remote session resumes
- Fixed resumed headless sessions losing a turn's replies when the model was switched or a request was retried mid-turn
- Fixed terminal escape codes, line breaks and oversized text from a background task's on-disk record reaching the task list and task notifications when work is resumed
- Fixed CMYK JPEG images failing to attach with "cannot decode"; they are now converted and resized like other JPEGs
- Fixed the managed settings approval dialog not naming the collector for a gRPC telemetry endpoint set without a scheme
- Fixed plugin `headersHelper` consent prompts showing a URL path that could be misread as a different host
- Fixed plugin errors showing `[redacted URL]` in place of a relative Windows path with a folder name that starts with `@`
- Fixed missing cursor in the permission-rule, auto-mode-rule, add-directory, session-rename and feedback-review text fields when the terminal's native cursor is enabled
- Fixed repeated clicks on a `/fork` receipt, each under a second apart, never backgrounding the session right away while it waited for the current tool to finish
- Fixed plugin LSP servers that reject `shutdown` params (e.g. rust-analyzer) being left running at session end; `exit` is now sent even if `shutdown` fails
- Fixed the attribution reminder overriding a CLAUDE.md or memory rule against commit and pull request attribution; lines set by managed settings still apply
- Fixed prompt suggestions being dropped for text in Japanese, Chinese, Thai and other languages written without spaces between words
- Fixed synchronized output being assumed from the terminal's name in GNOME Terminal and Konsole versions that do not support it
- Fixed `permission_denials` in `--output-format stream-json` results omitting Read, Edit and Write calls blocked by a path-scoped deny rule
- Fixed sessions run through the SDK or the desktop app showing an unknown status in other sessions' agent list
- Fixed `/insights` failing on Bedrock, Vertex, Foundry, and gateway deployments whose account can't reach the default Opus model by using the session model there instead
- Fixed organization policy limits not loading for the session when another Claude Code process refreshed the login at the same moment
- Fixed Claude Desktop sessions using Bedrock, Vertex, or a gateway not getting the contextual "what Claude needs" turn-end notification text
- Fixed MCP servers reconnecting when an updated config only changed the order of the server URL's query parameters
- Fixed the prompt box's top border splitting into extra lines when viewing a background agent whose name or description has line breaks or is wider than the terminal
- Fixed sessions getting permanently stuck on "Prompt is too long" when auto-compaction had no complete earlier exchange to summarize (mostly Agent SDK sessions with very large prompts)
- Fixed `/goal` runs silently stalling after API errors, network drops, or token limits: the goal now retries with backoff, or pauses and says why, including until a usage limit resets
- Fixed prompt cache misses in cloud sessions by waiting briefly for server configuration before the first request
- Fixed `/btw` answers that contained made-up tool calls and output: the side question is now told not to write them, and any that appear are flagged as not executed
- Fixed `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` re-running a turn that had failed with an API error over 6 hours earlier, or longer ago than `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` when set
- Fixed organization plugins enabled through managed settings not loading in headless sessions and on Claude Desktop (once Desktop bundles this CLI version); they load from the next session
- Fixed plugin archives extracted for a session being readable by other local users, extracted files keeping world-writable bits from the archive, and stale files surviving re-extraction
- Fixed `Edit()` deny rules and the write-path check not applying to the file a Bash `tee` command writes; a `Bash(tee:*)` allow rule no longer covers destinations outside the working directories
- Fixed stray characters like `22c`, or a terminal's color or version reply, being typed into the prompt at startup over slow connections (ssh, browser terminals)
- Fixed the terminal's block cursor showing under the interface in rxvt-unicode after leaving or re-entering fullscreen
- Fixed the cursor block staying visible after returning from an external editor in fullscreen mode on rxvt-unicode
- Fixed the interface being drawn twice after returning from an external editor (Ctrl+G) outside fullscreen mode
- Fixed the interface being drawn twice in Konsole after returning from an external editor
- Windows: Fixed PowerShell tool commands sent to the background stopping when Claude Code exits
- Improved the `/diff` panel to open fully rendered in one step instead of showing a loading state first
- Improved prompt suggestion filtering for Japanese, Chinese and Korean text: mixed-script and single-word suggestions are kept, and meta or evaluative text is dropped as it is for English
- Improved the Skill tool's "Unknown skill" error to name the plugin skill's full name when a bare name matches exactly one plugin skill
- Improved keyboard support over SSH and in unrecognized terminals: terminals that answer the kitty keyboard query (such as foot and Alacritty 0.16+) now get Shift+Enter and Ctrl+Shift shortcuts
- Improved responsiveness in long sessions: transcript updates no longer re-process the whole conversation to build the collapsed tool-use summaries
- Improved first-party sessions with telemetry disabled: an `alwaysLoad` MCP server that finishes connecting mid-conversation is usable on the next turn without a tool-search round trip
- Changed `/ultrareview --post` to post the PR comment directly when the findings arrive and print the comment link, instead of starting a second cloud session to post it
- Changed artifact database reads that save into the session scratchpad so they no longer stop for working-folder approval
- Changed skills synced from claude.ai in cloud sessions to be named `anthropic-skills:<name>`, matching Claude Desktop; the bare name still works when nothing else uses it
- [VSCode] Added an agent map: an "N agents" footer pill opens a map of the session's sub-agents with per-agent cards, Stop agent, and read-only transcripts
- [VSCode] Added a Hooks dialog to the command menu for viewing hooks and adding, editing, or removing them in user, project, and local settings; managed, plugin, and session hooks stay read-only
- [VSCode] Added live progress rows for running subagents under the tool-call groups in Focus view
- [VSCode] Added a Permission rules dialog that lists permission rules and adds or removes them in user, project, and local settings; startup-option, session-only, and managed rules stay read-only
- [VSCode] Added a Cancel button to the Switch account screen that returns to your session as the current account
- [VSCode] Fixed Focus view showing a turn started by a delivered plain-text prompt, such as a scheduled task's, as part of the previous turn
- [VSCode] Fixed the footer's prompt cache clock hiding its minutes when the panel is narrow
- [VSCode] Fixed the session list keeping sessions from the default folder when `CLAUDE_CONFIG_DIR` is set in a settings file or the `environmentVariables` setting
- [VSCode] Fixed a plan preview that finished loading late sometimes hiding its comment box or showing an older plan
- [VSCode] Fixed a plan preview accepting comments that went nowhere after its Claude tab closed
- [VSCode] Fixed the prompt cache clock and reopen notice for a session compacted after its last reply and then closed, which now reads as cold when reopened
- [VSCode] Fixed a session renamed in the extension while Remote Control is on keeping its old name on claude.ai/code
- [VSCode] Fixed the "Enable Remote Control for all sessions" toggle keeping its last position after the setting was reset to default from a terminal
- [VSCode] Fixed restored Claude tabs not counting as open in the session list after a window reload until clicked, and their row opening a second tab
- [VSCode] Fixed Switch account making a tab forget its dismissed usage-limit warnings when you sign back in as the same account
- [VSCode] Fixed a session rename being replaced by the generated name after a window reload when the session was renamed during a long turn
- [VSCode] Fixed the sidebar usage meter keeping a stale per-model weekly limit row after the account loses that limit
- [VSCode] Fixed a rare case where an @-mention sent with the keyboard shortcut while a new chat view was still starting could be inserted into the input long after the keystroke
- [VSCode] Fixed the session list jumping down when the Account & usage header appeared a moment after opening the Claude side bar
- [VSCode] Improved documents and messages written for someone other than the user: Claude now writes them for that audience and names it at the top of its reply
- [VSCode] Improved screen reader and keyboard accessibility in the slash-command menu, @-mention menu, output-style picker, Send/Stop button, permission and question cards, and onboarding checklist
- [VSCode] Changed the current-file chip in the message box: an X now removes it, replacing the Hide toggle
- [VSCode] Removed the Claude Code items from a session tab's right-click menu and the editor title bar's "..." menu; they could not act on the tab the menu was opened on
- [Claude Code on the web] Added taking back a queued message in a cloud session before Claude reads it: remove it from the queue, or press Esc or Up, and the text returns to the message box
- [Claude Code on the web] Fixed `/model default` in a cloud session leaving every later message failing in organizations that restrict which models Claude Code can use
- [Claude Code on the web] Fixed one-off scheduled routines occasionally running a second time after a transient server error
- [Claude Code on the web] Fixed routine runs that use subagents sometimes being treated as finished too early, which could skip the retry after a real failure or start a duplicate run
- [Claude Code on the web] Fixed file links in cloud session transcripts opening a GitHub 404 when Claude was working from a subfolder of the repository
- [Claude Code on the web] Changed the Cloud environments admin page to list every environment instead of capping each table at five rows behind a Show more control that could be unreachable
- [Claude Code on the web] Changed claude.ai/code for Free-plan users to open the plans page with a path to upgrade, instead of a "Disabled by org admin" page with no way forward
- [Claude Tag] Added a confirmation dialog before Connect all or Disconnect on a GitHub installation in admin settings, to guard against accidental organization-wide changes
- [Claude Tag] Fixed threads occasionally going silent after a failed turn because the failure notice was dropped when Slack briefly rate-limited it; the notice is now retried
- [Claude Tag] Fixed Claude accepting a switch to a model your organization hasn't enabled and then quietly answering with a fallback model; it now declines and says an admin can enable it
- [Claude Tag] Fixed a table posting as raw pipe text when Claude attached files to the same message; the table now posts as a normal reply and the files follow with a plain caption
- [Claude Tag] Fixed `@Claude !restart` at the top level of a channel where Claude isn't active starting an unrelated conversation; it now privately says there is nothing to restart
- [Claude Tag] Fixed plugin rows in Slack access settings showing an unlabeled raw ID with no way to turn the plugin off; they now show its name and link to the bundle that manages it
- [Claude Tag] Fixed the shared-session banner and Share dialog on sessions started from Slack claiming the whole organization could open the link; they now name the Slack channel's audience
- [Claude Tag] Improved load time of the admin settings page and its Slack channel picker, most noticeably for organizations with many channels or several connected workspaces
- [Claude Tag] Improved scheduled routines in Slack channels: a routine run can now reply in an existing thread instead of always posting a new top-level channel message
- [Claude Tag] Improved the timestamp on Claude's live progress checklists to show each reader's local time and how long ago it was updated, instead of a fixed UTC time
v2.1.268破坏性变化2026/09/11 · 6 天前

权限规则精细化与安全边界强化

亮点
  • 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)规则。
展开官方原文 ↓
## 2.1.268

- Added to the Claude apps gateway: with `pricing:` set in `gateway.yaml`, signed-in Claude Code clients receive the same rates through managed settings, so `/cost` and telemetry match the spend meter
- Added a startup warning for gateways when `access_control.allow_cidrs` is empty, and a one-time warning the first time a request arrives from a public address
- Added the `gatewayInternalNetworks` managed setting, letting administrators allow `/login` to a Claude apps gateway on their organization's own public IPv4 block
- Added `claude self-hosted-runner --remove-session-state` (default off): delete each session's per-session directories under `<base-dir>/_sessions/` when the session ends
- Added `configDirectory` to the output of `claude auth status --json`
- Added `--json` to `claude plugin install`, `uninstall`, `update`, `enable` and `disable`, and `errorDetails`/`noteDetails` to each row of `claude plugin list --json`
- Added browser-tab icons for published artifacts, chosen by Claude to match each page
- Fixed every turn failing with HTTP 400 on third-party Anthropic-compatible endpoints (`ANTHROPIC_BASE_URL`) since 2.1.265: a regex in the Artifact tool's input schema that those endpoints reject
- Fixed WebFetch hanging indefinitely on a server that keeps the response open without finishing; a fetch now fails after 300 seconds. Set `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` to override the deadline (0 turns it off)
- Fixed a respawned in-process teammate picking up tools or a system prompt from a same-named agent file in a folder you have not trusted
- Fixed sustained high CPU usage: a busy loop in long-running idle sessions no longer pins a CPU core, and rapid terminal focus reports during a session recap no longer keep the CPU high
- Fixed Claude sometimes replying "your message came through empty" after an MCP tool call
- Fixed deny and ask permission rules on symlinked directories (`/etc`, `/tmp`, `/var` on macOS; `/bin` on Linux) not applying when a path was given by its real location, and Bash commands ignoring deny rules written on a symlinked path spelling
- Fixed a case where a Read or Edit deny rule did not apply when an `env -C`, `eval` or similar command the permission checker cannot analyze was on the same line
- Fixed plugin and marketplace errors showing a token or password from a git source URL
- Fixed `/mcp` and `/plugin` server details, `claude mcp list`/`get`, and MCP login errors showing secrets resolved from `${VAR}` placeholders in MCP configs
- Fixed prompt caching and extended thinking breaking mid-session for SDK sessions using `excludeDynamicSections`: the first message is no longer re-rendered each request
- Fixed entitled users being told a model is restricted after restart or in the Desktop Code tab when a cached model-access denial was stale
- Fixed a running session silently switching to the organization's default model when another Claude Code process refreshed a stale model-access entry
- Fixed long-context 429s on Fable models showing the usage-credits consent prompt instead of the 1M-context message on Pro and Team plans
- Fixed workload identity federation via a profile (as claude-code-action configures it): processes sharing the profile could fail mid-run with `401 … jti reused`
- Fixed MCP server OAuth sign-in failing with "No available ports for OAuth redirect" when the local callback port range can't be bound
- Fixed the conversation summary produced by `/compact` and auto-compact mangling text that contained `$` sequences
- Fixed resuming a conversation that ended with `/compact`: its restored-file notes now load in the same order on every resume
- Fixed SDK prompt suggestions, side questions and `/rename` sending the conversation from before a compaction
- Fixed `@` file and `/` command suggestions not appearing after recalling a previous prompt with the up arrow and editing it
- Fixed `claude agents`: pressing ← again at a natural pace to go back to the agent list no longer gets ignored until you pause for over a second
- Fixed `claude agents` session delete getting stuck when a worktree can't be removed: the message names the cause and next step, and for a git worktree ctrl+x again deletes the directory anyway
- Fixed background agent and workflow rows in the agents panel expanding to many lines when their text contained line breaks
- Fixed Claude in Slack sessions losing their Slack tools when org managed settings set an MCP allowlist
- Fixed Claude in Chrome asking to allow the host "https" when a navigation URL had a scheme but a host that could not be parsed
- Fixed the spinner wrapping onto several lines when the current task's label is long; the label and the "Next:" task line now stay within one terminal row
- Fixed the `/bug` and `/feedback` description field showing no cursor when the terminal's native cursor is enabled
- Fixed Remote Control sessions served by `claude remote-control` showing a generated name instead of their session title in `ListAgents`
- Fixed `claude plugin validate` rejecting plugin paths whose directory name begins with two dots, which the plugin loader accepts
- Fixed plugins silently skipping a default monitors file or root SKILL.md that could not be checked
- Fixed WebFetch's error for localhost and other dotless hostnames to explain why the URL is refused and suggest curl
- Fixed PermissionRequest hooks not firing in `--print` mode
- Fixed policy-helper warnings not printing on headless (`-p`) runs
- Fixed `/resume` listing a `/fork` background session under its parent's name instead of its own `⑂` fork name
- Fixed `/remote-control` and other claude.ai-gated commands to suggest `/login` when signed out instead of showing a Claude for Enterprise migration message
- Fixed `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` not extending SessionEnd hooks that have no per-hook `timeout` (they were still cancelled after 1.5 seconds)
- Fixed `/autofix-pr` and other cloud-session commands saying to retry or install the Claude GitHub App when no GitHub account is connected; they now point to `/web-setup` or the web connect page
- Fixed cloud-session commands such as `/teleport` and `/remote-env` to explain when an organization policy turns them off, instead of answering "Unknown command"
- Fixed Bash sandbox instructions over-stating confinement: no unenforced path lists when filesystem isolation is off, and strict mode no longer claims commands can never run unsandboxed
- Improved fullscreen mode: adding or removing a prompt line (Shift+Enter) now repaints as fast as typing a character instead of re-rendering the visible transcript
- Improved `--continue` / `--resume`: the conversation appears immediately instead of waiting for SessionStart hooks, and the first message no longer re-reads the whole transcript
- Improved responsiveness during tool-heavy turns by no longer redrawing the transcript for a hidden per-tool-batch reminder
- Improved startup time in projects with `.claude/workflows/` scripts: listing them no longer parses each script
- Improved auto mode denials: the message Claude receives now names the rule that blocked the action and asks Claude to try a safer method and finish unrelated work before stopping to ask you
- Improved Claude in Chrome: long page reads now stay inline instead of being saved to a file and read back
- Improved the MEMORY.md truncation warning to say how many lines were cut and where the cut starts
- Improved the terminal permission prompt for artifacts: it now leads with the ask's question
- Improved the prompt footer: an editor or `/diff` selection now shows inside the prompt input, and fullscreen mode shows Remote Control status in the header instead of the footer
- Improved the "Usage credits required for 1M context" message to say that usage credits turned on mid-session take effect after restarting Claude Code
- Improved `/plugin`: installing, enabling or disabling a plugin now takes effect when you close the menu; `/reload-plugins` is no longer needed afterwards
- Changed the system prompt on Bedrock, Vertex and Foundry to deliver environment, model and settings details as attachments, matching first-party sessions
- Changed Bedrock, Vertex and Foundry sessions to keep the tool list byte-stable across a conversation (late-connecting tools load deferred instead of rewriting it), matching first-party sessions
- Changed the task-tracking tools (TaskCreate/Get/Update/List, TodoWrite) to be offered only on Claude 3.x, Opus 4.0–4.7, Sonnet 4.0–4.6, Haiku 4.5; set `CLAUDE_CODE_ENABLE_TODO_TOOLS=1` elsewhere
- Changed the artifact data-edit permission prompt in the terminal to a card that shows the document count and who can open the artifact
- Changed local Cowork sessions set to skip all approvals: the Artifact tool now refuses a local file outside the session's folders, or behind a symlink, instead of reading it without asking
- Changed plain `WebFetch` deny and ask rules to no longer apply to Artifact tool reads and updates; use an `Artifact` rule (or `WebFetch(domain:claude.ai)`) to block or gate them
- Changed the "N MCP servers need authentication" startup notice to announce each server once instead of at every launch
- [VSCode] Fixed the session list, settings toggles, and chat tabs when `CLAUDE_CONFIG_DIR` is set in a settings file or the `environmentVariables` setting
- [VSCode] Fixed the model pill, model picker and command menu going blank in open tabs for a few seconds after a login, logout or account switch
- [VSCode] Fixed Auto disappearing from the mode picker in new-tab or just-reloaded conversations when a project or local setting overrides the model named in `~/.claude/settings.json`
- [VSCode] Fixed session names reverting to the last prompt after a window reload when a SessionStart hook is configured
- [VSCode] Fixed the footer's model pill and Remote Control pill waiting for the new tab's Claude process to start when another tab in the window is already up
- [VSCode] Fixed a second Claude process running through its full startup when a session tab's launch arrived more than half a second after its config read
- [VSCode] Fixed resuming a session from the session list ignoring `claudeCode.preferredLocation: "sidebar"` (it always opened a panel), and programmatic opens resetting that setting to "panel"
- [VSCode] Fixed Windows issues: the WSL install prompt no longer appears on machines without WSL installed, and IDE diagnostics are now returned correctly for Windows files when WSL is installed
- [VSCode] Fixed the custom style builder saving a User level style in a folder the CLI does not read when `CLAUDE_CONFIG_DIR` is set through settings
- [VSCode] Added Left and Right arrow keys to change where an always-allow permission rule is saved, for keyboard and screen reader users
- [VSCode] Added a "Claude Code: Focus last message" command that moves keyboard focus to the newest message in the conversation, for keyboard and screen reader users
- [VSCode] Changed the Manage plugins dialog to apply installs, enables, disables and uninstalls to open sessions without a restart
- [VSCode] Changed some artifact permission prompts to omit the "don't ask again" choice, matching the terminal
- [Claude Code on the web] Fixed cloud sessions running longer than about six hours silently losing files saved to persisted session folders; saves now persist for up to a day
- [Claude Code on the web] Fixed "Invalid effort level" errors when a routine resumes a session, or a session starts with no set effort, in orgs where an admin caps a model's effort
- [Claude Code on the web] Improved routine creation from a conversation: when the new routine has no connectors, Claude now says so and how to add them instead of only confirming it
- [Claude Tag] Fixed the admin settings page hanging on a loading skeleton or going blank after a transient load failure; a section that fails to load now shows a Retry button
- [Claude Tag] Added a link from a Slack channel's configure page back to the organization's Claude in Slack admin settings
- [Claude Tag] Fixed a Slack Enterprise Grid channel losing its Claude settings (repository, environment, access) after a Slack admin moved it to another workspace
- [Claude Tag] Improved how Claude explains a blocked action: it now says whether a permission check, its own decision to confirm first, or missing access stopped it
- [Claude Tag] Improved reply speed: Claude now runs several read-only lookups (searching Slack, reading a thread, finding people) at once instead of one after another
- [Claude Tag] Improved formatting of comparisons: sentence-length comparisons now come as lists instead of wide tables that scroll sideways, and long table cells wrap
- [Claude Tag] Fixed `@Claude !restart` in a thread with its own session sometimes also posting a contradictory "this thread is handled by the channel session" notice
- [Claude Tag] Improved the message shown when your Claude account is in a different organization than the Slack workspace: it now explains how to connect the workspace to your org
- [Claude Tag] Fixed Markdown links whose URL is wrapped in angle brackets showing as literal bracket text in Slack instead of a clickable link
- [Claude Tag] Fixed a workspace guest's top-level @mention in a channel where guests may use Claude sometimes getting a "your Slack account isn't connected" reply instead of an answer
- [Claude Tag] Fixed a channel's long-running session being replaced with a fresh one mid-conversation; the scheduled refresh now waits until the channel and its threads are quiet
- [Claude Tag] Fixed channel-settings cards clicked more than once telling the proposing session the change was refused after it had already applied; the outcome is now sent once
- [Claude Tag] Changed memory in public channels: each channel now keeps its own notes, and Claude no longer recalls notes it saved in other public channels; workspace notes stay shared
- [Code Review] Added a note under the still-open findings list in follow-up reviews: resolving a finding's thread, not just replying to it, stops later reviews from counting it as open
- [Code Review] Fixed reviews sometimes ending as incomplete when one of the agents verifying a finding failed midway; the review now replaces that agent and reaches a verdict
- [Code Review] Fixed a push-triggered review that was queued behind a running review still posting after the pull request had been converted to draft
- [Code Review] Fixed reviews ignoring a directory's CLAUDE.md conventions when the PR edited a root file (e.g. README.md) that only shares a name with a file that CLAUDE.md lists
v2.1.267破坏性变化2026/09/10 · 7 天前

Prompt 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 和插件功能将被阻止
展开官方原文 ↓
## 2.1.267

- Added `maxEffortLevel` setting (top-level or per model under `modelSettings`): caps the effort level on every provider, including Bedrock, Vertex and Foundry; users can still pick a lower level
- Added `--system-prompt-snapshot off` to render the system prompt fresh on every request instead of reusing the conversation's recorded prompt (for iterating on prompt text)
- Fixed Cowork scheduled tasks in the cloud failing at startup for organizations whose managed settings require sandboxing
- Fixed `/context` and other local command output rendering blank on mobile clients
- Fixed shift+enter and option+backspace not working after reconnecting to a tmux or ssh session inside an agent view
- Fixed the dim last-prompt header not appearing at the top of the conversation when scrolling up in fullscreen mode
- Fixed Workflow `agent()` calls with large output schemas being refused in auto mode instead of being checked by the safety classifier
- Fixed a case where a marketplace entry path containing a backslash could bypass the containment check for fetched marketplaces on macOS and Linux
- Fixed expired AWS or Google Cloud credentials under a host app such as Claude Desktop retrying ten times with a generic "request failed" before the re-authenticate error appeared
- Fixed resuming a session after `/compact` or another slash command ran via `-p --resume`: a spurious "Continue from where you left off." turn is no longer inserted
- Fixed resuming a large session (transcript over 5 MB): parallel tool calls and their hook output are no longer dropped from the reloaded conversation
- Fixed managed `allowedHttpHookUrls`, `httpHookAllowedEnvVars` and `allowedChannelPlugins` to admit nothing, not everything, when unreadable
- Fixed `/login` on machines whose managed settings require Claude apps gateway sign-in: Esc now closes the dialog instead of doing nothing
- Fixed artifact publishes cut off by a dropped connection mid-upload: they now retry once when Claude Code can tell the upload never completed, instead of reporting an unknown outcome
- Fixed `effort:` frontmatter on custom commands, skills, and subagents being ignored on models whose default effort is still pinned (Opus 4.7, Opus 4.8, Fable 5)
- Fixed artifact publish failing with an unhelpful error when the page file isn't valid UTF-8 or contains a replacement character (U+FFFD); the error now names the line and column to fix
- Fixed `claude agents` `@` directory menu not listing repositories created after the session started
- Fixed Remote Control clients that join a Claude Desktop or VS Code session showing a stale permission mode until it was changed again
- Fixed `claude remote-control` exiting and dropping every attached session when its server credential expires (about 30 days after start); the host now re-registers and keeps going
- Fixed the usage-limit warning flickering on and off during a session when requests for different models or modes report different limit windows
- Fixed earlier reasoning being dropped when an MCP server re-sends, or a built-in tool re-renders, a tool the model already loaded
- Fixed a tool that disappears mid-conversation, from a disconnected MCP server or an upgrade, rewriting the tool list and discarding earlier thinking
- Fixed a background worker forked from a conversation adding EnterWorktree to the conversation's tool block mid-session, which broke prompt-cache reuse
- Fixed mid-session MCP and plugin tools being added to the tool list in sessions without ToolSearch, which broke prompt-cache reuse; supported models now receive them as deferred definitions
- Fixed switching models with /model re-sending every tool definition (a prompt-cache miss); commit and PR attribution text now arrives as a conversation note that updates on model changes
- Fixed resumed sessions rewriting the inline tool set when an MCP connector reconnects at a different moment than before
- Fixed resumed sessions re-rendering tool descriptions instead of replaying the recorded ones when the first turn ran a tool
- Fixed prompt-cache misses and dropped extended thinking when a claude.ai connector's tools change between a session and its resume
- Fixed resumed sessions rewriting earlier MCP tool announcements (and dropping extended thinking) before their connectors reconnect
- Fixed a prompt-cache break when a print-mode (`-p`) conversation is resumed interactively: the system prompt prefix no longer changes
- Improved the `/diff` panel: it no longer flashes "0 files changed" and a spinner before settling, and its empty state is centered in the panel
- Improved the Bash tool's description guidance so Claude describes what a command does in plain words instead of echoing the command
- Improved sandbox guidance so Claude suggests `/copy` when clipboard commands such as `pbcopy` fail inside the sandbox
- Improved `--resume` first-render time for sessions with many Bash tool calls
- Improved prompt input responsiveness: keystrokes no longer occasionally wait a frame behind spinner or streaming repaints
- Improved prompt-cache stability: subagents and sessions started with `--system-prompt` or `--append-system-prompt` now record the system prompt and tool definitions once instead of re-rendering them
- Improved Artifact tool publish errors: when a publish is refused, the message now says why and what to do about it
- Self-hosted runner: Changed `--use-anthropic-git-proxy` to be reported to the server at registration and to print a warning for each session that still clones through the legacy git proxy
- Gateway: Changed `forward_user_identity` upstreams to return a 429 as-is to a developer whose email was forwarded, instead of failing over to the next upstream, so the proxy's per-user limits hold
- [VSCode] Fixed the extension host hanging at 100% CPU when forking, editing an earlier message, or rewinding in a conversation whose saved transcript contains a cyclic parent link
- [VSCode] Fixed pasting a screenshot on WSL2/WSLg inserting raw image bytes into the chat input; the image is now attached when the clipboard provides it, otherwise the paste is ignored
- [VSCode] Fixed chat diff blocks always rendering with a dark editor theme; they now follow the active VS Code color theme, including high contrast
- [VSCode] Fixed mixed right-to-left and English text rendering in the wrong order while typing in the message input
- [VSCode] Fixed accepting an edit in the diff view on a file with Windows (CRLF) line endings failing with "String not found in file"
- [VSCode] Fixed @-mentions dropping files whose paths contain spaces
- [VSCode] Fixed the sessions list view failing to load in windows connected over Remote-SSH when the workspace folder exists only on the remote host
- [VSCode] Fixed runaway ripgrep processes when viewing files in large or symlink-heavy workspaces
- [Claude Code on the web] Fixed GitHub Enterprise Server sessions showing your GitHub account as disconnected once its token expired; PR and issue operations now refresh it automatically
- [Claude Code on the web] Fixed `gh` and GitHub API calls failing in organizations without the Claude GitHub App; they now use your connected GitHub account and say so when none is connected
- [Claude Tag] Added a "Use a custom connector" link to the preset connection forms in Claude Tag admin settings, so you can switch to a custom connection without starting over
- [Claude Tag] Fixed Claude replying "The API rejected the request as invalid" when the organization has run out of usage credits; the reply now says so and explains how to add more
- [Claude Tag] Fixed thread requests to edit or delete a message Claude posted at the channel's top level being answered with a correction instead of reaching the session that posted it
- [Claude Tag] Fixed **Connect** on Tool access requests under Admin settings > Review requests failing with "Authorization failed" or showing the requested access bundle as deleted
v2.1.2662026/09/09 · 8 天前

修复 gateway 环境变量与 API 认证的冲突

日常修复
亮点
  • 修复 CLAUDE_CODE_USE_GATEWAY 环境变量的回归,恢复其单独设置时被忽略的行为,解决与 API key、apiKeyHelper 或自定义认证同时使用时导致的 gateway 登录失败gateway 和代理用户
展开官方原文 ↓
## 2.1.266

- Fixed a 2.1.265 regression affecting LLM-gateway and proxy setups: the undocumented `CLAUDE_CODE_USE_GATEWAY` environment variable, previously ignored unless `ANTHROPIC_BASE_URL` and `ANTHROPIC_AUTH_TOKEN` were both set, began forcing Cloud-gateway sign-in on its own in 2.1.265, so configurations that set it alongside an API key, `apiKeyHelper`, or custom auth headers failed every request with "Not signed in to the Cloud gateway". The variable on its own is ignored again; no configuration change is needed
v2.1.265破坏性变化2026/09/09 · 8 天前

Agent 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 同步更新或调整策略
展开官方原文 ↓
## 2.1.265

- Added `user.email` and `user.groups` to the telemetry Claude Desktop and Cowork send through a Claude apps gateway, matching terminal sessions
- Added support for pointing `--plugin-dir` at a folder of plugins: each child folder with a manifest loads, and children added or removed while running are picked up
- Added a 1 GB cap on tool results saved to disk; the in-conversation preview says when a saved file was truncated
- Fixed resuming a foreground-spawned subagent changing its tool list and system prompt prefix, which broke prompt-cache reuse for that agent
- Fixed agent teammates and resumed subagents moving SubagentStart hook context and preloaded skills out of the prompt prefix on later turns, which broke prompt-cache reuse
- Fixed resume after the previous process died while a tool was running: the last prompt is no longer rewritten, and the interrupted tool call is kept and marked interrupted
- Fixed `/model opusplan[1m]` being rejected with "Model not found"
- Fixed syntax-highlighted code in permission prompts and messages sometimes omitting a character after a Ruby `?`, Erlang `$`, or Perl `$` sigil
- Fixed the fullscreen transcript jumping by one row whenever the slash-command or @-file suggestion list opened or closed
- Fixed a plugin path containing a backslash bypassing the symlink containment check on macOS and Linux
- Fixed plugin directories whose names begin with two dots being wrongly refused as outside the plugin root
- Fixed VS Code and SDK sessions occasionally requiring re-login when a session was closed while refreshing its token
- Fixed Remote Control sessions sending the end-of-turn signal before the reply's last message, which could show a reply as finished in the Claude app before its last part arrived
- Fixed background (`--bg`) sessions occasionally being retired mid-turn when a message arrived just before the idle timeout
- Fixed Claude Code's own git status and diff probes running clean filters configured by a nested repository inside the working tree
- Fixed the advisor tool and its instructions being re-decided per request from the request's model; the decision is now made once and announced in the conversation when it changes
- Fixed artifact publish accepting connector tool names the connector doesn't expose; the publish is now refused when none of the declared tools exist, and warned when only some don't
- Fixed `/add-dir <subdirectory>` refusing to load a subdirectory's agents when managed settings lock only skills to plugins, and promising agents when only agents are locked
- Fixed two-key keyboard shortcuts cancelling silently when the second key arrived more than a second later, as happens inside tmux; they now wait 3 seconds and show a notice when they time out
- Fixed forked skills (`context: fork`) not streaming their kickoff prompt and, with `--forward-subagent-text`, their text turns as progress events in stream-json
- Fixed a plugin's default component folder that the OS cannot check, such as a symlink loop, being silently skipped; it is now reported in `/plugin` with the error code
- Fixed the Claude apps gateway's OTLP telemetry relay pausing all forwarding to a collector for 30 seconds after it rejected a few payloads as malformed or too large
- Fixed `/plugin` Discover/Browse and `claude plugin list --json --available` showing no description or display name for marketplace plugins whose metadata lives only in their `plugin.json`
- Fixed `/login` showing "no gateway URL is configured" when re-run in a session that signed in to a Claude apps gateway set by managed settings
- Fixed `/model` claiming a model was "saved as your default" when the settings file couldn't be written; it now says the save failed and why
- Fixed `/clear` from Remote Control waiting on SessionStart hooks and on open terminal dialogs before completing
- Fixed the `/config` dialog changing height when switching between its tabs
- Fixed resuming a workflow run after its container restarted; a resume whose run journal is missing now fails with a clear error instead of rerunning every agent
- Fixed the `claude-api` skill's error-code reference: model access failures return 404 and unavailable beta headers return 400, not 403
- Fixed non-interactive sessions (`-p` with stream-json input, Agent SDK, cloud sessions) resetting the shell working directory at each new user message; a `cd` now persists across turns
- Fixed MCP servers configured as `http` that only speak the legacy HTTP+SSE transport never connecting; Claude Code now falls back to SSE as the MCP spec describes
- Fixed some claude.ai connectors in cloud sessions showing as needing authentication even though they are connected in claude.ai (servers that answer an unsupported request with HTTP 401)
- Fixed remote sessions keeping their sandbox container alive while a connector approval or sign-in link waits for you
- Fixed resumed sessions showing long model-facing recovery instructions in "background task didn't finish" notices instead of a short status line
- Windows: Fixed Read, Write and Edit refusing every file ("symlink resolution changed after permission was checked") when running inside an AppContainer or restricted-token sandbox
- Improved `--worktree` startup on large repositories: the new worktree is now checked out in parallel (git 2.32+)
- Improved `/workflows` agent detail: tool calls are marked running, failed or done, the subagent's task list is shown when it has one, and Enter unfolds the listed calls with their inputs and results
- Improved slash commands typed mid-prompt: matches now show in a list (Tab opens it outside fullscreen) instead of a single suggestion, and a plugin skill is now found by its bare name
- Improved remote MCP servers that need sign-in: Claude Code no longer registers an OAuth client with them until you actually authenticate
- Improved the time to resume long sessions that read many files
- Improved the error shown when an image over the size limits cannot be decoded: it now names the cause and how to fix it instead of only citing the limit
- Improved the Artifact tool's read of an artifact someone else wrote: the summary now treats the page as untrusted content and flags embedded instructions rather than relaying them
- Updated the `.claude` folder permission option to say what it actually allows: editing files in the project's `.claude` folder (or `~/.claude`) for the session
- Changed machines with `forceLoginGatewayUrl` in managed settings to be Claude apps gateway sessions from startup, like `forceLoginMethod: "gateway"`; a leftover claude.ai login or API key is not used
- Changed image processing to use the runtime's built-in image support; the CLI no longer extracts a native image module to the temp directory
- Changed plugin display metadata to prefer the marketplace entry over `plugin.json` on the Installed tab and `claude plugin details`, filling gaps from `plugin.json`
- Changed Claude apps gateway sessions to export OpenTelemetry directly to a collector the gateway's managed settings name in `OTEL_EXPORTER_OTLP_ENDPOINT`, instead of through the gateway's relay; sessions without a named collector still use the relay
- [VSCode] Added automatic archiving of sessions inactive for a set period (new "Archive inactive sessions" setting, default 14 days)
- [VSCode] Fixed the sidebar chat coming back blank after Reload Window or a restart when the conversation had been open for more than 10 minutes
- [VSCode] Fixed the timeline dot sitting below the text on the "Remote Control is active" message
v2.1.2632026/09/06 · 11 天前

缺陷修复与稳定性增强

稳定性加固
亮点
  • 修复多项影响可靠性的缺陷,提升系统稳定性。
展开官方原文 ↓
## 2.1.263

- Bug fixes and reliability improvements
v2.1.261破坏性变化2026/09/05 · 12 天前

多端稳定性深度加固与编辑器完善

亮点
  • 新增 /skill-doctor 检查未使用技能与上下文成本占用。
  • 命令和后台任务的内联输出大小限制可配置至 128K(bashOutputMaxCharstaskOutputMaxChars)。
  • 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 重新认证。
展开官方原文 ↓
## 2.1.261

- Added an "Organization policy" line to `/status` and `claude doctor` that says why your organization's policy could not be loaded, such as a proxy not passing the endpoint through
- Added `bashOutputMaxChars` and `taskOutputMaxChars` settings to raise how much command and background-task output Claude receives inline before it is saved to a file, up to 128K characters
- Added `--append-subagent-system-prompt-file` to read the subagent system prompt from a file, for prompts too large to pass on the command line
- Added `/skill-doctor` to show which loaded skills go unused and what they cost in context, so you can prune them
- Fixed typed or pasted characters occasionally landing out of order or being dropped during fast input or key repeat
- Fixed `/add-dir <subdirectory>` printing a false "couldn't be resolved" error when the working directory is on a `/net` automount
- Fixed the Bedrock setup wizard hanging when AWS or an AWS credential helper never responds (it now times out with a clear error), and its model checks failing behind a TLS-inspecting proxy
- Fixed cloud sessions discarding a plugin synced from claude.ai when managed settings force-enable it in `enabledPlugins`, then falling back to a marketplace clone that could fail
- Fixed being unable to delete the character immediately before an inline `[Image #N]` chip in the prompt input
- Fixed resuming a session losing hook output and other context around parallel tool calls, which changed the resumed request
- Fixed Remote Control showing a stale permission mode when a phone, browser, or claude.ai app attaches to a terminal session or after the mode changes in the terminal
- Fixed Remote Control sessions showing as still working (stuck spinner and Stop button) after stopping a turn from a connected phone or browser, or after a local slash command like `/clear`
- Fixed SDK and cloud sessions ignoring a Stop or interrupt sent just after the first prompt, before the turn had started; the turn now stops instead of running to completion
- Fixed Remote Control uploading a session pulled with `/teleport` into the connected session, which appeared appended to the original on phone and web
- Fixed Remote Control's inbound event stream failing behind TLS-inspecting corporate proxies on native Windows
- Fixed Remote Control sessions showing the default effort level on claude.ai when the effort comes from settings
- Fixed `gcpAuthRefresh` opening a browser at startup when the Google credential check was slow, even though the credential was still valid
- Fixed claude.ai connectors staying absent for the whole session when the startup connector fetch timed out — the CLI now retries in the background
- Fixed sustained high CPU usage when a background agent could not be resumed and its wake-up was retried in a tight loop
- Fixed feature flags gated to a newer version occasionally applying to an older Claude Code version running on the same machine
- Fixed `/usage` and the VS Code usage panel dropping a model-specific weekly limit row when the usage endpoint is rate limited or when opened right after startup
- Fixed `claude -p --resume <file>` adopting a malformed session ID recorded in the transcript; it now resumes under a fresh session ID instead
- Fixed the terminal progress indicator (iTerm2, Ghostty, ConEmu) showing the session as finished while a background workflow or agent was still running
- Fixed a rare layout glitch where a box could render with the wrong height after its container switched between row and column direction
- Fixed Claude apps gateway client IP when a trusted proxy appends a port to `X-Forwarded-For`; with an access list set, an unreadable entry now gets 403
- Fixed Claude apps gateway telling Claude Desktop to export OpenTelemetry as JSON even when the terminal CLI uses protobuf, so protobuf-only collectors rejected Desktop's data
- Fixed Desktop and web showing a session as busy while it only watches an artifact for updates
- Fixed Claude in Chrome `file_upload` failing with "paths: expected array, received undefined" in local Cowork sessions run from the Claude Desktop app
- Fixed `SendMessage` to an offline Remote Control session on another machine reading as delivered; the result now says delivery is queued until that machine reconnects
- Fixed plugin install hints from CLIs run in background Bash commands: they are now detected, and the raw `<claude-code-hint>` tag no longer leaks into the conversation
- Fixed in-process agent-team teammates re-sending their first-turn tool and skill announcements on the second turn, which changed the request prefix and missed the prompt cache
- Improved the `/model` picker and the VS Code model pill to show a model's name instead of its raw Bedrock, Vertex AI, or LLM gateway ID when Claude Code recognizes it
- Improved startup on Google Vertex AI when `GOOGLE_APPLICATION_CREDENTIALS` is set: API client creation no longer re-runs Google Cloud project discovery or spawns extra `gcloud` processes
- Improved streaming performance: already-rendered blocks are no longer re-checked by layout on each update
- Improved the dangerous-`rm` safety prompt to also catch `rm -rf` on positional parameters and inside double-quoted `sh -c` scripts
- Improved handling when the API sends no response headers: the retry now waits up to `API_TIMEOUT_MS` (10 minutes by default) instead of another 3 minutes, and the messages say what to change
- Changed a Claude apps gateway 403 on the managed settings load (at startup or after `/login`) to say Claude Code may not be enabled for the organization, instead of advising a new sign-in
- Changed machines whose managed settings pin `forceLoginMethod: "gateway"` to ignore a leftover API key or claude.ai login and ask for `/login`; Bedrock, Vertex AI, and Foundry sessions are unaffected
- Changed auto mode to treat a link that packs content into a public diagram renderer's URL as an upload to that site: no longer auto-approved unless you asked for it
- Changed the prompt's word-editing keys to match Bash: Ctrl+W deletes back to whitespace, Alt+F and Alt+D stop at word end, punctuation separates words; `keybindingFlavor` no longer has any effect
- Changed `/context` token counting to use a local estimate when the token-counting API is unavailable, instead of extra small-model requests
- [VSCode] Added a "Build a custom style" walkthrough to the Output styles menu that writes a custom output style file and lists it right away
- [VSCode] Added an Add server form and a Remove action to the MCP servers dialog, so MCP servers can be added and removed without leaving the IDE
- [VSCode] Added a hollow ring in the session list for sessions open in a terminal, another VS Code window, or Claude Desktop, so they no longer look closed
- [VSCode] Added a fold button to permission and question prompts so the conversation behind them can be read without dismissing them; the space beside the prompt now scrolls the conversation
- [VSCode] Added "Archive session" to the session list's right-click menu and gave Unarchive its own icon
- [VSCode] Fixed a session teleported from Claude Code on the web treating a question that was cut off when the cloud session shut down as declined
- [VSCode] Fixed the session tab's Rename box opening empty for a tab restored with the window; it now starts with the current name
- [VSCode] Fixed collapsed sections in the session list panel briefly showing expanded each time the panel loaded
- [VSCode] Fixed Focus view showing a tool call as still running after Claude had moved on, such as while a question waited for your answer
- [VSCode] Fixed the session list's active-row highlight going stale when an unfocused Claude tab's session ID is corrected
- [VSCode] Fixed Cmd/Ctrl+Shift+T reopen and deep-link opens placing the Claude tab outside the Claude editor group when a Claude tab has focus
- [VSCode] Fixed the session tab's "Add to group" putting a session opened from Claude Code on the Web in two groups; it now moves the entry the session list shows
- [VSCode] Fixed the model picker showing models an organization has since disabled until the window was reloaded twice
- [VSCode] Fixed a tab opened from the session list jumping back to that session, and a tab opened from a Web session restarting its teleport or staying empty, after VS Code reloads the tab's view
- [VSCode] Fixed `/btw` side-question history from earlier sessions being overwritten when a question is asked right after a window reload or while a settings file has errors
- [VSCode] Fixed the pending question card not reappearing after the Claude panel reloads when signed in with a Claude.ai or Console account
- [VSCode] Fixed claude.ai-only features staying visible in a window's other Claude panels after one panel picked up a third-party provider from a settings file
- [VSCode] Fixed the sign-in screen appearing despite the Disable Login Prompt setting when Claude Code reports no login or a request fails for lack of one
- [VSCode] Fixed the next queued permission prompt keeping text typed on the previous prompt and accepting an immediate second click
- [VSCode] Fixed install-plugin links opening the Claude sidebar without the install dialog in a window where only the session list had been shown
- [VSCode] Fixed the sidebar usage meter staying empty on a new window until the Account & usage dialog was opened, and a 0% usage limit being left out of the meter
- [VSCode] Fixed "Start new session in this group" losing the group after New conversation, and a missing unread dot for a session that finished before the sidebar's unread list loaded
- [VSCode] Fixed the editor tab badge showing unread during a running turn or missing on a tab opened from the session list, and "Add Session Tab to Group" doing nothing for an archived session
- [VSCode] Fixed "Enable Remote Control for all sessions" so flipping it also applies right away to sessions open in other VS Code windows
- [VSCode] Fixed the session list's Open filter for sessions continued from claude.ai whose tab was still recorded under the web session, and labeled the filter menu's sections for screen readers
- [VSCode] Changed the model picker to one flat list of every model, with rows kept for older model spellings listed last
v2.1.2602026/09/04 · 13 天前
中文摘要待生成,可查看官方原文 ↓
官方原文
## 2.1.260

- Added a diff panel that opens beside the conversation in fullscreen mode and shows your uncommitted changes as Claude edits; toggle it with `/diff`
- Added a likely cause for prompt-cache misses (e.g. tool definitions or system prompt changed, idle past the TTL) to `/cost` and the status line's `prompt_cache` field
- Added `/reload-plugins` to headless sessions, so it appears in the Claude Code Desktop and SDK command lists
- Added a text form of `/advisor` (`/advisor`, `/advisor <model>`, `/advisor off`) for the desktop app, Remote Control, and other headless (`-p`/Agent SDK) sessions
- Added `oidc.scope_on_refresh` to the Claude apps gateway for IdPs that return an id_token on refresh only when asked for `openid` again
- Added Claude apps gateway support for newer Claude Desktop keys in `desktop` policy blocks, including `userPluginMarketplacesEnabled` and `userPluginUploadsEnabled`
- Fixed `Edit`/`Write`/`Read` permission rules whose path contains parentheses being dropped as invalid or ignored by the Bash sandbox, which left "read-only" folders writable
- Fixed one file permission rule with an uncompilable pattern (e.g. an unclosed `[`) making every file edit fail with `Invalid regular expression`; such a deny rule now guards the literal path it spells
- Fixed Bash permission checks auto-approving zsh commands that hide a command substitution in a REPORTTIME, REPORTMEMORY or DIRSTACKSIZE assignment; these now prompt for approval
- Fixed Bedrock model discovery, token counting and AWS SSO/STS credential calls failing with "unable to get local issuer certificate" when the corporate root CA is only in the OS certificate store
- Fixed `permissions.blockReadsOutsideWorkingDirectories` on macOS hiding the user's git config from sandboxed git and hiding a worktree-isolated sub-agent's own checkout
- Fixed managed settings not loading for claude.ai Enterprise/Team users who also had a leftover API key from an earlier `/login`
- Fixed `/status` listing a signed-in claude.ai account and a configured API key as if both were in effect; the credential not in use is now marked
- Fixed managed `skillOverrides` entries keyed on a bundled skill's alias (e.g. `checkup` for `/doctor`) not applying, and `Skill(name)` deny rules not covering a nested skill listed as `<dir>:name`
- Fixed `model: fable` agents ignoring the `[1m]` tag on an `ANTHROPIC_DEFAULT_FABLE_MODEL` pin and silently running with a 200K context window
- Fixed the `/model` picker not showing Fable 5.1 for organizations that can use it, which was only accepted when typed as `/model claude-fable-5-1`
- Fixed prompt caching on Claude Fable 5.1 not covering the context attached after tool results, so it was re-sent as uncached input on every tool-call turn
- Fixed model switching staying blocked for the rest of the session after a plugin hook load failure; each switch now re-checks and the refusal names the cause
- Fixed model switching being blocked for the session when an organization-managed plugin's marketplace could not be loaded
- Fixed SDK-provided MCP servers (e.g. Desktop connectors) sometimes missing from the first turn and only appearing on the next one
- Fixed Claude in Chrome tools failing with "Not connected" mid-task in cloud-hosted claude.ai sessions when a connector was added or removed
- Fixed flags, joined emoji and accented letters splitting across wrapped lines, and stale text staying on screen when a flag or joined emoji falls in the terminal's last two columns (now shown as `…`)
- Fixed Remote Control accepting a model pick that is not a valid model name; it is now refused with an error instead of failing on the next message
- Fixed `/rewind` and `--rewind-files` reporting success when checkpoint backup files were missing and nothing was actually restored
- Fixed `/rewind` leaving stale file-read tracking from the rewound-away turns, which caused "File unchanged since last read" stubs and full-file re-injection after external edits
- Fixed `-p --resume`/`--continue` (as used by the desktop app) failing on every retry once a session's worktree directory lost its git metadata; it now fails once, then resumes without the worktree
- Fixed a subagent that resumed another agent via SendMessage never being woken by that agent's completion (the notification went to the main conversation instead)
- Fixed agent teams: an in-process teammate's transcript losing messages, or going blank, during long API retry waits (e.g. under `CLAUDE_CODE_RETRY_WATCHDOG`) as retry notices evicted real messages
- Fixed a session that moved to the background appearing twice in ListAgents (once as a phantom "interactive" twin with the same name) and receiving SendMessage deliveries in the viewer
- Fixed intermittent "task output swap refused" errors when many sessions share a project directory
- Fixed Ctrl+Z in fullscreen leaving the shell on the alternate screen, drawn over the paused interface
- Fixed Workflow tool subagents being restarted as stalled while a long context compaction was still in progress
- Fixed plugins from a URL marketplace failing to install with "marketplace entry path does not stay inside the marketplace directory" when a host app (e.g. Claude Desktop) stores it as a directory
- Fixed an extra browser tab opening when an artifact is published in a session you're driving from claude.ai, the desktop app, or mobile (Remote Control)
- Fixed the Artifact tool's first call failing with an "Invalid tool parameters" validation error in some Cowork sessions
- Fixed IDE line selections being dropped when running a skill or slash command (the "N lines selected" context now reaches Claude)
- Fixed repository detection for GitLab projects in nested subgroups (e.g. `gitlab.com/group/subgroup/project`)
- Fixed `owner/repo#123` issue references in rendered output linking to github.com when working in a GitLab repository; they now link to the gitlab.com issue
- Glob/Grep: Fixed the search path being probed on disk before the permission check; a missing path is now reported after permission is decided, as Read does
- Reverted the 2.1.259 change applying `Read()` deny rules to Bash arguments; it denied `npm run build` under a `Read(./**/build/**)` rule in every mode and made `cd … && grep` prompt even in auto mode
- Improved structured output: Workflow `agent({schema})` rejects a JSON Schema that can never be satisfied up front, and retry-cap errors now include the last validation failure
- Improved deleting a background session whose worktree has unpushed commits: the message now names the branch and commit count, and deleting again discards the worktree
- Improved the Claude apps gateway's refresh-failure log to name the step that failed
- Improved idle CPU usage of non-interactive (`-p` / SDK) sessions
- Improved the Claude apps gateway on Amazon Bedrock: input tokens for an aborted request are now counted with AWS's free CountTokens API (grant `bedrock:CountTokens`) instead of a one-token request
- Improved the settings error for rules such as `Edit(C:\dir\(name)\**)`, where `\(` is read as an escaped parenthesis rather than a path separator, to suggest an unambiguous spelling
- Improved auto-compact for 1M-context models: Opus and Fable sessions now compact shortly before the 1M-token limit, and recovery compaction on very large contexts no longer times out at 10 minutes
- Improved `/ultrareview` and `claude ultrareview` to wait up to 45 minutes (previously 30) for long-running cloud reviews
- Improved `/effort` on Claude Fable 5.1 so changing effort mid-session no longer invalidates the prompt cache
- Updated the bundled `claude-api` skill so its Go, Java, and C# samples use current-generation model IDs, and clarified that cheaper worker or sub-agent models should be current-generation too
- Changed `ctrl+l` / `cmd+k` in fullscreen mode to clear the transcript view like a terminal `clear`; scroll up to see earlier messages
- Changed permission rules with text after the closing parenthesis (e.g. `Bash(ls) x`), which never matched anything, to be reported as invalid settings instead of being silently ignored
- Changed server-managed settings so a managed CLAUDE.md (`claudeMd`) no longer triggers the security approval dialog; hooks, shell-command, sandbox, and unsafe `env` settings still require approval
- Changed Claude in Chrome to follow your organization's Claude in Chrome admin setting; when an admin turns it off, `--chrome`, `/chrome` and the browser tools are unavailable
- Changed Claude apps gateway to send `orgPluginSettings` in the list form read by Claude Desktop 1.15200.0 and later; older desktops ignore it
- Changed Claude apps gateway to also refuse to start, naming the field, when a `desktop` policy misspells a field in a nested object of a `managedMcpServers` or `orgPluginSettings` entry
- Changed commands typed at the `!` bash-mode prompt to run outside the sandbox even when strict sandbox mode (`sandbox.allowUnsandboxedCommands: false`) is on, like typing into your own terminal
- Changed self-hosted runner `--kill-session-after-min` to release a session that is only waiting on its user (paused, resumable on the next message) instead of killing it and reporting a failure
- Removed the one-hour time limit on background commands started by subagents; they now run until they exit or are stopped, matching the main session
- [VSCode] Added the selected effort level to the footer model pill, fixed a stale effort level after switching models, and returned the footer pills to their earlier compact size
- [VSCode] Added Open and Closed to the session list's status filter menu
- [VSCode] Fixed the welcome screen disappearing in a new session when Remote Control turns on automatically
- [VSCode] Fixed the session history picker loading a session a second time when it is already open in another tab; it now switches to that tab
- [VSCode] Fixed the session tab's Rename command silently doing nothing while the tab's view was reloading; it now always applies
- [VSCode] Fixed a half-finished message, an empty tool card or an extra "Thought for" line staying on screen after Claude Code retried a dropped response
- [VSCode] Fixed "Enable Remote Control for all sessions" not applying to a session tab that was still starting when the toggle was flipped

历史版本(88 个)

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-1998 个版本 · 8 已摘要
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-reviewermcp__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
v2.1.191修复多项 UI 和 MCP 问题,优化性能和可靠性
  • 添加 /rewind 命令支持对话恢复,可恢复 /clear 执行前的内容
  • 流式响应性能优化 37% CPU 使用,减少长会话内存占用
  • 改进 MCP 服务可靠性:capability discovery 支持重试、OAuth 流程优化、404 错误显示 URL
  • Sandbox 网络权限改进:允许的主机在会话内自动记忆,无需重复确认
  • 修复 agent 停止后重启、权限面板保存、vim 模式搜索等多项 UI 问题
  • 修复跨平台兼容性:Windows Terminal /login 链接截断、Ghostty ssh/tmux 的 Cmd+click、hook 逗号分隔符失效
v2.1.190修复与可靠性改进
  • 修复若干 bug 并提高系统可靠性
v2.1.180-1895 个版本 · 5 已摘要
v2.1.187强化安全隔离与企业管理,修复结构化输出与超时问题
  • 新增 sandbox.credentials 设置,阻止沙箱命令读取凭证文件和密钥环境变量,增强安全隔离。
  • 支持组织级模型限制,在 /model、--model 等处显示限制状态,便于企业权限管理。
  • 修复 --json-schema 和 workflow 结构化输出,模型不再重复调用 StructuredOutput 工具,增强可靠性。
  • 修复 MCP 工具无限超时卡顿,5 分钟无响应现改为出错中止,可通过环境变量 CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT 自定义。
  • 改进 /install-github-app 流程,GitHub Actions 工作流配置变为可选,简化集成步骤。
v2.1.186MCP 命令行认证和 Bash 自动响应,修复多个交互问题破坏性
  • 新增 claude mcp login/logout 命令行认证 MCP 服务器,支持 SSH 无浏览器模式,简化远程集成
  • ! 开头的 bash 命令现在自动触发 Claude 响应(可通过 respondToBashCommands: false 关闭),让 REPL 工作流更流畅
  • /workflows 视图添加状态过滤(按 f 键)、后台代理权限提示改为在主会话显示,交互体验优化
  • 修复机器睡眠唤醒后流式请求失败、滚动位置溢出、权限提示对齐等多个交互 bug
  • claude mcp get/remove 命令改进,输入错误时智能建议最接近的服务器名称
  • Skill 配置和内存管理改进,支持 kebab-case、snake_case、camelCase 混用
破坏性变化
  • CLAUDE_CODE_MAX_RETRIES 环境变量上限改为 15;未监听会话应改用 CLAUDE_CODE_RETRY_WATCHDOG
  • /review <pr> 命令现在使用与 /code-review medium 相同的审查引擎
v2.1.185流式响应提示优化
  • 响应提示改为「等待 API 响应」
  • 超时检测时间从 10 秒改为 20 秒
v2.1.183增强自动模式安全性并修复多项问题破坏性
  • 自动模式安全增强:阻止破坏性 git 命令(reset --hard、checkout、clean、stash drop),禁止修改非本会话生成的提交,限制云资源销毁操作
  • 模型弃用警告:请求的模型已弃用或自动更新时显示警告,支持 print 模式和 agent 配置中的模型
  • attribution.sessionUrl 设置:在网页和远程控制会话中可选择省略 claude.ai 会话链接的提交和 PR
  • /config 增强:新增 --help 列出所有快捷键,改进了切换行为(Enter/Space 更改设置,Esc 保存关闭)
  • WebSearch 和 subagent 修复:修复 subagent 中 WebSearch 空结果、会话标题生成和认证工具问题
  • TUI 和显示修复:修复全屏 TUI 损坏、终端光标位置、思考块处理、tmux 同步问题等多项显示缺陷
破坏性变化
  • /config 切换行为变更:Esc 键现在保存并关闭而非回滚设置
v2.1.181改进配置灵活性、流式输出体验和稳定性
  • 新增 /config key=value 语法,支持从 prompt 直接设置任何配置项(如 /config thinking=false),在交互模式、-p 和 Remote Control 中都可用
  • 改进长段落流式输出,文本现按行逐行显示而非等待首行换行,大幅提升实时反馈体验
  • 增强 auto-retry 机制,API 连接中断在思考阶段时能自动重试,无需用户手动操作
  • 升级 Bun 运行时至 1.4,提升后台命令执行性能
  • 新增 CLAUDE_CLIENT_PRESENCE_FILE 环境变量,当工作于本机时可自动抑制移动端推送通知
v2.1.170-1799 个版本 · 8 已摘要
v2.1.179修复连接断开、滚动焦点和插件性能问题
  • 中途连接断开时保留部分响应,spinner 不再卡在 "running tool"
  • 修复 WSL2/Windows Terminal 下鼠标滚轮滚动失效(2.1.172 回归)
  • 修复沙箱 denyRead/allowRead glob 在大目录树上使 Bash 工具描述过大、Linux 会话卡顿
  • 修复 Ctrl+O 快捷键不显示子代理转录内容
  • 修复点击提示框无法从子代理/页脚面板返回焦点
  • 改进远程会话中的插件加载性能,修复后台任务卡在「仍在运行」状态
v2.1.178增强权限控制与嵌套目录支持,修复子代理和认证关键问题破坏性
  • 新增 Tool(param:value) 权限规则语法,可按参数和通配符精细控制工具调用(如 Agent(model:opus) 限制 Opus 子代理)
  • 嵌套 .claude/skills 目录支持:技能现在按工作目录加载,名称冲突时显示为 <dir>:<name>
  • 嵌套 .claude/ 配置优先级改进:最接近工作目录的 agent、workflow、output-style 和 workflows 保存位置现在优先生效
  • 改进自动模式:子代理生成前进行分类器评估,防止子代理请求被阻止的操作时绕过审查
  • 改进 /doctor 命令展示、Remote Control 错误提示和 /bug 提交流程(现需描述才能提交)
  • 修复多个子代理关键问题:转录查看丢失输出、消息丢弃、后台运行重启等
破坏性变化
  • /bug 命令现需提供描述才能提交(不再支持空提交)
  • 工作流提示关键词检测改为仅在明确短语如 'run a workflow' 或 'workflow:' 时触发,不再对任何 'workflow' 提及响应
v2.1.177无公开发布说明
v2.1.176多项功能改进和稳定性修复,特别是 Remote Control、背景会话和模型管理
  • Session titles 现在根据对话语言自动生成,可通过 language 设置固定特定语言
  • 新增 footerLinksRegexes 设置,支持正则表达式匹配页脚链接徽章,可在用户或托管设置中配置
  • Bedrock 凭证缓存改进:现在缓存至真实过期时间 (Expiration) 而非固定 1 小时
  • 修复 availableModels 强制执行:别名模型无法通过环境变量绕过黑名单,/fast 在切换到非白名单模型时会拒绝
  • 修复 Fable 5 auto mode 失败:组织未启用 Opus 4.8 时,分类器正确回退到最佳可用 Opus 模型
  • 修复 Remote Control 多项问题:断开连接原因改为可读文本,修复连接失败的重复记录,修复跨账户登录时的连接挂起
v2.1.175增强模型白名单的受管控制能力破坏性
  • 新增 enforceAvailableModels 受管设置,强制执行 availableModels 白名单约束
  • Default 模型自动回退到白名单中的第一个允许模型,避免配置冲突
  • 管理员可防止用户或项目设置扩展受管的 availableModels 列表
破坏性变化
  • 启用 enforceAvailableModels 后,Default 模型解析会强制遵守白名单限制
  • 受管的 availableModels 列表无法通过用户或项目配置扩展
v2.1.174修复模型选择器与配置问题,VSCode 增强使用量分析
  • 新增 wheelScrollAccelerationEnabled 设置,可禁用全屏模式的鼠标滚轮加速
  • 修复 /model 选择器显示问题,模型族现在根据账户类型正确显示(Opus/Sonnet 默认模型显示正确)
  • [VSCode] 使用量面板(/usage)新增详细分析:缓存未命中、长上下文、子代理,支持 24h/7d 统计维度
  • 优化 Skill 热重载机制,仅重新发送变化的 Skill,减少网络开销
  • 修复 Bedrock GovCloud 推断配置、后台会话 env 变量继承、Workflow 子代理归属等多项配置问题
v2.1.173修复 Fable 5 模型名称规范化和沙箱警告问题
  • Fable 5 模型名称中的 [1m] 后缀现在自动移除,避免重复标记。
  • 修复 Windows 沙箱启用时出现虚假 'sandbox dependencies missing' 警告。
v2.1.172Sub-agents 支持嵌套递归、多项关键修复和性能优化
  • Sub-agents 现在可以生成自己的 sub-agents,最深支持 5 层嵌套,实现更复杂的多层任务编排
  • Amazon Bedrock 改进区域配置,自动从 ~/.aws 读取 AWS_REGION,/status 显示配置源头
  • /plugin 插件市场添加搜索栏,快速查找和浏览插件
  • 修复 1M context 会话永久卡死问题,超限时自动压缩回标准上下文
  • 修复多张图片导致重复报错、background agents 读取错误项目设置、子 agent 停止后仍显示 active 等关键 bug
  • 性能优化:减少空闲 CPU 占用、加速长对话处理、改进 Claude in Chrome 工具加载
v2.1.170推出 Claude Fable 5 Mythos-class 模型,修复 VS Code 终端的 session 保存问题
  • Claude Fable 5 现已可用——能力超越所有已发布模型,更新至 2.1.170 即可使用
  • 修复了从 VS Code 集成终端启动时 session transcripts 丢失、--resume 无法恢复的问题
v2.1.160-1699 个版本 · 9 已摘要
v2.1.169修复 MCP 策略执行、性能问题和后台会话稳定性
  • 新增 --safe-mode 标志禁用所有自定义配置,便于排查问题
  • 新增 /cd 命令切换工作目录时保持 prompt cache,避免不必要的重新加载
  • 修复企业 MCP 策略(allowedMcpServers/deniedMcpServers)在重连、IDE 配置和首次安装后未被执行的问题
  • 修复 Windows 上 claude -p 执行命令扫描时的性能问题,显著加快启动速度
  • 改进 TaskCreate 工具可靠性,现在自动修复格式错误并为缺失工具提供 schema 信息
  • 修复后台代理在会话恢复后卡在重连状态的问题,增强多会话稳定性
v2.1.168修复与可靠性改进
  • 修复若干 bug 并提高系统可靠性
v2.1.167修复 bug 和提升应用可靠性
  • 修复多个已知 bug,改进应用稳定性
  • 提升运行时可靠性,减少异常和错误
v2.1.166备用模型与权限管理完善破坏性
  • 新增 fallbackModel 设置,自动选用备用模型应对过载
  • 权限规则支持 glob 模式、强化跨会话消息隔离
  • 禁用思考链、修复 IDE 终端闪烁及 Shift 键输入
  • 修复进程泄漏、配置损坏、音声模式等多项问题
破坏性变化
  • allow 规则不再接受非 MCP glob 模式
  • 跨会话 SendMessage 消息不再携带用户权限
v2.1.165修复 bug 并改进系统可靠性
  • 修复了各类 bug,提升应用稳定性和整体质量
  • 改进了系统可靠性机制,增强容错和错误恢复能力
  • 优化了性能和运行效率,提升生产环境稳定表现
v2.1.163增强插件管理和 Hook 反馈能力,修复后台任务与权限问题
  • 新增 /plugin list 命令,支持 --enabled/--disabled 过滤查看已安装插件
  • Hook 可返回 additionalContext 向 Claude 提供反馈并继续对话,无需标记为错误
  • 新增 requiredMinimumVersion/requiredMaximumVersion 管理设置,可限制允许的版本范围
  • /btw 命令新增 "c to copy" 快捷键,复制原始 markdown 并保留格式
  • 修复后台会话更新后丢失任务、权限规则失效、Hook 条件误触等多个关键问题
v2.1.162改进代理命令体验,修复权限规则和会话管理的多项问题
  • claude agents --json 新增 waitingFor 字段显示阻塞原因(权限提示等),便于调试
  • Slash 命令自动完成改进 - 点击菜单项现在填充到输入框而非立即执行,更灵活可控
  • 权限规则修复 - WebFetch 预白名单生效、Windows 路径和 case-variant 路径匹配修正
  • MCP 子秒级超时配置修复 - 低于 1000ms 的值不再被错误强制为 1 秒
  • claude agents 终端显示改进 - 宽终端下完整显示会话信息和实时状态,不再截断
  • 后台会话管理修复 - 失败回复现在被正确排队,后台启动失败不再导致会话丢失
v2.1.161工具调用、指标和 MCP 连接器的多项改进与修复
  • OTEL_RESOURCE_ATTRIBUTES 现作为指标标签,支持按团队、仓库等自定义维度切分使用数据
  • claude agents 显示 done/total 进度,peek 模式高亮最长运行项
  • 并行工具调用优化:Bash 失败不再取消同批次其他任务,各工具独立返回结果
  • /mcp 连接器展示改进:自动收起未登录的 claude.ai 连接器
  • 全屏模式剪贴板增强:Linux 支持 wl-copy/xclip/xsel,同时支持中键粘贴
v2.1.160安全提升与后台会话稳定性改进,工作流关键字调整破坏性
  • 写入 shell 启动文件、git 配置和构建工具配置前现在需要用户确认,防止意外命令执行
  • grep 命令后无需额外 Read 操作即可编辑单个文件,简化工作流
  • 修复后台会话恢复时丢失对话历史和重复运行原始提示的问题
  • Windows WSL 剪贴板 copy-on-select 功能修复,改用 PowerShell interop 替代 OSC 52
  • 改进 auto mode 分类器延迟和 claude agents 会话列表响应速度
  • 修复 Windows 下输入响应延迟、vim mode 粘贴位置、CJK IME 输入法位置等多项用户体验问题
破坏性变化
  • 动态工作流触发关键字从 'workflow' 改为 'ultracode'——使用 /effort ultracode 运行超级代码评审,直接说出需求仍可触发工作流
v2.1.150-1598 个版本 · 8 已摘要
v2.1.159内部基础设施改进
v2.1.158Auto mode 扩展至 Bedrock、Vertex 和 Foundry 平台
  • Auto mode 现已在 Bedrock、Vertex、Foundry 等云平台上可用,支持 Opus 4.7 和 Opus 4.8 模型
  • 通过设置环境变量 CLAUDE_CODE_ENABLE_AUTO_MODE=1 启用 Auto mode
v2.1.157插件系统自动加载、Agent 配置优先级调整与多项稳定性修复
  • 插件自动加载与脚手架:.claude/skills 中的插件现在自动加载无需 marketplace;新增 claude plugin init <name> 快速创建新插件
  • Agent 设置优先级:claude agents 现在尊重 settings.json 中的 agent 字段,支持 --agent <name> 覆盖
  • Worktree 会话切换:EnterWorktree 支持在单个会话中动态切换不同的 Claude 管理 worktree
  • 图片处理稳定性:修复了零字节/损坏图片导致请求崩溃的问题,现在转为文本占位符
  • 权限提示修复:桌面应用、IDE 扩展和 SDK 在 auto/bypass 权限模式下不再出现沙箱网络提示
  • 性能优化:消除长对话和恢复会话中的冗余消息渲染,提升响应速度
v2.1.156修复 Opus 4.8 中 thinking blocks 导致的 API 错误
  • 修复了使用 Opus 4.8 时 thinking blocks 被错误修改引发的 API 错误问题
v2.1.154Opus 4.8 发布,支持动态 workflow 自动化多 agent 编排破坏性
  • Opus 4.8 默认 high effort 模式,fast mode 成本优化至 2x 费率获 2.5x 速度
  • 动态 workflow 支持 Claude 自动创建和协调数十到数百个 agent,处理大规模复杂任务
  • /simplify 改为清理专用,只审查代码重用、简化、效率并自动修复(不做 bug 审查)
  • 后台命令执行,! <command> 运行 shell 命令并支持附加/分离后台会话
  • 插件系统优化:支持可选插件(defaultEnabled: false)和目录感知建议
破坏性变化
  • lean system prompt 成为默认值(Opus 4.8 及部分旧版除外),可能改变 prompt 行为
  • /simplify 从完整 bug 审查改为仅清理类修复,若需完整审查改用 /code-review --fix
  • CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE 环境变量已弃用,06/01 删除;改用 /model 和 /fast 命令
v2.1.153MCP 服务器稳定性提升和后台 agents 多项修复破坏性
  • skipLfs 选项:Git/GitHub 源支持跳过 LFS 下载,加速仓库克隆和更新
  • npm 安装通知:检测全局安装无法自动更新,/doctor 显示修复方案
  • agents 自动补全:现在建议原生 slash 命令和 bundled skills,PR 显示优化
  • /model 选择持久化:保存为新 sessions 的默认值,免去重复选择
  • 关键稳定性修复:解决 MCP 重连循环、后台 sessions 内存泄漏、Worktree 权限等问题
破坏性变化
  • keybinding 迁移:若自定义过 modelPicker:setAsDefault,需改为 modelPicker:thisSessionOnly
v2.1.152代码审查自动应用与工作流优化
  • /code-review --fix 现在自动应用审查建议到代码工作树,/simplify 命令已集成此功能
  • Auto mode 不再需要 opt-in 同意,开箱即用简化初始体验
  • SessionStart hooks 可设置会话标题和 reloadSkills,同一会话内即可启用新 skills 无需重启
  • /reload-skills 命令重新扫描 skill 目录,动态加载新 skills 无需重启会话
  • Vim 模式中 / 在 NORMAL 模式打开反向历史搜索,与 bash/zsh vi-mode 行为一致
  • 新增 MessageDisplay hook 事件,允许在消息显示时转换或隐藏文本内容
v2.1.150基础设施改进
  • 内部基础设施改进,无用户界面变化
v2.1.140-1491 个版本 · 1 已摘要
v2.1.149完善成本追踪和修复多项安全与稳定性缺陷
  • /usage 命令现在按分类显示额度消耗明细(skills、subagents、plugins、MCP 服务器成本)
  • /diff 支持键盘导航滚动(方向键、j/k、PgUp/PgDn、Space、Home/End)
  • Markdown 输出现在正确渲染 GFM 任务列表复选框([x]/[ ])
  • 修复 PowerShell 权限绕过:内置 cd 函数不再在无检测状态下改变工作目录
  • 修复 find 命令在大目录树上导致 macOS 文件表溢出并崩溃的问题