中文 |Community English | 社区中文原版
一个为 CLI 提供 OpenAI/Gemini/Claude/Codex 兼容 API 接口的代理服务器。
现已支持通过 OAuth 登录接入 OpenAI Codex（GPT 系列）和 Claude Code。
您可以使用本地或多账户的CLI方式，通过任何与 OpenAI（包括Responses）/Gemini/Claude 兼容的客户端和SDK进行访问。
- 社区的功能
- 为 CLI 模型提供 OpenAI/Gemini/Claude/Codex 兼容的 API 端点
- 新增 OpenAI Codex（GPT 系列）支持（OAuth 登录）
- 新增 Claude Code 支持（OAuth 登录）
- 支持流式、非流式响应，以及受支持场景下的 WebSocket 响应
- 函数调用/工具支持
- 多模态输入（文本、图片）
- 多账户支持与轮询负载均衡（Gemini、OpenAI、Claude）
- 简单的 CLI 身份验证流程（Gemini、OpenAI、Claude）
- 支持 Gemini AIStudio API 密钥
- 支持 AI Studio Build 多账户轮询
- 支持 Gemini CLI 多账户轮询
- 支持 Claude Code 多账户轮询
- 支持 OpenAI Codex 多账户轮询
- 通过配置接入上游 OpenAI 兼容提供商（例如 OpenRouter）
- 可复用的 Go SDK（见
docs/sdk-usage_CN.md）
- 衍生的功能
- 增加提供商粒度的配置导入导出，以及禁用状态的支持
本项目致力于增强与完善CLIProxyAPI的功能与不足 ，收集与整合在原仓库没有计划（No plans to support this.）的功能。
- 非新增的功能bug从原版走rebase流程
- 代码尽量独立，为了考虑与原版的兼容性
- 代码注释提倡使用中文，方便衍生版本与原版本的区分与维护
%%{init: {'theme': 'base'}}%%
flowchart LR
subgraph upstream["原版仓库"]
direction TB
U1["cli-proxy-api<br/>main"]
end
subgraph local["本项目仓库"]
direction TB
L1["main"]
L2["dev"]
L3["release"]
end
U1 -->|"① 合并原版 main 到本项目 main"| L1
L1 -->|"② 合并本项目 main 到 dev"| L2
L2 -->|"③ 合并 dev 到 release"| L3
style upstream fill:#e1f5fe,stroke:#01579b
style local fill:#fff3e0,stroke:#e65100
style U1 fill:#b3e5fc,stroke:#0277bd
style L1 fill:#ffe0b2,stroke:#ef6c00
style L2 fill:#c8e6c9,stroke:#2e7d32
style L3 fill:#f8bbd9,stroke:#c2185b
- go-code-review/SKILL.md Go 代码审查标准（基于 AGENTS.md 规则）
- gin-api-patterns/SKILL.md Gin 框架最佳实践和中间件模式
- provider-integration/SKILL.md Provider 集成模式（OpenAI/Gemini/Claude/Codex/Vertex）
- oauth-auth-flow/SKILL.md OAuth 认证流程和 token 刷新
- config-sync-design/SKILL.md 配置同步功能设计模式
CLIProxyAPI 用户手册： https://help.router-for.me/
自v6.10.0版本以后，CLIProxyAPI及 CPAMC 项目不再预置数据统计功能，如果有数据统计需求的请使用以下项目：
CPA-Manager 是一个基于 CLI Proxy API 官方管理接口二开的管理和监控面板。 它保留 CPA 原本的管理能力，同时补上了我自己比较需要的几类能力：
- 请求监控和用量统计
- Codex 账号巡检
- 可选的 Usage Service 持久化统计服务
- 项目完全开源
独立的 CLIProxyAPI 使用量持久化与可视化服务，定期同步 CLIProxyAPI 数据，存储到 SQLite，提供聚合 API，并内置使用量分析与统计仪表盘。
面向 CLIProxyAPI 的本地优先使用量与配额看板。它从 Redis 兼容使用量队列采集每次请求的 Token 消耗并写入 SQLite，按账号和模型可视化每日及最近时间窗口的用量，并在本地网页中显示 Codex 5h/7d 配额余量。
面向 CLIProxyAPI 的完整管理中心，提供请求级监控和费用预估。CPA-Manager 可按账号、模型、渠道、延迟、状态和 token 用量追踪采集到的请求；支持可编辑模型价格与一键同步 LiteLLM 价格来估算费用；用 SQLite 持久化事件；并提供面向 Codex 账号池的批量巡检、配额识别、异常账号定位、清理建议与一键执行能力，适合多账号池的日常运维管理。
CLIProxyAPI 已内置对 Amp CLI 和 Amp IDE 扩展的支持，可让你使用自己的 Google/ChatGPT/Claude OAuth 订阅来配合 Amp 编码工具：
- 提供商路由别名，兼容 Amp 的 API 路径模式（
/api/provider/{provider}/v1...） - 管理代理，处理 OAuth 认证和账号功能
- 智能模型回退与自动路由
- 以安全为先的设计，管理端点仅限 localhost
当你需要某一类后端的请求/响应协议形态时，优先使用 provider-specific 路径，而不是合并后的 /v1/... 端点：
- 对于 messages 风格的后端，使用
/api/provider/{provider}/v1/messages。 - 对于按模型路径暴露生成接口的后端，使用
/api/provider/{provider}/v1beta/models/...。 - 对于 chat-completions 风格的后端，使用
/api/provider/{provider}/v1/chat/completions。
这些路径有助于选择协议表面，但当多个后端复用同一个客户端可见模型名时，它们本身并不能保证唯一的推理执行器。实际的推理路由仍然根据请求里的 model/alias 解析。若要严格钉住某个后端，请使用唯一 alias、前缀，或避免让多个后端暴露相同的客户端模型名。
- 使用文档：docs/sdk-usage_CN.md
- 高级（执行器与翻译器）：docs/sdk-advanced_CN.md
- 认证: docs/sdk-access_CN.md
- 凭据加载/更新: docs/sdk-watcher_CN.md
- 自定义 Provider 示例：
examples/custom-provider
这些项目基于 CLIProxyAPI:
一个原生 macOS 菜单栏应用，让您可以使用 Claude Code & ChatGPT 订阅服务和 AI 编程工具，无需 API 密钥。
一款跨平台的桌面和 Web 应用程序，可通过 CLIProxyAPI 使用您现有的 LLM 订阅（Gemini、ChatGPT、Claude, etc.）来翻译和验证 SRT 字幕 - 无需 API 密钥。
CLI 封装器，用于通过 CLIProxyAPI OAuth 即时切换多个 Claude 账户和替代模型（Gemini, Codex, Antigravity），无需 API 密钥。
原生 macOS 菜单栏应用，统一管理 Claude、Gemini、OpenAI 和 Antigravity 订阅，提供实时配额追踪和智能自动故障转移，支持 Claude Code、OpenCode 和 Droid 等 AI 编程工具，无需 API 密钥。
原生 macOS SwiftUI 应用，用于管理 CLI AI 会话（Claude Code、Codex、Gemini CLI），提供统一的提供商管理、Git 审查、项目组织、全局搜索和终端集成。集成 CLIProxyAPI 为 Codex、Claude、Gemini 和 Antigravity 提供统一的 OAuth 认证，支持内置和第三方提供商通过单一代理端点重路由 - OAuth 提供商无需 API 密钥。
原生 Windows CLIProxyAPI 分支，集成 TUI、系统托盘及多服务商 OAuth 认证，专为 AI 编程工具打造，无需 API 密钥。
一款 VSCode 扩展，提供了在 VSCode 中快速切换 Claude Code 模型的功能，内置 CLIProxyAPI 作为其后端，支持后台自动启动和关闭。
Windows 桌面应用，基于 Tauri + React 构建，用于通过 CLIProxyAPI 监控 AI 编程助手配额。支持跨 Gemini、Claude、OpenAI Codex 和 Antigravity 账户的使用量追踪，提供实时仪表盘、系统托盘集成和一键代理控制，无需 API 密钥。
面向 CLIProxyAPI 的 Web 管理面板，提供健康检查、资源监控、日志查看、自动更新、请求统计与定价展示，支持一键安装与 systemd 服务。
Windows 托盘应用，基于 PowerShell 脚本实现，不依赖任何第三方库。主要功能包括：自动创建快捷方式、静默运行、密码管理、通道切换（Main / Plus）以及自动下载与更新。
霖君是一款用于管理AI编程助手的跨平台桌面应用，支持macOS、Windows、Linux系统。统一管理Claude Code、Gemini CLI、OpenAI Codex等AI编程工具，本地代理实现多账户配额跟踪和一键配置。
一个面向 CLIProxyAPI 的现代化 Web 管理仪表盘，基于 Next.js、React 和 PostgreSQL 构建。支持实时日志流、结构化配置编辑、API Key 管理、Claude/Gemini/Codex 的 OAuth 提供方集成、使用量分析、容器管理，并可通过配套插件与 OpenCode 同步配置，无需手动编辑 YAML。
用于一站式管理 New API 兼容中转站账号的浏览器扩展，提供余额与用量看板、自动签到、密钥一键导出到常用应用、网页内 API 可用性测试，以及渠道与模型同步和重定向。支持通过 CLIProxyAPI Management API 一键导入 Provider 与同步配置。
Shadow AI 是一款专为受限环境设计的 AI 辅助工具。提供无窗口、无痕迹的隐蔽运行方式，并通过局域网实现跨设备的 AI 问答交互与控制。本质上是一个「屏幕/音频采集 + AI 推理 + 低摩擦投送」的自动化协作层，帮助用户在受控设备/受限环境下沉浸式跨应用地使用 AI 助手。
跨平台桌面应用（macOS、Windows、Linux），以原生 GUI 封装 CLIProxyAPI。支持连接 Claude、ChatGPT、Gemini、GitHub Copilot 及自定义 OpenAI 兼容端点，具备使用分析、请求监控和热门编程工具自动配置功能，无需 API 密钥。
上手即用的面向 CLIProxyAPI 跨平台配额查询工具，支持按账号展示 codex 5h/7d 配额窗口、按计划排序、状态着色及多账号汇总分析。
基于 CLIProxyAPI 的 Windows Codex CLI 本地优先桌面管理平台，聚焦简化本机配置、账号与运行状态管理，并为本地用户提供更完整的 Codex CLI 使用体验。
原生 macOS SwiftUI 应用，用于监控 CLIProxyAPI 池中的 ChatGPT/Codex 账号额度。通过 Management API 展示账号可用状态、Plus 基准容量、5 小时与周额度进度条、套餐权重和恢复预测。
Note
如果你开发了基于 CLIProxyAPI 的项目，请提交一个 PR（拉取请求）将其添加到此列表中。
以下项目是 CLIProxyAPI 的移植版或受其启发：
基于 Next.js 的实现，灵感来自 CLIProxyAPI，易于安装使用；自研格式转换（OpenAI/Claude/Gemini/Ollama）、组合系统与自动回退、多账户管理（指数退避）、Next.js Web 控制台，并支持 Cursor、Claude Code、Cline、RooCode 等 CLI 工具，无需 API 密钥。
代码不止，创新不停。智能路由至免费及低成本 AI 模型，并支持自动故障转移。
OmniRoute 是一个面向多供应商大语言模型的 AI 网关：它提供兼容 OpenAI 的端点，具备智能路由、负载均衡、重试及回退机制。通过添加策略、速率限制、缓存和可观测性，确保推理过程既可靠又具备成本意识。
一个公开的 CLIProxyAPI 兼容二开版本和配套管理面板，尽量保持与上游一致的使用方式，同时恢复内置使用量统计，并补充缓存命中率、首字响应时间、TPS 记录和面向 Docker 自托管的安装说明。
Note
如果你开发了 CLIProxyAPI 的移植或衍生项目，请提交 PR 将其添加到此列表中。
此项目根据 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE 文件。
QQ 群：188637136（满）、1081218164
或
Telegram 群：https://t.me/CLIProxyAPI