CLIProxyAPI是一款开源代理服务器 将Gemini CLI ChatGPT Codex Claude Code Qwen Code等CLI工具封装为标准OpenAI兼容API 支持多账号轮询负载均衡 让你用免费订阅享受GPT-5 Gemini-2.5-Pro Claude等顶级模型

🎤 引言

在AI开发中 我们往往需要使用多个平台的模型能力：OpenAI的GPT-5、Google的Gemini-2.5-Pro、Anthropic的Claude、阿里的Qwen等。但每个平台都有自己的CLI工具和API格式 切换成本高 管理复杂。

今天为大家推荐一款开源神器 —— CLIProxyAPI！它是一款代理服务器 将各种CLI工具统一封装为标准的OpenAI/Gemini/Claude兼容API 支持多账号轮询和负载均衡 让你可以用熟悉的API格式调用多个平台的免费CLI模型。

⭐ 核心亮点

1. 多平台CLI统一封装

CLIProxyAPI支持将以下CLI工具封装为标准API：

平台CLI工具支持模型
GoogleGemini CLIGemini 2.5 Pro
OpenAICodexGPT-5
AnthropicClaude CodeClaude 4
阿里Qwen CodeQwen-Max
其他iFlow Antigravity多种模型

统一API格式：

  • ✅ OpenAI兼容格式
  • ✅ Gemini兼容格式
  • ✅ Claude兼容格式
  • ✅ 标准REST API

2. 多账号负载均衡

  • 多账号支持 - 配置多个平台账号
  • 轮询调度 - 智能分配请求到不同账号
  • 故障转移 - 自动切换可用账号
  • 速率限制管理 - 避免触发限制

3. 完整API功能

功能支持状态
流式响应✅ Streaming
非流式响应✅ Non-streaming
工具调用✅ Function calling
多模态输入✅ 文本+图像
对话补全✅ Chat completions

4. 简单认证流程

支持多种认证方式：

  • OAuth登录 - Gemini OpenAI Claude Qwen iFlow
  • API Key - Generative Language API
  • 配置文件 - 支持OpenRouter等上游提供商

📥 安装与使用

Docker部署

# 克隆仓库
git clone https://github.com/router-for-me/CLIProxyAPI
cd CLIProxyAPI

# 配置环境变量
cp .env.example .env
# 编辑.env配置各平台账号

# Docker启动
docker-compose up -d

二进制运行

# 下载对应平台二进制
wget https://github.com/router-for-me/CLIProxyAPI/releases/latest/download/cliproxyapi-linux-amd64
chmod +x cliproxyapi-linux-amd64

# 运行
./cliproxyapi-linux-amd64

配置示例

# config.yaml
providers:
  gemini:
    - name: account1
      auth_type: oauth
      credentials:
        token: YOUR_GEMINI_TOKEN
    - name: account2
      auth_type: oauth
      credentials:
        token: YOUR_GEMINI_TOKEN2
  
  openai:
    - name: codex1
      auth_type: oauth
      credentials:
        token: YOUR_OPENAI_TOKEN
  
  claude:
    - name: claude1
      auth_type: oauth
      credentials:
        token: YOUR_CLAUDE_TOKEN

load_balancer:
  strategy: round_robin
  health_check: true

🛠 使用示例

OpenAI SDK调用

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:8080/v1",
    api_key="your-api-key"
)

# 调用Gemini模型
response = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[{"role": "user", "content": "Hello!"}]
)

# 调用Claude模型
response = client.chat.completions.create(
    model="claude-4",
    messages=[{"role": "user", "content": "Hello!"}]
)

cURL调用

# Gemini模型
curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-pro",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

# Claude模型
curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-4",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

🔍 适用场景

✅ 适合场景

  • 多平台模型管理 - 统一接口调用多个平台
  • 免费额度最大化 - 利用多账号免费额度
  • 负载均衡 - 高并发场景分散请求
  • 开发测试 - 快速切换不同模型对比
  • 成本优化 - 优先使用免费CLI订阅

❌ 不适合场景

  • 单一平台重度用户
  • 对延迟极度敏感
  • 无多平台账号

💡 核心优势

优势说明
统一接口一个API调用多个平台
免费使用利用各平台免费CLI订阅
负载均衡多账号轮询 高可用
开源免费可自托管 无费用
Go开发高性能 低资源占用

✅ 总结

CLIProxyAPI是一款实用的多平台CLI模型代理工具 它解决了以下痛点：

  1. 接口不统一 - 一个API调用所有平台
  2. 账号管理难 - 多账号自动负载均衡
  3. 成本控制 - 充分利用免费CLI订阅

推荐指数：⭐⭐⭐⭐⭐

如果你同时使用多个AI平台 或者想最大化利用免费额度 CLIProxyAPI是最佳选择。

📌 项目信息