ZAN Router CLI

一键把本机已安装的编码 Agent（Claude Code、OpenClaw、Codex、OpenCode、Neovate、Hermes、DSH）接入 ZAN Router。支持 macOS、Linux、Windows，Node >=18。

• 包名：@zan_team/zan-router
• 命令：zan-router
• 源码：TypeScript，tsup 构建为 dist/cli.js
• 集成指南：选择配置方式 · 一键配置 · 手动配置 · 兼容性 · 故障排查
• 参数文档：docs/cli.md

本地测试

npm install
npm run build

npx zan-router setup --model deepseek-v4-pro

安装

# 无需全局安装
npx @zan_team/zan-router setup --model deepseek-v4-pro

# 或全局安装
pnpm add -g @zan_team/zan-router
zan-router setup --model deepseek-v4-pro

命令

zan-router setup [--agents LIST] [--model MODEL] [--base-url URL]
zan-router detect
zan-router status [--agent AGENT] [--format text|json]
zan-router doctor [--agent AGENT] [--format text|json]
zan-router restore [--list] [--agent AGENT] [--backup ID]

• setup：检测已安装 Agent → 校验 API Key 与模型兼容性 → 安全写入配置。auto 为其废弃别名；也可直接用 Agent 名作为子命令（zan-router opencode --model ...）。
• detect：打印本机 Agent 安装状态，不联网不修改文件。CLI 不可用但配置目录/文件存在时，会提示 config found, CLI not in PATH。
• status：只读取本机安装与配置状态，不发起网络请求。
• doctor：分步骤串行实时诊断（Agent 安装、配置文件合法性、Base URL、凭证存在性、凭证有效性、模型权限、网络连通性、最小真实请求）。
• restore：查看或恢复 CLI 创建的恢复点。每个 Agent 拥有独立 backup ID；--list 展示执行各恢复点后预计得到的模型；直接执行且有多个 Agent 可恢复时，需要交互选择一个 Agent。

--api-key 被禁用，Key 只能通过隐藏交互输入或 ZAN_API_KEY 环境变量提供。 --base-url 默认 https://ai.zan.top，/v1 由 CLI 按需补充。

开发

pnpm install
pnpm typecheck     # tsc --noEmit
pnpm test          # vitest 单元测试
pnpm test:cli      # 构建 + CLI 集成测试
pnpm test:package  # 构建 + pack→install→run 冒烟
pnpm build         # tsup 产出 dist/cli.js
pnpm dev           # tsx 直接运行源码