CLI 代理 API

英语 | 中文 | 日语

一个代理服务器，为命令行界面（CLI）提供与 OpenAI/Gemini/Claude/Codex 兼容的 API 接口。

它现在还通过 OAuth 支持 OpenAI Codex（GPT 模型）和 Claude Code。

因此，您可以使用本地或多账号的 CLI 访问方式，配合兼容 OpenAI（包括响应）、Gemini 和 Claude 的客户端和 SDK。

赞助商

本项目由 Z.ai 赞助，他们通过 GLM 编码计划支持我们。

GLM 编码计划是一项专为 AI 编程设计的订阅服务，每月仅需 10 美元起。它让您可以在 10 多种流行的 AI 编程工具（Claude Code、Cline、Roo Code 等）中访问其旗舰模型 GLM-4.7 及（GLM-5 仅对 Pro 用户开放），为开发者提供顶级、快速且稳定的编码体验。

享受 GLM 编码计划 10% 折扣：https://z.ai/subscribe?ic=8JVLJQFSKB

---

	感谢 PackyCode 对本项目的赞助！PackyCode 是一家可靠高效的 API 中继服务提供商，为 Claude Code、Codex、Gemini 等提供中继服务。PackyCode 为我们的软件用户提供特别折扣：使用 此链接注册，并在充值时输入优惠码 "cliproxyapi"，即可享受 10% 折扣。
	感谢 AICodeMirror 对本项目的赞助！AICodeMirror 为 Claude Code / Codex / Gemini CLI 提供官方高稳定性中继服务，具备企业级并发能力、快速开票以及 24/7 专属技术支持。Claude Code / Codex / Gemini 官方渠道价格分别仅为原价的 38% / 2% / 9%，叠加充值额外折扣！AICodeMirror 为 CLIProxyAPI 用户提供特别福利：通过 此链接注册，首次充值可享 20% 折扣，企业客户更可最高享受 25% 折扣！
	衷心感谢 BmoPlus 对本项目的赞助！BmoPlus 是一家专为重度 AI 用户和开发者打造的高可靠性 AI 账号提供商。他们提供稳定可靠的即用型账号，以及 ChatGPT Plus / ChatGPT Pro（完全保修）/ Claude Pro / Super Grok / Gemini Pro 的官方充值服务。通过 BmoPlus - 高端 AI 账号及充值 注册并下单，用户可享受令人惊叹的优惠——仅需官方 GPT 订阅价格的 10%（90% OFF）！
	感谢 LingtrueAPI 对本项目的赞助！LingtrueAPI 是一家全球大型模型 API 中介服务平台，为 Claude Code、Codex、Gemini 等多种顶尖模型提供 API 调用服务。它致力于让用户以低成本、高稳定性的方式连接全球 AI 能力。LingtrueAPI 为本软件用户提供特别折扣：使用 此链接注册，并在首次充值时输入优惠码 "LingtrueAPI"，即可享受 10% 折扣。
	感谢 Poixe AI 对本项目的赞助！Poixe AI 提供可靠的 LLM API 服务。您可以通过该平台的 API 端点无缝构建 AI 驱动的产品。此外，您还可以成为供应商，向平台提供 AI API 资源并获得收益。通过 CLIProxyAPI 专属的 推荐链接注册，在首次充值时即可获得 5 美元奖励。

概述

• 适用于 CLI 模型的 OpenAI/Gemini/Claude 兼容 API 端点
• 通过 OAuth 登录支持 OpenAI Codex（GPT 模型）
• 通过 OAuth 登录支持 Claude Code
• 通过 OAuth 登录支持 Qwen Code
• 通过 OAuth 登录支持 iFlow
• Amp CLI 和 IDE 扩展支持提供商路由
• 流式与非流式响应
• 函数调用/工具支持
• 多模态输入支持（文本和图像）
• 多账号轮询负载均衡（Gemini、OpenAI、Claude、Qwen 和 iFlow）
• 简单的 CLI 认证流程（Gemini、OpenAI、Claude、Qwen 和 iFlow）
• 生成式语言 API 密钥支持
• AI Studio 构建多账号负载均衡
• Gemini CLI 多账号负载均衡
• Claude Code 多账号负载均衡
• Qwen Code 多账号负载均衡
• iFlow 多账号负载均衡
• OpenAI Codex 多账号负载均衡
• 通过配置支持兼容 OpenAI 的上游提供商（例如 OpenRouter）
• 可重用的 Go SDK 用于嵌入代理（参见 docs/sdk-usage.md）

开始使用

CLIProxyAPI 使用指南：https://help.router-for.me/

管理 API

请参阅 MANAGEMENT_API.md

Amp CLI 支持

CLIProxyAPI 内置了对 Amp CLI 和 Amp IDE 扩展的支持，使您能够将 Google/ChatGPT/Claude 的 OAuth 订阅与 Amp 的编程工具结合使用：

• Amp API 模式的提供商路由别名（/api/provider/{provider}/v1...）
• 用于 OAuth 认证和账户功能的管理代理
• 带有自动路由的智能模型回退
• 模型映射，用于将不可用的模型路由到替代方案（例如，claude-opus-4.5 → claude-sonnet-4）
• 以安全为先的设计，管理端点仅限于本地主机

当您需要特定后端系列的请求/响应格式时，请使用提供商专用路径，而非合并后的 /v1/... 端点：

• 对于消息风格的后端，请使用 /api/provider/{provider}/v1/messages
• 对于模型范围内的生成端点，请使用 /api/provider/{provider}/v1beta/models/...
• 对于聊天完成类的后端，请使用 /api/provider/{provider}/v1/chat/completions

这些路由有助于您选择协议表面，但它们本身并不能保证在多个后端重复使用同一客户端可见模型名称时，推理执行器是唯一的。推理路由仍然根据请求中的模型/别名来决定。若需严格绑定后端，请使用唯一别名、前缀，或避免客户端可见模型名称重叠。

→ 完整的 Amp CLI 集成指南

SDK 文档

• 使用方法：docs/sdk-usage.md
• 高级功能（执行器与翻译器）：docs/sdk-advanced.md
• 访问权限：docs/sdk-access.md
• 监视器：docs/sdk-watcher.md
• 自定义提供程序示例：examples/custom-provider

贡献说明

我们欢迎任何贡献！请随时提交 Pull Request。

1. 克隆仓库并创建分支
2. 创建你的特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加一些令人惊叹的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开 Pull Request

哪些项目正在使用 CLIProxyAPI？

以下项目基于 CLIProxyAPI：

vibeproxy

原生 macOS 菜单栏应用，允许你无需 API 密钥即可通过 AI 编码工具使用 Claude Code 和 ChatGPT 订阅。

Subtitle Translator

基于浏览器的工具，利用你的 Gemini 订阅并通过 CLIProxyAPI 翻译 SRT 字幕，并自动进行验证和错误修正——同样无需 API 密钥。

CCS (Claude Code Switch)

CLI 包装器，用于通过 CLIProxyAPI OAuth 在多个 Claude 账户及替代模型（Gemini、Codex、Antigravity）之间即时切换——无需 API 密钥。

Quotio

原生 macOS 菜单栏应用，统一管理 Claude、Gemini、OpenAI、Qwen 和 Antigravity 的订阅，具备实时配额跟踪和智能自动故障转移功能，适用于 Claude Code、OpenCode 和 Droid 等 AI 编码工具——无需 API 密钥。

CodMate

原生 macOS SwiftUI 应用，用于管理 CLI AI 会话（Codex、Claude Code、Gemini CLI），提供统一的提供商管理、Git 审查、项目组织、全局搜索和终端集成。集成了 CLIProxyAPI，为 Codex、Claude、Gemini、Antigravity 和 Qwen Code 提供 OAuth 认证，并通过单一代理端点实现内置及第三方提供商的路由转发——OAuth 提供商无需 API 密钥。

ProxyPilot

Windows 原生 CLIProxyAPI 分支，配备 TUI、系统托盘和多提供商 OAuth 支持，专为 AI 编码工具设计——无需 API 密钥。

Claude Proxy VSCode

VSCode 插件，用于快速切换 Claude Code 模型，后端集成 CLIProxyAPI，并具备自动后台生命周期管理功能。

ZeroLimit

基于 Tauri + React 构建的 Windows 桌面应用，通过 CLIProxyAPI 监控 AI 编码助手的配额。可实时跟踪 Gemini、Claude、OpenAI Codex 和 Antigravity 账户的使用情况，提供实时仪表板、系统托盘集成和一键代理控制——无需 API 密钥。

CPA-XXX Panel

轻量级 Web 管理面板，用于 CLIProxyAPI，具备健康检查、资源监控、实时日志、自动更新、请求统计和定价显示等功能。支持一键安装和 systemd 服务。

CLIProxyAPI Tray

基于 PowerShell 脚本实现的 Windows 托盘应用程序，不依赖任何第三方库。主要功能包括：自动创建快捷方式、静默运行、密码管理、频道切换（Main / Plus）以及自动下载和更新。

霖君

霖君是一款跨平台桌面应用，用于管理 AI 编程助手，支持 macOS、Windows 和 Linux 系统。统一管理 Claude Code、Gemini CLI、OpenAI Codex、Qwen Code 等 AI 编码工具，通过本地代理实现多账户配额跟踪和一键配置。

CLIProxyAPI Dashboard

基于 Next.js、React 和 PostgreSQL 构建的现代化 Web 管理仪表板，用于 CLIProxyAPI。具备实时日志流、结构化配置编辑、API 密钥管理、Claude/Gemini/Codex 的 OAuth 提供商集成、使用情况分析、容器管理和与 OpenCode 通过配套插件同步配置等功能——无需手动编辑 YAML 文件。

All API Hub

浏览器扩展程序，用于一站式管理兼容 New API 的中继站点账户，提供余额和使用情况仪表板、自动签到、一键将密钥导出至常用应用、页面内 API 可用性测试以及频道/模型同步和重定向功能。它通过管理 API 与 CLIProxyAPI 集成，实现一键导入提供商和同步配置。

Shadow AI

Shadow AI 是一款专为受限环境设计的 AI 助手工具。它采用隐蔽运行模式，无窗口且不留痕迹，可通过局域网（LAN）实现跨设备的 AI 问答交互和控制。本质上，它是“屏幕/音频捕获 + AI 推理 + 低摩擦传递”的自动化协作层，帮助用户在受控设备或受限环境中无缝使用 AI 助手。

ProxyPal

跨平台桌面应用（macOS、Windows、Linux），以原生 GUI 包装 CLIProxyAPI。连接 Claude、ChatGPT、Gemini、GitHub Copilot、Qwen、iFlow 以及自定义的 OpenAI 兼容端点，提供使用情况分析、请求监控和针对热门编码工具的自动配置——无需 API 密钥。

[!NOTE]
如果你基于 CLIProxyAPI 开发了项目，请提交 PR 将其加入此列表。

更多选择

以下项目是 CLIProxyAPI 的移植版本或受其启发而开发：

9Router

受 CLIProxyAPI 启发的 Next.js 实现，易于安装和使用，从头构建，具备格式转换（OpenAI/Claude/Gemini/Ollama）、组合系统与自动回退、多账户管理与指数退避、Next.js Web 仪表板，以及对 CLI 工具（Cursor、Claude Code、Cline、RooCode）的支持——无需 API 密钥。

OmniRoute

永不中断编程。智能路由至免费及低成本 AI 模型，并自动回退。

OmniRoute 是一个多提供商 LLM 的 AI 网关：一个兼容 OpenAI 的端点，具备智能路由、负载均衡、重试和回退机制。可添加策略、速率限制、缓存和可观ability，以实现可靠且成本敏感的推理。

[!NOTE]
如果你开发了 CLIProxyAPI 的移植版本或受其启发的项目，请提交 PR 将其加入此列表。

许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

CLIProxyAPI 快速上手指南

CLIProxyAPI 是一个本地代理服务器，旨在为命令行工具（CLI）提供兼容 OpenAI、Gemini、Claude 等主流模型的 API 接口。它支持通过 OAuth 直接登录使用官方订阅账号（如 ChatGPT Plus、Claude Pro），无需手动管理 API Key，并支持多账号负载均衡。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux、macOS 或 Windows。
• 运行环境：已安装 Go 1.21+（用于从源码构建）或直接使用预编译二进制文件。
• 网络环境：能够访问目标 AI 服务商（OpenAI/Google/Anthropic）的 OAuth 登录页面。
  • 提示：国内用户若遇到连接问题，请自行配置网络代理或在启动时设置 HTTP_PROXY 环境变量。
• 前置依赖：无特殊系统库依赖，单二进制文件即可运行。

安装步骤

您可以选择下载预编译版本或通过 Go 源码安装。

方式一：下载预编译二进制文件（推荐）

访问项目的 Releases 页面 下载对应您操作系统的最新版本压缩包，解压后即可得到可执行文件 cliproxyapi。

方式二：使用 Go 安装

如果您已配置好 Go 环境，可以使用以下命令直接安装：

go install github.com/automazeio/cliproxyapi@latest

安装完成后，确保二进制文件所在目录已添加到系统的 PATH 环境变量中。

基本使用

1. 启动服务

在终端中直接运行以下命令启动代理服务器。默认情况下，服务将监听本地端口（通常为 8080 或配置文件中指定的端口）。

cliproxyapi

注意：首次运行时，程序可能会生成默认的配置文件（如 config.yaml），您可以根据需要编辑该文件以自定义端口、日志级别或多账号配置。

2. 配置 OAuth 认证（无需 API Key）

CLIProxyAPI 的核心优势是支持 OAuth 登录。启动服务后，访问管理界面（通常位于 http://localhost:8080 或配置文件设定的地址）：

1. 在管理面板中选择添加提供商（如 OpenAI, Claude, Gemini）。
2. 点击 OAuth Login 按钮。
3. 在弹出的浏览器窗口中登录您的官方账号（需拥有 Plus/Pro 订阅）。
4. 授权成功后，令牌将自动保存至本地配置，无需手动复制粘贴 API Key。

3. 调用示例

配置完成后，CLIProxyAPI 会暴露标准的 OpenAI 兼容接口。您可以使用 curl 或任何兼容的 SDK 进行调用。

使用 curl 测试聊天接口：

curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "Hello, this is a test via CLIProxyAPI."
      }
    ]
  }'

配合 Claude Code 或其他 CLI 工具使用：

许多 AI 编程工具允许指定 Base URL。将其指向您的本地代理服务即可：

# 示例：设置环境变量指向本地代理
export OPENAI_BASE_URL="http://localhost:8080/v1"
export OPENAI_API_KEY="any-string-worksWithOAuth" 

# 然后运行您的 CLI 工具
npx @anthropic-ai/claude-code

4. 多账号负载均衡（可选）

若需在配置文件中启用多账号轮询，可在 config.yaml 中添加多个 OAuth 凭证或 API Key，CLIProxyAPI 会自动处理请求分发，提高可用性和配额利用率。

# config.yaml 示例片段
providers:
  - name: openai
    type: openai
    accounts:
      - oauth_token: "token_1..."
      - oauth_token: "token_2..."
    load_balance: round_robin

重启服务后生效。