服务器错误与用量限制

错误消息的措辞和版本要求随发布变化，以官方为准。看到这里的任何错误时，Claude Code 已经做过适用于该失败的重试（见总览里的自动重试）。

服务器错误

多数来自推理服务商：Anthropic API 上是 Anthropic 的服务，Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry 或自定义网关上是各自端点背后的服务。其中「auto mode 无法判断安全性」和「子智能体因 API 错误提前终止」也可能源于你这一侧（比如无权调用分类器模型的 Bedrock 账号，或触及用量限制的子智能体）。

API Error: 500 Internal server error

对任何 5xx 响应，Claude Code 都显示状态码和 API 的错误消息；末尾那句告诉你到哪里查服务状态，随服务商而变。怎么办：查 status.claude.com（或消息里指明的服务商状态页）有没有进行中的事故；等一分钟再重发（原消息仍在对话里，长提示可以直接输入 try again 而不必重新粘贴）；持续出现且没有公布的事故时，运行 /feedback 让 Anthropic 用请求详情排查（/feedback 不可用时见「上报错误」）。

API Error: Repeated 529 Overloaded errors

API 暂时对所有用户都处于容量上限，Claude Code 已重试多次。529 不是你的用量限制，也不计入配额。怎么办：查容量通知；几分钟后再试；运行 /model 换一个模型继续工作，因为容量是按模型统计的——某个模型负载特别高时 Claude Code 会提示你这么做（如 Opus is experiencing high load, please use /model to switch to Sonnet，Fable 模型则点名 Fable）。

Request timed out

API 在连接期限内没有响应，可能出现在高负载或模型生成很大响应时；默认请求超时 10 分钟。怎么办：重试；慢网络或代理导致时调大 API_TIMEOUT_MS；网络本身健康却频繁超时，见网络与请求错误。

No response from API

Claude Code 发出流式请求，API 在「首字节」期限内没有返回任何响应头，Claude Code 就中止请求，而不是等满整个 API_TIMEOUT_MS（默认 10 分钟），预算允许时最多重发一次。怎么办：再发一次消息；重复出现就按网络或代理问题处理；代理或网关把响应攒到完成才放出时，调大 API_TIMEOUT_MS 让重试等得更久，Bedrock 上同时调大 CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS；第一次总是超时、重试却成功时也调大它。

The response above may be incomplete

流式请求在响应进行中失败，此时 Claude 已完成了一段文本或工具调用，或在思考结束后开始了一个。重新发送请求可能把同样的工具调用执行两次，所以 Claude Code 保留 Claude 已完成的输出，并追加这条提示，而不是丢弃。怎么办：交互会话里读屏幕上保留下来的回复——Claude Code 保留错误之前 Claude 完成的每个块，但在回合结束时丢弃被打断的最后一块，所以最后几句或工具调用可能缺失；回复 continue 让 Claude 从它最后完成的块接着做。非交互（-p）模式下，默认文本输出会打印它仍持有的最后一个完成的文本块，再跟这条消息；其他输出格式见官方说明。

Auto mode cannot determine the safety of an action

auto 模式用来分类动作的模型没能给出决定，所以 auto 模式没有自动批准该动作；你看到的消息取决于分类器怎么失败。在工作目录内的读取、搜索和编辑跳过分类器，所以这些情形下仍可工作。怎么办：几秒后重试（Claude 看到同样的消息，通常会自己重试；瞬时失败与 auto 模式资格无关，不需要改设置）；重试一直失败就先做只读任务、稍后再回到被阻止的动作；Bedrock 上若每次重试都出现，检查你的账号能否调用消息里点名的模型（标准 Bedrock 模型确认 IAM 策略允许调用，Mantle 模型 ID 则联系 AWS 账号团队）。

The server returned no safety verdict

在服务端分类器评审下，服务器对某动作没有给出判决时 auto 模式会拒绝它；能确定类别时拒绝信息会在括号里点名，如 (timed out)；其余部分告诉 Claude 一次重试是否有帮助。怎么办：再发一条消息让 Claude 重试（计数重新开始）；停止反复出现且请求经过 LLM 网关或代理时，检查它是否把流式响应截短或改写了（服务端分类器评审和网关兼容指南说明哪些网关行为会造成拒绝，以及应原样透传什么）；启动前设置 CLAUDE_CODE_AUTO_MODE_SERVER=0 改用 Claude Code 自己的分类器请求。

Agent terminated early due to an API error

子智能体的 API 请求终端性失败（如触及用量限制，或服务器错误的重试用尽），所以它在完成任务前停止；需要 v2.1.199 或更高（更早的版本把 API 错误文本当作子智能体的结果返回给 Claude）。怎么办：把冒号之后的错误详情对应到本页相应章节（如用量限制或服务器错误）并按那里的步骤处理；底层错误清除后，让 Claude 重试任务或恢复该子智能体。前台子智能体已产出文本输出时被限流、过载或服务器错误打断，Claude 收到的是标记为不完整的部分输出，而不是这条错误；只产出了工具调用的子智能体也会得到这条错误。

用量限制

本节多数错误表示你账号或方案的配额已用完，但三个不同：Server is temporarily limiting requests 是与方案配额无关的服务端节流；Usage credits required for 1M context 是权益检查而非配额耗尽；The prompt to confirm went unanswered 是用量额度同意提示无人应答就关闭。

You've hit your session limit（及 weekly / Opus / Sonnet limit）

订阅方案含有滚动的用量额度，用完时会看到 You've hit your session limit · resets 3:45pm、You've hit your weekly limit · resets Mon 12:00am、You've hit your Opus limit、You've hit your Sonnet limit 之一。Claude Code 会阻止后续请求直到消息里显示的重置时间。session 和 weekly 限制在所有模型间共享，换模型不能恢复访问；Opus 和 Sonnet 限制只作用于该模型系列的请求，用 /model 切到系列之外的模型可继续工作（每个模型有自己的提示缓存，所以下一个请求会无缓存命中地重读整个对话）。用量同时计入 session 和 weekly 额度，一次高强度活动（如大规模工作流扇出）可能在 session 窗口重置前就耗尽 weekly 额度。用 claude.ai 订阅登录的交互会话里，Claude Code 还可以在会话里等待并在重置后不久继续被中断的任务（底部显示 Usage limit reached · continuing automatically at 3:45pm · esc to cancel，在空提示符处按 Esc 取消等待；v2.1.234 之前没有此功能；/config 里有「Continue automatically at usage limit」开关）。怎么办：等重置时间；桌面应用 Code 标签页的 session 限制卡片有「Auto-continue when limits reset」复选框（weekly 卡片没有，它与 CLI 设置是两个独立开关）；/usage 查看方案限制和重置时间；/usage-credits 在 Pro 和 Max 上购买额外用量，或在 Team 和 Enterprise 上向管理员申请；升级方案获得更高基础额度。限制用完之前 Claude Code 可能警告你已用掉大部分（如 You've used 85% of your session limit · resets 3:45pm），也可以在自定义状态栏里加上 rate_limits 字段持续观察剩余额度。

Usage credits required for 1M context

所选模型使用 1M token 扩展上下文窗口，而你的方案只通过用量额度提供它。怎么办：运行 /model 选不带 [1m] 后缀的变体回到标准上下文窗口；消息点名 /usage-credits 时运行它，在 Pro 和 Max 上为 1M 变体开启按量计费，或在 Team 和 Enterprise 上向管理员申请用量额度，开启后按消息说的重启 Claude Code 或新开会话（在那之前会话保持标准上下文上限）；运行 /model 之后仍报错，可能是别处还设置了 1M 模型 ID。

The prompt to confirm went unanswered

账号要求 Fable 用量额度同意时，Claude Code 在 Fable 请求计入用量额度之前请你确认；确认提示在无人应答时关闭，Claude Code 就以这类消息结束该回合（消息点名会话的 Fable 模型）。怎么办：在会话运行的地方（终端或宿主应用）再发一个提示并在提示再次出现时回答；后台会话先从智能体视图附加进去（从 Remote Control 客户端重发会再次显示该消息，因为客户端不能显示提示）；运行 /model 切到不消耗用量额度的模型；想要更多时间就把 dialogExpiry 设得更长或设为 "never"；v2.1.236 之前没有这条消息。

Server is temporarily limiting requests

API 施加了与你方案配额无关的短暂节流；Claude Code 通过缺少真实限额响应携带的统一配额头来区分它。自 v2.1.199 起，不论你如何认证，都会带退避自动重试后才显示。怎么办：稍等再试；持续出现就查 status.claude.com。

Request rejected (429)

你触及了为你的 API Key、Bedrock 项目或 Google Cloud 项目配置的速率限制；末尾那句指向的服务状态页随服务商而变。怎么办：运行 /status 确认当前凭证是你预期的那个（环境里一个多余的 ANTHROPIC_API_KEY 会让请求经过低档 Key 而不是你的订阅）；到服务商控制台查看当前限制并按需申请更高档位；Anthropic API Key 见速率限制参考了解档位和按工作区的上限；降低并发——调低 CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY、避免同时运行很多并行子智能体，或换更小的模型。

Credit balance is too low

你的 Console 组织的预付额度用完了，或 Claude Code 在你想用订阅时却在用 Console API Key 发送请求。怎么办：有 Pro、Max、Team 或 Enterprise 方案却看到这条时，运行 /status 查看 API key 行——环境里被批准的 ANTHROPIC_API_KEY 会让请求走那个 Key 而不是订阅，在当前 shell 取消设置它并从 shell 配置里删除，重启 claude，还没用订阅登录就运行 /login；到 platform.claude.com/settings/billing 充值，并考虑在那里开启自动充值，让余额在归零前补满。

Could not update your spend limit

服务器拒绝了你从触及花费上限时的提示里做的花费上限修改。服务器解释了拒绝原因时消息以该原因结尾，用同样的值重试还会失败；失败没有服务器给出的原因（如连接断开）时显示通用形式。怎么办：消息含原因时选一个满足它的上限（如更低的金额）；只有通用形式就重试（可能是瞬时失败）；一直失败就在浏览器里从 claude.ai 账单设置里修改。