教程Claude Code系列第 2 / 8 篇

Claude Code Projects 是什么、怎么用:让 Claude 替你分派和跟踪一连串任务

Projects 是 Claude Code 的新功能,目前对 Pro 和 Max 公测:一个长期的对话里,Claude 把你交代的事拆成一个个并行的云端会话来做,并跟踪每一个的进度。本文说明它适合什么、怎么建、怎么看进度、用量怎么算,以及有哪些限制。

发布 · 约 9 分钟读完 · 经人工审核()· 本站的内容怎么来的

本文根据公开分享整理,本站尚未实测。操作前请对照文末的原始来源。

本页目录(10 节)
  1. 它和“自己开几个会话”有什么不同
  2. 什么时候值得建一个项目
  3. 建一个项目
  4. 第一批任务之前,先做四件事
  5. 项目说明怎么写
  6. 怎么看进度
  7. 两个容易卡住的地方
  8. 让某个线程在你自己的电脑上跑
  9. 用量怎么算
  10. 其他限制

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 后面的接口 用本地会话

只有少数任务需要本机时,项目仍然合适:可以让那一个线程在你自己的电脑上跑(见后文)。

建一个项目

先检查三件事

  1. 套餐:Pro 或 Max,并且侧边栏里有 Projects。
  2. GitHub(项目要处理代码的话):代码在 github.com 上,不是 GitHub Enterprise Server、GitLab 或 Bitbucket;你连接的 GitHub 账号对它有推送权限;并且在它上面装了 Claude GitHub App。注意:用 /web-setup 连接的方式够普通的云端会话用,但不够项目的云端线程用。
  3. 网络、密钥和工具:这些来自项目的云端环境。默认环境已经能访问常见的包仓库,只有需要别的域名、密钥或没预装的工具时才要另外配置。

创建

  1. 在 claude.ai/code 或桌面应用的 Code 标签页,点左侧的 Projects,再点 New project。
  2. 填三样东西,只有名字是必填的:
    • Name:项目的名字。
    • Goal(可选):一句话说你要达成什么,比如“把 API 的 p95 延迟保持在 200 毫秒以内”。
    • Context(可选):项目要处理的 GitHub 仓库,以及线程应该读的文件、文件夹或 Google Drive 文件夹。加多数任务都要用到的仓库就行,不用把可能碰到的全加上。

也可以从一个已有的云端会话开始:把它“继续成一个项目”,或者“移进一个项目”。

第一批任务之前,先做四件事

官方建议在给新项目派第一批活之前:

  1. 写项目说明。 这是每个线程开始时都会读的简报(见下一节)。
  2. 先派一件小的真实任务,等它做完,打开线程看它是怎么汇报的、在分支上做了什么。
  3. 检查线程的模型和 effort。 在 Project settings > General 里。新项目默认每个线程都用 Opus 加高 effort。
  4. 让 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。

来源

通过 API 中转站使用这些模型?到 Veridrop 免费检测中转站给你的是不是它声称的模型,或者看看中转站排行榜前 100 名。

相关文章