自建API代理平台：免费调用Claude/GPT/Gemini大模型教程

背景：AI Coding需求激增，API成本居高不下

随着AI编程工具的爆火，开发者对大模型API的需求急剧增长。然而，获利最大的并非用户，而是各大模型厂商。国内大厂的Coding相关服务基本需要争抢名额，国外Claude、Gemini、GPT三大厂商更是不仅API订阅价格高昂，还严格限制调用速度——很多用户刚对话几句就耗尽Token额度。

本质上，这是厂商借需求缺口收割流量的行为。高昂成本和受限体验让不少独立开发者望而却步。

iClient 2 API：突破客户端限制的开源方案

针对这一痛点，GitHub上的开源项目iClient 2 API应运而生。它的核心目标是让开发者零成本调用主流大模型API。

核心原理

多数厂商的网页端和客户端其实都提供了免费对话额度，但这些额度仅限官方界面内部使用，无法被外部应用（如IDE插件、自定义工具）调用，形同虚设。

要理解这一限制的技术背景，需要了解大模型厂商通常会严格区分两种使用场景：客户端使用和API调用。客户端（如ChatGPT网页版、Gemini App）提供的免费额度是厂商获取用户、收集反馈数据的营销手段，其成本由广告收入或订阅用户交叉补贴。而API是面向开发者的付费服务，按Token计费，利润率更高。厂商通过技术手段（如专有协议、会话绑定、设备指纹等）将两者隔离，防止免费额度被程序化调用。

iClient 2 API的核心思路是：将这些仅限客户端使用的免费大模型额度，转换为标准的OpenAI兼容接口。本质上，它逆向了客户端的通信协议，将其"翻译"为标准API格式，从而打破了厂商设置的场景隔离。

什么是OpenAI兼容接口？

OpenAI兼容接口（OpenAI-compatible API）是指遵循OpenAI公司定义的RESTful API规范的接口格式。该规范以/v1/chat/completions为核心端点，使用JSON格式传递消息历史和模型参数。由于OpenAI是大模型API商业化的先驱，其接口格式已成为事实上的行业标准。目前绝大多数AI开发工具、IDE插件（如Cursor、Continue、Cline等）和聊天客户端都原生支持这一格式。这意味着只要你的服务能提供一个符合该规范的端点，就能无缝接入整个生态系统中的工具链，无需为每个模型厂商单独适配。

支持的模型列表

该项目目前支持将以下服务的免费额度转为API：

• Google Gemini（包括Gemini 2.5 Flash等最新模型）
• Anthropic Claude
• OpenAI ChatGPT
• 以及其他支持OAuth授权的模型服务

用户无需支付高价订阅费，也不受客户端场景限制，即可在任何支持OpenAI接口的工具中调用这些模型。

Docker部署教程：从零搭建API代理服务

为了实现24小时不间断服务，建议将项目部署在海外服务器上。本地部署虽然可行，但没有公网IP的情况下配置更复杂，稳定性也不如服务器方案。

为什么选择Docker部署？

Docker是一种操作系统级别的虚拟化技术，它将应用程序及其所有依赖项打包到一个标准化的容器中运行。相比传统的手动安装方式，Docker部署具有环境一致性（消除"在我机器上能跑"的问题）、一键启停、资源隔离和易于迁移等优势。对于iClient 2 API这类需要Node.js运行时、数据库和Web服务器等多个组件协同工作的项目，Docker可以将所有依赖封装在单个镜像中，用户只需一条命令即可完成部署，极大降低了运维门槛。

服务器准备

由于需要访问GPT、Gemini等海外服务，建议选择美国节点的VPS。VPS（Virtual Private Server，虚拟专用服务器）是通过虚拟化技术在物理服务器上划分出的独立运行环境。选择美国节点的原因在于Google、Anthropic、OpenAI的服务器主要部署在美国，同区域访问延迟最低（通常在10-50ms之间），且不存在跨境网络不稳定的问题。如果使用国内服务器，则需要额外配置代理通道来访问这些海外服务，不仅增加了架构复杂度，还会引入额外的网络延迟和故障点。

配置方面，2核CPU + 2GB内存即可满足需求，系统推荐Debian。之所以对硬件要求不高，是因为API代理服务本身计算量很小，主要瓶颈在网络I/O而非CPU或内存。

Docker部署详细步骤

通过SSH连接服务器后，依次执行以下操作：

1. 更新系统软件：确保系统包管理器为最新状态
2. 安装数字证书管理器：为后续HTTPS配置做准备
3. 配置Docker环境：添加Docker官方软件源并安装Docker
4. 启动Docker服务：运行Docker并设置开机自启
5. 创建项目目录：新建文件夹存放配置文件
6. 下载并运行容器：拉取镜像并启动服务

部署完成后，通过服务器IP:3000即可访问Web管理面板，默认密码为admin123（务必首次登录后立即修改）。

配置与使用：以Gemini免费API为例

OAuth授权模型服务

OAuth（Open Authorization）是一种开放标准的授权协议，允许用户在不暴露密码的前提下，授权第三方应用访问其在某个服务上的资源。在iClient 2 API的场景中，OAuth授权的作用是让项目以用户身份合法登录Google、Anthropic等平台，从而获取该账号对应的免费对话额度。整个过程中，用户的密码不会被第三方项目获取，而是通过令牌（Token）机制完成身份验证。不过需要注意的是，授权后第三方应用获得的访问令牌仍然具有一定权限，用户应确保只对可信项目进行授权。

进入Web管理面板后：

1. 点击「供应商管理」
2. 选择对应的模型服务（如Gemini）
3. 点击「生成授权」→「OAuth授权」
4. 在弹出的页面中登录你的Google账号完成授权
5. 复制授权回调地址并提交

生成API密钥

授权成功后，进入「配置管理」：

• 生成一个API密钥
• 勾选需要使用的模型（可全选）
• 保存配置

在第三方工具中调用API

以Cherry Studio等AI客户端为例：

1. 进入设置 → 模型配置
2. 选择任何兼容OpenAI接口的选项
3. 填入生成的API密钥
4. API地址填写：http://服务器IP:3000/v1
5. 添加模型（如Gemini 2.5 Flash）
6. 保存并开启

任何支持OpenAI兼容接口的工具都可以接入，包括各类IDE编程插件（如Cursor、Continue、Cline、Copilot替代方案等）、聊天客户端、自动化工作流工具等。这正是采用OpenAI兼容接口标准的最大优势——一次部署，全生态通用。

注意事项与风险提示

合规性考量

需要注意的是，这类项目本质上是利用了厂商免费额度的「灰色地带」。虽然目前开源社区活跃，但存在以下风险：

• 账号封禁风险：厂商可能检测到异常调用模式并封禁账号。大模型厂商通常会监控API调用的频率模式、请求来源IP、会话行为特征等指标，当检测到与正常客户端使用模式显著不同的调用行为时（如高频率、无浏览器指纹、固定间隔请求等），可能触发风控系统。
• 服务稳定性：依赖厂商的免费策略，一旦政策调整可能失效。厂商可能随时修改客户端通信协议、收紧免费额度、或增加验证机制（如CAPTCHA、设备绑定等），导致项目需要频繁更新适配。
• 速率限制：免费额度本身可能存在调用频率上限，通常远低于付费API的速率限制。

适用场景

该方案更适合个人开发者用于学习和轻量级开发场景，不建议用于生产环境或商业项目。对于有稳定需求的团队，仍建议购买官方API服务以获得可靠的SLA（Service Level Agreement，服务等级协议）保障，确保可用性、响应时间和技术支持。

总结

iClient 2 API为受限于高昂API成本的开发者提供了一条可行的替代路径。通过Docker一键部署，配合OAuth授权机制，即可将各大厂商的免费客户端额度转化为标准API接口，大幅降低AI开发的入门门槛。但使用时需权衡合规风险，合理规划使用场景。

核心要点

• iClient 2 API是GitHub开源项目，可将Gemini、Claude、GPT等厂商的免费客户端额度转换为OpenAI兼容API接口
• 部署方案基于Docker，推荐使用美国节点VPS（2核2G即可），通过端口3000提供Web管理面板
• 通过OAuth授权机制获取模型服务的免费额度，生成API密钥后可在任何兼容OpenAI接口的工具中调用
• 该方案存在账号封禁和服务不稳定的风险，更适合个人学习和轻量开发场景
• 解决了AI Coding需求激增但API成本高昂的核心矛盾，降低了开发者使用大模型的门槛