过去一个月,Claude Code 发了 10 来个版本。
我把更新日志从头翻到尾,12 个功能里,真正值得你动手的只有 3 个。剩下 9 个,文末一句话带过,不浪费你时间。
/doctor prompt-audit:给你的 CLAUDE.md 做个体检
版本:v2.1.283(9 月 25 日)。
干嘛的?检查你的 CLAUDE.md、skills、agents、commands 里,有没有"给旧模型写的 prompt 习惯"。
比如这些:
- 全大写的施压式措辞("YOU MUST NEVER...")
- 又臭又长的禁止清单
- 指向早就不存在的文件路径
- 两份指令文件互相打架
模型换代了,你的"员工手册"还停在上个朝代。prompt-audit 就是来干这个的:跑一遍,出一份体检报告,告诉你哪几条过时了。
用法很简单:在终端中输入 /doctor prompt-audit(别名 /checkup prompt-audit 也行。)
两个关键细节:
- 它只出报告,不动手。改不改、怎么改,你确认了才执行。体检只开药方,不直接动刀。
- 它不会乱报。官方文档里正经的 thinking 关键词(比如 think hard、ultrathink)它认得,不会当成"旧习惯"误杀。
什么时候跑?换了默认模型之后跑一次,或者每季度跑一次。你的 CLAUDE.md 是越写越长的,只增不减,早晚得体检。
AGENTS.md 原生支持:两份说明书终于二合一
版本:v2.1.277(9 月 18 日)。
一句话:项目里没有 CLAUDE.md,Claude Code 现在会自动读 AGENTS.md。
这事的背景值得说两句。AGENTS.md 是 OpenAI 先推的开放格式,Codex、Cursor、Gemini CLI 早就支持了,60 多个工具跟进。Anthropic 是最后一个硬扛的——自己家 CLI 只认 CLAUDE.md。9 月 18 日,硬扛结束。
对你意味着什么?
- 如果你同时用 Codex 和 Claude Code:以前要维护两份说明书,现在一份 AGENTS.md 到处通用。
- 行为在 /config 的 "Project instructions" 里可调,有四种模式(默认是 fallback:有 CLAUDE.md 就读它,没有才读 AGENTS.md)。
有个坑,必须说:挡住 fallback 的不只是 CLAUDE.md,一个被遗忘的 CLAUDE.local.md 也会。很多人目录里躺着一个半年前随手建的 CLAUDE.local.md,自己都忘了,然后纳闷"为什么 AGENTS.md 没生效"。无声失效,最气人那种。开这个功能前,先 ls 一下。
idleCompaction:你去吃午饭,它在帮你省钱
版本:v2.1.299(10 月 14 日)正式写进更新日志。
干嘛的?一个超过 20 万 token 的会话,闲置约 54 分钟,Claude Code 会在 1 小时 prompt cache 过期之前,自动把它压缩成摘要。
为什么这能省钱?说人话:prompt cache 是 1 小时的"短期记忆"。你离开超过 1 小时,回来后的第一句话,模型要把整个上下文全价重读一遍——在 Opus 上,这比热缓存贵 25 到 40 倍。idleCompaction 就是在你回来之前,先把 200 页文档缩印成 5 页摘要,你回来只读摘要的钱。
终端里你会看到一行字:"Compacted while idle, before the prompt cache expired"。第一次见的人都以为见鬼了。
但是,这事有争议,我得说清楚:这个功能 9 月底就悄悄上线了(代码里 2.1.286 就有),但直到 10 月 14 日才写进更新日志。更骚的是,日志里这些自动压缩被记成了 "manual"——看起来像你自己按的 /compact。社区炸过一轮:我的上下文,谁动了?
Anthropic 的动机我能理解(长会话闲置是真烧钱),但静默上线 + 甩锅式日志,确实不地道。实证派不回避这个。
压缩会丢什么?三样:精确的指令原文、你做决策的原因、你已经否决掉的方案。完整 transcript 还在,磁盘上 ~/.claude/projects/ 里能找到,但摘要里大概率没了。
所以我的建议:
- 开着,它确实省钱。关掉的方法是 settings.json 里加 "idleCompaction": false(要 v2.1.290 以上)。
- 重要的东西写进 CLAUDE.md——压缩之后,CLAUDE.md 会重新加载,这是你指令的"诺亚方舟"。
- 阈值能调:CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS(默认 200000,最低 100000)。
其余 9 个,一句话
- Hook 并发上限 12 个,onFailure: "block" 让崩掉的安全 hook 直接拦下操作(2.1.295/2.1.302)
- Sonnet 5.5 的缓存读降价到 $0.10/百万 token(原来 $0.20),Haiku 5.5 成默认 Haiku
- availableModelsMatch + deniedModels:团队管理员可以精确锁死允许的模型版本
- 网关多了 x-claude-code-prompt-id header,方便按用户请求分组统计
- Windows 上 PowerShell 再也不能 rd 删掉整个盘符了(是的,以前能)
- 全屏模式下,别的会话的截断消息可以点开展开
- 网关加了 load_test_mode,压测不用真发请求
知道就行,哪天用到了再回来翻。
更新越快,越要有人帮你过滤噪音。
这波更新:开 2 个(prompt-audit 跑一次、AGENTS.md 按需配),留 1 个默认开着(idleCompaction,但重要指令写进 CLAUDE.md),剩下 9 个知道名字就行。