通过OmniRoute与Node.js 22免费获取Claude Sonnet 4.5访问权限
OmniRoute 必须使用特定的 Node.js 版本 22,因为后续版本不支持所需依赖项。建议使用 nvm 来管理你的 Node.js 版本。
安装 nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
将以下内容添加到 ~/.zshrc 或 ~/.bashrc 文件中:
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
应用更改:
source ~/.zshrc
安装并激活 Node.js 22:
nvm install 22
nvm alias default 22
验证版本:
node -v
输出应为类似 v22.x.x 的格式。
安装并初始化 OmniRoute
全局安装 OmniRoute:
npm install -g omniroute
创建配置文件并设置密码:
mkdir -p ~/.omniroute
touch .env
echo -n $'\nINITIAL_PASSWORD=your_new_password\n' >> .env
默认密码为 123456。
运行命令:
omniroute
输入密码后,默认会打开一个网页控制台。
配置 KiroAi 提供商
在 OmniRoute 控制台中,选择 KiroAi,然后点击 配置提供商。
选择 AWS Builder ID。使用你的 Google 账号登录,并确认 AWS 授权权限。
授权成功后,可用模型(包括 Claude Sonnet 4.5)将出现在提供商列表中。
进入 API 管理器 → 创建第一个密钥。保存生成的 API 密钥。
在 端点 页面,复制基础 URL:http://localhost:20128/v1。
与 OpenCode 集成
安装 OpenCode:
npm i -g opencode-ai
创建或编辑 ~/.config/opencode/opencode.json 文件:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"omni": {
"name": "OmniRoute",
"npm": "@ai-sdk/openai-compatible",
"models": {
"kr/claude-sonnet-4.5": {
"name": "Omni sonnet-4.5"
},
"kr/claude-haiku-4.5": {
"name": "Omni Haiku-4.5"
}
},
"options": {
"baseURL": "http://localhost:20128/v1"
}
}
}
}
从 OmniRoute 控制台复制模型 ID(kr/claude-sonnet-4.5):http://localhost:20128/dashboard/providers/kiro。
将你的 API 密钥添加到 ~/.local/share/opencode/auth.json 文件中:
{
"omni": {
"type": "api",
"key": "sk-your-api-key"
}
}
运行 opencode 命令,使用 /models 命令选择模型。
设置步骤总结
| 步骤 | 操作 | 命令/操作 |
|------|--------|----------------|
| 1 | 安装 nvm | curl ... | bash |
| 2 | 安装 Node.js 22 | nvm install 22 |
| 3 | 安装 OmniRoute | npm install -g omniroute |
| 4 | 配置 .env | echo INITIAL_PASSWORD=... >> .env |
| 5 | 启动服务 | omniroute |
| 6 | 配置提供商 | 通过 Google 使用 AWS Builder ID |
| 7 | 获取 API 密钥 | API 管理器 → 创建密钥 |
| 8 | OpenCode 配置 | 编辑 ~/.config/opencode/opencode.json |
| 9 | 认证设置 | 编辑 ~/.local/share/opencode/auth.json |
关键要点
- Node.js 版本:仅支持版本 22,否则 OmniRoute 无法启动。
- API 密钥:
opencode.json和auth.json中的提供商标识(omni)必须完全一致。 - 基础 URL:请使用
http://localhost:20128/v1—— 这是与 OpenAI 兼容的精确接口地址。 - 认证方式:通过 Google 登录 AWS Builder ID 即可访问 KiroAi 模型,无需使用 VPN。
- 模型标识符:使用
kr/claude-sonnet-4.5表示 Sonnet 4.5 模型,请在 OmniRoute 控制台中核对确认。
此方法让你无需订阅或受地域限制,即可本地代理访问高端大模型。OmniRoute 支持 OpenAI 兼容接口,轻松集成至现有开发流程。
— Editorial Team
暂无评论。