Appearance
常见报错排查
先看报错里的状态码,点下面对应的数字跳过去。没有状态码的情况(超时、能回复但没记录、改了不生效)在后半部分。
400:请求参数无效
| 报错 | 意思 | 处理方式 |
|---|---|---|
400 · 上下文过长 / token 超限 | 一次发送的内容超过了模型上限 | 新开一个对话,少带几个文件;长对话先让客户端总结再继续 |
400 · 协议不匹配 / 不支持 Responses | 客户端协议和地址对不上 | 不要自己改地址路径,复制 使用密钥 弹窗里对应客户端的配置 |
400 · 其它参数错误 | 模型名、参数或客户端版本不兼容 | 确认模型名来自弹窗;把客户端升级到最新版再试 |
401:Key 无效或没带
| 报错 | 意思 | 处理方式 |
|---|---|---|
401 · Invalid API key | Key 错误、不完整、被删除或被禁用 | 重新复制 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 | 分组里可用账号暂时耗尽 | 稍后重试;持续出现请联系 售后 |
超时、一直转圈
没有状态码、一直在等:
- 确认电脑能打开 www.dcbot.online。
- 暂时关掉可能拦截请求的代理、VPN 或安全软件再试。
- 长上下文、复杂任务本来就慢,别连续点发送,重复请求会撞上
429。
能回复但没有使用记录
这是最常见、也最容易被忽略的情况。 客户端能正常对话,但站内 使用记录 里没有这次调用,说明请求根本没有到达 爱鹿 Plan,而是走了别的地方。
按顺序检查:
- 是不是还在用官方账号登录? 很多客户端同时支持官方登录和自定义接入,官方登录优先。
- Claude Code:运行
claude auth status查看,需要时claude auth logout。 - Codex / VS Code 插件:退出官方账号登录。
- Claude Code:运行
- CCSwitch 里生效的是不是 爱鹿 Plan? 只有显示 使用中 的那条才生效,见 CCSwitch 接入。
- 变量名对不对? Claude Code 读的是
ANTHROPIC_BASE_URL,不是OPENAI_BASE_URL。 - 重启了吗? 见下一节。
改了配置不生效
多数客户端只在启动时读一次配置。改完配置或在 CCSwitch 切换之后:
- 终端客户端:关掉这个终端窗口,新开一个再启动。
- VS Code 插件:执行 重新加载窗口(Ctrl/Cmd + Shift + P →
Reload Window)。 - 桌面端(如 Codex 桌面版):完全退出(包括托盘图标)再重新打开。
CCSwitch 导入失败
| 现象 | 处理方式 |
|---|---|
| 点 导入到 CCS 没反应 | 用 Google Chrome 打开站点;确认 CCSwitch 已安装并打开过一次 |
| 提示「CC-Switch 未安装或协议处理程序未注册」 | 确认已安装并打开过一次;Windows 用 .msi 安装包重装,它会注册 ccswitch:// 协议 |
| 导入成功但不生效 | CCSwitch 里点击 启用,直到 爱鹿 Plan 显示 使用中 |
| 一直导入失败 | 在 CCSwitch 里 手动添加 |
建议的排查顺序
- 站内余额或订阅是否正常。
- Key 是否存在、已启用、绑定了正确的分组。
- 客户端里的地址和 Key 是否正确(注意
/v1)。 - 客户端是否已经重启。
- 发一次测试请求,看 使用记录 有没有出现。
联系售后时带上什么
带上这些信息能更快定位:
- 操作系统、客户端名称和版本(如 Codex 0.160.0、CCSwitch 3.x)。
- 出错的时间、模型名、完整状态码和报错文字。
- Key 的名称。
不要发完整 API Key,截图里的 Key、余额和导入链接请打码。联系方式见 售后与联系。