应用路由

// 路由前
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  }
}

// 路由后
{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:15721"
  }
}

Codex 配置变更：

# 路由前
base_url = "https://api.openai.com/v1"

# 路由后
base_url = "http://127.0.0.1:15721/v1"

Gemini 配置变更：

# 路由前
GOOGLE_GEMINI_BASE_URL=https://generativelanguage.googleapis.com

# 路由后
GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:15721

请求转发

路由收到请求后：

识别请求来源（Claude/Codex/Gemini）
查找该应用当前启用的供应商
将请求转发到供应商的实际端点
记录请求日志
返回响应给应用

路由状态指示

主界面指示

开启路由后，主界面会有以下变化：

路由 Logo 颜色：从无色变为绿色
供应商卡片：当前活跃的供应商显示绿色边框

供应商卡片状态

状态	边框颜色	说明
当前启用	蓝色	配置文件中的供应商（非路由模式）
路由活跃	绿色	路由实际使用的供应商
普通	默认	未使用的供应商

关闭路由

操作步骤

在路由面板中关闭对应应用的路由开关
或直接停止路由服务

配置恢复

关闭路由时，Olenro 会：

将应用配置恢复到路由前的状态
保存当前的请求日志

路由与供应商切换

路由模式下切换供应商

在路由模式下切换供应商：

在主界面点击供应商的「启用」按钮
路由立即使用新供应商转发请求
无需重启 CLI 工具

这是路由模式的一大优势：切换供应商即时生效。

非路由模式下切换

在非路由模式下切换供应商：

修改配置文件
需要重启 CLI 工具才能生效

多应用路由

可以同时路由多个应用，每个应用独立管理：

独立的供应商配置
独立的故障转移队列
独立的请求统计

使用场景

场景一：用量监控

开启路由 + 日志记录，监控 API 使用情况。

场景二：快速切换

开启路由后，切换供应商无需重启 CLI 工具。

场景三：故障转移

开启路由是使用故障转移功能的前提。

注意事项

性能影响

路由会增加少量延迟（通常 < 10ms），对于大多数场景可以忽略。

网络要求

路由模式下，CLI 工具需要能够访问本地路由地址。

配置备份

开启路由前，Olenro 会备份原始配置，关闭时恢复。

常见问题

路由后请求失败

检查：

路由服务是否正常运行
供应商配置是否正确
网络是否正常

关闭路由后配置未恢复

可能原因：

路由异常退出
配置文件被其他程序修改

解决方法：

手动编辑供应商，重新保存
或重新启用再关闭路由

本页内容