让 Claude 通过 Projects 协调持续进行的工作

• 将工作发送到一个地方：每当出现问题时，将错误报告、堆栈跟踪或任务列表粘贴到对话中。Claude 为每项工作启动一个线程，或将其传递给已在该区域工作的线程，并就地回答快速问题。
• 设置一次上下文：每个新线程都以项目的存储库、说明和内存开始，因此您陈述一次的规则（例如要针对哪个分支）会到达所有线程。
• 离开并返回查看完成的工作：当您一小时后或第二天早上回来时，Overview 窗格显示哪些线程已完成、哪些拉取请求已准备好供审查，以及哪个线程正在等待您的回答。

​

何时使用项目

• 跨多个代码库的一个目标：“将每个服务升级到新的 lint 配置。“Claude 可以为每个代码库运行一个线程，每个都有自己的拉取请求，Overview 窗格显示哪些已准备好审查。
• 您不断提供的一个领域：一个服务的错误、堆栈跟踪和审查请求，当它们到达您时粘贴到对话中。您在一次修复后告诉 Claude 记住的陷阱在项目记忆中供下一次使用。
• 比一个会话更大的构建或迁移：“构建 docs/spec.md 描述的内容”或”将应用从已弃用的 ORM 迁移出去。“工作分成线程，每个处理一部分，您要求 Claude 记住的早期决定会到达后续线程，您在构建期间发现的规范更改和错误进入同一对话。
• 非代码工作：一个合同文件夹或支持工单导出，您不断回来提出新问题，例如”在这些工单中找到十个最常见的集成错误。“上传文档而不是添加代码库，线程将每个写作作为文件提交到项目的Library 标签页。

​

何时其他方式更合适

• 一个适合在一个会话中完成的任务：“修复不稳定的登录测试。“自己启动一个云会话。
• 需要仅您的机器可以访问的工具或服务的工作：本地数据库、设备模拟器、VPN 后面的 API。使用本地会话，或代理视图同时运行多个。如果工作只需要本地文件，请将它们上传到项目。
• 一个按时间表重复的任务，周围没有对话：“每周一发布依赖报告。“在其自身上创建一个例程。
• 多个人在 Slack 频道中给 Claude 工作并一起引导它：请参阅 Claude Tag。

​

项目如何组织

• 项目对话：一个长期运行的会话，Claude 充当协调员。它接收您发送的内容，决定什么成为线程，并跟踪它启动的每个线程。它看到线程报告回来的内容，而不是它们采取的每一步。
• 线程：工作者。每个都是一个单独的云会话，有自己的上下文窗口，在自己的分支上完成一项工作，在工作需要时打开拉取请求，并在完成时报告回对话。
• 每个线程开始时的内容：
  • 项目的代码库和文件，加上其说明和记忆
  • CLAUDE.md、skills 和项目每个代码库中的 plugins，以及在有一个代码库的项目中，该代码库的权限规则和 hooks
  • 您 claude.ai 账户上的连接器
  • 一个云环境，设置其网络访问、环境变量、API 凭证和已安装的工具
• Overview 窗格：您在其中一次看到所有线程以及哪些需要您。其他标签页是 Library（用于您添加的文件和线程生成的文件）、Pull requests（用于线程打开的文件）和 Routines（用于项目中的计划工作）。

​

创建项目

• 从头开始，当您知道希望 Claude 运行的工作流时：打开 New project 对话框并命名它。从头开始启动新项目会逐步讲解对话框。
• 从已经在进行工作的云会话：从该会话的菜单中选择 Continue as a project，Claude 从会话正在做的事情中提议项目的设置。请参阅从现有云会话启动。

​

检查先决条件

• 计划：您在 Pro 或 Max 上，Projects 显示在您的侧边栏中。
• GitHub，如果项目将处理代码：您的代码在 github.com 上而不是 GitHub Enterprise Server、GitLab 或 Bitbucket 上，您连接的 GitHub 账户对其有推送访问权限，Claude GitHub App 已安装在其上。如果您使用 /web-setup 连接了 GitHub，该令牌让您的其他云会话可以访问代码库，但对于项目线程来说还不够，项目线程需要 Claude GitHub App。设置 GitHub 访问有相关步骤。
• 网络、凭证和工具：这些来自项目的云环境。默认环境已经可以访问常见的包注册表，因此仅在工作需要其他域、密钥或未预装的工具时检查此项。如果工作需要 MCP 服务器，检查它是否在您的 claude.ai 连接器中显示为已连接。

​

从头开始启动新项目

​

从现有云会话启动

• Continue as a project 创建一个以会话命名的新项目并打开它。Claude 读取会话并在对话中发布 Setup recommendations 供您确认。原始会话保留在您的会话列表中，如果它在轮的中间，它会继续运行，因此如果您不想两者同时工作，请自己停止它。如果您使用可能出现在云会话消息框上方的 Set up project 横幅，结果是相同的，除了会话的运行轮在项目打开后停止。
• Move to project 将会话的工作带入现有项目。它在该项目的对话中发布一条消息，要求 Claude 读取会话并从中断的地方继续，新工作在项目自己的线程中继续。原始会话保留在您的会话列表中，未改变。

​

设置 GitHub 访问

​

在项目中工作

​

您的第一批

1. 编写项目说明：每个线程开始的简报，例如要针对哪个分支、线程如何检查其工作以及什么需要您的批准。
2. 发送一个真实工作的小部分，或启动 Claude 建议的线程之一（如果它提供了任何），并在它完成时打开线程以查看它如何报告回来以及它在分支上做了什么。如果它假设了错误的东西或无法到达它需要的东西，线程猜测或停滞而不是询问涵盖了在哪里修复。
3. 检查 Project settings > General 中的 Thread model 和 Thread effort。新项目在高努力下在 Opus 上运行每个线程，这最快地使用您的计划；选择模型并让 Claude 管理上下文涵盖了替代方案。
4. 要求 Claude 在启动线程之前提议线程并一次运行几个，一旦几个线程以您想要的方式回来，就放弃这些限制。

​

发送工作并读取结果

• 快速问题通常在对话中得到答案。
• 新工作进入新线程或已在该领域工作的线程，Claude 告诉您哪个。每个新线程显示为您消息下的卡片：一个带有线程标题和状态的框，您点击打开线程。
• 一条消息中的多个不相关的任务成为单独的线程。

​

审查线程的拉取请求

• 分支：在新分支上工作，从代码库的默认分支开始。
• 拉取请求：当您要求时打开一个，并可以为错误修复或其他具体更改自己打开一个。
• 打开后：使用自动修复打开监视拉取请求，无论自动修复是否对您的其他云会话打开。它在 CI 失败时推送修复，处理审查评论，并在检查通过且拉取请求准备好供您审查时在线程中回复。

​

在 Overview 中查看需要您的内容

​

当您需要控制时打开线程

• 逐步阅读 Claude 做了什么。
• 通过在线程自己的消息框中写入来引导任务。那里的消息直接进入该线程，而项目对话中的后续只有在 Claude 将后续匹配到该线程时才会到达它。
• 回答线程等待的权限提示。
• 使用 Stop 中断线程，它在线程工作时替换发送按钮，或按 Esc。

​

选择模型并让 Claude 管理上下文

• Thread model 和 Thread effort 适用于线程。要为一个任务使用不同的模型，请在任务中要求它；对于已经运行的线程，使用该线程的模型选择器。
• Coordinator model 和 Coordinator effort 适用于项目对话中的 Claude。

​

调整 Claude 如何运行项目

• “提议线程并等待我的批准后再启动它们”或”现在启动这些而不要求我确认”
• “一次最多运行两个线程”或”为同一领域的后续工作重用现有线程”
• “发布更短的更新”或”仅在某些完成或被阻止时发布”
• “给我每个线程的状态更新”
• “用更小的模型做这个任务”
• “在我看到计划之前不要打开拉取请求”
• “告诉我这些代码库中有什么问题，不要修复任何东西”，当您想在任何东西成为线程之前查看发现时
• “在这里回答那个而不是启动线程”，当 Claude 为您打算作为快速问题的东西启动线程时

​

解除等待批准的线程

​

给项目提供常规上下文

​

编写项目说明

• 项目的目的
• 工作发生的地方：哪些代码库、从哪个分支开始、如何命名拉取请求
• 线程在调用完成之前如何检查自己的工作
• 当它需要的东西缺失时该做什么
• 什么需要您的批准

此项目将支付 API 的 p95 延迟保持在 200 毫秒以下：分析、查询和缓存修复，以及随之而来的依赖升级，在 payments-api 代码库中。

- 从 main 分支并为每个线程打开一个草稿拉取请求。
- 在您调用工作完成之前，运行 `make test` 和 `make lint` 并在您的最终消息中粘贴摘要行。
- 如果您无法到达您需要的东西，例如代码库、密钥、API 或连接器，请在您的第一条消息中准确说出缺失的内容并停止。不要替代、模拟或猜测。
- 不要在没有在线程中询问我的情况下合并、强制推送或更改 CI 配置。

​

决定要添加哪些代码库

• 将其添加到项目，在 New project 对话框中、Project settings > Environment 中，或通过在对话中要求 Claude 将其添加到项目。从那时起，每个线程克隆它并从其 CLAUDE.md 和 skills 加载开始，无论任务是否涉及它。从一个代码库转到多个也改变了线程从每个代码库的 .claude/settings.json 中获取什么；请参阅线程从您的代码库中获取什么。
• 将其留下，让线程在需要时添加它。 其任务需要项目没有的代码库的线程可以将其添加到自己，线程中的注释说它仅被添加到此线程。克隆发生在任务的中途，因此该代码库的 CLAUDE.md 和 skills 在线程启动时不存在。下一个线程再次启动时没有它。线程添加的代码库需要与项目代码库相同的先决条件：Claude GitHub App 安装在其上并从您的 GitHub 账户推送访问。

​

线程从您的代码库中获取什么

​

为线程选择环境

​

将 skills、plugins、connectors 和工具放入线程

• Skills、subagents 和 commands：将它们提交到您添加到项目的代码库，例如 .claude/skills/<skill-name>/SKILL.md 处的 skill。每个线程克隆项目中的每个代码库并从每个代码库加载 .claude/skills/、.claude/agents/ 和 .claude/commands/，因此提交到一个代码库的 skill 在每个新线程中可用。线程也加载您为 claude.ai 账户启用的 skills。
• Plugins：在 Project settings > Plugins 中添加它们；它们加载到每个新线程中。代码库在其 .claude/settings.json 中声明的 Plugins 也加载；请参阅什么从您的设置中进行。
• MCP 服务器：线程从您 claude.ai 账户上的连接器获取其 MCP 工具，这些是您在 claude.ai/customize/connectors 一次连接的 MCP 服务器，或通过 Project settings > Environment 中的 Manage connectors 链接。每个线程可以使用所有这些而无需每个项目的设置。项目对话本身没有连接器，因此将需要一个的工作作为线程的任务发送。在有一个代码库的项目中，线程也从该代码库的.mcp.json加载 MCP 服务器。连接器如何到达 Claude Code列出了云会话的规则和关闭连接器的设置。
• 命令行工具和包：在环境的设置脚本中安装它们。

​

项目设置参考

​

暂停、存档或删除项目

• Pause：一次停止所有东西。每个运行的线程和对话都被中断，没有新线程启动，例程不运行，项目不接受消息，直到您恢复它。点击同一地方或项目消息框上方的横幅中的 Resume；暂停的线程在您之后向其发送消息时继续。
• Archive：从侧边栏隐藏项目并存档其线程，这停止任何正在运行或监视拉取请求的线程。项目中的例程在存档时不运行。要恢复项目，请从 Projects 页面打开它并点击 Unarchive。其线程保持存档，直到您从会话列表中单独取消存档它们。
• Delete：永久删除项目及其线程、其记忆和其文件，并关闭项目的例程。这无法撤销。线程推送到 GitHub 的分支和拉取请求不受影响。

​

使用和成本

​

什么使用您的计划

• 运行线程：每个都是一个完整的会话，多个可以同时运行。没有固定数字；Claude 启动工作需要的尽可能多，您要求的限制是偏好而不是上限。强制限制是每天跨您的项目 200 个新线程。
• 对话：Claude 使用自己的令牌读取线程报告的内容并决定下一步做什么。
• 线程监视拉取请求：当 CI 失败或审查评论到达其拉取请求时，空闲线程唤醒并再次使用您的计划。要停止这个，请在线程中要求它停止监视拉取请求。

​

查看和减少项目的使用

• 路由到已闲置超过缓存生命周期（Pro 和 Max 在您计划限制内为一小时）的线程的后续，在做任何事情之前重新读取该线程的整个对话。对于新工作，要求 Claude 启动新线程可以使用比恢复大的旧线程更少的。
• 对于不需要最大模型的工作，为线程、对话或两者选择更小的模型或更低的努力级别。
• 在项目对话中要求 Claude 一次运行更少的线程，或自己回答小问题而不是启动线程。

​

项目与其他 Claude Code 功能的关系

• Claude Tag：Claude Tag 是您团队 Slack 频道中的 Claude，在 Team 和 Enterprise 计划上。频道中的任何人都可以给它工作，频道中的每个人都看到并引导它，它使用管理员为该频道设置的连接。项目是您的：您是唯一给它工作或看到其线程的人，它使用您自己的 GitHub 访问和连接器，它在 Pro 和 Max 上。Claude Tag 与 Cowork 和 Claude Code 的不同之处有并排比较。
• 云会话：每个线程都是一个云会话，由 Claude 而不是您启动和跟踪。您自己启动的云会话可以通过Continue as a project 或 Move to project成为项目或提供一个。
• 例程：当您在项目中要求计划工作时，Claude 创建一个例程，作为该项目中的线程运行，并出现在其 Routines 标签页上。您在项目外创建的例程继续自己工作。
• 本地会话和代理视图：您的终端、IDE 或桌面应用的本地环境中的会话在您的机器上运行，不能是项目的一部分。代理视图是用于跟踪多个这些本地会话的屏幕；它没有协调员。
• Worktrees：一个worktree为每个本地会话提供其自己的代码库工作副本，因此您机器上的并行会话不会相互覆盖。线程不需要它们：每个线程将其代码库克隆到其自己的云沙箱中，并在其自己的分支上工作。
• 代理团队：一个代理团队是一个会话，为单个任务启动队友会话，在您的机器上或在云会话内，并以该任务结束。
• claude.ai 聊天和 Cowork 中的 Projects：早期的 Projects 体验，对对话和参考文件进行分组，没有线程或协调员。这些项目继续按照今天的方式工作，直到重新设计的体验到达它们。

​

限制

• Projects 在 claude.ai/code 和桌面应用中可用，不在终端 CLI 或通过 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 中。CLI 的 claude project 命令（它管理目录的本地 Claude Code 状态）是无关的。
• 项目线程是云会话，Anthropic 作为模型提供者。安全和数据使用涵盖了云会话如何隔离以及保留什么。
• 本地会话不能是项目的一部分。
• 线程的沙箱在轮之间暂停，并在线程继续时恢复。如果沙箱无法恢复，线程从新克隆继续，因此未提交的更改可能会丢失。在长任务上，要求 Claude 提交和推送进行中的工作。
• 项目属于一个用户。您不能与另一个用户共享项目或其线程，线程记录没有其他云会话具有的共享选项。在测试版期间没有项目的组织级控制。
• 线程属于启动它的一个项目。您不能将线程移动或复制到另一个项目，或将其移出以独立存在。Move to project仅以另一种方式进行：它将云会话的工作带入项目。

​

故障排除

​

线程看起来卡住了

​

线程猜测或停滞而不是询问

1. 在对话中要求 Claude：“对于每个打开的线程，列出您要求它做什么、它假设或无法到达什么，以及它在等待什么。“Claude 读取每个线程并在对话中回答。
2. 对于从错误假设开始的线程，从 Overview 打开线程并从其菜单标记为已解决，或在其消息框中告诉它做什么。其分支和任何拉取请求保留在 GitHub 上，直到您删除它们。
3. 一次修复间隙，在项目说明或环境中，然后在再次发送其余工作作为新线程之前发送一个线程。

​

Claude 没有响应

​

代码库访问错误

• “Couldn’t start the session — Claude doesn’t have GitHub access to this project’s repository”，在线程启动之前报告，当 Claude GitHub App 未安装在该代码库上、已暂停或未链接到您连接的 GitHub 账户时。
• “Unable to access your repository”，由线程报告，当其克隆失败时：GitHub 拒绝了克隆、在项目拥有的名称下找不到代码库，或线程被要求启动的分支不存在。
• “Claude can’t access” 一个代码库，在您在 New project 对话框或 Project settings 中保存代码库时显示。消息继续带有安装链接和重新连接链接。如果 Claude GitHub App 不在该代码库上，使用安装链接，如果它在，使用重新连接链接，因为 GitHub App 可以在 GitHub 上安装而不链接到您连接到 Claude 的账户。如果消息说 GitHub App 已暂停或不包括此代码库，请按照其链接到 GitHub 修复。

​

线程达到使用限制

​

需要额外的使用信用

​

其他消息

​

相关资源

• 在云中使用 Claude Code：每个线程背后的云会话如何工作，包括 GitHub 访问选项和拉取请求上的自动修复
• 配置云环境：更改线程可以在网络上到达什么，为它们提供环境变量和 API 凭证，并使用设置脚本安装工具
• 使用例程自动化工作：例程的时间表、触发器和管理，包括 Claude 从项目创建的那些
• 使用代理视图管理多个代理：当工作需要仅您的机器可以到达的工具或服务时，在您自己的机器上运行和跟踪多个会话
• Projects redesigned: from folder to conversation：发布公告，带有使项目成为与 Claude 对话的思考