Claude Code GitHub Actions 将 AI 驱动的自动化带入你的 GitHub 工作流。只需在 PR 或 Issue 中提及 @claude，Claude 就能分析代码、创建 Pull Request、实现功能并修复 Bug，同时遵循你的项目规范。
为什么使用 Claude Code GitHub Actions？
- 即时创建 PR：描述需求，Claude 生成包含所有必要更改的完整 PR
- 自动化代码实现：一条命令将 Issue 转化为可工作的代码
- 遵循项目规范：Claude 会遵��
CLAUDE.md中的指导原则和现有代码模式 - 简单配置：通过安装向导和 API key 在几分钟内完成配置
- 默认安全：你的代码只在 GitHub 的 Runner 上运行
快速配置
最简单的方式是通过 Claude Code 终端完成：
bash
# 在终端中打开 Claude Code
claude
# 运行安装命令
/install-github-app该命令会引导你完成 GitHub App 安装和必要的 Secret 配置。
注意：你必须是仓库管理员才能安装 GitHub App 和添加 Secret。
手动配置步骤
如果快速配置不可用，按以下步骤手动完成：
步骤 1：安装 Claude GitHub App
访问 https://github.com/apps/claude 安装到你的仓库。
App 需要以下仓库权限：
- Contents：读写（修改仓库文件）
- Issues：读写（响应 Issue）
- Pull requests：读写（创建 PR 和推送更改）
步骤 2：添加 API Key Secret
在仓库的 Settings → Secrets and variables → Actions 中添加：
- 名称：
ANTHROPIC_API_KEY - 值：你的 Anthropic API key
步骤 3：添加工作流文件
创建 .github/workflows/claude.yml：
yaml
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 提及配置完成后，在 Issue 或 PR 评论中 @claude 即可触发。
从 Beta 版升级到 v1.0
如果你正在使用 Beta 版，以下是主要变更：
| Beta 版参数 | v1.0 参数 |
|---|---|
mode | （已移除，自动检测） |
direct_prompt | prompt |
override_prompt | prompt + GitHub 变量 |
custom_instructions | claude_args: --append-system-prompt |
max_turns | claude_args: --max-turns |
model | claude_args: --model |
allowed_tools | claude_args: --allowedTools |
disallowed_tools | claude_args: --disallowedTools |
claude_env | settings JSON 格式 |
升级示例
Beta 版写法：
yaml
- uses: anthropics/claude-code-action@beta
with:
mode: "tag"
direct_prompt: "Review this PR for security issues"
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
custom_instructions: "Follow our coding standards"
max_turns: "10"
model: "claude-sonnet-4-6"v1.0 写法：
yaml
- uses: anthropics/claude-code-action@v1
with:
prompt: "Review this PR for security issues"
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
claude_args: |
--append-system-prompt "Follow our coding standards"
--max-turns 10
--model claude-sonnet-4-6实用工作流示例
自动 PR 代码审查
yaml
name: Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
prompt: |
Please review this PR for:
1. Code quality and maintainability
2. Security vulnerabilities
3. Performance issues
4. Missing tests
Provide constructive feedback.自动修复 Issue
yaml
name: Auto Fix Issue
on:
issues:
types: [labeled]
jobs:
fix:
if: contains(github.event.label.name, 'claude-fix')
runs-on: ubuntu-latest
steps:
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
prompt: |
Fix the issue described in: ${{ github.event.issue.body }}
Create a PR with the fix.使用 Opus 4.6 进行深度分析
yaml
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
prompt: "Perform a deep security audit of this codebase"
claude_args: --model claude-opus-4-6与 AWS Bedrock / Google Vertex AI 集成
如果你通过第三方云提供商使用 Claude：
yaml
- uses: anthropics/claude-code-action@v1
with:
# 不使用 anthropic_api_key，改用云提供商凭证
claude_args: --model us.anthropic.claude-sonnet-4-5-20251101-v1:0
env:
AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
AWS_REGION: us-east-1
ANTHROPIC_PROVIDER: bedrock最佳实践
- 在 CLAUDE.md 中定义项目规范：Claude 会自动读取并遵守这些规范
- 限制允许的工具：通过
--allowedTools控制 Claude 可以使用哪些工具 - 设置最大轮次：使用
--max-turns避免无限循环 - 监控成本：通过 Anthropic Console 追踪 API 使用量
- 测试工作流：先在测试仓库验证配置，再部署到生产环境
总结
Claude Code GitHub Actions 将 AI 能力无缝集成到你的 GitHub 工作流，实现从代码审查到自动修复的全流程 AI 辅助。通过合理配置，可以显著减少人工审查时间，同时保持代码质量标准。
来源：Claude Code 官方文档 - GitHub Actions 原文作者：Anthropic Team