请求错误类问题

请求返回 400，与内容无关

现象：使用 AWS 分组时返回 400，日志含 invalid beta flag，新建对话后依然复现。

原因：Claude Code 自动附加实验性 Beta 请求头（anthropic-beta），部分 AWS 分组上游不支持该请求头。

修复：先用环境变量确认问题：

# Mac / Linux
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
claude

# Windows PowerShell
$env:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS = "1"
claude

确认有效后写入全局配置文件 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的请求地址",
    "ANTHROPIC_API_KEY": "sk-***",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

保存后彻底关闭终端窗口再重新打开。

API Error 400（非内容原因）

原因：Claude Code 本身 bug 导致请求体格式异常。

修复：重发请求或执行 /compact 后通常恢复。

413 请求体过大

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

原因：当前会话上下文 token 过多，请求体超过服务端最大体积限制。

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

预防：长任务中定期执行 /compact。

400 Invalid model name

现象：API Error: 400 Invalid model name，使用 Opus 模型时出现。

原因：Opus 并发配额不足，服务端降级拒绝。

修复：无需修改配置，稍等片刻后重试即可。不要反复修改配置浪费排查时间。

429 Rate Limit / 额度耗尽

429 有两种子类型，处理方式完全不同：

• rate_limit_error：短时间请求过于频繁，等待后自动恢复
• insufficient_quota：当月额度已耗尽，必须充值或等下月重置

判断方法：前往 https://你的请求地址 查看余额：

• 用量未耗尽 → 频率限制，等待或降低并发
• 用量已归零 → 额度耗尽，前往充值

Overloaded / 500 错误

原因：官方服务过载或故障。

修复：访问 status.anthropic.com 确认服务状态，等待恢复即可。

API Error: response exceeded the 32000

原因：单次回复超出默认输出 token 上限。

修复：在 ~/.claude/settings.json 的 env 中设置：

"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000"

503 model_not_found

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

修复：使用 /model 命令切换到其他可用模型，或联系服务提供方确认模型可用性。

context window 超限，对话被截断

原因：单次会话积累 token 过多，未及时 /compact 或新开会话。

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

Command timed out after 2m 0.0s

原因：Claude Code 等待 shell 命令返回超时，与 API 请求无关。

修复：手动在终端执行对应命令查看卡在哪里。