2026 年 9 月 17 日,Anthropic 把 Claude Code 的 Projects 重构成了一个「协调者 + 并行线程」的编排层,以 Beta 形式推送。变化的核心是工作单元:过去在一条构建线上跑多个会话,拆活、交接、拼结果都靠你自己;现在你在项目里描述要达成什么,由 Claude 来界定范围、分派任务、协调并行线程、复核产出并汇总结果。这篇教程带你把一个真实的多仓库任务交给他跑通,并把用量、冲突和记忆这几处最容易踩坑的地方一次性讲清。
先理解:项目里到底有什么
重构后的 Projects 由两类角色组成,理解这个分工是用好它的前提:
| 角色 | 是什么 | 你要做什么 |
|---|---|---|
| 协调者(主项目会话) | 一个常驻的 Claude 会话,负责拆解目标、路由任务、跟进进度、汇总结果 | 像给幕僚长做简报一样陈述工作,随时在主会话里监控与纠偏 |
| 线程(Thread) | 每条线程都是一次完整的 Claude Code 云端会话,独占一个分支与一份仓库副本 | 下钻到单条线程细调,或者放手让它跑 |
官方给的两个示例场景很能说明它的适用面:给一个应用设「把结账接口 p75 延迟降下来」的目标,让它逐个端点做性能剖析、测试优化并开 PR;或者接上 API、Web、移动端三个仓库,设「下线废弃的 v1 端点」的目标,让它每个仓库开一条线程迁移调用方、跑测试、开 PR,最后告诉你哪些要先合。注意它的定位:适合跑超过一次回复时长、且不止一个部分的长任务,单点小修改用不上这套编排。
Step 1:确认你有没有 Beta 准入
Beta 首批只开放给同时满足以下条件的用户:
□ 订阅档位为 Claude Pro 或 Max
□ 在 Claude Code 里使用过云端会话(cloud sessions)
□ 网页端与桌面端没有任何既有 Projects
三条都满足却还没看到入口,可以加入官方等待名单排队。官方计划在一周内扩大到更多同档位用户,之后才轮到 Team 与 Enterprise。已有项目不会被强制迁移,会按原样继续工作、随推送升级。
这是 Beta,不是正式功能。 Anthropic 没有承诺行为不变:协调者的拆解策略、线程调度、记忆机制都可能随版本调整。把重要的生产仓库先放到只读或低风险的分支上试,别在发布周拿它做不可逆的操作。
Step 2:建项目,把目标写成「可验收的一句话」
创建项目时你要选一个目标(Goal)并挂上仓库或上下文。协调者会先建议它能马上着手的工作,所以目标写法直接决定它给出的任务清单靠不靠谱:
写得不好的目标:
「优化一下结账流程」
→ 没有度量、没有边界,协调者只能猜范围
写得可用的目标:
「把结账接口的 p75 延迟从 900ms 降到 400ms 以内,
逐个端点定位慢点,改动以 PR 形式提交,不改变对外行为」
→ 有度量、有约束、有交付形态
挂上下文时按需选择:接了仓库,线程就能开 PR、跑项目里的测试;挂的是文档,线程就读文档、产草稿。两类的交付物不同,别混在一个目标里。
Step 3:给协调者和工作线程分别定模型与档位
一个项目可以同时跑多条线程,而每条线程都是一次完整的 Claude Code 会话——官方明确提示,项目会比单个会话更快触及用量上限。配套的控制手段有两个:
1. 项目级用量查看
在项目设置里查看本项目专属的用量,
与你在其他场景的额度分开计量。
2. 双向分别选型
协调者会话与工作线程可以各自选择模型与 effort 档位
(档位越高越贵也越慢)。
常见搭配:协调者用高档位做拆解与复核,
工作线程用中档位执行机械性迁移。
先算一笔账再放开并行度。把一个任务拆成五条线程,消耗的不是五分之一的额度,而接近五次完整会话。跑长任务前看一眼项目用量页,确认当前额度能撑到验收点,否则任务会停在半程,上下文状态比进程更难收拾。
Step 4:派活、跟进度、学会「只看该看的」
工作铺开后的日常监控有两个入口,对应两种注意力:
| 入口 | 看什么 | 什么时候用 |
|---|---|---|
| 主项目会话 | 整体进度、协调者的检查点与汇总 | 日常巡检,大多数时候只看这里 |
| 单条线程 | 该线程的执行细节、分支与产出 | 某条线程结果异常,或需要人工干预时 |
协调者会主动检查并跟进各项任务,你也可以随时在主会话里插话纠偏,包括用手机远程调整。官方明确说明:你离开电脑后它会继续工作。另外,沟通风格本身也是可调的——你可以要求它改变检查频率、开新线程的频率,以及每次汇报的详细程度。
Step 5:把冲突交给 git,而不是协调者
多条线程并行,撞到同一份代码怎么办?Anthropic 的选择很务实:不发明新的冲突解决机制,重叠一律按普通 PR 的合并冲突处理。协调者维持秩序,但代码层的裁决权仍在你们熟悉的 git 工作流里。
实操要点:
1. 让任务边界尽量不重叠(按模块/按仓库拆线程)
2. 出现合并冲突时,按你团队处理普通 PR 的流程走
3. 留意「由谁拍板」:协调者可以汇总冲突信息,
但业务语义上的取舍应当由人确认
4. 优先合并低风险线程,给后续线程留干净的基线
冲突频率是任务拆分质量的信号。如果一个项目里线程之间频繁打架,说明拆分维度不对——按层拆(前端/后端)比按需拆(每个需求各开线程)更容易撞车。调整拆分比硬解冲突便宜得多。
Step 6:用好共享记忆与 Library
每条线程都会向项目记忆写入、并从其中读取。官方举的例子很具体:它能记住发布日期改到了周五、某个导出功能为什么被砍、动计费服务之前该先找谁确认。它还会记住你的工作与沟通风格。配套的 Library 则收集你添加的文件与 Claude 产出的各类工件,让一条线程的产出能被另一条线程和后续会话找到。
推荐的记忆维护习惯:
1. 关键决策发生反转时,明确告诉协调者「之前的决定作废」
2. 约束性信息(红线、审批人、发布窗口)主动写进项目指令
3. 每周看一眼记忆里积累了什么,清掉过期的
4. 把可复用的模板、规范放进 Library,而不是散在各线程里
自动积累的记忆也会自动积累错误。被推翻的决定、过期的约束、已经换人的对接人,都会安静地躺在记忆里影响后续判断。信任一份基于记忆产出的计划之前,先检查项目「相信什么」。这正是官方保留手动纠偏入口的原因。
Step 7:知道边界在哪,什么时候不该用它
| 边界 | 现状 | 应对 |
|---|---|---|
| 线程只在云端运行 | 本机运行、接入本地工具与自有网络的能力官方称很快推出,但没给时间表 | 强依赖本地栈或内网环境的任务继续用本地会话 |
| Beta 准入窄 | 首批限定条件多,Team/Enterprise 在后续批次 | 团队先由个别人验证工作流,再等扩容 |
| 用量消耗快 | 多线程并行等于多会话并行 | 按 Step 3 的双向选型控制,长任务分段跑 |
还有一类任务天然不适合它:答案在单次对话里就能给出的咨询、改动范围只有一两个文件的小修小补、以及需要严格气隙环境的合规场景。识别「这活不值得开项目」和学会开项目同样重要。
常见问题速查
| 你遇到的现象 | 大概率原因 & 解决 |
|---|---|
| 看不到新版 Projects 入口 | 三条 Beta 准入条件未全满足,或尚未扩容到你的账号;进等待名单排队 |
| 额度消耗远超预期 | 多线程并行是完整会话并行。查项目级用量,下调线程档位或减少并行数 |
| 线程之间频繁合并冲突 | 任务拆分维度不当,改按模块/仓库拆分再跑 |
| 它记错了某个旧决定 | 记忆里有过期信息。在主会话明确纠正,并清理项目指令里的过时条目 |
| 想在本机跑线程 | 当前仅支持云端,本地运行能力官方称即将推出,关注后续版本 |