不会代码，怎么用 Claude Code 独立做完一个项目

一句话结论

小白不要一上来让 Claude Code 直接写代码，先让它帮你把项目拆成需求、页面、数据、功能、验收、上线 6 个阶段，每一步都要有可检查的产物。

适用场景

• 你不会代码，但想做一个能打开给客户看的网页、工具、课程页、知识库或 Demo
• 你有一个想法，但不知道要建什么文件、用什么技术、怎么让 Claude Code 开始
• 你已经会打开 Claude Code，但每次只会说「帮我做个网站」，结果做出来不完整
• 你想独立完成项目，而不是每一步都找程序员帮忙

常见现象

• Claude Code 写了一堆代码，但你不知道怎么运行
• 页面能打开但很丑、内容不完整、按钮没反应
• 它说完成了，但你不知道项目到底有没有构建通过
• 你让它改 A，它顺手改了 B，最后越改越乱
• 做了一半遇到报错，只会把窗口关掉重新开始

原因解释

• 不会代码的人最容易把「做项目」误解成「让 AI 一次性生成全部代码」，但真正稳定的做法是分阶段验收
• Claude Code 很擅长读项目、改文件、跑命令、解释报错，但它需要你给清楚目标和边界
• 项目失败通常不是模型不会写代码，而是需求没拆清、入口没找对、验收标准没写、报错没保留
• 你不需要先学完整编程，但必须学会 6 个动作：说清目标、看懂文件树、复制命令、保存报错、看预览、确认上线地址

解决步骤

1. 第 1 阶段：把想法写成 1 页需求稿。告诉 Claude Code 目标用户是谁、要解决什么问题、必须有哪些页面或按钮、不要做哪些功能。
2. 第 2 阶段：让 Claude Code 先出项目计划，不许直接写代码。计划里必须有页面清单、数据清单、文件范围、运行命令、验收方式。
3. 第 3 阶段：创建或打开项目。新项目让 Claude Code 选择最简单技术栈；已有项目先让它解释目录结构、入口文件和构建命令。
4. 第 4 阶段：先做能看的第一版。不要一口气做登录、支付、后台、数据库，先做首页、核心流程和可预览 Demo。
5. 第 5 阶段：每完成一个小功能就运行一次。让 Claude Code 告诉你打开哪个本地地址、点哪里、应该看到什么。
6. 第 6 阶段：遇到报错不要重开会话。复制完整报错、命令、截图描述，让 Claude Code 先解释原因，再给最小修复。
7. 第 7 阶段：上线前做验收。要求它运行 build/test，检查关键页面、按钮、移动端、SEO 标题和没有泄露密钥。
8. 第 8 阶段：上线后保存交接文档。让 Claude Code 写清项目怎么运行、怎么改文案、怎么部署、常见问题怎么处理。

可复制命令

# 第 1 步：把想法变成需求稿
你是我的产品经理和技术翻译。我完全不懂代码。

我想做的项目：<一句话写你的想法>
目标用户：<谁会使用>
我希望用户完成的动作：<例如提交表单、浏览课程、搜索文章、查看报价>
必须有的内容：<列 3-8 条>
不要做的内容：<例如登录、支付、复杂后台>
我的素材：<文案、图片、链接、表格、联系方式>

请你先不要写代码，先输出：
1. 这个项目最小可用版本是什么。
2. 需要哪些页面。
3. 每个页面放什么内容。
4. 哪些功能可以先不做。
5. 我下一步应该准备什么素材。

# 第 2 步：让 Claude Code 出工程计划
你是 Claude Code 项目教练。我不会代码，请一步一步带我完成。

项目路径：<填项目文件夹>
项目目标：<填需求稿总结>

本轮先不要改代码，请你先检查项目结构，然后输出：
- 技术栈是什么
- 入口文件在哪里
- 页面/路由在哪里
- 数据或文章内容放在哪里
- 本地运行命令
- 构建命令
- 本轮建议先改哪些文件
- 不要碰哪些文件
- 做完后我应该如何验收

# 第 3 步：正式让它做第一版
请按刚才的计划制作第一版。

要求：
1. 先做能打开、能看懂、能演示的版本。
2. 不要加入登录、支付、数据库，除非我明确要求。
3. 每次只改和本项目有关的文件。
4. 做完后运行构建或本地预览命令。
5. 告诉我本地预览地址，以及我需要点击检查的 5 个地方。
6. 如果报错，请先解释报错，再修复，不要直接大改。

# 第 4 步：用验收目标收口（直接当普通提示词发送，或写进 CLAUDE.md）
本轮完成条件——小白项目第一版：
1. 首页或主页面能打开。
2. 用户能看懂这是给谁用、解决什么问题、下一步点哪里。
3. 核心按钮有去处，不出现空按钮。
4. npm run build 或项目对应构建命令通过。
5. 给我一份交接说明：如何运行、如何修改内容、如何上线、还有哪些风险。

# 报错时这样贴给 Claude Code
我刚才执行了这个命令：
<粘贴命令>

完整报错如下：
<从第一行到最后一行完整粘贴>

我刚才想做的事情：
<例如启动本地预览、构建、部署、打开页面>

请你：
1. 用小白能懂的话解释错误原因。
2. 判断最可能是哪一个文件或配置导致的。
3. 只做最小修复。
4. 修完重新运行同一个命令验证。

# 交付前检查清单
请你帮我做最终验收，不要新增功能。

检查：
1. 关键页面是否能打开。
2. 按钮是否都有去处。
3. 手机宽度下文字是否溢出。
4. 是否有空内容、占位英文、无效链接。
5. 是否泄露 API Key、token、邮箱以外的隐私信息。
6. 构建命令是否通过。
7. 如果是静态站，dist 里是否有可部署文件。

输出：
- 通过项
- 发现的问题
- 已修复的问题
- 仍需人工确认的问题

仍然不行怎么办

• Claude Code 不知道从哪里开始：把任务缩小成「只做首页第一屏」或「只做一个可预览 Demo」。
• 项目越做越乱：让它停下来输出当前改动清单，先恢复到上一个能运行的版本，再继续。
• 你看不懂报错：不要概括，直接完整复制给它；报错少一行，经常就会误判。
• 本地打不开：让它确认当前目录、端口、启动命令和浏览器地址，不要只说 127.0.0.1 拒绝连接。
• 准备上线但不确定：先让它只构建和检查 dist，不要部署；确认 Cloudflare/Vercel/服务器项目名后再上线。

小白最适合先做的 6 类项目

• 个人或公司介绍页：最容易做成，适合练习页面、图片、联系方式和部署。
• 课程或知识库页面：适合把文档整理成分类、搜索、文章页。
• 客户演示 Demo：适合给外贸、客服、知识库、自动回复业务做可点击样板。
• 表单收集页：适合收集需求、报名、咨询，但先用第三方表单，不要一开始做后台。
• 数据整理小工具：例如 CSV 清洗、标题生成、报价文本生成，适合本地使用。
• Telegram Bot 或 Agent 工作流说明页：先做说明和流程，再决定是否真的接 API。

不建议小白第一天就做的项目

• 支付系统、余额系统、会员系统：涉及钱和权限，必须有人复核。
• 多用户后台和数据库管理：出错后很难靠截图判断问题。
• 自动发帖、自动私信、批量采集：容易违反平台规则，也容易封号。
• 生产环境网络运维：路由器、服务器、防火墙可以让 AI 辅助分析，但不要一开始就自动执行危险命令。
• 带密钥的模型中转或账号池系统：需要安全、计费和日志经验，不适合小白独立硬做。

你需要学会看懂的 8 个词

• 项目目录：放代码和素材的文件夹，Claude Code 必须在这里启动。
• 入口文件：网站或工具最先加载的文件，改错入口就看不到效果。
• 依赖：项目需要安装的工具包，通常由 npm install 安装。
• 本地预览：在你电脑上打开的测试地址，常见是 localhost 或 127.0.0.1。
• 构建：把项目打包成能上线的文件，常见命令是 npm run build。
• dist：很多静态站构建后的输出目录，部署时通常上传它。
• 报错日志：命令失败时输出的文字，要完整复制。
• 版本控制：Git 记录每次改动，做坏了可以回退。

从 0 到上线的路线图

1. 准备素材：项目名、目标用户、页面文案、图片、联系方式、参考网站。
2. 写需求稿：让 Claude Code 把你的想法翻译成页面清单和功能清单。
3. 搭第一版：只做最小可用版本，先能打开、能演示。
4. 补内容：把空文案、占位图、无效按钮改掉。
5. 做体验检查：手机端、按钮、表单、搜索、链接逐项看。
6. 构建验证：运行 build，保存成功结果。
7. 部署上线：只部署指定项目，记录线上地址。
8. 交接维护：写 README 或交接说明，下次知道怎么改。

一个真实案例：做外贸 AI 工作流 Demo

1. 你告诉 Claude Code：我要给外贸客户展示 AI 如何做客户开发、询盘回复、报价草稿和跟进提醒。
2. 先让它出页面结构：首屏、流程图、6 个模块卡片、可复制提示词、联系入口。
3. 让它先做静态 Demo，不接真实 CRM、不接邮箱、不接客户数据。
4. 你检查文案是否像客户能看懂的人话，不要只堆 AI 名词。
5. 让它运行本地预览，你点击每个按钮和卡片。
6. 构建通过后部署成一个 URL，发给客户预览。

一个真实案例：做知识库教程站

1. 你准备 10 篇教程标题和每篇的一句话结论。
2. 让 Claude Code 设计分类：新手入门、常见报错、工具教程、工作流模板。
3. 先做首页、分类页、文章页，不要先做复杂后台。
4. 要求文章正文直接出现在 HTML 里，方便搜索引擎抓取。
5. 让它生成 sitemap.xml 和 robots.txt。
6. 构建后抽查 dist 里的文章 HTML 能搜到标题和正文。

每天推进项目的节奏

• 每天只定 1 个目标，例如「今天把首页做完」而不是「今天把整个平台做完」。
• 每轮开始先让 Claude Code 复述目标和文件范围。
• 每轮结束都让它输出：改了什么、怎么验证、下轮做什么。
• 遇到报错先修报错，不要同时加新功能。
• 每完成一个可用版本就保存或提交一次，避免后面回不去。

判断项目是否真的完成

• 你能用一句话说清这个项目给谁用。
• 陌生人打开首页 5 秒内知道下一步点哪里。
• 核心流程至少完整走通一次。
• 所有主要按钮都有去处。
• 没有明显占位文案、乱码、空白区。
• 构建命令通过。
• 线上地址能打开，并且手机上也能看。

什么时候必须找人帮忙

• 涉及真实付款、余额、订单、退款、发票。
• 涉及生产数据库、客户隐私、账号密码、API Key。
• 上线后会影响很多用户或客户业务。
• Claude Code 连续两轮修复失败，还在改同一片代码。
• 你看不懂它准备执行的命令，尤其是 sudo、rm、数据库删除、批量上传。

Explore → Plan → Slice → Verify 小白四步法

1. Explore：进入项目后先让 Claude Code 只读分析。问它技术栈、入口文件、路由、数据源、构建命令。新仓库可以用 /init 让它自动生成 CLAUDE.md 初稿。
2. Plan：让它输出改动计划，列出要改哪些文件、不碰哪些文件、预期产物是什么。你确认后再允许它动手。复杂改动一定先要计划，不要直接说「帮我做」。
3. Slice：把任务切成可独立验收的小块。每块只做一件事，例如「只做首页第一屏」「只改文章数据」「只修这个报错」。不要一口气让它做登录+支付+后台。
4. Verify：每完成一块就运行构建或预览命令，确认结果。贴完整 stack trace 让它排错，不要只说「报错了」。改完跑测试或 build，通过了再进入下一块。

CLAUDE.md 放什么，写在最前面的 8 条规则

CLAUDE.md 放在项目根目录，Claude Code 每次启动都会读。长会话里规则会漂移，关键规则放在文件靠前位置，每条写成短命令加原因。

1. 项目是什么：一句话写清用途和目标用户。
2. 常用命令：安装依赖、本地开发、构建验证、测试命令各一行。
3. 每次改完必须做：运行 build、说明改了哪些文件、确认关键页面可访问。
4. 禁止触碰：不改无关项目、不删用户文件、不打印密钥、不自动部署。
5. 目录导航：入口文件在哪、页面路由在哪、数据源在哪、静态资源在哪。
6. 领域坑：项目特有的注意事项，例如「中文文件名会导致路由 404」「图片必须放 public 目录」。
7. 测试约定：改完跑什么命令验证、怎样算通过、失败了先修什么。
8. 输出格式：改动摘要、验证结果、风险和后续建议，每轮结束都输出。

progress.md 步骤追踪文件怎么防跑偏

长任务容易做到一半偏题。在项目里建一个 progress.md 当移动锚点，每轮开始让 Claude Code 先读它、更新它，这样即使开新会话也能接上。

1. 在项目根目录新建 progress.md，写上项目目标、当前阶段、已完成项、下一步。
2. 每轮开始时让 Claude Code 先读 progress.md，复述当前状态和本轮目标。
3. 每轮结束时让它更新 progress.md：标记完成项、写下一步、记录未解决问题。
4. 如果发现它偏题（改了不该改的文件、加了没要求的功能），让它回到 progress.md 里的下一步。
5. 开新会话时把 progress.md 路径告诉它，它就能接着上次的进度继续。

前端项目必须视觉验收：本地地址、手机宽度、按钮、截图

构建通过不等于页面正确。前端项目必须用浏览器打开本地预览地址，肉眼检查关键页面。

1. 让 Claude Code 告诉你本地预览地址（通常是 localhost:3000 或 localhost:5173）。
2. 用浏览器打开，检查首页是否能加载、文案是否正确、图片是否显示。
3. 按 F12 打开开发者工具，切到手机宽度（375px），检查文字是否溢出、按钮是否能点。
4. 点击每个主要按钮和链接，确认都有去处，不出现空白页或 404。
5. 如果有截图工具，截一张桌面版和一张手机版，贴给 Claude Code 让它确认布局。
6. 发现问题就具体描述：哪个页面、哪个按钮、什么现象，不要只说「页面有问题」。

什么任务适合做成 Skill 或子 Agent

重复执行同一类操作超过 3 次，就值得沉淀成 Skill 或子 Agent。Skill 是一份可复用的能力说明和操作手册，子 Agent 是可以后台并行执行的检查流。

• 适合做 Skill 的任务：每次发布前的验收清单、固定格式的内容生成、特定项目的部署流程、重复的数据清洗步骤。
• 适合做子 Agent 的任务：代码审查、安全检查、多文件一致性验证、并行跑不同分支的构建。
• 怎么做：把操作步骤写成 .md 文件放在 .claude/agents/ 目录，Claude Code 会自动识别。
• Skill 文件里写清：触发条件、输入要求、执行步骤、输出格式、失败时怎么办。
• 不适合做 Skill 的：一次性任务、需要大量人工判断的决策、每次输入完全不同的创意工作。

参考链接

• Claude Code Quickstart：https://code.claude.com/docs/en/quickstart
• Claude Code Common Workflows：https://code.claude.com/docs/en/common-workflows
• Claude Code Best Practices：https://code.claude.com/docs/en/best-practices

相关问题

• Claude Code 小白教学：更新新版本后先学哪些新特性

  更新后先别急着让它大改项目：先查版本，再用 /help 确认本机支持的斜杠命令；把验收目标写进提示词或 CLAUDE.md，不要把 Codex 教程直接搬到 Claude Code。

• Claude Code 第一次跑起来要做什么

  装、登录、改一个小文件、提交一次 PR，一小时内能跑完整的工具回路。

• Windows 下 Codex App / CLI / Computer Use 和 Claude Code CLI 优化指南

  Codex Computer Use 是 Windows Codex App 的桌面操作能力；写代码仍靠 App / CLI，Linux 项目仍建议放 WSL2。

• Agent 任务说明怎么写才不跑偏

  提示词不是咒语，而是一张任务单：目标、资料、规则、步骤、输出、示例、边界和验收标准写清楚，Agent 才不容易跑偏。

• Claude Code 用 Opus 4.7，Codex 用 GPT-5.5 协同完成项目

  Claude Code 负责看懂需求、拆方案、改小块和复核体验；Codex 负责跨文件落地、跑构建测试和部署验证，中间用一张任务卡交接就够了。

还卡着？

可以把截图、日志、需求单或当前页面链接发到 zhemuy@gmail.com。

• Agent 定制服务 — 查看需求模板
• 1A1API 模型中转 — 查看接入步骤
• 排错协助 — 联系处理