它到底是什么

/autocompact 用于设置 auto-compact window（自动压缩阈值）——即上下文占用达到多大 token 量时，Claude Code 会自动触发压缩（用摘要替换较早的对话内容）。据官方文档，该命令要求 Claude Code v2.1.221 或更高版本。

怎么触发 / 怎么使用

/autocompact [auto|<tokens>]

1. 查看当前设置

不带参数运行时，会显示当前生效的自动压缩窗口大小及其来源（例如来自环境变量、settings.json，还是模型默认值）。

2. 设置自定义窗口

/autocompact 500k
/autocompact 1M
/autocompact 200000

官方文档说明该命令接受纯数字（200000）和带单位后缀的写法（500k、1M）。

3. 恢复模型默认值

/autocompact auto

回到针对当前模型调优的默认窗口大小。

保存 / 配置 / 集成

• /autocompact 设置的值会保存到用户级 settings，并对当前及后续会话生效。
• 同一设置也可写入 ~/.claude/settings.json 的 autoCompactWindow 字段。
• 也可通过 CLI 参数 --autocompact 在单次启动时覆盖，或环境变量 CLAUDE_CODE_AUTO_COMPACT_WINDOW 设置（该环境变量只接受纯 token 数字，不支持 500k 这种单位写法）。
• 官方文档指出：该设置可能被更高优先级的作用域（如 managed settings）覆盖；具体优先级参见 /docs/en/model-config#set-the-auto-compact-window。

运行约束 / 限制

跟同类原语对比

经典使用场景

• 长时间会话中希望更早触发压缩以控制单次调用的成本，可调低窗口（如 /autocompact 100k）。
• 需要模型在压缩前保留更多细节上下文，可调高窗口（如 /autocompact 500k）。
• 不确定当前生效值来自哪里（命令保存值 / settings.json / 环境变量）时，直接运行不带参数的 /autocompact 查看来源。
• 想撤销此前的自定义设置、回到官方针对当前模型调优的默认值，用 /autocompact auto。

常见坑

1. 设了 /autocompact 却发现不生效，很可能是 CLAUDE_CODE_AUTO_COMPACT_WINDOW 环境变量或 managed settings 在更高优先级上覆盖了它——官方文档明确这是设计内的优先级链条，而非 bug。
2. 环境变量 CLAUDE_CODE_AUTO_COMPACT_WINDOW 只接受纯数字 token 数，写成 500k 这类带单位的格式在环境变量里不会被识别（命令/CLI 参数才支持单位后缀）。
3. 版本较旧的 Claude Code（低于 v2.1.221）没有此命令，升级 CLI 后才能使用。

来源

• Slash commands — Claude Code Docs
• Set the auto-compact window — Claude Code Docs (model-config)
• Tune auto-compaction | Claude Code Guide