在 CCSwitch / 多模型调度里,最诡异的现象就是:GPT 模型一切正常,ClaudeCode、Codex 却怎么都调不起来

报错现象

  • GPT 系列模型调用正常
  • ClaudeCode、Codex 模型调用失败 / 返回错误
  • 报错信息集中在「协议不匹配」「无法连接」这类

原因分析

这俩模型对协议的要求不一样:

模型协议适配说明
Codex原生适配 OpenAI 协议可以直接按 OpenAI 兼容方式调用
Claude 系列需单独适配中转协议原生 Anthropic 协议国内无法直连,必须经中转转换

所以不是模型没配,而是 Claude 系列没走对协议通道

解决步骤

把 Claude 系列模型封装为 OpenAI 兼容中转接口后再填入配置

  1. 在中转服务商处确认「Claude 系列」的模型 id 和调用端点(通常和 OpenAI 兼容端点不同)
  2. 把 Claude 模型挂到 OpenAI 兼容接口下(中转服务商一般提供这类转换)
  3. 配置里填入转换后的地址 + Claude 模型 id,不要直接填 Anthropic 原生地址
# 错误:直接在 ClaudeCode 里填 Anthropic 原生协议
# 正确:在中转服务商封装成 OpenAI 兼容接口后,再填到 CCSwitch
Base URL: https://中转地址/v1
Model:    claude-...(中转商给的 id)

效果验证

  • ClaudeCode 能正常调用
  • Codex 仍按 OpenAI 协议正常工作
  • 三套模型(GPT / Claude / Codex)在 CCSwitch 里并存可切

排错速查表

现象处理
只有 Claude 系列失败走 OpenAI 兼容中转封装
Codex 失败确认走的是 OpenAI 协议
都不行回到「协议混用」那篇检查

核心经验:「GPT 能用、Claude 不能用」不是模型问题,是协议问题。Claude 系列在国内的标配姿势是「封装成 OpenAI 兼容再接入」。