使用 Claude Code CLI

本单元目标

学完本单元后，你将能够熟练使用 Claude Code CLI 完成从分支创建、代码提交、PR 发起、评审响应到合并的完整生命周期管理，并能在命令行中直接调用 Claude 进行代码审查与变更说明生成。

概念讲解

Claude Code CLI 本质上是将 Claude 的代理能力嵌入你的终端工作流。它不是一个简单的命令包装器，而是一个具备上下文感知能力的编程代理——它能读取你的 Git 状态、diff 内容、仓库结构，甚至理解你当前分支与目标分支之间的关系。

以 PR 生命周期为例，传统流程中你需要手动执行 `git add`、`git commit`、`git push`，然后打开浏览器创建 PR，再根据 CI 结果反复修改。而 Claude Code CLI 将这些步骤抽象为一次会话：你告诉它"把当前改动整理成一个针对登录模块修复的 PR"，它会自动分析 diff、识别改动模式、生成符合仓库规范的 commit message、推送到远端，并调用 GitHub API 创建包含摘要和测试建议的 PR 描述。

关键在于理解 CLI 的"状态感知"特性。它不像普通脚本那样被动执行命令，而是主动理解你的意图。比如当它发现当前分支有未提交的调试代码时，会主动询问是否排除；当它检测到 PR 描述与代码改动不一致时，会提示你修正。这种交互模式要求你具备一定的 Git 和 GitHub 基础，但对 PR 流程的机械性操作则可以完全交给 CLI 处理。

实操演练

1. 在项目根目录运行 `claude` 进入交互模式，输入"查看当前分支与 main 的差异"，CLI 会自动执行 `git diff main...HEAD` 并生成结构化摘要。
2. 输入"为这些改动创建提交，使用 conventional commits 规范"，CLI 会分析 diff 内容，生成类似 `fix(auth): correct token refresh logic` 的提交信息，并在你确认后执行 commit。
3. 输入"推送并创建 PR，标题为'修复登录令牌刷新问题'，描述中附带测试建议"，CLI 将执行 push、调用 GitHub API 创建 PR，并返回 PR 链接。
4. 当 CI 失败时，输入"查看 CI 错误并给出修复方案"，CLI 会拉取 CI 日志、定位失败原因，并直接在终端中提供可执行的修复代码。
5. 输入"合并这个 PR 并删除远程分支"，CLI 确认合并条件（如 review 通过）后执行 merge 和 branch deletion。

练习任务

1. 在任意开源仓库的 fork 中，使用 Claude Code CLI 完成一次完整的 bug 修复流程：创建分支、提交改动、推送并创建 PR，要求 commit message 符合 Conventional Commits 规范。
2. 模拟一次 PR 评审场景：在已有 PR 的对话中调用 CLI 的 `review` 命令，生成包含代码质量、潜在缺陷和优化建议的评审意见，并输出为 markdown 文件。