Freemodel Auto Router

Freemodel Auto Router

Freemodel Auto Router 是一个 Tauri 桌面应用，会在本机启动 OpenAI / Anthropic 兼容代理，把 Claude Code、Hermes、OpenClaw 等客户端的请求转发到队列中的模型供应商。当前供应商不可用、限流或返回 5xx 时，应用会按队列自动重试和切换，减少手动改 Key、改 base URL、改模型名的频率。

核心亮点

- OpenCode Go 订阅转 Claude Code 协议：通过 Anthropic ↔ OpenAI 请求/响应转换，将 OpenCode Go 等 OpenAI 协议的订阅服务代理为 Claude Code 兼容的 Anthropic 协议，让你可以直接在 Claude Code 中使用 OpenCode Go 的模型。
- 使用你指定的模型：不同服务商提供了多个免费模型，大部分情况下，我们只想使用优秀的模型，这个应用可以把不同服务商的模型聚合到一个队列里，只使用你选择的模型。
- 额度耗尽自动路由：当一个模型触发限流、额度耗尽或上游故障时，代理会按队列自动重试并切换到下一个可用模型，而不需要你手动干预。

主要功能

- Anthropic ↔ OpenAI 协议转换：支持将 Anthropic Messages API 请求转换为 OpenAI Chat Completions 格式，并将响应转换回 Anthropic 格式，实现跨协议代理（如 OpenCode Go 订阅转 Claude Code 协议）。
- 多供应商路由：内置 OpenRouter、ModelScope、LongCat、SiliconFlow、SenseNova、Vercel AI Gateway、OpenCode Go 等供应商，并支持添加自定义供应商，便于筛选和组合更值得使用的免费模型。
- 多队列管理：可以创建多个模型队列，拖拽调整优先级，设置默认队列。
- 自动重试和切换：遇到 429、500、502、503、504 或上游请求错误时，先按配置重试，超过次数后切到队列里的下一个可用模型。
- OpenAI / Anthropic 双协议：供应商可分别配置 openai_url 和 anthropic_url，代理会根据访问前缀选择上游端点。
- 模型名自动改写：客户端传入的 model 会被替换为当前队列项指定的模型 ID。
- API Key 独立管理：Key 存在本机 auth.json，和可同步的路由配置分离。
- 客户端配置注入：支持在应用顶部开关中为 Claude Code、Hermes、OpenClaw 写入代理配置；Codex 注入后端已实现，当前 UI 暂时标记为开发中。
- 安装检测：自动检测 Claude Code、Hermes、OpenClaw 是否已安装，未安装时禁用对应开关。
- 代理日志：展示请求状态、供应商、模型、输入/输出 token、耗时、请求头和响应头，并自动脱敏敏感字段。
- 连接测试：可对已配置 Key 的供应商发起测试请求，查看连通性和延迟。
- 供应商配置同步：启动后会从线上地址检查预设供应商配置更新；本地自定义供应商和自定义模型单独保存。
- 版本检查：设置页可检查 GitHub Release 是否有新版本。
- 系统托盘：关闭窗口时隐藏到托盘，点击托盘图标可恢复窗口。

使用流程

1. 启动应用。
2. 在「服务商」页为供应商填写 API Key，或添加自定义供应商和模型。
3. 新建或编辑队列，把要使用的模型加入队列并拖拽排序。
4. 将需要日常使用的队列设为默认队列。
5. 在右上角打开目标客户端开关，例如 Claude Code、Hermes 或 OpenClaw。
6. 正常使用客户端。请求会进入本机代理，并按当前队列转发到上游供应商。

队列里的当前可用项由后端维护。某个模型连续失败超过 max_retries 后会被标记为耗尽，代理会切换到同一队列里的下一个可用项；所有项都耗尽后返回错误。编辑队列会重置该队列的运行状态。

macOS 文件损坏提示

如果 macOS 提示“Freemodel Auto Router…