
Claude Code Projects 怎么用:多智能体并行
Claude Code Projects 是 Anthropic 在 9 月 17 日全面重构的多 Agent 并行方案:你在主对话下达目标,协调者 Agent 自动把任务拆成子任务,丢给云端独立分支并行写代码,写完自动提 Pull Request,再配合「共享记忆」解决多个 Agent 互相记不住状态的上下文漂移。本文按官方文档核实后的步骤,从开启到选型给你走一遍,全流程约 10 分钟,需要 Pro 或 Max 订阅。
目录如下:先看 Projects 是什么、和旧并行方案有什么差别;再按入口、创建、发任务、看 Overview、配共享记忆、选模型六步走;最后是常见卡点速查和 FAQ。
Projects 是什么:为什么单独出这篇教程
9 月 17 日,Anthropic 把 Claude Code 的 Projects 从「一个装提示词和文档的文件夹」重构整合成一套多 Agent 协作调度系统。官方Claude Code Projects 文档把它定位成「一个持续对话,Claude 负责协调一连串相关的工作」(原文:one ongoing conversation where Claude coordinates a stream of related work)。
下面这张图画的就是三层的配合方式。

核心是三层结构。第一层是协调者对话,也就是那个长期存在的主窗口,它只负责接任务、拆线程、看汇报,不写代码;第二层是线程,每个线程是一个独立的 Claude Code 云端会话,有各自独立的上下文窗口,各自在一条独立的 Git 分支上干活,干完自动开 PR;第三层是共享记忆,线程执行过程中沉淀的技术规范、架构决策、团队偏好都会同步回项目,让后面的线程不用重新理解现状。
你随手把 bug report 或报错栈丢进对话,Claude 会自动开一条线程或交给正在干这类事的线程,快速问题甚至直接就地回答。等你回来,Overview 面板会告诉你哪些线程干完、哪些 PR 待审、哪些在等你。
Projects 与旧并行方案有什么不同
中文 SERP 上流行的多 Agent 教程,大多是旧的并行方案:Subagents、Agent view、Agent teams、dynamic workflows,再加 worktrees 和 /batch 分片。Projects 处理的是这些方案共同的痛点:多个会话各写各的、上下文互相污染、要反复重复粘贴配置、合并分支易冲突。想先摸清 Claude Code 的基础搭配,可以看Claude Code 常用斜杠命令详解这篇。
Projects 用「本地记忆 + 独立分支 + 自动 PR」把冲突和上下文漂移锁在单个线程里。你只需要把规则说一遍(比如「目标仓库用 xxx」),所有线程启动时都自动带上项目的说明和记忆。
和老版比,Cursor 9 月 10 日先发布了 Projects 的 beta(Coordinator Agent + 数千子 Agent),我们在Cursor Projects 教程里讲过,Anthropic 这套在云端分支和 PR 闭环上更顺。想先整体认识 Claude Code 的能力边界,可看Everything Claude Code 完整上手。
前置准备:账号、配额与入口
开始前先确认三件事,缺一样都能让你用不起来:
- 订阅档位:Projects 目前在 Pro 和 Max 上公开测试,Team / 企业版还没全量;没入口就先在官方等待列表登记。
- GitHub(任务涉及代码时):代码要放在 github.com,账号有仓库 push 权限,且装好 Claude GitHub App,否则云端线程够不着仓库。
- 配额与成本:Projects 走 Claude Code 套餐额度,比普通会话烧得快;新线程默认跑旗舰模型高阶强度,后面到设置里调。
第一步:找到入口并新建项目
入口有三个:浏览器端 claude.ai/code、桌面 App 的 Code 标签页、以及 Claude 移动端 iOS/Android。
创建有两种方式。
从零创建
- 打开 claude.ai/code,左侧栏找到 Projects,点 New project。
- 在 New project 对话框里填:Name 必填,是项目名;Goal 可选,一句话写要达成什么;Context 可选,挂这个项目要读的 GitHub 仓库、文件、文件夹或 Google Drive 目录。
- 点 Create project 完成。项目对话会带输入框打开,之前挂过仓库的话,Claude 会先派一条只读探索线程给你建议下一步。
从已有会话继续 如果某个 cloud session 干到适合沉淀成项目:在会话菜单里选 Continue as a project 或 Move to project,Claude 读出会话内容并贴出 Setup recommendations 让你确认。
第二步:写清项目说明,这是共享记忆质量的地基
这是整套上手最值钱的一步。所谓项目说明,就是每个线程启动时都带上的那份「工作简报」,写一次给全部分支共用。
建议至少覆盖四件事:
- 目标分支:改动要往哪个分支提交。
- 验证方式:线程跑完怎么自检(跑哪个测试命令)。
- 边界:哪些文件谁也不许碰、哪些命令不允许执行。
- 环境提醒:依赖什么模型、走什么工具。
仓库里的 CLAUDE.md 和 skills 也会被线程自动带上,作为说明的补充。写清楚之后,你就不用每个子任务都手动粘一遍配置了。
第三步:把任务发给协调器并读回结果
创建项目后,最关键的一句话就是「直接在其中发消息」。你可以一次发一批任务,Claude 自动拆成多个线程;也可以补一句临时变更,它判断是就地答、新开线程,还是派给正在干相关活的线程。
每条新线程在你消息下方生成一张卡片,点卡片打开看完整结果。产物集中在 Overview 的 Library 标签页,PR 集中在 Pull Requests 标签页。

//finance.sina.com.cn/stock/t/2026-09-18/doc-inisfazn8644472.shtml)
选模型与成本:把额度控住
新项目默认每条线程跑在旗舰模型的高阶强度上,烧得最快。官方给的调节点:
- 到 Project settings > General 看
Thread model和Thread effort,可换便宜的模型或降强度。 - 让 Claude 先建议线程、设定同时并行条数,等线程稳定再放开。
- 只想处理一次性小任务就别建项目,直接开 cloud session 或 Agent view 更省。
- 把踩过的坑补进共享记忆字段,后续线程直接绕开。
常见卡点速查表
| 现象 | 可能原因 | 处理办法 |
|---|---|---|
| 左侧栏看不到 Projects | 功能还没开放到你的账号 | 确认符合 Pro/Max 且在等待列表登记,官方文档看入口 |
| 线程读不到代码仓库 | GitHub App 未安装或未授权 | 装 App 并授权仓库,组织仓库需管理员授权 |
| 线程干不了活 | 任务依赖本机特有资源(数据库/内网) | 用 Remote Control 放本机执行,其余走云端 |
| 线程乱猜不提问 | 项目说明或共享记忆不清楚 | 去 Project settings 把验证方式、边界写准 |
| PR 冲突 | 多个线程碰了交叉文件 | 约定边界、拆线程、让线程只读共享 |
常见问题
Claude Code Projects 免费吗?
答:Projects 作为 Claude Code 在 Pro / Max 上的试用功能,不单独收费,但会占用你的套餐额度。因为它每开一条线程就是一次独立的云端会话,用起来比单会话烧得快,超出套餐限制按用量规则结算。
Projects 和 Subagents / Agent view 有什么差别?
答:Projects 是跨会话的长期协作,一个协调对话持续存在,靠本地记忆和项目说明把多个线程对齐,线程云端自己分支并自动提 PR。Subagents 只是单会话里派出去的子代理,只把自己上报给当前会话;Agent view 是手动开一堆独立会话。旧方案要你重复喂背景,Projects 把背景写进项目一次到位。
Projects 的线程会不会互相冲突改坏代码?
答:多个线程同时改同一份文件会产生合并冲突,和普通 PR 冲突一样在合并阶段解决。想少踩雷:在项目说明里约定好边界,把共享文件拆成独立线程,或让多数线程只读共享部分。需要本机私有资源时,用 Remote Control 放回本机跑。
能让多个线程互相评审、彼此提问吗?
答:Projects 的多线程主要是并行各自干活,靠共享记忆统一规则,适合批量跑任务、多仓库统一改、PR 汇总审查这一类。若你要多个 Agent 组队讨论、彼此逐条质疑,那是旧版 Agent teams(实验特性)的用法。两者目标不同,按需选一个。
26% 的研发任务由 AI 主导是什么意思?
答:这是 Anthropic 公布的内部研发自动化指数:截至今年 8 月约 26% 的 AI 研发任务已由 AI 主导完成,半年前还不到 1%,内部每天同时跑约 3 万个人 Agent。它说明 Projects 这类多 Agent 编排已经从概念进入规模化生产,任务调度 + PR 审查 + 边界管理正成为新一代团队协作的核心能力。

京ICP备2024094994号-29