从「能看懂」到「能说清」
前两节补齐了终端底子。现在到了关键一步:和 Claude Code 正式对话。
和聊天框最大的不同:你说的话会成为它动手的依据。说得越具体,结果越接近你要的。
todo-app 目录——这是今后无数对话的「标准开场」。学会怎么把话说清,后面实现 todo 才顺利。第一次对话:看它在做什么
在项目目录里启动:
claude
输入这一句试试:
帮我看看当前目录有哪些文件,并简单说明每个文件是做什么的
你会看到 Claude Code 的操作轨迹:列出目录 → 读文件 → 归纳说明。这一步你体验到了「它能动手」,而不只是回文字。
描述需求的三个要素
想让 Claude Code 干对活,把话分三部分说清楚:
- 目标:你要什么结果
- 范围:涉及哪些文件 / 哪里
- 约束:别碰什么 / 用什么技术 / 格式要求
对比两个说法:
❌ 模糊:「帮我优化一下这个代码」 ✅ 清晰:「把 src/app.js 里的登录校验抽成一个独立函数,加错误处理,别的文件不要动」
第二句有目标、有范围、有约束,Claude Code 就能精准干活,少返工。
一个实战演示
假设你项目里有个 calc.js,里面有个 bug。你这样对 Claude Code 说:
看看 calc.js,我算 7 除以 0 时结果不对,帮我找到原因并修复。
顺便解释一下问题出在哪。
它会:读 calc.js → 定位问题 → 修复 → 运行验证 → 给你解释。你全程只负责「描述问题」和「验收结果」。
学会审查,而不是全盘接受
AI 也会犯错。它改完,你要:
- 看它改了什么(对比改动)
- 确认没越界(只动了你让它动的)
- 自己跑一遍验证结果
「描述 → 执行 → 审查 → 迭代」这个循环里,审查这一步是你的责任。
打断与纠正
它跑偏了怎么办?别慌:
- 直接说:在输入行输入「等一下,这里不对,应该……」
- 它会停下,听你新的指令
- 反复纠正很正常,这是迭代的一部分
落地练习:让 Claude 规划 todo
用上「目标 / 范围 / 约束」三要素,在 todo-app 目录里启动 claude,对它说:
目标:帮我把这个目录做成一个终端待办工具。
范围:只添加新代码,不要动目录里已有的其他东西。
约束:用 Node.js 写,先只做"添加待办"这一个命令,其余先不做。
观察它:是先去读目录现状,还是直接开始写?好的表现是先了解、再动手,而不是一上来就乱写。
怎么判断做对了?——你能看到它先读目录/文件(操作轨迹),然后才动手;以及它没有越界乱改东西。至于代码对不对,我们留到第 4 模块正式验收。
卡住了怎么办? 它一下写了一大堆?别慌,说「先停下,只要添加这一个功能,别的删掉」。它没先读目录?直接说「先读一遍当前目录再动手」。
常见坑:只给「目标」,不给「范围和约束」
新手最容易犯的错,是只说「帮我做个 todo 工具」,然后让 AI 自由发挥。
结果往往出来一堆你不需要的东西,或用了你不熟的技术。目标、范围、约束三个都要给——范围防止它越界,约束防止它跑偏到你不想要的技术栈。给得越全,返工越少。
小结
- 描述需求 = 目标 + 范围 + 约束
- 说具体,它才能干对
- 它动手、你审查,循环迭代
- 跑偏就打断纠正,很正常
- 我们已经让 Claude 规划了 todo 的第一步
下一模块进入「斜杠命令全掌握」,给你一套提速的快捷键。