Claude Code 新人全栈开发指南

从 0 到 1，用 AI 驾驭完整项目开发

本指南从一个真实项目的完整开发过程中提炼而来。无论你要做什么系统，这套方法论都适用。

写在前面：一个认知转变

学 Claude Code，不是学编程。

是学如何跟 AI 说话，让 AI 替你写代码、跑测试、修 bug。

你的核心能力是：把需求说清楚。

第一章：开始之前——环境准备

1.1 必须安装的三样东西

# 1. Node.js（去 nodejs.org 下载，版本 v18 以上）node --version   # 验证：显示版本号即可# 2. Claude Codenpm install -g @anthropic-ai/claude-code# 3. 验证安装claude --version

1.2 启动你的第一个项目

# 建立项目文件夹，进入，启动 CCmkdir 你的项目名 && cd 你的项目名claude

✅ 看到 CC 的对话界面 = 准备就绪

第二章：项目启动——最重要的第一步

2.1 为什么第一步决定成败

第一步做对了，后面的开发会非常顺畅。第一步没做好，CC 会在整个项目里反复"犯糊涂"。

第一步的目标只有一个：让 CC 理解你的完整需求，自主规划项目架构。

2.2 你需要先准备一份 PRD

PRD = 产品需求文档。不需要很正式，一个文本文件就够。

PRD 最少要包含以下内容：

1. 这个系统是干什么的（一句话描述）2. 谁在用它（使用人群）3. 有哪些页面/功能（尽量具体）4. 字段信息（每个页面要显示/填写什么）5. 不需要做什么（明确边界）

提示：需求越具体，CC 规划越准确。 "做一个商城" vs "做一个内部选品下单系统，不需要支付和库存" 后者会让 CC 少做很多不必要的功能。

2.3 项目启动 Prompt 模板

把下面这段发给 CC，把 [ ] 里的内容替换成你自己的：

我有一个项目需求，请你完成以下事情：1. 仔细阅读我提供的需求文档，理解完整需求2. 自主规划项目目录结构3. 确认技术栈：[前端技术] + [后端技术] + [数据库]4. 在项目根目录创建 CLAUDE.md 文件，写入：   - 项目简介   - 完整目录结构   - 技术栈说明   - 数据库表结构   - 开发阶段划分   - 当前进度（初始为"未开始"）5. 创建实际的目录和空文件骨架不需要写任何业务代码，只需要把架构搭好。以下是需求文档全文：[粘贴你的 PRD 内容]

为什么这样写有效：

技巧点	作用
编号分步	CC 按顺序执行，不会漏掉任务
"不需要写业务代码"	防止 CC 跑偏，直接开始写功能
要求创建 CLAUDE.md	建立项目记忆，后续所有对话都能快速恢复上下文
PRD 直接粘贴	CC 不靠猜测，读原始需求，准确率大幅提升

2.4 什么是 CLAUDE.md？为什么它很关键

CLAUDE.md 是 CC 的"项目记忆文件"。

每次你重新打开 CC，它会自动读取这个文件，知道：

项目是什么
目录结构长什么样
当前做到哪一步了

没有它：每次都要重新解释背景，CC 容易混乱 有了它：CC 一进来就进入状态，像一个了解项目的老员工

好习惯：每完成一个阶段，让 CC 更新 CLAUDE.md 里的进度记录：
请更新 CLAUDE.md 的"当前进度"部分，标记 [已完成的阶段]，下一步是 [下一阶段]

第三章：高效对话——需求 Prompt 四要素

这是整个指南最核心的内容。

3.1 四要素公式

每次给 CC 布置任务，都用这个结构：

【背景】参考 CLAUDE.md，当前在 [哪个阶段]【任务】这次具体要做什么（越具体越好）【约束】不要做什么 / 必须遵守什么规则【验收】怎样算完成

3.2 反面教材 vs 正面示范

❌ 糟糕的 Prompt：

帮我做商品列表页

问题：CC 不知道用什么技术、要哪些字段、做到什么程度、要不要动其他文件。

✅ 好的 Prompt：

请先读取 CLAUDE.md 了解项目现状。【任务】只做前台的商品列表页（frontend/index.html）【要求】- 展示字段：商品图片、名称、品牌、价格、标签- 支持：按名称搜索、按标签筛选- 每个商品有"加入购物车"按钮和数量加减- 调用已有的后端接口【约束】- 只动 frontend/ 目录下的文件- 不要做购物车和提交订单页，那是下一步【验收】- 浏览器打开能看到商品列表- 搜索和筛选功能正常

3.3 任务拆解：切片原则

核心原则：每次只让 CC 做一件事。

# ❌ 错误方式：一次性交出所有任务帮我把整个前端都做完# ✅ 正确方式：切片下发现在只做商品列表页完成后告诉我，我再让你做购物车页

为什么要切片：

任务太大 → CC 容易失控，代码质量下降
切片执行 → 每步可验证，发现问题及时纠正
你始终知道项目进展到哪里

3.4 让 CC 汇报进度

在任务里加上这句话，CC 会主动告诉你每步的完成状态：

每完成一个模块，输出 ✅ [模块名]完成，再继续下一个

第四章：调用 CC 的核心能力

4.1 CC 能做什么

文件操作   → 读/写/创建/删除项目里的任何文件终端执行   → 运行命令、启动服务、安装依赖代码编辑   → 精准修改某一段代码，不影响其他部分自主调试   → 看到报错 → 分析原因 → 改代码 → 重新跑

4.2 最强技巧：自主调试模式

在任务里加上这段，CC 会自己跑测试、自己修 bug，不来烦你：

【自主调试要求】- 写完代码后，自己启动服务验证- 如果报错，自己看报错信息修复，不要来问我- 全部跑通后，输出测试结果清单

效果对比：

没有这句话	加了这句话
CC 写完代码就停了	CC 自己启动 → 看报错 → 修复 → 再启动
报错来问你	循环直到跑通才告诉你
你需要懂代码才能处理	你只需要看最终结果

4.3 让 CC 理解当前代码状态

当你想让 CC 修改已有代码，先让它读取：

请先读取 [文件路径] 了解当前代码，然后在此基础上 [做什么修改]

第五章：避坑指南

坑1：CC 改着改着"跑偏"了

症状： 你让改 A，CC 顺手改了 B/C/D

解决： 在约束里明确禁止范围

只修改 [具体文件名]不要动任何其他文件改完告诉我修改了哪几行

坑2：对话太长，CC 开始"失忆"

症状： 聊了很多轮后，CC 忘记之前的约定，开始犯之前犯过的错误

解决： 使用 /clear 命令清空对话，重新加载项目记忆

/clear

清空后第一句话：

请先读取 CLAUDE.md 了解项目现状，然后继续完成 [具体任务]

/clear 只清空对话历史，不会影响项目文件和 CLAUDE.md

坑3：一次交给 CC 的任务太大

症状： CC 写到一半逻辑混乱，或生成的代码根本跑不起来

解决： 切片原则（参考第三章）

坑4：修了一个 bug，引入了新 bug

症状： 改完一个问题，另一个地方坏了

解决： 让 CC 改完自测

修复这个 bug 后，把相关功能全部测一遍确认没有引入新问题再告诉我完成

坑5：CC 的回答越来越"敷衍"

症状： CC 说"已完成"但实际上没做好，或者代码有明显问题

解决： 要求输出具体证明

完成后输出：1. 修改了哪些文件2. curl 测试结果（显示状态码）3. 如果有问题，列出问题清单

第六章：标准开发流程

6.1 一个项目的完整节奏

第1步：准备 PRD（需求文档）    ↓第2步：启动 CC，生成架构 + CLAUDE.md    ↓第3步：按阶段切片开发（后端 → 后台前端 → 用户前端）    ↓第4步：每个切片：发 Prompt → CC 执行 → 验证结果    ↓第5步：完成一个阶段 → 更新 CLAUDE.md 进度    ↓第6步：联调测试（让 CC 走完整业务流程）    ↓第7步：标记 V1.0 完成

6.2 推荐的开发顺序

后端 API → 后台管理前端 → 用户前端 → 联调测试

为什么这个顺序：

后端先完成 → 前端有真实接口可以调用
后台先做 → 可以录入测试数据
有了数据 → 用户前端测试更真实

6.3 联调测试 Prompt 模板

请参考 CLAUDE.md 了解项目现状，所有功能已开发完成。【任务】做一次完整的端到端测试，按以下流程逐项验证：1. [测试步骤1]2. [测试步骤2]3. [测试步骤3]...【要求】- 每一步测试完，输出 ✅ 或 ❌ + 说明- 发现 bug 直接修复，不要来问我- 全部通过后，更新 CLAUDE.md 进度为"V1.0 完成"【验收】全部步骤 ✅

第七章：常用斜杠命令速查

命令	用途	何时使用
/clear	清空对话历史	对话太长、CC 开始失忆时
/mcp	查看已安装的 MCP 插件	确认插件是否生效
/doctor	诊断 CC 环境问题	CC 出现异常时
/exit	退出 CC	结束工作时

第八章：Prompt 模板速查手册

8.1 项目启动

请仔细阅读以下需求，自主规划项目架构，创建目录结构和 CLAUDE.md，不需要写业务代码。需求如下：[粘贴需求]

8.2 功能开发（标准版）

请先读取 CLAUDE.md 了解项目现状。【任务】[具体任务]【要求】[具体要求，分条列出]【约束】不要动 [哪些文件/模块]【验收】[怎样算完成]

8.3 Bug 修复

[描述问题现象]报错信息：[粘贴报错]请修复这个问题，修复后自测相关功能，确认没有引入新问题再告诉我。

8.4 恢复上下文（/clear 之后）

请先读取 CLAUDE.md 了解项目现状，然后继续完成 [具体任务]。

8.5 更新项目进度

请更新 CLAUDE.md 的"当前进度"部分，标记 [已完成的内容]，下一步是 [下一步计划]。

写在最后

你真正需要掌握的只有三件事

把需求说清楚：四要素公式（背景+任务+约束+验收）
切片执行：每次只做一件事，完成再进行下一件
善用 CLAUDE.md：保持项目记忆，随时可恢复上下文

一句话总结

CC 不需要你懂代码，但需要你把需求描述得像一个懂代码的人。

本指南基于内部商品销售系统（前后端分离全栈项目）的完整开发过程提炼，技术栈为 FastAPI + MySQL + HTML/TailwindCSS。方法论适用于任何技术栈和任何类型的系统开发。

后端开发教程(Claude Code 新人全栈开发指南)