Skip to content

常见报错排查 ​

先看报错里的状态码,点下面对应的数字跳过去。没有状态码的情况(超时、能回复但没记录、改了不生效)在后半部分。

  1. 400 参数错误
  2. 401 Key 无效
  3. 403 余额或权限
  4. 404 路径或模型
  5. 429 太频繁
  6. 5xx 上游异常

400:请求参数无效 ​

报错意思处理方式
400 · 上下文过长 / token 超限一次发送的内容超过了模型上限新开一个对话,少带几个文件;长对话先让客户端总结再继续
400 · 协议不匹配 / 不支持 Responses客户端协议和地址对不上不要自己改地址路径,复制 使用密钥 弹窗里对应客户端的配置
400 · 其它参数错误模型名、参数或客户端版本不兼容确认模型名来自弹窗;把客户端升级到最新版再试

401:Key 无效或没带 ​

报错意思处理方式
401 · Invalid API keyKey 错误、不完整、被删除或被禁用重新复制 Key,检查前后有没有空格;必要时新建一个
401 · API_KEY_REQUIRED / API key is required请求里没带 Key检查 Key 是否填进了正确的字段,见各客户端教程

Claude Code 报 401 时,还要确认变量名是 ANTHROPIC_AUTH_TOKEN,不是 OPENAI_ 开头。

403:余额、订阅或分组权限 ​

报错意思处理方式
403 · INSUFFICIENT_BALANCE / 余额不足账户余额用完了到 充值/订阅 充值,到账后立即恢复
403 · 订阅已到期订阅过期续费,或把 Key 换到余额分组
403 · 本周期额度已用完订阅的周期额度用完了等周期重置,或把 Key 换到余额分组
403 · restricted to Claude Code clients这个分组只允许 Claude Code 使用用 Claude Code 访问,或换一个 Key 分组

为什么余额不足是 403

爱鹿 Plan 用 403 表示计费相关的拒绝(余额、订阅、额度),不是 402。余额不足时报错码是 INSUFFICIENT_BALANCE。看到 403 时,先读报错里的中文提示。

404:路径或模型不存在 ​

报错意思处理方式
404 · model_not_found当前分组里没有这个模型换成分组支持的模型名,或调整 Key 分组,见 模型与分组
404 · 路径错误地址末尾的 /v1 加多了或加少了对照 接入地址怎么填 改正

最常见的是 Claude Code 的 ANTHROPIC_BASE_URL 末尾多加了 /v1。

429:请求太频繁或超出用量 ​

报错意思处理方式
429 · Concurrency limit / Too many pending requests同时发出的请求太多稍等几秒重试;多数客户端会自动退避
429 · rate_limit_exceeded触发了日 / 周 / 月用量上限等窗口重置,报错里通常带有重置时间

多个客户端共用一个 Key 更容易撞上并发限制,建议每个客户端单独建一个 Key。

5xx:上游暂时异常 ​

报错意思处理方式
502 / 524上游暂时繁忙或响应慢等几分钟重试;长时间持续请联系 售后
503 · No available accounts分组里可用账号暂时耗尽稍后重试;持续出现请联系 售后

超时、一直转圈 ​

没有状态码、一直在等:

  1. 确认电脑能打开 www.dcbot.online。
  2. 暂时关掉可能拦截请求的代理、VPN 或安全软件再试。
  3. 长上下文、复杂任务本来就慢,别连续点发送,重复请求会撞上 429。

能回复但没有使用记录 ​

这是最常见、也最容易被忽略的情况。 客户端能正常对话,但站内 使用记录 里没有这次调用,说明请求根本没有到达 爱鹿 Plan,而是走了别的地方。

按顺序检查:

  1. 是不是还在用官方账号登录? 很多客户端同时支持官方登录和自定义接入,官方登录优先。
    • Claude Code:运行 claude auth status 查看,需要时 claude auth logout。
    • Codex / VS Code 插件:退出官方账号登录。
  2. CCSwitch 里生效的是不是 爱鹿 Plan? 只有显示 使用中 的那条才生效,见 CCSwitch 接入。
  3. 变量名对不对? Claude Code 读的是 ANTHROPIC_BASE_URL,不是 OPENAI_BASE_URL。
  4. 重启了吗? 见下一节。

改了配置不生效 ​

多数客户端只在启动时读一次配置。改完配置或在 CCSwitch 切换之后:

  • 终端客户端:关掉这个终端窗口,新开一个再启动。
  • VS Code 插件:执行 重新加载窗口(Ctrl/Cmd + Shift + P → Reload Window)。
  • 桌面端(如 Codex 桌面版):完全退出(包括托盘图标)再重新打开。

CCSwitch 导入失败 ​

现象处理方式
点 导入到 CCS 没反应用 Google Chrome 打开站点;确认 CCSwitch 已安装并打开过一次
提示「CC-Switch 未安装或协议处理程序未注册」确认已安装并打开过一次;Windows 用 .msi 安装包重装,它会注册 ccswitch:// 协议
导入成功但不生效CCSwitch 里点击 启用,直到 爱鹿 Plan 显示 使用中
一直导入失败在 CCSwitch 里 手动添加

建议的排查顺序 ​

  1. 站内余额或订阅是否正常。
  2. Key 是否存在、已启用、绑定了正确的分组。
  3. 客户端里的地址和 Key 是否正确(注意 /v1)。
  4. 客户端是否已经重启。
  5. 发一次测试请求,看 使用记录 有没有出现。

联系售后时带上什么 ​

带上这些信息能更快定位:

  • 操作系统、客户端名称和版本(如 Codex 0.160.0、CCSwitch 3.x)。
  • 出错的时间、模型名、完整状态码和报错文字。
  • Key 的名称。

不要发完整 API Key,截图里的 Key、余额和导入链接请打码。联系方式见 售后与联系。