CLIProxyAPI (CPA)：把 CLI AI 工具变成 API

📋 概览

CPA（CLI Proxy API）是一个开源代理服务器，核心作用是将 Codex CLI、Claude Code、Gemini CLI、Grok Build 等终端交互式 AI 工具包装成兼容 OpenAI / Gemini / Claude 标准的 HTTP API 服务。

你的 AI 客户端
OpenClaw · Cursor · Cline

→

CPA 代理服务器

→

Codex · Claude Code
Gemini CLI · Grok Build

底层 AI 工具（订阅制，OAuth 登录）

原始项目是 router-for-me/CLIProxyAPI，Go 语言编写，MIT 协议开源，社区活跃度极高（近 300 个 PR、48+ Issue、20+ 衍生项目）。

一句话： CPA 让你可以用 订阅账号（Plus/Pro） 跑 API 级别的调用，省掉 API Key 费用，还能多账号轮询不怕限额。

🤔 为什么需要 CPA？

OpenAI Codex CLI、Claude Code、Gemini CLI 这些工具很强，但它们有一个共同问题——只有终端交互模式。它们用 OAuth 登录你的订阅账号，在终端里用，不提供 HTTP API 端点。

这意味着：

你没法用自己喜欢的客户端（比如 Cursor、OpenClaw、Cline）去调用它们的模型
账号有 5 小时 / 7 天等使用限制，一个号用完了干瞪眼
官方 API Key 贵（尤其 Claude 和 GPT），按月订阅反而更划算

CPA 在中间插了一层：

┌──────────────────┐     ┌──────────────────┐     ┌───────────────────────┐
│  你的 AI 客户端   │ → → │ CPA 代理服务器    │ → → │ Codex CLI (已登录OAuth)│
│  (OpenAI 格式)    │ ← ← │ (localhost:8080)  │ ← ← │ Claude Code (已登录)   │
└──────────────────┘     └──────────────────┘     │ Gemini CLI (已登录)    │
                                                   │ Grok Build (已登录)    │
                                                   └───────────────────────┘

你做 API 调用时，CPA 帮你转发给本地已登录的某个 CLI 工具，拿到结果再返回给你。客户端完全无感知。

🎯 核心功能

协议兼容

协议	端点	说明
OpenAI Chat Completions	`/v1/chat/completions`	主流客户端首选
OpenAI Responses	`/v1/responses`	GPT 最新协议
Gemini	`/v1/gemini/*`	含 Interactions 协议
Claude	`/v1/messages`	Anthropic 格式
Codex	`/v1/codex/*`	Codex 原生协议

功能清单

流式 / 非流式 / WebSocket 响应
函数调用 / Tool Use — 完整保留底层模型的工具调用能力
多模态 — 文本 + 图片输入
多账户轮询 — 配置多个账号，CPA 自动负载均衡（支持权重）
简单 OAuth 流程 — 一行命令扫码登录，自动刷新 Token
可对接 OpenAI 兼容上游 — 比如 OpenRouter，扩展模型池
Go SDK — 二次开发友好

🔌 支持的提供商

提供商	接入方式	可调用模型
OpenAI	OAuth 登录 Codex CLI	GPT 5.6、GPT 5.5 等全系列
Anthropic	OAuth 登录 Claude Code	Claude Fable 5、Opus 4.8、Sonnet 4.7 等
Google	OAuth + API Key	Gemini 3.5 Flash、Gemini 3.1 Pro 等
xAI	OAuth 登录 Grok Build	Grok 4.5、Composer 2.5 Fast 等
Kimi	OAuth / API Key	Kimi K3、K2.7 Code 等
自定义上游	OpenAI 兼容 API	对接任意 API 中转站

🔑 关键区别： 前五家都走订阅账号——你登录的是 Plus/Pro 账号，用订阅配额，而不是按 token 计费的 API Key。这通常是更经济的方案。

🚀 快速上手

安装

# Docker 一键启动
docker run -d --name cpa -p 8080:8080 \
  -v $(pwd)/config.yaml:/app/config.yaml \
  -v $(pwd)/auths:/app/auths \
  ghcr.io/router-for-me/cliproxyapi:latest

# 或者直接下载二进制
curl -sSL https://github.com/router-for-me/CLIProxyAPI/releases/latest/download/cliproxyapi-linux-amd64.tar.gz | tar xz
./cliproxyapi

配置

# config.yaml 示例
port: 8080
providers:
  codex:
    credentials:
      - type: oauth
        auth_dir: auths/codex
        weight: 1
  claude:
    credentials:
      - type: oauth
        auth_dir: auths/claude
        weight: 2

使用

# 客户端配置 — 指向 CPA 地址即可
# 比如 OpenClaw:
openclaw config set api_base "http://localhost:8080/v1"

# curl 测试
curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"你好"}]}'

🌳 生态衍生

CPA 周边已经长出了一整片生态工具，覆盖管理面板、桌面应用、VSCode 插件等：

项目	说明
CCS (Claude Code Switch)	CLI 封装器，一键切换多 Claude 账户和替代模型
CPA-Manager-Plus	Web 管理面板：请求监控、费用预估、账号巡检
CPA Usage Keeper	用量持久化 + SQLite + 可视化仪表盘
VibeProxy	macOS 菜单栏应用，一键启动 CPA
Quotio	多账号配额追踪 + 智能故障转移（macOS）
ProxyPilot	Windows 原生分支，TUI + 系统托盘
Claude Proxy VSCode	VSCode 扩展，后台切换 Claude Code 模型
ZeroLimit	Windows 桌面应用，跨账号配额监控
CPA-XXX Panel	健康检查 + 日志 + 自动更新 Web 面板
CLIProxyAPI Dashboard	Next.js 现代化仪表盘 + PostgreSQL
CPA Tray	Windows 托盘，静默运行 + 密码管理
Claude Dialects	同时启动多个 Claude Code 实例，每个配不同模型

📦 还不止这些： 另有霖君、AIUsage、Quotio Desktop、ProxyPal、Panopticon、Tunnel Agent 等十多个桌面端和 Web 应用也围绕 CPA 构建。整个生态的核心思路一致——用订阅账号跑 API 级能力，多账号池化提高可用性。

✅ 优缺点分析

优势

省钱： 用订阅（$20/mo Plus 或 $200/mo Pro）替代 API Key 按量计费，重度用户省很多
多账号池化： 多个订阅账号轮流用，突破 5 小时限制
开源免费： Go 单文件二进制，Docker 部署，零依赖
生态丰富： 大量周边工具降低了使用门槛
协议统一： 不管底层是什么模型，对外统一暴露 OpenAI 格式

缺点 / 坑

多一层运维： CPA 本身要跑着，掉线了就全瘫
冷启动需重登录： Codex 偶尔会被要求重新扫码登录，无法完全无人值守
配置门槛： YAML 配置 + OAuth 文件管理，新手需要点学习成本
延迟增加： 多一层代理转发，网络往返多了毫秒级开销
账号被封风险： 大量使用 CPA 轮询可能触发 OpenAI/Anthropic 的风控

CLIProxyAPI (CPA) 完全介绍