跳转到主要内容
PromptQuorum为人类设计。 为AI结构化。
主页/本地LLM进阶
Overview & Reference

AIClient2API 评测：一个本地代理，打通所有 AI 协议

·阅读约10分钟Hans Kuepper 作者 · PromptQuorum创始人 · 开放权重与开源AI发现引擎

AIClient2API 是一款免费、开源、自托管的代理工具,能把 Gemini CLI、Codex、Grok、Kiro 和 Antigravity 的客户端协议统一转换成一个本地 OpenAI 兼容 API。 由 justlovemaki 开发,以 GPL-3.0 协议发布,可通过 Docker 或 Node.js 运行,提供 OpenAI 格式端点和一个网页控制台,让任何 OpenAI 兼容客户端都能连接到原本无法直接访问的服务商。

关键要点

  • AIClient2API(github.com/justlovemaki/AIClient2API)是一款免费、开源、自托管的 API 代理——不是托管服务
  • 由 justlovemaki 开发;其他 GitHub 账号下存在多个几乎相同的分支,但这个仓库已确认是星标最高的原始版本
  • 根据仓库自身的许可字段,采用 GPL-3.0 协议
  • 把 Gemini CLI、Codex、Grok、Kiro 和 Antigravity 的客户端协议转换成一个 OpenAI 兼容 API,支持 OpenAI/Claude/Gemini 协议的双向转换
  • 通过 Docker(推荐)或 Node.js/npm 运行;内置网页控制台用于配置和健康监控
  • 截至本文撰写时,GitHub 星标超过 8,700,分支超过 1,380,版本发布活跃(v3.5.0 于 2026 年 9 月发布)

📍 简单一句话

AIClient2API 是由 justlovemaki 开发的免费、开源(GPL-3.0)自托管代理,GitHub 星标超过 8,700,能把 Gemini CLI、Codex、Grok、Kiro 和 Antigravity 的客户端协议转换成单一的本地 OpenAI 兼容 API。

💬 简单来说

AIClient2API 是一个运行在你自己机器上的小型服务器,处于你的 AI 客户端工具和它们对接的 AI 服务商之间。你不需要分别学习五种不同的服务商协议,只要把所有请求都指向这一个本地地址,AIClient2API 就会在后台把请求转换成每个服务商实际需要的格式。

📌注: 本文评测基于该项目自身的 GitHub 仓库、README 和发布历史撰写,并不代表 PromptQuorum 对 AIClient2API 的代理行为进行过实际负载测试或安全审计。

选择语言:
🇺🇸en🇩🇪de🇫🇷fr🇯🇵ja🇨🇳zh🇪🇸es🇧🇷pt🇸🇦ar🇰🇷ko

AIClient2API（github.com/justlovemaki/AIClient2API）是一款免费、开源、可自行部署的代理服务器，能把 Gemini CLI、Codex、Grok、Kiro 和 Antigravity 的客户端协议统一转换成单一的 OpenAI 兼容 API，目前在 GitHub 上已获得 8,700 多颗星。本文是 本地 LLM 软件目录 中 AIClient2API 条目的配套评测,重点说明它到底能做什么、怎么运行,以及适合哪些人使用。

AIClient2API 是什么?

AIClient2API 是一款免费、开源、自托管的代理服务器,把多个 AI 服务商和 CLI 工具的客户端协议统一到一个本地的 OpenAI 兼容 API 之下。 由 GitHub 用户 justlovemaki 开发,以 GPL-3.0 协议发布。

  • 产品类型:自托管的代理/网关服务器,不是聊天应用、IDE 插件或托管型 SaaS 产品
  • 开发者:justlovemaki(GitHub 用户名);github.com/justlovemaki/AIClient2API 这个仓库已确认是众多几乎相同分支中星标最高的原始版本
  • 许可协议:GPL-3.0,一种著佐权(copyleft)协议——分发修改后的版本通常需要以相同协议开放源代码
  • 根据 GitHub 元数据,该仓库创建于 2025 年 7 月 20 日
  • 规模:截至本文评测时,GitHub 星标超过 8,700,分支超过 1,380,未解决问题(open issue)约 5 个——相对其分支数量来说未解决问题数很少,说明项目维护较为活跃

AIClient2API 的版本历史是怎样的?

2026 年以来 AIClient2API 频繁发布小版本更新,最新的正式标记版本 v3.5.0 于 2026 年 9 月发布。

  • v3.5.0(2026 年 9 月):本文评测时的最新正式版本
  • v3.4.9.1 和 v3.4.8(2026 年 9 月):v3.5.0 发布前几天的增量补丁版本
  • v3.0.0(2026 年 5 月):据项目自身的发布说明,该版本加入了更深入的 AI 辅助集成功能,包括自动化技能指南和远程 API 帮助端点
  • 2026 年 4 月:根据项目更新日志,加入了完整的 OpenAI 图像生成与编辑 API 支持及相应协议转换
  • 2026 年 3 月:根据项目更新日志,加入了 Grok 协议支持,包括多模态输入以及图像/视频生成

AIClient2API 实际能做什么?

AIClient2API 作为本地服务器运行,接收标准的 OpenAI 格式 API 请求,将其转换成目标服务商实际需要的协议,再把响应转换回来。

  • 协议转换:在 OpenAI、Claude 和 Gemini 的 API 格式之间进行双向转换,项目方称使用了策略模式和适配器设计模式
  • 支持的服务商/协议:根据项目自身文档,包括 Gemini、Claude(通过 Kiro 或 Antigravity 客户端协议访问)、Grok(通过 Cookie 或 CLI OAuth)、Codex、Kimi、MiniMax、OpenAI,以及自定义的 OpenAI 兼容端点
  • 账号池管理:在每个服务商的多个账号之间轮询,支持自动故障转移和健康检查
  • OAuth 集成:内置针对 Antigravity、Codex、Grok CLI 和 Kiro 的 OAuth 认证流程
  • 负载均衡:在遇到 HTTP 429 速率限制错误时进行服务商选择与冷却处理,并支持跨服务商的降级链
  • TLS 旁路组件:一个独立的 Go 语言代理组件,项目方称它能模拟 JA3 TLS 指纹,用于规避某些服务商端点上的 Cloudflare 或 403 类拦截
  • 网页控制台:localhost:3000 提供基于浏览器的界面,用于实时配置、健康监控和 API 测试
  • 日志记录:完整捕获请求与响应,项目方将其定位为便于审计或构建训练数据集

如何配置和运行它?

AIClient2API 通过一个 JSON 配置文件(或网页控制台)进行配置,把接收到的请求映射到一个或多个后端服务商账号,然后作为长期运行的本地服务器进程运行。

  • 通过 Docker 启动(推荐):拉取镜像,挂载本地 configs 文件夹,并开放代理所需的端口
  • 通过 Node.js 启动:克隆仓库,运行自带的安装脚本,然后执行 npm start
  • 在挂载的 configs 目录中配置服务商凭据和账号池,或通过 http://localhost:3000 的网页控制台进行配置
  • 把任何 OpenAI 兼容客户端(聊天应用、编程 CLI 工具或自定义脚本)指向本地代理地址,而不是服务商自己的 API 端点
  • 通过网页控制台实时监控账号健康状态、速率限制冷却情况和请求日志
bash
docker run -d -p 3000:3000 -p 8086:8086 -p 1455:1455 -p 56121:56121 \
  -v "your_path/configs:/app/configs" \
  justlikemaki/aiclient-2-api

平台、价格与许可

平台

AIClient2API 的说明:
自托管服务器,跨平台(Mac、Windows、Linux),通过 Docker 或 Node.js 运行——没有云托管版本。

费用

AIClient2API 的说明:
免费且开源。你仍需为所连接的服务商账号或 API 密钥付费;代理本身不收费。

许可协议

AIClient2API 的说明:
根据仓库的许可字段,采用 GPL-3.0 著佐权(copyleft)协议。

安装方式

AIClient2API 的说明:
Docker(推荐,单条 docker run 命令)或通过自带安装脚本加 npm start 的 Node.js 方式。

在运行任一命令前,请到 github.com/justlovemaki/AIClient2API 核实当前推荐的安装方式和端口列表。

AIClient2API 收费吗?

AIClient2API 本身完全免费——没有授权费、订阅费,也没有按用量计费的费用。 实际支出完全取决于你连接的是哪些服务商账号或 API 密钥。

  • 代理软件本身:免费,GPL-3.0 开源,没有付费档位
  • 服务商费用:取决于你所连接的底层账号或 API 密钥本身的费用(例如付费的 OpenAI/Claude/Gemini API 密钥,或绑定在 Codex、Kiro 等 CLI 工具上的订阅)
  • 自托管成本:仅取决于你自己的算力——由于它是一个轻量级的 Node.js 代理,即便部署在小型 VPS 上,成本通常也可以忽略不计

AIClient2API 对比 LiteLLM:区别是什么?

AIClient2API 和 LiteLLM 都能让你用一种 API 格式接入多个服务商,但两者针对的是不同的问题:LiteLLM 专注于面向标准商业 API 的生产级多服务商路由,而 AIClient2API 专注于把基于 CLI 订阅和浏览器 OAuth 的 AI 工具桥接成 OpenAI 兼容格式。

主要目标

AIClient2API:
把基于 CLI/OAuth 的 AI 工具(Gemini CLI、Codex、Kiro、Antigravity)桥接成一个 API
LiteLLM:
在一个 OpenAI 兼容接口下统一 100 多个标准服务商 API

许可协议

AIClient2API:
GPL-3.0(著佐权)
LiteLLM:
MIT(宽松许可)

典型用户

AIClient2API:
希望通过标准 API 复用 CLI 工具订阅的开发者
LiteLLM:
希望在多个厂商之间标准化生产环境 LLM 流量的团队

附加功能

AIClient2API:
TLS 指纹旁路组件、针对特定 CLI 工具的 OAuth 流程
LiteLLM:
预算管理、支出跟踪、虚拟密钥、广泛的生态系统集成

这两款工具解决的是有重叠但又不完全相同的问题——部分团队会同时使用两者:用 LiteLLM 处理标准服务商 API,专门用 AIClient2API 处理基于 CLI 订阅的服务商。

在目录中比较

谁适合使用 AIClient2API?

AIClient2API 适合那些已经通过不同客户端工具接入多个 AI 服务商、并希望用一个统一的本地 OpenAI 兼容端点来搭建应用的开发者。

以下情况适合使用 AIClient2API

  • 已经在使用多个 AI CLI 工具或订阅(Gemini CLI、Codex、Kiro、Antigravity、Grok),希望通过一个标准 API 统一接入
  • 希望完全掌控一个自托管代理,而不是把请求路由到第三方托管网关
  • 需要在同一服务商的多个账号之间自动故障转移,以避免单账号的速率限制
  • 希望获得完整的请求/响应日志,用于审计或构建自己的训练/评估数据集
  • 愿意通过 Docker 或 Node.js 自行运行和维护一个小型自托管服务器

以下情况建议考虑其他方案

  • 只使用一个标准服务商的 API 密钥,不需要协议转换或多服务商路由
  • 希望使用完全托管的网关,而不是自己部署和维护
  • 对通过 CLI 工具或浏览器 OAuth 协议(而非官方付费 API)路由流量所处的服务条款灰色地带感到不放心
  • 需要团队预算、支出仪表盘或 SSO 等企业级功能——这些在 LiteLLM 等专用网关中更成熟

AIClient2API 不适合哪些场景?

如果你需要完全托管的网关、企业级支出控制,或者想避开 CLI 协议桥接带来的服务条款灰色地带,AIClient2API 并不适合。

  • 不是托管服务——运行、更新和保护自己的实例都需要自己负责
  • 并非主要围绕官方授权的标准服务商 API 构建——它的多个集成通过并非为第三方代理设计的 CLI 工具或 OAuth 协议实现,这可能与某些服务商的服务条款相冲突
  • 不像专用 LLM 网关那样注重企业治理功能(按团队预算、支出仪表盘、SSO)
  • 就本文评测所能核实的范围而言,未经过独立安全审计——请把它当作任何处理 API 凭据的自托管代理来对待,在将其暴露到本机以外之前,先检查账号池和日志的配置
  • 就本文评测所能核实的范围而言,背后没有公司或融资支持——请将其视为一个独立维护、由社区支持的项目

评估 AIClient2API 时的常见误区

关于 AIClient2API 的大多数困惑,都来自把它和众多分支混淆,或者误以为它的工作方式和标准的多服务商网关一样。

误区一:安装了分支而不是原始仓库

不同 GitHub 账号下存在多个描述几乎相同的项目。本文评测确认 github.com/justlovemaki/AIClient2API 是星标最高的原始仓库——在报告问题或检查更新之前,请确认你指向的是这个仓库,而不是某个分支。

误区二:以为它只代理标准的官方服务商 API

AIClient2API 的部分集成是通过 CLI 工具或浏览器 OAuth 协议(Kiro、Antigravity、Grok Cookie 认证)实现的,而不是官方支持的第三方 API 访问方式。在以这种方式路由生产环境流量之前,请先查看各服务商自己的服务条款。

误区三:把它当作生产级 LLM 网关的直接替代品

目前 AIClient2API 并未记录类似 LiteLLM 等专用生产网关中的团队预算、支出跟踪或 SSO 功能。请专门针对 CLI 订阅桥接场景来评估它,而不是把它当作通用的企业路由层。

误区四:跳过 TLS 旁路组件和 OAuth 设置步骤

AIClient2API 的部分服务商集成依赖于其独立的 Go 语言 TLS 旁路组件,或需要成功完成一次 OAuth 认证流程。如果某个服务商连接失败,请根据项目自身文档检查该服务商是否需要旁路组件或 OAuth 登录步骤。

竞品与替代方案

AIClient2API 最常被拿来与 LiteLLM 比较;此外,也值得将它与它可以放在前面的那些 OpenAI 兼容服务器进行对比,比如 vLLM、SGLang 和 LocalAI,具体取决于你需要的是协议桥接代理还是推理服务器本身。

LiteLLM

主要特点:
MIT 许可的代理,统一 100 多个标准服务商 API,支持预算和支出跟踪
链接:
LiteLLM 评测

这份列表反映的是常与 AIClient2API 一同被评估的工具,并非 PromptQuorum 独立的排名——在选择前请核实每款工具的当前功能特性。

在目录中比较

常见问题

AIClient2API 是什么?

AIClient2API(github.com/justlovemaki/AIClient2API)是一款免费、开源(GPL-3.0)的自托管代理,能把 Gemini CLI、Codex、Grok、Kiro 和 Antigravity 的客户端协议转换成单一的 OpenAI 兼容 API。

AIClient2API 免费吗?

是的,AIClient2API 本身完全免费,以 GPL-3.0 协议开源。你仍需为所连接的底层服务商账号或 API 密钥付费。

如何安装 AIClient2API?

项目自身的 README 推荐使用 Docker:运行 docker run -d -p 3000:3000 -p 8086:8086 -p 1455:1455 -p 56121:56121 -v "your_path/configs:/app/configs" justlikemaki/aiclient-2-api。也提供 Node.js 安装脚本。请先到 GitHub 仓库核实最新的安装说明。

AIClient2API 支持哪些 AI 服务商?

根据项目自身文档:Gemini、Claude(通过 Kiro 或 Antigravity)、Grok、Codex、Kimi、MiniMax、OpenAI,以及自定义的 OpenAI 兼容端点。

AIClient2API 是谁开发的?

AIClient2API 由 GitHub 用户 justlovemaki 开发。其他账号下存在多个几乎相同的分支,但这个仓库已确认是星标最高的原始版本。

AIClient2API 和 LiteLLM 是一回事吗?

不是。两者都能在一个 OpenAI 兼容 API 之下统一多个服务商,但 LiteLLM(MIT 协议)专注于标准商业服务商 API,并提供预算管理等生产级功能;AIClient2API(GPL-3.0)则专注于桥接基于 CLI 工具和 OAuth 的 AI 订阅。

AIClient2API 需要 GPU 吗?

不需要。AIClient2API 是一个轻量级的 Node.js 协议转换代理,而不是推理引擎——它本身不运行模型,因此没有 GPU 需求。

通过 AIClient2API 的 CLI 协议集成路由流量安全吗?

它的部分集成是通过并非为第三方代理正式设计的 CLI 工具或浏览器 OAuth 协议实现的,这可能与某些服务商的服务条款相冲突。在用于生产环境流量之前,请先查看各服务商自己的条款。

AIClient2API 是否支持每个服务商多个账号?

支持,根据项目文档,它提供账号池管理功能,可在同一服务商的多个账号之间轮询、自动故障转移并进行健康检查。

PromptQuorum 是否独立验证过 AIClient2API 的说法?

本文评测基于该项目自身的 GitHub 仓库、README 和发布历史撰写,而非 PromptQuorum 自行进行的实际负载测试或安全审计。

资料来源

← 返回 本地LLM进阶

MCP