--- title: 'Claude Code 项目启动清单:PSB 系统' video_id: aQvpqlSiUIQ url: https://youtu.be/aQvpqlSiUIQ title_en: "How I Start EVERY Claude Code Project" channel: AI with Avthar published: 2025-12-17 duration: "34:16" topics: [Claude Code 工作流, Claude Code 定制扩展, 多 Agent 协作] noted: 2026-07-05 value: S views: '9.5万' --- [![封面](https://i.ytimg.com/vi/aQvpqlSiUIQ/maxresdefault.jpg)](https://youtu.be/aQvpqlSiUIQ) > AI with Avthar · 34:16 · 发布 2025-12-17 · 9.5万次观看(截至抓取) · [观看原视频](https://youtu.be/aQvpqlSiUIQ) ## 主旨 作者把自己启动每个 Claude Code 项目的固定流程沉淀成一套 PSB 系统——Plan(规划)、Setup(配置)、Build(构建)三段,配一份可逐项跟做的开工清单,让项目从第一天起就好建 10 倍。 ## 核心论点 1. **开工前先按 PSB 三段走**——Plan / Setup / Build,把"打开终端就 freestyle 提示"换成有蓝图的流程,省下数月返工。([[#1-psb-系统规划配置构建-0038|→ 详解1]]) 2. **Plan 阶段只问自己两个问题**——项目目标是什么、要哪些功能里程碑;目标决定该精建什么、能跳过什么。([[#2-plan-只问两个问题-0306|→ 详解2]]) 3. **规划的产出物是一份 project spec doc**——轻量版 [[PRD]] + 工程设计,讲清"给谁、解决什么问题、做什么" + 技术栈与架构。([[#3-project-spec-doc轻量-prd--工程设计-0616|→ 详解3]]) 4. **Setup 是七步清单**——GitHub repo、env 文件、CLAUDE.md、自动化文档、plugins、MCPs、slash command 与 subagent,把 Claude Code 调成趁手的乐器。([[#4-setup-七步清单-1136|→ 详解4]]) 5. **CLAUDE.md 是项目记忆但容量有限**——每次会话必带,靠 link-off 到外部文档保持精简,不要堆。([[#5-claudemd项目记忆宜精不宜堆-1354|→ 详解5]]) 6. **Build 有三种工作流**——通用(research→plan→implement→test)、issue 驱动、多 agent;最常见错误是 Plan Mode 用得不够。([[#6-build-三工作流别少用-plan-mode-2513|→ 详解6]]) 7. **多 agent 并行靠 Git Worktree 隔离**——每个会话独立分支互不冲突,最后再合并。([[#7-多-agent-与-git-worktree-2947|→ 详解7]]) 8. **四条生产力贴士**——尽量用最好的模型、定期调 CLAUDE.md、用 `#` 做回归预防、不怕丢弃代码。([[#8-四条生产力贴士-3048|→ 详解8]]) ## 知识点详解 ### 1. PSB 系统:规划、配置、构建 [00:38](https://youtu.be/aQvpqlSiUIQ?t=38) 作者的反面教材是自己:打开终端敲 `claude` 就 freestyle 提示,没规划、没配置、没系统,像不带图纸盖房——最终能建成,但一路乱、慢、埋雷。做了几十个项目后他总结出 PSB 系统。 PSB = Plan、Setup、Build。Plan 是写第一行代码前把项目设置成"可成功"的样子;Setup 是把 Claude Code 配齐它需要的一切;Build 才是真正写代码,先做 MVP 再逐个里程碑。 关键立场:哪怕你不用整套系统,只挑其中几条 tip 也能提速。这让这套框架从"要么全信要么不用"降级成可拆用的清单。 ### 2. Plan 只问两个问题 [03:06](https://youtu.be/aQvpqlSiUIQ?t=186) 打开 Claude Code 前,作者先用纸笔或 Google Doc 做 brainstorm,回答两个问题。他强调前期花 15 分钟规划,能省下后面数小时甚至数天的返工。 问题一:你到底想做什么(项目目标)?是学新技术、验证想法、做产品 alpha,还是只想验证可行性?目标直接决定取舍——只做原型就聚焦核心功能、可以 move fast and break things;要上线给真实用户就得管安全、错误处理、边界情况。 问题二:你要哪些功能里程碑?把项目拆成清晰阶段——v1 长什么样、哪些留给 v2/v3。作者习惯用 MVP + 一两版改进的思路:MVP 是验证想法的最小集,后续版本再加打磨和优化。 pro tip:让 AI 反过来问你。把 brainstorm 丢给 Claude,问"要做成这个 MVP,我最该先回答哪三个问题",用 Ask User Question 工具 式的反问帮你暴露没想清的决策。这一招可复用到规划或构建的任何环节。 ### 3. project spec doc:轻量 PRD + 工程设计 [06:16](https://youtu.be/aQvpqlSiUIQ?t=376) 规划阶段的主交付物是 project spec doc,含两部分:product requirements(产品需求)和 engineering design(工程设计)——本质是公司里 [[PRD]] + EDD 的轻量版,专为 Claude Code 裁剪。详尽程度取决于前面定的目标和里程碑,所以要先把那两问答清。 产品需求回答三问:产品给谁、解决什么问题、应该做什么。作者的经验是**必须对用户交互足够具体**——别只写"用户能建日记条目",要写清是空白页还是带提示、能否加照片、能否改旧条目;你说得越细,Claude 建得越准,否则它会自己乱猜。同时把项目拆成里程碑、给每个里程碑定义"完成"长什么样。 工程设计回答"怎么建"。第一件也是最重要的是选技术栈——语言、前后端框架、数据库、托管等;不指定,Claude 会塞它自己选的技术。作者给了偏好栈(Vercel/Next.js/Tailwind/shadcn 前端,MongoDB 或 Supabase 后端,Clerk 认证,Stripe 支付)作参考,但强调那只是建议,重点是"你要明确告诉 Claude 用什么"。拿不准就让 Claude 联网出一份带选项和推荐的调研报告。 第二部分是技术架构:系统设计、组件如何交互、数据库 schema、API 设计。个人项目多可委托 Claude;团队/公司环境则要更规约地写明实现细节和团队最佳实践。这一步常连带"实际把基础设施开好"——建库、配托管、创建 API key,让 Claude 开工时能全速跑。 ### 4. Setup 七步清单 [11:36](https://youtu.be/aQvpqlSiUIQ?t=696) 配置阶段是把 Claude Code 调成"完美调音的乐器"。作者提醒七步不必全用,挑与你项目相关的即可。 步骤一,建 GitHub repo [12:08](https://youtu.be/aQvpqlSiUIQ?t=728):不只本地 Git。理由有四——能用 web/mobile 版随处编码;能用 GitHub CLI 和 Claude Code GitHub Action(自动 PR 评审、@claude 处理 issue);很多托管商(如 Vercel)连 repo 即部署、每分支还有 deploy preview,让开分支成为无脑选择;以及解锁 issue 驱动开发。步骤二,建 env 文件:让 Claude 按 spec 生成 `.env.example`,你复制后填入凭证,Claude 才能不停下来问你就构建。 步骤三,写 CLAUDE.md(详见下节)。步骤四,建 Automated Documentation:一组独立于 CLAUDE.md、供 Claude 按需读取的文档 [15:59](https://youtu.be/aQvpqlSiUIQ?t=959)。作者每个项目固定建四份——`architecture.md`(系统设计与组件交互)、`changelog.md`(变更史,给 Claude 项目演进全景)、项目状态文档(里程碑 / 已完成 / 上次停在哪,适合断续开发的人接续)、以及关键功能的 reference docs(可选,给某功能的高层概览)。让 Claude 在每次干完活时自动更新这些文档。 步骤五,plugins:插件由 slash command / subagent / MCP / hook / skill 任意组合而成,能直接搬别人的最佳定制。作者推荐 Anthropic front-end 插件(更好 UI、避开那种紫色渐变)、Anthropic feature-dev 插件、every 的 compound engineering 插件。步骤六,MCPs [19:35](https://youtu.be/aQvpqlSiUIQ?t=1175):把 Claude 接到外部工具——数据库 MCP(MongoDB/Supabase,自动改 schema)、Web 应用用 Playwright/Puppeteer MCP(让 Claude 看到页面、自动测用户流)、Vercel/Mixpanel/Linear 等。按技术栈挑关键部分试。 步骤七,slash command 与 subagent [20:55](https://youtu.be/aQvpqlSiUIQ?t=1255):两者都是自动化,但**分清区别很重要**——slash command 是提示快捷方式,**共用主对话的上下文窗口**;subagent 是专职 agent,**用 fork 出的独立上下文**,彼此互不知情,故适合并行和需要专注上下文的专项任务。作者常用内置的 planning 和 codebase-search subagent,并推荐三个自建:changelog agent、前端测试 agent、retro agent(会后反思并回写 CLAUDE.md/提示/命令,成为持续改进系统的地基)。两条 bonus:预配置 permissions(预批/预禁命令,避免你去倒杯咖啡回来发现 Claude 一直卡在等授权)、以及 hooks(在生命周期节点自动跑脚本,如 stop hook 检查测试没过就让 Claude 继续修、notification hook 在需授权时 Slack 提醒你)。 ### 5. CLAUDE.md:项目记忆,宜精不宜堆 [13:54](https://youtu.be/aQvpqlSiUIQ?t=834) CLAUDE.md 是项目的记忆——每次会话都自动进上下文。关键认知是**它是有限的,别把它撑爆**,只放最重要的信息。 建议放:项目目标与架构总览、设计风格与 UX 指南、约束与政策(如"永远别直接 push main""密钥一律走环境变量")、仓库礼仪(何时用 PR、分支命名)、常用命令(构建/测试)、测试说明。 保持精简的最有效手段是 link-off [15:22](https://youtu.be/aQvpqlSiUIQ?t=922):在 CLAUDE.md 里告诉 Claude "重要上下文在某某文件、需要时去读",比如链到 project spec 和 `architecture.md`,而不是把内容抄进来堵塞上下文窗口。别追求第一天就完美,它是随项目迭代长出来的。 ### 6. Build 三工作流,别少用 Plan Mode [25:13](https://youtu.be/aQvpqlSiUIQ?t=1513) 构建从让 Claude 按 spec 建里程碑一的 MVP 开始 [25:43](https://youtu.be/aQvpqlSiUIQ?t=1543):pro tip 是让它尽量用并行 subagent、并**先进 Plan Mode**,把你的 spec 翻成它自己的实现计划。 工作流一,通用(单个功能端到端):research → plan → implement → test。research 可选,大功能或首次用某 API 时有用。**plan 步骤最关键**——作者说人们用 Claude Code 最常见的错误就是 Plan Mode 用得不够 [27:14](https://youtu.be/aQvpqlSiUIQ?t=1634);在 plan mode 里 Claude 会拆步骤、反问澄清再动手,结果好得多。 工作流二,issue 驱动 [27:56](https://youtu.be/aQvpqlSiUIQ?t=1676):让 GitHub issue 成为 bug/功能的单一事实源,胜过 repo 里散落一堆 todo/feature.md。可让 Claude 把 spec 和里程碑转成一批 issue,也便于并行——同一 session 用 subagent 修一堆 bug,或多个 Claude Code 实例同时上大功能。 工作流三,多 agent(下节)。 ### 7. 多 agent 与 Git Worktree [29:47](https://youtu.be/aQvpqlSiUIQ?t=1787) 多 agent 开发(又叫 multi-clouding)= 同时跑多个 Claude Code 实例,各自做一个功能。怎么不打架?靠 Git Worktree——让一个 repo 在不同目录有多份工作副本、各在不同分支,每个会话在自己的 worktree 里改隔离的文件,却共享同一 git 历史。 各实例干完后,让 Claude 把 worktree 合并进 main 或某功能分支再测再评审。作者用它同时推进过三个功能,称威力巨大,但需要一定的搭建与管理知识。 ### 8. 四条生产力贴士 [30:48](https://youtu.be/aQvpqlSiUIQ?t=1848) 贴士一,尽量用最好的模型:重要任务用刚发布的 Opus 4.5、至少用 Sonnet。作者默认 Opus 做规划和复杂任务、Sonnet 当实现主力、Haiku 只做简单直接的活和 bug fix。逻辑是好模型少犯错省下的时间,比便宜模型多犯错让你去修更值。 贴士二,定期调 CLAUDE.md [31:37](https://youtu.be/aQvpqlSiUIQ?t=1897):加功能、过里程碑时更新它;可做个自定义命令"先更新 CLAUDE.md 再 git commit",让文档和代码同步。 贴士三,回归预防 [32:07](https://youtu.be/aQvpqlSiUIQ?t=1927):看到 Claude 犯错别只改了就走,敲 `#` 给一条指令,它会自动并入相关 CLAUDE.md,免手动编辑。贴士四,不怕丢弃代码 [32:31](https://youtu.be/aQvpqlSiUIQ?t=1951):"代码很便宜",原型阶段不 work 就撤销或整个功能重来,Claude 的 checkpoint/rewind 给你会话级恢复、Git 给你项目级版本控制。 ## 可执行步骤 - [ ] 开工前用纸笔/文档答两问:①项目目标(学习/验证/alpha/原型) ②功能里程碑(MVP + v2/v3)。 - [ ] 把 brainstorm 丢给 Claude,让它反问你"建 MVP 最该先答的三个问题",据此补齐决策。 - [ ] 写一份 project spec doc:产品需求(给谁/解决什么/做什么,交互写具体)+ 工程设计(明确技术栈 + 架构)。 - [ ] Setup 七步按需勾:建 GitHub repo → 建 `.env`(先让 Claude 出 `.env.example`)→ 写精简的 CLAUDE.md → 建四类自动化文档(architecture/changelog/项目状态/关键功能 reference)→ 装 plugins → 接关键 MCP → 配 slash command 与 subagent。 - [ ] CLAUDE.md 只放核心信息,用 link-off 指向 spec 和 architecture.md,别把全文抄进去。 - [ ] Build 每个功能走 research→plan→implement→test,动手前先进 Plan Mode 让它反问澄清。 - [ ] 拆成 GitHub issue 做单一事实源;需要并行多个大功能时用多实例 + Git Worktree,完成后合并再测。 - [ ] 用最好的模型;定期更新 CLAUDE.md;犯错用 `#` 沉淀规则;原型不 work 就丢掉重来。 ## 关联 - 深化 [[PRD]]:本片的 project spec doc 就是 PRD 的轻量落地——product requirements(给谁/解决什么/做什么)+ engineering design(技术栈/架构),与 PRD 概念页"决定长任务能跑多远的前置因素"一脉;本片独有的是给了这份文档的**具体骨架与组织方式**。 - 印证 Plan Mode:本片点名"最常见错误 = Plan Mode 用得不够",与 [[2026-03-08-Claude Code 六个层级]] 的单向交互警示互证。 - 印证 CLAUDE.md:本片"项目记忆、容量有限、靠 link-off 保持精简"与六个层级里"滥用收益微弱还推高推理成本"呼应——都主张 CLAUDE.md 宜精不宜堆。 - 印证 Git Worktree:多 agent 并行隔离、最后合并的用途,与 [[2026-03-08-Claude Code 六个层级]] 完全一致。 - 同源 Ask User Question 工具:本片"让 AI 反问你三个问题"的规划 pro tip 与之同源,都是把粗糙输入逼成详尽 spec。 ## 术语 - PSB system(规划-配置-构建三段式项目启动系统) - project spec doc(项目规格文档,轻量版 PRD + 工程设计) - automated documentation(与 CLAUDE.md 分离、供 Claude 按需读取并自动维护的项目文档) - multi-clouding(同时跑多个 Claude Code 实例并行开发) - deploy preview(每个分支自动部署出的可预览环境) ## 金句 > Remember, code is cheap. → 原型阶段别舍不得删——撤销或重写一个功能,常比死磕一个不 work 的方案更快到你满意的结果。 ## 立场与利益 Avthar 以教 AI 编程工具为定位,片尾推广自家 Maven 课程「AI Native Builder」(YouTube 观众用码 `YouTube` 减 $100,另有奖学金名额),PSB 系统即其教学框架(unique mechanism)。需分辨:PSB 三段、Plan Mode、PRD、worktree、模型分级等都是跨工具通用共识,不依赖购课;而他给的偏好技术栈(Vercel/Next/Tailwind/shadcn/MongoDB/Supabase/Clerk/Stripe/Anthropic 模型)是个人偏好而非要求,他本人也反复强调"只是建议"。三个 Anthropic/every 插件属具体产品推荐,可选。 ## 价值定位 - 适合谁:已在用或准备用 Claude Code、想把"项目怎么开工"标准化、少走弯路的人;新手也能只挑七步清单里的单点用。 - 解决什么:想不再"开终端就乱写",这里给了一份端到端、可逐项跟做的开工 checklist(两问 → spec → 七步 setup → 三工作流)。 - 认知 vs 实操:以拿来即用的操作为主(七步清单、四类文档、`#` 回归预防),辅以少量格局(PSB 三段、slash command 与 subagent 的上下文区别)。 - 与 [[2026-01-19-Claude Code 完全解读]]/[[2026-03-08-Claude Code 六个层级]] 重叠于 Plan Mode / PRD / worktree / CLAUDE.md 等单点;但本片独有的是把这些**装配成一条项目启动的固定流程**,并补上其他笔记少讲的 setup 细节——env 文件、四类自动化文档、plugins/MCP 选型、permissions 与 hooks 预配置。 ## 自检问题 1. PSB 分别指什么?每段的一句话目标是什么? **答案**:Plan(规划)= 写代码前把项目设置成可成功、产出 project spec doc;Setup(配置)= 把 Claude Code 配齐所需(七步清单);Build(构建)= 先 MVP 再逐里程碑、用三种工作流。见 [00:38](https://youtu.be/aQvpqlSiUIQ?t=38)。 2. project spec doc 的两部分各回答什么问题?它和公司 PRD 是什么关系? **答案**:产品需求答"给谁 / 解决什么问题 / 做什么",工程设计答"用什么技术栈、什么架构";它是公司 PRD + 工程设计文档的轻量版,专为 Claude Code 裁剪。见 [06:16](https://youtu.be/aQvpqlSiUIQ?t=376)。 3. slash command 与 subagent 最本质的区别是什么?这决定了 subagent 适合做什么? **答案**:slash command 共用主对话的上下文窗口,subagent 用 fork 出的独立上下文、彼此互不知情;因此 subagent 适合并行和需要专注上下文的专项任务。见 [21:09](https://youtu.be/aQvpqlSiUIQ?t=1269)。 4. 作者说人们用 Claude Code 最常见的错误是什么?为什么关键? **答案**:Plan Mode 用得不够;在 plan mode 里 Claude 会先拆步骤、反问澄清再动手,结果显著更好。见 [27:14](https://youtu.be/aQvpqlSiUIQ?t=1634)。 5. 多个 Claude Code 实例并行时靠什么避免冲突?怎么收尾? **答案**:靠 Git Worktree——一个 repo 多份工作副本各在不同分支/目录,文件隔离但共享 git 历史;完成后让 Claude 把 worktree 合并进 main 或功能分支再测再评审。见 [29:47](https://youtu.be/aQvpqlSiUIQ?t=1787)。 > [!quote] 💬 热门评论 top-10 主 + 10 回(抓取 2026-07-07) > > [7] **@Eric-yn6ur**:计划，开始新会话，构建，开始新会话，执行。永远不要让会话持续时间超过必要。Claude在前5到10个提示和任务中非常敏锐。 👍 4 >   ↪ **@avtharai(UP)**:没错。上下文管理很重要！ > [8] **@asifsvirtualfootprint7370**:请在下一个视频中分享Claude Code git工作树中的多智能体策略。 👍 24 >   ↪ **@avtharai(UP)**:收到，谢谢评论！ > [9] **@jamieosh70**:对于有经验的专业工程师或产品经理来说，很容易挑刺并批评你的一些说法和方法——但这是一个非常好的视频，你提出了一种方法，而且这是一个相当扎实、容易理解的方法，对任何没有经验的人来说都是一个很好的起点，对于有经验的人来说也很容易演变成他们自己的方法。你很好地解释了概念以及如何使用Claude Code，这又是通往其他方法和改进的绝佳跳板。做得好👍 👍 2 >   ↪ **@avtharai(UP)**:感谢你这条深思熟虑的评论，Jamie。我展示了一个简单的流程，适合单人操作实施。当然你可以让它复杂得多，但对我来说原则是一样的。 👍 1 > [10] **@codelucky**:在开始一个项目之前，我会花40小时在项目规格上，包括头脑风暴、规划、PRD、用户漏斗、技术需求、设计、功能、数据库、技术工具需求、架构，几乎涵盖项目的所有内容，还会讨论版本控制、MVP等。 👍 3 > ——其他 5 条:感谢/夸赞([2]@mvuyisileroymasebeni244、[3]@AlexWise-ed1zk、[4]@bwaxse、[5]@ChrisFNRose、[6]@prash_visaarray);1 条 spam 已略 >
英文原文[1] @avtharai(UP):Hey everyone! A lot of you have asked for advice on how to best setup Claude Code for new projects, so I made this video to show you my exact process. If you're interested in applying the system from this video and shipping 3 projects in just 9 days, check out my live course Ship with Claude Code & Replit: https://maven.com/alpha-clarity/ship-with-claude-code-replit?promoCode=YOUTUBE You'll also get 10+ hours of help directly from me in the form of office hours and live Q&A. And you can save $300 off with code YOUTUBE at checkout. (I also have a handful of scholarships available if cost is a major barrier, see the link in description.) I really appreciate all your support for this channel! Happy coding with Claude! 👍 13
  ↪ @codewithalihaider:Could you please share the documents you were showing in the video? It would make it much easier for us to learn from you. We can then test and iterate on them to refine and tailor everything perfectly to your needs. 👍 2
[2] @mvuyisileroymasebeni244:Great video. Very helpful. 👍 1
  ↪ @avtharai(UP):Happy to hear that. Thanks! 🙏🏽
[3] @AlexWise-ed1zk:I'm absolutely blown away by this channel. So much valuable, in-depth information packed into every video, and zero fluff or filler. Straight to the point and incredibly useful. Thank you 👍 7
  ↪ @avtharai(UP):Thanks Alex, this means so much to me, really appreciate your support! Let me know what topics / tools you'd like to see videos on in the future. 👍 1
  ↪ @joshadams8761:100% agree!
[4] @bwaxse:Everyone's already saying it, but for the algorithm: this is truly a exceptional video and channel. Please keep it up and thank you. 👍 5
  ↪ @avtharai(UP):I really appreciate it! Thanks so much for watching. And let me know what tools / topics you’d like to see covered next
[5] @ChrisFNRose:Bro. Hands down the best video I have seen on Claude Code project management to date. Superbly structured, efficient, all useful information without fluff or filler or personal diatribes. I don't care what else you put out, just stick to this style. 👍 31
  ↪ @avtharai(UP):Thank you so much - I'm glad this style and structure resonated! Let me know what other topics or tools you'd like to see covered in future. 👍 1
[6] @prash_visaarray:Very well structured and easy to understand. Keep up the good work! 👍 1
  ↪ @avtharai(UP):🙏🏽
[7] @Eric-yn6ur:Plan, start a new session, build, start a new session, execute. Never let you session last any longer than needed. Claude is super sharp for its first 5-10 prompts and tasks. 👍 4
  ↪ @avtharai(UP):Right on. Context management is important!
[8] @asifsvirtualfootprint7370:please share the multi agent strategy in Claude Code git work tree in the next video 👍 24
  ↪ @avtharai(UP):Noted, thanks for commenting!
[9] @jamieosh70:For someone experienced as a professional engineer or product manager it is easy to pick holes and criticise some of what you say and your approach - but this is a very good video, you set out an approach, and it’s a pretty solid approach that is easy to understand, it’s a great start for anyone inexperienced and it’s easy to evolve into what their approach is for anyone who is experienced. You explain the concepts and how to use Claude code well, again a great stepping stone to other approaches and refinements. Well done 👍 👍 2
  ↪ @avtharai(UP):Thank you for this thoughtful comment Jamie. I present a simple process that's easy for a 1 person operation to implement. You can ofc make it much more complex, but the principles for me stay the same. 👍 1
[10] @codelucky:Before starting a project, 40 hours I spend on Project specs that includes Brainstorming, planning, PRD, user funnel, technical requirements, design, features , functions, database, tech tools requirements, architecture near about everything that the project is all about also discuss versioning, MVP etc. 👍 3