跳转到主要内容
Claude Code GitHub Actions 是 Anthropic 官方推出的 GitHub Actions 集成方案。安装之后,只需要在 Issue、PR 或评论中 @claude,Claude 就会以 GitHub Bot 的身份在你的仓库里直接读代码、改代码、提 PR、跑 Review。 本文档介绍如何通过 Ace Data Cloud 的代理服务,把 Claude Code GitHub Actions 接到 claude-opus-4-8 等 Claude 模型上,无需 Anthropic 官方订阅。文中所有截图均来自我们公开的 demo 仓库 acedatacloud-dev/claude-code-action-demo,可以直接 fork 复现。

申请流程

要使用 Claude Code,首先可以到 Ace Data Cloud 控制台,获取您的 API Token,留作备用。 如果你尚未登录或注册,会自动跳转到登录页面邀请您来注册和登录,登录注册之后会自动返回当前页面。 在首次申请时会有免费额度赠送,可以免费体验 Claude Code 服务。

配置 GitHub Secret

把刚才复制的 Token 添加到目标仓库的 Secret 中,命名为 ANTHROPIC_AUTH_TOKEN
  1. 进入仓库 SettingsSecrets and variablesActions
  2. 点击 New repository secret
  3. NameANTHROPIC_AUTH_TOKENSecret 粘贴 Token 原文
  4. 点击 Add secret
Ace Data Cloud 网关使用 Authorization: Bearer <token> 鉴权,但 anthropics/claude-code-action 内部会通过 Anthropic SDK 把请求改写成 x-api-key。下面的 Workflow 里会启动一个 GitHub Runner 上的本地 HTTP 代理,把 x-api-key 翻译回 Authorization: Bearer

添加 Workflow 文件

在仓库中创建 .github/workflows/claude.yml完整内容如下(这就是我们 demo 仓库实际跑成功的版本):
name: Claude Code

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request_review:
    types: [submitted]

jobs:
  claude:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
    env:
      ANTHROPIC_BASE_URL: http://127.0.0.1:8788
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - name: Start AceData Cloud proxy (x-api-key → Bearer)
        env:
          UPSTREAM: https://api.acedata.cloud
          ACEDATA_TOKEN: ${{ secrets.ANTHROPIC_AUTH_TOKEN }}
        run: |
          cat > /tmp/proxy.py <<'PY'
          import http.server, socketserver, urllib.request, urllib.error, os
          UPSTREAM = os.environ["UPSTREAM"].rstrip("/")
          TOKEN = os.environ["ACEDATA_TOKEN"]
          HOP = {"host", "content-length", "connection", "keep-alive",
                 "proxy-authenticate", "proxy-authorization", "te",
                 "trailers", "transfer-encoding", "upgrade"}

          class H(http.server.BaseHTTPRequestHandler):
              protocol_version = "HTTP/1.1"

              def _proxy(self, method):
                  body = self.rfile.read(int(self.headers.get("Content-Length") or 0)) \
                      if method in ("POST", "PUT", "PATCH") else None
                  req = urllib.request.Request(UPSTREAM + self.path, data=body, method=method)
                  for k, v in self.headers.items():
                      if k.lower() in HOP or k.lower() in ("authorization", "x-api-key"):
                          continue
                      req.add_header(k, v)
                  req.add_header("Authorization", f"Bearer {TOKEN}")
                  try:
                      resp = urllib.request.urlopen(req, timeout=600)
                      data, code, headers = resp.read(), resp.status, resp.headers
                  except urllib.error.HTTPError as e:
                      data, code, headers = e.read(), e.code, e.headers
                  self.send_response(code)
                  for k, v in headers.items():
                      if k.lower() in HOP:
                          continue
                      self.send_header(k, v)
                  self.send_header("Content-Length", str(len(data)))
                  self.end_headers()
                  self.wfile.write(data)

              def do_GET(self): self._proxy("GET")
              def do_POST(self): self._proxy("POST")
              def do_PUT(self): self._proxy("PUT")
              def do_DELETE(self): self._proxy("DELETE")
              def log_message(self, *a, **k): pass

          class T(socketserver.ThreadingMixIn, http.server.HTTPServer):
              daemon_threads = True
              allow_reuse_address = True

          T(("127.0.0.1", 8788), H).serve_forever()
          PY
          nohup python3 /tmp/proxy.py > /tmp/proxy.log 2>&1 &
          for i in $(seq 1 20); do
            curl -sS -o /dev/null http://127.0.0.1:8788/ && break
            sleep 0.3
          done

      - name: Run Claude Code via AceData Cloud
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: dummy-not-used
          github_token: ${{ secrets.GITHUB_TOKEN }}
          claude_args: |
            --model claude-opus-4-8
          show_full_output: 'true'
提交之后,在 GitHub Actions 的 Workflows 列表中就可以看到这个 Claude Code 工作流:

几个关键点

  • ANTHROPIC_BASE_URL: http://127.0.0.1:8788 把所有 Anthropic API 请求指向本地代理。
  • 代理脚本读取 Secret ANTHROPIC_AUTH_TOKEN,把上游请求里的 x-api-key 头丢弃,统一替换为 Authorization: Bearer <token> 再转发到 https://api.acedata.cloud
  • anthropic_api_key: dummy-not-used 必须填一个非空字符串,否则 claude-code-action 启动前的校验会直接失败。真正鉴权用的是 Secret 里的 ANTHROPIC_AUTH_TOKEN
  • --model claude-opus-4-8 指定使用 Claude Opus 4.8,可以替换为 Ace Data Cloud 支持的任意 Claude 模型,例如 claude-sonnet-4-5claude-haiku-4-5

触发 Claude

新建一个 Issue,正文里写 @claude 加你要它做的事。例如下图,标题 Smoke test #11 (Opus 4.8),正文 @claude Reply with: OK. 大约 30 秒后,github-actions Bot 就会用 Claude Opus 4.8 的输出回复评论:
Claude finished @acedatacloud-dev’s task in 22s — View job OK.
对应的 Workflow 运行结果是 Success,总耗时 51 秒:

工作原理

GitHub Issue / PR comment 含 @claude
  └─→ GitHub Actions 触发 .github/workflows/claude.yml
        ├─ Step 1: 启动本地代理 127.0.0.1:8788
        └─ Step 2: anthropics/claude-code-action@v1
              └─→ Claude Code CLI 把 ANTHROPIC_BASE_URL 当成 Anthropic API
                    └─→ 请求落到本地代理(自带 x-api-key=dummy-not-used)
                          └─→ 代理替换为 Authorization: Bearer <ANTHROPIC_AUTH_TOKEN>
                                └─→ 转发到 https://api.acedata.cloud
                                      └─→ Claude Opus 4.8 实际推理
              └─→ Claude 在仓库里读代码 / 写代码 / 评论 / 提 PR
整条链路上唯一关键的转换在本地代理这一步。Ace Data Cloud 网关只识别 Authorization: Bearer <token> 这一种鉴权头,但官方 claude-code-action 内部使用的是 Anthropic SDK,会强制以 x-api-key 头发起请求。中间这个不到 40 行的 Python HTTP 代理就是用来桥接两种鉴权约定的,全部跑在 GitHub Runner 内存里,Token 不出 Runner

切换模型

通过 claude_args 即可切换:
      - name: Run Claude Code via AceData Cloud
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: dummy-not-used
          github_token: ${{ secrets.GITHUB_TOKEN }}
          claude_args: |
            --model claude-sonnet-4-5
            --max-turns 8
          show_full_output: 'true'
参数说明
--model模型名,常用 claude-opus-4-8claude-sonnet-4-5claude-haiku-4-5
--max-turns单次任务最多对话轮次,默认 10
--allowed-tools限制可用工具,逗号分隔
--mcp-config额外 MCP 配置文件路径
可用模型清单可在 Claude Messages 服务页面 查询。

常见问题

1. Workflow 启动失败,提示 Either anthropic_api_key or claude_code_oauth_token must be provided

claude-code-action@v1 启动前必须在 anthropic_api_keyclaude_code_oauth_token 或工作负载联合三者中至少给一个非空值。即使我们后面会用 Bearer Token 鉴权,也必须给 anthropic_api_key 一个占位字符串(示例里的 dummy-not-used)。

2. 代理返回 401,CLS 里看到 Authorization: Bearer -

通常是 Secret 设置出错。强烈避免gh secret set ANTHROPIC_AUTH_TOKEN --body - 这种从 stdin 读入的写法 —— 如果 stdin 没接好,Secret 真的会被设成字面量 -。推荐写法:
gh secret set ANTHROPIC_AUTH_TOKEN --repo <org>/<repo> --body '<your-real-token>'
设完后可以在 Workflow 里临时加一行 echo "len=${#ACEDATA_TOKEN}" 打印长度(不会泄露原值),验证 Secret 是否生效。

3. Claude 没有响应 @claude

  • 确认 if: 条件覆盖了触发事件,比如评论触发对应 issue_comment / pull_request_review_comment
  • 确认仓库里有 .github/workflows/claude.yml 且 Actions 没有被禁用。
  • 进入 Actions 选项卡,确认能看到对应的工作流 Run。
  • 检查代理 Step 是否成功启动,可参考 demo 仓库里 Proxy log (on failure) Step 的实现,把 /tmp/proxy.log 打出来定位问题。

4. 如何查看剩余额度

登录 Ace Data Cloud 控制台 即可查看当前账户的剩余额度。
控制台 - 使用历史 可以看到每一次调用的扣费明细。

了解更多