结论先说
- 先看是「全网偶发」还是「单会话毒化」:新开一个空目录敲
claude -p "hi"能通、只有旧长会话必报500,说明是旧会话里塞进了超大工具输出或损坏图片,不是服务器全挂。 - 流式卡死先按一次
Esc软中断,别直接强关终端:单按Esc只取消当前卡住的请求,保留已聊好的上下文,接着马上做裁剪。 - 救活旧会话先试
/rewind再试/compact:如果上下文已经大到连/compact压缩请求本身都报504超时,连按两次Esc(或输/rewind)退回到塞入大日志或大图之前的那一轮最管用。 - 防
504超时要控思考时长与代理空闲断连:超长上下文叠加长时间扩展思考时,公司网关容易因流无数据刷出而掐断连接;临时切/model sonnet或分步拆小任务可显著降低超时率。 - 开通与高配额升级入口:排查重试与长上下文压缩会额外消耗配额;国内无外币卡用户可在 Claude Code 订阅专页 或免密兑换的 Claude Pro iOS 卡密 开通,大仓库重度开发建议选 5 倍额度的 Claude Max 升级服务。

图:本站根据 Claude API 官方文档:Errors 与 Claude Code 排障页整理的示意图
本文根据 Claude Code 官方文档《Troubleshooting》、Claude API《Errors》参考页及官方状态页整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 在 Claude Code 里聊到几十轮后突然连报
API Error: 500,怎么重试都过不去、又舍不得直接关掉重来的开发者; - 用 Opus 深度思考改大文件时,经常转圈几分钟后跳出
504 Gateway Timeout或流式吐字卡住不动的人; - 想分清
500、504、529各自是官方崩了还是自己本地会话太臃肿的人。
一、先分清 500、504 与 529 的真实根因
看到 5xx 开头的状态码不要一律盲目狂按重试,结合官方错误码文档先定性:
| 终端报错表现 | 官方含义 | 在 Claude Code 里的常见诱因 |
|---|---|---|
API Error: 500 (api_error) | 服务端内部未预期异常 | 上游瞬时故障;或当前会话历史含损坏图片/极端体积工具返回导致每次重发都崩 |
504 Gateway Timeout | 网关等待上游响应超时 | 上下文接近满载且开启深度思考,首字等待超出了中间网关或企业代理阈值 |
| 流式输出停在半截不报错 | SSE 长连接静默僵死 | 笔记本休眠唤醒、Wi-Fi 切换或本地代理丢弃了长空闲流连接 |
529 overloaded_error | 官方算力高峰期临时过载 | 全球请求激增,与本地上下文无关,详见 529 过载报错处理指南 |
通用 HTTP 状态码与 request_id 看法可同步对照 Claude API 常见错误码总表。第一步永远先看一眼 status.claude.com:如果 Claude API 或 Claude Code 组件标黄/标红,耐心等官方修复即可,不必折腾本地配置。
二、不丢进度抢救卡死会话的四步实操
当状态页全绿,但你手头干了一半的重要会话一直报 500 或 504 时,按下面顺序止损:

图:本站根据 Claude Code 官方文档:Troubleshooting 整理的示意图
- 按一次
Esc停掉僵死请求并先备份:卡在思考动画超过三分钟没动静时,按一次Esc中断当前轮次,随后立即输入/export把已有分析导出成 Markdown 落盘防丢(导出细节见 Claude Code 导出会话记录方法); - 用
/rewind剥离最后一轮「重负载输入」:如果报错发生在你刚让它读了一个几兆的构建产物、贴了多张高清大图或跑出上万行报错之后,/compact往往也会跟着报 500。此时连按两次Esc打开/rewind,只回退对话(保留已改好的代码文件)到读大文件之前的那一步,具体边界见 Claude Code 回退检查点说明; - 上下文超六成及时手动
/compact:剥离毒化轮次后,执行/compact 只保留当前已完成接口清单与待修报错主动瘦身,把历史 Token 压下来; - 降档模型或调低思考预算度过卡点:大上下文叠加强思考最易撞上
504,输入/model sonnet临时切到响应更快的模型把眼前这一步跑通,或者把「一次性改十个文件」拆成每次改两个文件。
高峰期稳定性与订阅准备提示:欧美工作日晚间高峰期若频繁因长上下文重发请求,普通账号的 5 小时滚动窗口很容易被失败前的半截推理吃光。日常承担核心排障任务的开发者,可通过 Claude Pro 会员自助充值 续期,或升级至享有高峰优先权与 5 倍容量的 Claude Max 会员服务。
三、企业代理与终端断流防复发设置
如果你在公司内网配置了 HTTPS_PROXY 且每天固定遇到流式卡死,建议加做两项排查:
- 检查本地或公司代理的空闲超时(Idle Timeout):模型在进入深度推理(Thinking)阶段可能几十秒不吐可见字符,若中间代理设了 60 秒无数据断连就会直接造成客户端假死;
- 异常退出后用
claude -r接回:万一终端彻底失去响应不得不关窗口,重开终端后执行claude -r选中刚才的会话,紧接着第一句先敲/rewind或/compact,不要直接重发上一句长指令。恢复命令详见 Claude Code 查看与恢复历史对话。
常见问题
问:报 500 或 504 失败的那一轮会扣我的订阅额度或 API 费用吗?
答:服务端在返回结果前直接抛 500 通常不计成功完成,但如果是流式已经吐了一大半才断连,前面已生成的推理计算仍可能计入窗口消耗,所以切忌无脑连按十几次重试。
问:为什么 /compact 自己也报 504 Gateway Timeout?
答:因为 /compact 本质上也是把整段旧历史发给模型做摘要,当上下文已经塞满十几万 Token 时摘要请求本身就会超时。这时必须先用 /rewind 砍掉最后几轮大输出再压缩,或 /export 导出结论后 /clear 新开会话。
问:能把报错里的 request_id 发给谁查?
答:使用 API 或企业版的团队可复制终端打印的 req_... 编号提交给 Anthropic 官方支持定位后端日志。
问:国内开发者没有外币信用卡,怎么开通订阅并开具报销发票?
答:可通过本站 Claude Code 订阅专页 或 AI 会员充值总览 选购,支持支付宝、微信支付与 AlipayHK,提供免交密码的卡密自助兑换,企业采购可开具国内增值税发票。实时价格与售后细则以页面为准:订阅期内非违规掉订阅按剩余天数折退,风控封号不在质保范围。
相关教程
- Claude 报错 529 overloaded_error 怎么办:与 500、504 区分
- Claude API 报错 400 / 401 / 413 / 500 排查指南
- Claude Code 代码改坏了怎么回退:/rewind 与双击 Esc
- Claude Code 怎么导出会话、导出上下文
- Claude Code 怎么看历史对话、恢复之前的会话
参考资料
- Claude Code 官方文档:Troubleshooting — https://code.claude.com/docs/en/troubleshooting
- Claude API 官方文档:Errors — https://docs.claude.com/en/api/errors
- Anthropic 官方服务状态页 — https://status.claude.com
0 条评论
还没有评论,来抢沙发~