直接答案
把第一次 Claude Code 会话设计成可回退、可验证的小闭环,而不是一次模糊的大型开发请求。
这篇内容解决什么问题
帮助新用户建立正确的 Claude Code 交互节奏和验收习惯。
选择边界清楚的第一个任务
首次任务应能在少量文件内完成,并有明确验证信号,例如修复一个带复现步骤的缺陷、为现有函数补测试或更新一段文档。不要用“优化整个项目”测试工具能力。
在项目根目录启动会话,并先确认 Git 工作区现状。Claude Code 能读取、编辑和执行命令,但未提交改动与用户现有修改仍需要被保护。
cd /path/to/project
git status --short
claude先让 Claude 解释项目,不急着编辑
先问入口、依赖关系、测试方式和与任务相关的既有模式。Claude Code 会按需读取文件,不需要把整个仓库一次性粘贴进提示词。
要求它引用具体文件和函数,并说明不确定项。这样你能在改动前校正错误理解,也能减少无边界探索占用上下文。
先不要修改文件。请定位这个项目的入口、测试命令和错误处理模式,
只阅读与用户登录流程有关的文件,并用文件路径说明结论。复杂改动先进入 Plan 模式
当任务涉及多个文件、接口选择或你不熟悉的模块时,用 Plan 模式把探索与编辑分开。计划应列出准备修改的文件、数据流、风险、测试和明确的不做事项。
对于改一个拼写或增加一条日志这类单点任务,计划成本可能高于收益,可以直接执行。关键是让规划强度与风险匹配。
- 01探索在 Plan 模式读取相关实现和测试,不写文件。
- 02计划列出改动点、边界和验收命令,请用户确认。
- 03实施退出 Plan 模式后按计划编辑。
- 04验证运行测试、构建或可视化检查,并报告证据。
把验收条件写进同一个提示词
Claude 在“看起来完成”时会停止。把复现步骤、边界案例和验证命令一起给出,它才能在同一轮里实现、运行检查并根据失败继续修正。
验收条件应可观察:测试通过、构建退出码为零、接口返回预期状态,或截图与参考图的关键差异被消除。
修复会话过期后登录失败的问题。先写一个能复现问题的测试,
再修改 token refresh 流程。只改 auth 模块,运行该模块测试,
最后列出修改文件、测试命令和结果;不要通过跳过断言掩盖失败。提交前审查差异与范围
任务完成后先看 Git 差异,而不是直接要求提交。确认没有覆盖原有未提交修改、没有无关格式化,也没有新生成的密钥或构建产物。
可以让 Claude 先总结差异,再用一个新上下文或子代理只检查正确性、回归和遗漏。独立审查者不应为追求“有发现”而提出与需求无关的重构。
git status --short
git diff --check
git diff偏离时尽早停止并回退
发现方向不对时按 Esc 中断并补充约束。连续两次纠正仍无效,通常说明上下文已被错误路径污染,适合 /clear 后用更精确的首条提示重新开始。
每次提示都会形成检查点,可用 /rewind 恢复对话或由 Claude 编辑工具产生的文件状态。但 Bash 命令和外部进程造成的修改不在文件检查点保障范围内,Git 仍是最终安全网。
/rewind
/clear官方来源与核验范围
本文以公开官方文档为事实依据;命令和配置可能随客户端版本变化,执行前请同时核对对应来源。
查看技术核验方法