Claude Code v2.1.202 观察：多工作树会话恢复的卡顿，这次修掉了

用 Claude Code 跑大型项目，最让人挠头的瞬间是什么？

不是它写不出代码，是你为并行开发新建了十几个 git worktree，切回目录准备恢复会话——进度条开始转圈，终端像冻住，风扇狂响，短则一两分钟，长则三五分钟，只能干等。这种"等工具缓过来"的煎熬，是高频用多 worktree 的开发者近几个月反复撞上的日常。

工作树一多，会话恢复为什么卡

先补点背景：git worktree做多分支并行，已经是现代工程团队的常规操作。一个新功能拉一个 worktree，每个 worktree 对应一套独立的 Claude Code 会话。单个仓库挂十几个 worktree，不算少见。

根子出在 Claude Code 原来的会话存储机制上：每段会话绑定对应工作目录，统一存在 ~/.claude/projects/下，以目录绝对路径做索引。每个 worktree 路径独立，就各自对应一套会话记录。

当你打开会话选择器（/resume或 claude --resume）、或按名称恢复会话时，Claude Code 得扫描当前仓库下所有 worktree 的全部会话记录。v2.1.202 之前，这套扫描逻辑有性能缺陷——对每个 worktree 的会话数据反复做 IO 读写 + 内存分配，worktree 越多，耗时非线性暴涨。

GitHub 上有开发者反馈：仓库里十来个 worktree，打开会话选择器就要数分钟，内存飙到数 GB。更糟的是，即便用 claude --resume <名称>指定名称恢复，仍要走完完整全量扫描——明明已经锁定目标，却还得遍历全部 worktree 数据。

v2.1.202 改了什么

v2.1.202 的 18 项改动里，这条修复列在靠前的位置：

修复仓库存在大量 git worktree 时，按名称恢复会话、打开会话选择器耗时数分钟且内存占用极高的问题。

官方没披露底层实现，但结合问题本质能判断优化方向：扫描逻辑从"全量遍历"改成了"按需索引加载"。

• 旧版：打开选择器 → 遍历所有 worktree → 读每个 worktree 的会话文件 → 全载入内存 → 展示列表；

• 新版：打开选择器 → 读轻量化索引元数据 → 按需加载对应会话详情。

无论多少 worktree，读索引的开销稳定在 O(1)​ 量级。优化效果：从等数分钟，压到一两秒。

这不只是"快了一点"

有人会问：不就是加载快点，值得单写一篇？

值得。因为这是不是速度问题，是开发心流能不能保住的问题。

软件工程里，切换环境的损耗从来不止等待那两分钟。恢复会话干等 120 秒，思路早断了——刷手机、回消息、切窗口，等加载完，刚才的逻辑忘了。这两分钟打断的不只是终端操作，是你的连贯思考。

v2.1.202 把等待压到几乎无感。输入 /resume，选择器秒弹，选中回车，整套操作和单目录没差别。同时维护二三十个并行 worktree，切会话像在同仓库切分支一样顺。

背后释放的信号其实更值得记：Claude Code 正从"适配单仓库小项目"的工具，往"扛得住大型 monorepo、多 worktree 并行"的专业工程工具转。一款真能跑大型项目的 AI 编程助手，不能让用户卡在基础操作上干等。

观察：不显眼，但缺了寸步难行

v2.1.202 共 18 项改动，这条多 worktree 优化不算最亮眼——它不像动态工作流规模档位能手动拨，也不像远程控制图片修复那样直击显性痛点，属于"平时感知不到、一触发就折磨人"的那类基建。

像空气，平时不留意，缺了立刻不行。

下次打开挂了十几个 worktree 的大仓库，输 /resume，选择器秒弹，全程无卡——你感受不到异常，正是修复到位最好的证明。

升级命令：npm update -g claude-code。

对跑大型 monorepo、多 worktree 并行、动态工作流长会话的团队来说，模型侧的卡顿修掉了，接入通道的稳定与成本同样影响这条工作流——尤其是 Claude Opus 在多 worktree + 动态工作流并发下 token 消耗不低。UseAIAPI​ 同步覆盖 Claude 全系列及 Gemini、ChatGPT、DeepSeek 等全球主流大模型最新版本，支持企业级定制接入；在长会话、多智能体并发、跨模型切换等高消耗场景下，综合成本可控制在官方定价五折区间，对"大仓库 + 多 worktree + 高强度生成"并行的研发团队较为友好。