router

环境要求

• Node.js ≥ 18（安装器基于 npx 运行）
• 使用 Claude Code、opencode 或 pi 路径时，本机需安装 jq
• 可访问 npm 源与托管的 Weave Router 服务
• 若使用 --local 自托管模式，本机需能监听 localhost:8080

安装与启动步骤

1. 1检查 Node 版本

   安装器通过 npx 运行，必须先确认本机 Node 版本不低于 18；版本过低请先升级 Node。

   node -v

   复制

2. 2一键接入路由器

   运行交互式安装器，选择 Claude Code、Codex、opencode 或 pi，选择作用范围并自动获取 router key 并写入配置。

   npx @weave-os/router

   复制

3. 3跳过选择器直连

   已知所用工具时，可用对应参数跳过交互选择，直接为指定工具写配置。

   npx @weave-os/router --claude
   npx @weave-os/router --codex
   npx @weave-os/router --opencode
   npx @weave-os/router --pi

   复制

4. 4设为项目级配置

   使用 project 范围时，配置写入当前仓库（settings.json、.codex/ 或 opencode.json），会被提交，注意别泄露 key。

   npx @weave-os/router --scope project

   复制

5. 5切换自托管模式

   使用 --local 改为自托管，服务在本机 localhost:8080 上运行，不再走托管服务。

   npx @weave-os/router --local

   复制

6. 6指向自建地址/固定版本

   内网部署时用 --base-url 指向自有路由器地址；也可指定版本号避免自动升级。

   npx @weave-os/router --base-url https://router.acme.internal
   npx @weave-os/router@0.1.0

   复制

如何确认成功

安装器执行完毕后会为所选工具写好配置文件并获取到 router key；用 --local 时服务监听本地 localhost:8080。

常见问题

注意事项

• npm 包名为 @weave-os/router，旧名 @workweave/router 为兼容别名，发布内容一致。
• README 提到建议设置 dashboard 密码：不设密码推理仍能运行，但为安全起见应设置。
• --scope project 会把配置提交进仓库，注意不要泄露 router key。
• 以上命令均来自 README 的 30-second quickstart，完整参数见 install/npm/README.md。