Claude Code 529 overloaded 怎麼辦：2.1.302 重試環境變數與空閒壓縮速查表
Claude Code 遇到 529 overloaded，意思是 Anthropic 一側暫時過載，通常不是你的網路或賬號問題。截至 2026 年 10 月 17 日，官方 CHANGELOG 裡 2.1.295 到 2.1.302 這幾個版本，圍繞 529、429 重試和長對話的快取過期新增了幾項可配置的行為。本文按日誌原文整理成速查表，並給出一個先判斷、後調參的順序。以下內容只依據該更新日誌，具體預設值和細節以官方文件為準。
529 和 429 分別是什麼？
- 529 Overloaded：服務端過載，稍後重試通常能恢復。
- 429：請求被限流，或者觸到了用量上限。
兩者在 Claude Code 裡都會觸發自動重試。這次更新的重點是：重試等多久、無人值守時最多等多久、用量上限離重置太遠時要不要乾脆結束。
新增了哪些變數和設定？
| 名稱 | 版本 | 作用（據更新日誌） |
|---|---|---|
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS | 2.1.296 | 設定 529 重試退避的最大延遲，可以調長 |
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS | 2.1.295 | 限制無人值守重試模式（CLAUDE_CODE_RETRY_WATCHDOG）等待 429、529 的時長 |
CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS | 2.1.301 | 無人值守重試模式下，用量上限重置時間太遠時直接結束請求，不再等待 |
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS | 2.1.299 | 修改空閒壓縮的 20 萬 token 下限 |
"idleCompaction": false（settings.json） | 2.1.299 | 關閉空閒壓縮；2.1.302 起 /config 裡也有 Idle compaction 一行 |
名字裡的 _MS 表示毫秒。更新日誌沒有在這些條目裡給出預設值，所以不要憑印象填數，先看官方文件。
示例：給批處理任務設上限
假設你在伺服器上無人值守地跑 Claude Code，不希望它在 529 或額度耗盡時一直掛著。下面的數值只是示例，按自己的任務調整：
export CLAUDE_CODE_RETRY_WATCHDOG=1
# 總共最多等 10 分鐘（示例值）
export CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS=600000
# 用量上限要等很久才重置時，直接結束（示例值，3 小時）
export CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS=10800000
CLAUDE_CODE_RETRY_WATCHDOG 本身該設成什麼值，更新日誌沒寫，請查官方文件。另外兩個變數的含義也請以官方文件為準，這裡的值只是演示格式。
如果是互動使用，想讓 529 時多等一會兒而不是很快報錯，可以加大 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS。
空閒壓縮是什麼，要關嗎？
2.1.299 加入：一個 20 萬 token 以上的對話，閒置約 54 分鐘後，會在一小時提示快取過期之前自動壓縮，這樣你回來發下一條訊息時，不必重新處理整段長上下文。這個功能在終端中生效。
- 想改觸發下限：設定
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS。 - 想關掉：settings.json 裡寫
"idleCompaction": false，或在 2.1.302 及以上版本的/config中關閉Idle compaction。 - 以上兩項都需要 2.1.290 或更高版本。
如果你依賴對話裡的原始細節，不想被壓縮改寫，可以關掉；如果經常隔一陣回來繼續長會話，保留它更省重新處理的開銷。關於快取為什麼影響成本，可參考 Claude prompt caching 怎麼用才省錢。
其他幾處相關變化
- 2.1.299 修復了
/usage、接近上限的提示和狀態列有時顯示超過 100% 的問題。看到過 100% 以上的讀數，升級後再核對。 - 2.1.295 的 command 和 HTTP hooks 支援
onFailure: "block"：hook 無法啟動、超時或退出碼異常時，會攔截動作而不是放行。 - 2.1.295 起，沒有受管設定的機器也可以在使用者設定裡使用
forceLoginMethod: "gateway"和forceLoginGatewayUrl，讓/login指向 Claude apps gateway。
報 529 時先查什麼？
- 看官方狀態：開啟 cdnping 的 Anthropic 狀態頁，對照 Anthropic 官方狀態頁。官方有事件，基本是服務端問題，等恢復即可。
- 區分錯誤碼：529 是過載，429 是限流或額度。額度問題看
/usage，參見 Claude Max 5x 和 20x 的額度與周限。 - 官方正常卻仍然失敗，再查本地：超時、握手失敗更像網路問題，按 Claude Code 連線超時排查清單 走，或用 出口 IP 檢測 和 線上測速 看鏈路。
- 覺得"慢"但沒有報錯，見 Claude Code 慢怎麼辦。
- 最近有故障的背景可以看 9 月 29 日故障覆盤。
可以改介面地址嗎？
Claude Code 支援自定義介面地址，配置方法見 Claude Code 自定義 API 與 Codex、OpenCode 介面地址配置。AGI Plan 是 cdnping 的商業合作方，提供相容 Claude Code 的接入教程（startup），只需改一個介面地址，不需要 Claude 賬號。它不是官方授權渠道，部分模型僅境外可用，具體以 模型頁 為準。這只是一個可選項，上文的重試配置與它無關。
參考來源
- Claude Code CHANGELOG（GitHub），2.1.295、2.1.296、2.1.299、2.1.301、2.1.302 條目，查閱於 2026 年 10 月 17 日
- Claude Code CHANGELOG（raw）
- Anthropic 狀態頁
