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