claude-code-base-action

环境要求

• 一个可用的 GitHub 仓库，且对 Actions 有使用权限
• 仓库 Settings → Secrets 中已添加 ANTHROPIC_API_KEY
• 工作流文件需放在仓库的 .github/workflows/ 目录下
• 了解 YAML 基本缩进语法

安装与启动步骤

1. 1新建工作流文件

   在仓库 .github/workflows/ 下创建 YAML 文件，作为调用该 Action 的载体。

2. 2配置 API 密钥

   在仓库 Settings → Secrets and variables → Actions 中添加 ANTHROPIC_API_KEY，工作流里用 secrets 引用。

3. 3写入 Action 步骤

   按 README 示例使用 anthropics/claude-code-base-action@beta，并传入 prompt 与密钥。

   - name: Run Claude Code
     uses: anthropics/claude-code-base-action@beta
     with:
       prompt: "Your prompt here"
       claude_args: '--allowedTools "Bash(git:*),Read,Glob,Grep"'
       anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

   复制

4. 4配置 settings 参数

   settings 可指向 JSON 文件路径，也可直接内联 JSON 字符串，用于指定 model、env、permissions、hooks。

   - name: Run Claude Code with inline settings
     uses: anthropics/claude-code-base-action@beta
     with:
       prompt: "Your prompt here"
       settings: |
         {
           "model": "claude-opus-4-1-20250805",
           "permissions": {
             "allow": ["Bash", "Read"],
             "deny": ["WebFetch"]
           }
         }
       anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

   复制

5. 5配置 MCP 服务

   通过 claude_args 的 --mcp-config 传入 JSON 文件路径或内联 JSON，格式为 mcpServers 对象。

   - name: Run Claude Code with MCP config file
     uses: anthropics/claude-code-base-action@beta
     with:
       prompt: "Your prompt here"
       claude_args: |
         --mcp-config "path/to/mcp-config.json"
         --allowedTools "Bash(git:*),Read,Glob,Grep"
       anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

   复制

6. 6提交并触发运行

   提交工作流文件后，在仓库 Actions 页面查看本次运行日志与结果。

   git add .github/workflows/claude.yml
   git commit -m "add claude code workflow"
   git push

   复制

关键配置

如何确认成功

提交后在仓库 Actions 页面看到该工作流运行完成，日志中输出 Claude Code 的执行结果。

常见问题

注意事项

• 该仓库为镜像仓库，不接收 issue 与 PR，贡献请前往主仓库。
• Action 只是安装并运行 Claude Code 的薄封装，不建立信任边界，需自行确保工作目录与提示词可信。
• 该 Action 会始终把 enableAllProjectMcpServers 设为 true，以保证 MCP 服务正常工作。
• 不要在工作流中直接处理不可信输入，避免其影响执行环境。