Skip to content

疑难解答 ​

汇总 Claude Code、Codex CLI、OpenClaw 以及各类第三方客户端在接入过程中的高频问题与报错处理方案。按大类分页维护,点击进入对应分类:

排查前先做两件事

  1. 确认是不是普遍问题:先看群里有没有大面积反馈。如果没人反馈,基本可以判断是本机配置或网络问题。
  2. 确认余额和令牌状态:前往 控制台 查看令牌是否有效、额度是否充足。很多「报错」本质上是额度耗尽或令牌过期。

按报错信息速查 ​

终端或客户端里看到下面这些字样,直接点进对应的解决办法:

报错 / 现象解决办法
API Error 400(提问内容没问题)400 非内容原因
400 Invalid model name模型名写错
401 Invalid API Key / 无效令牌Claude Code 401 · Codex 401
401 Invalid API Key format令牌里混入了不可见字符
403 Missing API Key配置冲突
403 block / 403 Forbidden第三方客户端外接被拦 · OpenClaw
413 请求体过大413 请求体过大
429 限流 / 额度耗尽429 限流
Overloaded / 500上游繁忙
503 model_not_found分组里没有该模型
Unable to connect to Anthropic services首次启动连不上
response exceeded the 32000输出超长
context window 超限、对话被截断上下文超限
Command timed out after 2m命令超时
Selected model is at capacityCodex 模型容量满
Image generation is not enabled for this groupCodex 画图未开启
Codex 卡在 ReconnectingReconnecting 自恢复
连接超时、请求一直转圈换备用域名

通用排障清单 ​

不确定问题属于哪一类时,按这个顺序过一遍,能解决大部分情况:

  1. 确认令牌分组与所用模型匹配(Claude 模型用 Claude 分组,GPT 模型用 Codex 分组)
  2. 确认 Base URL 写法正确:Claude 类接入不带 /v1,Codex / OpenAI 兼容类接入带 /v1
  3. 检查系统环境变量是否残留了旧服务的配置(Windows:Win + R → sysdm.cpl;macOS / Linux:查看 ~/.zshrc 或 ~/.bashrc)
  4. 检查 ~/.claude.json 是否有官网 OAuth 登录残留(执行 claude auth logout 清除)
  5. 用 cc-switch 重新写入一次配置,然后完全关闭终端窗口再打开(不是新建标签页)
  6. 换个网络环境再试一次(详见网络与连接问题)

走完还是没解决,按售后与反馈里的三要素进群或提工单,别只说「用不了」。