---
title: "Claude Code Projects"
author: "陈成"
author_url: "https://research.sorrycc.dev/@sorrycc"
question: "Claude Code Projects 是什么，怎么用，社区怎么看？"
url: "https://research.sorrycc.dev/@sorrycc/claude-code-projects"
emoji: "🧭"
published: 2026-10-29T09:00:42Z
updated: 2026-10-29T09:00:33Z
version: 2
cite: "https://research.sorrycc.dev/@sorrycc/claude-code-projects.bib"
---

# Claude Code Projects 调研总结

By [陈成](https://research.sorrycc.dev/@sorrycc) · Published October 29, 2026

> Claude Code Projects 是什么，怎么用，社区怎么看？

> 整理日期：2026-10-29
> 来源：X 书签（x.com/i/history 搜 "Claude Projects"）及评论、Claude Code 官方文档、X 搜索、Reddit r/ClaudeCode 和 r/ClaudeAI

## 一句话

Projects 是 Claude Code 在 2026 年 9 月推出的功能（目前 beta）。一个 project 就是一个长期对话，Claude 在里面当协调者（coordinator），把你丢进来的任务拆成多个 thread 并行跑。thread 默认是云端 session，你合上电脑它们也继续跑，回来后在 Overview 里看哪些做完了、哪些 PR 可以 review、哪些在等你回复。

原来开多个 session 时，你自己是项目经理；用了 Projects，协调这件事交给了 Claude。

## 时间线

| 日期 | 事件 |
|---|---|
| 2026-09-18 | ClaudeDevs 宣布 Projects 在 Claude Code 桌面端和 Web 上线，小范围 beta |
| 2026-09-24 | 支持 local thread：thread 可以通过 Remote Control 跑在你自己的电脑上 |
| 2026-10-01 | Anthropic 的 Dan Fein 发帖说自己"几乎只在 Projects 里工作"，评论区挤满了要内测资格的人 |
| 2026-10-10 | waitlist 上的 Pro / Max 用户全部放开，附 4 分钟上手视频（200 万播放） |
| 截至目前 | 仍是 public beta，Team / Enterprise 计划还没有 |

## 架构

```mermaid
flowchart TD
    U[你：贴 bug、堆任务、随手想法<br/>桌面 / Web / 手机] --> C[Project 对话<br/>协调者，默认 Opus + low effort]
    C -->|新任务开新 thread| T1[Cloud thread A<br/>独立分支 → PR]
    C -->|同领域的任务交给已有 thread| T2[Cloud thread B]
    C -->|Work locally| T3[Local thread<br/>Remote Control 连到你的电脑]
    C -.简单问题直接回答.-> U
    M[(项目记忆 MEMORY.md<br/>+ 项目指令 ≤16k 字符<br/>+ 仓库 / 文件 / 云环境)] --> T1 & T2
    M -. 只带指令，不带记忆 .-> T3
    T1 & T2 & T3 -->|做完后汇报| C
    T1 & T2 & T3 --> O[Overview 面板<br/>待 review / 等你处理 / 运行中 / 合并中 / 空闲 / 已解决<br/>Library · Pull requests · Scheduled tasks]
```

### 组成部分

- **Project 对话**：协调者。它决定一条消息是开新 thread、转给已有 thread，还是直接回答。它只看 thread 的汇报，不看每一步过程。
- **Thread**：干活的 worker，每个都是完整的 Claude Code session，有自己的上下文窗口。cloud thread 在独立分支上工作，需要时会开 PR，开了 PR 之后默认开启 auto-fix：CI 挂了自己修，有 review 评论自己处理。
- **Cloud thread 启动时会带上**：项目的仓库和文件、项目指令和记忆、各仓库里的 `CLAUDE.md`、claude.ai 账号上的 connectors、云环境配置（网络、环境变量、secrets、工具）。
- **Cloud thread 不会带上**：仓库里的 skills、`.claude/settings.json`、`.mcp.json`，也不读你本机的任何 Claude Code 配置。
- **上下文管理**：不用自己管。thread 会自动 compact；协调者只看最近的消息、最近的 thread 和项目记忆，所以可以一直跑下去。一定不能丢的东西要写进项目记忆。

### 三种跨 thread 的上下文

| 类型 | 内容 | 怎么改 |
|---|---|---|
| 项目记忆 | Claude 自己记下的需求、决定、坑，以文件形式保存，每个 cloud thread 启动时读 `MEMORY.md` 索引 | 在对话里让 Claude 记住或忘掉某件事；或在 Project settings > Memory 里直接改 |
| 项目指令 | 发给每个新 thread 和协调者的 brief，最多 16,000 字符 | Project settings > Memory > Project instructions |
| 仓库 / 文件 / 环境 | 每个 thread clone 的仓库，`/mnt/project-files` 下的文件，云环境 | Project settings > Environment；Library 标签页 |

## 什么时候用

**适合：**
- 一个目标涉及多个仓库，比如"所有服务都换成新的 lint 配置"，每个仓库一个 thread、一个 PR
- 一个持续投喂的领域，比如某个服务的 bug、stack trace、review 请求，来一个丢一个
- 一个 session 装不下的构建或迁移，比如"按 docs/spec.md 实现"、"从废弃的 ORM 迁走"
- 非代码工作，比如上传一批合同或工单导出，反复提问，产出放在 Library

**不适合：**
- 一个 session 就能搞定的单个任务 → 直接开 cloud session
- 每个任务都要用本机资源（本地数据库、模拟器、VPN 后面的 API）→ 用本地 session 或 agent view
- 无需对话的定时任务 → 单独建 cloud scheduled task
- 多人在 Slack 里一起指挥 → Claude Tag

## 社区反馈

### 好评

- **"什么都往里倒"**：Dan Fein 和 Kevin Mac 都说，把想法一股脑倒进主对话，让协调者去分拣。Kevin 的建议是协调者用低 reasoning（它主要只是路由），thread 用正常 reasoning。
- **合上电脑也继续**：cloud thread 一直在跑，有人在开会间隙用手机看进度，"不用再捧着开着的笔记本在会议室之间走"。
- **上下文累积**：一个 thread 里学到的教训，协调者会转告其他 thread，新任务不会重复踩坑。Reddit 上有人说这种"共享工作记忆"是最有价值的部分。
- **内置 secrets 管理，session 按 thread 组织**：@lakshgandikota 觉得这比传统 Claude Code session 更顺手。
- 有人用 md 文件给协调者写上各项目的优先级（截止日期、重要程度），让它整晚在多个项目之间挑工单修。
- 有人说 "Projects in Cowork 已经改变了玩法"，这次终于到 Claude Code 了，不用每个 session 都从零开始。

### 痛点

1. **权限审批太多**：这是最集中的抱怨。thread 本该跑在 auto mode，实际上经常要点 allow；审批只能在 thread 里面点，在主对话里说"继续"传不到 thread。有人直接要一个 dangerous permissions 模式。
   - 一位 Reddit 用户的绕法：把严格的 `ask` 规则从提交进仓库的 `.claude/settings.json` 挪到 `.claude/settings.local.json`。（注意：现在的官方文档说 cloud thread 已经不读 `.claude/settings.json` 了，这个问题可能已修。）
2. **云和本地的界限不清楚**：thread 卡片上看不出跑在云端还是本地；cloud thread 访问不到 Tailscale / 内网，只会让你自己去贴 ssh 命令，不会主动提出"转到本地跑"。
3. **Local thread 难用**：要手动 `claude remote-control`，每个文件夹一个，重启就没了，得开 tmux 守着；桌面端连接本机的流程也让人困惑。local thread 只带项目指令，不带记忆。Riley Brown 早期吐槽"协调者不能起本地 thread，对做 app 不友好"，9 月 24 日已经补上。
4. **thread 停住 / 协调者不推进**：有人说 thread 经常在任务阶段之间停下，主对话也不去盯；协调者不一定会持续推着项目往 /goal 走；Remote Control 连接数会被占满。
5. **对项目的理解反而变差**：一位 7 月起就重度使用 Claude Code 的用户说，Projects 比他自己的"多个 session 向一个 integrator session 汇报"的工作流更笨，还得一遍遍教它项目 md 里写过的基本事实。
6. **云环境限制**：默认网络白名单不包括 hex.pm 之类的源；只支持 github.com（不支持 GitLab、Bitbucket、GHES）；组织仓库必须由 owner 安装 Claude GitHub App。
7. **放量慢**：评论区大量"求邀请"、"DM 了五次"、"Team 计划什么时候有"。

### 功能许愿（出现频率较高的）

- 每个 thread 上明确显示 cloud / local 标识
- 手机推送：thread 需要人处理时通知（目前只有桌面端有通知）
- 支持 Claude in Chrome
- 一个 Remote Control 守护进程管多个文件夹，并能装成系统服务
- 一个"元协调者"凌驾于多个 Project 之上，把任务分到对应的 Project
- Chat / Cowork / Code 三处的 Projects 合并（官方说法是"这对你已有的 chat 和 Cowork 项目是一次升级"）
- CLI 支持、WSL 支持、GitLab 支持
- 手机上的朗读和语音模式

## 用量和成本（要注意）

```mermaid
flowchart LR
    A[默认设置] --> B[每个 thread：Opus + high effort]
    B --> C[同时运行的 thread 数没有上限<br/>每天最多新建 200 个]
    C --> D[碰到 5 小时限额不会停<br/>等额度重置后自动继续]
    D --> E[盯 PR 的 thread<br/>CI 挂了或有新评论时会被唤醒]
    E --> F((额度被吃掉的速度<br/>比普通 session 快))
```

建议：
- 先到 Project settings > General 把 **Thread model / Thread effort** 调低（比如 Sonnet 或 medium）。Dan Fein 说默认是 medium，但最新文档写的是新项目默认 Opus + high，以设置页为准。
- 一开始先让 Claude **提出 thread 方案，等你确认后再启动**，同时最多跑两个；看几个 thread 的结果靠谱了再放开。
- 注意：在对话里说的"最多同时跑 N 个"只是 Claude 会遵守的偏好，不是硬性上限。要措辞精确并对所有 thread 生效，就写进项目指令。
- 先拿真实工作中的一小块试一次，打开 thread 看它怎么汇报、在分支上做了什么，再批量派活。

## 上手清单

1. 确认是 Pro / Max 计划，侧边栏里能看到 Projects（或在 More 下面）
2. 代码在 github.com 上，已安装 Claude GitHub App（`/web-setup` 的 token 不够用）
3. 新建 project：名称必填；Goal 和 Context（仓库、文件、Google Drive 文件夹）可选
4. 写项目指令：目标分支、thread 怎么自测、哪些操作要你点头
5. 调 Thread model / effort
6. 需要本机资源时：桌面端打开 "Use this computer from your phone and claude.ai"，或者运行 `claude remote-control --spawn worktree`（要求 v2.1.280 及以上），然后在 + 菜单里选 Work locally
7. 也可以从已有的 cloud session 转过来：侧边栏菜单 → Continue in project

## 竞品和替代方案

- **自己搭**：tmux + SendMessage、多个 session 往一个 inbox 文件夹汇报、Ralph loop、IssueOps
- **herdr 生态**：shepherdr（原 herdr-projects v2，作者自称"开发者版的 Claude Duet"，可以在手机、平板、桌面上作为任务控制中心）、Orchid（跨多台机器、多个订阅的 orchestrator）
- **Orca**（@orca_build）：主打 runtime、worktrees、手机控制、账单透明，有人同时跑二三十个 worktree
- **Cursor**：cloud agents + projects（Opus 当协调者，Sonnet 和更小的模型当 subagent）
- 也有人问 T3 Code 什么时候出对标功能，"出了我就换"

## 参考链接

### 官方
- 文档：Let Claude coordinate ongoing work with Projects — https://code.claude.com/docs/en/claude-projects
- Waitlist / 介绍页：Projects are becoming a conversation with Claude — https://claude.com/form/projects
- 9/24 Local 支持：https://x.com/ClaudeDevs/status/2102893178273874102
- 10/10 全量放开 waitlist + 4 分钟上手视频：https://x.com/ClaudeDevs/status/2108621476538781878
- 10/10 定义说明：https://x.com/ClaudeDevs/status/2108621478006808806
- 10/10 beta 说明：https://x.com/ClaudeDevs/status/2108621479164412232
- 相关 Bug：auto mode 在云端拦截已批准的操作 — https://github.com/anthropics/claude-code/issues/96775

### X 书签及讨论
- Dan Fein（Anthropic）使用心得串：https://x.com/dfeinition/status/2105447109193556206
- Elias Stråvik：shepherdr（herdr-projects v2）：https://x.com/eliasstravik/status/2115561860879777807
- Riley Brown：早期吐槽不能起本地 thread：https://x.com/rileybrown/status/2101453842319618291
- Rohan Paul：全量放开的解读：https://x.com/rohanpaul_ai/status/2108768446154760403
- laksh：比传统 session 更顺手：https://x.com/lakshgandikota/status/2108683555824115907
- AGTP：Local 支持解读：https://x.com/AGTPinsights/status/2102947715584082249
- Bargava：多项目优先级 + 整晚跑：https://x.com/bargava/status/2114042104527847545
- Ravindra Kumar：Orca 对比：https://x.com/ravidsrk/status/2109536803455930739
- Chris Laupama：问 T3 有没有对标：https://x.com/chrislaupama/status/2114418077471526961
- テディ：日文入门教程：https://x.com/Teddy__news/status/2109140383666213037

### Reddit
- Claude Code Projects is insanely good, but the friction is real：https://www.reddit.com/r/ClaudeCode/comments/1x2exvj/
- Does anyone feel disappointed by Claude Code Projects?：https://www.reddit.com/r/ClaudeCode/comments/1wxpt8h/
- Open to the whole waitlist. Read this before you run one（用量提醒）：https://www.reddit.com/r/ClaudeCode/comments/1x39y8x/
- Beta is great at coordinating parallel threads：https://www.reddit.com/r/ClaudeCode/comments/1x9dveu/
- Confusing Claude Code Projects Update?：https://www.reddit.com/r/ClaudeAI/comments/1x0rkwc/
- 社区分享（talk 要点）：https://www.reddit.com/r/ClaudeCode/comments/1xi5hnf/
- 葡语社区新闻：https://www.reddit.com/r/brdev/comments/1x3keob/
