Skip to content

Latest commit

 

History

History
325 lines (218 loc) · 26.6 KB

README_CN.md

File metadata and controls

325 lines (218 loc) · 26.6 KB

CLI Proxy API

English | 中文 | 日本語

如果您想在您的桌面使用 CLIProxyAPI,我们推荐您使用我们的 EasyCLIProxyAPI 桌面客户端,该客户端提供了图形化的配置界面、自动更新、系统托盘集成、一键启动/关闭 CLIProxyAPI 服务等功能。

CLIProxyAPI 是一个为 CLI 提供 OpenAI/Gemini/Claude/Codex/Grok 兼容 API 接口的代理服务器。

您可以通过任何与 OpenAI(包括 Responses)、Gemini(包括 Interactions)或 Claude 兼容的客户端或 SDK,以本地方式或多 CLI 账户访问以下提供商。

提供商 说明
Kimi Kimi 系列模型(Kimi K3、K2.8 Preview 等)。Kimi K3 是 Moonshot AI 迄今能力最强的模型,也是全球首个开源 3T 级模型。K3 拥有 2.8T 参数、原生视觉能力与 100 万 Token 上下文,面向长周期编码、知识工作与推理任务。CLIProxyAPI 支持通过 OAuth 或兼容 API 接入 Kimi。立即体验 Kimi Code 订阅(中文站|Global),或前往 Kimi 开放平台(中文站|Global)获取 API Key。感谢 Kimi 对 CLIProxyAPI 及开源社区的支持!
OpenAI OpenAI GPT-6 系列模型(GPT-6 Astra、GPT-6.1 Sol、GPT-6 Luna),也支持通过 Codex OAuth 接入。Astra 适合复杂推理与编程,Sol 兼顾能力与成本,Luna 适合高吞吐量的明确任务。
Anthropic Anthropic Claude 系列模型(Claude Fable 5.1、Claude Opus 5.5、Claude Sonnet 5.5)。Fable 5.1 适合长周期编程与知识工作;Opus 5.5 以更低成本提供强大的智能体编程能力。
Antigravity Google Gemini 系列模型包括 Gemini 3.8 Flash 和 Gemini 3.1 Pro Preview。CLIProxyAPI 支持 Gemini API、AI Studio、Vertex AI、Gemini CLI 与 Antigravity 账户;可用模型因渠道而异。Gemini 3.8 Flash 是 Google 面向长周期软件工程与智能体工作流推出的最新 Flash 模型。
xAI xAI Grok 系列模型(Grok 4.7、Grok 4.7 Build Fast 等)。Grok 4.7 是 SpaceXAI 面向编程、智能体任务与知识工作推出的最新模型。
Meta Meta Muse 系列模型(Muse Spark 1.3、Muse Spark 1.2 等)。CLIProxyAPI 支持通过 Meta 登录接入 Muse Code 账户,也支持 Meta Model API Key;Muse Spark 1.3 面向编程与智能体工作流。
Devin Devin 提供的模型(SWE-2、GPT-6 Astra、Claude Fable 5.1 等)。使用 --devin-login 连接 Devin 账户,即可路由该账户可用的模型。

赞助商

https://www.packyapi.com/register?aff=cliproxyapi

感谢 PackyCode 对本项目的赞助!

PackyCode 是一家可靠高效的 API 中转服务商,提供 Claude Code、Codex、Gemini 等多种服务的中转。

PackyCode 为本软件用户提供了特别优惠:使用此链接注册,并在充值时输入 "cliproxyapi" 优惠码即可享受九折优惠。


AICodeMirror 感谢 AICodeMirror 赞助了本项目!AICodeMirror 提供 Claude Code / Codex / Gemini 官方高稳定中转服务,支持企业级高并发、极速开票、7×24 专属技术支持。 Claude Code / Codex / Gemini 官方渠道低至 3.8 / 0.2 / 0.9 折,充值更有折上折!AICodeMirror 为 CLIProxyAPI 的用户提供了特别福利,通过此链接注册的用户,可享受首充8折,企业客户最高可享 7.5 折!
APIKEY.FUN 感谢 APIKEY.FUN 赞助本项目!APIKEY.FUN 是一家专业的企业级 AI 中转站,致力于为企业和个人开发者提供稳定、高效、低成本的 AI 模型 API 接入服务。平台支持 Claude、OpenAI、Gemini 等主流热门模型,价格低至官方原价的 7%。通过本项目专属链接注册,还可享受最高 充值永久 95 折 专属优惠。
FennoAI FennoAI 是一家稳定、高效的API 中转服务商,目前主要提供 Codex 中转服务,兼容OpenAI 及 Anthropic 协议,可灵活接入 Codex、Claude Code、OpenCode等主流编程工具,可稳定支撑千亿Token/日的企业级调用需求,支持国内及海外主体公对公结算、开票。FennoAI 为 CLIProxyAPI 的用户提供了专属福利:通过专属链接购买订阅,仅需 1.99 美元即可获得价值 50 美元的 Coding Plan 额度。同时支持邀请奖励,邀请好友购买最高可获得 20% 返佣,邀请越多,奖励越高。
七牛云AI 感谢 七牛云AI 赞助本项目!七牛云AI 是七牛云(02567.HK)旗下企业级大模型MaaS平台,一站式调用全球 150+ 主流模型,兼容全球主流模型厂商协议,覆盖文本、图像、音频、视频、文件处理等全模态处理能力,服务超过 169 万企业及开发者用户。专属福利:企业用户免费领 1200万 Token,邀请好友最高得百亿 Token。
Cubence 感谢 Cubence 对本项目的赞助!Cubence 是一家可靠高效的 API 中转服务商,提供 Claude Code、Codex、Gemini 等多种服务的中转。Cubence 为本软件用户提供了特别优惠:使用此链接注册,并在充值时输入 "CLIPROXYAPI" 优惠码即可享受九折优惠。
APIMart 感谢 APIMart 赞助了本项目!APIMart 是专注 AI 图片/视频生成的低价 API 平台,GPT-Image-2 低至 $0.006/张,1 美元可出图 160+ 张。图片、视频一套异步 API 通吃,提交任务拿 ID、回调取结果,跑批万张不超时、换模型不改代码。按量付费、无月费,通过此注册链接注册即可开用。
Swiftproxy Swiftproxy 提供 9000万+ 纯净住宅 IP,覆盖全球 220+ 个国家和地区,支持 HTTP(S)/SOCKS5、IP 轮换、Sticky Session 及精准地域定位。帮助 AI API 工具和自动化工作流从不同地区稳定访问在线服务,适用于 API 请求、网页访问、数据采集及地域测试等场景。住宅代理低至 $0.7/GB,支持免费测试,使用优惠码 PROXY90 可享 9 折优惠。立即体验 Swiftproxy。
Aiberm 本项目由 Aiberm 赞助——为开发者提供统一且优惠的 AI API。通过一个端点即可访问 Claude、GPT、Grok、DeepSeek、GLM、Kimi 和 MiniMax:Claude 优惠 85–90%,GPT 优惠 90%,Grok 优惠 80%。同时支持图片生成,包括 GPT Image 2 和 Nano Banana。访问 Aiberm。
RapidProxy RapidProxy 是一家专为自动化和多账户运营打造的高性能代理服务商,提供纯净住宅代理和原生静态 ISP IP。RapidProxy 拥有遍布全球的 9000 万+住宅 IP,并支持智能轮换、稳定会话和高并发,是网页抓取、浏览器自动化、社交媒体账户管理、电商运营、批量账户注册等场景的理想选择。住宅代理仅 $0.55/GB 起,流量永不过期。使用优惠码 RAPID10 可享 9 折优惠,立即开始免费试用。
PatewayAI PatewayAI 是一家面向资深 AI 开发者的 API 中继服务商,完整支持 Claude 与 Codex 系列模型。所有模型均来自官方高质量渠道,绝无稀释、绝无伪造,计费明细透明可查。经济模式低至 0.5 折,通过此链接注册即可获得试用额度,还可参与不定时营销活动领取免费额度。平台同时支持企业级并发、专属管理后台、正式合同与发票,并提供最高 150 美元的双向推荐奖励。
FluxA & Baidu AI Cloud 感谢 FluxA & Baidu AI Cloud 对本项目的支持! FluxA 与百度智能云联合推出 AgenticPlan,为 AI Agent 提供自主购买/管理/使用模型、API、工具的能力。内含百度千帆 TokenPlan,低至6折,可使用 DeepSeek V4、GLM 5.2、Kimi 等旗舰模型,并获赠 FluxA AgentMarket API的调用额度,解锁搜索、数据抓取、社交媒体、金融、加密、生图、视频等 1000+ 付费 API。

在用户授权下,AI Agent 还可借助官方的Visa卡支付自主采购资源、管理 API Key、监控用量并规划续费,帮助 Agent 从「自主完成任务」升级为真正能够「自主规划预算,完成任务」。进一步了解 AgenticPlan。
OpenLux 感谢 OpenLux 对本项目的赞助!Openlux是一个面向企业的一站式 AI 聚合平台,汇集全球各大厂商主流大模型,平台提供高效、稳定的服务与及时的技术支持。Claude、OpenAI、Gemini 系列模型基准折扣分别低至官方的 0.882 折、0.4 折和 0.8 折。

CLI Proxy API 用户还可享受专属福利:通过专属链接注册,充值最高可享 7.5% 优惠!

立即体验:https://www.openlux.ai/register?channel=c_6axb1q5n

功能特性

  • 为 CLI 模型提供 OpenAI/Gemini/Claude/Codex/Grok 兼容的 API 端点
  • 新增 OpenAI Codex(GPT 系列)支持(OAuth 登录)
  • 新增 Claude Code 支持(OAuth 登录)
  • 新增 Grok Build 支持(OAuth 登录)
  • 支持流式、非流式响应,以及受支持场景下的 WebSocket 响应
  • 函数调用/工具支持
  • 多模态输入(文本、图片)
  • 多账户支持与轮询负载均衡(Gemini、OpenAI、Claude、Grok)
  • 简单的 CLI 身份验证流程(Gemini、OpenAI、Claude、Grok)
  • 支持 Gemini AIStudio API 密钥
  • 支持 AI Studio Build 多账户轮询
  • 支持 Claude Code 多账户轮询
  • 支持 OpenAI Codex 多账户轮询
  • 支持 Grok Build 多账户轮询
  • 通过配置接入上游 OpenAI 兼容提供商(例如 OpenRouter)
  • 可复用的 Go SDK(见 docs/sdk-usage_CN.md)

新手入门

CLIProxyAPI 用户手册: https://help.router-for.me/

管理 API 文档

请参见 MANAGEMENT_API_CN.md

使用量统计

自v6.10.0版本以后,CLIProxyAPI及 CPAMC 项目不再预置数据统计功能,如果有数据统计需求的请使用以下项目:

独立的 CLIProxyAPI 使用量持久化与可视化服务,定期同步 CLIProxyAPI 数据,存储到 SQLite,提供聚合 API,并内置使用量分析与统计仪表盘。

面向 CLIProxyAPI 的完整管理中心,提供请求级监控和费用预估。CPA-Manager 可按账号、模型、渠道、延迟、状态和 token 用量追踪采集到的请求;支持可编辑模型价格与一键同步 LiteLLM 价格来估算费用;用 SQLite 持久化事件;并提供面向 Codex 账号池的批量巡检、配额识别、异常账号定位、清理建议与一键执行能力,适合多账号池的日常运维管理。

SDK 文档

贡献

欢迎贡献!请随时提交 Pull Request。

  1. Fork 仓库
  2. 创建您的功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推送到分支(git push origin feature/amazing-feature)
  5. 打开 Pull Request

谁与我们在一起?

这些项目基于 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 密钥。

原生 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、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 配额窗口、按计划排序、状态着色及多账号汇总分析。

原生 macOS SwiftUI 应用,用于监控 CLIProxyAPI 池中的 ChatGPT/Codex 账号额度。通过 Management API 展示账号可用状态、Plus 基准容量、5 小时与周额度进度条、套餐权重和恢复预测。

面向 AI 编程助手的多智能体编排工具。它将 CLIProxyAPI 作为本地 sidecar 运行,使其智能体可以通过 ChatGPT 订阅驱动 GPT 模型,并将 Claude Code 指向 Anthropic 兼容端点,无需 OpenAI API 密钥。

Windows 桌面 UI,通过单一界面管理 CLIProxyAPI 和 Perplexity WebUI Scraper,灵感来自 Quotio 和 VibeProxy。连接 OAuth 提供商(Claude、Gemini、Codex、Kimi、Antigravity)、自定义 API 密钥和 Perplexity 会话账号,然后将任意编程智能体指向本地端点。

Quotio 的跨平台(Tauri)移植版,支持 Windows / macOS / Linux。通过 CLIProxyAPI 管理多账号代理池(Codex、Claude Code、GitHub Copilot、Gemini、Antigravity、Kiro、Cursor、Trae、GLM),提供每账号 5 小时 / 每周额度进度条、Codex 主动重置次数与一键重置、智能调度、用量统计及 Codex 多开实例,无需 API 密钥。

VS Code 扩展,可将你的 Claude、ChatGPT/Codex、Antigravity、Grok 和 Kimi 订阅作为原生语言模型接入 GitHub Copilot Chat,并且也可用于生成 Git 提交信息、聊天标题和摘要。它以完全托管的后台生命周期运行 CLIProxyAPI(下载、验证、监督),并在所有窗口间共享,因此无需配置。无需 API 密钥,只需 OAuth。

基于 PowerShell 的 Windows CLIProxyAPI 托盘启动工具。支持无终端窗口后台运行、打开管理页面、关闭管理窗口后保持后端运行,并可通过托盘重新打开页面;同时支持启动时自动检查 CLIProxyAPI 更新、SHA-256 校验与失败回滚、一键重启并更新 CLIProxyAPI、基于 PID 校验的进程管理以及安全停止服务。

一个仅支持 HTTP 传输的模型上下文协议(MCP)服务器,使用 CLIProxyAPI 部署为 MCP 客户端提供由 Grok 驱动的实时网页搜索、X/Twitter 搜索和模型发现功能。它还提供 MCP 传输、客户端 API 密钥管理、配额、用量跟踪和 Web 管理面板。

原生 macOS SwiftUI AI 订阅看板与编程代理管理器。可在应用内完整管理官方 CLIProxyAPI 发布版(下载、校验、守护运行、更新与回滚),汇聚 OAuth 账号与实时模型,并将同一网关接入 Codex、Claude Code/Science、OpenCode 或 OpenAI/Anthropic/Gemini 客户端;支持可选局域网访问。

运行多个具有原生体验的 Claude Code 命令,每个命令由不同的模型(Codex、GLM、Kimi、Gemini、Grok、MiniMax、DeepSeek、Cursor、Copilot、Claude)驱动。每个命令都会启动真正的 Claude Code 界面,并拥有独立的配置、历史记录、端口,以及通过 Go SDK 连接的嵌入式 CLIProxyAPI 实例,无需单独安装代理。仅支持 macOS。详情请访问 claude-dialects.cc。

可将 CLIProxyAPI 的本地 OpenAI 兼容端点用作模型提供商的浏览器智能体。通过 EasyCLIProxyAPI 使用 CLIProxyAPI 时,请参阅 WebBrain 提供的独立设置、安全与账号风险指南。

原生 macOS 菜单栏应用,通过 CLIProxyAPI 的管理 API 管理多个 Claude 账号(也支持 claude-swap 与 9Router):5 小时 / 7 天 / 按模型的配额仪表,弹窗内切换 / 暂停 / 星标账号,按当前消耗速度预测各窗口何时耗尽,并可在 iPhone 上同步查看。

基于 Pi SDK 的自托管编程 Agent 平台,提供 Web 界面、并发子 Agent 和 CubeSandbox KVM 工作空间。使用 CLIProxyAPI 作为模型供应商网关,将供应商凭据保留在客户机工作空间之外。

Claude Code 状态栏,按当前 CPA 实例展示 Codex / Grok / Antigravity / Claude 的逐账户额度(5h / 7d / 周)与重置倒计时。根据 ANTHROPIC_BASE_URL 选择实例,通过 Management API 采集额度。

适用于 CLIProxyAPI 的跨平台 Electron 托盘仪表盘。展示 ChatGPT/Codex、Claude、Gemini/Antigravity、Grok、Kimi 和 Cursor 各账户的真实 OAuth 配额窗口,预估用量队列成本,并跟踪 OpenAI/Claude 服务状态。深色终端风格 UI;支持在 Windows 和 Linux 上运行。

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 的端点,具备智能路由、负载均衡、重试及回退机制。通过添加策略、速率限制、缓存和可观测性,确保推理过程既可靠又具备成本意识。

这是一个使用 Tauri 2 + Vue 3 构建的工具,用于管理多个 OpenAI Codex 桌面账户。它可以在已保存的 ChatGPT/Codex 认证配置之间切换,实时查看 5 小时和每周配额使用情况,验证 token 健康状态,查看当前账户详情,并在无需手动复制的情况下导入或保存 auth.json 文件。

Note

如果你开发了 CLIProxyAPI 的移植或衍生项目,请提交 PR 将其添加到此列表中。

许可证

此项目根据 MIT 许可证授权 - 有关详细信息,请参阅 LICENSE 文件。

写给所有中国网友的

QQ 群:188637136(满)、1081218164

或

Telegram 群:https://t.me/CLIProxyAPI