router-for-me/CLIProxyAPI
GitHub: router-for-me/CLIProxyAPI
将 Gemini CLI、Claude Code、ChatGPT Codex 等 AI 编程助手的 CLI 访问转换为标准 API 接口,让用户通过 OAuth 订阅账户而非 API key 来调用 AI 能力。
Stars: 19303 | Forks: 3139
# CLI Proxy API
English | [中文](README_CN.md)
一个代理服务器,为 CLI 提供与 OpenAI/Gemini/Claude/Codex 兼容的 API 接口。
它现在还通过 OAuth 支持 OpenAI Codex (GPT 模型) 和 Claude Code。
因此,你可以在本地或多账户 CLI 访问中使用与 OpenAI(包含 Responses)/Gemini/Claude 兼容的客户端和 SDK。
## 概述
- 为 CLI 模型提供 OpenAI/Gemini/Claude 兼容的 API 端点
- 通过 OAuth 登录支持 OpenAI Codex (GPT 模型)
- 通过 OAuth 登录支持 Claude Code
- 通过 OAuth 登录支持 Qwen Code
- 通过 OAuth 登录支持 iFlow
- 支持带有 provider 路由的 Amp CLI 和 IDE 扩展
- 支持流式和非流式响应
- 支持函数调用/工具
- 支持多模态输入(文本和图像)
- 多账户轮询负载均衡(Gemini、OpenAI、Claude、Qwen 和 iFlow)
- 简单的 CLI 认证流程(Gemini、OpenAI、Claude、Qwen 和 iFlow)
- 支持 Generative Language API Key
- AI Studio Build 多账户负载均衡
- Gemini CLI 多账户负载均衡
- Claude Code 多账户负载均衡
- Qwen Code 多账户负载均衡
- iFlow 多账户负载均衡
- OpenAI Codex 多账户负载均衡
- 通过配置支持 OpenAI 兼容的上游 provider(例如 OpenRouter)
- 可复用的 Go SDK,用于嵌入代理(参见 `docs/sdk-usage.md`)
## 快速开始
CLIProxyAPI 指南:[https://help.router-for.me/](https://help.router-for.me/)
## 管理 API
参见 [MANAGEMENT_API.md](https://help.router-for.me/management/api)
## Amp CLI 支持
CLIProxyAPI 包含对 [Amp CLI](https://ampcode.com) 和 Amp IDE 扩展的集成支持,让你能够通过 Amp 的编码工具使用你的 Google/ChatGPT/Claude OAuth 订阅:
- Amp API 模式的 Provider 路由别名(`/api/provider/{provider}/v1...`)
- 用于 OAuth 认证和账户功能的管理代理
- 具有自动路由功能的智能模型回退
- **模型映射**,用于将不可用的模型路由到替代方案(例如 `claude-opus-4.5` → `claude-sonnet-4`)
- 安全优先的设计,仅限 localhost 的管理端点
**→ [完整的 Amp CLI 集成指南](https://help.router-for.me/agent-client/amp-cli.html)**
## SDK 文档
- 用法:[docs/sdk-usage.md](docs/sdk-usage.md)
- 高级用法(executors & translators):[docs/sdk-advanced.md](docs/sdk-advanced.md)
- 访问控制:[docs/sdk-access.md](docs/sdk-access.md)
- 监视器:[docs/sdk-watcher.md](docs/sdk-watcher.md)
- 自定义 Provider 示例:`examples/custom-provider`
## 谁在使用?
这些项目基于 CLIProxyAPI:
### [vibeproxy](https://github.com/automazeio/vibeproxy)
原生 macOS 菜单栏应用,让你可以在 AI 编码工具中使用 Claude Code 和 ChatGPT 订阅——无需 API keys
### [Subtitle Translator](https://github.com/VjayC/SRT-Subtitle-Translator-Validator)
基于浏览器的工具,通过 CLIProxyAPI 使用你的 Gemini 订阅翻译 SRT 字幕,带有自动验证/错误修正功能——无需 API keys
### [CCS (Claude Code Switch)](https://github.com/kaitranntt/ccs)
CLI 包装器,用于通过 CLIProxyAPI OAuth 在多个 Claude 账户和替代模型(Gemini、Codex、Antigravity)之间即时切换——无需 API keys
### [ProxyPal](https://github.com/heyhuynhgiabuu/proxypal)
原生 macOS GUI,用于管理 CLIProxyAPI:通过 OAuth 配置 provider、模型映射和端点——无需 API keys。
### [Quotio](https://github.com/nguyenphutrong/quotio)
原生 macOS 菜单栏应用,统一 Claude、Gemini、OpenAI、Qwen 和 Antigravity 订阅,为 Claude Code、OpenCode 和 Droid 等 AI 编码工具提供实时配额跟踪和智能自动故障转移——无需 API keys。
### [CodMate](https://github.com/loocor/CodMate)
原生 macOS SwiftUI 应用,用于管理 CLI AI 会话(Codex、Claude Code、Gemini CLI),具有统一的 provider 管理、Git review、项目组织、全局搜索和终端集成功能。集成 CLIProxyAPI 为 Codex、Claude、Gemini、Antigravity 和 Qwen Code 提供 OAuth 认证,并通过单一代理端点提供内置和第三方 provider 重路由——OAuth provider 无需 API keys。
### [ProxyPilot](https://github.com/Finesssee/ProxyPilot)
Windows 原生 CLIProxyAPI 分支,带有 TUI、系统托盘和多 provider OAuth,适用于 AI 编码工具——无需 API keys。
### [Claude Proxy VSCode](https://github.com/uzhao/claude-proxy-vscode)
用于快速切换 Claude Code 模型的 VSCode 扩展,以集成的 CLIProxyAPI 作为后端,并具有自动后台生命周期管理功能。
### [ZeroLimit](https://github.com/0xtbug/zero-limit)
使用 Tauri + React 构建的 Windows 桌面应用,用于通过 CLIProxyAPI 监控 AI 编码助手配额。跨 Gemini、Claude、OpenAI Codex 和 Antigravity 账户跟踪使用情况,具有实时仪表板、系统托盘集成和一键代理控制功能——无需 API keys。
### [CPA-XXX Panel](https://github.com/ferretgeek/CPA-X)
CLIProxyAPI 的轻量级 Web 管理面板,具有健康检查、资源监控、实时日志、自动更新、请求统计和价格显示。支持一键安装和 systemd 服务。
### [CLIProxyAPI Tray](https://github.com/kitephp/CLIProxyAPI_Tray)
使用 PowerShell 脚本实现的 Windows 托盘应用程序,不依赖任何第三方库。主要功能包括:自动创建快捷方式、静默运行、密码管理、通道切换(Main / Plus)以及自动下载和更新。
### [霖君](https://github.com/wangdabaoqq/LinJun)
霖君是一个用于管理 AI 编程助手的跨平台桌面应用程序,支持 macOS、Windows 和 Linux 系统。统一管理 Claude Code、Gemini CLI、OpenAI Codex、Qwen Code 等 AI 编码工具,提供本地代理以进行多账户配额跟踪和一键配置。
### [CLIProxyAPI Dashboard](https://github.com/itsmylife44/cliproxyapi-dashboard)
使用 Next.js、React 和 PostgreSQL 构建的现代化 CLIProxyAPI Web 管理仪表板。功能包括实时日志流、结构化配置编辑、API key 管理、Claude/Gemini/Codex 的 OAuth provider 集成、使用分析、容器管理,以及通过配套插件与 OpenCode 进行配置同步——无需手动编辑 YAML。
### [All API Hub](https://github.com/qixing-jk/all-api-hub)
浏览器扩展,用于一站式管理 New API 兼容的中转站账户,具有余额和使用量仪表板、自动签到、一键将 key 导出到常用应用、页面内 API 可用性测试以及通道/模型同步和重定向功能。它通过 Management API 与 CLIProxyAPI 集成,实现一键 provider 导入和配置同步。
### [Shadow AI](https://github.com/HEUDavid/shadow-ai)
Shadow AI 是一款专为受限环境设计的 AI 助手工具。它提供了一种无窗口、无痕迹的隐形操作
模式,并可通过局域网(LAN)实现跨设备的 AI 问答交互和控制。本质上,它是一个“屏幕/音频捕获 + AI 推理 +
低摩擦交付”的自动化协作层,帮助用户在受控设备或受限环境中跨应用沉浸式使用 AI 助手。
## 更多选择
这些项目是 CLIProxyAPI 的移植版本或受其启发:
### [9Router](https://github.com/decolua/9router)
受 CLIProxyAPI 启发的 Next.js 实现,易于安装和使用,从零开始构建,具有格式转换(OpenAI/Claude/Gemini/Ollama)、带有自动回退的 combo 系统、带有指数退避的多账户管理、Next.js Web 仪表板,并支持 CLI 工具(Cursor、Claude Code、Cline、RooCode)——无需 API keys。
### [OmniRoute](https://github.com/diegosouzapw/OmniRoute)
永不停歇的编码。智能路由到免费和低成本的 AI 模型,并具有自动回退功能。
OmniRoute 是一个多 provider LLM 的 AI 网关:一个 OpenAI 兼容的端点,具有智能路由、负载均衡、重试和回退功能。添加策略、速率限制、缓存和可观察性,以实现可靠、具有成本意识的推理。
## 许可证
本项目基于 MIT 许可证授权 - 详见 [LICENSE](LICENSE) 文件。
标签:AI 网关, Amp CLI, API 代理, API 聚合, ChatGPT, ChatGPT Codex, Claude, Claude Code, Codex, CVE检测, EVTX分析, Gemini 2.5 Pro, Gemini CLI, Go SDK, GPT-5, iFlow, LLM 代理, OAuth 认证, OpenAI 兼容, Promptflow, Qwen, Qwen Code, 免费 API, 函数调用, 反向代理, 多模态, 多账号管理, 大模型网关, 威胁情报, 开发者工具, 接口转换, 日志审计, 流式响应, 请求拦截, 负载均衡, 路由转发