Make Codex and Claude Code subscriptions go further: a local model router that gives routine agent work to economical models and keeps your strongest model for the hard parts.
快速开始
先安装 macOS 桌面应用或 Linux 无界面版,接入模型来源,再按需要直接创建固定模型或按难度分流路由。按难度分流路由可以明确选择本地规则,不要求部署外部决策服务;任务委派是独立能力。
1. 选择运行方式
- macOS 桌面应用:要求 macOS 15.0 或更高版本。公开安装包为自签名构建,下载后先核对 SHA256,再按 macOS 安装与首次启动 的说明打开应用。
- Linux 无界面版:面向服务器、远程工作站和自动化环境,按当前用户安装,不需要
sudo。按 Linux 无界面版安装 启动服务并通过 CLI 完成后续配置。
下面第 2–5 步展示桌面应用的可视化路径。Linux 用户可按无界面版指南,用 CLI 完成相同配置。无论使用哪种入口,都先确认本机服务已经就绪;模型路由、会话记录和任务执行都依赖它。
使用 CLI 或 Agent 接入
运行 hiroute quickstart 查看当前服务、准确的配置目标和可复用来源/路由;选定后加 --context CONTEXT_ID --plan PLAN_ID。指定 Hermes 配置时可加 --hermes-root /ABSOLUTE/EFFECTIVE/ROOT。这个入口只读状态,并说明还缺哪些选择以及下一步命令。
主路径是“来源 → 路由 → 目标 Agent → 原生加载 → 匹配的真实请求证据”。现有 Preview 命令支持简化选择和 --apply-file PATH,无需手写完整编辑器或搬运摘要。参见 CLI Quickstart,了解直接按难度分流组合、调整、响应丢失后的恢复和独立能力恢复。同一管理 Skill 可在任何受支持 Agent 中运行并管理另一个目标,调用方自己的模型可以保持原生接入。
需要决策模型时,先用 hiroute decision services options 查看可复用连接和安装包预设。凭证由用户在自己的终端通过不回显提示录入,再让管理 Agent 继续保存、测试和绑定路由;不要把密钥发到聊天。具体步骤见 CLI 决策模型接入。
2. 连接一个模型
打开“模型 → 通用模型”,选择“添加模型”。你可以接入应用列出的本机订阅,也可以在“高级接入”中选择“自定义 API”。通用模型负责实际执行任务;首次使用先完成这项连接即可。
检查连接后,选择要加入 HiRoute 的模型并保存。页面上的“接入就绪”表示这项连接具备进入路由的必要资料,不等同于每个上游模型都已经完成一次真实推理测试。
3. 创建第一条智能路由
打开“智能路由”,选择“新建智能路由”:
- 填写名称和使用场景,例如“日常开发”和“处理常规代码修改”。
- 按需求选择“固定模型”并添加候选,或直接选择“按难度分流”,配置常规组、主力组和明确的决策方式。
- 选择“启用”。只有已发布并启用的路由会处理新请求。
进一步的设置可按 智能模型路由 配置“按难度分流”“自定义分支”或“免费优先”。需要模型判断和阶段评分时,再到“模型 → 决策模型”添加内置连接,或接入自行部署的自定义扩展。
4. 连接你的 Agent
下面以 Codex 为例。打开“Agent”,选择已发现的 Codex,然后:
- 在“模型路由”中选择“启用”。
- 打开“使用 HiRoute 模型路由”。
- 勾选刚创建的智能路由,并把它设为默认选择。
- 保存配置,按页面提示完成检查。
HiRoute 会保留恢复点。若以后停用模型路由,可以在“连接详情与恢复”中恢复接入前的设置。
5. 发起一次真实请求
按提示加载原生配置并选择模型,再发起已授权、可明确验收的小任务。配置已保存不代表运行中的会话已经切换。请求开始后,在 HiRoute 的“会话”中查看实际路由、模型、用量和执行状态。
接下来
- 使用智能模型路由:配置四种路由类型、决策模型与自定义分支,查看本轮选择、实际执行及后续阶段评价。
- 使用智能任务路由:把适合独立执行的工作委派给执行 Agent。
- Linux 无界面版安装:从空环境安装并用 CLI 配置模型、路由和 Agent。
- HiRoute CLI:从终端管理 HiRoute、查看执行记录、启动任务,以及在连接中断后确认任务是否已提交。