Skip to content

[Bug] Claude Desktop 从直连切换模型映射时循环校验:保存映射需先路由,开启路由又要求已有映射 #8441

Closed

Description

@ix-prism

Self Checks / 自检

CC Switch Version / 版本号

4.0.14(Windows 安装程序文件版本与产品版本均为 4.0.14)

Operating System / 操作系统

Windows 11 专业版,10.0.26300,64 位

Related App / 涉及应用

Claude Desktop(Windows Store 包版本 2.37337.1.0)

Steps to Reproduce / 重现步骤

前置状态:Claude Desktop 处于直连模式,当前正在使用供应商 A;A 的接入方式为直连,尚未配置模型路由映射。

  1. 编辑当前正在使用的供应商 A,将「接入方式」改为「模型映射」,填写至少一档实际请求模型后保存。
  2. 保存失败,提示当前供应商必须经过本地路由,要求先切换 Claude Desktop 到路由模式。
  3. 返回 Claude Desktop 供应商页,进入「路由」→「开始路由」,在「路由到」中选择同一个供应商 A。
  4. 开始路由失败,提示至少需要一个模型路由映射。
  5. 回到第 1 步,仍然不能保存,形成循环:保存映射需要先开启路由,开启路由又要求已有映射。

本机故障时读取到的持久化状态为:

{
  "claudeDesktopMode": "direct"
}

meta.claudeDesktopModelRoutes 不存在。这里只摘录与问题相关的字段。

Expected Behavior / 期望行为

用户应能从当前供应商的直连配置,直接完成模型映射配置及路由启用,不需要借用另一个预先配置好的供应商。

例如,在保存映射时引导用户确认切换路由,并将待保存的供应商配置与模式切换一起提交;或者允许先保存映射草稿,再用该草稿启动路由。失败时应保留原配置和编辑内容。

Actual Behavior / 实际行为

保存映射时报:

更新供应商失败:这个供应商要经本地路由才能用(模型映射或托管账号),请先把 Claude Desktop 切到路由模式

This provider only works through local routing (model mapping or a managed account); switch Claude Desktop to the routing mode first

开始路由时报:

Claude Desktop 本地路由模式至少需要一个模型路由映射

Claude Desktop proxy mode requires at least one model route mapping

两条操作分别要求另一个操作已完成,无法在原供应商上按提示继续。

Additional Context / 补充信息

已在本机验证的绕过方法

  1. 在「开始路由」对话框的「路由到」中,临时选择另一家已经有模型映射的供应商 B。
  2. 成功进入路由模式。
  3. 编辑供应商 A,添加模型映射并保存;此时保存成功。
  4. 将路由切回供应商 A。

完成后,本机确认 A 的 claudeDesktopMode 已为 proxy,模型映射已持久化,本地路由端口已监听。这只验证了配置流程恢复;上游模型服务是否可用是另一件事。

v4.0.14 源码定位

这两处检查与现场的循环提示一致。未修改源码,也未运行源码测试;以上为 Windows 4.0.14 的现场行为、状态检查及对应版本源码核对。

#3436 讨论的是路由关闭时切换供应商的自动引导;本报告关注的是编辑当前直连供应商时,首次保存映射与首次启动路由互相阻挡的具体配置流程问题。

Activity

  1. farion1231 commented on Oct 17, 2026

    @farion1231
    Owner

    感谢这么详细的报告和源码定位!两处校验互相阻挡的情况我们已经确认,正在分析该怎么调整这个流程(保存映射时引导进入路由,还是允许先保存再开始路由)。有进展会在这里更新。

  2. added a commit that references this issue on Oct 17, 2026
    7344cc3
  3. farion1231 commented on Oct 17, 2026

    @farion1231
    Owner

    已随 v4.0.15 发布:没填模型列表的原生供应商可以先进入路由,再在同一张卡上保存映射。感谢你的修复(#8444)。

    发布说明:https://github.com/farion1231/cc-switch/releases/tag/v4.0.15

  4. added a commit that references this issue on Oct 23, 2026
    766f146
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions