全部指南

Claude Code 挂了吗？如何区分服务故障和本地问题

先查看 status.claude.com，再看错误信息：500、529 Overloaded、使用限制、429 或连接错误，各自的含义和处理方法。

基于版本
CLI
0.2.17
预览 ref
a2c45c8

简要回答

打开 status.claude.com。如果 Claude Code 或 API 有正在进行的事件，说明别人也用不了，办法就是等待。

如果状态页一切正常，就仔细看具体的错误。Anthropic 的错误参考把它们分成几类：

看到的提示通常意味着第一步
API Error: 500 Internal server error服务器端问题重试，然后查看状态页
API Error: Repeated 529 Overloaded errorsAPI 容量已满等待。不计入你的配额
Server is temporarily limiting requests (not your usage limit)服务器端的短暂限流稍等片刻
You've hit your session limit · resets …套餐的使用限制等待重置，或参阅限制指南
Request rejected (429)API 密钥或云项目的速率限制放慢速度，或提高上限
Unable to connect to API 及其变体网络、VPN、代理或 DNScurl -I https://api.anthropic.com

Claude Code 在显示错误之前，会对临时失败自动带退避重试最多 10 次，所以看到错误时，重试已经用完了。

问题

Claude Code 不再响应，或者任务中途出现红色错误。搜索“Claude Code 挂了吗”是很自然的反应，但很多时候服务本身没问题，原因在本地：使用限制、代理、VPN、登录过期。这两种情况的处理方式正好相反。等待修不好代理，重装也修不好服务故障。

第 1 步：查看 Claude 状态页

status.claude.com 列出 Claude 各项服务的事件，包括 Claude Code 使用的 API。Anthropic 的错误信息也会指向这里。从 v2.1.198 起，当原因是 529 过载时，重试倒计时会写明去哪里查看状态。

如果你使用 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或网关，错误中会显示该提供商或主机的名称。请查看那个提供商的状态页，而不是 Anthropic 的。

第 2 步：阅读错误信息

API Error: 500 Internal server error

Anthropic 将其描述为服务器端问题，通常是暂时的。稍后再试。如果持续出现，查看状态页。

API Error: Repeated 529 Overloaded errors

API 容量已满。Anthropic 的参考说明，529 不是你的使用限制，也不计入你的配额。Opus is experiencing high load 这类消息属于同一类。在负载回落之前，用 /model 切换到其他模型可以继续工作。

Server is temporarily limiting requests (not your usage limit)

与套餐无关的短暂限流。从 v2.1.199 起，Claude Code 会在显示之前自动重试。稍等片刻再试。

You've hit your session limit 或 weekly limit

这不是服务故障。你的套餐额度用完了，消息中写明了重置时间。参阅 Claude Code 用量何时重置？和达到限制后怎么办。

Request rejected (429)

你达到了 API 密钥、Bedrock 项目或 Google Cloud 项目配置的速率限制。如果是代理或网关返回了自己的 429 页面，它的标题会显示在 · 之后。

Unable to connect to API

连接 API 失败。较新的版本会写明原因，并在括号中保留错误代码，例如 ConnectionRefused、ENOTFOUND 或 EHOSTUNREACH。消息示例：

Unable to connect to API. Check your internet connection
Couldn't connect through your proxy (ERR_PROXY_TUNNEL)
Connection dropped (ECONNRESET)

Anthropic 列出的常见原因包括：没有网络连接、VPN 屏蔽了 api.anthropic.com、公司代理未配置。

第 3 步：在同一个 shell 中测试连接

curl -I https://api.anthropic.com

在 Windows PowerShell 中使用 curl.exe -I https://api.anthropic.com，以避开内置别名。

  • curl 失败： 问题出在这台机器的网络。检查 Wi-Fi、VPN 和 DNS。在公司代理后面时，启动 Claude Code 之前设置 HTTPS_PROXY。
  • curl 正常但 Claude Code 不行： 运行时和网络之间有东西拦着。如果用网关，检查 ANTHROPIC_BASE_URL，并对照 Anthropic 网络配置页面检查防火墙允许的主机。

第 4 步：排除本地安装问题

如果状态页正常，网络也没问题：

  1. 更新：claude update。
  2. 确认登录的是你预期的账号：在 Claude Code 中运行 /status。
  3. 检查环境中是否有多余的 ANTHROPIC_API_KEY，它会覆盖订阅登录。
  4. 如果是卡住或 CPU 占用高而不是报错，Anthropic 的故障排除页面介绍了常见原因。

无人值守运行

对于 CI 或其他无人看管的任务，Anthropic 提供了 CLAUDE_CODE_RETRY_WATCHDOG=1。它会无限重试 429 和 529 容量错误，而不是在常规重试后失败。支出上限导致的 429 仍会立即失败。请配合任务超时使用，以免长时间故障一直占用 runner。

不在电脑前时，区分提供商问题和电脑问题

当会话运行在你没坐在跟前的电脑上时，“Claude Code 挂了”可能有三种含义：提供商出了问题、会话达到了限制、或者电脑本身离线了。

如果你想在手机上分辨这些情况，Happier 是一款开源应用，可以从手机、桌面或网页跨设备运行和编排 Claude Code、Codex 等代理。

它会显示：

  • 每台机器显示“在线”（online）或“离线”（offline），以及最后在线时间。如果电脑离线，在它恢复之前提供商的状态都无关紧要。
  • 使用限制会以横幅显示在会话中，即“已达到使用限制（Usage limit reached）”，并附上提供商给出的重置时间。这样就能把配额停止和服务故障区分开。

在电脑上，happier daemon status 会显示后台服务是否在运行。Happier 无法修复提供商故障、网络中断或已关机的电脑。设置方法见如何在手机上使用 Happier。它在 GitHub 上开源，可以在这里下载，还有一个 Discord。

常见问题

Claude Code 现在挂了吗？

查看 status.claude.com。Anthropic 自己的错误信息指向的就是这里。

529 错误会消耗我的用量吗？

不会。Anthropic 的错误参考说明，529 不是你的使用限制，也不计入配额。

Claude 聊天能用，Claude Code 却不行，为什么？

它们共用账号，但不一定走同一条路径。Claude Code 可能在使用 API 密钥、代理、网关或云提供商。检查 /status 和环境变量。

为什么 Claude Code 停在“Connection lost while your computer was asleep”？

请求过程中电脑进入了睡眠。Claude Code 会重试断开的连接，如果这一轮仍然结束了，就再发送一次消息。

相关指南

claudetroubleshootingerrorsoutage
最后更新: 2026-10-26