搜索 K
主题
Claude Code 上下文自动压缩配置指南
Summary
.claude/settings.json 没有 autoCompact 顶层键；自动压缩通过 env 中的环境变量配置。若公司将上下文上限控制为 200k，建议显式设置 CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000。
推荐配置（200k 上限）
json
{
"env": {
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "200000",
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "70"
}
}配置位置：<project>/.claude/settings.json
参数速查
| 变量 | 官方语义 | 200k 场景建议 |
|---|---|---|
CLAUDE_CODE_AUTO_COMPACT_WINDOW | 用于自动压缩计算的 context capacity（tokens） | 200000 |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE | 在上述 capacity 的多少 % 时触发自动压缩 | 70 |
200k 档位速查
| 档位 | WINDOW | PCT | 触发点 | 适合场景 |
|---|---|---|---|---|
| 保守 | 200000 | 80 | 160k | 更想保留历史上下文 |
| 平衡 | 200000 | 70 | 140k | 日常开发，默认推荐 |
| 激进 | 200000 | 60 | 120k | 超长会话、大量输出 |
调参规则
| 如果… | 就调整… |
|---|---|
| 压缩触发太晚 | 降低 CLAUDE_AUTOCOMPACT_PCT_OVERRIDE |
| 压缩触发太早 | 提高 CLAUDE_AUTOCOMPACT_PCT_OVERRIDE |
| 公司要求按 200k 控制 | 显式设置 CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 |
| 不确定怎么配 | 先用 200000 / 70 |
相关命令
| 命令 | 用途 |
|---|---|
/context | 查看当前上下文占用 |
/compact | 手动执行压缩 |
说明
CLAUDE_CODE_AUTO_COMPACT_WINDOW的单位是 tokens，不是“压缩后剩余多少内容”。- 真正触发点 =
CLAUDE_CODE_AUTO_COMPACT_WINDOW × CLAUDE_AUTOCOMPACT_PCT_OVERRIDE。 - 若实际模型窗口大于
200k，但组织策略要求按200k控制，也应显式写200000。
