请求错误类问题

API Error 400

先重发一次请求，并删除非必要参数。客户端或插件可能生成了当前服务端不接受的请求体。

413 请求体过大

当前会话上下文过多时，请执行客户端提供的清理或压缩命令，或新建会话后重试。

400 Invalid model name

从 Yuan API 模型与价格页面复制模型 ID。不要使用拼写相近但服务端未开放的模型名。

401 Unauthorized

检查 Key、变量名称、Bearer 鉴权和最终请求地址。Claude Code 使用 ANTHROPIC_AUTH_TOKEN，Codex / OpenAI 使用 OPENAI_API_KEY。

429 Rate Limit / 额度耗尽

频率限制通常等待后恢复；额度不足需要登录控制台确认余额或用量。不要使用无上限重试。

Overloaded / 500 错误

可能是服务端或上游暂时过载。记录时间、模型和 request id，稍后重试；可以查看服务状态。

503 model_not_found

所选模型当前不可用、下线或模型 ID 错误。重新从模型页面选择当前开放的模型。

context window 超限

定期压缩上下文或开始新会话，避免单次请求积累过多历史内容。

Command timed out

如果是命令行工具等待 shell 命令超时，请先单独执行对应命令，确认本地命令是否卡住；这不一定是 API 请求问题。