# @alexeiled/claude-router 中文文档

规范地址：https://npmcn.com/package/%40alexeiled/claude-router/

版本：1\.21\.0
npm 元数据更新时间：2026-11-04T07:31:58.205Z
中文译文更新时间：2026-11-06T02:32:24.562Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40alexeiled/claude-router
原文对照：https://npmcn.com/package/%40alexeiled/claude-router/?lang=original
项目主页：https://github.com/alexei-led/claude-router#readme
源码仓库：https://github.com/alexei-led/claude-router

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：923 kB，51 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：0 个
- 首次发布：2026-09-22T13:03:23.242Z
- 最新版本发布：2026-11-04T07:31:57.848Z
- 近 30 天下载量：6287（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：56（近 12 个月 56 个）

## 中文简介

克洛德原住民代码模型和努力路由,与Anthropic,DeepSeek,z.ai,MiniMax,MiMo和Kimi默认,自定义提供者配置,以及分类建议.

## 安装

```sh
npm install @alexeiled/claude-router
```

也可以使用：`pnpm add @alexeiled/claude-router`、`yarn add @alexeiled/claude-router`、`bun add @alexeiled/claude-router`

## README

# Claude 模式路由器

[![CI](https://github.com/alexei-led/claude-router/actions/workflows/ci.yml/badge.svg)](https://github.com/alexei-led/claude-router/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**一个Claude Code Mod,它为每个主对口转弯选择一个模型和努力,由一个即时分级器提供建议:Jev;Cloudflare's Clef, Clef Flash 或 Clef Omni; OpenAI;或当地Ollama模型.**

摩德只改变了克洛德密码的"倒钩"中的模型和努力. Claude Code发送请求,流出回复,运行工具,并报告使用情况. 路由器不代理模式流量或启动本地服务器; Ollama 分类器调用您运行的 Ollama 服务器 。 副代理商在开始时每个获得一个模型,选择了同样的方式:每个定义名称没有模型的代理商都说: `model: inherit`组合 `modelRouting: auto`他们的台阶从不改道 见 [子剂通路](https://npmcn.com/package/%40alexeiled/claude-router/docs/configuration.md#subagent-routing)。 。 。 .

## 供应商

使用已经与克洛德密码合作的提供者. 选择其路由器配置文件, 而不是新终点 :

```sh
CLAUDE_ROUTER_PROVIDER=deepseek claude --model 'deepseek-flash[1m]'
```

创建 `~/.claude/deepseek-router.json` 包含 `{}` 以使用 DeepSeek 默认值. 与 `CLAUDE_CONFIG_DIR`,将文件放入目录.

| 内建配置文件 | 路由器文件 | 默认模式 |
| --- | --- | --- |
| Anthropic, 默认值 | `router.json` | 海库 5.5, Sonnet 5.5, Opus 5.5 |
| `deepseek` | `deepseek-router.json` | 深搜索闪光灯,通过努力传送 |
| `zai` | `zai-router.json` | GLM-5.3-Flash和GLM-5.3 |
| `minimax` | `minimax-router.json` | 迷你Max-M3.1-Flash,经过努力 |
| `mimo` | `mimo-router.json` | 米莫-V2.6-Flash和米莫-V2.6-Pro,无路由工作 |
| `kimi` | `kimi-router.json` | Kimi-K3.1-Pro,经过努力 |

OpenRouter, Ollama, 其他本地服务器和其他兼容的主机供应商使用自定义 `<provider>-router.json` 文档. 它们没有内置模型默认值. 所选文件必须存在并验证,否则路由器会让克洛德代码的模型保持不变.

见 [供应商](https://npmcn.com/package/%40alexeiled/claude-router/docs/providers.md) 页:1 **默认路径和活动**, (中文(简体) ), **自定义配置**,则 **`--settings` 标记选项**。 。 。 . 执行提供者的选择与分类者选择是分开的. 即使一个提供者的缓存行为使得无法进行储蓄比较时,被观察到的用法仍然可见.

## 支持的分类器

活动分类器是在每个逻辑转弯的起步处为分级和转弯活动而询问的,在转弯运行时,再次在背景中每4个请求(`policy.reviewEveryRequests`) (中文(简体) ). 在窗子上挑一个 **分类符** 选项卡或选定的路由器文件中;只有活动者收到即时文本。 有子剂的路由 `on` (默认),它也会被询问一次每个路由子代理,并附有任务描述和即时; 设置 `"subagentRouting": "off"` 保持文本本地化.

| 分类符 | 服务 | 证书 | 快速文本转到 | 如何要求活动 |
| --- | --- | --- | --- | --- |
| 杰维 | [类型安全.ai](https://typesafe.ai/) | Jev API 密钥 | 类型安全.ai | 第三个 `choice` 请求中提出的问题 |
| 克莱夫 | Cloudflare工人大赦国际,27B | Cloudflare API 令牌和账户 ID | 云雾花 | 一样 |
| 克莱夫闪光灯 | 云旗工人大赦国际,9B | Cloudflare API 令牌和账户 ID | 云雾花 | 一样 |
| 克莱夫·奥姆尼 | Cloudflare工人大赦国际,30B 教育部 | Cloudflare API 令牌和账户 ID | 云雾花 | 一样 |
| 开放AI | 开放AI, `gpt-6-luna` (公开β) | OpenAI API 密钥 | OpenAI (英语:`api.openai.com`(中文(简体) ) | 一秒钟 `choice` 内 `questions`,在同一请求中 |
| 奥拉玛 | 当地人 [奥拉玛](https://ollama.com/) 模式 | 无 | 留在这台机器上 | 第二项请求:如果还有300毫秒或以上,则字母A至H,一个符号 |

Jev是默认的. [配置](https://npmcn.com/package/%40alexeiled/claude-router/docs/configuration.md#classifiers) 给出结束点,超时,以及如何添加另一个会说所支持的协议之一的服务.

![The Router band above the Claude Code prompt in eight states](https://npmcn.com/package/%40alexeiled/claude-router/docs/router-band.svg)

提示上方的波段显示每个转弯的层次,活性,模型和原因. `/router` 打开一个平面来标出一个分级,编辑每个分级的模型和努力,并调整政策。 见 [用户指南](https://npmcn.com/package/%40alexeiled/claude-router/docs/user-guide.md#read-the-status-band)。 。 。 .

路由器需要克劳德代码2.1.289或更新. 节余没有计量。 窗格的"用法"标签估计了以配置的列表价格为相同物物的无路由成本(您自己在主线上的模型,克洛德代码对每个子代理的取取取),对于这届,即今天,7或30天,这个月或所有的时间;它不是一个账单,也不判断答案的质量. 见 [评价](https://npmcn.com/package/%40alexeiled/claude-router/docs/evaluation.md)。 。 。 .

## 如何运作

```mermaid
sequenceDiagram
  actor Dev as Developer
  participant Code as Claude Code
  participant Mod as Router Mod
  participant Cls as Classifier
  participant API as Model provider
  Dev->>Code: Prompt
  opt Subagent spawn
    Code->>Mod: agent.spawn
    Mod-->>Code: One model for the agent (on), or none (off)
  end
  Code->>Mod: Main or subagent step
  alt Main conversation, routing on
    Mod->>Cls: Bounded prompt and dialogue
    Cls-->>Mod: Tier advice
    Mod-->>Code: Selected model and effort
  else Routing off or subagent step
    Mod-->>Code: Original model and effort
  end
  Code->>API: Native request and tools
  API-->>Code: Response stream and usage
  Mod-->>Dev: Status band and router pane
```

活动分类器标签每个新逻辑转折, 路由器在任务运行时再次检查路由: 标签为转折 `ops` 编辑代码移动到 `code` 路径一次,一个背景分类器每4个请求可以移动层次或活动。 同一任务上更便宜的路线等待一个住地,而检查站的工作可以显示:通过测试、构建或嵌入运行,或命令、文件和只读的工作,路由器能够看到的成功。 任务通知将作为您上次请求的进展. `/router decisions` 列出为什么每个转弯都跑到它过去的地方。 见 [任务期间的变化](https://npmcn.com/package/%40alexeiled/claude-router/docs/user-guide.md#changes-during-a-task)。在Mod修改下一步之前,当地的政策适用投票、上下文、失败和缓存成本规则。 Claude Code拥有请求构建,模型证书,工具,流化,以及API成本分类账.

以"Anthropic"为剖面,基线为:

| 级别 | 默认模式 | 努力 |
| --- | --- | --- |
| `micro` | 海库 5.5 | `medium` |
| `low` | 海库 5.5 | `high` |
| `medium` | 奥普斯 5.5 | `medium` |
| `high` | 奥普斯 5.5 | `xhigh` |

这些都是路由默认。 它们并不声称具有同等的模型质量. [配置](https://npmcn.com/package/%40alexeiled/claude-router/docs/configuration.md#built-in-defaults) 给出其背后的公布结果和 `router.json` 恢复1.3索内梯子的线条.

活动路由增加了第二个标签:转弯产生的东西(`code`, (中文(简体) ), `debug`, (中文(简体) ), `explore`, (中文(简体) ), `plan`, (中文(简体) ), `review`, (中文(简体) ), `ops`,或 `docs`) (中文(简体) ). 然后按层次和活动选择一条路线。 它自1.7起默认生效。 A 类 `·` 单元格使用层本身的路径, 基线:

Anthropic profile使用了这些活动默认. 其他简介 [它们的默认](https://npmcn.com/package/%40alexeiled/claude-router/docs/providers.md#activity-overrides)。 。 。 .

| 活动 | `micro` | `low` | `medium` | `high` |
| --- | --- | --- | --- | --- |
| 基本路线 | 海库 中 | 海库高地 | O 介质 | Opus 高分数 |
| `code`, (中文(简体) ), `debug`, (中文(简体) ), `plan`, (中文(简体) ), `review` | • 妇女 | **声纳 高** | • 妇女 | • 妇女 |
| `ops` | • 妇女 | • 妇女 | **海库高地** | • 妇女 |
| `explore`, (中文(简体) ), `docs` | • 妇女 | • 妇女 | • 妇女 | • 妇女 |

`/router activities off` 停止询问并保持基地路线. [活动路线](https://npmcn.com/package/%40alexeiled/claude-router/docs/activity-routing.md) 解释每个细胞 以及如何改变它。 标签是可选的 : `uncertain` 或弱标签 如果移动通过缓存检查,当活动答案失败运行活动而分级答案仍然适用时,如果分类器失败运行的路由停留时,则使用基准路由. 见 [按活动分列的路线](https://npmcn.com/package/%40alexeiled/claude-router/docs/user-guide.md#route-by-activity),以及 [评价](https://npmcn.com/package/%40alexeiled/claude-router/docs/evaluation.md#activity-routing) 如何检查。 它的默认凌驾于已公布的供应商结果以及一个开发商的会话的列表价格重放,而不是计量的节约.

A 类 [路由模式](https://npmcn.com/package/%40alexeiled/claude-router/docs/routing-modes.md) 交易成本与答题质量相比没有新的路径: `cost` 换一个更便宜的模型 或者一个工作水平 少一些在转弯允许的情况下, `quality` 以上一级或以上一级工作水平 `balanced`,默认值,按配置运行路径。 按会话设置 `/router mode cost`,每个项目单位 `.claude/router.json`,或用于配置 `"mode"` 内 `router.json`。 。 。 .

对于混合的Anthropic和DeepSeek会话,请使用明文 [模型代理配置文件](https://npmcn.com/package/%40alexeiled/claude-router/docs/providers.md#mix-anthropic-and-deepseek-with-model-proxy) 带有单独启动的本地代理 。 没有安装内置的混合提供者默认值 .

## 安装

你需要克劳德代码2.1289 或更新 和证书之一 [支持的分类器](https://npmcn.com/package/%40alexeiled/claude-router/#readme-supported-classifiers)。 。 。 .

```sh
claude plugin marketplace add alexei-led/claude-router
claude plugin install router@alexei-led-claude-router
```

对于默认的 Anthropic 剖面图,请从完整基准模型开始,例如 `claude --model claude-haiku-5-5`对于其他提供者, [选择一个提供者配置](https://npmcn.com/package/%40alexeiled/claude-router/docs/providers.md#select-a-provider)运行 `/plugin configure router` 并保存密钥。 对于任何其他分类者,保存其证书,或运行 `ollama serve` 然后在窗格的分类器标签上选择分类器。 新建一个分层路线或活动路线模式的会议 `on` 一种活动超过使用的模型(默认值为Sonnet 5.5),起始于路由启动;在任何其他模型上,起始于路由关闭,并说明原因,以及 `/router auto` 打开线路.

Claude Code在启动时更新插件, 当这个市场自动更新时。 否则就跑 `claude plugin marketplace update alexei-led-claude-router`,则 `claude plugin update router@alexei-led-claude-router`。 。 。 .

从0.8升级? 删除0.8的网关设置 `/router:setup` 在第一个 1.0 会话前写出,或者请求进入一个不再开始 1.0 的网关。 跟着 [移徙步骤](https://npmcn.com/package/%40alexeiled/claude-router/docs/user-guide.md#move-from-v08-gateway-setup)。 。 。 .

## 从退票中运行

以此目录作为本地插件和完整的海库基线模型启动 Claude Code :

```sh
claude --plugin-dir "$PWD" --model claude-haiku-5-5
```

在克洛德代码,运行 `/plugin configure router` 并保存敏感插件选项中的分类键。 摩德增加了它的状态带和 `/router` 窗关。 不需要状态线设置或网关环境变量.

运行 `/router` 打开面板:路由状态、每层控制、调制和用法,包括路由与无路由。 运行 `/model` 选择一个模型并关闭路由,以及 `/router auto` 打开它 关于控制、度量衡、调制和故障排除,见 [用户指南](https://npmcn.com/package/%40alexeiled/claude-router/docs/user-guide.md)。 。 。 .

在推前,进行与CI相同的检查. `npm run setup` 安装 Biome 和 TypeScript `tools/`;插件根没有锁文件,所以克洛德代码没有安装插件. `npm run validate` 财务报告和审定财务报表 `npm run test:plugin` 需要帮助 `claude` CLI:他们在克洛德码引擎中加载了Mod,它拒绝一些擦拭和单位测试缺失的故障.

```sh
npm run setup
npm run check && npm run typecheck && npm test && npm run validate && npm run test:plugin
```

## 文档

-   [用户指南](https://npmcn.com/package/%40alexeiled/claude-router/docs/user-guide.md):安装,使用控件,读取面板,并排除出故障.
-   [供应商](https://npmcn.com/package/%40alexeiled/claude-router/docs/providers.md): 提供者名称,路由器文件,内置默认,以及自定义配置.
-   [配置](https://npmcn.com/package/%40alexeiled/claude-router/docs/configuration.md):路由器-文件设置,分类器密钥,缓存政策,和迁移.
-   [建筑](https://npmcn.com/package/%40alexeiled/claude-router/docs/architecture.md): Mod事件流,状态,保障,和运行时间边界.
-   [活动路线](https://npmcn.com/package/%40alexeiled/claude-router/docs/activity-routing.md):按活动排列的默认矩阵,为什么每个单元格,以及如何改变或关闭.
-   [运行模式](https://npmcn.com/package/%40alexeiled/claude-router/docs/routing-modes.md)数字 : `cost`, (中文(简体) ), `balanced` 财务报告和审定财务报表 `quality`,模式的来源,以及每个模式的每个决定.
-   [本地路由器细节](https://npmcn.com/package/%40alexeiled/claude-router/docs/native-router.md):面板语义,调和,并被接受的限制.
-   [评价](https://npmcn.com/package/%40alexeiled/claude-router/docs/evaluation.md):历史网关结果和原生影回放.
-   [更改日志](https://npmcn.com/package/%40alexeiled/claude-router/CHANGELOG.md):按版本划分的用户可见变化.

## 常见问题

### @alexeiled/claude-router 是什么？

克洛德原住民代码模型和努力路由,与Anthropic,DeepSeek,z\.ai,MiniMax,MiMo和Kimi默认,自定义提供者配置,以及分类建议\.

### 如何安装 @alexeiled/claude-router？

在项目目录运行 npm install @alexeiled/claude-router，或使用 pnpm add / yarn add / bun add。

### @alexeiled/claude-router 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/alexeiled\_\_claude-router 是否存在。

### @alexeiled/claude-router 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @alexeiled/claude-router 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @alexeiled/claude-router 可以商用吗？

@alexeiled/claude-router 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @alexeiled/claude-router 的下载量有多少？

根据 npm 官方下载统计，@alexeiled/claude-router 在 2026/10/06 – 2026/11/04 这 30 天内被下载 6,287 次，日均约 210 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @alexeiled/claude-router 还在维护吗？

最新版本 1\.21\.0 发布于 2026/11/04（1 天前）；至今共发布 56 个版本，其中过去 12 个月发布了 56 个；首次发布于 2026/09/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。