跳到主要内容
SynaRoute

桌面软件 · 全部本地运行 · 无需注册账号

多个 Key 互为备份,多个模型协同思考

本机运行的 API 路由代理,为 Claude CLI、Claude 桌面端和 Codex 桌面端统管 Key 与模型:内置 33 家厂商的地址预设,Anthropic Messages / OpenAI Chat / OpenAI Responses 三种协议自动互转。

主 Key 报错自动换下一个,连续失败三次的 Key 停用 60 秒后自动放回;也能让 2~4 个模型并行回答同一个问题,再由决策者综合出结论。

  • Windows
  • macOS
  • Linux

当前版本 v0.1.69

SynaRoute 主界面:Claude CLI 分类下的多个厂商 Key 列表,含优先级排序、健康状态与代理端点

为什么需要它

多 Key 用户每天都在手动做的事,交给一个常驻程序去做。

不用你去切

主 Key 用完了或被封了,同一次请求里就换到下一条,不用你自己发现然后手动去切。

两层:一条 Key 连续失败三次会被停用 60 秒、期间直接跳过,到点自动放回;而某个模型在某条 Key 上不可用时只停那一个模型(按上游真实模型名记,换个别名绕不过去),停用时长从 2 分钟起翻倍、最长 30 分钟。上游自己抖动(限流、5xx)不算这条 Key 的账,限流的重试提示原样透传给客户端而不是被吞掉。

三个客户端分开管

Claude CLI、Claude 桌面端、Codex 桌面端各有独立分类,配置互不干扰。

每个分类有自己的 Key 列表、主 Key、代理端口与模型映射。给 CLI 换 Key 不会动到桌面端。

密钥本地保存

配置与密钥本地保存,不上传 SynaRoute 云端。调用上游时,密钥用于向你配置的厂商端点鉴权。

Windows 默认使用 DPAPI,将密文绑定当前用户账户;macOS 使用系统钥匙串保管随机加密密钥。两者均可切换为主口令模式。Linux 必须先设置主口令,不提供固定密钥回退。主口令模式使用 Argon2id + AES-256-GCM,每次启动需解锁,忘记口令无法恢复密钥。

协议自动转换

客户端说的和厂商听的不是一种协议时,由代理层在中间做转换。

Anthropic Messages、OpenAI Chat Completions、OpenAI Responses 三种协议双向互转,覆盖流式与非流式、工具调用、多轮历史。这也意味着故障转移可以跨协议 —— 主备 Key 不必来自同一家厂商。

特色能力

让多个模型一起想,再由一个模型拍板

同一个问题交给多个模型并行回答,再由你指定的决策模型综合出最终结论。适合代码审查、方案设计、疑难排查这类单个模型容易漏视角的任务。

成员并行回答2~4 个 Key + 模型的组合,同时开跑
汇总压缩汇总省额度,或全量上下文保信息
决策者产出结论必填,建议选能力最强的那个模型
  • 两种汇总策略

    压缩汇总先让汇总模型把各家答案精简,成员多时更省额度;全量上下文把原答案整份交给决策者,信息最全。并发上限与单成员超时都可调。

  • 按需读你的代码

    可开启一组只读工具,让成员自己决定读哪个文件、搜什么关键词、看哪个符号。工具永不写文件、不执行命令,且限制在工作目录内。默认关闭——每轮都要重发完整历史,额度消耗明显更高。

  • 支持传图

    报错截图、界面稿都可以作为输入。最多 4 张、单张不超过 5MB。任何一张不合规会整次报错说明原因,不会静默丢掉某张图让你拿到一个「其实没看图」的答案。

  • 也能当 MCP 工具用

    开启 MCP 服务器后,Codex CLI 与 Claude Code 可以直接调用它。这条通道只返回建议、绝不改你的文件,所有修改仍由你的客户端执行。

大脑聚合配置界面:参与成员列表、最终决策者、聚合策略与并发超时设置

完整能力

从故障转移、协议转换,到用量花费、余额查询与排障响应头 —— 每条都写明它做什么、代价是什么。

模型映射

把厂商的真实模型名,映射成客户端认识的名字。

第三方厂商的模型名往往和客户端期望的对不上。配置一条映射后,客户端仍按熟悉的名字调用,代理层负责翻译成厂商真实模型名。还可以指定一个兜底模型:某条 Key 不提供客户端请求的那个模型时,用兜底模型顶上。

加密密钥存储

密钥加密存于本地;Linux 强制主口令,Windows 与 macOS 可选。

Windows 默认使用 DPAPI,将密文绑定当前用户账户;macOS 使用系统钥匙串保管随机加密密钥。两者均可切换为主口令模式。Linux 必须先设置主口令,不提供固定密钥回退。主口令模式使用 Argon2id + AES-256-GCM,每次启动需解锁,忘记口令无法恢复密钥。

一键接入客户端

点「启动」,自动把代理端点写进客户端配置。

启动代理时自动写入对应客户端的配置文件,停止时自动还原,并在写入前备份原配置。三个客户端各写各的字段,互不覆盖。界面里可以先预览将要写入的内容再决定。

运行日志

每次转发发生了什么,都能查。

记录转发时间、命中哪个 Key、请求的模型被解析成了什么、上游返回什么状态、是否发生了转移。支持搜索与导出诊断报告。记录完整对话正文的开关默认关闭,需要排障时才临时打开。

配置导入导出

整套配置可打包带走,支持合并或覆盖导入。

导出的文件带校验值。因为密钥密文与本机账户绑定、换机器解不出,含密钥的导出会用你设定的口令重新加密。端口、日志目录这类本机运行态不随导出走。

托盘与自启动

常驻托盘,可快速启停代理与切换主 Key。

托盘图标按代理运行状态变化。右键菜单可分别启停三个分类的代理、快速切换主 Key。可选开机自启动,随系统启动时最小化到托盘。

排障响应头

每个回答都带一行可粘贴的路由信息:走了哪条 Key、切了几次。

响应头里带 X-SynaRoute-Decision(key / model / attempts / latency 一行)以及请求 ID、上游状态码、版本号。出问题时不必再猜「刚才那次是走哪条 Key 的」,把这一行贴出来就够了。头里刻意不放地址与密钥 —— 有些中转站把令牌放在 URL 路径里,回显地址等于把密钥回显给客户端。

单模型锁定

某个模型不可用时只挡那一个,不再连坐整条 Key。

中转站最常见的失败是「这条 Key 的某个模型没开通」,对它服务的其它模型完全正常。此前这类失败三次就把整条 Key 停用一分钟,把好模型一起误伤。现在按模型单独退避,锁的是上游真实模型名(锁对外名换个别名就绕过去了)。同一条 Key 上锁了三个模型才升级为整条熔断 —— 否则一条「什么都不通」的 Key 会永远赖在候选池首位。

用量与花费统计

按分类与 Key 统计 token,并按内置单价表估算花费。

内置各厂商在役模型的单价表(含缓存命中价逐厂商不同的那部分),按 Key 估算花费;中转站有折扣时填一个计费倍率即可校准。算不出金额时会说明为什么算不出,而不是显示 0 —— 界面上还标着单价表的核对日期,让你自己判断这个估算值得信几分。

余额查询

直接在 Key 卡片上看中转站还剩多少额度。

认得出的站点零配置就能查(按域名匹配端点,NewAPI 系还会现场读取它自己的计费单位换算比率);认不出的站点会按序探测几个常见端点并把命中的那个记下来。查不到就如实说「这个站点没有余额接口」,不拿配额上限之类的数字冒充余额 —— 那会给出一个你会当真的错数字。

局域网共享

可选让同网段的设备也用这台机器的代理,非本机必须带令牌。

默认只监听本机回环地址。开启后同网段设备也能连,但非本机来源一律要校验接入令牌才放行 —— 令牌在设置页里查看、复制、重新生成,日志与诊断报告里只留前 8 位指纹,避免随手贴出的日志把额度送人。监听同时绑 IPv4 与 IPv6,不会出现「有的机器连得上、有的连不上」。

Codex 模型选择器

让非 GPT 模型出现在 Codex 自己的模型菜单里。

接入 Codex 时会顺带写一份模型目录给它读,于是你配的模型(包括 Claude、GLM 这类非 GPT 的名字)会直接出现在它的模型菜单里,并带上思考强度档位。档位按上游协议推导:只有「思考开关」而没有档位的厂商刻意不声明 —— 声明了在 Codex 里调也不会有任何效果。改完模型列表要重开一次 Codex 才生效。

界面一览

以下截图取自软件的浏览器预览模式,数据为示例数据。点击可放大。

Key 管理卡片式列表,可拖动优先级、切换启用状态、查看健康探测结果与代理端点。
大脑聚合配置并行解答的成员、决策模型与汇总方式。
运行日志每次转发的命中 Key、模型解析结果与上游状态,可搜索、可展开细节。
设置主题、语言、端口、日志与安全相关开关,每个开关都写明了代价。
厂商管理维护常用厂商的地址与协议类型,新增 Key 时直接选用。

下载

免费使用,无需注册账号。

Windows

exe · NSIS 安装包

版本
v0.1.69
系统要求
Windows 10 (1809) / Windows 11
大小
6.7 MB

macOS

dmg

版本
v0.1.69
系统要求
macOS 11+(Apple 芯片 / Intel)
大小
9.5 MB

其它架构 / 格式:Intel(9.9 MB)

推荐给你

Linux

AppImage

版本
v0.1.69
系统要求
glibc 2.31+(Ubuntu 20.04+ / Debian 11+ 等)
大小
85.4 MB

其它架构 / 格式:deb(11.7 MB)rpm(11.7 MB)

三步开始使用

不用读完整份文档也能跑起来。

  1. 1

    下载并安装

    下载安装包,按向导完成安装。首次启动会自动创建本地配置目录。

  2. 2

    添加厂商 Key

    Linux 用户先在「设置 → 安全」启用主口令。选择客户端分类,新增 Key 并填入厂商地址与密钥,保存时会拉取可用模型列表。

  3. 3

    点「启动」

    启动本地代理,SynaRoute 会自动把代理端点写入对应客户端的配置文件(写入前先备份原文件)。

照常使用就行

回到 Claude Code 或 Codex 正常使用。请求经由本地代理转发,Key 出问题时自动接力到下一条,代理记账并提供排障响应头与日志。

Claude Code CLI 最低版本要求

CLI 需要 2.1.245 或更新版本才能让代理接管模型发现。老版本仍能连上代理,但会在选模型时报错。更新 CLI 只需在任意目录跑 npx @anthropic-ai/claude@latest,它会自己覆盖掉旧版本;可以用 claude --version 查看当前版本。

数据与隐私

以下都是软件的实际行为,可以对照源码核对。

数据存在哪里

配置 config.json 与密钥库 secrets.enc 位于用户应用数据目录的 SynaRoute 文件夹:Windows 通常为 %APPDATA%\SynaRoute,macOS 为 ~/Library/Application Support/SynaRoute,Linux 为 $XDG_DATA_HOME/SynaRoute(未设置时为 ~/.local/share/SynaRoute)。日志可能位于其他目录,请在设置中确认实际路径。

密钥如何保存

Windows 默认使用 DPAPI,将密文绑定当前用户账户;macOS 使用系统钥匙串保管随机加密密钥。两者均可切换为主口令模式。Linux 必须先设置主口令,不提供固定密钥回退。主口令模式使用 Argon2id + AES-256-GCM,每次启动需解锁,忘记口令无法恢复密钥。

会往外发什么

只有你自己配置的上游厂商请求,以及检查新版本时对 GitHub 发布页的请求。不收集使用数据,不做行为统计,没有账号体系,也不做配置同步。

关于日志

默认日志仅记录元信息;开启「记录调用模型日志」后会包含对话正文与系统提示词,仅建议临时排障使用。Windows/Linux 优先写入可执行文件同级 logs,不可写时回退应用数据目录的 SynaRoute/logs;macOS 默认 ~/Library/Logs/SynaRoute。支持自定义日志目录,以设置页显示的路径为准。

如何彻底删除数据

卸载前先停止代理并恢复客户端配置,在设置中记下应用数据目录与日志目录,然后退出应用。删除 SynaRoute 应用数据文件夹(含配置、密钥库及备份),另行删除实际日志目录及曾使用的自定义日志目录。自行导出的配置、诊断报告及客户端配置备份也需按保存位置单独清理;只删除应用数据目录并不保证清理完整。

源码

源码公开在 GitHub,上述行为都可以自行核对。请注意本项目目前尚未附带开源许可证。

需要你注意的风险

本地代理监听在回环地址上,同一台机器上的其他程序理论上可以访问该端点。请不要把代理端口暴露到公网。另外,DPAPI 加密防的是文件被复制走,不防已经登录了你账户的程序。

常见问题

下面十条是最常被问到的。答案都对应软件的实际行为。

让多个 Key 互为备份,让多个模型一起想

免费使用,全部本地运行,不需要注册账号。