More solved problems

The following 227 problems are closed on GitHub and were discussed there, but do not recur often enough to warrant their own page. This is a list of entry points to the original threads — this page offers no distilled fixes; follow a link to read the original report.

Models and switching41

#3121使用本地模型时claude code desktop 显示Request error: net::ERR_CONNECTION_TIMED_OUT16
#995连接openrouter出现错误 No allowed providers are available for the selected model.14
#4362Claude Desktop更新到最新版后，Fable挡位所映射的模型不可用，且所有挡位模型在CC-Switch中声明的1M上下文不生效8
#2592mac电脑后重启，打开claude code，提示无法连接deepseek v4模型6
#3830最新Codex无法展示Deepseek和模型6
#4326v3.16.3版本阿里云百炼Anthropic 端点获取模型列表失败6
#4426[Bug] Codex桌面端 config.toml 中的模型配置失效，请求时被错误替换为 "gpt-5.4"6
#2447GLM模型配置失败5
#4013[BUG] After setting DeepSeek API in CC Switch, Codex cannot select the model5
#4601不显示模型仅显示【自定义】解决办法及 100% BUG 复现方法5
#1669检查模型时一直失败，提示HTTP 404，已确认输入的url和api还有模型名称没有问题4
#2757[Bug] Hermes model.base_url not updated when switching providers (HTTP 404 on auxiliary services)4
#3569【WSL2环境下codex cli】config.toml中指向兜底model-catalog路径错误4
#4164[Bug] Streaming SSE conversion loses tool_call_id for third-party models (e.g. SenseNova)4
#426七牛云-openai 检查失败: HTTP 400: {"error":{"message":"no available channels for model gpt-5.1-codex (request_id: chatcmpl-6686fac83baf4c729ea171fe96233789)","type":"invalid_request_error"}}3
#1435Bug Report: Claude Code v2.1.72 Auth & Model Persistence Conflict3
#2724Support for full GitHub Copilot model list (errors with current setup)3
#27792个coding plan套餐不同的模型上下文长度（1M/256k），热切换时claude出现压缩错误问题。3
#4070模型属性的属性名无法输入limit3
#4483[Codex] 开启思考模式后首轮 tool_calls 报 400 invalid tool_call_id（Provider: SenseNova商汤, model: deepseek-v4-flash）3
#312`PackyCode API 调用报错 503：gpt-5.1 系列模型提示“无可用渠道 (distributor)”`2
#835Gemini 模型 max_seq_len 限制过低 (32k)，导致无法在 claudecode 中使用 Gemini 2.0 模型2
#1234CCswitch 版本 3.11.1 接入第三方模型输出中断卡死2
#1681使用Copilot时如果调用GPT系列模型，选择OpenAI Chat Completions和OpenAI Responses API两种格式，都会出现“不支持endpoint”报错2
#4180配置了minimax模型后在claude code cli中无法识别图片2
#4335failed in codex when use MiniMax-M3 model2
#4974ai模型切换bug2
#5053glm5.2模型响应内容异常2
#5194Codex 路由无法使用 gpt-5.6-luna gpt-5.6-sol，直接返回 404 Model not found2
#5843codex用cc-switch接入模型识别图片有严重的token膨胀bug2
#1376404 error After Add longcat Model to openclaw1
#1448使用claude code cli驱动gpt模型报参数错误1
#2938codex cli 现在也开启模型校验了吗？使用 cc Switch 切换模型后，使用报错如下错误1
#3174无法获取模型了表1
#3335[Bug] cc-switch-model-catalog.json generates invalid ReasoningEffortPreset format - should be object array not string array1
#3513[Bug] 切换供应商后，已运行的 Claude Code 进程不会更新 --model 参数1
#4342[Codex路由] 供应商 Mimo (token-plan-cn.xiaomimimo.com) 配置后请求失败，返回模型不支持错误1
#4627Bug Report: Most NVIDIA NIM API Models Not Working in Claude Code via CC Switch1
#4989GLM 模型自带联网搜索报错1
#5032Copilot free帳號本來可以讀的到model使用在claude code，現在不能了1
#5160cc-switch 3.16.5 搭配claude Haiku 4.5 提示API Error: 400 "thinking.type.enabled" is not supported for this model.1

Config and sync29

#859claude配置魔塔社区或Nvidia api时使用报错15
#78vscode 插件配置不生效10
#753[bug] opencode配置供应商时多个参数没有写入opencode.json8
#574setting全部配置好了，claude code还是无法连接，如何解决？7
#761配置openrouter 400报错5
#3310[Bug] 导入 Hermes 配置失败：duplicate entry with key custom_providers5
#6310在 Windows 系统下，使用 CC Switch 切换供应商或路由时，写入 WSL 2 中 Claude Code 的 `settings.json` 文件失败，并报错 `os error 50`。5
#59不能导入到vcode4
#341cc-switch 在 mac 下无法自行配置 gemini 环境变量问题4
#370插件配置在切换 AI 提供商时丢失4
#729[Bug]: opencode 配置路径有问题4
#1405[Bug] v3.12.0(macOS): Stream Check toast 未插值 + Codex config.toml 写入 [agents].base_url 导致 Codex 26.305.950 报错3
#1614wsl2安装的openclaw，无法读取和设置相关配置3
#2129OpenCode配置火山引擎Coding plan无法连接-4043
#2192Codex配置报错3
#4094进入[设置]-[关于]后程序报错崩溃3
#4883配置腾讯云 COS（S3 兼容）同步失败：403 PathStyleDomainForbidden（疑似客户端硬编码 force_path_style）3
#931Gemini 模式下，无法配置智谱的渠道2
#3013Stepfun (阶跃星辰) 默认预设配置导致 Claude Code 运行无限 attempt (无法连接)2
#3824bug: Common config sync overwrites custom Codex config.toml — MCP servers regressed to npx mcp-remote2
#160[bug]无法配置：experimental_use_rmcp_client = true1
#249iFlow心流平台自定义配置，404错误1
#325Codex 配置无法使用魔搭社区1
#1081Claude Official 检查出错: Failed to extract base_url: 配置错误: Claude Provider 缺少 base_url 配置1
#1521builder error. /. Gemini Provider 缺少 base_url 配置1
#1583codex更新最新后出现配置文件异常1
#1849opencode 配置的供应商标识无法修改，导致复制后供应商标识越来越长且管理混乱1
#2233将opencode go设置为Claude Code供应商，对话中回复一句就开始报错1
#2548hermes 配置报错1

Proxy and network23

#2750[Bug] Codex 经 cc-switch 本地代理后持续 Reconnecting，流在 response.completed 前断开22
#3585本地路路由映射开启后，报错unexpected status 502 Bad Gateway: Unknown error, url: http://127.0.0.1:15721/v1/responses18
#450本地代理报错15
#2937[Bug] Claude Desktop 第三方供应商代理未钳制 max_tokens，上游有 32768 上限时全部请求 4004
#4672Codex proxy returns 502 error (v3.16.3)4
#1187使用modelscope的代理API，无法使用3
#2354ccswitch配置openai格式代理之后，工具调用会connection error3
#2718使用本地自建api时提示API Error: 502 请求转发失败: 上游请求失败3
#3362本地代理对 GET /v1 返回 404，导致 Codex 桌面版连通性检测失败持续 reconnectingv3
#1958`Proxy duplicates /v1 path prefix, causing 502 upstream_error`2
#3191[Bug] 代理模式下 settings.json 丢失 ANTHROPIC_MODEL 等环境变量，导致 Claude Code 显示默认模型名2
#3893[Bug] Codex: preserveCodexOfficialAuthOnSwitch not working + Local Proxy tool calls broken2
#5301支持原生responses接口的中转站地址，不开启本路路由也无法连通，报5022
#1819CC Switch proxy enabled but Claude Code VSCode extension cannot connect (macOS)1
#3043bug(proxy): "Failed to toggle routing: {{detail}}" — error detail not passed to i18n template1
#3372Bug: ProxyPanel takeover toggle hardcodes 'claude' but misses 'claude-desktop' when user is in claude-desktop mode1
#3674413 Payload Too Large: CC Switch local proxy failed1
#3846Bug: Streaming timeout causes wrong model name and zero tokens in usage logs1
#4275[Bug] Gemini 代理未向 Zhipu CodingPlan 上游注入 Authorization header1
#4505launch temp 可以正常使用，Test 报错，命令行claude后API Error: 502 connection failed: error sending request for url (https://api.deepseek.com/anthropic/v1/messages)1
#4901Invalid schema for function 'codex_app__automation_update' when proxying to DeepSeek1
#5091Codex 配置 OpenCode Go 报 504 异常1
#5423opencode go接入cc无法使用网络搜索功能1

#3294claudecode 请求报错：API Error: 400 message[1] has invalid role: system (request id: 2026052914014224017678685184388)24
#820给Claude 配置 minimax M2.1 模型报错 401 login fail: Please carry the API secret key in the 'Authorization' field of the request header15
#1657登录配置了copilot 之后使用cc终端报错10
#4628Codex 使用第三方中转并保留官方登录时，启用远程压缩会返回 invalid character '('7
#1116bug(provider-form): Claude custom provider does not show API Key input when creating new config6
#745[Bug] Gemini 全局/单独代理设置不生效，提示需要登录 (Google Official)4
#1832Codex使用CC-Switch配置官方模型，已经认证了但依然报错4
#3224[Bug] Claude Desktop 使用 AWS Bedrock API Key 时测试通过但实际聊天失败4
#2639github copilot 添加账号提示：网络错误: error sending request for url (https://github.com/login/device/code)3
#3110[Bug] Claude Desktop 使用 AWS Bedrock API Key 时错误转发到 bedrock-runtime /v1/messages，导致 HTTP 200 空响应3
#137使用后无法切换回claude官方授权方式吗？2
#4411使用不了codex，显示API Key 所属分组已停用，该怎么办，还有怎么彻底删除ccswitch2
#5041Bug: Claude provider edit mode — API Key input missing when category is undefined1
#5213Bug: Provider switch overwrites target provider's API key with previous provider's key1

Provider management12

#19能不能添加一个魔搭？10
#2117[Bug] stream_check ignores ANTHROPIC_BETAS and omits context-1m-2025-08-07 for opus[1m] providers8
#3459[bug] 路由模式下切换供应商，界面中的6
#1110google ai studio来添加报错Unknown name \"beta\"5
#4934OpenAI Chat Completions 路由缺少 `/v1/messages/count_tokens`，导致 Claude Code 无法使用 OpenAI-compatible 供应商4
#838添加Open Code供应商报错3
#2236Bug Report: Tool result missing due to internal error with OpenCode Kimi provider3
#1257[BUG] OpenAI Official preset has empty config - missing base_url causes "codex provider not provide base url" error2
#2878使用 Codex Provider 时，Claude Code 调用 pwsh/PowerShell 工具会崩溃，但 DeepSeek Provider 正常2
#4044codex 使用预设供应商【火山Agentplan】接入火山【Coding Plan】不能使用DeepSeek-V4-Flash2
#464添加 openrouter ，返回Provider returned error1
#1873Bug: Claude OpenAI-compatible providers force /v1 for custom base URLs1

Install and update10

#3277升级到新版的claude，交互指令报错40065
#2123Cannot install on Ubuntu 20.04 – missing libwebkit2gtk-4.1-0 dependency9
#2020误清理掉 installer.msi 导致无法安装新版本3
#958Opencode 已安装，但在 cc switch 中不显示2
#6111[Bug] skills.sh 安装嵌套目录 Skill 后详情链接丢失真实路径并返回 4042
#474[Bug] 从测试版降级到稳定版时应用崩溃，数据库版本不兼容缺乏友好提示1
#3328v3.16.0 版本在 codex 使用外部 api 启用远程压缩报错1
#5119deepseek-v4-flash 报错：Invalid schema for function 'codex_app__automation_update'1
#5370[Bug] macOS + NVM: Claude update fails with "env: node: No such file or directory"1
#6061[Bug] Windows in-app update relaunch loses User PATH, causing CLI detection to fail1

MCP and Skills3

#172MCP 不能手动修改吗？一直提示TOML 格式错误7
#993直接把skills放到.cc-switch下面，无法识别2
#1224claude code 插件在vscode中无法使用图片1

Launch and crashes2

#936闪退问题14
#34Arch linux下新建项目后卡死5

Terminal2

#3291WSL/WSLg 环境下打开“关于”页面后界面卡死，终端显示 Stopped7
#6409Wsl热切换失败 os error 501

UI and windows1

#1111在linux wayland桌面环境下，每次的首次启动缩放图标无法使用8

Usage and balance1

#1587V3.12.2版本对claude-4-6模型无法计费3

Other89

#1173阿里云 Coding plan 支持思考模式参数异常33
#6188原子替换失败: 不支持该请求。 (os error 50)21
#1484claude正常回复但是会报错Cannot read properties of undefined (reading 'output_tokens')16
#666■ unexpected status 413 Payload Too Large: Failed to buffer the request body: length limit exceeded, url: http://127.0.0.1:15721/v1/responses11
#2739API Error: 422 格式转换错误10
#489cc-switch shows "API Error: undefined is not an object (evaluating '_.text.trim')"9
#991Claude Rectifier 导致 Claude API thinking / signature 校验失败（HTTP 400）9
#3246[Bug] Claude Code 2.1.153 + DeepSeek V4 → 400 thinking mode error9
#2975claude code 通过 cc switch 访问openCode go 报错8
#4700codex无法正常使用8
#3142本地glm-5.1无法转换响应7
#130ubuntu 20.04无法使用6
#707遇到一个api报错，我不确定是否和本项目有关，大佬可以帮我看看吗6
#1881⎿ API Error: 400 {"error":{"code":400,"message":"System message must be at the beginning.","param":null,"type":"BadRequestError"}}6
#2600使用DeepSeek API报400错误6
#186CC-Switch-v3.6.0-Linux.AppImage start error5
#647PI Base URL 拼接路径冗余导致 404 错误 (ChatGLM/OpenAI 兼容接口)5
#1519Claude Code通过火山方舟接入doubao-seed-2.0-code 报错 API Error 400 invalid value: `document`5
#3219kimi for coding API Error: 400 thinking is enabled but reasoning_content is missing in assistant tool call message at index 25
#3313VScode接Claude Code，在cc接deepseek v4，开始还可以用，但突然写API Error: 400 Failed to deserialize the JSON body into the target type5
#4056Bug Report5
#630使用 claude-relay-service 的时候无法使用 cc switch4
#2012mac上无法使用codex4
#2837cc switch 调用 mimo给claude code使用，报400错误4
#2848DeepSeek 返回 Invalid schema: got 'type: null' 错误。4
#523测试失败:解析响应JSON失败:Exception generated by QuickJS3
#549ubunut 24.04 LTS claude code error3
#752使用Openrouter时报错403和4043
#830Error: v4/v1/message for ZAI3
#1268opencode addition failed3
#1433Claude code error，api提供方说是否支持aws Claude资源为什么偶尔调用成功偶尔会提示传参数报错3
#1477linuxbrew 本地环境检查异常3
#3056本地路由 API Error: 422 格式转换错误: Unable to resolve Gemini functionResponse.name3
#3227bypass permissions. Error: Permission mode couldn't be changed. You can try again3
#3280Deepseek/Mimo API Error: 400 Failed to deserialize the JSON body into the target type: messages[1].role: unknown variant `system`, expected `user` or `assistant` at line 1 column 132663
#4804用中转站bug3
#5365CC Switch V3.17.0 +Codex0.144.4 错误3
#15Groq is not working2
#343选择 codex offical 后使用 codex cli 会报错2
#906Claude Code 官方订阅无法进行可用性测试2
#939Claude Official 修改 .claude.json 时 tmp 文件因目录锁创建失败2
#1013[Bug] OpenAI 兼容模式强制拼接 /v1 路径，导致智谱 AI (GLM) 接口 4042
#1082使用百度千帆Coding Plan报错返回 API Error: 4222
#1845claude code无法使用qwen3.6-plus2
#1899google ai stadio api接入claude code失败2
#2620[Bug] Claude Code hangs on tool calls: SSE translation produces invalid JSON (Unrecognized token)2
#2676CCSwitch本地路由功能，该功能存在缺陷，开启后无法命中缓存，会导致流量暴增，部分用户消耗已暴涨十倍。2
#2851API Error: 400 The parameter `output_config.effort` specified in the request are not valid: expected `low`, `medium`, `high` or `max`, but got `xhigh` instead.2
#3305在claude code中使用deepseek出现API Error: 400 错误2
#3364Windows: CLI tools detected but cannot run due to quoted path escaping2
#3831Deepseek 400 error when using dynamic workflow2
#3863[BUG] GLM开启路由也无法正常使用.2
#4820[Bug] Misleading "context window exceeds limit (2013)" when attaching images > 10MB to Codex2
#6137[Bug] A valid empty CC Switch SQL export cannot be restored2
#272Error 71 (Protocol error) dispatching to Wayland display1
#515API Error: 4221
#575[Bug] 使用 Claude Code 连接 Google AI 时报错 400: function_declarations 参数缺少 items 字段定义1
#648# Bug Report: Cannot connect to local HTTP server (127.0.0.1)1
#907使用火山引擎报 404 错误1
#1109v3.10.3 not working in my Debian 11.111
#1220[Bug] Frequent tao library assertion failure flush_paint_messages on Windows1
#1719claude切换用不了1
#1909内嵌的BUN的BUG1
#1944Error Found version mismatched Tauri packages1
#2207Claude for Powerpoint 中CC-SWITCH 不能用。1
#2364🐛 Duplicate message_delta causes connection error with OpenRouter Chat Completions1
#2579bug king,bug everywhere,can't use.1
#2708数据库错误: Invalid column type Blob at index: 2, name: server_config1
#2838claude desktop报错：Claude Code couldn't start1
#3316claude code转发请求给gpt5.5时出现API Error: 400 Store must be set to false1
#3317在cc Switch接deepseek v4。开始还可以用，但在VScode里用着用着突然写API Error: 400 Failed to deserialize the JSON body into the target type: messages[1].role: unknown variant system, expected user or assistant at line 1 column 13211
#3483claude desktop + kimi-for-coding。报错：API Error: 400 thinking is enabled but reasoning_content is missing in assistant tool call message at index 3881
#3590退出codex再用cc switch链接报错1
#3622天翼云 codingplan套餐，接入Claude code，报错1
#3637英伟达ai无法接入1
#3663[Bug] DeepSeek V4 Pro/Kimi/Moonshot 调用含图片时返回 400 错误1
#37243.16.1 CODEX windows 下介入ds 后，无法使用1
#3951流式响应中 `choices:[]` 的 usage-only 尾包导致 422 错误1
#4185codex自定义 Chat Completions 报错1
#4225claude code cli 使用glm会出现重复请求；导致出现529错误1
#4230Codex GPT5.5 API Error: 400 Invalid JSON schema: regex lookaround is not supported. Found at $.properties.fileKey.pattern.1
#4574千问接入codex无法正常调用工具，如“联网搜索”1
#5025火山coding plan的GLM5.2在claude cdoe中发送图片直接报错响应4001
#5121Backend CI runs only on Linux — Windows/macOS breakage undetected (8 failing tests + clippy `-D warnings` error)1
#5275[Bug] Claude Code 经 Codex OAuth 将 Haiku 映射到 gpt-5.6-luna 时返回 4041
#5378bug(codex): standalone Web Search returns 404 because Alpha Search route is missing1
#5464[Bug] Linux/Wayland: window control buttons are not clickable until maximized1
#6129[Bug] Backup and sync follow-up audit finds fidelity and atomicity gaps1
#6140[Bug] grokbuild + zhipu/glm-5.2: 翻译回的 Responses usage 缺失 input_tokens_details → serialization error1

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.

Official site ccswitch.io
GitHub repository
Official downloads (Releases)