又一款实现 Claude Code 自由的神器(Cloudflare Worker 云端转换,本地直接用)【附 Gemini 版部署教程】

佬友们,新的 Claude Code 羊毛来了。

Claude Code 的强大毋庸置疑(编程 AI Agent 目前口碑最强,没人反对吧?)。但是费用太贵、账号注册难;太劝退了,我到现在也没用过官方 API 来用 CC.

既然都是 LLM,能不能用其他厂商的 API 来用 Claude Code?当然可以。最近我在用这个神器项目:claude-worker-proxy

原理非常简单,就是在云端 Cloudflare Worker 加了一层转换层,直接看图:

这个项目的原理很简单,它是一个轻量级的代理服务,能将 Claude 格式的 API 请求,转换为 Gemini 或 OpenAI 等其他模型的格式。核心亮点是,它被设计运行在 Cloudflare Workers 上。

补充知识:不熟悉 Cloudflare Workers 的同学可以把它理解成一个“无服务器”的计算平台。你只需要把代码部署上去,它就能在网络上运行,而你完全不用关心服务器运维。

最关键的是,Cloudflare 提供的免费额度非常慷慨(人称赛博菩萨)。虽然是一个云计算平台,但是你在用免费 plan 的时候完全不用像其他国外平台一样绑定信用卡。

部署教程(手把手!)

这里以 Gemini 为例子。

0. 准备 Gemini API Key

  • Gemini API Base URL – 比如 https://generativelanguage.googleapis.com/v1beta/v1/messages
  • Gemini API – 下文用 YOUR_GEMINI_API_KEY 代指

1. 部署 Cloudflare Worker

如果没有账号,需要先到 Cloudflare 官网注册一个,Google 账号直接登录就行:随时随地连接、保护和构建 | Cloudflare

命令行部署:

# 1. 克隆项目
git clone https://github.com/glidea/claude-worker-proxy

# 2. 进入目录并安装依赖
cd claude-worker-proxy
npm install

# 3. 使用 wrangler 工具登陆 Cloudflare (如果没安装会自动提示)
wrangler login

# 4. 一键部署
npm run deploycf

部署成功后,你会得到一个 .workers.dev 结尾的 URL,这就是你的代理地址。下文用 YOUR_WORKER_URL 代指。

这时候聪明的观众就要问了。我要在哪里填写 Gemini 的 key
呢?

我一开始用这个项目的时候也有一样的问题。实际上这个 worker 设计是无状态的,你的 key 和 base url 是在最后发送网络请求的时候带上的,非常灵活。你只需要部署一次,之后更改配置什么的不需要重复操作 Cloudflare.

安全警告:所以,别人部署的 claude-worker-proxy 实际上你也能拿来直接用,但是别人能在日志里看到你的 api key。偷懒的朋友建议使用临时 key 来快速测试。

2. 配置 Claude Code 环境变量

打开 ~/.claude/settings.json 文件,修改 env 部分:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://YOUR_WORKER_URL/gemini/https://generativelanguage.googleapis.com/v1beta",
    "ANTHROPIC_API_KEY": "YOUR_GEMINI_API_KEY",
    "ANTHROPIC_MODEL": "gemini-1.5-pro",
    "ANTHROPIC_SMALL_FAST_MODEL": "gemini-1.5-flash"
  }
}

字段说明 ANTHROPIC_BASE_URL:

  • 这个字段由多个部分组成
  • 第一部分:Cloudflare Worker 网址,由上一步得到. 举个例子可能长这样:https://hahaha.hahahah123.workers.dev
  • 第二部分:API 类型说明。这个项目支持多种厂商,这里使用的例子是gemini
  • 第三部分:目标厂商的服务地址,Gemini 对应 https://generativelanguage.googleapis.com/v1beta
  • 每个部分用 / 符号连接起来
  • 举个例子:https://hahaha.hahahah123.workers.dev/gemini/https://generativelanguage.googleapis.com/v1beta

字段说明 ANTHROPIC_API_KEY:

  • 没错,就是 Gemini API Key
  • Cloudflare Worker 会做这部分转换

你可以用其他方式来设置环境变量:Claude Code settings - Claude Code Docs ,只要环境变量名字对的上就行。

配置完成后,直接运行 Claude Code 即可!!!

其他

类似原理方案还有 musistudio/claude-code-router,这个更火一些,现在支持的 api 很多。

这个项目的“API转换”逻辑是在本地执行的。不过 claude code router 配置更复杂,我自己鼓捣了很久才运行成功,后面想配置新的,一直失败。现在直接用 claude worker proxy 了,配置简单很多。大家可以对比看看哪个适合自己的使用场景。

claude-worker-proxy 在云端部署,如果你想分享给朋友的话,他/她只需要设置最后一步"配置 Claude Code 环境变量"就能直接使用了!

109 个赞

新人第一次发帖,多多指教 :person_fencing:

先占个前排

问题来了,这样 Gemini 能处理好 Claude Code 的工具调用吗?

挺详细的教程,学习了

worker绑定域名搞优选非常简单,速度更快。默认 .dev慢。 :grimacing:

1 个赞

偶尔见到过类似的报错,频率很低,但是这种情况cc会自己重试,用户不需要操作什么。

挺详细的教程,学习了

突然想到一个,这样加了一层代理。是不是gemini key更不容易被封禁了

我的意思是 Gemini 能否学会用 Claude Code 提供的工具,如果调用格式错误 claude code 是检测不到的。Claude Code Router 这一点就实现得很差

刚去看了代码,应该是没问题的 https://github.com/glidea/claude-worker-proxy/blob/main/src%2Fgemini.ts#L48-L58

2 个赞

猫猫头作者来顶个贴

3 个赞

感谢佬友 留着备用

感谢分享

:backhand_index_pointing_up::backhand_index_pointing_up::backhand_index_pointing_up:claude worker proxy 的项目作者在这,有bug找他:man_running:

1 个赞

请教.workers.dev 如何配合 gateway.ai 实现无需代理国内直接访问呢?

gemini2.5pro 在 CC 里不 太好用,不积极调用工具,还经常犯错,不如 qwen3coder 和 GLM4.5

3 个赞

学习一下

太强啦,我的佬!感谢分享 :lark_016:

提个小建议,ANTHROPIC_BASE_URL可以用逗号分隔吧,不然自己就乱了 :lark_033:

感谢大佬。

大佬 我提了个 iss,cc 的 key 好像要 sk 开头的 直接用 gemini 是不是会有问题呀