Claude Code Projects:协调器、/btw、/fork 与用量限制
Claude Code Projects 可以通过协调器管理多个并行编码线程。2026 年 11 月 14 日的更新增强了协调器,加入 /btw、/fork、线程提醒、单线程只读分享和产物导航。本文介绍使用资格、项目创建、GitHub 权限、线程配置与结果检查,并说明默认 Opus 和 high effort 为什么更容易耗尽套餐额度。你还将了解如何调整模型和 effort、控制线程数量、查看 token 用量、处理缓存过期,以及关闭 Auto-continue。最后比较 Projects、本地 CLI 会话、agent view 和 T3 Code 的适用场景。
本文内容

如果你需要同时处理多个相关的编码任务,又不想手动协调每个会话,可以考虑 Claude Code Projects。截至 2026 年 11 月 14 日,Projects 正面向 Pro、Max 和 Ultra 用户分批开放公开测试。新项目默认使用 Opus,工作线程的 effort 为 high,可能更快耗尽共享的套餐额度。
建议先创建一个小线程验证流程。简单任务可以尝试较小的模型和较低的 effort。如果希望保留下一使用周期的额度,还应关闭 Auto-continue。
Anthropic 在 11 月 14 日的更新中增强了协调器的主动汇报能力,并为 Projects 加入 /btw、/fork、线程提醒、只读分享和更方便的产物导航。
Projects 的核心价值没有改变:你在一个项目对话中描述相关工作,由 Claude 创建和管理实际执行任务的会话。但每个运行中的线程都是完整的 Claude Code 会话,都会消耗现有套餐额度。
Claude Code Projects 是什么?哪些用户可以使用?
Claude Code Project 是一个持续存在的项目对话。Claude 在其中担任协调器,创建并管理多个独立工作会话,这些会话称为线程(thread)。
例如,你可以一次提出三个任务:
- 修复身份验证功能的回归问题。
- 为支付接口补充缺失的测试。
- 排查一条执行缓慢的数据库查询。
协调器会把工作分配给不同线程,跟踪进度,并在项目对话中汇报结果。每个新线程都会收到项目指令,可以独立执行任务。
大多数线程通过 Claude Code 云端会话运行。每个云端线程都有自己的仓库克隆、独立沙箱和 Git 分支。
如果任务必须访问本机文件或工具,也可以让 Claude 通过 Remote Control 在你的电脑上运行线程。
云端线程在你关闭笔记本电脑后仍可继续工作。本机线程则依赖宿主电脑保持可用。
Claude Code Projects 与旧版 Claude.ai Projects 不同。旧版主要用于归集对话和参考文件;新版增加了主动协调以及真正执行编码工作的线程。
开放范围与候补名单
截至 2026 年 11 月 14 日,Anthropic 文档列出的开放情况如下:
| 套餐 | Projects 开放情况 |
|---|---|
| Pro | 公开测试,分批开放 |
| Max | 公开测试,分批开放 |
| Ultra | 公开测试,分批开放 |
| Team | 暂未提供 |
| Enterprise | 暂未提供 |
即使订阅了符合条件的套餐,也不代表你的账号已经获得 Projects 权限。
可以按以下步骤检查:
- 打开网页版 Claude Code。
- 在侧边栏查找 Projects。
- 如果没有看到,打开侧边栏中的 More。
- 也可以检查 Claude 桌面应用的 Code 标签页。
- 如果仍然没有 Projects,访问 Projects 候补名单。
还可以尝试直接打开 Projects 浏览页面。
初期开放优先考虑曾使用云端会话,且未在 Claude.ai chat 或 Cowork 中创建旧版 Projects 的账号。
Projects 并不是通过升级终端 CLI 就能开启的功能。Anthropic 通过网页端、桌面应用和移动应用提供该功能,实际访问权限取决于账号资格。
11 月 14 日的 Projects 更新了什么?
2026 年 11 月 14 日 06:51 UTC+8,Anthropic 的 @ClaudeDevs 账号宣布了多项 Projects 更新。
这些变化主要影响用户与协调器、独立线程及其产物的交互方式。
| 功能 | 作用 | 适用场景 |
|---|---|---|
| 更主动的协调器 | 在项目对话中回答问题、汇报线程状态 | 不逐个打开线程,也能了解多个任务的进度 |
/btw | 为临时出现的旁支问题创建独立线程 | 不打断当前工作,调查无关问题 |
/fork | 从当前线程创建新线程 | 尝试另一种实现方案 |
| 线程提醒 | 暂时收起线程,到期后重新显示并在项目对话中提醒 | 等待依赖完成或稍后继续审查 |
| 只读分享 | 按照适用条件分享单个线程的只读链接 | 向其他 Claude 用户展示线程工作 |
| 产物导航 | 展示最近打开、更新或固定的产物,以及线程内的产物缩略图 | 找回之前生成的内容 |
协调器会更主动地汇报进度
协调器现在可以直接回答项目对话中的问题,并更主动地提供运行状态。
例如,在启动多个任务后,你可以询问:
哪些线程还在运行?哪些 pull request 等待审查?哪些任务被阻塞,需要我做决定?
协调器能报告各线程向它反馈的信息,但看不到每个线程内部执行的所有步骤。
排查故障时,这个区别很重要。你仍需打开对应线程,检查实际执行的命令、工具调用和结果。
Anthropic 在 11 月 14 日的协调器更新公告中介绍了这一变化。
/btw 与 /fork 有什么区别?
这两个命令现在都可以在 Projects 中使用,但解决的问题不同。
当你正在处理某项任务,突然出现一个无关问题时,使用 /btw。
假设一个线程正在修改身份验证中间件,你又发现了独立的计费错误。这时可以用 /btw 为计费问题创建新线程,让原线程继续专注于身份验证。
如果你想为当前问题尝试另一种解决方案,则使用 /fork。
例如,一个线程正在用 JOIN 优化数据库查询。你可以从该线程创建分支线程,调查使用物化视图的方案,同时保留原线程的工作。
两者的区别是:
/btw:把新的旁支任务放进独立线程。/fork:基于当前线程的工作创建另一条探索路径。
两个命令都可能增加完整会话,从而提高套餐用量。如果没有明确的方案比较需求,不要反复创建 fork。
Anthropic 在两个命令的更新公告中解释了它们在 Projects 内的行为。不要据此认定所有版本的终端 CLI 都具有完全相同的表现。
线程提醒、只读分享和产物导航
你可以给任意线程设置提醒,也可以直接让 Claude 在稍后提醒你。
根据 Anthropic 的提醒功能公告,线程会暂时从当前视图中移开。提醒时间到达后,它会重新出现,Claude 也会在项目对话中提起这项工作。
这适合需要等待后续决策的任务,但提醒本身不能代替结果审查。
Anthropic 还宣布了单线程只读分享功能。操作方式如下:
- 打开要分享的线程。
- 打开该线程的菜单。
- 如果看到 Share,选择它。
- 将链接发给已登录 Claude 的接收者。
通过该功能,曾访问过你电脑的线程不能分享。
截至 11 月 14 日,公告与现有文档存在冲突。 官方更新公告介绍了单线程只读分享,但 Projects 限制文档当时仍写着项目线程的对话记录不能分享。
因此,应把公告视为正在引入的新行为,并实际检查线程菜单是否出现 Share。目前没有核实到这项界面更新要求某个特定的 Claude Code CLI 版本。
只读链接也不代表内容可以安全公开。分享前应检查仓库细节、运行日志和其他敏感信息。
产物导航更新公告说明,线程面板顶部会集中显示最近打开、更新或固定的产物。每个线程还会显示其产物缩略图;不需要时,可以在 view settings 中关闭这些缩略图。
Anthropic 表示,更新后的项目设置和本地文件夹访问界面已覆盖网页端和桌面端,最新版移动应用也采用了新设计。
如何创建第一个 Claude Code Project?
建议先为一个持续性目标创建项目,再用一个小任务验证环境和执行结果。确认流程正常后,再交给协调器多个任务。
1. 检查 GitHub 仓库权限
对于需要处理代码的云端线程,Anthropic 目前要求:
- 仓库托管在
github.com,而不是 GitHub Enterprise Server、GitLab 或 Bitbucket。 - 关联的 GitHub 账号对仓库具有 push 权限。
- 已安装 Claude GitHub App,并授权它访问对应仓库。
仅通过 /web-setup 配置 GitHub token,不足以满足 Projects 云端线程的访问要求。
如果看不到目标仓库,按照官方 GitHub 接入说明检查配置。先关联 GitHub 账号,再为所需仓库安装并授权 Claude GitHub App。
如果私有仓库所在组织启用了 SAML SSO,还可能需要为该组织单独授权 Claude 应用。
云端线程的配置规则也与本地 Claude Code 会话不同。
云端线程会读取各仓库的 CLAUDE.md 指令,但不会加载仓库中的 skills、.mcp.json MCP 服务器或 .claude/settings.json。
其中也包括 .claude/settings.json 定义的 hooks、权限规则和 env 环境变量配置。这些内容不会自动在云端线程中生效。
云端线程同样不会继承只安装在你电脑上的工具。需要的能力应通过项目云端环境和受支持的 Claude 账号集成进行配置。如果工作依赖本机工具,可以考虑 Remote Control。
2. 创建项目
Anthropic 的项目创建文档给出了以下操作流程:
- 打开
claude.ai/code,或桌面应用中的 Code 标签页。 - 从侧边栏或 More 中选择 Projects,然后点击 New project。
- 在 Name 中填写项目名称。
- 根据需要在 What do you want to work on? 中填写项目目标。
- 在 Context 下通过 + 添加所需的 GitHub 仓库、文件或文件夹。
- 点击 Create project。
只有 Name 是必填项。项目目标和上下文可以稍后补充。
如果按钮显示 Get started,而不是 New project,Anthropic 可能会要求你先升级或归档现有的 Claude.ai 旧版项目。
首次创建项目后,Claude 可能立即自行执行一轮操作。这会消耗套餐额度,也可能启动一个用于了解仓库的探索线程,或提出项目配置建议。
接受建议前,先检查其中列出的仓库和计划任务。
3. 配置项目指令和用量设置
通过项目侧边栏菜单或顶部菜单打开 Project settings。
进入 Project settings > Memory > Project instructions,为新线程添加工作规则。
例如:
只在选定的仓库中工作。每项实现使用独立分支。报告完成前运行相关测试。修改公开 API 行为之前先征求我的同意。在我批准实现方案前,不要创建 pull request。
新线程会收到这些指令。
需要注意:在 Project settings 中修改指令、仓库、插件或环境后,变更只会传递给新线程,不会自动更新已经运行的线程。
接下来进入 Project settings > General,查看模型和 effort 相关设置。
4. 运行一个小任务并检查结果
第一个任务应具有明确、可验证的成功条件。
可以在项目对话中输入:
调查 orders 接口为什么会对无效输入返回错误的状态码。只启动一个线程。找出失败用例,增加回归测试,并提出最小修复方案。在我批准方案前,不要创建 pull request。
这是一个示例提示词,并不是已经执行过的测试结果。
在 Overview 中查看线程状态。该面板按 Working、Waiting on you、Ready for review 等状态归类线程。
打开对应线程,重点检查:
- 它读取或修改了哪些文件?
- 是否运行了要求的测试?
- 结果说明是否与代码 diff 一致?
- 是否还缺少权限、依赖或需要你作出的决定?
云端线程通常在不同分支上工作。你提出要求时,它们可以创建 pull request;对于明确的 bug 修复等具体改动,也可能主动创建。
如果出现 Couldn’t start the session 或 Unable to access your repository,先检查 GitHub App 安装情况和仓库访问权限。
使用错误信息中提供的修复操作,例如重新安装应用或选择仓库。修复后回到项目对话,让 Claude 为同一任务启动新线程。
项目协调不能消除 Git 合并冲突。两个线程修改同一段代码,仍可能产生冲突,因此合并前必须检查变更。
确认第一个线程按预期工作后,再从项目对话中发起第二项独立任务,让 Claude 在另一个线程中执行。
如何降低 Claude Code Projects 的额度消耗?
控制用量的第一步,是检查并调整默认模型和 effort。
Anthropic 文档说明,新项目的协调器和工作线程默认都使用 Opus。工作线程的 effort 默认为 high,项目主对话的 effort 默认为 low。
对于简单 bug 修复、补充测试或文档修改,这样的默认配置可能消耗较多额度。
调整 Thread model、effort 和 Auto-continue
打开 Project settings > General。
| 设置 | 新项目默认值 | 降低用量时的起始选择 |
|---|---|---|
| Thread model | Opus | 日常任务尝试账号可选的较小模型 |
| Thread effort | High | 边界明确的任务尝试 Medium 或 low |
| Coordinator model | Opus | 路由任务和汇报状态可尝试较小模型 |
| Coordinator effort | Low | 协调效果正常就保持 low |
| Auto-continue when usage limits reset | On | 如果不希望在下一额度周期自动恢复,改为 Off |
模型选择范围会受到账号资格和当前模型供应情况影响。
复杂调试、架构决策或需要大量推理的任务,可以保留 Opus 和 high effort。对于独立测试或简单编辑,则可以先尝试较小模型和较低 effort,再根据结果质量决定是否提高。
这些设置控制不同部分:
- Thread model 和 Thread effort:控制实际执行任务的工作线程。
- Coordinator model 和 Coordinator effort:控制项目主对话中的协调器。
你可以在分配新任务时指定不同模型。对于已经运行的线程,则使用该线程自己的模型选择器。
这些都是 Projects 界面中的配置,并不是本机 settings.json 的配置项。
要求减少并行线程,但不要把要求当成硬性上限
Anthropic 建议先让协调器提出线程方案,获得确认后再启动。
例如,可以加入以下指令:
开始工作前先提出线程规划。同一时间最多运行两个线程。简单问题直接在项目对话中回答,不要额外创建线程。汇报已完成的任务和阻塞项,等待我批准后再启动下一批任务。
这样的指令有助于约束工作流程,但不能保证系统层面的并发限制。
Anthropic 明确表示,用户要求的线程数量属于偏好,而不是强制执行的上限。
真正强制执行的限制,是所有 Projects 合计每天最多创建 500 个新线程。
这并不意味着可以免费使用 500 个完整会话,也不代表系统保证支持 500 个线程同时运行。
在 Overview 中核对实际启动的线程数量。
哪些操作会消耗 token?
Anthropic 的 Projects 用量文档列出了四类需要特别关注的消耗来源。
运行中的线程: 每个线程都是完整会话。多个线程同时执行,会并行消耗同一份套餐额度。
协调器: 读取线程汇报、决定后续行动,以及在项目对话中回复,同样需要 token。
监视 pull request 的线程: 如果 CI 失败或出现新的代码审查评论,原本空闲的线程可能重新唤醒并继续消耗额度。
较长的对话: 重新进入旧线程时,Claude 可能需要再次读取大量历史上下文。
对于 Pro、Max 和 Ultra 套餐包含额度内的使用,Anthropic 文档给出的缓存有效期为 1 小时。
如果线程空闲超过 1 小时,后续消息到来时,它会先重新读取整个对话历史。
因此,对于真正的新任务,创建一个新线程有时比恢复历史很长的旧线程更省额度。
但也不要为每个后续问题都重新创建线程。如果仍然需要先前的调查背景,保留旧线程可能更合适。
Anthropic 没有给出 Projects 固定的额度消耗倍数。实际使用量取决于线程数量、模型、effort、对话长度以及重复执行的工作。
可以在 Project settings > Usage 中查看实际 token 分布,包括各线程、各模型和项目主对话的用量。
想进一步了解 Projects 之外的代理额外开销,可以参考我们的 Claude Code agent_summary token 用量分析。该文的测量对象是后台代理的进度摘要,不是 Projects 的额外消耗倍数。
项目闲置时还会消耗额度吗?
根据 Anthropic 的说明,如果项目没有运行中的线程、没有正在监视的 pull request,也没有收到新消息,那么闲置期间不会消耗套餐额度。
已经归档的项目同样不会继续消耗额度。
因此,没有必要仅仅为了避免闲置消耗,就删除已完成的项目。
但仍在监视 pull request 的线程可能被新的 CI 结果或审查评论唤醒。如果不再需要监视,请直接在对应线程中要求它停止监视该 pull request。
Projects 达到套餐用量上限后会怎样?
Projects 与订阅中的其他 Claude Code 活动共享使用限制,没有单独的一池免费 token。
截至 2026 年 11 月 14 日,不同套餐的相关限制如下:
| 套餐 | 适用限制 |
|---|---|
| Pro | 5 小时会话限制和每周限制 |
| Max | 5 小时会话限制和每周限制 |
| Ultra | 每周限制;已验证的 Ultra 账号没有 5 小时限制 |
尚未完成验证的 Ultra 账号仍可能受到临时会话限制。
Anthropic 在 Ultra 套餐说明中解释了这个例外。你也可以阅读我们的 Ultra 与 Max 用量限制对比,了解两种套餐之间的差别。
Auto-continue 可能消耗下一周期的额度
当线程或协调器达到适用的套餐限制时,工作会暂停等待。
默认情况下,限制重置后,暂停的工作会自动恢复。恢复后的消耗会计入新的使用周期。
如果不希望发生这种情况:
- 打开
Project settings > General。 - 找到 Auto-continue when usage limits reset。
- 在界面提示的额度重置时间之前将其关闭。
- 重置后,如果要继续工作,再向线程或项目主对话发送消息,手动恢复。
这是一项作用于整个项目的设置,而不是只控制当前打开的线程。
关闭 Auto-continue 也不会自动关闭其他付费使用选项,需要单独检查。
Usage credits 与套餐包含额度是两回事
Anthropic 允许 Pro、Max 和 Ultra 订阅用户启用 usage credits,通过按量计费继续使用部分服务。
启用后,符合条件的请求可以在套餐包含额度耗尽后,使用付费 credits 继续执行。项目线程不能自行替你启用这项功能。
在启动大量并行任务之前,先打开 Claude 账号中的 Settings > Usage。
如果已经启用 usage credits,建议设置符合预算的月度支出上限。如果不希望在套餐包含额度耗尽后产生额外的按量费用,应关闭 usage credits。
这些 usage credits 与 Max、Ultra 套餐附带的每月 API credits 不是同一种额度。
如果线程显示 Additional usage credits are required,可能是请求的模型或上下文大小不在当前套餐的包含范围内,而账号又没有启用所需 credits。
优先检查能否改用套餐包含的模型或上下文配置。如果确实需要额外付费,再阅读 Anthropic 的 usage credits 官方说明,决定是否启用。
Projects、本地 Claude Code 会话和 T3 Code 怎么选?
如果需要长期协调多个相关任务,优先考虑 Projects。如果你更看重本地环境控制,或者只需要运行少量独立任务,本地会话通常更直接。
| 方案 | 最适合的任务 | 由谁协调 | 主要限制 |
|---|---|---|---|
| Claude Code Projects | 跨多个会话、仓库或工作日的相关任务 | Claude 协调器 | 仅支持 Anthropic 模型提供方;处于测试期;共享套餐额度 |
| 多个本地 Claude Code CLI 会话 | 需要本地工具的少量独立任务 | 你自己 | 需要手动启动、监视和协调 |
| Claude Code agent view | 在一个界面中查看多个本地会话 | 你负责分配和调整任务 | Research preview;没有 Projects 协调器 |
| T3 Code | 管理 Claude Code、Codex 等本地编码代理 | 你或已配置的代理工作流 | 需要配置代理并保持宿主机器可用 |
需要明确控制权时,选择本地 CLI 会话
如果只有两个互不依赖的编码任务,使用独立本地会话和 Git worktree 可能已经足够。
Git worktree 会给每个会话提供独立的仓库工作目录,减少多个会话意外修改同一工作目录的风险。
本地会话可以使用已安装的工具、hooks、配置以及受支持的模型提供方设置。它们不会自动变成 Project 线程。
Claude Code 的 claude agents 界面提供了一种统一分配和监控多个本地会话的方式,目前属于 Research preview。
Anthropic 在 Run agents in parallel 中对比了这些并行工作方式。
如果每项任务都依赖本地数据库、自定义 hooks,或云端线程无法访问的基础设施,建议先测试本地会话或 agent view。
需要跨代理管理时,选择 T3 Code
T3 Code 是一个开源界面,用于管理在你自己电脑上运行的编码代理。
它的公开文档列出了 Claude Code、Codex、Cursor、OpenCode 等受支持的代理。
根据公开 README,T3 Code 可以在同一界面显示代理线程,并支持远程连接。每个线程还可以使用独立的 Git worktree 来隔离代码修改。
T3 Code 使用你已经配置的代理和相应认证方式,本身不转售 token。
如果你需要在 Claude Code 与 Codex 等代理之间转交任务,或者从另一台设备监控本地工作,它可能更合适。
但 T3 Code 不会把第三方会话变成 Claude Code Projects,也不会提供 Anthropic 托管的 Projects 协调器。
具体的登录权限、模型访问和计费,仍由底层代理及其模型提供方决定。
配置方法可参考我们的 T3 Code 与 Claude Code、Codex 及 API 网关接入指南。
Projects 能使用自定义 API Key 或模型提供方吗?
目前没有找到 Projects 使用自定义模型提供方的官方配置路径。
Anthropic 的 Projects 限制说明明确指出,无论云端线程还是通过 Remote Control 运行的线程,都以 Anthropic 作为模型提供方。
Projects 也不能直接在终端 CLI、VS Code 扩展或 JetBrains 插件中使用。
如果必须使用自定义 API endpoint,应选择支持该配置的本地编码工具或第三方编排界面,并单独核查该工具的提供方兼容性。
按量付费的 API 接入方式不能替代 Projects 协调器,也不能获得相同的账号使用资格或云端会话管理能力。
一套控制用量的起始配置
假设你有符合条件的 Pro 账号,需要修复同一个服务中的多个小问题,可以先采用以下配置:
- 为该服务创建一个 Project,只连接必要的仓库。
- 在 Project instructions 中明确分支、测试和审批规则。
- 对于日常任务,选择账号可用的较小 Thread model,并降低 Thread effort。
- 将 Coordinator effort 保持在 low,必要时尝试较小的 Coordinator model。
- 先让协调器提出线程方案,每次只批准一到两个任务。
- 如果需要保留下一周期额度,关闭 Auto-continue。
- 第一批任务完成后,检查
Project settings > Usage。
对于确实需要复杂推理的调查,继续使用 Opus 和 high effort。只有在分离工作上下文能够带来明确收益时,才使用 /btw 和 /fork,不要把每个小问题都变成新会话。
如果是跨多个仓库、持续多天的迁移工作,Projects 可以减少手动协调。对于少量本地修改,独立 CLI 会话或 agent view 可能用更简单的方式完成同样的任务。