CLIProxyAPI 是一款专为命令行工具设计的代理服务器,提供与 OpenAI、Gemini、Claude、Codex 等主流 AI 模型兼容的 API 接口。通过 OAuth 认证机制,支持本地或跨账户的 CLI 访问,帮助开发者在无需 API 密钥的情况下,安全高效地使用多模型 AI 编码工具。
核心功能与特性
- 多模型兼容:支持 OpenAI、Gemini、Claude、Qwen、iFlow 等主流模型的 API 端点,提供流式与非流式响应
- OAuth 认证:通过 OAuth 登录实现 OpenAI Codex、Claude Code、Qwen Code 等工具的免密钥访问
- 负载均衡:支持多账户轮询负载均衡(Gemini/OpenAI/Claude/Qwen/iFlow),提升服务稳定性
- 智能路由:提供 Amp CLI/IDE 扩展支持,实现模型自动降级与路由映射(如 claude-opus-4.5 → claude-sonnet-4)
- 企业级特性:支持多模态输入(文本/图像)、函数调用、管理 API 及可嵌入的 Go SDK
安装与使用指南
CLIProxyAPI 提供完整的文档支持(官方指南),支持通过配置管理上游提供商(如 OpenRouter)。用户可通过以下方式使用:
- 基础部署:直接运行 CLI 工具,配置账户认证与模型路由规则
- SDK 集成:通过 Go SDK 嵌入代理功能(参考 SDK 文档)
- Amp CLI 集成:支持 Google/ChatGPT/Claude 订阅与 Amp 编码工具无缝对接
生态与扩展项目
CLIProxyAPI 已衍生出多个开源项目,覆盖不同使用场景:
- VibeProxy:macOS 原生菜单栏应用,支持 Claude Code 与 ChatGPT 订阅免密钥使用
- Subtitle Translator:基于浏览器的 SRT 字幕翻译工具,通过 CLIProxyAPI 调用 Gemini 订阅
- CCS (Claude Code Switch):CLI 工具,支持多账户与模型快速切换(Gemini/Codex/Antigravity)
- Proxypal:macOS 图形界面管理工具,支持 OAuth 配置与模型映射
- Quotio:统一 Claude/Gemini/OpenAI 订阅的 macOS 菜单栏应用,提供实时配额追踪
- CodMate:macOS SwiftUI 应用,集成 Git 审查与终端管理功能
- ProxyPilot:Windows 原生 CLIProxyAPI 分支,支持 TUI 与系统托盘集成
- ZeroLimit:Windows 桌面应用,提供 AI 编码助手配额监控与一键代理控制
- LinJun:跨平台 AI 编程助手管理工具,支持多账户配额追踪与一键配置
- Shadow AI:专为受限环境设计的 AI 助手工具,支持局域网跨设备交互
CLIProxyAPI 通过统一的代理架构,解决了多 AI 模型 CLI 工具的认证与路由问题,可为开发者提供灵活、安全且免密钥的 AI 编码解决方案。
