请求错误类问题

本页收录与 API 请求本身相关的报错，多数与上下文长度、限流和服务端状态有关，与配置无关。

API Error 400（非内容原因）

现象：请求返回 API Error: 400，但提问内容本身没有任何敏感或异常之处。

原因：客户端（尤其是 Claude Code）自身的 bug，导致发出的请求体格式异常。

修复：重发一次请求，或执行 /compact 压缩上下文后再发，通常即可恢复。

413 请求体过大

现象：API Error: 413 Request Entity Too Large。

原因：当前会话累积的上下文 token 过多，整个请求体超过了服务端允许的最大体积。

修复：执行 /clear 清空对话，或执行 /compact 压缩上下文（保留摘要），也可以退出后重新开一个会话。

预防：长任务过程中定期执行 /compact，不要在一个会话里连续做几个小时。

400 Invalid model name

现象：使用 Opus 等高端模型时返回 API Error: 400 Invalid model name。

原因：该模型当前并发配额不足，服务端拒绝了请求，并非模型名真的写错。

修复：不要改配置，等一会儿重试即可。反复修改配置只会浪费排查时间。

429 限流 / 额度耗尽

429 有两种子类型，处理方式完全不同，先看报错里的具体类型：

类型	含义	处理方式
rate_limit_error	短时间内请求过于频繁	等待片刻自动恢复，或降低并发
insufficient_quota	额度已耗尽	前往钱包与充值补充额度

判断方法：打开 控制台 查看余额：

• 额度还有 → 属于频率限制，等待或降低并发
• 额度已归零 → 属于额度耗尽，需要充值

Overloaded / 500 错误

原因：上游模型服务过载或故障，不是本站配置问题。

修复：稍等重试。Claude 类模型可访问 status.anthropic.com 确认官方服务状态，等恢复后即可正常使用。

503 model_not_found

原因：所选模型在当前渠道已下线或暂不可用。

修复：用 /model 命令切换到其他可用模型；可用模型以模型广场为准。

response exceeded the 32000

现象：API Error: response exceeded the 32000。

原因：单次回复的输出内容超过了默认输出 token 上限。

修复：在 ~/.claude/settings.json 的 env 中显式设置上限：

{
  "env": {
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000"
  }
}

context window 超限，对话被截断

原因：单个会话累积 token 过多，没有及时压缩或新开会话。

修复：执行 /compact 压缩上下文，或 /clear 开始新会话。

Command timed out after 2m 0.0s

原因：这是客户端等待 shell 命令返回超时，与 API 请求无关。

修复：手动在终端里执行那条命令，看它卡在哪一步。常见于等待用户输入的交互式命令。