Claude Code GitHub Actions

Claude Code GitHub Actions 为您的 GitHub 工作流带来了 AI 驱动的自动化。只需在任何 PR 或问题中简单地提及 @claude，Claude 就可以分析您的代码、创建拉取请求、实现功能和修复错误。

Claude 可以做什么？

Claude Code 提供了一个强大的 GitHub Action，改变了您处理代码的方式。

设置

快速设置

设置此操作的最简单方法是通过终端中的 Claude Code：

claude
> /install-github-app

手动设置

1. 安装 Claude GitHub 应用到您的仓库
2. 添加 ANTHROPIC_API_KEY 到您的仓库密钥
3. 复制工作流文件到 .github/workflows/

示例用例

基本工作流

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 }}

使用斜杠命令

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

使用提示的自定义自动化

- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    prompt: "Analyze this PR for security issues"

最佳实践

CLAUDE.md 配置

在您的仓库根目录创建一个 CLAUDE.md 文件来定义：

• 代码风格指南
• 审查标准
• 项目特定规则
• 首选模式

安全考虑

• 始终使用 GitHub 密钥来存储 API 密钥
• 不要在工作流文件中硬编码 API 密钥

优化性能

• 使用问题模板提供上下文
• 保持您的 CLAUDE.md 简洁和专注
• 为您的工作流配置适当的超时

CI 成本

• GitHub Actions 成本：根据您的 GitHub 计划
• API 成本：根据您的 Anthropic API 使用量

使用 AWS Bedrock 和 Google Vertex AI

前置条件

对于 Google Cloud Vertex AI：

• 启用了 Vertex AI 的 Google Cloud 项目
• 为 GitHub Actions 配置的工作负载身份联合
• 具有所需权限的服务账户

对于 AWS Bedrock：

• 启用了 Amazon Bedrock 的 AWS 账户
• 在 AWS 中配置的 GitHub OIDC 身份提供商
• 具有 Bedrock 权限的 IAM 角色

故障排除

Claude 不响应 @claude 命令

• 验证 GitHub 应用是否正确安装
• 检查工作流是否启用
• 确保 API 密钥在仓库密钥中设置
• 确认评论包含 @claude（不是 /claude）

CI 不在 Claude 的提交上运行

• 确保您使用的是 GitHub 应用或自定义应用
• 检查工作流触发器是否包含必要的事件
• 验证应用权限是否包括 CI 触发器

身份验证错误

• 确认 API 密钥有效且具有足够的权限
• 对于 Bedrock/Vertex，检查凭证配置