{"author":{"id":"4e3fvwoonbfzbvqtdwehr2fzdp","name":"陈成","avatar_url":"https://lh3.googleusercontent.com/a/ACg8ocLP6uaUWVTzl3dUQgZAldOJdTbU_NCUcOxb0Jx1K5CuD97UlDiQ=s96-c","handle":"sorrycc"},"mine":false,"report":{"topic_id":"e6zgnb4uuunp","markdown":"# Claude Code Projects 调研总结\n\n\u003e 整理日期：2026-10-29\n\u003e 来源：X 书签（x.com/i/history 搜 \"Claude Projects\"）及评论、Claude Code 官方文档、X 搜索、Reddit r/ClaudeCode 和 r/ClaudeAI\n\n## 一句话\n\nProjects 是 Claude Code 在 2026 年 9 月推出的功能（目前 beta）。一个 project 就是一个长期对话，Claude 在里面当协调者（coordinator），把你丢进来的任务拆成多个 thread 并行跑。thread 默认是云端 session，你合上电脑它们也继续跑，回来后在 Overview 里看哪些做完了、哪些 PR 可以 review、哪些在等你回复。\n\n原来开多个 session 时，你自己是项目经理；用了 Projects，协调这件事交给了 Claude。\n\n## 时间线\n\n| 日期 | 事件 |\n|---|---|\n| 2026-09-18 | ClaudeDevs 宣布 Projects 在 Claude Code 桌面端和 Web 上线，小范围 beta |\n| 2026-09-24 | 支持 local thread：thread 可以通过 Remote Control 跑在你自己的电脑上 |\n| 2026-10-01 | Anthropic 的 Dan Fein 发帖说自己\"几乎只在 Projects 里工作\"，评论区挤满了要内测资格的人 |\n| 2026-10-10 | waitlist 上的 Pro / Max 用户全部放开，附 4 分钟上手视频（200 万播放） |\n| 截至目前 | 仍是 public beta，Team / Enterprise 计划还没有 |\n\n## 架构\n\n```mermaid\nflowchart TD\n    U[你：贴 bug、堆任务、随手想法\u003cbr/\u003e桌面 / Web / 手机] --\u003e C[Project 对话\u003cbr/\u003e协调者，默认 Opus + low effort]\n    C --\u003e|新任务开新 thread| T1[Cloud thread A\u003cbr/\u003e独立分支 → PR]\n    C --\u003e|同领域的任务交给已有 thread| T2[Cloud thread B]\n    C --\u003e|Work locally| T3[Local thread\u003cbr/\u003eRemote Control 连到你的电脑]\n    C -.简单问题直接回答.-\u003e U\n    M[(项目记忆 MEMORY.md\u003cbr/\u003e+ 项目指令 ≤16k 字符\u003cbr/\u003e+ 仓库 / 文件 / 云环境)] --\u003e T1 \u0026 T2\n    M -. 只带指令，不带记忆 .-\u003e T3\n    T1 \u0026 T2 \u0026 T3 --\u003e|做完后汇报| C\n    T1 \u0026 T2 \u0026 T3 --\u003e O[Overview 面板\u003cbr/\u003e待 review / 等你处理 / 运行中 / 合并中 / 空闲 / 已解决\u003cbr/\u003eLibrary · Pull requests · Scheduled tasks]\n```\n\n### 组成部分\n\n- **Project 对话**：协调者。它决定一条消息是开新 thread、转给已有 thread，还是直接回答。它只看 thread 的汇报，不看每一步过程。\n- **Thread**：干活的 worker，每个都是完整的 Claude Code session，有自己的上下文窗口。cloud thread 在独立分支上工作，需要时会开 PR，开了 PR 之后默认开启 auto-fix：CI 挂了自己修，有 review 评论自己处理。\n- **Cloud thread 启动时会带上**：项目的仓库和文件、项目指令和记忆、各仓库里的 `CLAUDE.md`、claude.ai 账号上的 connectors、云环境配置（网络、环境变量、secrets、工具）。\n- **Cloud thread 不会带上**：仓库里的 skills、`.claude/settings.json`、`.mcp.json`，也不读你本机的任何 Claude Code 配置。\n- **上下文管理**：不用自己管。thread 会自动 compact；协调者只看最近的消息、最近的 thread 和项目记忆，所以可以一直跑下去。一定不能丢的东西要写进项目记忆。\n\n### 三种跨 thread 的上下文\n\n| 类型 | 内容 | 怎么改 |\n|---|---|---|\n| 项目记忆 | Claude 自己记下的需求、决定、坑，以文件形式保存，每个 cloud thread 启动时读 `MEMORY.md` 索引 | 在对话里让 Claude 记住或忘掉某件事；或在 Project settings \u003e Memory 里直接改 |\n| 项目指令 | 发给每个新 thread 和协调者的 brief，最多 16,000 字符 | Project settings \u003e Memory \u003e Project instructions |\n| 仓库 / 文件 / 环境 | 每个 thread clone 的仓库，`/mnt/project-files` 下的文件，云环境 | Project settings \u003e Environment；Library 标签页 |\n\n## 什么时候用\n\n**适合：**\n- 一个目标涉及多个仓库，比如\"所有服务都换成新的 lint 配置\"，每个仓库一个 thread、一个 PR\n- 一个持续投喂的领域，比如某个服务的 bug、stack trace、review 请求，来一个丢一个\n- 一个 session 装不下的构建或迁移，比如\"按 docs/spec.md 实现\"、\"从废弃的 ORM 迁走\"\n- 非代码工作，比如上传一批合同或工单导出，反复提问，产出放在 Library\n\n**不适合：**\n- 一个 session 就能搞定的单个任务 → 直接开 cloud session\n- 每个任务都要用本机资源（本地数据库、模拟器、VPN 后面的 API）→ 用本地 session 或 agent view\n- 无需对话的定时任务 → 单独建 cloud scheduled task\n- 多人在 Slack 里一起指挥 → Claude Tag\n\n## 社区反馈\n\n### 好评\n\n- **\"什么都往里倒\"**：Dan Fein 和 Kevin Mac 都说，把想法一股脑倒进主对话，让协调者去分拣。Kevin 的建议是协调者用低 reasoning（它主要只是路由），thread 用正常 reasoning。\n- **合上电脑也继续**：cloud thread 一直在跑，有人在开会间隙用手机看进度，\"不用再捧着开着的笔记本在会议室之间走\"。\n- **上下文累积**：一个 thread 里学到的教训，协调者会转告其他 thread，新任务不会重复踩坑。Reddit 上有人说这种\"共享工作记忆\"是最有价值的部分。\n- **内置 secrets 管理，session 按 thread 组织**：@lakshgandikota 觉得这比传统 Claude Code session 更顺手。\n- 有人用 md 文件给协调者写上各项目的优先级（截止日期、重要程度），让它整晚在多个项目之间挑工单修。\n- 有人说 \"Projects in Cowork 已经改变了玩法\"，这次终于到 Claude Code 了，不用每个 session 都从零开始。\n\n### 痛点\n\n1. **权限审批太多**：这是最集中的抱怨。thread 本该跑在 auto mode，实际上经常要点 allow；审批只能在 thread 里面点，在主对话里说\"继续\"传不到 thread。有人直接要一个 dangerous permissions 模式。\n   - 一位 Reddit 用户的绕法：把严格的 `ask` 规则从提交进仓库的 `.claude/settings.json` 挪到 `.claude/settings.local.json`。（注意：现在的官方文档说 cloud thread 已经不读 `.claude/settings.json` 了，这个问题可能已修。）\n2. **云和本地的界限不清楚**：thread 卡片上看不出跑在云端还是本地；cloud thread 访问不到 Tailscale / 内网，只会让你自己去贴 ssh 命令，不会主动提出\"转到本地跑\"。\n3. **Local thread 难用**：要手动 `claude remote-control`，每个文件夹一个，重启就没了，得开 tmux 守着；桌面端连接本机的流程也让人困惑。local thread 只带项目指令，不带记忆。Riley Brown 早期吐槽\"协调者不能起本地 thread，对做 app 不友好\"，9 月 24 日已经补上。\n4. **thread 停住 / 协调者不推进**：有人说 thread 经常在任务阶段之间停下，主对话也不去盯；协调者不一定会持续推着项目往 /goal 走；Remote Control 连接数会被占满。\n5. **对项目的理解反而变差**：一位 7 月起就重度使用 Claude Code 的用户说，Projects 比他自己的\"多个 session 向一个 integrator session 汇报\"的工作流更笨，还得一遍遍教它项目 md 里写过的基本事实。\n6. **云环境限制**：默认网络白名单不包括 hex.pm 之类的源；只支持 github.com（不支持 GitLab、Bitbucket、GHES）；组织仓库必须由 owner 安装 Claude GitHub App。\n7. **放量慢**：评论区大量\"求邀请\"、\"DM 了五次\"、\"Team 计划什么时候有\"。\n\n### 功能许愿（出现频率较高的）\n\n- 每个 thread 上明确显示 cloud / local 标识\n- 手机推送：thread 需要人处理时通知（目前只有桌面端有通知）\n- 支持 Claude in Chrome\n- 一个 Remote Control 守护进程管多个文件夹，并能装成系统服务\n- 一个\"元协调者\"凌驾于多个 Project 之上，把任务分到对应的 Project\n- Chat / Cowork / Code 三处的 Projects 合并（官方说法是\"这对你已有的 chat 和 Cowork 项目是一次升级\"）\n- CLI 支持、WSL 支持、GitLab 支持\n- 手机上的朗读和语音模式\n\n## 用量和成本（要注意）\n\n```mermaid\nflowchart LR\n    A[默认设置] --\u003e B[每个 thread：Opus + high effort]\n    B --\u003e C[同时运行的 thread 数没有上限\u003cbr/\u003e每天最多新建 200 个]\n    C --\u003e D[碰到 5 小时限额不会停\u003cbr/\u003e等额度重置后自动继续]\n    D --\u003e E[盯 PR 的 thread\u003cbr/\u003eCI 挂了或有新评论时会被唤醒]\n    E --\u003e F((额度被吃掉的速度\u003cbr/\u003e比普通 session 快))\n```\n\n建议：\n- 先到 Project settings \u003e General 把 **Thread model / Thread effort** 调低（比如 Sonnet 或 medium）。Dan Fein 说默认是 medium，但最新文档写的是新项目默认 Opus + high，以设置页为准。\n- 一开始先让 Claude **提出 thread 方案，等你确认后再启动**，同时最多跑两个；看几个 thread 的结果靠谱了再放开。\n- 注意：在对话里说的\"最多同时跑 N 个\"只是 Claude 会遵守的偏好，不是硬性上限。要措辞精确并对所有 thread 生效，就写进项目指令。\n- 先拿真实工作中的一小块试一次，打开 thread 看它怎么汇报、在分支上做了什么，再批量派活。\n\n## 上手清单\n\n1. 确认是 Pro / Max 计划，侧边栏里能看到 Projects（或在 More 下面）\n2. 代码在 github.com 上，已安装 Claude GitHub App（`/web-setup` 的 token 不够用）\n3. 新建 project：名称必填；Goal 和 Context（仓库、文件、Google Drive 文件夹）可选\n4. 写项目指令：目标分支、thread 怎么自测、哪些操作要你点头\n5. 调 Thread model / effort\n6. 需要本机资源时：桌面端打开 \"Use this computer from your phone and claude.ai\"，或者运行 `claude remote-control --spawn worktree`（要求 v2.1.280 及以上），然后在 + 菜单里选 Work locally\n7. 也可以从已有的 cloud session 转过来：侧边栏菜单 → Continue in project\n\n## 竞品和替代方案\n\n- **自己搭**：tmux + SendMessage、多个 session 往一个 inbox 文件夹汇报、Ralph loop、IssueOps\n- **herdr 生态**：shepherdr（原 herdr-projects v2，作者自称\"开发者版的 Claude Duet\"，可以在手机、平板、桌面上作为任务控制中心）、Orchid（跨多台机器、多个订阅的 orchestrator）\n- **Orca**（@orca_build）：主打 runtime、worktrees、手机控制、账单透明，有人同时跑二三十个 worktree\n- **Cursor**：cloud agents + projects（Opus 当协调者，Sonnet 和更小的模型当 subagent）\n- 也有人问 T3 Code 什么时候出对标功能，\"出了我就换\"\n\n## 参考链接\n\n### 官方\n- 文档：Let Claude coordinate ongoing work with Projects — https://code.claude.com/docs/en/claude-projects\n- Waitlist / 介绍页：Projects are becoming a conversation with Claude — https://claude.com/form/projects\n- 9/24 Local 支持：https://x.com/ClaudeDevs/status/2102893178273874102\n- 10/10 全量放开 waitlist + 4 分钟上手视频：https://x.com/ClaudeDevs/status/2108621476538781878\n- 10/10 定义说明：https://x.com/ClaudeDevs/status/2108621478006808806\n- 10/10 beta 说明：https://x.com/ClaudeDevs/status/2108621479164412232\n- 相关 Bug：auto mode 在云端拦截已批准的操作 — https://github.com/anthropics/claude-code/issues/96775\n\n### X 书签及讨论\n- Dan Fein（Anthropic）使用心得串：https://x.com/dfeinition/status/2105447109193556206\n- Elias Stråvik：shepherdr（herdr-projects v2）：https://x.com/eliasstravik/status/2115561860879777807\n- Riley Brown：早期吐槽不能起本地 thread：https://x.com/rileybrown/status/2101453842319618291\n- Rohan Paul：全量放开的解读：https://x.com/rohanpaul_ai/status/2108768446154760403\n- laksh：比传统 session 更顺手：https://x.com/lakshgandikota/status/2108683555824115907\n- AGTP：Local 支持解读：https://x.com/AGTPinsights/status/2102947715584082249\n- Bargava：多项目优先级 + 整晚跑：https://x.com/bargava/status/2114042104527847545\n- Ravindra Kumar：Orca 对比：https://x.com/ravidsrk/status/2109536803455930739\n- Chris Laupama：问 T3 有没有对标：https://x.com/chrislaupama/status/2114418077471526961\n- テディ：日文入门教程：https://x.com/Teddy__news/status/2109140383666213037\n\n### Reddit\n- Claude Code Projects is insanely good, but the friction is real：https://www.reddit.com/r/ClaudeCode/comments/1x2exvj/\n- Does anyone feel disappointed by Claude Code Projects?：https://www.reddit.com/r/ClaudeCode/comments/1wxpt8h/\n- Open to the whole waitlist. Read this before you run one（用量提醒）：https://www.reddit.com/r/ClaudeCode/comments/1x39y8x/\n- Beta is great at coordinating parallel threads：https://www.reddit.com/r/ClaudeCode/comments/1x9dveu/\n- Confusing Claude Code Projects Update?：https://www.reddit.com/r/ClaudeAI/comments/1x0rkwc/\n- 社区分享（talk 要点）：https://www.reddit.com/r/ClaudeCode/comments/1xi5hnf/\n- 葡语社区新闻：https://www.reddit.com/r/brdev/comments/1x3keob/\n","html":"","default_view":"markdown","version":2,"updated_by":"4e3fvwoonbfzbvqtdwehr2fzdp","updated_at":"2026-10-29T09:00:33Z","assets":[],"base_url":"/pub/e6zgnb4uuunp/p/"},"sources":[],"topic":{"id":"e6zgnb4uuunp","title":"Claude Code Projects","question":"Claude Code Projects 是什么，怎么用，社区怎么看？","visibility":"public","slug":"claude-code-projects","hue":350,"emoji":"🧭","owner_id":"4e3fvwoonbfzbvqtdwehr2fzdp","created_at":"2026-10-29T09:00:19Z","updated_at":"2026-10-29T09:00:42Z","published_at":"2026-10-29T09:00:42Z","item_count":0,"report_words":1342,"formats":["markdown"],"url":"https://research.sorrycc.dev/@sorrycc/claude-code-projects"}}
