7.2 安装与配置

快速安装（推荐）

如果你有仓库的管理员权限，最快的方式是在本地 Claude Code 里跑一条命令：

claude

进入会话后输入：

/install-github-app

它会引导你完成整个安装流程：

1. 打开浏览器，引导你安装 Claude GitHub App 到指定仓库
2. 自动生成 workflow 文件
3. 提示你添加必要的 Secrets

整个过程大概 5 分钟。

⚠️ 这个方式只支持直接使用 Anthropic API（Claude Pro/Max/Teams）的用户。如果你的公司通过 AWS Bedrock 或 Google Vertex 接入，需要用下面的手动方式。

---

手动安装（适合企业用户或快速安装失败时）

第一步：安装 Claude GitHub App

访问：github.com/apps/claude

点击 Install，选择要安装到的仓库（可以选择特定仓库，不必给全部仓库权限）。

App 需要以下权限：

• Contents：读写仓库文件（用于修改代码和提交）
• Issues：读写 Issue（用于响应 @claude 提及）
• Pull requests：读写 PR（用于创建 PR 和发评论）

第二步：添加 API Key Secret

在你的 GitHub 仓库页面： Settings → Secrets and variables → Actions → New repository secret

添加：

• Name: ANTHROPIC_API_KEY
• Value: 你的 Anthropic API Key（在 console.anthropic.com 获取）

第三步：创建 Workflow 文件

在仓库里创建 .github/workflows/claude.yml：

name: Claude Code

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request:
    types: [opened, synchronize]

permissions:
  contents: write
  issues: write
  pull-requests: write

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

提交这个文件，安装就完成了。

---

验证安装成功

在任意 Issue 或 PR 的评论里输入：

@claude what files are in this repository?

如果安装正确，几秒钟内会看到 GitHub Actions 开始运行，然后 Claude Code 在评论里回复仓库的文件列表。

如果没有反应，检查：

1. GitHub App 是否已安装到这个仓库
2. ANTHROPIC_API_KEY Secret 是否添加正确
3. Workflow 文件是否在正确路径（.github/workflows/）
4. Actions 是否在仓库设置里启用（Settings → Actions → General）

---

配置 CLAUDE.md 让它了解你的项目

GitHub Actions 里的 Claude Code 每次运行都是全新的环境，没有任何项目记忆。

CLAUDE.md 在这里尤其重要——把你的代码规范、测试命令、架构说明写进去，它每次运行都会先读取，不会犯低级错误。

特别建议加上这几条：

## GitHub Actions 行为规范

- PR 描述要包含：改了什么、为什么改、测试了什么
- commit message 遵循 Conventional Commits
- 新功能必须有测试，测试通过后才能 merge
- 不要修改 package-lock.json 以外的 lock 文件

---

下一节，配置自动代码审查。