HiRoute 是 Higress 团队在云栖大会正式开源、Apache 2.0 协议发布的本地 Agent 智能路由引擎，核心定位是作为现有 AI Agent 的前置调度网关，不用替换 Codex、Claude Code、Hermes、DeepSeek Harness 这些你已经在用的 Agent，它会在每一轮任务里判断当前步骤难度，自动分配给经济型轻量模型或者主力高端模型，还支持任务委派给不同 Worker Agent 协作执行，同时打通订阅账号和 API 密钥混合调度，优先消耗订阅额度、订阅不可用时自动切 API，减少高端订阅额度被简单任务浪费，在保持 Agent 输出质量稳定的前提下降低消耗，让订阅更耐用，支持桌面图形端、CLI 命令行，全部调度、日志、会话数据都在本地运行，不需要第三方中转服务。
一、HiRoute 核心能力清单
- 项目归属：Higress 团队，开源协议 Apache 2.0，核心网关使用 Rust 开发
- 运行形态：本地网关服务，支持 Windows 桌面、Linux、macOS，CLI/Desktop 共用一套内核
- 兼容 Agent：Codex、Claude Code、Qoder、Pi、Hermes、DeepSeek Harness 等主流编程 Agent
- 核心调度：步骤级模型路由、多 Agent 任务委派、失败自动接力切换模型
- 订阅管理：订阅 + API Key 混合接入、额度限额管控、赠金生命周期管理
- 观测能力：每轮路由理由记录、会话回放、模型效果评分、信任度调优
- 网络代理：每一条模型接入通道可以独立配置代理策略
- 部署方式：一键脚本安装、源码编译部署两种方式
二、HiRoute 新旧使用模式对比表
| 项目 | 传统 Agent 直接调用模型 | 接入 HiRoute 之后 |
|---|---|---|
| 模型选择 | 全程固定同一个模型，要么全程贵、要么能力不足 | 分步骤动态切换，简单任务轻量模型，复杂难题主力模型 |
| 订阅消耗 | 普通查询、文档整理等简单任务持续消耗高价订阅 | 优先用订阅，按需调用高端模型，节省订阅额度 |
| 故障处理 | 模型超时 / 限流直接报错中断任务 | 自动切换备选模型接力执行 |
| 多模型管理 | 多个订阅、多个 API Key 需要手动切换配置 | 统一接入面板，统一额度管控、统一路由策略 |
| 数据链路 | Agent 直连模型服务商 | 请求经过本地网关，会话记录保存在本机 |
三、HiRoute 部署与接入实操步骤
- 环境准备：准备好你已有的 Agent、模型订阅账号、对应 API Key，确认网络可访问模型服务。
- 一键安装：执行官方脚本 curl -fsSL https://hiroute.ai/install.sh | sh，也可以从 GitHub 仓库源码编译构建。
- 接入模型：在控制台添加订阅和 API 接入，同名模型自动合并为一组，设置额度上限。
- 配置路由计划：设置决策规则、经济模型、主力模型，调节模型信任度。
- 修改 Agent 配置：把 Agent 里的模型地址指向本地 HiRoute 网关地址，无需改动 Agent 本身的提示词和业务逻辑。
- 开始执行任务：正常下发指令，HiRoute 自动做路由决策，后台查看每一轮的路由理由、消耗、评分。
- 持续调优：根据会话回放结果调整信任度，优化路由策略。
四、适合场景与不适合场景
✅ 适合接入 HiRoute
- 使用 Codex、Claude Code 这类付费订阅型编程 Agent，希望拉长订阅使用时长
- 长流程复杂 Agent 任务，包含检索、整理、编码、调试、评审多阶段工作
- 同时持有多家模型订阅、API 赠金，需要统一调度、管控预算
- 想搭建 Super Agent 多层协作架构，主 Agent 把子任务委派给专门 Worker Agent
- 在意数据链路，希望路由日志、会话记录存储在本地，不上传第三方平台
❌ 不太适合 HiRoute
- 只有单一模型、任务流程很短，步骤几乎没有难度变化
- 完全离线本地大模型，没有云端订阅、API 调用需求
- 纯简单对话类场景，没有长步骤 Agent 任务
五、关键机制说明
- 路由决策逻辑：依靠内置决策模型对每一轮输出结果打分，如果经济型模型结果可信度低，下一轮自动切主力模型；结果合格则继续使用经济型模型。
- 订阅优先策略：同一模型的订阅通道优先级高于 API，订阅额度耗尽、限流、超时才自动切换 API 通道。
- 额度隔离：可以为不同 API 密钥设置周期额度、一次性额度，额度耗尽自动停用该通道。
- 协议适配：原生支持流式输出，兼容主流模型消息协议，同时修复部分服务商缓存 token 重复计费问题。
【相关 FAQ】
问题 1：HiRoute 开源，接入 HiRoute 之后需要换掉原来的 Codex、Claude Code 这些 Agent 吗？
回答 1：HiRoute 是前置路由网关，开源的 HiRoute 不需要替换原有 Agent，Agent 本身保持不变，只需要把 Agent 的请求地址指向本地 HiRoute 网关。
问题 2：HiRoute 开源，HiRoute 延长模型订阅使用寿命的原理是什么？
回答 2：HiRoute 会按每一步任务难度智能分配模型，常规简单步骤交给低成本经济型模型，只在复杂推理、调试等关键步骤消耗高价订阅模型，减少订阅额度浪费，让模型订阅更耐用。
问题 3：HiRoute 开源，HiRoute 的数据和会话日志会上传到外部服务吗？
回答 3：HiRoute 是本地运行的开源引擎，路由决策、会话记录、日志全部保存在本地，作为本地网关转发请求，不会将会话数据上传 HiRoute 的中心化服务。
【参考资料】
[2026-10-22]（HiRoute Is Open Source: Help Your Agents Do More and Your Subscriptions Go Further）Alibaba Cloud Community
[2026-11-06]（Higress 社区 10 月进展｜Higress 为企业加固，HiRoute 为开发者省钱）Higress 官方博客
[2026-11-05]（HiRoute 新版本发布：结合自己的真实工作选择最佳模型）SegmentFault
[2026-10-16]（HiRoute 智能路由实战：GPT-6 Astra × Qwen-3.8 Flash）阿里云云原生
【免责声明】
本文基于 Higress 社区公开文档、云栖大会发布信息整理，HiRoute 为 Apache2.0 开源项目，路由效果、模型兼容、订阅调度逻辑会持续迭代更新；订阅额度、API 计费规则由对应模型服务商决定，HiRoute 仅做转发调度，不改变服务商计费规则；所有部署、路由策略配置请以 HiRoute GitHub 仓库最新文档为准，本文不构成选型与采购建议。