claude-code-action让Claude直接响应GitHub PR评论、Issue提及和自动化任务,支持多种认证方式(Anthropic API Key、Bedrock、Vertex、Foundry),可完成代码审查、简单修复甚至新功能实现。

一个通用的 Claude Code Action,用于处理 GitHub PR 和 issue,可以回答问题并实现代码变更。该 Action 能智能检测何时激活——无论是响应 @claude 提及、issue 分配,还是执行带有显式 prompt 的自动化任务。它支持多种认证方式,包括 Anthropic 直连 API(API Key 或 Workload Identity Federation)、Amazon Bedrock、Google Vertex AI 和 Microsoft Foundry。
🎯 智能模式检测:可根据工作流上下文自动选择合适的执行模式——无需配置
🤖 交互式代码助手:Claude 可以回答关于代码、架构和编程的问题
🔍 代码审查:分析 PR 变更并提出改进建议
✨ 代码实现:可以实现简单的修复、重构乃至新功能
💬 PR/Issue 集成:与 GitHub 评论和 PR 评审无缝衔接
🛠️ 灵活的工具访问:可访问 GitHub API 和文件操作(可通过配置启用更多工具)
📋 进度追踪:可视化进度指示器,带有动态更新的复选框,Claude 完成子任务时会自动更新
📊 结构化输出:获取经过验证的 JSON 结果,可自动成为 GitHub Action 输出,用于复杂自动化场景
🏃 在你的基础设施上运行:Action 完全在你的 GitHub Runner 上执行(API 调用发送到你选择的提供商)
⚙️ 简化配置:统一的 prompt 和 claude_args 输入提供清晰、强大的配置,与 Claude Code SDK 对齐
📦 从 v0.x 升级?
查看迁移指南,获取逐步说明来更新工作流到 v1.0。新版本简化了配置,同时保持与大多数现有设置的兼容性。
安装此 Action 最简单的方式是通过终端中的 Claude Code。只需打开 claude 并运行 /install-github-app。
该命令将引导你完成 GitHub App 和所需 secrets 的设置。
你必须是仓库管理员才能安装 GitHub App 和添加 secrets
这种快速启动方法仅适用于直接使用 Anthropic API 的用户。对于 AWS Bedrock、Google Vertex AI 或 Microsoft Foundry 的配置,请参阅 docs/cloud-providers.md。
📚 解决方案和使用案例
寻找特定的自动化模式?查看解决方案指南,获取完整的工作示例,包括:
🔍 自动化 PR 代码审查 - 完整审查自动化
📂 路径特定审查 - 在关键文件更改时触发
👥 外部贡献者审查 - 为新贡献者提供特殊处理
📝 自定义审查清单 - 强制执行团队标准
🔄 定时维护 - 自动化的仓库健康检查
🏷️ Issue 分类与标注 - 自动分类
📖 文档同步 - 保持文档与代码变更同步
🔒 安全审查 - OWASP 对齐的安全分析
📊 自助进度追踪 - 在自动化模式下创建追踪评论
每个解决方案都包含完整的工作示例、配置细节和预期结果。
解决方案指南 - 🎯 可直接使用的自动化模式
迁移指南 - ⭐ 从 v0.x 升级到 v1.0
设置指南 - 手动设置、自定义 GitHub App 和安全最佳实践
使用指南 - 基本用法、工作流配置和输入参数
自定义自动化 - 自动化工作流和自定义 prompt 的示例
配置 - MCP 服务器、权限、环境变量和高级设置
实验性功能 - 执行模式和网络限制
云提供商 - AWS Bedrock、Google Vertex AI 和 Microsoft Foundry 设置
能力与限制 - Claude 能做什么和不能做什么
安全 - 访问控制、权限和提交签名
FAQ - 常见问题和故障排除
遇到问题或有疑问?查看常见问题解答,获取常见问题的解决方案以及 Claude 能力和限制的详细说明。
本项目采用 MIT 许可证——详见 LICENSE 文件。