编程 CLI Linux, macOS, Windows, Docker

CLIProxyAPI：CPA中转站账号池 API 网关

用 CLIProxyAPI 可以把自己合法持有的 CLI、OAuth、订阅账号或上游 API 资源代理成统一接口，再交给 NewAPI、团队工具或本地 AI 编程客户端使用。

查看 GitHub 项目
CLIProxyAPI CPA中转站 CLI Proxy API CLIProxyAPI NewAPI Codex 中转站 Claude Code 中转站 Gemini CLI API 代理

它是干什么的

CLIProxyAPI 是一个把 AI 编程 CLI、OAuth 登录态、订阅账号能力和兼容 API 上游统一代理出来的开源服务。官方文档把它定位为给 CLI 提供 OpenAI、Gemini、Claude、Codex、Grok 兼容 API 接口的代理服务器。

CPA中转站的核心做法，是用 CLIProxyAPI 做账号池和 API 网关：上游接 Codex、Claude Code、Gemini CLI、Grok Build 或 OpenAI 兼容接口，下游再接 NewAPI、管理面板或本地客户端。

flowchart TD upstream("Codex / Claude Code / Gemini CLI / Grok Build / OpenAI 兼容上游") cpa("CLIProxyAPI / CPA") panel("NewAPI / CPA-Helper / 自研面板 / 本地客户端") clients("Cursor / Claude Code / Codex / OpenCode / SDK / 团队用户") upstream -->|"账号 / OAuth / API Key"| cpa cpa -->|"统一 API"| panel panel -->|"Base URL / Token"| clients

适合什么人

CLIProxyAPI 更适合开发者、站长和小团队做账号池网关，而不是普通用户直接拿来聊天。

场景是否适合
自己有 Codex、Claude Code、Gemini CLI 等账号，想统一成 API✅ 适合
想给团队内部统一一个 Base URL 和 Key🟡 适合，但要加管理层
想研究 CPA + NewAPI 中转站架构✅ 适合
想做大规模公网商业中转站❌ 风险高，不建议直接上
只想找一个稳定付费 API 中转站❌ 不适合，应该看服务商而不是部署工具

它解决什么问题

搭 CPA中转站时，最先要解决的不是前台页面，而是供给层能力：

  • 把不同账号和上游统一成 API。
  • 支持 OpenAI / Gemini / Claude / Codex 等兼容协议。
  • 用多账号轮询降低单账号限流影响。
  • 给 NewAPI 这类面板提供一个可管理的上游渠道。
  • 服务 Claude Code、Codex、Cursor、OpenCode 等 AI 编程工作流。

分工上，CLIProxyAPI 负责底层代理和账号池，NewAPI 负责用户、Token、渠道和额度。不要把 CPA 当成完整面板，也不要把 NewAPI 当成账号登录工具。

接入前先确认边界

上线前至少要回答这几个问题：

问题为什么重要
账号来源是否合法订阅账号、OAuth 登录态和 API Key 的使用边界不同
管理接口是否只允许可信来源访问CPA 会保存配置和认证文件，泄露后损失很重
是否需要 NewAPI 做用户与额度多人使用时，仅靠 CPA 很难管理分发
是否接受上游随时风控或变更CLI、OAuth、订阅账号链路比官方 API 更脆
是否有日志、备份和失败切换中转站故障通常不是单点问题

和 NewAPI、Sub2API 怎么分工

工具更像什么典型用途
CLIProxyAPI / CPA账号转 API 层把 Codex、Claude Code、Gemini CLI、兼容上游代理出来
NewAPI管理和分发层管渠道、令牌、用户、额度、价格和统一出口
Sub2API一体化快速中转个人或小团队快速把订阅能力转 API

如果你的目标是自用，CPA 单独部署就能解决很多问题。如果你的目标是多人分发，通常要 CPA + NewAPI 或 CPA + 轻量面板。

快速接入路径

官方文档提供 macOS、Linux、Windows、Docker 和 Docker Compose 等方式。CPA中转站场景更常见的是服务器 Docker Compose，因为配置、认证目录和备份都更清楚。

如果要把它接入 NewAPI，通常是：

步骤要做什么
1先跑通 CPA，并确认本地 http://127.0.0.1:8317 可访问
2在 CPA 里完成 Codex、Claude Code、Gemini CLI 或兼容上游配置
3生成或配置 CPA 给 NewAPI 使用的 API Key
4在 NewAPI 里把 CPA 添加成上游渠道
5在 NewAPI 中创建给用户或客户端使用的令牌
6用 Codex、Claude Code、CC Switch、curl 或 SDK 做最小请求测试

具体部署细节，建议看这篇教程：CPA中转站搭建教程：CLIProxyAPI + NewAPI 账号池网关。

常见坑

  • 把 CPA 直接暴露到公网：管理接口、配置文件和认证目录都需要保护，公网部署必须先做访问控制。
  • 只测聊天，不测流式：Claude Code、Codex、Cursor 更依赖流式和协议细节，普通聊天能回不代表 coding CLI 能用。
  • 把 NewAPI 和 CPA 当成竞争关系：它们通常是上下游关系。CPA 解决账号转 API，NewAPI 解决分发管理。
  • 忽略账号风控：多账号轮询不能消除平台风控，只是让故障更晚暴露。
  • 没有备份认证目录：OAuth 登录态和配置文件是核心资产，迁移前要先设计备份。

参考资料

资料来源

相关工具

API Relay Check：中转站检测与模型掺水验证工具 一个面向 AI API 中转站的验证入口，用于小额验货：检查中转站是否疑似掺水、模型冒充、隐藏注入、Token 用量异常、TTFT 过慢、SSE 流不稳定，以及 Claude Code / Codex 接入风险。 CC Switch 管理 Claude Code 与 Codex 配置 一个面向开发者的配置管理工具，适合整理 Claude Code、Codex、Gemini CLI、OpenCode、provider 档案、Base URL、API Key、MCP、prompts 和 skills。 Codex++：Codex 桌面端 tweak 系统 一个非官方 Codex 桌面端 tweak 系统：注入 loader，把 runtime 放在 app bundle 外，增加 Tweaks 设置页，并管理 tweak 模块。

相关教程

CPA中转站搭建教程：CLIProxyAPI + NewAPI 账号池网关 面向开发者和站长的 CPA中转站搭建教程：解释 CLIProxyAPI 与 NewAPI 分工、账号池架构、部署路径、接入测试、安全配置和常见排障。

相关主题

Codex 中转服务对比 对比支持 Codex 的中转站和 AI API 服务商，整理 Base URL、Responses API、模型覆盖、价格套餐、支付方式、售后渠道、公开核验记录与配置教程。 Claude Code 中转平台对比 对比 Claude Code 中转平台，整理 Claude Code 支持线索、Anthropic 兼容接入、Claude 模型覆盖、价格说明、支付方式、售后渠道与公开核验记录。 Gemini CLI 中转站推荐与服务商对比 对比 Gemini CLI 中转站、Gemini API 中转与 Google 模型服务商的模型覆盖、API Key、Base URL、价格、支付方式和核验信息。 OpenAI API 中转服务商 对比 OpenAI API 中转与 OpenAI 兼容代理服务商的 Base URL、模型、价格、支付方式与公开核验信息。

常见问题

常见问题

CLIProxyAPI 和 CPA中转站是什么关系？

CPA 通常就是 CLIProxyAPI 的简称。CPA中转站多数时候指用 CLIProxyAPI 做底层账号转 API，再配合 NewAPI 或其他面板做分发。

CLIProxyAPI 能单独当中转站用吗？

可以自用或小范围团队使用，但它更像账号池和协议代理层。面向多人分发、额度、用户、计费和渠道管理时，通常还会搭配 NewAPI、CPA-Helper 或其他管理层。

CLIProxyAPI 适合公网商业中转站吗？

不建议直接公网售卖。它会持有账号凭证和 OAuth 登录态，且订阅账号 API 化可能涉及平台条款和风控。商业化前要先解决凭证隔离、访问控制、审计、备份、风控和合规问题。

CPA + NewAPI 的分工是什么？

CPA 负责把账号、OAuth、CLI 或兼容上游转成可调用 API；NewAPI 负责渠道管理、用户 Token、额度、价格和统一出口。