报错索引
把报错原文里的关键片段（状态码、error code、异常名）拿来对照。 每个主题页都合并了多条重复 issue，卡片上的计数就是合并了多少条。
361 个主题页，汇总自 1728 个真实 issue口径说明
40013
Codex DeepSeek HTTP 400 报错升级到 v3.18.0 修复工具 schema 400；多轮 tool_call_id 与 Responses 原生模式问题需按场景处理。Codex 接 Kimi 报 HTTP 400 tool schema 校验失败升级 cc-switch 到 v3.18.0+；若仍报错需等待 MFJS schema 清洗功能上线。Invalid schema for function升级 cc-switch 至 v3.18.0+，修复 Codex 工具参数缺失 type: object 导致的上游 400 报错。400 content[].thinking must be passed back升级 cc-switch 至 v3.15.0 及以上版本以修复思考块丢失问题，或降级 Claude Code 并改用 DeepSeek 原生 Anthropic 接口。Function call is missing使用社区补丁 cc-switch-gemini-fixer 或在历史消息中注入 skip_thought_signature_validator 以绕过 Gemini 工具调用的签名验证。API Error: 400 invalid_parameter_error检查 base url 与模型配置，开启整流器，或忽略 Stream Check 的 400 误报。HTTP 400 unknown model 'ark-code-latest'在 CC Switch 中将 MiniMax 供应商的模型 ID 从火山方舟专用的 ark-code-latest 更改为 MiniMax-M3 即可解决此 400 报错。Range of input length should be [1, 1048576]升级 CC Switch 至 v3.19.0 以修复图片被当作 base64 文本转发导致的 token 膨胀问题，或避免在代理下使用 view_image。missing field content HTTP 400 - Codex将 CC Switch 转换层中 content:null 替换为空字符串即可解决严格上游拒绝请求的问题。HTTP 400 Invalid JSON /responses将 Codex 提供商的 meta.apiFormat 改为 openai_responses 以直通转发请求。API 返回 400 错误 - Claude Code升级 CC Switch 至 v3.16.1 修复 MiMo 模型缺失 reasoning_content 导致的 400 错误；若为 Github Copilot 供应商，请检查 API 格式与代理配置。HTTP 400 maximum context length Codex升级 cc-switch 以修复 auto_compact_token_limit 缺失问题，或手动修改 model catalog json 配置上下文窗口限制。正文内容频繁出现在 thinking（思考）块内，visible text 块几乎为空升级 cc-switch 至包含 PR #4210 的版本，将预注入 thinking 占位符改为反应式处理即可解决长上下文会话冻结与正文折叠问题。
anthropic_base_url10
ANTHROPIC_BASE_URL 被改成 127.0.0.1开启本地路由时 ANTHROPIC_BASE_URL 指向 http://127.0.0.1:15721 是预期；把插件等公共字段移进「通用配置」，切换后重启 Claude Code 生效。settings.json被全量重写导致插件失效多数相关 issue 仍未解决；升级至v3.20.1+，该版本已修复切换配置时清空enabledPlugins等字段的Bug。kimi k2 报错 404 CC Switch连接测试返回 404 不代表 Kimi 不可用；将 ANTHROPIC_BASE_URL 设为 https://api.kimi.com/coding/ 后直接运行 Claude Code 验证。Not logged in, please run /login在 ~/.claude.json 添加 hasCompletedOnboarding: true，并在 /config 中开启 use custom Api key。DeepSeek前缀缓存命中率骤降 - CC Switch修复升级至 cc-switch v3.16.3 以修复格式转换导致的缓存命中率计算错误。Missing API key · Run /login - Claude Code清除冲突的 ANTHROPIC_BASE_URL 环境变量，或升级 CC Switch 使用内置的环境变量冲突检测功能。"Not logged in ? Please run /login" Claude使用 Copilot 或 Codex 等托管账户时，必须在 cc-switch 中开启“API代理接管”，否则直连上游地址会导致认证失败或模型无权限报错。There's an issue with the selected model去掉 ANTHROPIC_BASE_URL 末尾的 /v1，通过命令行而非 cc-switch 按钮启动以使用本地路由，并检查模型是否支持多模态或 thinking 参数。Not logged in · Please run /login使用 Codex 供应商时，请勿通过 cc-switch 内置终端启动 Claude Code，应手动打开全局终端运行以通过本地路由接管 OAuth 认证。There's an issue with the selected model开启本地代理与整流器，并正确设置 ANTHROPIC_BASE_URL 以解决 NVIDIA 或 MiniMax 模型调用失败问题。
anthropic_auth_token6
ANTHROPIC_AUTH_TOKEN and ANTHROPIC_API_KEY执行 `claude daemon stop --any` 停止残留 Claude 后台进程，然后确保 `~/.claude/settings.json` 的 `env` 中只保留一种认证变量。Auth conflict退出 Claude 官方登录、清理冲突的 ANTHROPIC_* 环境变量，并将 ~/.claude.json 的 hasCompletedOnboarding 设为 true 后重启终端。Auth conflict删除 claude.json 中的 primaryApiKey，或将环境变量改为 ANTHROPIC_API_KEY 以解决认证冲突。ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY打开 `~/.claude/settings.json`，删除重复的 auth 环境变量，只保留当前供应商需要的 `ANTHROPIC_AUTH_TOKEN` 或 `ANTHROPIC_API_KEY`，保存后重启 Claude Code。The user sent an empty message.将 cc-switch 中 Kimi 的 API 格式改为 OpenAI chat completions 并开启代理，或导出历史记录重建会话以跳出空消息循环。http://127.0.0.1:15721 代理配置卡死升级到 CC Switch v3.16.2 修复备份损坏导致的代理卡死，或改用“替换配置”模式手动写入环境变量。
openai_api_key6
auth.json 的 OPENAI_API_KEY 未同步更新 - Codex升级 cc-switch 至 v3.20.1，切换 Codex 供应商时不再覆写 auth.json，彻底解决 key 残留问题。Codex 供应商 API Key 重启或切换后互相覆盖开启 CC Switch 本地代理接管模式，或在 config.toml 使用 experimental_bearer_token 绕过 auth.json 同步缺陷。无法使用谷歌邮箱登录的codex账号 - Codex升级 cc-switch 至 v3.16.1+，或手动修改 ~/.codex/auth.json 恢复 auth_mode 为 chatgpt 并清空 OPENAI_API_KEY。重启后.claude下的auth.json会被强制替换 - Codex升级 cc-switch 至最新版，或在登录官方账号前先关闭代理接管，避免旧快照覆盖官方凭据。Missing environment variable在 config.toml 中删除 env_key 配置项，或手动在 Windows 环境变量中设置 OPENAI_API_KEY，并确保供应商接口支持原生 response 格式。auth.json 不会随渠道改变而改变，在编辑时覆写第三方渠道的密钥 Codex暂无官方修复；编辑已保存的 Codex 第三方渠道会让 auth.json 里的官方 KEY 覆盖第三方密钥，建议删除重建渠道。
4044
404 Not FoundDeepSeek 不支持 Responses API，请使用内置预设走 Chat Completions 路由；若因图片报错需修改模型目录移除 image 模态。Not found (404)升级 cc-switch 至 v3.16.3 以修复智谱 GLM 等 Base URL 被错误拼接 /v1/ 导致的 404 报错，并开启媒体回退防止图片请求触发全局熔断。API Error: 404 Claude Code 路径拼接或未注册路由检查 API 地址是否被错误拼接，或升级 cc-switch 以修复 OpenAI 兼容模式及本地路由缺失导致的 404 问题。上游 HTTP 404 cc-switch升级 cc-switch 移除 NVIDIA 请求的 ?beta=true 参数；Kimi 不支持 Codex 的 Responses API，需改用 Claude Code 或本地转换。
anthropic_model4
"There's an issue with the selected model"升级 cc-switch 至 v3.13.0+ 修复环境变量同步问题，并使用别名映射变量覆盖默认模型。DeepSeek 勾选 1M 不生效？cc-switch 本地代理配置开启 cc-switch 本地代理时不要填 [1m]，主模型留空；未开代理才可用 [1m] 后缀。我用魔搭是报错 401 token 失效 - Claude Code在 cc-switch 的 Provider 环境变量中添加 ANTHROPIC_MODEL 即可解决 401 报错。该变量不会同步到 settings.json，此为正常设计。settings.json 的 env 属性不生效 - Claude CodeClaude Code 仅在启动时读取 settings.json，切换节点后需重启 Claude Code 或手动在终端设置环境变量。
4013
HTTP 401 Unauthorized - CC Switch Anthropic升级 cc-switch 至修复版，以支持 Anthropic 所需的 x-api-key 和 anthropic-version 请求头。HTTP 401 超出256K上下文限制 - CC Switch & Codex在 Codex 的 config.toml 中调低 AUTO COMPACT 触发阈值，避免请求体实际 Token 数超过上游 Kimi 的 256K 限制。unexpected status 401 Unauthorized - Codex手动修改 Codex 的 config.toml，添加 model_provider 声明及对应的 provider 配置段，或升级 cc-switch 至最新版。
anthropic_api_key3
"Not logged in · Please run /login" Claude升级 cc-switch 至 v3.19.2+，或手动将 settings.json 中的 ANTHROPIC_API_KEY 改为 ANTHROPIC_AUTH_TOKEN 以跳过审批弹窗。测试报504：Claude Code无法使用检查 cc-switch 是否已把 `glm-4.7` 模型映射读入代理；否则 Claude Code 会直接请求 glm 模型并返回 504。claude.ai connectors are disabled取消设置 `ANTHROPIC_API_KEY` 环境变量，以恢复 claude.ai 登录和组织连接器的加载。
4032
5022
ark_api_key2
claude_code_attribution_header2
codex_sqlite_home2
webkit_disable_compositing_mode2
webkit_disable_dmabuf_renderer2
4291
anthropic_custom_headers1
anthropic_default_haiku_model1
anthropic_default_opus_model1
anthropic_default_sonnet_model1
authentication_error1
autherror1
claude_code_auto_compact_window1
claude_code_effort_level1
claude_code_max_context_tokens1
claude_code_use_bedrock1
claude_config_dir1
codex_home1
deepseek_api_key1
disable_autoupdater1
drm_ioctl_mode_create_dumb1
egl_bad_parameter1
enoent1
err_bad_request1
gemini_api_key1
gtk_is_widget1
hermes_home1
home_url1
invalid_argument1
invalid_authentication_error1
model_not_supported1
node_repl_native_pipe_connect_timeout_ms1
proxy_managed1
rate_limit_error1
response.created1
responses_feature_not_supported1
skill_dir_not_found1
win-error-1831
win-error-25031
win-error-4001
代理与本地路由92
CC Switch local proxy failed while handling升级 CC Switch 到最新版并重开 Codex 对话；旧会话历史中残留的非法 schema 或图片块会持续触发 400。502 Bad Gateway Codex 代理接管覆盖 config.toml关闭全局代理改规则模式直连127.0.0.1，或升级cc-switch避免全量覆盖config.toml。cc-switch 配置不生效 / 切换后未应用 - Claude Code先确认目标应用实际读取的配置路径与 cc-switch 写入路径一致，再检查路由/插件开关、重复键和版本兼容性。cc-switch 本地代理常见问题：502 Bad Gateway、超时、无法删除配置代理相关问题多由官方供应商不被支持、配置未生效或 UI 状态不同步引起；需按场景检查代理模式、供应商类型与接管状态。Codex API key被自动修改导致model xxx not found升级至v3.19.2+，修复了多供应商共用地址时API Key因读取auth.json而错误收敛的问题。CC Switch 开启代理后 Claude Code 报错或模型映射失败先升级到 v3.15.0 以上，再在 cc-switch 中显式配置全局出站代理，避免系统代理被旧进程缓存。通用配置勾选会不生效，还会被之前的配置覆盖 Codex CC Switch升级到 CC Switch v3.17.0 及以上可修复 Codex 通用配置合并失效；若仍被旧快照覆盖，先切到其他供应商再切回以触发自愈。cc-switch 启动闪退 / 白屏 / 黑屏 / 后台崩溃升级到最新版；Windows 白屏安装 WebView2，代理崩溃改端口并升级 v3.9.1+，旧 macOS/Linux 用 CLI 或对应发行版包。cc-switch 配置用量查询失败 / 用量查询一直显示失败 / undefined升级到 v3.16.2+；仍失败时按 NewAPI 格式填写 base_url 和访问令牌，或关闭自动刷新/用量查询。cc-switch DeepSeek 用量统计不准/余额查询失败升级到 v3.19.2 并重建 Codex 用量；余额查询需正确填写 {{apiKey}} 或代理。settings.json 被代理接管覆盖导致插件配置丢失 - Claude Code将 hooks、statusLine 等自定义字段放入「通用配置」面板，或升级至 v3.12.2+ 以修复旧版备份恢复逻辑。content[].thinking must be passed back升级 cc-switch 到 v3.16.0 或更高版本；临时可回退 Claude Code 到 2.1.150 或关闭 thinking。<!-- Failed to upload "image.png" -->截图上传失败不影响问题本身，请直接用文字描述报错信息。开启本地代理后 Codex 报错在 CC Switch 的 Codex 供应商请求地址末尾补上 `/v1`，保存后重试即可。Not logged in · Run /login - Claude Code开启 CC Switch 本地代理接管，检查 API 地址是否包含 /v1，或通过 CC Switch 启动终端以注入环境变量。api failed deserialize json body into按错误类型回退 Claude Code、升级 cc-switch、关闭本地代理或停止发送不支持的字段。missing information 信息缺失 cc-switch这是文档信息缺失类问题的汇总，需按具体场景补充说明或等待官方文档完善。unexpected status 502 Bad Gateway Codex在代理软件中将 127.0.0.1 设为直连，或在 Codex 环境变量中配置 NO_PROXY 以绕过本地代理拦截。Connection failed多数相关 issue 仍未解决；升级至 v3.16.3+ 修复 SSL 重协商 Bug，或重启应用以刷新代理状态。Failed to parse Hermes config升级 cc-switch 至 v3.16.3+ 以修复 CRLF 换行导致的配置追加 bug，或手动删除 config.yaml 中的重复键。Unknown name "prompt_cache_key" cc-switch升级 cc-switch 至 v3.16.2+ 修复 prompt_cache_key 注入问题，或改用 OpenRouter 原生 Claude Code 格式端点以规避兼容性报错。x-anthropic-billing-header 导致缓存失效 CC Switch升级 CC Switch 至 v3.15.0+，修复 openai_responses 模式下动态 billing header 破坏前缀缓存的问题。bash: 无法设定终端进程组 cc-switch这是 3.18.0 在 Linux 下检查本地代理环境的已知 Bug，降级到 3.18.0 之前的版本，并直接在终端手动配置代理。ChatGPT无法认证, 全局代理已经开了升级 cc-switch 至 v3.16.4+，并在「设置-路由-全局出站代理」中配置代理地址，修复 OAuth 认证不走代理的问题。Codex 用量统计偏高：fork/resume 会话重复统计父历史 token升级 cc-switch 至 v3.18.0+ 并重建用量数据库，可修复 fork 会话重复统计父历史 token 问题。结果显示用了16亿，用量统计飙升 Codex升级 cc-switch 至 v3.18.0 修复子代理历史重放双计 bug，系统会自动重建被污染的 Codex 用量数据。选择了代理转发到远程，但还是给本地进行转发彻底删除 .cc-switch 配置目录以清除缓存，并升级至 v3.17.0 修复代理限制与统计 Bug。[SRV-006] connection error升级 cc-switch 至 v3.16.4，修复了自定义 provider 接入 DeepSeek 时代理转发断连及历史计费错误回退到请求模型的问题。temporarily unavailable, so auto mode cannot升级 cc-switch 至 v3.15.0+ 以修复模型映射与 thinking 转换，或在通用配置中手动覆盖默认模型环境变量以匹配第三方后端。升级了3.15版本就完全看不到剩余额度了 cc-switch升级 cc-switch 到 3.16.0 修复用量不显示；若遇磁盘/CPU/GPU占用高，请关闭本地代理或路由总开关。Warmup request downgraded to model在 CC Switch 中关闭 Copilot 的 warmupDowngrade 选项，防止请求被静默替换为 gpt-5-mini。Claude Official 检查出错: 提取 base_url 失败 - CodexCC Switch 代理与负载均衡不支持 Claude 官方订阅，请改用第三方 API Key。强行代理会因缺少 base_url 报错并导致封号。缺少 supports_reasoning_summaries 字段 Codex升级 cc-switch 至 v3.18.0 及以上版本，修复生成模型目录时缺失必需字段导致 Codex 启动失败的问题。Error running remote compact task在 Codex 设置中关闭远程上下文压缩（Remote Compaction），改用本地压缩即可临时绕过此协议转换缺陷。deepseek 检查失败: Not found (404)接口地址不存在 CodexCodex 需 Responses API 而 DeepSeek 仅支持 Chat API，需使用第三方代理进行协议转换。界面显示「查询失败」升级至 v3.16.2 以上修复查询路由，或使用自定义模板配置余额查询接口；将 hooks 写入通用配置防丢失，并调大故障转移超时阈值防覆盖。Invalid schema for function Codex 报错升级 cc-switch 修复工具 Schema 转换缺陷；若上游严格拒绝 oneOf，暂用历史任务或更换模型。Invalid type for 'messages'升级 cc-switch 至最新版修复转换 Bug，或降级 Codex CLI 至 0.80.0 并改用 wire_api="chat" 绕过。invalid type: sequence备份并删除旧的 config.toml，让 Codex 重新生成默认配置以修复 hooks 格式不兼容问题。Request body format invalid 报错 Claude Code升级 cc-switch 并开启 Rectifier 整流器，或添加环境变量 MAX_THINKING_TOKENS=0 以兼容第三方 API 格式。selected model (kimi-k2.5) may not exist 报错删除 API 地址末尾的 /v1，改用 Anthropic 兼容接口；若旧会话含图片请使用 /compact 压缩上下文或更换模型。unexpected status 404 Not Found升级 cc-switch 到 v3.16.4+，并在 Codex 供应商表单把上游格式显式设为 Chat Completions。Unsupported content type: redacted_thinking运行 openrouter-proxy 等本地代理过滤 redacted_thinking 数据块，并修改 Claude Code 配置文件将 API 指向该代理。查询用量必须同源请求 cc-switch在 cc-switch 中改用通用模板或自定义模板，并在请求地址中直接填写查询用量的 URL，即可绕过同源限制。Claude Code 配置后无法调用模型先确认 cc-switch 只是改写配置；检查跳过初次安装确认、代理/区域限制与上游 API 兼容性。API Error: 400 无效的请求: Claude Desktop 模型路由未配置升级 cc-switch 至 v3.16.0+，并在供应商表单中显式配置 Haiku 和 Opus 等子任务模型的路由规则。配置错误: Claude Provider 缺少 base_url 配置关闭 cc-switch 的本地代理接管功能，在终端重新执行 /logout 和 /login，或升级至 v3.14.0 以上版本。没有任何效果,无法登录官方渠道 - Codex升级 cc-switch 至 v3.16.2 或更高版本，并彻底删除用户目录下的 .codex 和 .cc switch 文件夹以修复 auth.json 被错误覆盖的问题。codex创建子代理采用复制模式的时候，会被错误的统计全量用量 - Codex升级到 v3.18.0 版本，修复子代理复制模式导致的用量双计问题以及代理流式记录重复放大的 Bug。Console Go: Upstream request failed该 400 错误由 OpenCode Go 网关拒绝不兼容的请求负载引起。可通过重启代理恢复会话映射，或避免使用 WebSearch 和图片功能等待后续修复。到claude 里面提示 401 - Claude Code开启 cc-switch 的本地代理功能以转换 API 格式，并确保 `ANTHROPIC_BASE_URL` 环境变量正确注入到 Claude Code 进程中。Error running remote compact task 报错 - Codex升级 cc-switch 至 v3.12.0 或更高版本，该版本在本地代理中新增了对 Codex `/responses/compact` 路由的转发支持，可解决 404 或 502 报错。格式转换错误: Failed to parse upstream response升级 cc-switch 修复流式响应解析错误，或为讯飞等非标 API 开启“填充完整请求路径”并补全 URL。InputValidationError: Write failed在 cc-switch 中关闭 Tool Search、最大强度思考及 1M 上下文声明以降低长文本截断概率，或回退至 3.13.0 版本。代理显示没有任何请求 - Claude Code这是 cc-switch 的已知 Bug，当 Nvidia 等上游未返回 usage 数据时，openai_chat 链路会直接丢弃日志，暂无官方修复。status=429 - Claude DesktopCC Switch 3.15.0 的流式请求会跳过模型重写导致 429 错误，目前暂无官方修复方案。CC Switch does not show the remaining quotaCodex 免费账户因官方 API 限制无法查询配额，暂无直接修复方案；Grok Build 用量漏记需修改源码改为流式解析。401 Unauthorized: Incorrect API key provided切换到 OpenAI Official 或关闭代理后，需手动清空 ~/.codex/auth.json 中残留的第三方 OPENAI_API_KEY 并重启 Codex 以恢复官方 OAuth 登录。请求转发失败: error sending request for url检查本地网络连接与代理配置，确保 cc-switch 能够正常访问 Nvidia API 端点以解决 502 超时错误。Authorization header is badly formatted在 cc-switch 中开启“本地路由”选项，并将 API 格式设置为“原生”，即可解决 GitHub Copilot 接入 Claude Code 时的 400 认证头格式错误。[proxy::response_processor] [Claude] 流错误当 cc-switch 代理 Claude Code 发生流解码错误或超时时，会导致日志遗漏或 token 统计为 0。可通过修改源码中的模型提取回退逻辑来修复模型名显示异常。cc-switch token计量为0旧版数据库缺少新模型定价导致 token 统计为 0，升级到包含修复的新版即可。Not logged in · Please run /login Claude修改 `~/.claude.json` 将 `PROXY_MANAGED` 移至 `approved` 列表，或在弹窗时选择 yes。使用claude code的代理功能后，无法显示模型的思考过程 cc-switch可先切回 Anthropic 协议恢复思考显示；若用 `openai_chat`，需修改 `streaming.rs` 的块转换，避免 Qwen 交替 `reasoning`/`content` 把 Claude Code 回复拆成多个片段。usage null - Claude Code Qwen DashScope升级到 cc-switch v3.16.3+，自动修复 OpenAI 兼容接口流式用量为 null 的问题。Claude Desktop 模式下代理接管 Claude 开关无法勾选在 claude-desktop 模式下，设置页的“应用接管”区域硬编码显示的是 Claude Code (claude) 开关，而非 Claude Desktop (claude-desktop) 开关，导致点击无反应或报错。一启动代理我在.claude.json里配置的mcp就会被重置CC Switch 采用全量覆盖同步，请在 CC Switch 内导入并统一管理 MCP，避免直接修改 .claude.json。Invalid schema: codex_app__automation_update升级 CC Switch 至 v3.18.0 或更高版本，以修复 Codex 转换 DeepSeek 协议时因 type: null 导致的 400 报错。Codex 开启代理后 apply_patch 工具不可用升级到 cc-switch v3.16.2 或更高版本；若使用中转站，请确保后台模型与 Codex 期望模型匹配，否则开启路由可能导致工具调用失败。Codex kimi 使用代理时请求持续发送这是 Codex App 客户端行为，非 cc-switch 故障；需检查客户端重试或保活机制。Codex 子代理 Token 统计遗漏与偏低升级至最新代码后，解析器将改用 payload.id 生成唯一请求 ID 替代 session_id，彻底解决 INSERT OR IGNORE 导致的静默丢弃问题，使子代理用量准确入库。测试失败 - Claude Code将 cc-switch 出站代理端口修改为与本地代理软件一致的端口（如 7897）即可恢复连接。"Expecting property name enclosed in double升级 CC Switch 至 v3.16.4 或更高版本，以修复大请求体未正确解压导致的 JSON 解析错误。Function call is missing a thought_signature在 Claude Desktop 代理模式下使用 Gemini Native 触发工具调用时，因会话 ID 不匹配导致 thought_signature 丢失，需等待官方修复。该模型始终思考，不支持关闭思考；请使用 low、high 或 max。在 cc-switch 配置中将 glm-5.3 设为强制思考模式，禁用 thinking.type: disabled。API Error: 400 Param Incorrect Claude Code升级 CC Switch 到 v3.16.2 或更新版本，修复 MiMo thinking mode 下 reasoning_content 未回传导致的 400 错误。model is not supported when using Codex关闭 cc-switch 的代理接管功能，避免向 Codex 写入不受支持的模型 ID 导致官方订阅封号或请求被拒。Nvidia 检查失败: Not found (404)升级 cc-switch 至 v3.16.3 或更高版本，新版已将测速改为轻量级 HTTP 探测，修复了 NVIDIA 接口误报 404 的问题。Claude Code无法调用工具 NVIDIA代理 - CC Switch修复NVIDIA免费通道模型不稳定，建议切换至deepseek-ai/deepseek-v4-flash等稳定提供商。stream disconnected before completion Codex升级 cc-switch 至 v3.14.0 或更高版本，以修复代理转发 hop-by-hop 响应头导致的连接断开问题。thinking enabled but reasoning_content关闭 Claude Code 的 Thinking 模式，或升级 cc-switch 解决 Kimi/Moonshot 工具调用报错。thinking options type cannot be disabled升级 cc-switch 至 v3.16.4 或更高版本，代理会自动剥离与 DeepSeek 冲突的 reasoning_effort 参数。Unexpected item type in content.在配置中启用内容块过滤以移除第三方后端不支持的 Anthropic 内部类型。Upstream request failed检查上游提供商是否支持当前模型或地区限制，切换可用模型即可。报.codex下的cc-switch.db出错，然后启动cc-switch失败关闭程序，手动清理 cc-switch.db 中 base_url 为空的残留记录，或直接删除该数据库文件后重启。在线更新时卡死无响应 CC Switch在 FlClash TUN 模式下 CC Switch 在线更新会卡死，请切换为系统代理模式或手动下载覆盖安装。无法应用于claude code for VS Code - Claude Code删除 VS Code 中关于 claude code 的旧代理设置，并在 cc-switch 中重新开关“应用到Claude Code插件”选项即可解决。第三方模型仍自称 based on GPT-5 - Codex将 `baseInstructions` 覆盖逻辑从 `if profile != ProxyChat` 块移出，使其对 ProxyChat 生效；当前即使配置了 `baseInstructions` 也不会注入。unsupported call: - Codex升级 cc-switch 至 v3.16.4 或更高版本，修复流式转换中工具调用 name/id 被空 delta 覆盖的问题。gemini开启本地代理后对话说无效令牌 cc-switch将 Gemini 供应商的渠道从 codex 分组改回 gemini 分组，开启本地代理后即可避免请求被错误路由而报无效令牌。total_cost_usd 没有重新计算 cc-switch升级 cc-switch 至 v3.15.0 或更高版本，以支持在修改模型定价后自动重新计算历史成本。Unsupported parameter: 'max_tokens'报错来自路由转发时携带了模型不支持的 max_tokens 参数；issue 中未给出已确认的修复步骤，请核对模型参数支持或等待 cc-switch 修复。
终端与环境变量45
Codex 用量统计被双倍放大或虚增升级到 v3.19.2 并在用量页执行「重建 Codex 用量」以修正历史虚增数据。'claude' 不是内部或外部命令，也不是可运行的程序升级至 v3.16.2+ 以修复 WSL/Windows 路径检测问题，或手动配置安装目录覆盖。cc-switch 启动白屏 / 黑屏 / 闪退 / 无界面（launch crash）先区分是窗口状态损坏、WebView2/系统兼容问题，还是安全软件拦截；按日志和现象分别处理，必要时改用 CLI 版。cc-switch 导致 Claude Code / Codex 的 MCP 配置丢失升级 cc-switch 到最新修复版，关闭或谨慎使用统一接管 MCP，逐个排查无效 MCP，并手动修正被改写的 command/type/path 字段。claude mcp list 显示 ✘ Failed to connectWindows 下 cc-switch 会把 MCP 的 npx 命令自动包装成 cmd /c，破坏 stdio 管道导致连接失败；手动改回 ~/.claude.json 或用 claude mcp add 重写可临时解决。原子替换失败 不支持该请求 os error 50 cc-switch升级 cc-switch 至 v3.20.0 或更高版本，以修复 WSL 路径下配置文件原子替换失败的回归问题。我windows11打开cc，为什么只有进程没有界面 cc-switchWindows 11 可在 exe 属性中尝试兼容 Windows 7；无效则改用 cc-switch-cli 绕过 Tauri 2 GUI 白屏。env: node: No such file or directory升级 cc-switch 至 v3.18.0+，修复 macOS GUI 启动时 PATH 缺失导致更新 Codex 找不到 node 的问题。model does not support thinking在 cc-switch 高级设置里关掉整流器（Proxy Rectifier），或升到修复版本；Qwen 工具调用死循环、空 thinking block 等变体仍未解决。未安装 / not installed or not executable升级 CC Switch 至 v3.20.0+ 以修复自定义 npm prefix 及 macOS 检测失败，Windows 误报多处安装需升级至 v3.16.5+。'claude' 不是内部或外部命令在 CC Switch 设置中手动指定 claude 可执行文件的完整路径，或确保该路径已加入系统 PATH。无法导入供应商，无法进行会话管理 cc-switch升级 cc-switch 以支持 jsonc 配置；WSL2 环境需定时克隆数据库至 Windows 本地路径以绕过 SQLite 锁定。not installed or not executable - OpenCode升级 CC Switch 至 v3.11.0+ 修复路径检测，或手动将 opencode 软链接至 ~/.local/bin。Unkonw coding plan provider cc-switch 火山引擎升级 cc-switch 至 v3.20.0 及以上版本，并重建或修改火山引擎 Agent Plan 供应商的 Base URL。检测到多处安装或显示为未安装 - Codex/OpenCode升级 CC Switch 至 v3.17.0 及以上版本，修复 Windows 下 npm 路径解析及包装脚本误判问题。每次点击都会先弹出系统文件夹选择器 cc-switch修改 src/App.tsx 移除 handleOpenTerminal 中的 pickDirectory() 调用，即可解决点击打开终端时强制弹出文件夹选择器的问题。zsh:1: command not found: claude升级 cc-switch 至 v3.16.4 或更高版本以修复终端启动时未加载 PATH 的问题，或临时切换至系统默认终端。401 认证失败: Claude Desktop gateway token 无效清除 Claude Desktop 的官方 OAuth 登录态，或修改 .claude.json 配置文件以解决 401 网关 token 无效问题。切换渠道后auth.json完全没变 - CodexCodex 切换渠道后 auth.json 未更新，需手动修改 auth.json 或等待 cc-switch 修复。重启电脑后禁用的 MCP 重新生效 - Codex官方尚未修复此配置覆盖问题，需手动清理配置文件中的冲突 MCP 节点，并谨慎使用 deeplink 导入以防自定义设置丢失。codex中只有258k上下文 - Codexcc-switch 将 minimax 模型映射为 gpt-5.5 后，会触发 Codex 和 Claude Code 的硬编码上下文限制，导致 1M 上下文失效。cc-switch老是自动删除我的环境变量冲突弹窗直接关闭不会删除环境变量；想彻底消除需删除 shell 配置或 Hermes config.yaml 中的对应项；v3.17.0 弹窗无法关闭是已知问题。重启终端，执行gemini，提示需要输入api-key - Gemini CLI更新 cc-switch 修复保存清空 bug；若仍无效则是 Gemini CLI 官方读取 bug，需将环境变量写入 bash_profile。skills同步到了未选择的应用上 OpenCode升级 cc-switch 到 v3.12.3 修复隐式推断 bug，并在 OpenCode 设置中关闭默认读取 .claude 目录下 skills 的选项。protocol handler not registered在 Linux 的 CC Switch.desktop 文件中将 Exec 修改为 cc-switch %U，解决 Chromium 浏览器无法识别导入协议的问题；WSL 同步需检查管理员权限。<tool_use_error>InputValidationError 报错cc-switch 转换层存在 SSE 解析 bug 导致 tool call 丢失，目前建议直连 API 或更换官方节点。本地有claude cli但是关于设置里显示未安装升级 CC Switch 至 v3.16.5 或更高版本，以修复 Windows 下 npm 全局包多入口导致的误报冲突及路径乱码问题。配置WSL路径但技能读不到 cc-switch在 Windows 版 cc-switch 中无法直接读取或安装 WSL 的 ~/.agents/skills，需直接在 WSL 内安装并运行 Linux 版 cc-switch。Symlink target not foundAppImage 安装失败，需手动修复 .DirIcon 符号链接为相对路径。打开终端未使用完整配置通过「通用配置」面板提取并勾选写入，避免全量覆盖导致插件等共享配置丢失。为什么单独在终端使用claude命令使用的模型与在cc-switch中使用的模型不一样呢把真实要用的 MiniMax 设为主模型，并在 cc-switch 打开的终端运行 claude；未开启接管时终端里显示的映射名不代表请求被替换。在codex桌面端中接入gpt5.5无法图片输入和切换推理强度 - Codex删除 Codex 下的 cc-switch 配置文件并重建，或手动修改 cc-switch-model-catalog.json 补充缺失的推理档位和图片模态。No such file or directory (os error 2)将 config.toml 中的 model_catalog_json 绝对路径修改为相对路径 cc-switch-model-catalog.json，或升级 cc-switch。Copied订阅接入时模型映射不生效升级至 v3.15.0 或更高版本以修复 Copilot 订阅模型映射失效问题。version `GLIBC_2.35' not found官方 AppImage 依赖高版本 GLIBC，RHEL/Rocky Linux 用户可改用社区编译的 Flatpak 版本或旧基础镜像构建版。env: node: No such file or directory将 cc-switch 升级至 v3.18.0 或更高版本即可自动修复 GUI 环境下 PATH 缺失导致的环境变量解析失败问题。This software does not run on macOS执行 `brew update` 后重试安装，或手动从 GitHub Releases 下载 DMG 安装。invalid_request_error Kimi For Coding在 cc-switch 的 Kimi 配置中设置 ENABLE_TOOL_SEARCH=false。No endpoints available that support升级 Claude Code 至 v2.1.92 及以上版本，并更新 cc-switch 以修复 OpenRouter 参数传递错误，或尝试关闭本地代理。not found(404) 添加Claude code桌面版模型api失败升级至 v3.16.3+ 以修复连通性检测误报，或忽略 404 直接测试实际调用。'/d' 不是内部或外部命令 CC Switch点“打开终端”选中中文工作目录后报 '/d' 时，先改用英文目录或用 mklink /J 建立英文 junction 绕过；彻底修复需让 .bat 全部使用 CRLF 并加 chcp 65001。模型就自动切换到了haiku上 cc-switch这是 Claude Code 自带特性：haiku 用于读文件，cc-switch 只管理环境变量，不会改变模型选择。Bash(...) Waiting... Claude Code降级 Claude Code 至 v2.1.104 或 v2.0.64（需管理员权限），或切换至阿里云百炼等兼容 provider，因 Nvidia 模型无法正确解析 tool use 格式。原子替换失败 os error 50将 Claude Code 配置目录从 WSL 路径改回 Windows 本地路径，或回退至 v3.19.0。已安装，但无法在当前环境中运行，请检查 CC Switch升级到 CC Switch v3.16.1 或更新版本，修复 Windows 上 cmd /C 引号处理导致本地环境检查把已安装 CLI 误报为“无法运行”的问题。
界面与交互33
cc-switch 导入/云同步失败：外键、只读数据库与覆盖问题升级 cc-switch 并避免同步 provider_health / 只读 db；导入后点击“导入”而非“保存”。cc-switch Skills 管理异常（重复、无法识别、删除后恢复、状态不一致）多数 Skills 问题已在后续版本修复：升级到 v3.18.0 可解决默认仓库删除后恢复；升级到 v3.13.0 可改善已安装 Skill 识别与去重。切换后配置丢失：Claude Code / Codex / WSL 路径核对切换供应商会重写 settings.json，请把 hooks/statusLine/enabledPlugins 等字段放入“通用配置/共享配置片段”，不要只写在本地文件里。config.toml 和auth.json的内容仍然是之前第三方的api的升级 CC Switch 到 v3.16.1+（建议最新），重启后重新切换 Codex 供应商；若官方 OAuth 失效，执行 codex logout 后重新 codex login --device-auth。在Codex界面，官方订阅无法查询用量 - Codex开启本地路由映射以统计特定模型用量，第三方API需适配查询脚本，Claude官方及Free账号暂不支持查询。无任何套餐显示(解析为空)升级 CC Switch 至最新版本，或在自定义脚本中将过滤条件从 TOKENS_LIMIT 改为 CREDIT_LIMIT 以适配智谱最新积分制 API。config.toml 更改后不知不觉又回到之前的配置cc-switch 数据库是单一事实源，手动修改本地文件会被覆盖，需在软件内的 MCP 管理器或通用配置模块中统一修改。Codex OAuth切换API Key无效升级至 v3.17.0+，并在设置中关闭「保留官方插件」选项。实际上下文窗口报错且无法/compact - Claude Code / Codex在 cc-switch 中为模型手动指定正确的 model_context_window 值，避免错误默认值导致压缩失效或 422 报错。在实际使用中只显示200K上下文窗口了 - Claude Code在 `~/.claude/settings.json` 中将默认模型改为带 `[1m]` 后缀的变体，或在会话中手动执行 `/model claude-opus-4-8[1m]` 以激活 1M 上下文。cc-switch安装后无法打开主界面或无反应尝试使用CLI版本替代，或升级/回滚Windows系统以解决Tauri兼容性。不能显示 gemini cli 历史会话 - Gemini CLIGemini CLI 0.39.1 更改了历史路径，因消费级服务将停用，官方不再修复旧路径，建议等待 Antigravity CLI 支持。JSON 解析错误: expected value at line 1升级 cc-switch 修复并发写入导致的 JSON 损坏，并在通用配置中添加自定义字段防止切换时被整份覆盖丢失。开启应用增强功能后我原本的api无法连接上，跳503 - Codex在 cc-switch 中关闭“应用增强”或“保留官方登录”功能，即可解决 503 错误和超时问题。Your access token could not be refreshed完全退出并重启 Codex（或结束 codex 进程）以清除旧授权，再重新登录。ending with a leaked `</t` close-tag此问题由 cc-switch 流式转换器未去重及未过滤 think 标签引起，请更新 cc-switch 至包含 PR #6319 修复的版本。点击更新后卡住强制退出并重新打开软件，或手动更新至 v3.16.3 及以上版本以修复更新死锁问题。"+"号按钮消失，无法添加供应商将 cc-switch 窗口最大化或向右拉宽，即可显示被隐藏的添加供应商“+”号按钮。当key输入为limit时，输入框内容会被自动清空 OpenCode由于 cc-switch 界面将 limit 设为保留字，需直接编辑 opencode.json 文件来手动配置模型的上下文和输出限制。ZIP 文件中未找到技能（需包含 SKILL.md 文件）升级 cc-switch 至 v3.16.2 或更高版本，并在导入同名 Skill 前手动删除旧目录，以解决路径解析与冲突提示错误。codex cli 失败：CC Switch将 cc-switch 升级至 v3.16.3 或更高版本即可修复本地环境检测与升级链路的阻塞问题。Claude Code 切换模型后旧窗口没反应在 cc-switch 切换模型后，已打开的 Claude Code 会话不会自动生效；请关闭旧窗口/会话并重新打开，或在新窗口中使用切换后的模型。auth.json会自动复用上一个供应商的 - Codex在设置中关闭“切换第三方时保留官方登录”选项即可解决。unexpected status 401 Unauthorized Codex使用内置 DeepSeek 模板替代自建配置，或在配置文件中手动添加 http_headers 传递 API Key 以解决 401 报错。无法安装和更新 Codex CC Switch升级到 v3.16.3+ 后从「设置 → 关于」重新安装/更新 Codex；若 v3.16.5 仍失败请带日志反馈。Your input exceeds the context window 报错当会话上下文过长超出模型限制时报错，需手动压缩上下文或设置自动压缩窗口。切换Codex供应商后会话记录消失升级至v3.16.0以上，CC Switch会自动将第三方供应商历史迁移至custom桶，原文件已备份。Gateway rejected model "claude-haiku-4-5"在配置中开启 isFullUrl=true 并填写完整 API 路径，禁止 cc-switch 自动拼接 /v1/messages。error code is 2503 或升级后图标变白修改 per-user-main.wxs 移除快捷方式 Icon="ProductIcon" 属性即可解决安装失败与升级后图标丢失问题；旧版用户需取消固定后重新固定。配置界面闪烁升级 cc-switch 修复表单异步加载导致的闪烁，并通过读取 SQLite 数据库解决 env 变量不随供应商更新的问题。“event handler is re-entrant” 报错或启动闪退卸载 Windows 更新 KB5081263 或等待 cc-switch 升级以规避 TAO EventLoop 重入导致的崩溃与界面不渲染问题。切换路由状态失败:{{detail}}升级到 v3.16.2 或更新版本，路由面板会显示真实错误详情。show 0 skills from cc-switch升级 cc-switch 至 v3.17.0 并重新切换 skill 状态，以修复 Windows 下 Hermes Desktop 读取 LOCALAPPDATA 路径的问题。
导入与同步25
CC Switch 配置导入/同步不生效升级 CC Switch 到 v3.16.1+，并检查 WebDAV/云同步与配置写入路径是否被正确同步。cc-switch Skills 导入/同步异常（失效、无法识别、目录不同步）多数问题源于 Skills 目录结构变化或 DB 与文件系统不同步；优先使用 cc-switch UI 管理、升级版本并检查嵌套/插件目录支持。cc-switch 检查更新失败 / 更新安装失败更新失败多因权限不足或 GitHub 网络异常；请用管理员/绿色版安装，或到 GitHub Releases 手动下载。[CODEX-SYNC] deferred：尚未写到 child fork 时刻这是 cc-switch 3.18.0 的 Codex 同步缺陷：已完成父 rollout 早于子 fork 时间戳会被永久 deferred；暂无确认修复，先避免产生 fork 并等待补丁。Codex 桌面端看不到第三方模型在 Codex 桌面端登录官方 ChatGPT 账号，并在 cc-switch 开启保留官方登录即可恢复显示。在codex中打开不显示使用的模型列表，切换不了模型 Codex在 cc-switch 中开启“切换第三方时保留官方登录”，并确保已在 Codex 登录过官方 ChatGPT 账号，即可恢复第三方模型显示。codex升级为ChatGPT后不适配了吗 cc-switch升级到 cc-switch v3.17.0，该版本已适配 Codex 合并到 ChatGPT Desktop 后的供应商切换，避免旧配置被覆盖。codex 会话已过期 - Codex备份配置后运行脚本同步 auth.json 的 token 至 cc-switch 数据库与本地文件，或关闭用量刷新防止旧数据覆盖。测试脚本:报错未返回结果MiniMax 更改了余额查询 API 返回结构导致旧版解析失效。请升级 cc-switch 至 v3.16.2+，或临时使用自定义模板。还没有添加任何供应商升级或云同步后 UI 状态与底层数据库不同步，完全重启应用或重新导入备份即可恢复供应商列表。Codex Desktop UI 的项目列表完全为空 - Codex升级 CC Switch 后 model_provider 键名变更，统一改回 custom 或升到修复版本；官方登录态丢失、推理档位变少等情形仍未解决。cc-switch接入claude的配置被覆盖 Claude Code在 cc-switch 中登出官方账号并清除登录状态，以恢复开发者模式的代理配置。Gemini CLI 的用量数据没有被统计 CC Switch消费级 Gemini CLI 已停用并迁移至 Antigravity CLI，CC Switch 不再支持其用量统计；若为自定义模板或 Grok 用量问题请升级至最新版。手动修改的 MCP 配置文件被 cc-switch 覆盖cc-switch 采用全量写入机制，需通过「通用配置」同步插件，并升级至 v3.13.0 修复 MCP 跨应用泄漏。skills 安装路径不对 cc-switch旧版 cc-switch 会把 skills 装到 ~/.claude/skills/skills，Claude Code 不识别；升级到修复版本，或临时把内容上移到 ~/.claude/skills/。commnd自动变成cmd导致mcp服务连接失败 - Claude Code在 cc-switch 界面内修改 MCP 配置以防被覆盖，并手动修正被错误改写为 cmd 的 npx 命令。openclaw.json is not valid JSON - OpenClaw手动为 ~/.openclaw/openclaw.json 中的 models 键添加双引号，以修复严格 JSON 解析失败的问题。Skill 源目录缺少 SKILL.md，拒绝同步以避免覆盖目标目录当技能仓库目录结构与 skillId 不匹配或存在嵌套时 CC Switch 会安装失败，可改用 `npx skills add` 命令行手动安装。在 auth.json 不存在时无法恢复 Provider Auth - Codex升级至 v3.13.0 即可解决多设备同步时因缺失 auth.json 导致无法恢复 Provider Auth 的问题。This model is not supported when using注释掉 config.yaml 中的 model_provider = custom，恢复使用官方 OpenAI provider。AbsolutePathBuf deserialized without a base在 macOS 版 Codex 中，CC Switch 写入的相对路径会导致此报错。请手动将 `~/.codex/config.toml` 中的 `model_catalog_json` 修改为绝对路径即可修复。S3 HEAD bucket 失败: 404 Not Foundendpoint 已含 bucket 名时，需移除配置中的 bucket 字段以避免路径重复拼接。打开后就闪退 cc-switch目前没有已确认修复：卸载重装也无效，先收集 debug 日志并保留现场，等待官方修复。配置后同样用不了，选择不了模型 - Codex开启 Codex 应用增强中的“保留官方登录”选项并重新登录切换即可恢复模型列表显示。默认带的 5 个 Mcp 有两个直接添加报错 cc-switch安装缺失的 `uvx` 和 `mcp-server-time` 依赖（`pipx install uv`、`pipx install mcp-server-time`）后重新添加 MCP。
环境变量5
获取模型列表失败先升级 cc-switch 并先添加模型行再获取列表；若仍失败，用 curl 验证 /v1/models 权限。配置不生效：MCP 未导入与环境变量被覆盖cc-switch 采用全量覆盖设计，手动改的配置需通过“通用配置”提取保存；MCP 需手动导入；环境变量需勾选“写入通用配置覆盖”。json文件配置里没有相关DEEPSEEK配置项升级 cc-switch 至 v3.20.0+，在模型映射中勾选思考等级并重新保存，以修复配置未写入或被模板覆盖的问题。built-in provider IDs: openai - Codex升级 CC Switch 至 v3.16.4+ 并删除旧配置重新保存。开启「统一 Codex 会话历史」开关，避免手动覆盖 openai provider，确保使用 openai_base_url。Gemini CLI 读取项目 .env 导致 cc-switch 失效在 PowerShell 中封装 gemini 命令，手动加载 ~/.gemini/.env 环境变量。
用量与余额6
用量统计不显示/查询失败先开启用量统计开关并检查供应商脚本与协议限制；官方统计需启用 Tool Search。codex deepseek无法选择模型 cc-switchCodex 桌面端在没有官方 ChatGPT 登录态时会强制隐藏第三方自定义模型：先登录一次官方 ChatGPT，再在 cc-switch 开启「切换第三方时保留官方登录」并重启 Codex 即可恢复模型列表。用cc-switch切换, 发现无效 - CodexCodex 不支持热切换，必须在 cc-switch 切换中转站后彻底重启 Codex 应用，会话丢失可通过迁移工具恢复。获取模型失败 cc-switch升级 cc-switch 至 v3.16.4+ 修复 404 探测问题；若为 Coding Plan 需手动更改 API 地址并手动填入模型。Invalid schema: got 'type: null'升级 cc-switch 至 v3.17.0 或更高版本，以修复 OpenAI 格式转换时缺失 type 字段导致的报错。Kimi余量查询不可用更新cc-switch至最新版本，后端已自动修复Kimi余额识别逻辑。
更新与升级4
自动升级不行，重新下载新版本安装之后还是老版本彻底卸载旧版本并清理残留后重新安装，即可解决自动升级失败或版本未更新的问题。用户在 GUI 中的配置修改完全无效OMO v4.19.3 将配置迁移至 ~/.omo/omo.jsonc，导致 cc-switch 写入旧路径失效。需手动编辑新配置文件或升级 cc-switch。macOS cc-switch检测版本错误/卡死修改.zshrc中fastfetch调用，添加[[ -t 1 ]]限制非交互式输出。unexpected status 403 Forbidden在 CC Switch 设置中关闭“保持官方登录”并重启，可阻止 Codex 自动发送生图请求导致中转站 403 报错。
供应商管理5
添加供应商页面 搜索预设后无法点击选中搜索结果 cc-switch更新到修复该 UI 问题的版本；临时可在搜索后用 Tab 键切到预设并按 Enter 选中。添加供应商失败：crypto.randomUUID is not a function升级到 cc-switch v3.9 或更新版本，该版本为旧 macOS 添加了 crypto.randomUUID 兜底逻辑；或升级 macOS 到 12.3 Monterey/11.6.5 Big Sur 以上。大模型无法发现任何工具 - Codex升级 cc-switch 至 3.16.1 以上版本，并修改 cc-switch-model-catalog.json 将 DeepSeek 模型的 supports_search_tool 设为 false。思考等级未适配升级至最新版后重新添加 OpenCode Go 预设以获取正确的 reasoning_effort 配置。为 Claude Code 添加 CoderPlan provider这是功能请求：为 cc-switch 增加 CoderPlan provider preset，作者已准备 Claude Code preset PR，但维护者仅要求通过 readme 邮箱沟通，合并状态未确认。
thinking 字段2
Skills2
配置不生效1
安装与安装包1
启动闪退 / 白屏2
网络与超时1
模型列表1
登录与鉴权1
其他37
切换供应商后 Codex config.toml 配置丢失升级 cc-switch 到 v3.17.0+，该版本改为增量合并而非全量覆盖 config.toml。There's an issue with the selected model升级 CC Switch 到最新版，重启目标工具并新建会话，让本地路由剥离 [1m] 后缀后重新匹配映射。auth.json又填充了已有账号的auth.json Codex升级到 v3.17.0+，并关闭「非接管切换时保留官方登录」；auth.json 被旧账号/旧 key 覆盖时，先备份再升级验证。重启CC switch后打开codex，所有的设置、插件、都会丢失重置将 Codex/Claude Code 的跨供应商配置和插件写入“通用配置”，避免切换供应商时被覆盖；已丢失内容可到 default 供应商或通用配置中恢复。cc-switch 供应商管理无法删除或添加失败问题供应商管理问题多为 UI 限制或版本 bug，唯一供应商不可删除，输入异常与删除失效需升级版本或关闭相关功能。Codex model catalog template `gpt-5.5`重新生成 ~/.codex/models_cache.json，并保留 Codex 的 ChatGPT 登录态，CC Switch 才能写入路由并显示 DeepSeek 模型。Codex model catalog template `gpt-5.5`运行 `codex debug models --bundled > ~/.codex/models_cache.json` 生成缺失的模型缓存，再重新切换 Codex 路由即可。切换供应商后 settings.json 插件与 hooks 丢失这是 cc-switch 的全量快照覆盖设计：把需要保留的字段放进“共享配置片段 / 通用配置”，并勾选“写入通用配置”。cc-switch 使用统计异常：0/200K、重复计费与定价无法删除升级到 v3.16.3 修复 token 为 0，v3.17.0 改进 Codex 派生会话去重，v3.19.0 修复内置定价删除后复发。Codex桌面端显示「自定义」或401 Unauthorized在cc-switch设置中开启「切换第三方时保留官方登录」并确保Codex已登录官方ChatGPT账号，或新开对话避免旧会话401。本地环境检查 提示codex未安装先在终端运行 `codex --version` 确认命令可执行；若终端正常但 cc-switch 检测不到，通常是安装路径未纳入探测范围，升级到 v3.16.4+ 或提供路径等待修复。There's an issue with the selected model检查 cc-switch 中模型名与供应商配置，模型测试功能不可靠，请以实际请求为准。千问 Qwen 模型报错或截断升级到 CC Switch v3.16.4 并使用对应 Qwen/OpenCode Go 新预设。Cowork WebFetch 无法访问外部网络 - Claude Desktop在 CC Switch 生成的 3P gateway profile 中加入 "coworkEgressAllowedHosts": ["*"]，允许 Cowork sandbox 访问外部主机。cc-switch 登录与鉴权配置无法填写或无法删除升级到 v3.17.0 或更新版本；Google 官方 OAuth 误判与历史供应商门控导致的 API Key 输入框消失已修复。not installed or not executable升级 CC Switch 到 v3.16.2+，或在设置中手动指定 CLI 安装目录，并清理 shell 启动输出噪音。cc-switch 窗口显示异常 UI 渲染问题升级到包含 UI 修复的版本；地址栏溢出与渲染异常已被修复，标题栏背景色问题需等待后续修复。通用配置被忽略 cc-switch升级到 cc-switch v3.12.2+，通用配置片段在重启后会正确持久化；临时可关闭“通用配置功能”并直接写入配置 JSON。DeepSeek API Key 被覆盖导致 401升级 cc-switch 到 v3.16.2+，并重新填写 DeepSeek API Key，避免切换供应商时被其他 Key 覆盖。DeepSeek 使用统计费用/缓存命中率错误升级到 v3.16.3 及以上，修复 chat→message 转换路径中重复计入 input、流式无 usage 与模型计费归属错误。Gemini 出现 default 配置且无法删除default 是 CC Switch 导入现有 live 配置生成的预期供应商；需先在设置中切换当前供应商，再删除不需要的配置。Unknown parameter关闭 cc-switch 的统一会话历史开关，并将带有 custom 标签的历史会话移回 openai，以修复 namespace 参数报错。msi程序和exe程序我都点了但是没有反应用 PowerShell 以管理员身份启动安装包；仍失败时先卸载旧版或改用 portable 绿色版。Claude code 不支持 geminicc-switch 目前不支持将 Gemini 作为 Claude Code 的 provider；需要等待本地代理功能或使用第三方代理项目。skills 无法获取/插件被回滚 cc-switch升级 cc-switch 到 v3.9.0 修复 skills 获取；插件配置被覆盖时备份 ~/.claude/settings.json 的 enablePlugins 到通用配置片段。The 'deepseek-v4-flash' model在 cc-switch 中开启保留官方登录选项，并确保本地路由接管已开启，然后重启 Codex 桌面端。调用 GLM-5 报错 1311 cc-switch这是供应商权限问题：请在对应服务商开通 GLM-5 / MiniMax / Kimi 权限，或联系供应商确认订阅套餐权限。Unsupported parameter(s): prompt_cache_key升级 cc-switch 到最新版本，以修复转发 Nvidia API 时未自动移除 prompt_cache_key 参数的问题。API Error: 400 Invalid request Error将 Claude Code CLI 或 VSCode 插件回退到旧版本（如 2.1.150 或 145），并禁用自动更新以解决 400 报错。Codex 配置 DeepSeek 报错 gpt-5.5安装 Codex CLI 并执行 codex debug models --bundled 重新生成 models_cache.json。API Error: 422 格式转换错误上游 NVIDIA NIM 的 GLM-5.2 模型偶发返回空 choices 数组，建议在 cc-switch 中开启故障转移或重试请求。Invalid pages parameter: "" Claude Code将 API 格式切换为 anthropic，或升级 cc-switch 以修复 Responses 转换产生的空 pages 字段问题。Unexpected status 503 Service Unavailable配置 v2ray 等代理工具绕过局域网流量，解决 Codex 访问 cc-switch 本地路由时的 503 报错。AnyRouter 报错 429 Claude Code在供应商配置 JSON 中加入 "model": "opus[1m]" 并重启 Claude Code；若仍报 429，多为上游限流，可换网络或改用 haiku。cc-switch Codex 会话记录丢失关闭 Codex 路由或统一会话历史相关开关，使 model_provider 与旧会话一致后重启 Codex，历史会话即可恢复。无法找到授权登录的入口了 cc-switch升级 cc-switch 或从 Claude Code 迁移供应商自动添加官方供应商，即可恢复 Claude Desktop 授权登录入口。Please check WebDAV username/passwordcc-switch 写回同步数据时脱敏把 WebDAV 密码清空成空字符串，升级到修复版本即可；临时可重新输入密码恢复。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。