GitHub 地址https://github.com/justlovemaki/AIClient-2-API简介AIClient-2-API​ 是一个基于 Node.js 构建的智能 API 代理服务。它的核心使命是“破壁”将原本只能通过特定客户端如 Gemini CLI、Antigravity、Qwen Code、Kiro 等访问的免费大模型通过协议转换与模拟封装成标准的OpenAI 兼容接口。简单来说它在你本地搭建了一个“万能翻译官”服务器。你的标准 OpenAI 应用如 NextChat、Cursor向它发送请求它负责将请求“伪装”成对应客户端的样子去调用 Google Gemini、Claude 等免费服务并将结果返回给你的应用。这使得你无需支付 API 费用即可在任意第三方工具中大规模使用 Claude Opus、Gemini Pro 等高级模型。主要功能1. 协议转换与统一接口支持将 Gemini CLI、Antigravity、Claude Kiro、Qwen Code 等非标准协议的模型统一转换为OpenAI / Claude API 格式。你的应用只需配置baseURLhttp://localhost:3000即可像调用 GPT-4 一样调用这些模型。2. 多模型与多模态支持模型覆盖支持 Gemini 3.0 Pro、Claude 4.5 Opus、Qwen3 Coder Plus 等前沿模型。多模态输入支持图像、文档PDF/Word等文件上传通过代理层自动处理并转发给后端模型。3. 账户池与高可用架构智能轮询内置账户池管理支持配置多个账号自动进行健康检查与负载均衡。自动降级当某类服务如 Gemini CLI达到限额429 错误时可自动降级切换至备用服务如 Antigravity确保 99.9% 的可用性。优先级调度可设置账户优先级优先使用高质量或高配额账号。4. Web UI 可视化控制台提供完整的 Web 管理界面默认端口 3000无需修改配置文件即可在浏览器中完成实时配置修改模型参数、代理设置。授权管理可视化配置 OAuth 凭证如 Gemini 的 refresh_token。监控日志实时查看请求日志、账户健康状态。5. 高级特性TLS 指纹模拟针对 Grok 等严格校验 JA3 指纹的服务集成 Sidecar 代理模拟浏览器 TLS解决 403 封禁问题。Kiro 扩展思维完整支持 Claude Kiro 的 Chain of Thought (CoT) 扩展思维模式通过配置thinking参数开启。安装与配置环境要求Node.js版本 18 或以上。系统Windows、macOS、Linux 均可需具备网络访问能力用于 OAuth 授权。快速安装推荐克隆仓库git clone https://github.com/justlovemaki/AIClient-2-API.git cd AIClient-2-API运行自动脚本Windows双击start_windows.batmacOS/Linux运行./start_unix.sh脚本会自动安装依赖并启动服务。Docker 部署可选进入docker目录修改docker-compose.yml配置后运行docker-compose up -d初始配置访问控制台浏览器打开http://localhost:3000默认账号密码为admin/admin123首次登录后建议修改。授权模型在 “Configuration” 页面选择对应 Provider如 Gemini点击 “Generate Authorization”按指引完成 OAuth 登录获取凭证。配置代理若需科学上网可在 Web UI 中统一配置 HTTP 代理地址。如何使用1. 作为本地 API 服务器启动服务后你的 AI 应用如 NextChat、OpenCat、Cursor只需修改以下配置API Base URLhttp://localhost:3000或你的服务器 IPAPI Key任意非空字符串如sk-xxxxAIClient-2-API 会忽略此 Key 并使用内置的账户池模型名称在 Web UI 中配置的模型标识符如gemini-3.0-pro2. 直接调用 API使用 curl 或 httpie 直接测试接口# OpenAI 兼容格式 curl http://localhost:3000/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer any_key \ -d { model: gemini-3.0-pro, messages: [{role: user, content: Hello}] }3. 开启高级功能开启 Kiro 思考在请求体中加入thinking: enabled或max_tokens: 4096。使用 Sidecar在 Web UI 中开启 TLS Sidecar 选项以应对严格的反爬环境。应用场景实例场景一IDE 插件免费使用 Gemini 3.0 Pro痛点开发者希望使用 Cursor 或 Codeium 等 IDE 的 AI 辅助编程功能但 OpenAI API 费用高昂且 Gemini 官方未提供兼容接口。AIClient-2-API 方案本地部署 AIClient-2-API配置好 Gemini CLI OAuth 凭证。在 Cursor 设置中将 API Endpoint 指向http://localhost:3000模型选择gemini-3.0-pro。效果IDE 现在完全通过本地的免费 Gemini 模型进行代码补全和问答体验与 GPT-4 无异且零成本。场景二企业内网统一 AI 网关痛点企业有多个团队需要使用不同模型Claude 做文案、Qwen 做代码但账号分散管理混乱且存在安全风险。AIClient-2-API 方案在内部服务器部署 AIClient-2-API配置好 Claude Kiro、Qwen Code 等多个账户池。为不同部门分配统一的 API 地址并设置账户优先级如给研发部优先使用高配 Claude 账户。效果企业拥有了一个高可用的内部 AI 网关所有外部模型请求被统一收敛便于审计和成本控制仅消耗免费额度。场景三规避 TLS 指纹封禁痛点在服务器上直接调用 Grok 或 Claude 官方 API 时因 TLS 指纹被识别为机器人而返回 403 错误。AIClient-2-API 方案启用内置的 TLS Sidecar 功能模拟真实浏览器的 TLS 握手特征。将所有请求路由经过 Sidecar 代理转发。效果成功绕过云服务器的 JA3 检测稳定调用原本无法访问的模型服务。风险与合规说明本地运行该工具运行在你本地或自有服务器不收集用户数据但需自行保管好 OAuth 凭证。服务条款使用需遵守各模型提供商Google、Anthropic 等的服务协议避免滥用导致账号封禁。仅供学习该项目基于 GPL-3.0 协议主要用于学习与研究协议转换技术。AIClient-2-API 极大地降低了使用前沿大模型的门槛将复杂的协议适配工作封装在后台让开发者能专注于应用层的创新。GitHub 地址https://github.com/justlovemaki/AIClient-2-API