它到底是什么

/install-github-app 是 Claude Code 的会话内 Slash 命令,用于以向导式交互将 Anthropic 官方 Claude GitHub App 安装到指定仓库。官方 quickstart 将其描述为「引导你完成 GitHub App 的安装与所需 Secrets 的配置」(guide you through setting up the GitHub app and required secrets),从而让仓库中的 PR / Issue 评论者可以通过 @claude 触发 AI 自动化流程。workflow 文件的创建属于手动安装路径的步骤(见下文对比),向导本身不保证自动生成 workflow。

平台限制(来自官方文档原文):

• 必须是目标仓库的 repository admin
• 仅适用于直接使用 Anthropic API 的用户;使用 Amazon Bedrock 或 Google Vertex AI 的用户无法使用此命令,须走手动配置流程

怎么触发 / 怎么使用

在 Claude Code 终端会话中直接输入:

/install-github-app

命令不接受额外参数,整个安装过程以交互式向导形式引导完成。

向导流程

1. Claude Code 生成并打开 GitHub App 安装链接
2. 点击 Install 按钮,选择要集成的仓库
3. App 获取以下仓库权限并请求确认:
   • Contents: Read & Write
   • Issues: Read & Write
   • Pull requests: Read & Write
4. 向导引导添加 ANTHROPIC_API_KEY 到仓库 Secrets

官方 quickstart 仅承诺向导完成 GitHub App 安装 + 所需 Secrets 配置。workflow 文件(.github/workflows/claude.yml)的添加是手动安装路径的步骤(从 examples/claude.yml 复制),不在向导的明确保证范围内;如向导未自动生成,需按手动路径自行添加 workflow 文件后,@claude 触发词才会生效。

验证安装

在任意 Issue 或 PR 评论中发送:

@claude 你好,能看到这条评论吗?

保存 / 配置 / 集成

安装向导引导完成 GitHub App 安装与 Secrets 配置后,以下内容会被写入或需要手动配置:

仓库 Secrets(Settings → Secrets and variables → Actions):

workflow 文件: 按手动安装路径,需在 .github/workflows/claude.yml 添加 workflow(从 examples/claude.yml 复制),基础结构如下:

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

行为个性化: 在仓库根目录创建 CLAUDE.md,定义代码风格、审查标准等;Claude 在执行任务时会遵循该文件的指引。

运行约束 / 限制

跟同类原语对比

经典使用场景

• 首次为仓库接入 Claude GitHub Actions,用向导完成 App 安装 + Secret 配置(workflow 文件按需走手动路径添加)
• 在 PR 评论中通过 @claude implement this feature 触发 Claude 自动提交代码变更
• 通过 @claude fix the TypeError in the user dashboard 让 Claude 直接修复 Issue 中描述的 bug

常见坑

1. macOS Keychain 凭证缺失导致命令消失
   错误信息为 security: SecKeychainSearchCopyNext: The specified item could not be found in the keychain.。根因是 Claude Code 本地 Keychain 条目丢失或无法访问,命令随即从界面隐藏。该 issue 未提供官方解决方案(标注为 "None explicitly provided");仅有推测认为重新鉴权或许有帮助,属未经证实的 workaround,不保证有效。(来源:GitHub issue #1639,影响版本 1.0.11,平台 macOS)

2. API Key 硬编码进 workflow 文件
   官方文档明确警告:永远不要将 ANTHROPIC_API_KEY 直接写入 workflow YAML。必须使用 ${{ secrets.ANTHROPIC_API_KEY }} 引用,否则 Key 会随仓库历史公开。

3. Bedrock / Vertex 用户误用命令
   若账号通过 Amazon Bedrock 或 Google Vertex AI 接入 Claude,/install-github-app 向导无法完成,需改用手动配置路径并创建自定义 GitHub App。

4. @claude 无响应
   常见原因:GitHub App 未正确安装、workflow 未启用、Secrets 名称拼写错误、或评论用的是 /claude 而非 @claude。

来源

• Commands — Claude Code 官方文档
• Claude Code GitHub Actions — 官方文档
• GitHub Issue #1639: GitHub App Installation Command Disappeared