更多已解决的问题
以下 234 个问题在 GitHub 上已经关闭并且有过讨论，但重复出现的次数不足以单独成页。这里只给原帖入口——本页不提供归纳过的解法，点进去看当事人的原始记录。
模型与切换41
- #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
配置与同步29
- #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
代理与网络23
- #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/responses19
- #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
登录与鉴权15
- #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
- #6688同一个Team里的两个账号，无法同时添加登录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
供应商管理13
- #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
- #5565[Bug] 阿里云 OSS 预设使用 Path-style URL，导致 S3 HEAD Bucket 返回 4032
- #464添加 openrouter ，返回Provider returned error1
- #1873Bug: Claude OpenAI-compatible providers force /v1 for custom base URLs1
安装与更新10
- #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 与 Skills3
启动与崩溃2
终端2
界面与窗口1
用量与余额1
其他94
- #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
- #6516Deepseek的max思考等级即使在ccswitch中启用却仍无法在codex desktop中生效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
- #5841[Bug] MiniMax-M3 built-in pricing uses the undiscounted rates2
- #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
- #6685[Bug] Claude Code 经 CC Switch 接 DashScope（OpenAI Responses 格式）时，多轮工具调用回放触发 `function_call.arguments Input should be a valid string` → “格式转换错误”1
- #6738[Bug] Codex OAuth accounts from same ChatGPT Team overwrite each other1
- #6899不支持 ChatGPT最新的 超快模式 cause: invalid service_tier "ultrafast"1
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。