CLIProxyAPI 是什么?

CLIProxyAPI 是一个用 Go 编写的代理服务器,把 Gemini CLI、Antigravity、ChatGPT Codex、Claude Code、Grok Build 等 CLI/订阅工具,通过 OAuth 登录「包装」成 OpenAI/Gemini/Claude/Codex 兼容的 API 接口对外提供,并支持多账号轮询负载均衡。需要首先点明并置于最前的风险:它的本质用途是把面向个人的订阅/CLI 访问转成程序化 API(且支持多账号池化),这通常与 Gemini/OpenAI/Anthropic/xAI 等上游服务商的服务条款相冲突——以非官方方式将消费级订阅 API 化、账号池化/共享、用于转售等,常被这些条款禁止。本页仅作客观编目,不提供搭建或使用指引;是否使用应由读者在充分评估法律、版权、服务条款与账号安全风险后自行判断。许可为 MIT,约 34,450 stars。

⭐ 35,028 Stars 🍴 5,811 Forks Go 作者: router-for-me
来源:README.md(Overview、首段、OAuth/多账号说明);GitHub 仓库描述(wrap ... as API、enjoy the free ... through API);GitHub 仓库元数据(stars=34450、license=MIT) 查看 GitHub 仓库 →

为什么值得关注

围绕「把 AI 订阅/CLI 额度转成 API、低价中转、多账号分摊」形成了一条灰色产业链,CLIProxyAPI 是其中被广泛使用的开源代理之一,README 中列出了大量基于此类中转的商业赞助商(以「官方价 7%/2%/38%」「90% OFF」等折扣售卖中转或账号)。这类热度主要来自成本套利诉求,但伴随明确合规风险。客观记录:截至数据采集约 34,450 stars。需强调:高 star 不代表用途合规——围绕它的生态包含订阅转 API、账号池化/转售等做法,可能违反上游服务商条款并带来账号封禁与法律风险。

来源:README.md(Sponsor 段落中的折扣转售/账号售卖描述);GitHub 仓库元数据(stars=34450)

核心功能

订阅/CLI 转兼容 API(风险项)

把 Gemini CLI、Codex、Claude Code、Grok Build 等通过 OAuth 登录包装成 OpenAI/Gemini/Claude/Codex 兼容 API。需提示:以非官方方式将消费级订阅 API 化通常与上游服务条款相冲突。

来源:README.md(首段、Overview);GitHub 仓库描述
多账号轮询负载均衡(风险项)

对 Gemini/OpenAI/Claude/Grok 的多账号做轮询负载均衡。账号池化/共享常被上游条款禁止,并带来封号与关联风控风险。

来源:README.md(Overview 的 multi-account load balancing 各项)
兼容接口与可嵌入 SDK

支持流式/非流式/WebSocket、函数调用、多模态输入,可经配置接入 OpenAI 兼容上游(如 OpenRouter),并提供可嵌入的 Go SDK 与管理 API。

来源:README.md(Overview、Management API、SDK usage)

技术架构

从公开信息看,CLIProxyAPI 是一个 Go 编写的代理服务器:对外暴露 OpenAI(含 Responses)/Gemini/Claude/Grok 兼容的 API 端点,对内通过 OAuth 登录接入 Gemini CLI、OpenAI Codex、Claude Code、Grok Build 等,并对多账号做轮询负载均衡;支持流式/非流式/WebSocket、函数调用与多模态输入,也可经配置接入 OpenAI 兼容上游(如 OpenRouter),并提供可嵌入的 Go SDK 与管理 API。本页不展开其与各上游 OAuth 对接、账号池化或请求转发的具体实现细节——这类细节涉及对上游服务的非官方访问方式;读者若关注,应以是否符合上游服务条款为前提自行查阅源码。

来源:README.md(Overview 能力列表、Management API、SDK usage)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 各上游 CLI/服务的 OAuth 接入各上游 CLI/服务… 可选 OpenAI 兼容上游(如 OpenRouter)可选 OpenAI 兼… 订阅/CLI 转兼容 API(风险项)订阅/CLI 转兼容 API… 多账号轮询负载均衡(风险项)多账号轮询负载均衡(风… 兼容接口与可嵌入 SDK CLIProxyAPI 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Go框架代理服务器(兼容 OpenAI/Gemini/Claude/Codex API)+ 可嵌入 Go SDK
各上游 CLI/服务的 OAuth 接入可选 OpenAI 兼容上游(如 OpenRouter)
自托管;另有第三方管理中心/用量看板(本页不展开部署)
来源:README.md(Overview、Getting Started、Usage Statistics 列出的第三方工具)

快速上手

出于合规考虑,本页不提供该项目的部署或配置步骤。仅作技术编目:它是可自托管的 Go 代理服务。需要特别提醒——通过 OAuth 把个人订阅/CLI 访问转成 API、对多账号做池化/负载均衡,或将其用于转售,通常违反 Gemini/OpenAI/Anthropic/xAI 等上游服务商的服务条款,可能导致账号封禁、订阅终止乃至法律/合同责任。任何部署前应先确认是否获得上游服务商授权、是否符合其条款。真正合规的等价需求应通过各服务商官方的 API、企业/团队方案与官方计费来满足。
来源:README.md(Overview、Getting Started);合规判断

使用场景

从项目自述看,其面向的是「用本地或多账号 CLI 访问,配合 OpenAI/Gemini/Claude 兼容的客户端与 SDK」——即把订阅/CLI 额度统一 API 化供程序调用。需要客观指出:这些用法绝大多数落在上游服务条款的禁区(订阅非官方 API 化、账号池化/共享、转售)。真正合规的等价需求,应通过各服务商官方 API 与官方计费满足,而非此类代理。本页不推荐将其用于规避上游条款的任何场景。

来源:README.md(Overview、首段);综合合规判断

优势与局限

优势

  • 工程上是一个功能较完整的兼容 API 代理:多协议兼容、多模态、函数调用、可嵌入 SDK
  • Go 实现、支持多账号负载均衡与多种上游接入

局限

  • 核心用途(订阅/CLI 转 API、账号池化、转售额度)通常违反 Gemini/OpenAI/Anthropic/xAI 等上游服务条款
  • 围绕其生态以「官方价极低折扣」售卖中转与账号,指向订阅转售
  • 使用者面临账号封禁、订阅终止、关联风控、数据/支付安全与潜在法律责任
  • 通过 OAuth 持有并复用个人凭证,存在凭证与隐私风险
来源:README.md(Overview、Sponsor 段落);综合 ToS/合规判断

最新版本

本页不追踪该项目的具体发行版变更内容(README 提到自 v6.10.0 起移除了内置用量统计,改由第三方工具承担)。读者如需了解版本细节,应在确认用途合规的前提下自行查阅仓库 releases。

来源:README.md(Usage Statistics 段落,提及 v6.10.0 变更)

总结评价

CLIProxyAPI 在工程上是一个完成度较高的兼容 API 代理,但它的主要用途——把个人 AI 订阅/CLI 访问转成 API、多账号池化、低价转售额度——通常与 Gemini/OpenAI/Anthropic/xAI 等上游服务商的服务条款相冲突,并伴随账号封禁、关联风控、凭证与数据安全以及法律/合同等多重风险。本页只对其性质做客观编目,不提供搭建或使用指引。对有「降低 AI 使用成本」「统一接入」等真实需求的读者,建议走官方 API 与官方计费,而非此类代理。

来源:综合 README.md 的自述与 Sponsor 生态描述、以及上游服务条款与合规判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-24 12:45. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件