Claude Code Projects 是什么、怎么用:让 Claude 替你分派和跟踪一连串任务
Projects 是 Claude Code 的新功能,目前对 Pro 和 Max 公测:一个长期的对话里,Claude 把你交代的事拆成一个个并行的云端会话来做,并跟踪每一个的进度。本文说明它适合什么、怎么建、怎么看进度、用量怎么算,以及有哪些限制。
本文根据公开分享整理,本站尚未实测。操作前请对照文末的原始来源。
Anthropic 在 2026 年 10 月 9 日宣布:Claude Code Projects 候补名单里的 Pro 和 Max 用户已经全部放行。一句话概括这个功能:项目是一个长期的对话,你在里面说要做什么,Claude 负责把它拆成一个个任务、各开一个会话并行去做,并替你盯着每一个的进度。
先说三个前提:
- 目前只对 Pro 和 Max 套餐公测,Team 和 Enterprise 还不能用。 侧边栏里没有 Projects 的话,说明还没轮到你的账号,可以去排候补名单。
- 它只在网页(claude.ai/code)、桌面应用和手机应用里有,终端里的命令行、VS Code 扩展和 JetBrains 插件里没有;通过 Amazon Bedrock、Google Cloud 或 Microsoft Foundry 接入时也不能用。
- 它比单个会话更费用量。 新项目默认让每个任务都用 Opus 加高 effort,官方直说这是消耗套餐最快的组合。
每个任务默认是一个云端会话。云端会话是什么、怎么连 GitHub,见本站的 Claude Code 云端会话怎么用。
它和“自己开几个会话”有什么不同
Claude Code 里能同时跑多个会话的功能有好几个,所以“并行”本身不是项目的特点。区别在于:在项目里,是 Claude 而不是你来发起和跟踪这些会话,而且每一个都从同一份说明开始。
一个项目由这几部分组成:
| 部分 | 是什么 |
|---|---|
| 项目对话 | 一个长期的会话,Claude 在里面当协调人。它接收你发的东西,决定哪些该开成任务,并记着它开过的每一个。它看到的是各个任务的汇报,不是每一步操作 |
| 线程(thread) | 干活的。每个线程是一个独立的会话,有自己的上下文,做一件事,做完向项目对话汇报。云端线程在自己的分支上工作,需要时会开一个 PR |
| Overview 面板 | 在对话旁边,一眼看到所有线程和哪些在等你 |
每个云端线程开始时都带着:项目的仓库和文件、项目的说明和记忆、各仓库里的 CLAUDE.md 和 skills、你 claude.ai 账号上的连接器,以及一个决定网络访问和已装工具的云端环境。
你本机的 Claude Code 设置不会带过去。 这一点和云端会话相同。
什么时候值得建一个项目
官方的判断标准:这件事的目标比一次会话长,而且会不断产生新任务。举的四类例子:
- 一个目标,很多仓库。 “把所有服务都升到新的 lint 配置。”每个仓库一个线程,各开各的 PR。
- 一块你不断往里送东西的领域。 某个服务的 bug、报错堆栈和评审请求,收到就贴进对话。修某个问题时让 Claude 记住的坑,下一个任务也能用上。
- 比一次会话大的建设或迁移。 “把
docs/spec.md里写的东西做出来”“把应用从旧的 ORM 上迁走”。 - 不是代码的工作。 一个合同文件夹,或者一份导出的工单,你隔三差五要问新问题。上传文档而不是添加仓库,线程把每份结论作为文件交回来。
不适合的情况:
| 情况 | 更合适的做法 |
|---|---|
| 一次会话就能做完的事,比如“修掉登录测试里那个不稳定的用例” | 自己开一个云端会话 |
| 每个任务都要用到你本机的东西:本地数据库、模拟器、VPN 后面的接口 | 用本地会话 |
只有少数任务需要本机时,项目仍然合适:可以让那一个线程在你自己的电脑上跑(见后文)。
建一个项目
先检查三件事
- 套餐:Pro 或 Max,并且侧边栏里有 Projects。
- GitHub(项目要处理代码的话):代码在 github.com 上,不是 GitHub Enterprise Server、GitLab 或 Bitbucket;你连接的 GitHub 账号对它有推送权限;并且在它上面装了 Claude GitHub App。注意:用
/web-setup连接的方式够普通的云端会话用,但不够项目的云端线程用。 - 网络、密钥和工具:这些来自项目的云端环境。默认环境已经能访问常见的包仓库,只有需要别的域名、密钥或没预装的工具时才要另外配置。
创建
- 在 claude.ai/code 或桌面应用的 Code 标签页,点左侧的 Projects,再点 New project。
- 填三样东西,只有名字是必填的:
- Name:项目的名字。
- Goal(可选):一句话说你要达成什么,比如“把 API 的 p95 延迟保持在 200 毫秒以内”。
- Context(可选):项目要处理的 GitHub 仓库,以及线程应该读的文件、文件夹或 Google Drive 文件夹。加多数任务都要用到的仓库就行,不用把可能碰到的全加上。
也可以从一个已有的云端会话开始:把它“继续成一个项目”,或者“移进一个项目”。
第一批任务之前,先做四件事
官方建议在给新项目派第一批活之前:
- 写项目说明。 这是每个线程开始时都会读的简报(见下一节)。
- 先派一件小的真实任务,等它做完,打开线程看它是怎么汇报的、在分支上做了什么。
- 检查线程的模型和 effort。 在 Project settings > General 里。新项目默认每个线程都用 Opus 加高 effort。
- 让 Claude 先提出要开哪些线程、等你点头再开,并且一次只跑几个。 等几个线程的结果都符合预期了,再放开。
项目说明怎么写
点项目标题栏的齿轮图标,进 Project settings > Memory > Project instructions。一份有用的说明要写清:
- 这个项目是干什么的;
- 工作在哪里进行:哪些仓库、从哪个分支开始、PR 怎么命名;
- 线程在说“做完了”之前,怎么自己检查;
- 需要的东西缺了怎么办;
- 哪些事要先得到你的同意。
官方给的例子:
This project holds p95 latency for the payments API under 200 ms: profiling, query and caching fixes, and the dependency upgrades that come with them, in the payments-api repository.
- Branch from main and open one draft pull request per thread.
- Before you call work done, run `make test` and `make lint` and paste the summary lines in your final message.
- If you can't reach something you need, such as a repository, a secret, an API, or a connector, say exactly what's missing in your first message and stop. Don't substitute, mock, or guess.
- Don't merge, force-push, or change CI configuration without asking me in the thread.
两条补充:
- 只和某一个仓库有关的规矩(比如它的构建命令)写进那个仓库的
CLAUDE.md,每个云端线程都会读。 - 工作开始之后,你纠正了某个线程,同时告诉 Claude 记住这条纠正,它会进入项目记忆,后面的线程也能用上。
怎么看进度
Overview 面板的 Threads 标签页按状态给线程分组:
| 分组 | 里面是什么 |
|---|---|
| Ready for review | PR 已经开了、等你评审的线程 |
| Waiting on you | 需要你回复或批准的,或者失败了的 |
| Working | 还在跑的 |
| Landing | PR 已经批准或排队等合并的 |
| Idle | 做完了、也没在等什么的 |
| Resolved | 标记为完成的:你标的,Claude 在你做完最后一步(比如合并 PR)后标的,或者一周没动静后自动标的 |
面板另外几个标签页:Library 放你加的文件和线程产出的文件,Pull requests 放线程开的 PR,Routines 放项目里的定时任务。
桌面应用还会发系统通知:Claude 在对话里发了消息、某个线程出错或需要你时都会提醒。浏览器里没有通知,看 Overview 按钮上的小圆点。
两个容易卡住的地方
线程在等批准,但你在项目对话里说“继续”没用。 线程默认以 auto 模式运行,多数操作不用问你。但它确实需要你批准时,那个提示在线程里面,线程会一直等到你在那里回答。在项目对话里告诉 Claude “去做吧”传不到它那里。
想让所有线程都能不经询问地运行某些命令,把权限规则写进仓库的 .claude/settings.json。要注意:只有一个仓库的项目,云端线程会用上这些规则;有多个仓库、又用的是 Anthropic 托管的环境时,任何仓库的权限规则都到不了云端线程。
没提交的改动可能丢。 云端线程的沙箱在两轮之间会暂停,继续时再恢复。恢复不了的话,线程会从一份全新的克隆继续,没提交的改动就没了。长任务要让 Claude 把进行中的工作提交并推送。
让某个线程在你自己的电脑上跑
任务需要只有你电脑上才有的东西时(本地数据库、模拟器、VPN 后面的接口),可以在项目对话里让 Claude 把这个任务的线程放到你的电脑上跑。它通过 Remote Control 连接,项目的其他线程照常在云端。
这种线程和云端线程的区别:
- 用的是那台电脑上的文件、工具、MCP 服务器和 Claude Code 设置,包括 hooks 和权限规则;
- 会带上项目的说明,但不会加载项目的记忆文件;
- 只在那台电脑醒着、Remote Control 开着的时候运行。
两种接入方式,都要求那台电脑上的 Claude Code 是 v2.1.280 或更高:
- 桌面应用:打开 Settings > Claude Code,打开 Use this computer from your phone and claude.ai,把文件夹加到下面的列表里。
- 终端:在那个文件夹里运行
claude remote-control并保持运行。
用量怎么算
项目的用量和你其他的 Claude Code 会话算在同一个套餐额度里,项目自己不会花超过这个额度。
- 线程碰到额度上限时会等着,额度重置后自己继续。也就是说,你留着在跑的工作会直接用掉下一个用量窗口。
- 只有你给账号开了“用量额度”(usage credits),工作才会超出套餐的限制。线程不能替你打开它。
官方说得很直接:项目比单个会话用得快,Pro 套餐尤其如此,跑项目的日子要预期更早碰到上限。 消耗用量的有三处:
| 哪里在用 | 说明 |
|---|---|
| 运行中的线程 | 每个都是一个完整的会话,可以同时跑好几个。没有固定的个数;你要求的上限只是偏好,不是硬限制。硬限制是所有项目加起来每天最多新开 200 个线程 |
| 项目对话本身 | Claude 读各个线程的汇报、决定下一步,也要用 token |
| 盯着 PR 的线程 | 一个空闲的线程,在它的 PR 上 CI 失败或来了评审意见时会醒来,再次消耗用量。不想这样,就在线程里让它别再盯着那个 PR |
没有线程在跑、没有被盯着的 PR、也没有新消息的项目,闲置时不消耗用量。
怎么省
在 Project settings 的 Usage 里可以看到每个线程、每个模型用了多少,以及项目对话用了多少。降低用量的办法:
- 不需要最大模型的工作,给线程、对话或两者换小一点的模型或低一点的 effort。模型和 effort 在 Project settings > General 里设,线程和协调对话是分开的两组设置。
- 让 Claude 一次少跑几个线程,或者小问题自己回答,不要为它开线程。
- 一个闲置超过缓存有效时间(Pro 和 Max 是一小时)的线程,再接到后续任务时,要先把整段对话重读一遍。新的工作与其唤醒一个很大的旧线程,不如让 Claude 开一个新的。
其他限制
- 项目只属于一个人。 不能把项目或它的线程分享给别人,测试期间也没有组织层面的管理选项。
- 线程不能换项目,也不能挪出来单独存在。你自己在本机开的会话不能加进项目。
- 不需要你管理上下文:线程会自动压缩,项目对话靠最近的消息、最近的线程和项目记忆工作,所以能一直进行下去。绝对不能丢的东西,放进项目记忆。
- 通过中转站或第三方供应商使用 Claude Code 的话,用不了 Projects:官方写明项目的线程以 Anthropic 作为模型提供方,也不支持 Bedrock、Google Cloud 和 Microsoft Foundry。