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 状态页
