Claude Code GitHub Actions：触发与认证怎样接起来

什么时候用

• 你要在 GitHub issue 或 PR 工作流里接入 Claude Code，并且有仓库管理员权限。[1]

什么时候不用

• 仓库使用其他托管平台，或你尚未确认可使用的认证方式和仓库权限。[1]

先说明什么时候运行

官方交互示例使用 issue_comment 和 pull_request_review_comment 的 created 事件，并以评论中包含 @claude 作为作业条件。动作本身也检查触发短语。不要只看到 action 名称就假设每个 PR 都会自动评审；先核对事件、if 条件与 prompt。[1]

把 GitHub 身份与模型认证分开

手动路径包括安装 Claude GitHub App、添加认证 secret、放入 workflow。官方说明可用 ANTHROPIC_API_KEY，或通过 claude setup-token 生成订阅 OAuth token 并用 CLAUDE_CODE_OAUTH_TOKEN；两种 secret 对应不同 action 输入。哪一种适用，应按自己的账户与组织规则确认。[1]

按依赖顺序核对 workflow

• 仓库副本：actions/checkout 在 Claude action 前执行，让任务能看到仓库和本地技能文件。
• 动作入口：当前官方示例引用 anthropics/claude-code-action@v1，采用前再次核对官方示例与版本。
• GitHub 权限：官方默认 App 认证要求 id-token: write；actions: read 用于读取 CI 结果。其他权限按任务及官方 workflow 对照。
• 输出位置：明确预期是同一 issue/PR 评论、文件变更还是流水线结果，验收时读取对应位置。

[1]

首次运行怎样验收

先在受控仓库里确认 workflow 被预期事件启动，再看 checkout、认证和 action 步骤的日志。启动不等于任务成功；还要核对输出是否回应指定任务，以及文件差异是否有可复查依据。仓库不是 github.com 时，官方 /install-github-app 快速安装流程会退出，应改读对应平台的官方接入文档。[1]

本页仅完成官方来源核验，没有安装 App、保存密钥、修改 workflow、调用模型或发布评论，也没有证明某个仓库可用。实际 CI 运行与模型费用应在你首次执行时单独记录。[1]