前言
在快速迭代的 AI 开发工具领域,细节决定成败。Claude Code 刚刚发布的 v2.1.133 版本中,开发团队对 Git Worktree 的分支逻辑进行了"拨乱反正",并修复了多会话并发时可能导致的认证失效问题。如果你经常在多个终端或 IDE 窗口中同时开启 Claude,这次更新将极大提升你的系统稳定性。
一、 Git 工作流重塑:worktree.baseRef 配置项
这是一个非常关键的行为变更,建议所有深度使用 Git Worktree 的开发者关注:
-
新设置项 :
worktree.baseRef。-
fresh(默认值) :新创建的工作树(Worktree)将基于远端origin/分支。这意味着你的新分支是"干净"的,不包含本地未推送的提交。注意: 这将EnterWorktree的行为改回了 v2.1.128 之前的逻辑。 -
head:基于本地HEAD创建。如果你希望在新工作树中保留本地未推送的 commits,请手动将此项设置为"head"。
-
-
适用范围 :涵盖了
--worktree参数、EnterWorktree命令以及 Agent 隔离环境。
二、 稳定性与性能增强
1. 认证风暴修复 (Refresh-Token Race)
-
痛点:此前如果在多个并发会话中同时触发 Token 刷新,可能会发生竞态条件导致共享凭据被抹除,从而使所有会话同时陷入 401 认证失败的死胡同。
-
修复:新版本彻底解决了这一并发冲突,确保多会话环境下认证的持续稳定性。
2. 内存与资源调度
- 动态回收:新增了对后台工作线程(Background Workers)的动态管理。当系统内存压力较大时,Claude 会主动释放处于"温备"状态的闲置线程,显著降低资源占用。
3. 远程控制 (Remote Control) 增强
- 深度中断 :修复了从 claude.ai 网页端发送停止/中断指令时,CLI 会话未能完全同步取消的问题。现在远程中断的行为已与本地按下
Esc键完全一致。
三、 企业级安全与沙盒配置 (Linux/WSL)
针对在高度受限环境或特定发行版中使用 Claude 的开发者:
-
自定义沙盒路径 :新增
sandbox.bwrapPath和sandbox.socatPath设置,允许用户手动指定bubblewrap和socat二进制文件的位置。 -
管理设置合并 :新增
parentSettingsBehavior('first-wins' | 'merge')。管理员现在可以决定是将 SDK 的受管设置与父级策略进行合并,还是采用首位优先原则。
四、 工具与 Hook 能力增强
-
Effort 状态感知:
-
现在的 Hook 脚本可以通过 JSON 输入中的
effort.level字段或$CLAUDE_EFFORT环境变量获取当前的思考强度(Effort Level)。 -
Bash 工具执行的命令同样可以读取
$CLAUDE_EFFORT变量,方便根据 AI 的"努力程度"执行不同的自动化逻辑。
-
-
技能发现修复:修复了子代理(Subagents)无法通过 Skill 工具发现项目、用户或插件技能的 Bug。
五、 其他关键 Bug 修复清单
| 类别 | 修复内容 |
|---|---|
| 路径匹配 | 修复了针对驱动器根目录(如 C:\ 或 /)设置的 Edit/Write 权限规则匹配错误导致频繁弹窗的问题。 |
| 网络适配 | 修复了 MCP OAuth 完整流程(包括发现、动态注册等)不尊重代理(Proxy)设置或 mTLS 配置的问题。 |
| 磁盘/硬件 | 修复了由于时钟偏移或磁盘响应过慢导致历史文件锁定失败引起的 ECOMPROMISED 异常。 |
| 多会话冲突 | 修复了在一个会话中调整 /effort 会意外改变其他并发会话设置的问题。 |
| VS Code | 修复了插件在某些平台上因找不到捆绑的 Claude 二进制文件而报错的问题。 |
结语
从 v2.1.133 可以看出,Claude Code 正在解决越来越复杂的生产环境问题,如网络驱动器挂载、跨会话状态同步以及企业级沙盒路径定制。
升级命令:
claude update
温馨提示:如果你依赖本地未推送的 commit 自动进入 Worktree,记得运行 /config 将 worktree.baseRef 改为 "head"。