結論先說
- 先看是「全網偶發」還是「單會話毒化」:新開一個空目錄敲
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 條評論
還沒有評論,來搶沙發~