Non-Technical Guide

Vibecoding
操作手册

写给没有编程经验、但要用 AI 从零开发软件的人。
不需要你懂代码，但需要你会表达需求、能判断好坏。

向下滑动
01
认知篇
你的角色是什么
02
准备篇
装好工具再上路
03
启动篇
从想法到项目骨架
04
Harness 篇
给 AI 立规矩
05
沟通篇
怎么跟 AI 说话
06
开发篇
日常工作循环
07
质控篇
保证东西能用
08
急救篇
出了问题怎么办
09
成长篇
从入门到熟练
++
附录
速查表
01

认知篇

你的角色是什么

一个类比

想象你要装修房子：

传统装修AI 开发
你画草图 → 找施工队 → 干活 → 验收你说想要什么 → AI 出方案 → AI 干活 → 你验收
施工队问你要不要大理石AI 问你要不要用 React
你不需要会砌墙你不需要会写代码
但你要说清「客厅要大、采光好」但你要说清「首页简洁、加载快」
你的角色是业主 + 项目经理，不是施工工人。

你需要的四个能力

需求表达力
把脑子里的想法变成 AI 能理解的文字
方案判断力
AI 给你三个方案，你能选出最合适的
质量感知力
看到成品能说出「这里不对」
节奏把控力
知道先做什么后做什么，不贪多

这四个能力跟技术无关。你在日常工作中每天都在用。

每次只做一件事。
做完、验收、保存，再做下一件。

整份手册最重要的一句话。后面所有流程都围绕这个原则展开。

02

准备篇

装好工具再上路

先选你的工作方式

Claude Code 有两种使用方式，功能完全一样。推荐 VS Code 插件。

VS Code 插件 ← 推荐终端版
适合谁大多数人，非技术背景喜欢打字、追求效率
审批改动点按钮，有可视化对比按 y / n
看文件左侧文件树直接看需要用命令
上手难度跟普通软件一样需习惯终端
两种方式共享所有配置（CLAUDE.md、规则、记忆、hooks）。可以混着用。

安装 VS Code 插件

第 1 步 — 安装 VS Code+
去 code.visualstudio.com 下载安装，跟装普通软件一样。
第 2 步 — 安装 Claude Code 插件+
按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows）→ 搜索 Claude Code → 作者 Anthropic → 安装
第 3 步 — 打开项目文件夹+
菜单 → 文件 → 打开文件夹 → 新建文件夹（如 my-project）→ 打开
第 4 步 — 启动面板+
点右上角 ✨ 图标，或按 Cmd+Shift+P 输入 "Claude Code"。首次需登录 Anthropic 账号。
my-project — VS Code
◇ src/
  ◇ index.html
  ◇ app.js
◇ tests/
◇ CLAUDE.md
◇ package.json
<div class="card">
  <h2>融资卡片</h2>
  // AI 写的代码
</div>
Claude Code
已创建融资卡片组件，包含公司名称、轮次和金额字段。
测试通过 ✓
在这里输入需求...

三个好处

代码改动可视化
红绿对比（红色=删除，绿色=新增），点「接受」或「拒绝」决定是否采纳
文件结构一目了然
左侧文件树直接看项目有哪些文件，新增文件有标记
@提及文件
在对话框输入 @ 引用文件，如 @index.html 表示「我说的是这个文件」

终端版安装（可选）

已用 VS Code 插件的可跳过。终端版是进阶方式。
终端命令# 安装 Node.js curl -fsSL https://fnm.vercel.app/install | bash # 重启终端后 fnm install 22 && fnm use 22 # 安装 Claude Code npm install -g @anthropic-ai/claude-code # 验证 claude --version

操作对照表

操作VS Code 插件终端版
启动点 ✨ 图标claude
审批改动点「接受/拒绝」按 y / n
引用文件@文件名直接说文件名
保存代码/commit
全面测试/qa
退出关闭面板/exit
03

启动篇

从想法到项目骨架

先回答五个问题

拿出纸或备忘录，不碰电脑：

问题 1 — 解决谁的什么问题？+
示例：「帮助投资经理快速了解每天的一级市场融资动态，不用自己去各个网站翻。」
问题 2 — 最核心的三个操作？+
示例：「看今天的融资卡片 / 按赛道筛选 / 看某家公司详情」
问题 3 — 只做一个功能，做哪个？+
示例：「先只做融资卡片列表展示」
问题 4 — 手机还是电脑？+
示例：「投资经理早上通勤时在手机上刷」
问题 5 — 有参考产品吗？+
示例：「类似即刻 App 的卡片信息流」
这五个答案 = 施工图纸。写得越清楚，AI 越不会跑偏。

让 AI 帮你选技术方案

你对 AI 说我要做一个产品： 【把你的五个答案贴进来】 我不是程序员。请帮我： 1. 推荐最简单、最成熟的技术方案 2. 用我能听懂的话解释为什么选它 3. 生成项目的基础目录结构 4. 初始化 git 仓库

不确定选哪个？选第一个。成熟方案永远优于炫酷方案。

生成项目骨架

你对 AI 说方案可以。请按这个方案： 1. 创建完整的项目目录结构 2. 安装所有需要的依赖 3. 确保项目能启动、能看到空白页面 4. 启动开发服务器让我看看效果

看到页面（哪怕只是 Hello World），第一个里程碑就达成了。
立刻输入 /commit 保存。

04

Harness 篇

给 AI 立规矩 — 最关键的基础设施

这是整份手册最关键的基础设施章节。如果前三章是「选好工具、画好图纸」，这一章就是「搭好脚手架」。脚手架不搭或搭得不好，后面所有开发都会出问题。

为什么 Harness 如此重要

很多人想：「AI 不是很聪明吗？直接说需求不就行了？」

答案：AI 很聪明，但它没有记忆、没有标准、没有纪律。

想象你招了一个能力极强的员工，但是——他每天早上失忆，不记得昨天做了什么；没有员工手册，不知道规矩；没人检查质量；特别积极，你说改 A 他顺手把 B 也改了。

没有 Harness
每次对话重新介绍项目 AI 可能删你的数据 改完代码不知道有没有 bug 所有事都要你自己盯 AI 永远是新员工 重复操作每次都要手动说
有 Harness
AI 自动读取项目说明书 红线规则明确禁止 自动运行测试和安全扫描 专业角色各司其职 记忆系统让 AI 越来越懂你 常用工作流一键触发

六层结构

完整的 Harness 有六层，每一层解决一个特定的问题。先搭前三层就能启动项目，后三层在开发过程中逐步完善。

层名称解决什么问题
1项目说明书 (CLAUDE.md)让 AI 知道项目是什么
2行为规则 (Rules)让 AI 知道该怎么做
3自动检查 (Hooks)自动帮你守规矩
4AI 团队 (Agents)不同角色各司其职
5记忆系统 (Memory)让 AI 越来越懂你
6工作流模板 (Commands)常用操作一键触发

第一层：项目说明书 (CLAUDE.md)

每次你开新对话，AI 都会自动读取这个文件。相当于每天给员工做 briefing。

你对 AI 说请在项目根目录创建 CLAUDE.md，包含： 1. 项目简介（你用一段话描述） 2. 技术栈（AI 刚选的方案） 3. 当前目标（你的 MVP 功能） 4. 红线规则：下面这些事绝对不能做——
不写的后果：每次新对话都要从头说一遍项目背景。开了 20 个对话就重复 20 遍，而且一定会漏说。

红线规则模板（「不准」「必须」比「尽量」「建议」有效得多）：

数据安全+
· 不准把密码、API Key 写在代码里
· 不准删除数据库中已有的数据
· 不准在没有备份的情况下修改数据库结构
开发纪律+
· 每次只改一个功能，改完测试通过才能继续
· 新功能必须有对应的测试
· 改了代码必须能正常启动
· 只修改当前需求相关的文件，不要「顺手」改别的
界面要求+
· 所有页面必须在手机端可用
· 加载数据时必须有 loading 提示
· 出错时给用户友好提示，不能显示代码报错

第二层：行为规则 (Rules)

CLAUDE.md 是项目级说明书，Rules 是跨项目通用的行为标准——「公司级制度手册」。

规则类型解决什么问题示例
代码风格保持整洁统一文件不超过 400 行
测试要求保证功能不会坏覆盖率 80% 以上
安全检查防止泄露和攻击必须验证用户输入
Git 工作流代码保存有规范提交信息写清改了什么
开发流程做事有先后先计划→先写测试→再写代码
你对 AI 说请根据技术栈安装对应的开发规则集， 包括代码风格、测试要求、安全检查、Git 工作流。
不装的后果：AI 写的代码质量参差不齐。功能越多越难维护，最后不得不推倒重来。

第三层：自动检查 (Hooks)

前两层是「写在纸上的规矩」。Hooks 是自动执行的监督，在关键节点自动触发。

触发时机做什么相当于
AI 改完代码后自动格式化、类型检查编辑审校
提交代码前运行测试、扫描密钥出厂质检
对话开始时加载项目状态早会 briefing
对话结束时保存状态和经验下班交接
你对 AI 说请配置自动检查： 1. 每次编辑代码后自动格式化 2. 每次提交前自动运行测试 3. 每次提交前扫描有没有泄露密钥 4. 每次提交前做代码审查
不配的后果：质量全靠 AI「自觉」。有时它记得跑测试，有时忘了。直到线上出大 bug 才发现。

第四层：AI 团队 (Agents)

你可以让 AI 扮演不同角色。就像公司不会让同一个人既写代码又做安全审查——那样什么都做不精。

角色负责什么何时出场
规划师把大需求拆成可执行步骤做新功能之前
代码审查员检查代码质量和问题代码写完之后
测试工程师确保写了测试、测试能过开发过程中
安全官检查安全漏洞提交之前
架构师做技术方案决策遇到复杂选择时

这些角色是预置的，配好后 AI 会在合适时机自动使用。你不需要手动调用。

第五层：记忆系统 (Memory)

AI 默认没有记忆。每次新对话它都像刚入职的新人。记忆系统让你存下重要信息，AI 以后自动读取。

存偏好记住：以后所有列表页没有数据时都要显示「暂无数据」提示。已复制
存教训记住：不要 mock 数据库，用真实数据库测试。上次 mock 导致线上出了问题。已复制
存决策记住：我们的配色参考即刻 App，不要用太鲜艳的颜色。已复制
没有记忆的后果：你每次都在纠正同样的问题。第三次说了「按钮用蓝色」，第四次 AI 又给你搞个绿色。不是它学不会，是它根本不记得。

第六层：工作流模板 (Commands)

把重复操作打包成一键快捷方式：

命令做了什么相当于
/commit保存代码 + 生成提交信息游戏存档
/qa全面测试 + 修复 + 重新验证请 QA 验收
/review代码审查 + 列出问题技术主管过一遍
/verify测试 + 安全扫描 + 格式检查出厂质检全套

搭建节奏

项目启动时 第 1 天

搭第 1-3 层：写 CLAUDE.md + 安装规则 + 配 hooks。这三层让你可以安全地开始开发。

开发过程中 第 1-2 周

用起第 5-6 层：开始积累记忆（随时存）、熟悉 /commit /qa 等命令。效率越来越高。

项目复杂后 第 3 周起

了解第 4 层 AI 角色分工、更新 CLAUDE.md 补充新红线、积累更多模板。持续完善。

捷径：用 ECC 一键搭好第 2-6 层

好消息：第 2-6 层已经有人帮你做好了。

Everything Claude Code（ECC） 是一个开源的 Harness 框架，由 Anthropic 黑客松获奖者维护，10 个月以上实战打磨。

层自己搭用 ECC
第 1 层：CLAUDE.md自己写自己写
第 2 层：规则需要挑选安装预置 65 个，覆盖 13 种语言
第 3 层：Hooks一个一个配预置 25 个自动检查
第 4 层：Agents需要定义角色预置 28 个专业角色
第 5 层：记忆随用随存（两者一样）
第 6 层：命令/技能需要积累预置 91 命令 + 263 技能
类比：ECC 就像一辆装好了发动机、刹车和仪表盘的车。你只需要告诉导航目的地在哪（写 CLAUDE.md）。不需要懂发动机怎么转，但要知道方向盘、油门、刹车在哪——也就是下面的「什么时候该用什么」。

什么时候该用什么

六层装好之后，你不用记住内部结构。只需要知道：在不同场景下，触发哪个能力。

你在做什么该用的能力怎么触发
开始新功能规划师「我要做XX，先出计划」
写完了代码代码审查自动 / /review
功能做完了保存/commit
想全面测一遍QA 测试/qa
准备给别人看完整验证/verify
AI 做了不喜欢的事记忆「记住：以后不要XX」
AI 做了喜欢的事记忆「记住：以后都这样」
代码提交前安全扫描自动触发
AI 改完代码格式化+检查自动触发
出了 bug—「先查原因不要直接改」
你需要主动做的只有 4 件事：
① 说清楚需求  ② 审批计划  ③ 验收效果  ④ 遇到偏好/教训说「记住」

其他的（格式化、测试、安全扫描、类型检查、状态保存、角色调度）全部自动处理。

项目结构一览

你的项目my-project/ ├── CLAUDE.md ← 你写的（唯一需要亲手写的文件） ├── .claude/ │ └── settings.json ├── src/ ← AI 写的 ├── tests/ ← AI 写的 └── ...
ECC 帮你装好的（所有项目共享）~/.claude/ ├── rules/ ← 65 个行为规则 ├── hooks/ ← 25 个自动检查 ├── agents/ ← 28 个 AI 角色 ├── commands/ ← 91 个斜杠命令 ├── skills/ ← 263 个专业技能 └── projects/ ← 你积累的记忆

六个必踩的坑

不设 Harness 的代价——这些坑不是「可能」踩，而是「一定」踩：

坑表现预防
重复解释每次新对话从头说一遍写好 CLAUDE.md
质量过山车有时好有时烂ECC 规则模板
悄悄出错密钥泄露、测试没跑ECC 预置 hooks
顺手搞破坏你说改 A，它把 B 也改了红线 + 规则
同错犯三遍纠正过的问题下次还犯用「记住」积累记忆
改坏回不去全面崩溃每完成一步 /commit
05

沟通篇

怎么跟 AI 说话 — 最重要的一章

Harness 是一次性的，但沟通是每天的事。沟通质量直接决定产出质量。

好需求 vs 坏需求

坏需求
「做一个好看的页面」
AI 不知道你觉得什么叫好看
好需求
「做一个卡片列表页。每张卡片显示公司名称（大号加粗）、融资轮次（标签样式）、金额和日期。配色参考即刻 App。手机端一列，电脑端三列。」
坏需求
「加个搜索功能」
搜什么？搜索框在哪？结果怎么显示？
好需求
「在卡片列表页顶部加搜索框。用户输入公司名或赛道名，实时过滤下方卡片。无结果时显示'未找到相关信息'。」

需求四要素

做什么
功能描述
在哪里
哪个页面、什么位置
长什么样
视觉样子（可拿参考图）
怎么交互
点击/输入后发生什么

分解的艺术

一步到位
「做一个完整的用户注册登录系统，支持手机号、邮箱、微信登录，有验证码、找回密码、个人信息页。」
逐步推进
第 1 步 → 「先做邮箱注册」→ 验收 → 保存 第 2 步 → 「加登录功能」→ 验收 → 保存 第 3 步 → 「登录后跳首页」→ 验收 → 保存 第 4 步 → 「加退出按钮」→ 验收 → 保存

六句万能话术

点击可复制：

开始新功能我要做XX功能。请先出计划，不要直接写代码。已复制
听不懂用我能听懂的话解释一下，为什么要这么做？有没有更简单的方式？已复制
方向不对停一下。我的目标是XX，你现在做的好像偏了。重新理解一下我的需求。已复制
看效果跑起来让我看看效果。已复制
报 BugXX地方出了问题，表现是XX。帮我查原因，找到后先告诉我，不要直接改。已复制
做完了提交代码。提交信息写XX。已复制

黄金法则

说「是什么」，不说「怎么做」
指挥实现
「用 flex 布局做一个三列卡片网格」
描述结果
「做一个三列的卡片网格」

就像你不需要告诉装修工人用什么型号的螺丝。

06

开发篇

日常工作循环

每日标准流程

进入项目打开 VS Code 或终端
↓
告诉 AI 今天做什么「今天做 XX 功能」
↓
AI 出计划，你审批「可以」或「调整 XX」
↓
AI 开发自动写代码 + 测试
↓
验收：看效果「跑起来让我看」
↓
满意 → /commit
不满意 → 说哪里不对

功能开发四步法

第 1 步 — 描述需求+
示例我要做一个融资卡片的详情页。 用户点击卡片后跳到详情页，显示： - 顶部：公司名称（大号）、Logo - 基本信息：融资轮次、金额、日期、投资方 - 公司简介 - 底部：返回按钮 请先出实现计划，不要写代码。
第 2 步 — 审批计划+
不看技术细节，看这三条：

✓ 步骤数量合理吗？
✓ 涵盖了你说的所有内容吗？
✓ 有没有多余的？

看不懂就问：「第 3 步'创建路由'是什么意思？」
确认：「计划可以。开始做吧。」
调整：「把第 5 步去掉，不需要分享功能。」
第 3 步 — 观察过程+
正常信号："Test passed"、"Created file"、"Server running"

异常信号："Error"、反复改同一个文件、改了你没提到的文件

看到异常：「停一下，好像出了问题。告诉我怎么回事。」
第 4 步 — 验收+
「跑起来让我看看效果」→ 对照需求逐条检查。

满意 → /commit
不满意 → 说清楚哪里不对：「字号太小了，金额缺货币单位。」

什么时候该保存

该保存
功能做完并验收通过 Bug 修完并确认修好 配置调整确认生效
不该保存
功能做了一半 出了 bug 还没修好 还没验收
保存 = 游戏存档。每完成一关存一次。
07

质控篇

保证东西能用

三层质量保障

第一层：自动检查 自动

hooks 帮你做。代码格式化、安全扫描、基本测试，你不用管。

第二层：AI 自测 一句话

输入 /qa，AI 自动测试整个应用、报告问题并修复。

第三层：你亲眼验收 最重要

「跑起来让我看看效果」→ 自己像用户一样操作一遍。

验收检查清单

点击可勾选：

阶段性全面检查

在这些节点做一次：给老板演示之前、每做完 5 个功能、准备上线之前。

你对 AI 说请做一次全面质量检查： 1. 运行所有测试 2. 检查有没有安全问题 3. 检查所有页面在手机端的显示 4. 列出所有问题，按严重程度排序
08

急救篇

出了问题怎么办

你一定会遇到问题。这不是「万一」，而是「一定」。

问题分级

点击切换：

小问题
样式/文字
中问题
功能异常
大问题
跑不起来
直接说哪里不对：
「标题颜色不对，应该是深灰色。」
「卡片间距太大了，缩小一半。」
描述表现，先查原因再修：
「点击卡片没有跳转到详情页。」
关键一句：「先告诉我为什么，不要直接改。」
不要慌，你有存档。
「项目跑不起来了，看看最近改动哪里出了问题。如果短时间修不好，先回退到上一个能用的版本。」

最后手段：! git log --oneline -10 查看历史 → ! git checkout abc1234 -- . 回退

AI 出了状况

AI 卡住了 — 反复改同一个文件+
「停一下。你已经反复修改好几次了。 请告诉我：1. 你在解决什么问题 2. 试了哪些方法 3. 根本原因是什么 然后我们重新想方案。」
如果还卡住：「这个问题先放一放，记录到待办。先做别的。」
AI 跑偏了 — 改了你没提到的东西+
「停。我只要你做 XX。不要动其他文件。 请撤销刚才不相关的改动。」
预防：在 CLAUDE.md 红线规则里加「只修改与当前需求直接相关的文件」
对话太长，AI 变笨了+
信号：AI 重复做你否决过的方案，或者忘了项目是做什么的。

解决：退出后重新启动。新对话会自动读取记忆，不会「失忆」。

经验法则：一个对话做 2-3 个功能就开新的。
09

成长篇

从入门到熟练

三个阶段

跟着手册走 1-2 周

严格四步法：需求 → 计划 → 开发 → 验收。每个功能都看计划再动手。不确定就问。

有自己的节奏 3-4 周

简单改动可跳过计划步骤。开始积累反馈记忆，AI 越来越懂你。知道什么时候该拆分。

驾轻就熟 第 2 月起

能判断 AI 方案好坏。遇到问题知道怎么描述。开始建立自己的规则和模板。

让 AI 越来越懂你

每次交互都是训练的机会，点击可复制：

纠正偏好以后所有按钮都用圆角、蓝色背景白色文字。记住这个偏好。已复制
正面反馈这个页面的布局和配色很好，以后类似页面都参考这个风格。已复制
建立规则以后所有列表页，没有数据时都要显示友好提示。记住这个。已复制
++

附录

速查表

常用命令

你想做的事VS Code终端
启动✨ 图标claude
退出关闭面板/exit
保存代码/commit
全面测试/qa
代码审查/review
安全检查/verify
新开对话/clear
引用文件@文件名直接说

常用话术

新功能我要做XX功能。先出计划，不要写代码。已复制
审批可以，开始做。已复制
听不懂用我能听懂的话解释一下。已复制
看效果跑起来让我看看。已复制
报 bugXX的表现是XX，先查原因不要直接改。已复制
跑偏了停。只做XX，不要动其他东西。已复制
记住以后都XX。记住这个。已复制
回退回退到上一个能用的版本。已复制

每周健康检查

求助渠道

AI 本身就是你最强的技术专家。
Claude Code 自己的代码几乎都是 AI 写的。AI 能解决绝大多数技术问题——报错、bug、架构、性能优化。

AI 真正做不了的事：替你做最终决策。它可以给五种方案并分析利弊，但「选哪个」是你的事。
问题类型找谁
技术问题（报错、bug）先问 AI，它就是资深工程师
方案选择AI 给方案 + 利弊分析，你来拍板
产品方向AI 可以探讨分析，最终方向你决定
AI 工具本身的问题输入 /help
需要人类判断的决策找合伙人、老板或领域专家