CLIProxyAPI

一个强大的代理服务器，将基于 CLI 的 AI 模型（Gemini CLI、OpenAI Codex、Claude Code、Qwen Code、iFlow、Antigravity）封装为 OpenAI/Gemini/Claude/Codex 兼容的 API 端点，支持 OAuth 认证。

功能特点

• 多供应商支持: OpenAI Codex (GPT-5)、Claude Code、Gemini CLI、Qwen Code、iFlow 和 Antigravity
• OAuth 认证: 使用现有订阅，无需 API 密钥
• 多账户负载均衡: 支持多账户轮询，自动故障转移
• OpenAI 兼容: 与任何 OpenAI SDK 和 AI 编码工具无缝配合
• 流式支持: 所有供应商的实时流式响应
• 函数调用: 完整的工具/函数调用支持
• Web 管理界面: 内置 Web 界面，便于 OAuth 配置
• 预配置: 包含优化的 config.yaml - 开箱即用

支持的 AI 编码工具

CLIProxyAPI 支持所有主流 AI 编码助手：

• Cursor - AI 优先的代码编辑器
• Continue - VS Code AI 辅助扩展
• Cline - Claude 驱动的编码助手
• Windsurf - AI 结对编程工具
• Roo Code - AI 代码生成
• GitHub Copilot Chat - 通过 OpenAI 兼容性
• 等等 - 任何支持 OpenAI API 格式的工具

快速开始指南

步骤 1: 认证供应商

部署后，您有两种认证方法：

方法 A: Web UI（推荐）

1. 访问管理 Web UI：https://<your-domain>:8085
2. 点击 OAuth 按钮：Codex、Claude Code、Qwen Code、iFlow 或 Antigravity
3. 在浏览器中完成 OAuth 流程
4. 对于 Gemini CLI：使用 CLI 方法（需要终端）

方法 B: CLI 认证

使用 Zeabur 的 shell/终端功能：

# 进入工作目录
cd /CLIProxyAPI

# Gemini CLI (OAuth 通过端口 8085)
./CLIProxyAPI -no-browser --login

# OpenAI Codex (OAuth 通过端口 1455)
./CLIProxyAPI -no-browser --codex-login

# Claude Code (OAuth 通过端口 54545)
./CLIProxyAPI -no-browser --claude-login

# Qwen Code
./CLIProxyAPI -no-browser --qwen-login

# iFlow (OAuth 通过端口 11451)
./CLIProxyAPI -no-browser --iflow-login

# Antigravity (OAuth 通过端口 51121)
./CLIProxyAPI -no-browser --antigravity-login

-no-browser 标志会在终端显示 OAuth URL，供手动浏览器认证。

步骤 2: 配置您的 AI 编码工具

认证后，配置您的工具：

基础 URL: https://<your-domain>/v1
API 密钥: sk-cliproxyapi-default-key-change-me（或在 config.yaml 中更新）

可用模型

每个供应商提供不同的模型：

OpenAI Codex: gpt-5-codex, gpt-5, codex-latest
Claude Code: claude-sonnet-4, claude-opus-4, claude-sonnet-4-5, claude-opus-4-5
Gemini CLI: gemini-2.5-pro, gemini-2.5-flash, gemini-2.0-flash-thinking
Qwen Code: qwen-coder-plus, qwen-turbo, qwen-max
iFlow: tstars2.0
Antigravity: antigravity-latest

配置示例

Cursor

{
  "models": {
    "override": {
      "gpt-5-codex": {
        "apiKey": "sk-cliproxyapi-default-key-change-me",
        "baseURL": "https://<your-domain>/v1"
      }
    }
  }
}

预配置设置

此模板包含优化的 config.yaml，具有：

✅ 远程管理已启用 - 从任何地方访问 Web UI
✅ 失败自动重试 - 3 次重试，最大 30 秒间隔
✅ 轮询负载均衡 - 账户间均匀分配
✅ 流式保活 - 15 秒保活，连接稳定
✅ 日志管理 - 基于文件的日志，100MB 限制
✅ 使用跟踪 - 内置使用统计
✅ 配额管理 - 配额超限时自动切换项目/模型

配置位置: /CLIProxyAPI/config.yaml

您可以通过 Zeabur 的文件编辑器或终端编辑配置。

端口参考

端口	用途	协议
8317	主 API 端点	HTTP
8085	管理 Web UI 和 Gemini OAuth	HTTP
1455	OpenAI Codex OAuth 回调	TCP
54545	Claude Code OAuth 回调	TCP
51121	Antigravity OAuth 回调	TCP
11451	iFlow OAuth 回调	TCP

资源

• 文档: https://help.router-for.me/
• GitHub: https://github.com/router-for-me/CLIProxyAPI
• Docker 指南: https://help.router-for.me/docker/docker-compose.html
• 配置: https://help.router-for.me/configuration/options.html
• 问题: https://github.com/router-for-me/CLIProxyAPI/issues

许可证

MIT 许可证 - 参见 LICENSE