Claude Code 问题排查
Claude Code 的排查重点是确认它是否拿到了 Claude / Anthropic 这一套配置。不要把 OpenAI 兼容地址、Codex 模型名或 Gemini Key 混到 Claude Code 里。
先确认什么
| 检查项 | 怎么看 | 为什么 |
|---|---|---|
| 目标工具 | 确认你排查的是 Claude Code，而不是 Codex 或 Gemini CLI | 不同工具的配置文件、协议和模型名不一样 |
| 服务商协议 | 后台或教程里明确写了 Claude、Anthropic、Claude Code | 只提供 OpenAI 兼容接口的服务商不一定支持 Claude Code |
| Key 类型 | 使用 Claude / Anthropic 对应 Key | Key 类型不对会直接 401 或鉴权失败 |
| 终端状态 | 切换配置后重新打开终端再测 | 旧终端可能还在使用切换前的环境变量或配置 |
常见报错
| 现象 | 优先检查 | 处理方法 |
|---|---|---|
| 命令能打开，但请求失败 | Claude Code 是否拿到新配置 | 关闭当前终端窗口后重新打开，再发最短测试问题。通过 CC-Switch 切换后，不要同时手动改同一份配置。 |
| 401 / Unauthorized | Key 类型和完整性 | 确认使用的是 Claude / Anthropic 对应 Key，不要把 OpenAI 兼容 Key 填到 Claude Code 里；重新复制时检查前后空格。 |
| 404 / model not found | Claude 模型名 | 按服务商后台 Claude 模型列表原样填写，大小写、短横线、版本号都不要改。 |
| 连接超时或无响应 | Claude Base URL | 回后台确认 Claude / Anthropic 接口地址；只给 OpenAI 兼容地址的服务商，不一定支持 Claude Code。 |
| 切换后仍走旧服务商 | 终端会话和配置来源 | 重开终端后再测；如果还不生效，确认 CC-Switch 当前 Provider 已应用到 Claude Code。 |
最小测试
测试时先发一句固定短问题，确认能返回后，再进入真实项目。
Claude Code 最小测试
claude "请只回复：Claude Code 配置测试成功"反馈模板
给服务商反馈时这样写
工具名称：Claude Code 系统版本： 服务商后台 Base URL： 模型 ID / 模型名： 报错原文： 我已经检查过：Key 没有空格 / 余额正常 / 模型名照抄 / Base URL 按后台填写 / 已经重开终端