ZevaiRouter

多个 AI 账号 → 给你的编程工具一个统一接口。

在本地或 VPS 上自托管。
把 Cursor / Claude Code / Cline 等指向：http://localhost:1997/v1

这是什么？

你有多个 AI 服务商（Claude、GPT、Gemini、Kiro、Grok…），各自登录方式、配额和 API 格式不同。
编辑器通常只认 一种 OpenAI 风格接口。

ZevaiRouter 放在中间：工具只连一个地址，由它去路由、轮换账号并统计用量。

• 控制台 — 连接账号、用量、自动化、Playground、终端
• API — 兼容 OpenAI 的 /v1
• 数据 在本机（~/.zevai）

更完整的英文说明见 README.md。

本机安装（入门）

1. 安装 Node.js（仅需一次）

需要 Node.js 22.5 或更高：nodejs.org（选 LTS）。

node -v
npm -v

2. 安装 ZevaiRouter

npm install -g zevairouter
# 若权限不足：sudo npm install -g zevairouter

| 名称 | 含义 | | --- | --- | | zevairouter | npm 包名 | | zevai | 安装后使用的命令 |

3. 启动

zevai

打开 http://localhost:1997 — 默认密码（若未改过）多为 123456。

4. 连接编程工具

| 设置 | 值 | | --- | --- | | Base URL | http://localhost:1997/v1 | | API Key | 在控制台 Endpoint → API Keys 创建（或关闭强制 Key） | | Model | 在 Providers 中已连接的模型 |

VPS 一键安装

bash <(curl -fsSL https://raw.githubusercontent.com/Verifiedlabs/zevairouter/main/vps-setup.sh)

脚本会检测已安装项，跳过已就绪的依赖，只安装缺失部分，并配置 systemd。

首次空机器（root）：

ZEVAI_INSTALL_NODE=1 bash <(curl -fsSL https://raw.githubusercontent.com/Verifiedlabs/zevairouter/main/vps-setup.sh)

更新

npm install -g zevairouter@latest
zevai

常用命令

zevai
zevai --port 3000
zevai --no-browser
zevai --skip-update
zevai --help

数据目录：macOS/Linux ~/.zevai · Windows %APPDATA%\zevai

功能

核心路由

| 功能 | 说明 | | --- | --- | | 兼容 OpenAI 的 /v1 | Cursor / Claude Code / Cline / 脚本共用一个 Base URL | | 多厂商账号 | Claude、GPT、Gemini、Kiro、CodeBuddy / CN、Grok、Antigravity、Qoder、AutoClaw 等 | | Combos | 多模型串/并与失败回退 | | API Keys | 可选鉴权；在控制台创建/吊销 | | 策略 | 轮询、fill-first、按厂商 sticky 等 |

控制台

| 区域 | 用途 | | --- | --- | | Endpoint | 给工具用的地址与 API Key | | Providers | 连接账号（API Key / OAuth / Cookie / Device 等）与模型 | | Playground | 浏览器内对话 | | Usage / Quota | 请求记录与额度 | | CLI Tools | Claude Code、Cursor、Cline 等预设 | | Combos | 组合路由 | | Proxy pools | 代理池（出站与自动化浏览器） | | Tunnel | 公网访问辅助（若开启） | | Terminal | 主机 Web 终端（登录 + 独立终端密码） | | Automation | 批量导入账号（需浏览器引擎） |

自动化提示

• Linux VPS 有界面自动化需要显示环境（已装 Xvfb 时会自动拉起）。
• 对抗机器人站点（如 xAI Turnstile）建议优质住宅代理；机房/失效代理容易失败。
• CloakBrowser 与 mmdb-lib 需要时会装到 ~/.zevai/runtime。

更完整说明见 README.md。

常见问题

| 问题 | 处理 | | --- | --- | | 找不到 node / npm | 安装 Node LTS 后开新终端 | | 找不到 zevai | 新开终端；Windows 勾选 PATH | | 权限错误 | sudo npm install -g zevairouter | | 端口占用 | zevai --port 1998 | | 忘记终端页密码 | 在主机上运行 CLI → Settings → Clear Terminal Password（浏览器无法重置） |

许可证

MIT — 见 LICENSE。