router-for-me/CLIProxyAPI

⭐ 31,785 · Go · GitHub 仓库

将Gemini CLI、Antigravity、ChatGPT Codex、Claude Code封装为兼容OpenAI/Gemini/Claude/Codex的API服务，让您通过API免费畅享Gemini 3.1 Pro、GPT 5.5、Claude模型。

antigravity claude-code cluade codex gemini openai

一句话总结

通过OAuth代理实现免费AI API——将CLI工具包装成OpenAI/Gemini/Claude端点，无需API密钥。

🔥 核心能力与独特卖点

零API密钥要求 – 采用OAuth认证对接OpenAI Codex、Claude Code和Gemini CLI。彻底消除付费API密钥需求，充分利用你现有的订阅凭证。
多供应商统一代理 – 提供单一代理端点，兼容OpenAI、Gemini、Claude和Codex API格式。解决碎片化问题，无需为每个AI供应商维护独立的客户端。
多账户负载均衡 – 按轮询机制在多个账户间分配请求。防止速率限制和单账户节流，适合运行并发工作负载的重度用户。
流式与多模态支持 – 全面支持流式、非流式、WebSocket响应、函数调用/工具以及多模态输入（文本+图像）。匹配原生API能力，同时使用基于CLI的模型。
IDE与Amp CLI集成 – 内置供应商路由、模型映射以及Amp CLI和IDE扩展的智能回退。实现无缝替换，无缝融入现有AI编码工作流。

独特卖点：唯一能将基于CLI的AI工具（通常免费或基于订阅）转化为标准API端点的代理，通过熟悉的API接口，让你免费或低成本访问Gemini 3.1 Pro、GPT 5.5、Claude等顶级模型。

Architecture

技术架构

组件	详情
编程语言	Go（单二进制部署）
核心模式	反向代理服务器 + 协议转换
后端供应商	Gemini CLI、OpenAI Codex、Claude Code、Antigravity
API兼容性	OpenAI `/v1/chat/completions`、Gemini `/v1beta/models`、Claude `/v1/messages`、Codex端点
认证方式	OAuth 2.0流程获取凭证（不存储API密钥）
负载均衡	跨多个账户的轮询调度器
协议支持	REST、WebSocket、服务器推送事件（流式）
可扩展性	可复用的Go SDK，便于嵌入其他应用
管理功能	管理API端点，支持配置与健康监控

快速入门指南

设置仅需三步：

下载二进制文件 – 从发布页面获取对应操作系统（Linux、macOS、Windows）的版本。
配置供应商 – 通过OAuth为每个要代理的CLI工具完成认证。
运行代理服务器 – 将现有的OpenAI/Gemini/Claude SDK客户端指向http://localhost:8080。

bash

# 下载并运行代理（Linux示例）
wget https://github.com/router-for-me/CLIProxyAPI/releases/latest/download/cliproxyapi-linux-amd64
chmod +x cliproxyapi-linux-amd64

# 启动代理服务器（首次请求时会触发交互式OAuth登录）
./cliproxyapi-linux-amd64 --port 8080

# 配合任何兼容OpenAI的客户端使用
curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-pro",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

优缺点与使用场景

优点

零成本 – 无需API密钥费用；利用现有订阅或免费套餐。
即插即用 – 无需修改代码，即可与任何OpenAI/Gemini/Claude SDK配合使用。
多账户弹性 – 负载均衡防止因速率限制导致的单点故障。
OAuth简洁性 – 无需密钥管理、轮换，也无密钥泄露的安全风险。
持续活跃开发 – 31.7K星标与近期更新，表明社区活跃且维护良好。

缺点

需要本地基础设施 – 必须在本地机器或网络上运行并维护代理服务器。
统计依赖外部工具 – 使用统计需借助独立的第三方工具/服务。
OAuth会话管理 – 凭证可能过期，需要重新认证。
第三方依赖 – 部分功能依赖外部赞助商/服务才能完整使用。
CLI工具可用性 – 需要底层CLI工具（Gemini CLI、Claude Code等）已安装并能正常运行。

谁不适合使用？

合规要求严格的企业团队 – OAuth认证可能不符合要求API密钥管理的企业安全策略。
没有现有订阅的用户 – 代理需要底层CLI工具的有效订阅；它不提供模型的免费访问。
无服务器/边缘部署场景 – 需要持久运行的本地服务器；不适用于AWS Lambda、Cloudflare Workers等临时环境。
需要保证正常运行时间的用户 – 代理依赖底层CLI工具的可用性以及本地机器的在线状态。

理想使用场景

AI辅助编码工作流 – 用ChatGPT/Claude订阅替代昂贵的API密钥，用于Copilot、Cursor或自定义IDE插件。
多账户重度用户 – 拥有多个Gemini/Claude订阅的开发者，希望聚合容量并避免速率限制。
原型开发与测试 – 团队需要尝试不同模型（Gemini、GPT、Claude），但不想管理多个API密钥和计费账户。
CI/CD流水线 – 在CI中使用现有订阅运行AI代码审查或生成，无需付费API密钥。
教育/自托管场景 – 学生或爱好者希望通过标准API使用顶级AI模型，而无需承担持续的API费用。

社区与活跃度

这个项目火得一塌糊涂。 拥有31,785颗星标，且最近更新至2026年5月，CLIProxyAPI显然精准击中了开发者社区的痛点。Go代码库维护活跃，其星标数量（跻身GitHub项目前0.1%）充分证明了它在真实世界的广泛采用。项目的强劲势头表明，它正在成为连接CLI AI工具与标准API接口的事实标准。如果你正在寻找一个已经过大规模社区验证的代理解决方案，就是它了。

router-for-me/CLIProxyAPI ​

一句话总结 ​

🔥 核心能力与独特卖点 ​

技术架构 ​

快速入门指南 ​

优缺点与使用场景 ​

优点 ​

缺点 ​

谁不适合使用？ ​

理想使用场景 ​

社区与活跃度 ​