了解如何使用 Claude Code GitHub Actions 将 Claude Code 集成到您的开发工作流程中
Claude Code GitHub Actions 为您的 GitHub 工作流程带来 AI 驱动的自动化。只需在任何 PR 或 issue 中简单地提及 ,Claude 就可以分析您的代码、创建拉取请求、实现功能和修复错误 - 所有这些都遵循您项目的标准。
ℹ️ 信息
Claude Code GitHub Actions 目前处于测试阶段。随着我们完善体验,功能和特性可能会发生变化。
📝 注意
Claude Code GitHub Actions 基于 Claude Code SDK 构建,该 SDK 支持将 Claude Code 程序化集成到您的应用程序中。您可以使用 SDK 构建超越 GitHub Actions 的自定义自动化工作流程。
Claude Code 提供强大的 GitHub Actions,改变您处理代码的方式:
此 GitHub Action 允许您在 GitHub Actions 工作流程中运行 Claude Code。您可以使用它在 Claude Code 之上构建任何自定义工作流程。
查看仓库 →
使用 Claude 构建自定义 GitHub 工作流程的基础。这个可扩展的框架为您提供对 Claude 功能的完全访问权限,用于创建定制的自动化。
查看仓库 →
设置此操作的最简单方法是通过终端中的 Claude Code。只需打开 claude 并运行 。
此命令将指导您完成设置 GitHub 应用程序和所需密钥的过程。
📝 注意
如果 命令失败或您更喜欢手动设置,请按照以下手动设置说明操作:
💡 提示
完成快速启动或手动设置后,通过在 issue 或 PR 评论中标记 来测试操作!
Claude Code GitHub Actions 可以帮助您完成各种任务。有关完整的工作示例,请参阅示例目录。
在 issue 评论中:
Claude 将分析 issue,编写代码,并创建 PR 供审查。
在 PR 评论中:
Claude 将分析您的代码并提供具体的实现指导。
在 issue 中:
Claude 将定位错误,实现修复,并创建 PR。
在您的仓库根目录中创建一个 文件来定义代码风格指南、审查标准、项目特定规则和首选模式。此文件指导 Claude 理解您的项目标准。
⚠️ 警告
永远不要直接将 API 密钥提交到您的仓库!
始终使用 GitHub 密钥来存储 API 密钥:
始终使用 GitHub 密钥(例如,)而不是在工作流程文件中直接硬编码 API 密钥。
使用 issue 模板提供上下文,保持您的 简洁和专注,并为您的工作流程配置适当的超时。
使用 Claude Code GitHub Actions 时,请注意相关成本:
GitHub Actions 成本:
API 成本:
成本优化提示:
对于不同用例的即用型工作流程配置,包括:
访问 Claude Code Action 仓库中的示例目录。
💡 提示
示例仓库包含完整的、经过测试的工作流程,您可以直接复制到您的 目录中。
对于企业环境,您可以将 Claude Code GitHub Actions 与您自己的云基础设施一起使用。这种方法让您控制数据驻留和计费,同时保持相同的功能。
在使用云提供商设置 Claude Code GitHub Actions 之前,您需要:
对于 Google Cloud Vertex AI:
对于 AWS Bedrock:
为了在使用 Vertex AI 或 Bedrock 等第三方提供商时获得**控制和安全性,我们建议创建您自己的 GitHub 应用程序:
📝 注意
此应用程序将与 actions/create-github-app-token 操作一起使用,在您的工作流程中生成身份验证令牌。
Anthropic API 的替代方案或如果您不想设置自己的 Github 应用程序:使用官方 Anthropic 应用程序:
选择您的云提供商并设置安全身份验证:
AWS Bedrock
配置 AWS 以允许 GitHub Actions 安全地进行身份验证,而无需存储凭据。
安全说明:使用特定于仓库的配置,并仅授予所需的最小权限。
所需设置:
所需值:
设置后,您将需要:
💡 提示
OIDC 比使用静态 AWS 访问密钥更安全,因为凭据是临时的并且会自动轮换。
有关详细的 OIDC 设置说明,请参阅 AWS 文档。
Google Vertex AI
配置 Google Cloud 以允许 GitHub Actions 安全地进行身份验证,而无需存储凭据。
安全说明:使用特定于仓库的配置,并仅授予所需的最小权限。
所需设置:
所需值:
设置后,您将需要:
💡 提示
工作负载身份联合消除了对可下载服务帐户密钥的需求,提高了安全性。
有关详细的设置说明,请参阅 Google Cloud 工作负载身份联合文档。
将以下密钥添加到您的仓库(设置 → 密钥和变量 → Actions):
对于 Anthropic API(直接):
对于 Google Cloud Vertex AI
对于 AWS Bedrock
创建与您的云提供商集成的 GitHub Actions 工作流程文件。以下示例显示了 AWS Bedrock 和 Google Vertex AI 的完整配置:
AWS Bedrock 工作流程
先决条件:
所需的 GitHub 密钥:
💡 提示
Bedrock 的模型 ID 格式包括区域前缀(例如,)和版本后缀。
Google Vertex AI 工作流程
先决条件:
所需的 GitHub 密钥:
💡 提示
项目 ID 会从 Google Cloud 身份验证步骤中自动检索,因此您无需硬编码它。
验证 GitHub 应用程序是否正确安装,检查工作流程是否已启用,确保 API 密钥已在仓库密钥中设置,并确认评论包含 (不是 )。
确保您使用的是 GitHub 应用程序或自定义应用程序(不是 Actions 用户),检查工作流程触发器是否包含必要的事件,并验证应用程序权限是否包含 CI 触发器。
确认 API 密钥有效且具有足够的权限。对于 Bedrock/Vertex,检查凭据配置并确保密钥在工作流程中正确命名。
Claude Code Action 支持以下关键参数:
*需要 或 之一 直接 Anthropic API 需要,Bedrock/Vertex 不需要
虽然 命令是推荐的方法,但您也可以:
有关详细文档,请参阅 Claude Code Action 仓库。
您可以通过两种方式配置 Claude 的行为:
Claude 在创建 PR 和响应请求时将遵循这些指南。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/222289.html