TOPIC COLLECTION
Claude Code 2.1.304更新：恢复旧会话前先提示5小时额度，/auto-mode-setup引导配置自动模式，Pro和Max用户怎么用
Claude Code 2.1.304于2026-10-19 19:47 UTC（新加坡时间10月20日凌晨3:47）发布到npm。和普通用户关系最大的有三处：Pro和Max计划恢复一个闲置会话时，如果会明显吃掉5小时用量额度，会先弹出提示，可以继续恢复，也可以开新会话再让Claude去查旧会话；新增/auto-mode-setup，读取项目和近期会话来帮自动模式了解你的环境，并开放到Bedrock、Vertex、Foundry等第三方渠道；修复了claude --worktree在HEAD游离时退出会不问一声删掉worktree和分支、可能丢提交的问题。本文讲清升级方法、各项改动的实际用法和要留意的地方。
资料更新：2026-10-20
依据anthropics/claude-code仓库CHANGELOG.md的2.1.304、2.1.302、2.1.299条目，以及npm registry上@anthropic-ai/claude-code的发布时间（2.1.304：2026-10-19T19:47:15Z）。5小时额度提示的具体阈值官方没有给出数字，文中不做猜测。核查2026-10-20（新加坡时间）。
主题标签：Claude Code、Anthropic、5小时额度、auto mode、AI编程
如果你每天开着Claude Code干活，又是Pro或Max订阅，那这次2.1.304值得花五分钟看一下。它不是那种换模型、改价格的大版本，changelog里一大半是修bug，但有几条会直接影响你的额度消耗和代码安全。
先交代时间：npm上2.1.304的发布时间是2026-10-19 19:47 UTC，换成新加坡/北京时间是10月20日凌晨3点47分。前一个版本2.1.303是10月18日发的，内容只有一句「Bug fixes and reliability improvements」。所以这一版算是攒了几天的集中更新。
改动一：恢复旧会话之前，先告诉你会花多少额度
原文是这么写的：在Pro和Max计划上，如果恢复一个不活跃的对话会用掉5小时用量限制里「明显的一部分」，Claude Code会先给出警告。你有两个选择：照样恢复，或者开一个新对话，之后如果你提到之前的内容，Claude可以去查那个旧对话。
为什么恢复旧会话会贵？这要结合前几个版本一起看。Claude Code的提示缓存（prompt cache）有效期是1小时。会话放着超过一小时，缓存过期，下一条消息就得把整个上下文重新处理一遍。一个已经堆到十几万token的长会话，恢复时这一下就不便宜。
2.1.299加过一个「空闲压缩」功能：在终端里，20万token以上的对话闲置约54分钟，会在一小时缓存过期之前先自动压缩，这样你回来发消息时就不用把全部内容重算。2.1.302又在/config里加了「Idle compaction」开关，可以关掉或重新打开。这次的额度提示，等于是把这个成本摆到台面上，让你自己选。
我的实际建议是这样的：
- 隔夜的长会话，看到提示就选开新会话。新会话里一句「接着昨天那个重构任务」，让它去查旧记录，通常比硬恢复省。
- 如果旧会话里有大量你还要反复用到的细节（比如一长串报错日志和排查过程），恢复也不亏，只是心里有数。
- 官方没写「明显的一部分」到底是百分之多少，我也不乱猜。想看自己还剩多少，用
/usage。这一版顺手改了/usage：用量数据被限流时，它会告诉你什么时候恢复，而不是一句「稍后再试」。
改动二：/auto-mode-setup，帮自动模式认识你的项目
自动模式（auto mode）是让Claude Code在一定范围内自己决定执行哪些操作、少弹确认框的模式，后台有一个安全分类器判断每个工具调用该不该放行。问题在于，分类器不了解你的环境：哪些目录是测试数据可以随便删，哪个命令会连生产库，它一开始并不知道。
新的/auto-mode-setup是一个引导式设置，会读取你的项目和最近的会话，教自动模式了解你的环境。这次还特别说明，它现在也能在Amazon Bedrock、Google Vertex、Microsoft Foundry、Claude apps gateway以及关闭了遥测的会话里使用。以前走第三方云或者公司网关的团队，这块是用不上的。
操作上很简单：
- 进入项目根目录，启动
claude。 - 输入
/auto-mode-setup，按提示走完。 - 走完以后，挑一个低风险的小任务试跑一次自动模式，看看哪些操作被放行、哪些被拦，再决定要不要长期开着。
提醒一句，它会读近期会话。如果你的会话里出现过密钥、内部地址之类的东西，先想清楚这些内容会不会被用作环境描述的一部分。公司项目建议先在个人测试仓库里试一下流程。
改动三：/claude-api managed-agents-secure，只检查不修改
这条面向在Claude开发者平台上用Managed Agents的人。命令会拿某个托管代理的配置，去对照Anthropic公开的安全指南，列出不一致的地方，而且明确写了「不会改动任何东西」。适合上线前自查，或者接手别人搭的代理时先摸底。没用托管代理的个人开发者可以跳过。
一个容易被忽略、但可能救你一次的修复
changelog里有一条写得很平淡：修复了claude --worktree在退出时，如果HEAD处于游离状态或者切到了别的分支，会不经询问就删除worktree和它的分支，「可能导致丢失提交」。
用worktree并行开多个任务的人（站内写过Claude Code并行会话怎么开），如果之前遇到过「明明提交了，回来分支没了」的情况，很可能就是这个。升级前，建议把还在worktree里的重要提交先push到远端或者打个tag，别指望修复版能找回已经删掉的东西。
同一类安全修复还有一条：对挂载盘或其顶层目录（比如macOS的/Volumes、Linux的/media、WSL里的/mnt/c）执行rm -r，现在会和rm -rf /Applications一样弹安全确认。之前这里是漏的。
其他几条值得知道的改动
CLAUDE_CODE_AUTO_COMPACT_WINDOW=200k以前会被悄悄当成10万token窗口。现在这个变量支持k和M后缀，数值超范围或被忽略时会给警告。设过这个变量的人，升级后检查一下实际生效值。- 自定节奏的
/loop如果定在1小时上限唤醒，以前会在1小时缓存刚过期之后触发，等于每次都不走缓存。这次修了。 - Opus 5.5的
/fast对话框去掉了「research preview」字样。快速模式本身的价格和用法，站内有Opus 5.5快速模式价格说明。 - 在自定义
ANTHROPIC_BASE_URL后面（也就是走LLM网关）时，工具搜索默认打开；网关返回400或422时会自动去掉它重试。 - Code Review加了Quick、Standard、Deep三档审查级别。这个话题站内之前写过Claude Code Review风险分级，这里不重复。
怎么升级、怎么确认
原生安装的直接运行claude update；用npm装的可以执行npm i -g @anthropic-ai/[email protected]。装完用claude --version看一眼版本号。VS Code和JetBrains插件里的Claude Code跟着扩展更新走，扩展市场里点一下更新就行。
公司内网走代理的，npm源同步可能慢几个小时，装不到2.1.304不一定是你的问题，过一阵再试。
我会怎么用这一版
说实话，最实用的是额度提示和worktree修复。前者让「要不要恢复昨晚那个会话」从拍脑袋变成有依据，后者堵住了一个会丢代码的坑。/auto-mode-setup对团队和第三方云用户更有意义，个人用户可以等有空再折腾。
还在纠结Claude Code和其他命令行代理怎么选的，可以看Claude Code和Codex怎么选，或者在AI命令行代理、AI编程分类里横向比一比。工具入口：Claude Code、Claude、Claude开发者平台、Anthropic Console、Visual Studio Code、JetBrains、GitHub。
来源与核查日期
- anthropics/claude-code CHANGELOG（2.1.304、2.1.302、2.1.299条目）
- npm：@anthropic-ai/claude-code（2.1.304发布时间2026-10-19T19:47:15Z）
核查日期：2026-10-20（新加坡时间）。功能可用范围以Anthropic官方说明和你的计划为准。
