Claude Code 教程系列

做完第一个可回看的 Claude Code 任务

先说清文件和校验,留好撤回路径,再读 diff。本章不上 MCP,也不改生产配置。

先准备什么

用练习仓库或你熟悉的小项目。确认 git status 干净,或你知道怎么撤回。

在项目目录启动 claude。若还在登录或 PATH 上打转,先回安装章或排错章。

为本轮定一条禁令:不提交、不通推送、不碰密钥文件。

  1. 选练习仓库并进入。
  2. 确认能撤回。
  3. 写下本轮绝不能做的事。

循环:提问、观察、审阅

用一段话说明任务:文件、校验命令、禁令。若客户端提供计划模式,第一天就用。

看它打开哪些文件。一旦走进密钥或 vendor 噪音,停。

成功标准是你能看懂的 diff,不是一段自信的总结。

  • 一件事,一条校验命令。
  • 离开约定文件就停。
  • 每个 hunk 都读。
示意图:提示、工具、diff、校验构成第一次任务循环。
成功是你能讲清的 diff,不是很长的聊天。

把第一句提示写无聊一点

好例子:给文件 Y 里的函数 X 补单元测试,跑测试命令,不要提交。

坏例子:把应用变得更好,或重构一切看起来乱的东西。

仓库不明显时,写上语言和包管理器。

  • 点名文件。
  • 点名校验命令。
  • 重复禁令。

会话里你会看到什么

终端会话会显示工具调用、文件编辑和提问。心里没底时,读操作可以批得松,写操作批得紧。

斜杠命令和快捷键会随版本变。信客户端里的帮助,不要信上个季度的截图。

  • 批准前先读工具名。
  • 坏循环尽早打断。
  • 不要贴 .env 来解释失败。

像同事一样审

先 git diff,再跑你点名的校验命令。它没跑测试,你自己跑。

若 diff 夹带顺手格式化,请它改小。

然后才决定保留文件。保留不等于提交,除非你说了要提交。

  1. 读 diff。
  2. 跑校验命令。
  3. 保留或撤回。

无头模式可以再等

CLI 也能非交互地接一段提示给脚本。第一周更适合在交互会话里看每一次工具调用。

若已经需要流水线,从当天 CLI 参考抄参数,不要默记本段。

  • 先在交互里学会。
  • 信任提示后再写脚本。
  • 命令行不要带密钥。

第一个任务失败时

目录错了:看 doctor 和 pwd。二进制错了:which claude。

模型乱跑:缩小文件列表。测试红了:读失败,不要把同一句提示连试三次。

登录打转属于排错,不属于把提示写得更长。

  • 检查目录和二进制。
  • 把任务缩小。
  • 撤回后再写更小的请求。

第一任务的错法

第一次改文件的同时要求提交。

因为总结听起来很稳就跳过 diff。

  • 第一天就上生产仓库。
  • 第一小时就上 MCP。
  • 没有撤回路径。

做到这样就够了

你留下或撤回了一段 diff,并且自己跑过校验命令。

  1. 练习仓库。
  2. 禁令说出口。
  3. diff 读过。
  4. 校验跑过。
  5. 除非你选择,否则不提交。

下一章:写 CLAUDE.md

下一章写 Agent 每次会话都应看到的短说明书。

技能继续等。先把一个循环做稳。

常见问题

第一个任务必须是功能吗?

不必。一个测试、一次 lint 修复,或解释一个目录就够。

可以用计划模式吗?

你的构建如果提供,就用。短计划胜过突然重写。

它改错文件怎么办?

停、撤回、再点名文件。不要在脏树上叠第二次重写。

交互还是脚本?

第一周用交互。

可以放开所有工具吗?

可以,但你学到的更少。在信任仓库之前,写操作请手批。

两个仓库一起开?

先在一个练习仓库里跑完一个循环。

截图能发到公共频道吗?

有令牌或客户数据就不要。doctor 输出也可能含路径。

本系列全部章节

  1. 1. Claude Code 是什么(以及不是什么)
  2. 2. 按 2026 年的方式安装 Claude Code
  3. 3. 做完第一个可回看的 Claude Code 任务
  4. 4. CLAUDE.md 与项目说明书
  5. 5. 能复用的 Claude Code 技能
  6. 6. 给 Claude Code 接一台 MCP 服务器
  7. 7. Claude Code 和 OpenAI Codex 怎么选
  8. 8. Claude Code 排错