2026 年 7 月 7 日,Claude Code 发布 v2.1.203,这是一个修复密度极高的版本——超过 20 项针对后台代理、Worktree 隔离和跨平台兼容性的修复,同时带来两个提升可见性的小功能。
新特性一:登录即将过期时主动提醒
Added a warning when your login is about to expire, so you can re-authenticate before background sessions are interrupted.
现在,Claude Code 会在你的登录即将过期前主动提醒,让你有机会重新认证,而不是等到后台会话被意外中断才发现问题。
# 登录即将过期时会看到类似提示
⚠ 你的登录将在 X 小时后过期,请运行 /login 重新认证
# 避免后台代理任务因认证失效而被打断对于依赖后台代理长时间运行任务的用户,这个提醒能有效避免「任务跑到一半突然因为登录过期而失败」的情况。
新特性二:权限模式常驻角标
Added a grey ⏸ badge to the footer when in manual permission mode, making the active mode always visible.
处于 Manual 权限模式(即 v2.1.200 改名后的模式)时,界面底部现在会常驻显示一个灰色 ⏸ 角标,让当前生效的权限模式始终可见,不需要额外执行命令查询。
# 界面底部角标示例
[项目名] [模型: Sonnet 5] [⏸ Manual]
# ^^^^^^^^ 权限模式常驻可见
后台代理与 Worktree:超 20 项关键修复
v2.1.203 是近期后台代理稳定性投入最密集的版本之一,覆盖了大量真实使用场景的边缘问题:
会话恢复与连接稳定性
- 修复 macOS 上打开/切换后台代理会话卡顿 15-20 秒的问题(v2.1.196 引入的回归 Bug,因误报低内存导致)
- 修复守护进程会话 Token 过期后,后台会话永久无法响应连接/回复/停止指令的问题——现在会自动恢复
- 修复返回
claude agents时静默停止正在运行的子代理、并从头重新执行 Prompt 的问题——现在工作进度会被正确保留
Worktree 隔离修复
- 修复 Worktree 隔离的子代理有时会在父检出目录而非自己的 Worktree 中运行 Shell 命令的问题
- 修复多仓库工作区中 Worktree 创建拒绝嵌套仓库、导致后台会话无法隔离编辑的问题
- 修复大量 Git Worktree 场景下 Bash 报错「argument list too long」的问题
跨平台兼容性
- 修复后台代理继承守护进程的过期
PATH而非派发 Shell 的PATH,导致 Windows 上工具缺失的问题 - 修复后台和代理视图会话丢失 Shell 导出的
ANTHROPIC_BASE_URL、导致 API Key 被发到默认端点并 401 失败的问题 - 修复 Windows 上后台任务输出在
/clear后被永久替换为空文件的问题
其他稳定性修复
- 修复工作目录被删除、替换为文件或变成无效路径时后台代理陷入崩溃循环的问题——现在只失败一次并给出清晰错误
- 修复后台守护进程自动升级失败时静默杀死所有正在运行的后台会话的问题
- 修复
TaskStop和TaskOutput找不到由另一个 Agent 生成的后台代理的问题——错误信息现在会按 ID 和描述列出正在运行的代理
性能与体验改进
- 长响应流式输出时响应性提升:实时预览更新不再重新渲染整个屏幕
- 子代理行为改进:现在更不容易把整个任务重新委托给另一个子代理
- 二进制体积减少约 7MB,启动内存减少约 7MB(通过懒加载一个大型内置依赖)
- VS Code 新增设置开关:「为所有会话启用 Remote Control」
升级建议
npm update -g @anthropic-ai/claude-code
claude --version
# Claude Code 2.1.203 或更高如果你在 Windows 上运行后台代理,或者大量使用 Git Worktree 进行任务隔离,v2.1.203 修复的问题很可能你已经遇到过——强烈建议升级。
总结
v2.1.203 虽然没有引人注目的大功能发布,但对后台代理和 Worktree 隔离场景的密集修复,反映了 Claude Code 团队在这两个核心工作流上持续投入稳定性打磨。登录过期预警和权限模式常驻角标,则是两个小而有用的可见性改进。
来源:Claude Code Changelog v2.1.203 — Anthropic,2026-07-07