Claude Code 快速开始

可复现实践

用完整证据链完成一个有边界的小改动

通过小型仓库任务练习探索、计划、编辑、验证和审查，首次使用不授予宽泛自动化权限。

准备

• 可信仓库，且 git 状态干净或已理解。
• Claude Code 认证正常，已知项目测试命令。
• 任务只有一个可观察结果，例如一个失败测试或一条校验规则。

执行步骤

1. 记录基线

   打开会话前保留现有修改并确认项目命令。

   git status --short
   git diff --check

2. 从只读计划开始

   要求列出相关文件、最小改动、风险和准确验证命令。

   claude --permission-mode plan

3. 批准窄范围实现

   只有文件范围和验收检查正确时才退出 plan mode，并请求有边界的修改。

4. 在叙述之外验证

   运行仓库测试并检查真实 diff，不把成功摘要当作证据。

   git diff --check
   git diff --stat
   # 在这里运行项目自己的定向测试

预期结果

目标行为改变，无关文件未受影响，指定项目检查通过或暴露明确的第一个失败。

验证

• 把最终 diff 与原验收条件逐项比较。
• 至少运行一个仓库自己的定向测试或构建命令。
• 检查 git status，发现生成文件或意外文件。

失败处理

清理或回退

• 审查后只拒绝或手动恢复本任务 hunk，不删除无关工作区修改。
• 再次尝试时保留失败命令和第一个可操作错误。

边界与不适用场景

• 测试、所有权或回退不明确时，不要把生产仓库作为首次练习。
• plan mode 降低写入风险，但不能替代备份、审查和权限策略。