@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:
- 进入仓库 Settings → Secrets and variables → Actions
- 点击 New repository secret
- Name 填
ANTHROPIC_AUTH_TOKEN,Secret 粘贴 Token 原文 - 点击 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 仓库实际跑成功的版本):
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-5、claude-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 秒:
工作原理
Authorization: Bearer <token> 这一种鉴权头,但官方 claude-code-action 内部使用的是 Anthropic SDK,会强制以 x-api-key 头发起请求。中间这个不到 40 行的 Python HTTP 代理就是用来桥接两种鉴权约定的,全部跑在 GitHub Runner 内存里,Token 不出 Runner。
切换模型
通过claude_args 即可切换:
| 参数 | 说明 |
|---|---|
--model | 模型名,常用 claude-opus-4-8、claude-sonnet-4-5、claude-haiku-4-5 |
--max-turns | 单次任务最多对话轮次,默认 10 |
--allowed-tools | 限制可用工具,逗号分隔 |
--mcp-config | 额外 MCP 配置文件路径 |
常见问题
1. Workflow 启动失败,提示 Either anthropic_api_key or claude_code_oauth_token must be provided
claude-code-action@v1 启动前必须在 anthropic_api_key、claude_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 真的会被设成字面量 -。推荐写法:
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 控制台 即可查看当前账户的剩余额度。控制台 - 使用历史 可以看到每一次调用的扣费明细。
了解更多
- 🧪 acedatacloud-dev/claude-code-action-demo — 本文使用的、可直接 fork 复现的 demo 仓库
- 📖 Claude Code GitHub Actions 官方文档
- 🛠️ anthropics/claude-code-action — Action 源码
- 🔧 Ace Data Cloud Claude Messages 服务

