GitHub Actions 集成

是什么

Claude Code GitHub Actions 将 AI 自动化能力引入 GitHub 工作流。在 PR 或 Issue 中 @claude 提及即可触发 Claude 分析代码、创建 PR、实现功能或修复 Bug，同时遵循项目的 CLAUDE.md 规范。

核心机制

触发方式：在 PR 或 Issue 评论中 @claude 提及，Claude 自动分析请求并执行相应操作。

快速安装：在 Claude Code CLI 中运行 /install-github-app，引导完成 GitHub App 安装和密钥配置（仅支持直接 API 用户）。

手动安装步骤：

1. 安装 Claude GitHub App（需要 Contents/Issues/Pull requests 读写权限）
2. 在仓库 Secrets 中添加 ANTHROPIC_API_KEY
3. 将 workflow 文件复制到 .github/workflows/

Bedrock/Vertex AI 支持：不能使用 /install-github-app，需手动配置 workflow，通过 IAM 或 Workload Identity 认证。

v1.0 重大变更（从 beta 升级）：

• @beta → @v1
• 删除 mode: "tag" 或 mode: "agent"（自动检测）
• direct_prompt → prompt
• max_turns、model 等移入 claude_args

关键细节

• GitHub App 权限：Contents（读写）、Issues（读写）、Pull requests（读写）
• 默认模型：Sonnet；使用 Opus 4.7 需配置 model 参数
• 仓库管理员才能安装 GitHub App 和添加 Secrets
• Action 仓库：github.com/anthropics/claude-code-action

关联

• code-review — 自动 PR 审查（无需 @claude 触发）
• gitlab-ci-cd — GitLab 的类似集成
• headless — 非交互式运行模式

实践要点

• 测试安装：在 Issue 或 PR 评论中 @claude 触发
• 代码在 GitHub runners 上运行，不离开 GitHub 基础设施
• 可在 workflow 中自定义 claude_args 传递 CLI 选项
• 对于自动化程度高的场景，考虑配合 --dangerously-skip-permissions 使用（需谨慎）