正文 · AI 翻译
变更内容
- 新增 `worktree.baseRef` 设置（`fresh` | `head`），用于选择 `--worktree`、EnterWorktree 以及智能体隔离工作树是从 `origin/<default>` 分支，还是从本地 HEAD 分支。注意：默认值 `fresh` 会将 EnterWorktree 的基准分支改回 `origin/<default>`（自 2.1.128 版本以来一直是本地 HEAD）—— 将 `worktree.baseRef` 设置为 `"head"` 可在新工作树中保留未推送的提交。
- 新增 `sandbox.bwrapPath` 和 `sandbox.socatPath` 托管设置（Linux/WSL），用于指定自定义的 bubblewrap 和 socat 二进制文件路径。
- 新增 `parentSettingsBehavior` 管理级键（`'first-wins'` | `'merge'`），允许管理员将 SDK 的 managedSettings（父级）纳入策略合并。
- 钩子现在可通过 `effort.level` JSON 输入字段和 `$CLAUDE_EFFORT` 环境变量接收当前投入级别，Bash 工具命令也可读取 `$CLAUDE_EFFORT`。
- 改进了专注模式的行为。
- 改进了内存使用：在内存压力下释放热备用后台工作进程。
- 修复了刷新令牌竞争导致共享凭据被清除后，所有并行会话均以 401 错误终止的问题。
- 修复了限定于驱动器根目录（`C:\`）或 POSIX `/` 的编辑/写入允许规则匹配不正确并持续弹出提示的问题。
- 修复了因时钟偏差或磁盘缓慢导致历史记录或会话日志文件锁受损时，出现未处理的拒绝（ECOMPROMISED）问题。
- 修复了在对话压缩过程中按 Esc 键会错误显示“压缩对话时出错”通知的问题。
- 修复了在完整的 MCP OAuth 流程（包括发现、动态客户端注册、令牌交换和令牌刷新）中，`HTTP(S)_PROXY` / `NO_PROXY` / mTLS 未被正确遵循的问题。
- 修复了通过 `--add-dir` / SDK additionalDirectories 传入的映射网络驱动器上的读取/写入/编辑操作被拒绝的问题。
- 修复了从 claude.ai 发起的远程控制停止/中断未能像本地按 Esc 键那样完全取消 CLI 会话，导致在中断卡住的工具或提示词后，队列中的消息无法继续推进的问题。
- 修复了在一个会话中使用 `/effort` 意外改变其他并发会话投入级别的问题，以及 IDE 投入级别变更可能被静默丢弃的相关问题。
- 修复了子智能体无法通过技能工具发现项目、用户或插件技能的问题。
- `claude --help` 现在会列出 `--remote-control` 以及 `--remote-control-session-name-prefix`。
- [VSCode] 修复了当扩展构建未打包 Claude 二进制文件时，`claudeCode.claudeProcessWrapper` 因“不支持的平台”而失败的问题。
What's changed
- Added
worktree.baseRefsetting (fresh|head) to choose whether--worktree,EnterWorktree, and agent-isolation worktrees branch fromorigin/<default>or localHEAD. Note: the defaultfreshchangesEnterWorktree's base back toorigin/<default>(it has been localHEADsince 2.1.128) — setworktree.baseRef: "head"to keep unpushed commits in new worktrees - Added
sandbox.bwrapPathandsandbox.socatPathmanaged settings (Linux/WSL) to specify custom bubblewrap and socat binary locations - Added
parentSettingsBehavioradmin-tier key ('first-wins' | 'merge') to let admins opt SDKmanagedSettings(parent tier) into the policy merge - Hooks now receive the active effort level via the
effort.levelJSON input field and the$CLAUDE_EFFORTenvironment variable, and Bash tool commands can read$CLAUDE_EFFORT - Improved focus mode behavior
- Improved memory usage by releasing warm-spare background workers under memory pressure
- Fixed parallel sessions all dead-ending at 401 after a refresh-token race wiped shared credentials
- Fixed
Edit/Writeallow rules scoped to a drive root (C:\) or POSIX/matching incorrectly and always prompting - Fixed an unhandled rejection (
ECOMPROMISED) when a history or session-log file lock is compromised by clock skew or slow disk - Fixed pressing Esc during conversation compaction showing a spurious "Error compacting conversation" notification
- Fixed
HTTP(S)_PROXY/NO_PROXY/ mTLS not being respected for the full MCP OAuth flow including discovery, dynamic client registration, token exchange, and token refresh - Fixed Read/Write/Edit being denied on mapped network drives passed via
--add-dir/ SDKadditionalDirectories - Fixed Remote Control stop/interrupt from claude.ai not fully canceling the CLI session the same way local Esc does, causing queued messages to never advance after interrupting a stuck tool or prompt
- Fixed
/effortin one session unexpectedly changing the effort level of other concurrent sessions, and a related issue where an IDE effort change could be silently dropped - Fixed subagents not discovering project, user, or plugin skills via the Skill tool
claude --helpnow lists--remote-controlalongside--remote-control-session-name-prefix- [VSCode] Fixed
claudeCode.claudeProcessWrapperfailing with "Unsupported platform" when the extension build doesn't bundle a Claude binary