Claude 模式路由器

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

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

供应商

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

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

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

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

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

支持的分类器

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

Jev是默认的. 配置 给出结束点,超时,以及如何添加另一个会说所支持的协议之一的服务.

提示上方的波段显示每个转弯的层次,活性,模型和原因. /router 打开一个平面来标出一个分级,编辑每个分级的模型和努力,并调整政策。 见 用户指南。 。 。 .

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

如何运作

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 列出为什么每个转弯都跑到它过去的地方。 见 任务期间的变化。在Mod修改下一步之前,当地的政策适用投票、上下文、失败和缓存成本规则。 Claude Code拥有请求构建,模型证书,工具,流化,以及API成本分类账.

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

这些都是路由默认。 它们并不声称具有同等的模型质量. 配置 给出其背后的公布结果和 router.json 恢复1.3索内梯子的线条.

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

Anthropic profile使用了这些活动默认. 其他简介 它们的默认。 。 。 .

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

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

对于混合的Anthropic和DeepSeek会话,请使用明文 模型代理配置文件 带有单独启动的本地代理 。 没有安装内置的混合提供者默认值 .

安装

你需要克劳德代码2.1289 或更新 和证书之一 支持的分类器。 。 。 .

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

对于默认的 Anthropic 剖面图,请从完整基准模型开始,例如 claude --model claude-haiku-5-5对于其他提供者, 选择一个提供者配置运行 /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 的网关。 跟着 移徙步骤。 。 。 .

从退票中运行

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

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

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

运行 /router 打开面板:路由状态、每层控制、调制和用法,包括路由与无路由。 运行 /model 选择一个模型并关闭路由,以及 /router auto 打开它 关于控制、度量衡、调制和故障排除,见 用户指南。 。 。 .

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

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

文档

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