跳到主要内容

Claude Code 快速开始

这页适合什么场景​

  • 你想把终端和仓库本身当成主入口。
  • 你愿意先写清边界、命令和验收，再让 agent 动代码。
  • 这次任务更像 repo pairing，而不是平台委派或 IDE 工作台协作。

前置条件​

  • 你已经决定把终端当成主入口，而不是把它当 IDE 的补位气泡。
  • 仓库里至少有一个能稳定运行的验证命令。
  • 你已经看过 Claude Code 概览，知道它更适合仓库内闭环。

20 分钟交付目标​

第一次 quick start 不求“改得多”，只求：

  • 在仓库根目录把任务合同写清楚。
  • Claude Code 先复述边界，再做一轮最小改动。
  • 你手里有命令结果和一段简短交付说明。

推荐第一条任务​

第一次建议优先选：

  • 修一个已知 bug
  • 补一条缺失测试
  • 做一次不改变行为的小重构

第一次不要选：

  • 需求仍在变化的新 feature
  • 需要大量 UI 比对和人工确认的任务
  • 没有任何验证命令的仓库

步骤​

第 1 步：在仓库根目录固定边界​

先把本次任务写成 4 行：

任务：今天只做什么
范围：只改哪些目录
不要做：这次明确不碰什么
验收：要跑什么命令

如果你还没有规则文件，先补 仓库规则文件体系。

第一次最好再补一行“交付物”，例如“输出一段变更说明和命令结果”。

第 2 步：让 Claude Code 先复述，再执行​

第一次不要直接要求“帮我全做完”。先要求它：

  1. 复述任务和边界。
  2. 给出最小计划。
  3. 只做一轮最小改动。
  4. 回报真实命令结果。

可以直接这样说：

请先复述任务、范围、禁止修改区和验收命令。
然后给出最小计划，只推进第一轮最小改动。
完成后必须回报真实命令结果，并总结改了什么、没改什么、还有什么风险。

第 3 步：把第一次闭环跑通​

优先选这些任务：

  • 修一个已知 bug
  • 补一条缺失测试
  • 做一次不改变行为的小重构

如果今天任务偏维护，直接搭配 Bugfix / Refactor / Test Runbook。

第 4 步：把结果收成一段可复用说明​

第一次 quick start 不要只留下 diff。至少收口这三样东西：

  • 改了什么
  • 跑了什么命令
  • 哪些风险或未完成项仍然存在

验收清单​

第一次成功的标准不是“它写了很多代码”，而是：

  • 任务边界没有失控。
  • 你真的执行了验证命令。
  • 你能给出一段结果说明，而不是只给 diff。
  • 你能说清这次为什么适合终端主入口。

常见失误​

  • 没写任务合同就直接开跑，结果 agent 自己补全边界。
  • 只看改动，不看命令结果，最后不知道仓库到底有没有验证过。
  • 第一次就选长链路 feature，导致终端闭环变成漫长对话。
  • 把 Claude Code 当成平台层工具使用，期待它自动解决 PR 流和多人交接。

下一步​

来源​