Source: https://aiprimetech.io/zh/claude-code/errors/overloaded-529/

[首页](/zh/) › [Claude Code](/claude-code/zh/) › [错误](/zh/claude-code/errors/) › 过载 / 529

[概览](/claude-code/zh/)[安装](/claude-code/zh/install/)[CLI 参考文档](/zh/claude-code/cli/)[定价与限制](/claude-code/zh/pricing/)[Agent SDK](/zh/claude-code/sdk/)[技能与插件](/zh/claude-code/skills/)[GitHub](/zh/claude-code/github/)[网页、桌面与 IDE](/zh/claude-code/web-and-desktop/)[模型](/zh/claude-code/models/)[错误](/zh/claude-code/errors/)[是否开源？](/zh/claude-code/open-source/)[教程](/claude-code/zh/tutorial/)[学生指南](/zh/claude-code/for-students/)[QA 自动化](/zh/claude-code/qa-automation/)[与 Cursor 对比](/zh/claude-code/vs-cursor/)[与 Codex 和 OpenCode 对比](/zh/claude-code/vs-codex/)[子智能体](/zh/claude-code/subagents/)[钩子](/zh/claude-code/hooks/)[MCP](/zh/claude-code/mcp/)[生态系统](/zh/claude-code/ecosystem/)[VS Code](/zh/claude-code/vscode/)[OpenRouter](/zh/claude-code/openrouter/)[速率限制](/zh/claude-code/rate-limits/)[中文指南](/claude-code/zh/)

最后更新：2026 年 11 月

# Claude“过载”错误（API 错误 529）：含义及应对方法

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}} 表示模型正在运行，但目前没有容量处理你的请求。这不是对你账号的限制；使用该模型的所有人都会同时遇到它。解决方法在于合理等待，避免集中发送请求。

## TLDR
- 529 = 模型对所有人都已处于饱和状态。与你的密钥或套餐无关。
- Claude Code 会自动重试（“将在 N 秒后重试……第 x/10 次尝试”）；让它继续即可。
- 使用以下命令切换模型档位： /model ，往往能立即奏效；各模型的容量彼此独立。
- 同时启动大量子代理，会让 529 错误关联出现；请减少并行运行的数量。

## 你会看到什么 

```
API Error (529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}) · Retrying in 1 seconds… (attempt 1/10)
API Error (529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}) · Retrying in 2 seconds… (attempt 3/10)
```

这些内容来自 [#3572](https://github.com/anthropics/claude-code/issues/3572)，七月的那波 2025 讨论收到了 274 条评论——其中许多来自订阅 $200 Max 套餐的用户，这正说明了问题：529 关乎容量，更贵的订阅并不会为你预留容量。现在仍有人报告这一错误： [#91817](https://github.com/anthropics/claude-code/issues/91817) （“重试次数过多”）， [#91849](https://github.com/anthropics/claude-code/issues/91849) 和 [#91825](https://github.com/anthropics/claude-code/issues/91825) 均于 2026 年九月 3 日提交。 

## 发生原因 
- 某个模型的需求激增。 新版本发布时和美国工作日的上午是典型高峰期；最新的旗舰模型争用最为严重。
- 你自己的并行分发。 [#90043](https://github.com/anthropics/claude-code/issues/90043) 扫描了 60 天的会话记录，发现大多数 529 错误都是集中出现的：编排器同时启动 N 个智能体，它们同时请求 API，导致这一批任务中的大多数在同一分钟失败。
- 任务丢失。 [#89267](https://github.com/anthropics/claude-code/issues/89267) 以及一份相关报告指出，529 可能会终止后台子智能体，而不是重试——因此，突发请求不仅会拖慢进度，还会导致任务丢失。 

## 解决方法 
- 1. 让内置重试机制运行。 大多数 529 错误会在 10 次尝试内消失。
- 2. 切换模型档位： /model 当前步骤改用 Sonnet（或 Opus）；稍后再切回来。
- 3. 减少同时运行的子智能体数量 并错开并行任务的启动时间；大量同时发出的首次请求，正是让一次 529 变成十次的原因。
- 4. 重新运行被丢弃的子智能体 需明确执行——检查并行分发中的每个任务单元是否都已实际完成。
- 5. 大型任务安排在非高峰时段： 在美国工作时间以外，长时间自主运行的任务遇到容量瓶颈的可能性要低得多。 

## 529、500 与 429 的区别 
- 529 过载 ——容量问题，影响所有人，属于暂时情况。等待或切换模型。
- 500 ——服务器故障。参见 [API 错误 500](/zh/claude-code/errors/api-error-500/).
- 429 ——你自己的限额（请求数、令牌数、并发数）。参见 [速率限制](/zh/claude-code/rate-limits/). 

## 在此网关上 

网关会将流量分散到多个上游账户，并在遇到 529 时改用另一个账户重试，之后才会放弃，因此单个账户达到容量上限不会中断你的会话。当某个模型的所有上游都达到容量上限时，你仍会看到此错误——使用以下命令选择其他档位： /model。配置方式一如既往： ANTHROPIC_BASE_URL=https://aiprimetech.io 以及一个网关密钥。

## 厌倦了与这个问题反复较劲？

改为通过 AI Prime Tech 网关运行 Claude Code：使用相同的 Claude 模型，由网关自己的上游账户提供服务，设置两个环境变量即可切换，新账户可获得 $5 免费 API 额度 使用优惠码 FIXIT — 无需银行卡。

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[使用优惠码 FIXIT 创建账户](/register?promo=FIXIT)

## 常见问题

Claude 过载错误是什么意思？

模型在那一刻没有空余容量（HTTP 529，overloaded_error）。它会影响使用该模型的所有人，并会自行消失。如何修复 Claude API 错误 529？

让 Claude Code 重试，使用 /model 切换模型档位，并减少并行运行的子智能体数量。大型任务应选择非高峰时段。订阅 Max 能避免过载错误吗？

不能。529 关乎容量，而非套餐限额——Max 用户报告此错误的频率与其他用户一样。

## 通过网关运行 Claude Code

相同的模型，两个环境变量，面值 7.69231 倍的额度，或固定费率不限量方案。 新账户：使用优惠码 FIXIT 可获得 $5 免费 API 额度。[获取 API 密钥](/register?promo=FIXIT) [查看不限量方案](/zh/plans/)

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，也未获得其认可或赞助。“Claude”和“Claude Code”是 Anthropic 的商标。此处介绍的 Claude Code 功能以撰写时 Anthropic 的公开文档为依据，且经常发生变化；本页面的价格和模型列表读取自此网关的实时设置。

## 更多 Claude Code 指南

[Claude Code 错误及修复方法](/zh/claude-code/errors/)[Claude Code“API 错误：500”：含义及真正有效的修复方法](/zh/claude-code/errors/api-error-500/)[Claude Code API 错误 400：提示词过长、工具使用并发问题及其他错误](/zh/claude-code/errors/api-error-400/)[Claude Code OAuth 错误：超出 15000ms 超时时限，以及状态码 500](/zh/claude-code/errors/oauth-error/)[“Claude Code 进程退出，退出码为 1”：如何找到真正的错误并修复](/zh/claude-code/errors/process-exited-code-1/)[Claude“提示词过长”“输入对于请求的模型而言过长”和“已达到上下文上限”：什么占满了窗口，以及如何释放空间](/zh/claude-code/errors/prompt-too-long/)[已达到 Claude 使用上限：会话、每周和 Opus 上限、“指定的 API 使用上限”、“额度余额过低” — 以及应对方法](/zh/claude-code/errors/usage-limit-reached/)[Claude Code 401 和 403：身份验证凭据无效、API 密钥无效、“未登录”、host_not_allowed](/zh/claude-code/errors/auth-401-403/)[Claude Code 连接错误：ECONNRESET、响应中途连接丢失、“正在等待 API 响应”、“无法连接到 API”、SSL 证书错误](/zh/claude-code/errors/connection-lost/)[Claude Code 挂起、卡住或停止响应：如何定位卡住的位置并恢复](/zh/claude-code/errors/claude-code-hangs/)[Claude.ai 无法正常使用：“出了点问题”、容量限制、“已达到 5 小时上限”、“登录时出错”及其他问题](/zh/claude-code/errors/claude-ai-not-working/)