第 02 模块 · 3 节

与 Claude 的第一次对话

《Claude Code 基础入门》02 终端与命令行基础 · 本节时长 26 分钟

从「能看懂」到「能说清」

前两节补齐了终端底子。现在到了关键一步:和 Claude Code 正式对话

和聊天框最大的不同:你说的话会成为它动手的依据。说得越具体,结果越接近你要的。

贯穿项目这一节我们就会第一次开口,让 Claude Code 帮我们看一眼 todo-app 目录——这是今后无数对话的「标准开场」。学会怎么把话说清,后面实现 todo 才顺利。

第一次对话:看它在做什么

在项目目录里启动:

claude

输入这一句试试:

帮我看看当前目录有哪些文件,并简单说明每个文件是做什么的

你会看到 Claude Code 的操作轨迹:列出目录 → 读文件 → 归纳说明。这一步你体验到了「它能动手」,而不只是回文字。


描述需求的三个要素

想让 Claude Code 干对活,把话分三部分说清楚:

  1. 目标:你要什么结果
  2. 范围:涉及哪些文件 / 哪里
  3. 约束:别碰什么 / 用什么技术 / 格式要求

对比两个说法:

❌ 模糊:「帮我优化一下这个代码」 ✅ 清晰:「把 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 自由发挥。

结果往往出来一堆你不需要的东西,或用了你不熟的技术。目标、范围、约束三个都要给——范围防止它越界,约束防止它跑偏到你不想要的技术栈。给得越全,返工越少。


小结

  1. 描述需求 = 目标 + 范围 + 约束
  2. 说具体,它才能干对
  3. 它动手、你审查,循环迭代
  4. 跑偏就打断纠正,很正常
  5. 我们已经让 Claude 规划了 todo 的第一步

下一模块进入「斜杠命令全掌握」,给你一套提速的快捷键。