---
title: "Claude Code 529 overloaded 怎么办：2.1.302 重试环境变量与空闲压缩速查表"
description: "截至 2026 年 10 月 17 日的 Claude Code 官方更新日志，整理了 529 过载重试、无人值守等待上限、用量上限和空闲压缩的 4 个变量与 1 个设置，附排查顺序。"
url: https://cdnping.org/blog/claude-code-529-overloaded-retry-idle-compaction
language: zh-CN
published: 2026-10-18
category: "排障指南"
tags: ["Claude Code","529","429","环境变量","空闲压缩"]
source: cdnping.org
license: Free to quote and summarize with a link to the url above.
---
# Claude Code 529 overloaded 怎么办：2.1.302 重试环境变量与空闲压缩速查表

Claude Code 遇到 529 overloaded，意思是 Anthropic 一侧暂时过载，通常不是你的网络或账号问题。截至 2026 年 10 月 17 日，官方 [CHANGELOG](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) 里 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 或额度耗尽时一直挂着。下面的数值只是示例，按自己的任务调整：

```bash
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 怎么用才省钱](/blog/claude-prompt-caching-save-cost)。

## 其他几处相关变化

- 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 时先查什么？

1. 看官方状态：打开 [cdnping 的 Anthropic 状态页](/status/anthropic)，对照 [Anthropic 官方状态页](https://status.anthropic.com)。官方有事件，基本是服务端问题，等恢复即可。
2. 区分错误码：529 是过载，429 是限流或额度。额度问题看 `/usage`，参见 [Claude Max 5x 和 20x 的额度与周限](/blog/claude-max-plan-5x-20x-claude-code)。
3. 官方正常却仍然失败，再查本地：超时、握手失败更像网络问题，按 [Claude Code 连接超时排查清单](/blog/claude-code-connection-troubleshooting) 走，或用 [出口 IP 检测](/ip) 和 [在线测速](/) 看链路。
4. 觉得"慢"但没有报错，见 [Claude Code 慢怎么办](/blog/claude-code-slow-response-fix)。
5. 最近有故障的背景可以看 [9 月 29 日故障复盘](/blog/claude-code-outage-sep29-spend-limit-oct7)。

## 可以改接口地址吗？

Claude Code 支持自定义接口地址，配置方法见 [Claude Code 自定义 API 与 Codex、OpenCode 接口地址配置](/blog/configure-custom-api-endpoint-claude-code-codex)。AGI Plan 是 cdnping 的商业合作方，提供兼容 Claude Code 的接入教程（[startup](https://agiplan.dev/startup)），只需改一个接口地址，不需要 Claude 账号。它不是官方授权渠道，部分模型仅境外可用，具体以 [模型页](https://agiplan.dev/models) 为准。这只是一个可选项，上文的重试配置与它无关。

## 参考来源

- [Claude Code CHANGELOG（GitHub）](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)，2.1.295、2.1.296、2.1.299、2.1.301、2.1.302 条目，查阅于 2026 年 10 月 17 日
- [Claude Code CHANGELOG（raw）](https://raw.githubusercontent.com/anthropics/claude-code/refs/heads/main/CHANGELOG.md)
- [Anthropic 状态页](https://status.anthropic.com)