用 Claude Code 大半年了，是时候再来一个阶段性总结了。
Vibe Coding：君子动嘴不动手
本身的定义：
“Describe the vibe, not the code.”
开玩笑的解释：你负责吹水，AI 负责实现。
其本质其实就是你表达意图，但不 care 实现细节；跟它对话式地迭代，你只管说要什么，怎么做是它的事。Claude Code 则是 A厂 给这套玩法配的工具。
上手简单
npm install -g @anthropic-ai/claude-code
claude两行命令，搞定。
关键组件
CLAUDE.md：给 AI 的 README
放仓库根目录，写上构建命令、代码风格、关键文件路径。README 给人看，这个给 AI 看。
啥时候用？永远。不写就上 Claude Code，等于招了新人啥也不交代就让干活。
Slash Commands：偷懒快捷键
/commit、/review-pr、/test，往 .claude/commands/ 扔 markdown 文件定义。把常用指令打个包，能自动化的绝不手敲。
Skills：复杂任务流水线
可复用的 prompt 模板，带工作流程。从 registry 装或自己写。步骤多容易漏的活儿，让 skill 帮你记着。
MCP Servers：外部服务接口
让 Claude 能调数据库、API、第三方服务。
Hooks：生命周期钩子
触发 shell 命令，比如提交前跑 lint。
其他
Plugins 扩展能力，Tools 干日常活，Subagents 处理专项任务，Marketplace 共享资源。
常见误区
误区一：长 Prompt = 好 Prompt
写 prompt 跟写小说似的，事无巨细，毫无重点，结果双方都傻逼了。
字多不等于说清楚。好 prompt 该简洁、具体、没歧义。消除歧义，不是堆细节。
误区二：银弹执念
沉迷找”最强 prompt”、“完美 MCP”、“终极 skill”，好像找到咒语就能搞定一切。
不要做梦了。工具是工具，不是方案。与其找银弹，不如练基本功。银弹并不存在。
误区三：忽视上下文
AI 编码，上下文是基础。
CLAUDE.md 随便写，文件结构不清晰，变量名随意取，不仅 Claude 不懂你代码，仨月后你自己能看懂不？
好上下文 > 巧 prompting。与其抠 prompt 字眼，不如整理代码结构、写好 CLAUDE.md、规范命名。底子打好，prompt 随便写。
工程实践：老规矩不能丢
有人觉得有了 AI 就完事大吉了，大错特错！
流程照走
需求 → 设计 → 开发 → 测试 → 文档AI 改变的是速度，不是规矩。跳过设计直接干？省掉测试直接上？AI 帮你更快堆屎山。
小步快跑
任务拆小，每个 story 控制在 20 分钟内。小任务好验证、好定位、迭代快。任务越大 Claude 越容易跑偏，写了 500 行才发现方向错，谁试谁知道。
从头干净
“先做出来，以后再重构。“然后呢？没有然后。技术债利滚利比信用卡狠。
Claude 生成代码快，堆屎山效率也成倍提升。不从头保持干净，一周后就是珠穆朗玛。每个迭代保持整洁，边做边文档，早重构勤重构。
文档原则
小而精，互相链接，别搞万字长文。代码是事实，链过去就行，别复制。搞个高层代码地图，标清入口和核心模块。
职责划分：谁拍板谁干活
Claude 干的：设计方案、低层次技术决策、写码重构、按你规矩来。
你定的：需求验收标准、领域模型、数据库 schema、框架选型、技术规则。
你拍板的：架构、项目结构、基础设施。
你提供的：llms.txt、示例代码、领域知识、辅助工具、遇到困难时的指点。
铁律
永远别让 Claude Code 定你的领域模型和数据库 schema。
这俩是系统逻辑的基础，别的都搭上面。让 AI 定这些，等于让装修师傅定户型。Claude 是好工人，但业主是你。
收尾
Claude Code 抢的不是饭碗，而是效率。
你出愿景、领域知识、判断力；它出苦力、速度、做牛马。
AI 取代程序员？取代的是只会把需求翻译成代码的低层次工作。有愿景、能判断、把得住方向，AI 只会让你更强。
前提是会用。不然神兵利器，砍的是自己。
还没上车的，抓紧。