Repolode
anthropics

anthropics/claude-code-base-action

一个 GitHub Action,可在 GitHub Actions 工作流中运行 Claude Code,用于构建自定义自动化流程。

Star
1,015
Fork
603
未关闭 Issue
14
最近提交
9小时前

这是什么?

Claude Code Base Action 是一个轻量的 GitHub Actions 封装,会安装并运行 Claude Code,并使用你提供的提示词和参数。它面向在 Claude Code 之上构建自定义工作流的场景,而不是开箱即用的 @claude 提及功能,后者由另一个仓库 claude-code-action 提供。

提示词可以直接写在输入中,也可以从文件读取。额外的 CLI 参数可用于设置允许使用的工具、最大轮次、系统提示词和模型,设置与 MCP 配置也支持 JSON 格式。认证方式包括 Anthropic API Key、OAuth Token、Workload Identity Federation,以及通过 OIDC 接入 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry。输出包括执行状态、执行日志文件路径、可用于续接对话的 session ID,以及提供 JSON schema 时的结构化输出。

该 Action 会在调用方提供的工作目录和提示词下运行 Claude Code,因此信任边界需由调用方自行把握。处理外部 issue 或 fork 分支 PR 等不可信输入时,应改用主仓库 claude-code-action。

核心功能

  • 01可在任意 GitHub Actions 工作流中通过直接提示词或提示词文件运行 Claude Code。
  • 02支持传入自定义 CLI 参数,如允许工具、最大轮次和系统提示词。
  • 03支持 Anthropic API Key、OAuth Token 和 Workload Identity Federation 认证。
  • 04可通过 OIDC 访问 Amazon Bedrock、Google Vertex AI 和 Microsoft Foundry。
  • 05输出执行状态、日志文件路径、可续接的 session ID,以及可选的结构化输出。

适用场景

  • 构建定时运行的自定义代码审查任务,并在 PR 中添加评论。
  • 在仓库中自动执行重构或依赖更新等任务。
  • 在 CI 流水线中生成报告或文档。
  • 在使用 Bedrock 或 Vertex AI 云凭证的工作流中调用 Claude Code。

快速上手

  1. 1

    在 GitHub Actions 工作流文件中添加该 Action,并配置提示词和 API 密钥 secret

  2. 2

    将 Anthropic API 密钥保存为仓库 secret ANTHROPIC_API_KEY,并在工作流中引用它

使用前须知

  • 这是镜像仓库,问题和拉取请求需提交到主仓库 claude-code-action。
  • 它本身不执行信任边界检查,处理分支 PR 等不可信输入时应改用主仓库 claude-code-action。
  • 运行需要 Anthropic API 密钥或 OAuth 令牌,或配置联合身份验证。

标签

常见问题

claude-code-base-action 是什么?
一个 GitHub Action,可在 GitHub Actions 工作流中运行 Claude Code,用于构建自定义自动化流程。 Claude Code Base Action 是一个轻量的 GitHub Actions 封装,会安装并运行 Claude Code,并使用你提供的提示词和参数。它面向在 Claude Code 之上构建自定义工作流的场景,而不是开箱即用的 @claude 提及功能,后者由另一个仓库 claude-code-action 提供。
claude-code-base-action 可以免费使用吗?用的什么许可证?
claude-code-base-action 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
claude-code-base-action 还在维护吗?
活跃维护中。claude-code-base-action 最近一次提交是在 2026年10月22日。
claude-code-base-action 适合用来做什么?
构建定时运行的自定义代码审查任务,并在 PR 中添加评论。 在仓库中自动执行重构或依赖更新等任务。 在 CI 流水线中生成报告或文档。 在使用 Bedrock 或 Vertex AI 云凭证的工作流中调用 Claude Code。
claude-code-base-action 怎么安装和运行?
在 GitHub Actions 工作流文件中添加该 Action,并配置提示词和 API 密钥 secret 将 Anthropic API 密钥保存为仓库 secret ANTHROPIC_API_KEY,并在工作流中引用它
在哪里获取 claude-code-base-action?
源代码和安装说明在 GitHub 上:https://github.com/anthropics/claude-code-base-action

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目