跳转到正文
ThinkWatch
开始输入以搜索文档。
ThinkWatch Lite · 切换上游无需重启

切换中转站、上游或模型,无需重启 Claude Code 与 Codex#

ThinkWatch Lite 只需把 Claude Code、Codex 指向本机网关一次,此后每个请求发往哪个上游、使用哪个模型都由网关决定。切换中转站、上游或模型,改的是应用中的路由规则或手动选择的策略组;网关不重启,从随后的请求起按新的设置转发,客户端无需重启,也无需再改配置文件。

准备#

  • 已安装 ThinkWatch Lite。本文按 2026.10.4 版编写。
  • 已在客户端页用「接管…」接管 Claude Code 或 Codex。Claude Code 下一个请求即使用新配置;Codex 接管后需要重新打开一次终端。客户端一侧的改动到此为止。
  • 上游页中至少有两个上游,例如两个中转站,或一个提供多个模型的上游。

步骤#

用路由规则切换:

  1. 在路由页的「路由」标签中,打开客户端密钥所用的路由;没有其他路由时,就是标有「默认」的那一条。
  2. 在规则列表中,对要修改的规则选择「编辑…」,通常是条件显示为「全部请求(兜底)」的那一条。
  3. 「命中后」保持「转发」,在「转发至」中选择新的上游或策略组。
  4. 同时更换模型时,展开「改写参数」,在「模型改为」中填写模型名。
  5. 在规则对话框中选择「保存」,再在路由对话框中选择「保存」。

用手动选择的策略组切换:

  1. 在路由页的「策略组」标签中选择「新建策略组」,填写「名称」,「策略」选「手动选择」,在「成员」中勾选上游,对其中一个选择「设为优先」,然后选择「创建」。
  2. 按上面的步骤,在规则的「转发至」中选择这个策略组。
  3. 之后切换时,在路由页打开该策略组的操作菜单,在「优先使用」中选择一个成员。macOS 的菜单栏菜单和 Windows、Linux 的托盘菜单中也可以切换:每个手动选择的策略组显示当前使用的上游,子菜单中列出全部成员。

说明#

  • **为什么无需重启。**接管后的客户端配置中只有网关地址和它自己的密钥:Claude Code 是 ~/.claude/settings.json 中的 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN,Codex 是 ~/.codex/config.toml 中名为 thinkwatch 的 provider。上游的地址、密钥和模型都在网关的配置中,由网关就地重新加载。已在进行的请求按它开始时的配置完成。
  • **Codex 的会话列表不会拆开。**Codex 的会话列表只列出当前 provider 的会话。接管期间它始终使用 thinkwatch 这个 provider,因此经网关开始的会话都在同一个列表中,与由哪个上游回答无关。接管之前的会话仍在原来的 provider 下,分开显示;要通过网关继续其中一个,运行 codex resume <会话 ID> -c model_provider=thinkwatch。
  • **进行中的对话。**在策略组中,一段对话在当前这一轮结束之前留在回答它的上游上;跨轮时,只要该上游的提示缓存仍有效,即最近一次回答在五分钟以内、且读写了至少 1,024 个缓存 token,也会留下。手动选择的策略组更换优先使用的上游后,新对话立即改用新上游,进行中的对话可能留在原上游,直到缓存过期或原上游失败。把规则改为转发至另一个上游或策略组,则从下一个请求起对所有对话生效。
  • **模型名。**模型列表中没有所请求模型的上游会被跳过。新上游使用不同的模型名时(例如以 GLM 代替 Claude),在规则上设置「模型改为」。更换模型后已缓存的 prompt 不再命中,费用按发出的模型名计算。
  • **只切换一个客户端。**每个接管的客户端都有自己的密钥。只切换其中一个、其余不变时,用「新建路由」建一条路由,在「使用此路由的密钥」中加入它的密钥。

相关文档:功能详解、在多个中转站和多把密钥之间自动故障转移与负载均衡、安装与更新。

最后更新于 2026-10-04 在 GitHub 上编辑