这篇讲什么
从”没用过 Claude Code”到”提交第一个 reviewed 重构 PR”的直线路径，给已经会写代码、但还没把活交给 agent 的人。痛点：很多人装好就让它”把仓库清理一下”，拿到 40 文件 diff 没法 review，对工具失去信任。这篇强行让你慢一点——装好、写紧 CLAUDE.md、跑 planning prompt、按命名小步执行——让第一次 session 结束时是一个干净小 PR，而不是后悔。
本文涉及的工具 / 概念：
- Claude Code: Anthropic 的命令行 AI 编程 agent，能在你的终端里读、写、运行项目代码。
- CLAUDE.md: 项目根目录的记忆文件，Claude Code 自动加载，相当于系统 prompt。
- Plan mode / planning prompt: 让 agent 先出计划再动代码，方便你在动 diff 前就审意图。
这篇适合谁看
熟悉命令行的开发者。如果你已用过 Copilot 或 Cursor，但想要 agent 协调的多步改动，这篇尤其有用——Claude Code 的心智模型完全不同。只想在浏览器里反复改原型不用终端，改看 Claude Artifacts 进阶工作流。
什么时候适合用
改动跨多文件、要跑测试、或 agent 需要先读仓库再改时，用 Claude Code。一次补全就够请先看 agent vs 自动补全 再决定。强匹配：跨文件改名、依赖升级、给老代码补测试、脚本化重构。
开始前准备
- 项目本地能跑：测试过、lint 过、能 build。Claude Code 会放大仓库现状——包括坏的地方。
- 第一次选小而低风险的目标：给糟糕名字的函数改名、给一个模块加测试、把一个文件迁到新模式。不要整库。
- 把当前工作 commit 或 stash 掉。你要一条干净基线，让 agent 的 diff 一眼看清。
- CLAUDE.md 写好（模板见步骤 2）。哪怕 20 行也能显著改善第一次 session 的质量。
具体步骤
- 按官方文档安装（一般
npm install -g @anthropic-ai/claude-code）。claude --version验证。 - 项目根写 CLAUDE.md，写明代码库信息——参考 AI 编程上下文管理。最低限度：语言/框架、测试命令、lint 命令、禁碰路径。
- 跑
claude，先要计划：为 src/auth.ts 写重构计划——把 JWT 校验抽成独立模块。先别写代码；列出要改的文件、要新建的文件、要加的测试。陌生仓库先做 AI 代码库导览工作流，搞清楚到底在重构什么。 - 认真审计划。看 agent 是否要碰不该碰的文件、漏了测试更新、或范围 creep。直接反推：“别碰
database.ts，不在范围。” - 分步执行：每次一个改动，每步跑测试，过了再 commit。安全的最小单位是干净 commit，不是整个任务。
- session 结尾让 agent 总结改了什么、还有哪些没完成。把这段贴进 PR 描述。
第一次实操怎么跑
- 选一个文件里一个明显有味道的函数——太长、名字不清、没测试。
- 让 Claude Code 先为现有行为加测试。跑一遍确认通过。
- 再让它做一个命名好的小重构——“拆成 validate / transform / save 三段”。再跑测试，仍应通过。
- Commit。记下哪里顺、哪里出乎意料、哪些 prompt 想留。
完成后检查
- 每个 agent 步骤后跑一次测试套件。干净通过是改动是否安全的唯一客观信号。
- 前三次 session 逐行读 diff。形成信任后才能略读，之前别略。
- 留心 agent 偷偷改范围外文件——和 main 对 diff 确认影响面。
- 每次 session 后重读 CLAUDE.md，把刚才希望提前写好的约束补上。
怎么复用这套流程
- 把每次成功任务当模板：保存 planning prompt、加过的约束、测试命令。
- 维护一份自己的”好用句式”：「先别写代码」「原地修改不要重建」「列出范围外文件」。
- CLAUDE.md 当活记忆养——agent 犯同样的错两次，就加一条禁令。
- 每隔几周用同一 prompt 跑别的文件，看模型行为漂移。
建议的操作流程
CLAUDE.md → planning prompt → 审计划 → 一小步 → 跑测试 → commit → 重复。强制慢下来，agent 才最快。
FAQ
- Claude Code 和 Cursor 有什么区别？: Cursor 是带 AI 内联的 IDE；Claude Code 是驱动 shell 的 agent。体感差异大，参见 Claude Code vs Cursor。
- 没 CLAUDE.md 能用吗？: 能，但真项目质量掉得快。20 行也比没有强。
- 会跑破坏性命令吗？: 默认会先问；不要无脑同意，每条都看。
- agent 卡住了怎么办？: 取消、缩范围、重启。别狂点 retry，见 Claude 重试触发频控。
- 实际成本？: 真实重构按消费档大致每次 $1-5；很多 token 花在反复读已读过的代码。
容易踩的坑
- 跳过计划直接要代码——拿到一坨没法审的 diff。
- 没 CLAUDE.md——agent 每次重新发明你的项目约定和风格。
- 让它直接提交——再好的 diff 也藏一行静默的错。
- 任务给太大（“整个模块重构”）而不是命名好的小步。
- agent 卡在「Claude is at capacity」就不停 retry——会让冷却时间更长（Claude 重试触发频控）。
- 把 Claude Code 的输出当作架构权威——它执行快，但”该不该这么做”不够稳。
相关阅读
标签: #AI 编程 #教程 #Claude Code