AIClient2API（A2）🚀

一个能将多种仅客户端内使用的大模型 API（Gemini CLI, Antigravity, Codex, Grok, Kiro ...），模拟请求，统一封装为本地 OpenAI 兼容接口的强大代理。

镜像下载量超100k	trendshift.io上过榜2

🔧 OpenClaw 配置 | 👉 中文 | English | 日本語 | 📚 完整文档

---

💎 赞助商

排序按赞助先后顺序排列，均推荐注册使用。

	PackyCode 是一家可靠且高效的 API 中转服务商，提供 Claude Code、Codex、Gemini 等模型的中转服务。PackyCode 为本软件用户提供特别优惠：通过此链接注册并在充值时输入 AIClient2API 优惠码，即可享受 10% 的折扣。
	感谢 APIKEY.FUN 赞助本项目！APIKEY.FUN 是一家专业的企业级 AI 中转站，致力于为企业和个人开发者提供稳定、高效、低成本的其他 AI 模型 API 接入服务。平台支持 Claude、OpenAI、Gemini 等主流热门模型，价格低至官方原价的 7%。通过本项目专属链接注册，还可享受最高 充值永久 95 折 专属优惠。
	感谢 VisionCoder 对本项目的支持。VisionCoder 开发平台 是一个可靠高效的 API 中继服务提供商，提供 Claude Code、Codex、Gemini 等主流 AI 模型，帮助开发者和团队更轻松地集成 AI 功能，提升工作效率。此外，VisionCoder 还提供 Claude Max 200 与 GPT Pro 200 高级成品号的独家售卖渠道，助力体验全网顶配 AI 的算力与体验。
	感谢 Atlas Cloud 赞助本项目！Atlas Cloud 是一款全模态 AI 推理平台，为开发者提供单一的 AI API 以轻松接入视频生成、图像生成和大语言模型 API。无需管理多个供应商集成，您只需连接一次，即可统一访问跨所有模态的 300 多种精选模型。欢迎查看 Atlas Cloud 全新的 编码计划促销活动 (coding plan)，以获取更具性价比的 API 接入服务。
	成为赞助商 如果您有意赞助本项目，请扫描左侧微信二维码（添加时请注明来意：赞助）。

---

🚀 项目概览

AIClient2API 是一个突破客户端限制的 API 代理服务，将 Gemini、Antigravity、Codex, Grok、Kiro 等原本仅限客户端内使用的免费大模型，转换为可供任何应用调用的标准 OpenAI 兼容接口。基于 Node.js 构建，支持 OpenAI、Claude、Gemini 三大协议的智能互转，让 Cherry-Studio、NextChat、Cline 等工具能够免费大量使用 Claude Opus、Gemini Pro 等高级模型。项目采用策略模式和适配器模式的模块化架构，内置账号池管理、智能轮询、自动故障转移和健康检查机制，确保 99.9% 的服务可用性。

[!NOTE] 🎉 重要里程碑

• 感谢阮一峰老师在 周刊 359 期 的推荐

📅 版本更新日志

点击展开查看详细版本历史

• 2026.06.03 - 新增 Grok Build（Grok CLI）支持：接入 grok-cli-oauth 的 xAI OAuth / Responses API 调用链，支持 Grok Build 文本模型、多协议转换、内置工具（网页搜索、X 搜索、代码解释器、集合/附件搜索）以及图片/视频生成模型。
• 2026.05.04 (v3.0.0) - 里程碑更新：AI 深度集成与自发现架构。新增自动化 Skill 指南与远程 /api/help、/api/example 接口，支持 AI 代理无缝理解并操作 50+ 个全量 API 端点；实现了 CLI 与 REST API 输出结果的完全统一，增强了结构化 JSON 支持。
• 2026.04.29 - 全面支持 OpenAI 标准的图片生成 (/v1/images/generations) 与编辑 (/v1/images/edits) 接口。支持自动将 OpenAI 格式请求转换为各模型对应的原生生图协议，并适配号池轮询与自动重试机制，大幅提升多模态创作的稳定性。
• 2026.03.02 - 新增 Grok 协议支持，支持通过 Cookie/SSO 方式访问 xAI Grok 系列模型（Grok），支持多模态输入、图片/视频生成、自动 token 刷新及流式输出
• 2026.01.26 - 新增 Codex 协议支持：支持 OpenAI Codex OAuth 授权接入
• 2026.01.25 - 增强 AI 监控插件：支持监控 AI 协议转换前后的请求参数和响应。优化日志管理：统一日志格式，可视化配置
• 2026.01.15 - 优化提供商池管理器：新增异步刷新队列机制、缓冲队列去重、全局并发控制，支持节点预热和自动过期检测

  • 2026.01.03 - 新增主题切换功能并优化提供商池初始化，移除使用提供商默认配置的降级策略

• 2025.12.30 - 添加主进程管理和自动更新功能
• 2025.12.25 - 配置文件统一管理：所有配置集中到 configs/ 目录，Docker 用户需更新挂载路径为 -v "本地路径:/app/configs"
• 2025.12.11 - Docker 镜像自动构建并发布到 Docker Hub: justlikemaki/aiclient-2-api
• 2025.11.30 - 新增 Antigravity 协议支持，支持通过 Google 内部接口访问 Gemini Pro、Claude Sonnet 等模型
• 2025.11.11 - 新增 Web UI 管理控制台，支持实时配置管理和健康状态监控
• 2025.11.06 - 新增对 Gemini 预览版的支持，增强模型兼容性和性能优化
• 2025.10.18 - Kiro 开放注册，新用户赠送 500 额度，已完整支持 Claude Sonnet
• 2025.08.29 - 发布账号池管理功能，支持多账号轮询、智能故障转移和自动降级策略
• 配置方式：在 configs/config.json 中添加 PROVIDER_POOLS_FILE_PATH 参数
• 参考配置：provider_pools.json
• 历史已开发
• 支持 Gemini CLI、Kiro 等客户端2API
• OpenAI ,Claude ,Gemini 三协议互转，自动智能切换

---

💡 核心优势

🤖 AI 优先，Agent 交互支持

AI 优先设计：本项目原生支持与 OpenClaw, Hermes, Claude Code 等主流 AI Agent 的高效交互。

💡 快速指令：你可以直接对 AI 说下面这句话，它将自动掌握本项目的所有用法：

• 远程部署： text 请加载并学习 https://raw.githubusercontent.com/justlovemaki/AIClient2API/main/docs/skills/aiclient-cli-usage.md 中的 Skill（服务地址为你的实际域名或 IP，登录密码为你的实际密码），以掌握 AIClient2API 的所有用法。
• 本地模式： 如果你在本地环境直接运行 AI 代理，可以直接发送： text 请加载并学习本项目的 docs/skills/aiclient-cli-usage.md 这一 Skill，以协助我本地启动、配置并管理 AIClient2API 服务。

🎯 统一接入，一站式管理

• 多模型统一接口：通过标准 OpenAI 兼容协议，一次配置即可接入 Gemini、Claude、Grok、Codex、Kimi、MiniMax 等主流大模型
• 灵活切换机制：Path 路由、支持通过启动参数、环境变量三种方式动态切换模型，满足不同场景需求
• 零成本迁移：完全兼容 OpenAI API 规范，Cherry-Studio、NextChat、Cline 等工具无需修改即可使用
• 多协议智能转换：支持 OpenAI、Claude、Gemini 三大协议间的智能转换，实现跨协议模型调用

🚀 突破限制，提升效率

• 绕过官方限制：利用 OAuth 授权机制，有效突破 Gemini, Antigravity 等服务的免费 API 速率和配额限制
• TLS 指纹绕过：内置 TLS Sidecar (Go uTLS) 模拟浏览器特征，有效绕过 Grok 等服务的 Cloudflare 403 封锁
• 免费高级模型：通过 Kiro API 模式免费使用 Claude Opus，降低使用成本
• 账号池智能调度：支持多账号轮询、自动故障转移和配置降级，确保 99.9% 服务可用性

🛡️ 安全可控，数据透明

• 全链路日志记录：捕获所有请求和响应数据，支持审计、调试
• 私有数据集构建：基于日志数据快速构建专属训练数据集
• 系统提示词管理：支持覆盖和追加两种模式，实现统一基础指令与个性化扩展的完美结合

🔧 开发友好，易于扩展

• Web UI 管理控制台：实时配置管理、健康状态监控、API 测试和日志查看
• 模块化架构：基于策略模式和适配器模式，新增模型提供商仅需 3 步
• 完整测试保障：集成测试和单元测试覆盖率 90%+，确保代码质量
• 容器化部署：提供 Docker 支持，一键部署，跨平台运行

---

📑 快速导航

• 💡 核心优势
• 🚀 快速启动
• 🐳 Docker 部署
• 📋 核心功能
• 🔐 授权配置指南
• 📁 授权文件存储路径
• ⚙️ 高级配置
• ❓ 常见问题
• 📄 开源许可
• 🙏 致谢
• ⚠️ 免责声明

---

🔧 使用说明

🚀 快速启动

使用 AIClient2API 最推荐的方式是通过自动化脚本启动，并直接在 Web UI 控制台 进行可视化配置。

🐳 Docker 快捷启动 (推荐)

docker run -d -p 3000:3000 -p 8085-8086:8085-8086 -p 1455:1455 -p 56121:56121 -p 19876-19880:19876-19880 --restart=always -v "指定路径/configs:/app/configs" -v "指定路径/plugins:/app/src/plugins-user" --name aiclient2api justlikemaki/aiclient-2-api

参数说明： - -d：后台运行容器 - -p 3000:3000 ...：端口映射。3000 为 Web UI，其余为 OAuth 回调端口（Gemini: 8085, Antigravity: 8086, Codex: 1455, Grok CLI: 56121, Kiro: 19876-19880） - --restart=always：容器自动重启策略 - -v "指定路径/configs:/app/configs"：挂载配置目录（请将"指定路径"替换为实际路径，如 /home/user/aiclient2api） - -v "指定路径/plugins:/app/src/plugins-user"：挂载用户插件目录 - --name aiclient2api：容器名称

🐳 Docker Compose 部署

你也可以使用 Docker Compose 进行部署。首先，进入 docker 目录：

cd docker
mkdir -p configs
docker compose up -d

如需从源码构建而非使用预构建镜像，请编辑 docker-compose.yml： 1. 注释掉 image: justlikemaki/aiclient-2-api:latest 行 2. 取消 build: 部分的注释 3. 运行 docker compose up -d --build

1. 运行启动脚本

• Linux/macOS: chmod +x install-and-run.sh && ./install-and-run.sh
• Windows: 双击运行 install-and-run.bat

💡 如果脚本运行失败，可以尝试手动安装依赖并启动： ```bash npm install

默认启动

npm start

查看帮助信息

npm run help

查看 API 调用示例

npm run example:api

纯后端模式（禁用前端管理界面）

npm start -- --no-ui ```

2. 访问控制台

服务器启动后，打开浏览器访问： 👉 http://localhost:3000

默认密码: admin123 (登录后可在控制台或修改 pwd 文件变更)

3. 可视化配置 (推荐)

进入 "配置管理" 页面，您可以直接： * ✅ 填入各提供商的 API Key 或上传 OAuth 凭据文件 * ✅ 实时切换默认模型提供商 * ✅ 监控健康状态和实时请求日志

4. 本地环境准备 (非 Docker 用户)

如果您是在本地直接运行（通过脚本或 Node.js），且需要绕过 Grok 等服务的 TLS 检测，请务必： * ✅ 安装 Go 语言环境：前往 Go 官网 下载并安装 (1.20+)。 * ✅ 手动编译 Sidecar：执行以下命令编译 TLS 代理组件： bash cd tls-sidecar && go build -o tls-sidecar && cd .. 注意：若未编译此二进制文件，TLS Sidecar 功能将因找不到执行文件而无法启动。

脚本执行示例

========================================
  AI Client 2 API 快速安装启动脚本
========================================

[检查] 正在检查Node.js是否已安装...
✅ Node.js已安装，版本: v20.10.0
✅ 找到package.json文件
✅ node_modules目录已存在
✅ 项目文件检查完成

========================================
  启动AI Client 2 API服务器...
========================================

🌐 服务器将在 http://localhost:3000 启动
📖 访问 http://localhost:3000 查看管理界面
⏹️  按 Ctrl+C 停止服务器

💡 提示：脚本会自动安装依赖并启动服务器。如果遇到任何问题，脚本会提供清晰的错误信息和解决建议。

---

📋 核心功能

Web UI 管理控制台

功能完善的 Web 管理界面，包含：

📊 仪表盘：系统概览、交互式路由示例、客户端配置指南

⚙️ 配置管理：实时参数修改，支持所有提供商（Gemini、Antigravity、OpenAI、Claude、Kiro），包含高级设置和文件上传

🔗 提供商池：监控活动连接、提供商健康统计、启用/禁用管理

📁 配置文件：OAuth 凭据集中管理，支持搜索过滤和文件操作

📜 实时日志：系统日志和请求日志实时显示，带管理控制

🔐 登录验证：默认密码 admin123，可通过 pwd 文件修改

访问：http://localhost:3000 → 登录 → 侧边栏导航 → 立即生效

多模态输入能力

支持图片、文档等多种类型的输入，为您提供更丰富的交互体验和更强大的应用场景。

最新模型支持

无缝支持以下最新大模型，仅需在 Web UI 或 configs/config.json 中配置相应的端点： * Grok / Grok Build - xAI 旗舰模型，现已通过 Grok Cookie/SSO 与 Grok CLI OAuth 支持，支持思考模型、Grok Build、内置工具、图片生成及视频生成 * Claude Opus - Anthropic 史上最强模型，现已通过 Kiro, Antigravity 支持 * Gemini Pro - Google 下一代架构预览版，现已通过 Gemini, Antigravity 支持 * Kimi / MiniMax - 国内顶级旗舰模型同步支持，现已通过自定义OpenAI，Claude 支持

---

🔐 授权配置指南

点击展开查看各提供商授权配置详细步骤

💡 提示：为了获得最佳体验，建议通过 Web UI 控制台 进行可视化授权管理。

🌐 Web UI 快捷授权 (推荐)

在 Web UI 管理界面中，您可以极速完成授权配置： 1. 生成授权：在 “提供商池” 页面或“配置管理” 页面，点击对应提供商（如 Gemini）右上角的 “生成授权” 按钮。 2. 扫码/登录：系统将弹出授权对话框，您可以点击 “在浏览器中打开” 进行登录验证。对于 Gemini，Antigravity 需完成 Google 账号授权。 3. 自动保存：授权成功后，系统会自动获取凭据并保存至 configs/ 对应目录下，您可以在 “配置文件” 页面看到新生成的凭据。 4. 可视化管理：您可以随时在 Web UI 中上传、删除凭据，或通过 “快速关联” 功能将已有的凭据文件一键绑定到提供商。

Gemini CLI OAuth 配置

1. 获取OAuth凭据：访问 Google Cloud Console 创建项目，启用Gemini API
2. 项目配置：可能需要