简介#
CLIProxyAPI（常简写为 CPA）将 Gemini CLI、Antigravity、ChatGPT Codex、Claude Code、Qwen Code、iFlow 等 CLI 的访问能力，统一封装为 OpenAI / Gemini / Claude / Codex 兼容 API。使用各产品的订阅账号即可通过兼容客户端和 SDK 调用，无需单独购买 API Key。
核心价值：订阅即 API、多端复用（Cursor / Cline / Roo Code / OpenCode / Amp 等）、多账户轮询与故障转移。
CPA 与 CCR 的区别#
- CPA（CLIProxyAPI）：反代/聚合各渠道模型，对外提供统一的 API Endpoint（URL）与鉴权方式（Key）。
- CCR：将 Claude Code 的请求路由到其他（非 Anthropic）模型提供方。
快速开始#
安装与首次运行#
quotio macOS 用户可优先使用 一键安装/管理（会自动安装 CLIProxyAPI / CPA）。
- 从 Releases 下载对应平台版本并解压。
- 编辑
config.yaml，重点配置：port：服务端口（默认 8317）api-keys：调用模型时的认证密钥（可多个）secret-key：管理接口密钥（Web UI 连接时使用）proxy-url: 如需访问codex等模型需要设置代理 （socks5://127.0.0.1:7897）
- 启动程序（如 Windows 下运行
cli-proxy-api.exe）。
配置项说明见： 基础配置 。
管理方式#
- Web UI（推荐）：内置管理界面，启动服务后访问
http://<host>:<port>/management.html，输入管理密钥即可使用。详见 Web UI 说明 。 - 桌面客户端： EasyCLI 跨平台桌面客户端，详见 桌面客户端说明 。
调用方式#
- cc-switch — 配置代理地址后可供 Claude Code 等编码工具使用
- Cherry AI — 配置代理地址后可进行直接对话
- Chatbox AI — 配置代理地址后可进行直接对话
相关项目#
- quotio — macOS（推荐）一键安装/管理，包含自动安装 CLIProxyAPI（CPA）。
- EasyCLI — 跨平台 CPA 桌面客户端
- Cli-Proxy-API-Management-Center — 官方 Web 管理面板
- CPA-Dashboard — 社区 Dashboard
- batch-auth-manager — 批量认证管理工具