[SRV-006] connection error: connection error cc-switch
Quick fix
升级 cc-switch 至 v3.16.4,修复了自定义 provider 接入 DeepSeek 时代理转发断连及历史计费错误回退到请求模型的问题。
Symptom
Section titled “Symptom”[2026-06-05][10:54:36][DEBUG][cc_switch_lib::proxy::server] [SRV-006] connection error: connection error在 v3.16.1 等早期版本中,Claude Code 接入自定义 DeepSeek 模型时,代理转发与流式处理逻辑存在稳健性缺陷,导致长文本生成中途发生传输层断连并抛出 `[SRV-006] connection error`。同时,历史成本回填逻辑 `get_log_model_pricing_cached` 在处理非标准日期格式的模型名称(如 `deepseek-v4-pro-202606`)时,会因 `trip_model_date_suffix` 清洗匹配失败,静默回退到请求模型(如 Claude Opus)进行计费,导致成本被错误放大。
这些问题均在 v3.16.4 中得到修复。新版本改进了流式处理的断连检测,并引入了按真实上游模型计费(schema v11),在转发时捕获真实出站模型写入日志,彻底解决了别名匹配失败导致的计费回退问题。
升级 cc-switch 至 v3.16.4 或更高版本,以应用代理转发稳健性改进及真实上游模型计费逻辑。
若历史统计中已产生因模型别名匹配失败导致的错误计费数据,需手动修复 `proxy_request_logs` 数据库表中的受影响行。
Affected Versions
Section titled “Affected Versions”ToolClaude Code
Version3.15.0 - 3.16.2
PlatformsmacOSWindows
Source Issues
Section titled “Source Issues”本页汇总自 5 个真实 issue
- 为什么开启本地路由后,选择的 DeepSeek 模型保存后变成了 claude-* 模型?
- 这是本地路由的正常行为。开启后 cc-switch 会将请求模型(如 sonnet、opus)转化为对应的期望模型,以兼容不支持 `/v1/messages` 的接口。若无需此功能可关闭本地路由。
- 配置了 DeepSeek V4 Pro,为什么日志显示始终使用 v4-flash?
- 通常是因为填写的模型名称存在大小写等非法格式,导致 DeepSeek 服务器判断不匹配并 fallback 到 v4-flash。请确保使用官方合法的模型 ID。
- DeepSeek V4 支持 reasoning_effort 参数,为什么在 Claude Desktop 配置后无法透传?
- 目前 cc-switch 的 `supports_reasoning_effort` 列表未包含 DeepSeek 模型,导致该参数被丢弃。此问题已记录,后续版本可能会支持透传或允许用户自定义配置。
cc-switch DeepSeek 用量统计不准/余额查询失败升级到 v3.19.2 并重建 Codex 用量;余额查询需正确填写 {{apiKey}} 或代理。Claude Desktop 模式下代理接管 Claude 开关无法勾选在 claude-desktop 模式下,设置页的“应用接管”区域硬编码显示的是 Claude Code (claude) 开关,而非 Claude Desktop (claude-desktop) 开关,导致点击无反应或报错。Codex 开启代理后 apply_patch 工具不可用升级到 cc-switch v3.16.2 或更高版本;若使用中转站,请确保后台模型与 Codex 期望模型匹配,否则开启路由可能导致工具调用失败。
这是一个非官方社区 wiki,与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。