Deepseek ArtifactsDeepseek Artifacts
返回博客

Claude Code 挂了吗?30 秒查官方状态 + 529 报错自救

Claude Code 报错先别急着重装:30 秒查清是官方宕机还是本地问题,附 529 overloaded 自救清单、错峰时段分析和免费替代路线。

2026年10月11日

Agent 会话改到一半突然甩出 API Error: 529,终端卡死转圈——先别急着重装。**报错只有三类可能:Anthropic 官方故障、你的本地环境(网络/代理/版本/配额)、或者第三方中转站自己挂了。**三类问题的解法完全不同,猜错的代价是白折腾半小时。

本文是一份按顺序执行的排查清单,写于 2026 年 10 月 11 日——正赶上 529 overloaded 报错扎堆的一周,Claude Code 2.1.296(10 月 9 日发布)刚给这个报错加了官方退避开关。状态页结构当天核实过,实时以官方页面为准。

先说结论:30 秒确认官方状态

打开官方状态页 status.claude.com——国内网络直连大概率打不开,请在你平时跑 Claude Code 的网络环境里查,否则查到的不是答案。别看第三方「宕机检测」聚合站:全球性事故发生后,官方页面几分钟内就会挂出公告。

2026 年 10 月 11 日核实的页面结构:

  • 六个监控组件,各自独立亮灯:claude.ai、Claude Console、Claude API、Claude Code、Claude Cowork、Claude for Government。先看 Claude Code 那行;拿 API key 自己接应用的,再看 Claude API 那行。
  • 五级状态灯:Operational(正常)、Degraded Performance(性能降级)、Partial Outage(部分中断)、Major Outage(重大中断)、Maintenance(维护)。「能用但巨慢、偶尔报错」多半对应「性能降级」,别只盯着全绿。
  • 事故生命周期:Investigating → Identified → Monitoring → Resolved,带时间戳更新;看到 Monitoring 基本就是修复已上线。
  • Past Incidents 历史事故区:近 90 天逐日记录,支持 RSS/Atom 和邮件、短信、Slack、Teams、webhook 订阅——想知道何时恢复,在这页订阅最快。

一个必须建立的心智模型:状态页全绿 ≠ 没有 529。 状态页记录平台级事故,而 529 是单个模型的容量信号——一个模型挤爆了,页面照样绿。核实当天的历史事故区正是这种形态:10 月 6 日「Claude Opus 5.5 错误率升高」、10 月 5 日「Claude Mythos 5.1 与 Fable 5.1 错误率升高」,期间 Claude Code 组件大部分时间保持 Operational。

时效说明:以上结构核对于 2026-10-11,实时状态以官方页面为准,本文只是那页的阅读手册。

官方宕机还是你的问题?五步自检

前两步回答「是不是官方挂了」,后三步抓伪装成宕机的本地故障。中文用户还要多查一项:中转站。

1. 看组件行,别只看首页。 Claude Code 那行绿着而报错还在继续?基本是本地问题或单模型容量问题,不是宕机。

2. 读懂报错本身。 状态码就是诊断书:

报错含义该做什么
529 overloadedAnthropic 容量打满带退避重试,见下一节
429 rate limit你的账号触发限额查套餐用量,放慢请求节奏
401 / 权限错误认证问题重新登录,检查 ANTHROPIC_API_KEY
5xx / 连接被拒网络链路不通查代理、VPN、DNS,或真是事故

3. 查版本。 跑 claude --version,不是最新就 claude update——不少「挂了」的帖子最后是老版本里早就修掉的 bug。发稿时最新版是 2.1.296(2026 年 10 月 9 日),三个可自验的标记:新增 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS 环境变量(下节细说)、MCP server 描述上限从 2048 提到 4096、Sonnet 5.5 cache 读取从 $0.20 降到 $0.10 每百万 token。

4. 查网络链路——国内用户的重点。 代理节点差、TUN 分流规则不对、DNS 污染,症状和宕机一模一样:时好时坏、连接重置、流式响应中途断掉。换个节点跑同一个请求就能定案。用第三方中转 API 的还要加一步:看中转服务商自己的状态页——中转站挂了不归 Anthropic 管。

5. 查配额,再决定要不要愤怒。 限额用尽、key 欠费,报错经常被误报成「宕机」。先去 Console 看额度和限流;分不清套餐怎么计量的,这篇 Claude Code 用量限额有逐项拆解。

五步全过、状态页全绿、报错依旧?去 Claude Code 卡死排障接着往下挖。

529 overloaded 专项:本周的重点事件

这个月被发成「Claude Code 挂了」的帖子,大部分不是宕机,而是 529 overloaded:Anthropic 坦白告诉你,你要的模型此刻没有空余容量。不是封号、不是配置坏、通常也不是欠费——就是堵车,而且堵在可预测的时段(下节展开)。

它这周成为新闻的原因:**Claude Code 2.1.296(2026 年 10 月 9 日发布)**给这个报错加了官方旋钮,changelog 原文:

Added CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS environment variable to set a longer maximum delay for the backoff when retrying an overloaded (529) request.

实际含义:撞上 529 时,Claude Code 自动做指数退避重试,但旧的退避上限可能在容量恢复前就到顶——长时间运行的 agent 会话在拥堵十几分钟后直接死掉。这个变量把上限拉高,按毫秒设值:

export CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS=300000

无人值守任务建议写进 shell 配置。changelog 只给了变量名没给默认值,我们不替官方编数字。

泼盆冷水:变量让你等得起,不是凭空造容量,平台真被打满时解药只有时间。完整打法——529 对比 500/429、等待窗口策略、中途降档——见 Claude Code overloaded (529) 指南。

为什么 Claude Code 总是「挂」?三个规律

宕机并不随机,三个规律解释了大部分。以下读法来自官方状态页 90 天事故记录(2026 年 10 月 11 日时点)——所有例子都是官方页面自己记的。

规律一:美国工作时间 = 容量高压期。 对中文用户这是纯时区算术:美东 9:00–18:00 对应北京时间 21:00 到次日 6:00——你熬夜写代码的高峰恰是它容量最挤的时段;而你白天的工作时间(北京时间 9:00–18:00)是美国的深夜到清晨,负载相对松。529 扎堆在前一个窗口。

规律二:发布日拥堵。 新模型发布后的头几个小时会吸进需求洪峰。5.5 这一代连着发——Opus 5.5 在 9 月 22 日、Sonnet 5.5 在 9 月 28 日、Haiku 5.5 在 10 月 7 日——同一周的事故记录里躺着「Claude Opus 5.5 错误率升高」(10 月 6 日)和 Mythos/Fable 双模型事故(10 月 5 日)。我们不断言因果,只指出事实:拥堵的周和发布的周,是同样那些周。

规律三:单模型事故,主状态灯不红。 事故可以只砸中一个模型而 Claude Code 组件保持绿色。报错点名了具体模型时,最快的动作是去历史事故区搜模型名,或更直接——本会话降档到另一个模型,问题整个绕开。一句话总结:最难用的时段可预测——美国工作日、发布窗口、某个模型的倒霉日,都不需要状态页变红。

挂了怎么办:错峰、降档、免费路线

错峰,改的是作息不是期望。 把重的 agent 任务挪出美国 9-to-5,529 暴露率实打实地降。对中文用户反而是利好:北京时间白天干活正好避开美东高峰。

降模型档位。 拥堵通常按模型算。Opus 或 Sonnet 报 529 时,把机械性的活——可 review 的重构、可重跑的测试——丢给 Haiku 接着跑。各档位的完整账本在 Claude Code 订阅到底值不值。

账单和宕机都疼时,走免费路线。 Claude Code 只是个 harness,harness 可以指向别处。DeepSeek 提供 Anthropic 兼容端点,同一套 CLI、同一套肌肉记忆,接上就是另一个模型体系、按 token 计费——deepseek-flash 错峰输入每百万 token $0.15 起。换来的是可控账单和对 Anthropic 容量事件的免疫,代价是模型质量换了一代。对国内用户还有一层实际意义:DeepSeek API 网络可达性好得多,省掉代理变量。两个环境变量的接法见在 Claude Code 里用 DeepSeek。

顺带分清:慢不等于挂。 会话能跑完只是巨慢,那是限流、网络距离或长上下文税,解法在 Claude Code 变慢的原因与修复。

常见问题

怎么判断 Claude Code 现在是不是真的挂了?

唯一权威来源是 status.claude.com:先看 Claude Code 组件行,再看活跃事故列表。「现在挂了」通常是三种情况之一:美国高峰时段的单模型容量拥堵(表现为 529)、只砸中某个模型的事故(页面可能仍绿色)、或维护窗口。页面全绿但连不上,就回到五步自检——问题大概率在你这一侧或你的中转站。

是大家都挂了,还是只有我挂?

状态页 Claude Code 行变黄变红 = 大家都挂;401 认证错、429 限额错、换网络也不好的连接错误 = 只有你(或你的中转站)。529 特殊一些:容量满谁撞上谁疼,属于「大家一起疼」,但页面照样可以是绿的。

529 overloaded 到底是什么意思?

你要的模型此刻没有空余容量——拥堵信号,不是账号问题。Claude Code 会自动指数退避重试;从 2.1.296 起,可用 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS 环境变量调高退避延迟上限,让无人值守会话扛过更长的拥堵窗口。

官方状态页会显示 529 吗?

通常不会——这是状态页最被误解的一点。页面记录平台级组件事故,而 529 是按模型的容量信号,绝大多数时候够不上「事故」的登记标准。例外是拥堵严重到被官方立项,比如 2026 年 10 月 6 日那条「Claude Opus 5.5 错误率升高」。

延伸阅读