模型与路由

建议先配置能够完成完整工作流的模型来源，再扩展路由。常规 Cloud 场景仅需登录并运行 originrouter agent setup --cloud；自有模型服务、远程设备和分别为每个模型位置配置路由的场景见下方对应章节。

路由用于选择请求使用的模型来源。命令仍在目标 CLI 设备上执行；Cloud、远程设备和本地模型服务的数据处理范围不同，配置前请阅读数据与执行边界。

推荐：OriginRouter Cloud

登录 OriginRouter 账户

originrouter login

完成账户授权后，CLI 才能读取 Cloud 可用模型并写入账户级路由。

初始化 Cloud 路由

originrouter agent setup --cloud

该命令为 Claude 与 Codex 写入当前账户可用的 Cloud 路由。

查看 Cloud 可用模型

originrouter route cloud models

该命令列出当前账户可以使用的 Cloud 模型。需要指定模型时，先从这里确认模型 ID。

查看 Claude 生效路由

originrouter route show claude

该命令显示 Claude 当前两个模型位置（main 和 small）的生效来源和模型。

查看 Codex 生效路由

originrouter route show codex

该命令显示 Codex 当前 main 模型位置的生效来源和模型。

覆盖 Claude 的 Cloud 模型

originrouter route cloud set claude.main --model <model-id>

将 Claude 的 main 模型位置切换到指定 Cloud 模型。

覆盖 Codex 的 Cloud 模型

originrouter route cloud set codex.main --model <model-id>

将 Codex 的 main 模型位置切换到指定 Cloud 模型。

为 Claude 和 Codex 选择模型

Claude 有两个可配置的模型位置：main（主要任务）和 small（较轻量、较快的任务），且二者必须来自同一个模型服务；Codex 只有 main（主要任务）。route show 查看当前真正生效的来源和模型，route list 查看已保存的全部路由条目。通常只需配置 main；未单独配置 small 时，它可以回退到 main。

可选：自有模型服务

开始前

本地路径会替换 Cloud 路由。先完成CLI 概览与安装中的本机运行环境准备，包括 originrouter setup。

配置顺序

显式清理当前智能体路由，再创建模型服务。否则新配置可能与隐式 Cloud 路由冲突。

切换为原生路由配置

originrouter agent setup --native

为本地模型服务路由准备原生配置模式。完成后，请继续配置模型服务和模型位置。

准备模型服务凭据

export ANTHROPIC_API_KEY='替换为实际密钥'

示例使用环境变量保存密钥。生产环境应通过密钥管理系统或受控运行环境注入凭据，避免将密钥写入 Shell 历史或仓库。

创建本地模型服务

originrouter provider add team-anthropic \
  --type proxy \
  --engine litellm \
  --litellm-provider anthropic \
  --api-key os.environ/ANTHROPIC_API_KEY \
  --model claude-sonnet-4-6

该命令创建名为 team-anthropic 的本地模型服务，并通过 os.environ/ANTHROPIC_API_KEY 引用运行时环境中的密钥。保存后可使用 provider show 检查脱敏结果。

将模型服务写入 Claude 路由

originrouter route set claude \
  --provider team-anthropic \
  --main-model claude-sonnet-4-6 \
  --small-model claude-sonnet-4-6

该命令同时设置 Claude 的 main 与 small 两个模型位置。示例只使用一个模型，因此两个位置保持一致。

启动本地 Proxy

originrouter proxy start --port 4000

启动本地 Proxy 后，CLI 才能通过刚配置的模型服务发起模型请求。

检查 Claude 生效路由

originrouter route show claude

确认 main 与 small 两个模型位置均指向预期模型服务和模型。

如需单独配置 small 模型，请先在 App 的“模型服务控制”中添加并打开第二个模型的“本机启用”；只有需要让其他可信设备使用时，才再打开“允许远程”。也可以通过 Local API 完成同样设置，然后执行 route set claude ... --small-model <已启用模型>。

CLI 当前没有单独的 provider model add 顶层命令。

os.environ/NAME 保存的是环境变量名，不是密钥值；启动 Proxy 或服务的同一用户环境必须能读取它。

可选：远程设备

前置条件

目标设备必须在线、运行 Remote Share，并至少共享一个已启用且允许远程使用的模型。

配置顺序

先按远程访问完成服务、设备信任和模型授权，再查询可用设备：

登录并查询远程设备

originrouter login
originrouter route remote devices

login 建立账户会话；route remote devices 列出当前可用于路由的远程设备和模型。记录目标设备 ID 与模型 ID 后，再执行路由设置。

将远程模型写入 Codex 路由

originrouter route remote set codex.main --device <device-id> --model <model-id>

将指定远程设备上的模型写入 Codex 的 main 模型位置。目标设备必须保持在线，并已通过 Remote Share 授权该模型。

检查与恢复

列出本地模型服务

originrouter provider list

确认当前设备已配置的本地模型服务名称。

检查模型服务

originrouter doctor provider <provider-name>

检查指定模型服务的字段和推理能力。

列出全部路由

originrouter route list

查看所有已保存的路由条目。

查看 Claude 生效路由

originrouter route show claude

检查 Claude 当前各模型位置的最终来源和模型。

查看 Codex 生效路由

originrouter route show codex

检查 Codex 当前模型位置的最终来源和模型。

重启 Proxy

originrouter proxy restart

模型服务或路由变更未生效时，重启本地 Proxy，再重新执行模型请求。

provider list/show 主要确认模型服务本身与脱敏字段，不能完整显示每个模型的 enabled、remoteEnabled 状态。模型开关请在 App“模型服务控制”或 Local API 中检查。

如果看到 route model ... is not enabled，先启用该模型。

如果看到 Claude 的两个模型位置使用了不同模型服务，使用上面的成组命令同时重写它们。