42k star 的 CLIProxyAPI：一份订阅喂饱所有 AI 工具

你买了 Claude Pro，想在字节 Trae 或者最近爆火的腾讯的Workbuddy用一下，怎么办？

今天聊一个 42k star 的开源工具 CLIProxyAPI，它把你的 AI 订阅（Claude、ChatGPT、Gemini、Grok）变成本地 API 接口。

为什么需要这个

很多工具只认 API key，不支持 OAuth 登录：

国产 agent 工具：字节 Trae、阿里 CoderWork、腾讯 WorkBuddy等，想用 Claude 或 GPT 必须填 API key

开源 agent：Opencode、Cline 这类插件也一样

核心痛点：你买了 Claude Pro 订阅，想尝试在 Trae 写代码、Cursor 改 bug、Continue 做重构——三个工具都用同一个订阅，怎么办？

CLIProxyAPI 就干这个：把订阅账号转成 API 接口，一份订阅供多个工具用。

它是什么

一个跑在你电脑上的中转站。

它通过 OAuth 登录你的订阅账号（Claude Code、Codex、Gemini、Grok），然后把这些订阅包装成标准 API 地址（http://localhost:8317）。

其他工具只要支持自定义 base_url，就能把这个本地地址填进去。

你不用懂“反向代理““协议转换”，三步就行：装个小程序、登进订阅账号、给工具填本地地址。

工作原理：

订阅账号（OAuth 登录） ↓ 本地代理（CLIProxyAPI，监听 8317 端口） ↓ API 接口（http://localhost:8317） ↓ 任意支持自定义 base_url 的工具

为什么值得推荐

一个订阅，到处能用

你买一个 Claude Pro，可以在多个工具里都用上。

场景：

• 日常开发 Cursor 实现需求，改 bug，使用 Claude Pro

• 尝鲜验证，内容创作 ，接入Workbuddy 或者Trae, 还可以依然用同一个订阅

三个工具都指向 http://localhost:8317，底层走的是你那一份订阅的额度。

国产工具尤其有用，它们大多只支持 API key：

• 字节 Trae、阿里 CoderWork、腾讯 WorkBuddy

这些工具想用 Claude 或 GPT，要么掏钱买 API key，要么用不了。有了 CLIProxyAPI，把订阅转成 key 就能接进去。

Cursor、Windsurf 这类工具的自定义模型功能也吃这套——填个 base_url 就行。

跨厂商混着用

不只 Claude，你可以把 Claude、GPT、Gemini、Grok 都接进来，在一个入口里切换。

比如：

• 写代码用 Claude Opus

• 画图用 GPT-Image-2

• 快速查询用 Gemini Flash

都从 http://localhost:8317 调，换个模型名就行。

还能给模型起别名。gpt-5.5 太长，配置文件里改成 codex-latest，调用时直接写 codex-latest。

OpenRouter 这类聚合平台也能接——配置文件加一段 openai-compatibility，填 OpenRouter 的 API 地址和 key，几百个模型都能通过本地代理调。

和 OAuth 直连有什么不一样

很多人问：Cursor、Claude Code 本身就支持 OAuth 登录，为什么还要绕一层代理？

适用场景不同。

对比维度OAuth 直连CLIProxyAPI 反代工作方式工具 厂商直连工具 → 本地代理 → 厂商账号绑定单账号绑死某个工具一个账号供多个工具用工具限制只能用工具原生支持的那家（如 Cursor 只能 OAuth 登 Claude/OpenAI）任何支持自定义 base_url 的工具都能接跨厂商不支持支持（Claude、GPT、Gemini 混用）适用场景工具原生集成的厂商工具不支持 OAuth 的厂商，或想跨工具复用订阅

核心差异：OAuth 是“工具认账号“，反代是“工具认接口、接口认账号“。

例子：

• Cursor 原生支持 OAuth 登 Claude，直接在 Cursor 里登就行

• 字节 Trae 不支持 OAuth 登 Claude，只认 API key——这时候就需要 CLIProxyAPI 把订阅转成 key

跨工具复用：一个 Claude Pro 订阅在 Trae、Cursor、Continue 三个工具里都用，OAuth 直连做不到（每个工具各自登，额度独立计），反代可以（三个工具都指向同一个本地接口，底层走同一个订阅）。

手把手三步上手

第一步：装代理

macOS 用 Homebrew：

brew install cliproxyapi brew services start cliproxyapi

Docker 一行：

docker run -p 8317:8317
-v /path/to/config.yaml:/CLIProxyAPI/config.yaml
-v /path/to/auth-dir:/root/.cli-proxy-api
eceasy/cli-proxy-api:latest

启动后代理监听 8317 端口。浏览器打开 http://localhost:8317 能看到状态页，说明跑起来了。

第二步：登录订阅

CLIProxyAPI 通过 OAuth 登录订阅账号，不需要 API key。

在终端运行登录命令（根据你的订阅选一个）：

Claude Code 订阅

./cli-proxy-api –claude-login

Codex 订阅

./cli-proxy-api –codex-login

Grok Build 订阅

./cli-proxy-api –xai-login

运行后浏览器会自动打开登录页，登进去授权就行。如果你在远程服务器上，加 –no-browser 参数会打印登录 URL，你可以在本地浏览器打开。

登录完成后，在配置文件设置 api-keys（自己定义一个字符串，比如 “my-secret-key”），这个 key 后面要填到工具里。

配置文件路径：

• Homebrew 安装：$(brew –prefix)/etc/cliproxyapi.confApple Silicon 常见为 /opt/homebrew/etc/cliproxyapi.conf Intel Mac 常见为 /usr/local/etc/cliproxyapi.conf

• Docker：你挂载进去的 config.yaml

打开配置文件，找到 api-keys：

api-keys:

• “my-secret-key”

填个你记得住的 key。

第三步：在目标工具里填地址

代理跑起来了，订阅登进去了，最后一步是把其他工具接进来。

所有支持自定义模型的工具都是同样填法：

• base_url：http://localhost:8317 或 http://localhost:8317/v1（有的工具要求带 /v1 后缀）

• api-key：你在配置文件设的那个 key（比如 my-secret-key）

• 模型名：照抄你想用的模型 ID，比如 claude-opus-4-20250514、gpt-5-codex、gemini-2.5-flash

国产工具（Trae、CoderWork Workbuddy）、Cursor、Continue、Cline——都这么填。

填完之后，工具把请求发到 http://localhost:8317，代理收到请求后用你登录的订阅去调模型，然后把结果返回给工具。

不足和提醒

合规风险

这个玩法踩在各家服务条款的边缘。

本质上你是把订阅额度绕成 API 用。官方检测到非正常流量模式（比如同一个账号短时间内从多个 IP、多个工具同时调用），可能判定为滥用，封号风险有。

我的态度：这是个工具，用不用、怎么用，你自己评估风险。我只是把它介绍清楚。

需要一点命令行基础

装代理、改配置文件需要碰终端。完全不碰命令行的话，上手有点门槛。

好消息是生态里有不少桌面 GUI 版（README 里有推荐），不用敲命令也能管理代理。

依赖开源项目维护

厂商风控策略会变，CLIProxyAPI 需要持续跟进。哪天 Claude 或 OpenAI 改了协议，代理可能就不能用，得等项目更新。

好在这个项目 42k star，维护还算活跃。

不是万能钥匙

只能用在支持自定义 base_url 的工具里。有些在线平台（比如某些 Web IDE）不支持自定义接口，接不进去。

一句话总结

如果你有一个 AI 订阅、又想在多个工具里都用上（尤其那些只认 API key 的国产工具或开源 agent），这个 42k star 的工具值得一试。

Hi，我是 爱学习的Niko。17 年程序员老兵，现在每天用 AI 写代码，搞创作。这里分享学习和使用 AI 的经验、技术思考、踩过的坑、实用工具和 SKILL。关注我，一起学习。