概览
Claude Code Action 把仓库事件、提示词与 Claude Code 的工具能力连接起来。工作流可以响应 Issue 或 PR 中的 @claude,也可以由明确的自动化提示启动代码检查或维护任务。执行发生在 GitHub runner 上,模型请求则发送到配置的提供方。适合已经使用 GitHub Actions 的团队逐步引入代码解释、审查和小范围修改。
主要功能
- 支持 Issue 与 PR 评论触发。
- 可解释仓库代码与实现方式。
- 支持审查变更和提出修改建议。
- 支持按提示实施小范围代码修改。
- 提供结构化输出和任务进度信息。
- 支持 Anthropic、Bedrock、Vertex AI 等认证路径。
要求、安装和快速入门
1. 确认拥有目标仓库安装应用和配置 Actions 的权限。
2. 直接使用 Anthropic API 时,可在 Claude Code 中运行 /install-github-app 跟随引导配置。
3. 手动安装可参考官方 docs/setup.md 和 examples/claude.yml。
4. 将所需凭据放在 Actions secrets,按示例配置工作流权限。
5. 使用 anthropics/claude-code-action@v1,并设置任务所需 prompt 或 claude_args。
6. 在测试 PR 中触发一次只读审查,确认日志与结果后再开放修改类任务。
2. 直接使用 Anthropic API 时,可在 Claude Code 中运行 /install-github-app 跟随引导配置。
3. 手动安装可参考官方 docs/setup.md 和 examples/claude.yml。
4. 将所需凭据放在 Actions secrets,按示例配置工作流权限。
5. 使用 anthropics/claude-code-action@v1,并设置任务所需 prompt 或 claude_args。
6. 在测试 PR 中触发一次只读审查,确认日志与结果后再开放修改类任务。
用法
团队可以先选一个变更较小的 PR,要求只检查错误处理、边界条件和测试遗漏,并让建议引用具体文件。稳定后再增加按目录审查、Issue 分类或文档同步。需要修改代码时,将允许触及的范围和验收命令写入提示,输出继续经过团队的正常评审与 CI 流程。
实施要点
触发条件、可用工具和权限会决定自动化能修改什么。外部贡献的 PR 应沿用上游的权限与事件配置说明,避免为方便运行而把敏感凭据暴露给不受信任的工作流。
实施要点
触发条件、可用工具和权限会决定自动化能修改什么。外部贡献的 PR 应沿用上游的权限与事件配置说明,避免为方便运行而把敏感凭据暴露给不受信任的工作流。
模型兼容性与使用场景
需要 GitHub Actions runner、仓库权限及可用模型认证;不同云提供方的设置路径不同。Actions 执行费用和模型调用费用属于各自服务,安装开源 Action 不等于包含免费模型额度。
许可证与风险说明
Action 代码采用 MIT;Claude 模型服务、云提供方和 GitHub Actions 另有服务条款及计费。