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

✍ Niko爱学习🕐 2026-07-16📦 7.9 KB 🟢 已读 𝕏 文章列表

文章介绍了开源工具 CLIProxyAPI，它能将 Claude、ChatGPT 等 AI 订阅账号通过 OAuth 转换为本地 API 接口，从而让只支持 API Key 的国产工具（如字节 Trae）或开源 Agent 复用同一个订阅。文章详解了其安装、配置步骤及工作原理，同时也指出了合规风险和使用门槛。

# 42k star 的 CLIProxyAPI：一份订阅喂饱所有 AI 工具 **作者**: Niko爱学习 **日期**: 2026-07-16T04:31:55.000Z **来源**: [https://x.com/ai_super_niko/status/2077612167634030853](https://x.com/ai_super_niko/status/2077612167634030853) --- ![Image](/doc/3068/image/img_0b838c569195.jpg) 你买了 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 的工具 ![Image](/doc/3068/image/img_ce13364784d1.jpg) ## 为什么值得推荐 ## 一个订阅，到处能用你买一个 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 是"工具认账号"，反代是"工具认接口、接口认账号"。 ![Image](/doc/3068/image/img_86bf50b03973.jpg) 例子： - 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。关注我，一起学习。 ## 相关链接 - [Niko爱学习](https://x.com/ai_super_niko) - [@ai_super_niko](https://x.com/ai_super_niko) - [1.4K](https://x.com/ai_super_niko/status/2077612167634030853/analytics) - [Upgrade to Premium](https://x.com/i/premium_sign_up) - [12:31 PM · Jul 16, 2026](https://x.com/ai_super_niko/status/2077612167634030853) - [1,424 Views](https://x.com/ai_super_niko/status/2077612167634030853/analytics) - [View quotes](https://x.com/ai_super_niko/status/2077612167634030853/quotes) --- *导出时间: 2026/7/16 14:44:41*

🔗 相关文档