CLIProxyAPI 是一个代理服务器,旨在为命令行(CLI)AI 工具提供 OpenAI、Gemini、Claude、Codex、Grok 兼容的 API 接口。通过它,用户可以在本地使用任意 OpenAI(含 Responses)、Gemini(含 Interactions)或 Claude 兼容的客户端或 SDK,访问多个 CLI 账号所对应的模型服务。
主要能力包括:
- 提供 OpenAI/Gemini/Claude/Grok 兼容的 API 端点,用于 CLI 模型。
- 通过 OAuth 登录支持 OpenAI Codex(GPT 系列)、Claude Code、Grok Build。
- 在支持的情况下提供流式、非流式及 WebSocket 响应。
- 支持函数调用/工具调用。
- 支持多模态输入(文本与图像)。
- 支持多账号轮询负载均衡(Gemini、OpenAI、Claude、Grok)。
- 提供简单的 CLI 认证流程(Gemini、OpenAI、Claude、Grok)。
- 支持 Generative Language API Key。
- 支持 AI Studio Build 多账号负载均衡、Claude Code 多账号负载均衡、OpenAI Codex 多账号负载均衡、Grok Build 多账号负载均衡。
- 可通过配置接入 OpenAI 兼容的上游提供商(例如 OpenRouter)。
- 提供可复用的 Go SDK,用于嵌入代理(参见 docs/sdk-usage.md)。
使用方式: 项目提供 CLIProxyAPI 指南(https://help.router-for.me/),并包含管理 API 文档(MANAGEMENT_API.md)。用户可通过 CLI 认证流程登录各提供商账号,然后使用兼容的客户端或 SDK 连接本地代理端点。若希望在桌面端使用,官方推荐 EasyCLIProxyAPI 桌面客户端,提供图形化配置界面、自动更新、系统托盘集成以及一键启动/停止服务。
自 v6.10.0 起,CLIProxyAPI 和 CPAMC 不再内置使用统计功能。如需统计,可使用 CPA Usage Keeper(独立持久化与可视化服务,支持定期数据同步、SQLite 存储、聚合 API 及内置仪表板)或 CPA-Manager-Plus(自托管管理控制台与可观测性仪表板,支持 OAuth 凭据管理、AI 提供商管理、客户端 API 密钥、模型别名、插件及 CPA 设置,提供请求历史、实时监控、故障诊断、令牌/延迟/预估成本分析等)。
适用场景:
- 希望将已有的 AI CLI 订阅(如 Claude Code、ChatGPT Codex、Gemini、Grok 等)通过标准 API 接口提供给其他工具或应用使用。
- 需要在多个 CLI 账号之间进行负载均衡,以提高可用性或分摊配额。
- 开发基于 OpenAI/Gemini/Claude 兼容接口的应用,但希望后端使用 CLI 订阅而非直接 API 密钥。
- 通过 Go SDK 将代理能力嵌入自有项目。
限制与说明:
- 项目本身不提供模型,仅作为代理转发请求至各 CLI 提供商。
- 使用统计功能需依赖第三方项目(CPA Usage Keeper、CPA-Manager-Plus 等)。
- 部分功能(如 WebSocket 响应)取决于上游提供商的支持情况。
- 具体安装步骤、系统要求、收费模式等未在提供资料中详细说明,暂未提供。