分钟搭建本地代理，让你用上免费的 Claude 官方模型

2026-3-22 16:43 2323 0

摘要: 原因二：第一次启动失败了按照官方的一键脚本跑，结果报了个端口占用的错误。它可以把你电脑上的 Kiro 客户端（内置免费 Claude 模型）、Gemini CLI 这些原本只能客户端使用的模型，通通转换成标准的 OpenAI 接口。原因一：配置看起来很复杂官方文档写得很详细，但对于新手来说，信息量太大了。

关键词：API, 模型, Kiro, Claude, Claude Code, Gemini CLI, Kiro 客户端, OpenAI API, 客户端, AIClient

前两天我的 Claude Code 又双叒叕被封了。

相信这段时间大家都一样，Claude Code 接口隔三差五就挂，不是返回 429 就是直接提示账号异常。之前我为了稳定使用，每个月花 $200 买 Claude Code 会员，结果呢？该封还是封，该挂还是挂。

但就在上个月，我发现了一个神器 —— AIClient-2-API。它可以把你电脑上的 Kiro 客户端（内置免费 Claude 模型）、Gemini CLI 这些原本只能客户端使用的模型，通通转换成标准的 OpenAI 接口。

换句话说：别人还在焦虑封号的时候，我已经用本地代理稳定跑通 Claude 4.5 了，一分钱没花。

今天我就手把手带你跑一遍，3 分钟让你也能用上。

这个工具解决什么问题

先说清楚：AIClient-2-API 是一个本地代理服务。

它的工作原理是这样的：

很多 AI 客户端（比如 Kiro、比如 Google 的 Gemini CLI）本身是免费的，内置了 Claude 模型或者 Gemini 模型。但这些模型只能在这个客户端里用，别的工具（比如你常用的 Cherry-Studio、NextChat、Cline）根本调不动。

而 AIClient-2-API 做的事情，就是拦截这些客户端的请求，模拟一遍，然后把这些请求封装成标准的 OpenAI 接口吐出来。

这样一来，你可以让任何支持 OpenAI API 的工具，去调用原本只有 Kiro、Gemini CLI 才能用的模型。

核心优势：

免费：Kiro 内置的 Claude 模型不要钱
稳定：不依赖第三方中转，被封的概率极低
通用：一次配置，Cherry-Studio、NextChat、Cline 都能用

为什么我差点放弃这个工具

说实话，我第一次看到这个项目的时候，差点没坚持下去。

原因一：配置看起来很复杂

官方文档写得很详细，但对于新手来说，信息量太大了。什么 OAuth 授权、什么凭据文件、什么 provider pools，听起来就头大。我当时看着看着就想放弃了。

原因二：第一次启动失败了

按照官方的一键脚本跑，结果报了个端口占用的错误。我又不懂 Node.js，折腾了半天才发现是 3000 端口被别的服务占用了。

原因三：不知道授权能干啥

按照文档配置好了 Gemini CLI 的 OAuth，结果跑起来一直返回 401。我当时完全懵的，不知道问题出在哪。

后来我发现，其实最大的坑在于：很多人不知道 Kiro 这个客户端本身就内置了 Claude 模型，而且这个模型是可以通过代理调用的。一旦打通这一点，后面就顺了。

所以这篇文章，我会把最核心的那条路画出来，让你直接跑通，少走弯路。

实战开始：3 分钟跑通最小闭环

我们今天的目标很简单：让 Cherry-Studio 通过本地代理，调用 Kiro 内置的免费 Claude 模型。

你需要准备的东西：

一台电脑（Windows / Mac / Linux 都可以）
Kiro 客户端（免费版就行）

接下来跟着我做。

第一步：下载并安装 Kiro 客户端

去 Kiro 官网下载安装包：https://kiro.dev/pricing/

安装完成后，打开 Kiro，用你的账号登录。

这里有个关键点：Kiro 需要完成登录，才能生成认证凭据文件。后面的代理服务会读取这个文件来模拟你的身份。

登录完成后，先不要关掉 Kiro，我们继续。

第二步：下载 AIClient-2-API

打开终端（Windows 用户用 PowerShell 或者 CMD，Mac 用户用 Terminal），运行以下命令：

# 克隆项目
git clone https://github.com/justlovemaki/AIClient-2-API.git

# 进入目录
cd AIClient-2-API

# 安装依赖
npm install

如果你的电脑没有安装 Node.js，先去 https://nodejs.org/ 下载安装 LTS 版本。

依赖安装完成后，你会看到一堆 warning，不用管，继续下一步。

第三步：启动服务

在终端里运行：

# 方式一：直接运行（默认端口 3000）
node ./src/index.js

# 方式二：指定端口（如果 3000 被占用）
node ./src/index.js --port 8080

正常情况下，你会看到类似这样的输出：

 AIClient-2-API 服务已启动
 访问地址: http://localhost:3000
 默认密码: admin123

注意：如果这里报错了，提示端口被占用，换一个端口号就行：

node ./src/index.js --port 8080

第四步：配置 Kiro 授权

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

用默认密码 admin123 登录，你会看到 Web 管理界面。

在左侧菜单找到「配置管理」，点击进入。

找到 Kiro 这一行，点击右上角的「生成授权」按钮。

这时候系统会提示你：

请确保 Kiro 客户端已登录并完成授权

因为我们之前已经登录过 Kiro 了，系统会自动读取 ~/.aws/sso/cache/kiro-auth-token.json 这个凭据文件。

授权成功后，你会在「配置文件」页面看到新生成的凭据文件。

第五步：在 Cherry-Studio 中配置

打开 Cherry-Studio，进入设置 → API 配置。

按照以下填写：

API 地址：http://localhost:3000/v1（如果你用的是别的端口，改成对应的）
API Key：123456（这是默认的，可以在 Web UI 里改）

模型选择那里，你会看到出现了 claude-kiro-oauth 相关的模型，选择其中一个（比如 claude-sonnet-4-5-20250514）。

然后就可以正常聊天了。

不信你现在随便问一个问题试试。

真实使用场景

跑通之后，我主要用这个方案做以下几件事：

场景一：日常对话和代码审查

我把 Cherry-Studio 的主力模型切换成了 Kiro 里的 Claude Sonnet 4.5。对话质量很高，关键是稳定。不像之前用 Claude Code，三天两头需要重新登录。

场景二：Cline / Continue 等 IDE 插件的 AI 能力

以前这些插件需要配置 OpenAI 或者 Anthropic 的 API，每个月都要花不少钱。现在直接指向本地代理，同样的模型，换了个免费的口子。

场景三：备用方案

我会同时跑着两个服务：一个是 AIClient-2-API（走 Kiro），一个是 Claude Code。万一 Claude Code 挂了，无缝切换到 Kiro，几乎无感知。

一个关键技巧：同时启用多个提供商

这是我最近发现的一个极大提升稳定性的玩法。

在 Web UI 的「提供商池」页面，你可以同时配置 Kiro + Gemini CLI + Antigravity 多个账号。

当某一个账号触发限流（返回 429）时，系统会自动切换到另一个账号。整个过程对你的应用是透明的。

配置方式很简单：

在「配置管理」页面，分别给 Gemini、Antigravity 点击「生成授权」
系统会自动把凭据保存到对应目录
在「提供商池」页面，确保这些提供商都是启用状态

这样一来，你实际上拥有了一个自动故障转移的模型池，稳定性直接拉满。

注意事项和边界

说了这么多好处，也要说说这个方案的边界：

Kiro 模型不是无限的：虽然免费，但每天的请求量有限制。具体多少取决于 Kiro 官方的策略，建议跑通后观察一下配额。
依赖本地服务：AIClient-2-API 需要跑在你的电脑上。如果你出门在外用手机，就没辙了。这时候可以搭配 Tailscale 或者 frp 做内网穿透，但那就是另一个话题了。
凭据会过期：Kiro 的 OAuth 凭据一段时间后需要重新授权。如果发现接口突然返回 401，去 Web UI 里重新点一下「生成授权」。
合规使用：这个工具只是把客户端的请求封装成 API 接口，不涉及任何破解或者破解行为。模型本身都是官方提供的。但还是建议用在学习和研究场景，不要用于商业用途。