切换路由状态失败:{{detail}} - cc-switch

Quick fix

升级到 v3.16.2 或更新版本，路由面板会显示真实错误详情。

Symptom

报错原文复制

切换路由状态失败:{{detail}}

Cause

在 cc-switch v3.16.2 之前，路由面板（ProxyPanel）切换 Claude Code 路由失败时，没有把后端返回的错误详情传给提示文案，导致 i18n 文案 “切换路由状态失败: {{detail}}” 中的 {{detail}} 占位符没有被替换，直接以字面量显示。主界面的路由开关走的是另一条已正确传值的代码路径，因此会显示例如 “切换路由状态失败: Claude 配置文件不存在” 的真实原因。

该问题已在 v3.16.2 修复（#3656，commit ce538265）。修复后两处都会注入真实的后端错误详情，提示保持一致。如果用户本地没有 .claude 文件夹或 Claude 配置文件不存在，升级后应能看到具体原因而不是 {{detail}}。

Fix

1. 1

   确认当前 cc-switch 版本低于 v3.16.2，并复现路由面板中的 “切换路由状态失败:{{detail}}” 提示。

2. 2

   升级 cc-switch 到 v3.16.2 或更新版本。

3. 3

   重新在路由面板中切换 Claude Code 路由，确认提示变为真实错误详情，例如 “切换路由状态失败: Claude 配置文件不存在”。

4. 4

   如果提示显示 Claude 配置文件不存在，检查本地用户目录是否存在 Claude Code 所需的 .claude 配置目录或配置文件；若不存在，先正常初始化或配置 Claude Code 后再切换路由。

Affected Versions

Toolcc-switch

Version< 3.16.2（v3.16.2 修复）

PlatformsWindows

Source Issues

本页汇总自 1 个真实 issue

• #2818切换路由状态失败，提示不一致

FAQ

为什么主界面的路由开关提示正常，路由面板却显示 {{detail}}？

因为两处使用了不同代码路径。路由面板没有把后端错误详情传入提示文案，导致 {{detail}} 占位符原样显示；主界面路径已经正确传值。

升级到哪个版本可以修复？

升级到 v3.16.2 或更新版本。维护者确认该问题在 v3.16.2 通过 #3656 修复。

看到 “Claude 配置文件不存在” 后该怎么办？

这表示后端真实错误是 Claude Code 配置文件不存在。需要先确保本地存在 Claude Code 的配置目录或配置文件，再重新切换路由。

相关问题

codex cli 失败：CC Switch将 cc-switch 升级至 v3.16.3 或更高版本即可修复本地环境检测与升级链路的阻塞问题。2 issues mergedcc-switch 配置不生效 / 切换后未应用 - Claude Code先确认目标应用实际读取的配置路径与 cc-switch 写入路径一致，再检查路由/插件开关、重复键和版本兼容性。28 issues merged报.codex下的cc-switch.db出错，然后启动cc-switch失败关闭程序，手动清理 cc-switch.db 中 base_url 为空的残留记录，或直接删除该数据库文件后重启。1 issues merged