工作流 📋 7 个步骤 第 447 / 450 篇

Claude Code Projects 重做实操:把多仓库任务交给协调者与并行线程

Claude Code Projects Beta 全流程实操:准入确认、目标写法、协调者与线程的模型分级、并行监控、合并冲突处理、共享记忆与 Library 维护,以及三条硬边界。

2026.09.19· 25 分钟阅读· 约 2669 字· 🧭 Claude Code / 🧵 并行线程

2026 年 9 月 17 日,Anthropic 把 Claude Code 的 Projects 重构成了一个「协调者 + 并行线程」的编排层,以 Beta 形式推送。变化的核心是工作单元:过去在一条构建线上跑多个会话,拆活、交接、拼结果都靠你自己;现在你在项目里描述要达成什么,由 Claude 来界定范围、分派任务、协调并行线程、复核产出并汇总结果。这篇教程带你把一个真实的多仓库任务交给他跑通,并把用量、冲突和记忆这几处最容易踩坑的地方一次性讲清。

🎯 适合人群:持有 Claude Pro 或 Max 订阅、已在用 Claude Code 云端会话的开发者与团队负责人。需要能连上 GitHub 的仓库环境,不需要自建任何服务。

先理解:项目里到底有什么

重构后的 Projects 由两类角色组成,理解这个分工是用好它的前提:

角色是什么你要做什么
协调者(主项目会话)一个常驻的 Claude 会话,负责拆解目标、路由任务、跟进进度、汇总结果像给幕僚长做简报一样陈述工作,随时在主会话里监控与纠偏
线程(Thread)每条线程都是一次完整的 Claude Code 云端会话,独占一个分支与一份仓库副本下钻到单条线程细调,或者放手让它跑

官方给的两个示例场景很能说明它的适用面:给一个应用设「把结账接口 p75 延迟降下来」的目标,让它逐个端点做性能剖析、测试优化并开 PR;或者接上 API、Web、移动端三个仓库,设「下线废弃的 v1 端点」的目标,让它每个仓库开一条线程迁移调用方、跑测试、开 PR,最后告诉你哪些要先合。注意它的定位:适合跑超过一次回复时长、且不止一个部分的长任务,单点小修改用不上这套编排。

Step 1:确认你有没有 Beta 准入

1 门槛是三条,逐条对照

Beta 首批只开放给同时满足以下条件的用户:

□ 订阅档位为 Claude Pro 或 Max
□ 在 Claude Code 里使用过云端会话(cloud sessions)
□ 网页端与桌面端没有任何既有 Projects

三条都满足却还没看到入口,可以加入官方等待名单排队。官方计划在一周内扩大到更多同档位用户,之后才轮到 Team 与 Enterprise。已有项目不会被强制迁移,会按原样继续工作、随推送升级。

这是 Beta,不是正式功能。 Anthropic 没有承诺行为不变:协调者的拆解策略、线程调度、记忆机制都可能随版本调整。把重要的生产仓库先放到只读或低风险的分支上试,别在发布周拿它做不可逆的操作。

Step 2:建项目,把目标写成「可验收的一句话」

2 目标质量决定编排质量

创建项目时你要选一个目标(Goal)并挂上仓库或上下文。协调者会先建议它能马上着手的工作,所以目标写法直接决定它给出的任务清单靠不靠谱:

写得不好的目标:
  「优化一下结账流程」
  → 没有度量、没有边界,协调者只能猜范围

写得可用的目标:
  「把结账接口的 p75 延迟从 900ms 降到 400ms 以内,
   逐个端点定位慢点,改动以 PR 形式提交,不改变对外行为」
  → 有度量、有约束、有交付形态

挂上下文时按需选择:接了仓库,线程就能开 PR、跑项目里的测试;挂的是文档,线程就读文档、产草稿。两类的交付物不同,别混在一个目标里。

💡 项目级配置项都在这一步集中管理:云端环境、连接器、插件、项目指令与模型。项目指令相当于给协调者的常驻简报,把「合并前必须跑哪些测试」「哪些目录不许碰」写在这里,比每次口头交代可靠。

Step 3:给协调者和工作线程分别定模型与档位

3 这是本项目最直接的成本旋钮

一个项目可以同时跑多条线程,而每条线程都是一次完整的 Claude Code 会话——官方明确提示,项目会比单个会话更快触及用量上限。配套的控制手段有两个:

1. 项目级用量查看
   在项目设置里查看本项目专属的用量,
   与你在其他场景的额度分开计量。

2. 双向分别选型
   协调者会话与工作线程可以各自选择模型与 effort 档位
   (档位越高越贵也越慢)。
   常见搭配:协调者用高档位做拆解与复核,
   工作线程用中档位执行机械性迁移。

先算一笔账再放开并行度。把一个任务拆成五条线程,消耗的不是五分之一的额度,而接近五次完整会话。跑长任务前看一眼项目用量页,确认当前额度能撑到验收点,否则任务会停在半程,上下文状态比进程更难收拾。

Step 4:派活、跟进度、学会「只看该看的」

4 主会话看全局,单线程看细节

工作铺开后的日常监控有两个入口,对应两种注意力:

入口看什么什么时候用
主项目会话整体进度、协调者的检查点与汇总日常巡检,大多数时候只看这里
单条线程该线程的执行细节、分支与产出某条线程结果异常,或需要人工干预时

协调者会主动检查并跟进各项任务,你也可以随时在主会话里插话纠偏,包括用手机远程调整。官方明确说明:你离开电脑后它会继续工作。另外,沟通风格本身也是可调的——你可以要求它改变检查频率、开新线程的频率,以及每次汇报的详细程度。

💡 每条线程还可以继续用 subagents、loops 与 workflows 把分配到的大活再拆小。如果一个线程跑得太久没有产出,先看它有没有用上这层二级拆分,而不是直接推倒重来。

Step 5:把冲突交给 git,而不是协调者

5 这是整套设计里最值得学的一处

多条线程并行,撞到同一份代码怎么办?Anthropic 的选择很务实:不发明新的冲突解决机制,重叠一律按普通 PR 的合并冲突处理。协调者维持秩序,但代码层的裁决权仍在你们熟悉的 git 工作流里。

实操要点:
1. 让任务边界尽量不重叠(按模块/按仓库拆线程)
2. 出现合并冲突时,按你团队处理普通 PR 的流程走
3. 留意「由谁拍板」:协调者可以汇总冲突信息,
   但业务语义上的取舍应当由人确认
4. 优先合并低风险线程,给后续线程留干净的基线

冲突频率是任务拆分质量的信号。如果一个项目里线程之间频繁打架,说明拆分维度不对——按层拆(前端/后端)比按需拆(每个需求各开线程)更容易撞车。调整拆分比硬解冲突便宜得多。

Step 6:用好共享记忆与 Library

6 让上下文自己积累,而不是靠你复述

每条线程都会向项目记忆写入、并从其中读取。官方举的例子很具体:它能记住发布日期改到了周五、某个导出功能为什么被砍、动计费服务之前该先找谁确认。它还会记住你的工作与沟通风格。配套的 Library 则收集你添加的文件与 Claude 产出的各类工件,让一条线程的产出能被另一条线程和后续会话找到。

推荐的记忆维护习惯:
1. 关键决策发生反转时,明确告诉协调者「之前的决定作废」
2. 约束性信息(红线、审批人、发布窗口)主动写进项目指令
3. 每周看一眼记忆里积累了什么,清掉过期的
4. 把可复用的模板、规范放进 Library,而不是散在各线程里

自动积累的记忆也会自动积累错误。被推翻的决定、过期的约束、已经换人的对接人,都会安静地躺在记忆里影响后续判断。信任一份基于记忆产出的计划之前,先检查项目「相信什么」。这正是官方保留手动纠偏入口的原因。

Step 7:知道边界在哪,什么时候不该用它

7 三条硬边界
边界现状应对
线程只在云端运行本机运行、接入本地工具与自有网络的能力官方称很快推出,但没给时间表强依赖本地栈或内网环境的任务继续用本地会话
Beta 准入窄首批限定条件多,Team/Enterprise 在后续批次团队先由个别人验证工作流,再等扩容
用量消耗快多线程并行等于多会话并行按 Step 3 的双向选型控制,长任务分段跑

还有一类任务天然不适合它:答案在单次对话里就能给出的咨询、改动范围只有一两个文件的小修小补、以及需要严格气隙环境的合规场景。识别「这活不值得开项目」和学会开项目同样重要。

常见问题速查

你遇到的现象大概率原因 & 解决
看不到新版 Projects 入口三条 Beta 准入条件未全满足,或尚未扩容到你的账号;进等待名单排队
额度消耗远超预期多线程并行是完整会话并行。查项目级用量,下调线程档位或减少并行数
线程之间频繁合并冲突任务拆分维度不当,改按模块/仓库拆分再跑
它记错了某个旧决定记忆里有过期信息。在主会话明确纠正,并清理项目指令里的过时条目
想在本机跑线程当前仅支持云端,本地运行能力官方称即将推出,关注后续版本
← 返回教程中心