Posts 如何使用 Claude Code 开始每一个项目
Post
Cancel

如何使用 Claude Code 开始每一个项目

你是不是也有过这样的经历?兴冲冲地开始一个新项目,结果半路发现缺这少那,要么是配置文件没准备好,要么是项目目标不够清晰,最后不得不停下来返工。如果你用 Claude Code 开发过项目,这种挫败感可能更强烈——明明 AI 很强大,为什么还是会陷入混乱?

今天要分享的这套 PSB 系统,来自一位资深 AI 产品经理在构建了几十个 Claude Code 项目后总结出的实战经验。它不是什么高深的理论,而是一套简单实用的三步法,能让你的项目从启动那一刻起就保持清晰高效。

什么是 PSB 系统?

PSB 是三个英文单词的首字母缩写,代表项目启动的三个阶段:

  • 📋 Plan(规划):在写代码前先想清楚要做什么

  • ⚙️ Setup(配置):为 Claude Code 准备好所有工具和环境

  • 🔨 Build(构建):真正开始编码和开发功能

听起来很简单对吧?但就是这三步,能让你的开发效率提升好几倍。


第一阶段:Plan - 规划决定成败

很多人打开 Claude Code 的第一件事就是开始写代码,这恰恰是最常见的错误。花 15 分钟做好规划,能帮你省下几个小时甚至几天的返工时间。

🤔 先回答两个核心问题

在开始之前,拿出笔记本或打开文档,认真回答这两个问题:

问题 1:你到底想做什么?

这听起来像废话,但很关键。你是想:

  • 学习一个新技术?

  • 验证一个想法可不可行?

  • 做一个能给真实用户用的产品?

  • 还是只是做个原型看看效果?

目标不同,做法完全不同。比如你只是做原型,那就专注核心功能,快速验证想法,不用纠结代码质量。但如果要给真实用户用,就得考虑安全性、错误处理这些细节了。

问题 2:分几步走?

把项目拆成清晰的阶段:

  • 第一版(MVP)要做成什么样?

  • 哪些功能可以留到后面做?

  • 第二版、第三版各做什么改进?

一般来说,想清楚一个 MVP 和一到两个改进版本就够了。

💡 让 AI 帮你规划

这里有个小技巧:不要自己苦思冥想,让 AI 来帮你提问。

你可以这样问:

“我想做这个项目,为了成功完成 MVP,我需要回答哪三个最重要的问题?”

或者直接用 Claude 或 ChatGPT 的语音模式聊聊,让 AI 帮你整理思路,最后生成一份 markdown 文档作为起点。特别是想法还比较模糊的时候,这招特别管用。

📝 写一份项目规格文档

规格文档包含两部分:

1. 产品需求

回答三个问题:

  • 谁用:产品是给谁用的?

  • 为什么用:解决什么问题?

  • 怎么用:产品应该做什么?

这里要注意,别写得太抽象。比如不要只说”用户可以创建日记”,而要说”用户打开应用看到空白页,可以添加照片,可以编辑历史记录,具体流程是……”越具体越好。

2. 技术需求

主要包括两块:

选技术栈

如果你不确定用什么技术,可以让 Claude Code 帮你做个调研报告。如果你已经有想法,这里有一套推荐的 Web 应用技术组合:

  • 前端:Vercel + Next.js + Tailwind + Shadcn

  • 后端:MongoDB 或 Supabase

  • 认证:Clerk

  • 支付:Stripe

  • 邮件:Resend

  • AI 功能:Anthropic + Google Gemini

定架构

说清楚系统怎么设计、各部分怎么交互、数据库怎么设计、API 怎么定义。如果你在公司团队里干活,这部分要写详细点,方便团队协作。

对了,在开始写代码前,记得把基础设施都准备好:数据库建好、域名注册好、API 密钥都创建好。

💡 要点总结

  • 明确项目目标,不要盲目开始

  • 把项目分解成清晰的里程碑

  • 写详细的需求文档,越具体越好

  • 选好技术栈,准备好所有基础设施


第二阶段:Setup - 配置是效率的基础

配置阶段可能看起来有点繁琐,但这是磨刀不误砍柴工。把这七步做好,后面开发会顺利得多。

📦 步骤 1:建 GitHub 仓库

强烈建议从一开始就建好 Git 仓库,理由有四个:

  1. 随处编码:可以在电脑、平板、手机上用 Claude Code

  2. 自动化流程:用 GitHub CLI 和 Actions 处理 PR、Issues

  3. 一键部署:很多平台(比如 Vercel)可以直接连 GitHub 部署

  4. 基于 Issue 开发:把 Issues 当作任务清单,可以多个 Claude Code 实例同时干活

小提示:每个大功能用新分支开发,完成后再合并到主分支。

🔐 步骤 2:准备环境变量

让 Claude 根据你的技术栈生成一个 .env.example 文件,然后复制一份填上真实的密钥和凭证。这样 Claude 就能直接用,不用三天两头问你要密钥了。

📄 步骤 3:配置 claude.md 文件

这个文件是项目的”记忆”,每次和 Claude Code 对话都会读取它。但要记住一个原则:保持简洁

应该包含什么?

  1. 项目目标和架构概览

  2. 设计风格和用户体验准则

  3. 约束和规则(比如”永远不要直接推到主分支”)

  4. 仓库规范(什么时候用 PR,分支怎么命名)

  5. 常用命令(构建、测试命令)

如果内容太多怎么办?用链接。在 claude.md 里提到重要文件,告诉 Claude 需要时去看那些文件。

这个文件不用一次写完美,在开发过程中慢慢完善就行。

📚 步骤 4:建自动化文档系统

除了 claude.md,还要准备几份文档,让 Claude 在需要时查阅:

  1. architecture.md:系统设计和组件交互

  2. changelog.md:项目变更历史

  3. project-status.md:当前进度和下一步计划

  4. 功能文档:比如 onboarding.mdpayments.md

怎么保持更新?在 claude.md 里加一条指令,让 Claude 工作时自动更新这些文档。或者创建一个自定义命令,完成功能后跑一下。

🔌 步骤 5:安装插件

插件是给 Claude Code 加功能的扩展包,能让开发更快更简单。

推荐三个:

  1. Anthropic Frontend Plugin:专门优化前端开发

  2. Anthropic Feature Dev Plugin:简化功能开发流程

  3. Every Compound Engineering Plugin:一整套实用命令和子代理

/plugins 命令就能管理这些插件。

🔗 步骤 6:连接 MCP 服务器

MCP(Model Context Protocol)是连接外部工具的桥梁。比如:

  • 数据库 MCP(MongoDB 或 Supabase):让 Claude 能直接操作数据库

  • Playwright MCP:自动测试网页功能

  • Vercel MCP:一键部署

  • Linear MCP:管理项目任务

安装很简单,按文档里的命令操作就行,通常就是一行命令的事。

⚡步骤 7:设置命令和子代理

Slash 命令子代理有什么区别?

  • Slash 命令:快捷方式,和主对话用同一个上下文

  • 子代理:专门干一件事的独立代理,有自己的上下文

推荐的子代理:

  1. Planning 子代理:帮你规划任务

  2. Codebase Search 子代理:搜索代码库

  3. Changelog 子代理:自动更新变更日志

  4. Frontend Testing 子代理:专注前端测试

  5. Retro 子代理:开发后反思改进

推荐的命令:

  • /commit/pr:提交更改

  • Feature Dev 相关命令

  • 自定义的更新文档命令

✓ 两个高级技巧

技巧 1:预配置权限

提前批准常用操作(比如 git 命令、编辑文件),避免 Claude 老是问你”可以吗”。不然你去泡杯咖啡回来,发现 Claude 还在等你批准,那可太尴尬了。

技巧 2:设置 Hooks

Hooks 是自动运行的脚本,可以在特定时刻触发。比如:

  • Stop Hook:Claude 完成任务后自动检查测试

  • Notification Hook:需要权限时在 Slack 通知你

虽然听起来高级,但试试看,能大幅提升效率。

💡 要点总结

  • GitHub 仓库是基础,从一开始就要建好

  • claude.md 要简洁但信息丰富

  • 用文档系统让 Claude 记住项目状态

  • 插件和 MCP 能省很多事

  • 预配置权限和 Hooks 让开发更顺畅


第三阶段:Build - 开始真正的开发

前面两步做好了,这一步就轻松多了。

✓ 构建 MVP

把项目规格文档准备好,让 Claude 根据它来构建第一版。

专业技巧:要求 Claude 尽可能使用并行子代理,能同时处理项目的多个部分,速度快得多。

记住:始终先用计划模式,让 Claude 把规格转化成实施计划,结果会好很多。

✓ 三种开发工作流

流程 1:通用流程(适合单个功能)

四个步骤:

  1. 研究:让 Claude 做技术调研(可选)

  2. 计划:用计划模式分解任务(最重要!)

  3. 实施:Claude 自动使用你配置的所有工具

  4. 测试:验证功能是否正常

推荐使用 Feature Dev 命令,它会自动走完这个流程。

流程 2:基于 Issue 的开发(适合大项目)

核心思想:把 GitHub Issues 当作任务清单。

  • 不是直接给 Claude 下命令

  • 而是创建 Issues 描述要做的事

  • 然后让 Claude 处理这些 Issues

好处是:

  • 项目更有条理

  • 可以多个 Claude 实例并行干活

  • 用子代理同时修多个 bug

流程 3:多代理开发(最高级)

同时运行多个 Claude Code 实例,每个处理不同的功能。

关键技术是 Git Worktrees:它让你能在不同目录里同时处理不同分支,互不干扰。

完成后让 Claude 把各个分支合并起来就行。这招很强大,但需要一点学习成本。

🚀 四个提升效率的技巧

技巧 1:用最好的模型

  • Opus 4.5:规划和复杂任务

  • Sonnet:日常开发主力

  • Haiku:简单 bug 修复

别为了省钱用差的模型,好模型犯错少,长远看反而省时间省钱。

技巧 2:定期更新 claude.md

每次添加新功能或达到新里程碑时更新。可以创建个自定义命令,让 Claude 自动更新文档并提交 git。

技巧 3:防止重复犯错

Claude 犯错时,别只是改掉继续。键盘敲个 # 号,给 Claude 一个指令,它会自动更新到 claude.md 里,下次就不会再犯同样的错了。

技巧 4:别怕推倒重来

代码很便宜。如果某个功能怎么都搞不定,特别是在原型阶段,直接删掉重新写可能更快。反正有 Git,什么都丢不了。

💡 要点总结

  • 先规划再实施,用计划模式

  • 根据项目规模选合适的工作流

  • 用好模型,定期更新文档

  • 别怕推倒重来,快速迭代


写在最后

PSB 系统看起来步骤不少,但其实都是些实实在在的技巧。你不需要一次全用上,挑几个适合自己的先试试,慢慢就会体会到好处。

最重要的是:花时间规划,做好配置,然后放心构建。这三步走好了,用 Claude Code 开发项目会变成一件很享受的事。

记住,这不是什么高深的理论,而是经过几十个项目验证的实战经验。试试看,你也能让自己的项目从第一天起就井井有条。


📚 信息来源

视频标题:How I Start EVERY Claude Code Project
作者:Avthar Sewrathan(AI with Avthar)
作者背景:拥有十年技术经验的 AI 产品经理和创业者
发布时间:2024 年 12 月 17 日
视频时长:约 33 分钟

本文基于该视频内容整理改写,旨在以更通俗易懂的方式分享 Claude Code 项目开发的实战经验。


真诚邀请您走进我的知识小宇宙,关注我个人的公众号,在这里,我将不时为您献上独家原创且极具价值的技术内容分享。每一次推送,都倾注了我对技术领域的独特见解与实战心得,旨在与您共享成长过程中的每一份收获和感悟。您的关注和支持,是我持续提供优质内容的最大动力,让我们在学习的道路上并肩同行,共同进步,一起书写精彩的成长篇章!

This post is licensed under CC BY 4.0 by the author.

Claude Agent SDK 完整指南:从零开始构建 AI Agent

-

Trending Tags