cc-switch 报错排查手册

非官方社区排障 wiki。把 cc-switch 公开 GitHub issues 里散落的解法，整理成一页一个问题的结构化文档——每页固定按 Symptom / Cause / Fix 展开，并逐条链回源 issue。

361 个主题页 · 汇总自 1728 个真实 issue这些数字怎么算的

把报错原文粘进来搜索…⌘K

高频问题

CC Switch local proxy failed while handling43切换供应商后 Codex config.toml 配置丢失40502 Bad Gateway Codex 代理接管覆盖 config.toml29cc-switch 配置不生效 / 切换后未应用 - Claude Code28cc-switch 本地代理常见问题：502 Bad Gateway、超时、无法删除配置26cc-switch 导入/云同步失败：外键、只读数据库与覆盖问题25Codex API key被自动修改导致model xxx not found24CC Switch 配置导入/同步不生效23

按报错码查状态码、error code、异常名——把报错原文里的关键片段拿来对照66 组报错码按供应商查DeepSeek、GLM、Kimi、通义千问、Copilot 等接入时的配置问题15 家供应商安装与启动装不上、打不开、更新完出问题、终端找不到命令129 个主题页