Claude Code 十月更新汇总(2026-10-01 → 10-31,v2.1.287 → v2.1.316)

By 陈成 · Published October 29, 2026 · Updated November 2, 2026

Claude Code 2026 年 10 月(v2.1.287 → v2.1.316)更新了什么,哪些值得关注?

主要来源:官方 changelog https://code.claude.com/docs/en/changelog.md 补充来源:我的 X 书签、X 搜索(@ClaudeDevs / @bcherny / 社区)、Reddit r/ClaudeCode 与 r/ClaudeAI 的讨论 整理日期:2026-10-29,2026-11-02 补充 2.1.314(10/30)和 2.1.316(10/31)

TL;DR


1. 版本时间线

timeline
    title Claude Code 2026 年 10 月版本时间线
    10-01 : 2.1.287 Claude Mods 上线 / You should know 内置 mod
    10-02 ~ 10-06 : 2.1.288 Ctrl+C 草稿可找回 / --max-findings : 2.1.290 claude attach/logs 支持按名字 / WebSearch 额度改为按小时回填 : 2.1.292 Agent 工具支持 effort 参数
    10-07 ~ 10-09 : 2.1.293 Haiku 5.5 : 2.1.295 hooks onFailure block / OSC 7501 : 2.1.296 子代理 autoCompactWindow / Read allow_large
    10-14 ~ 10-16 : 2.1.299 idle compaction / MCP 规则精确匹配 : 2.1.300 请求 gzip 压缩 / virtualText : 2.1.302 fork 子代理默认开启
    10-19 ~ 10-23 : 2.1.304 /auto-mode-setup / Code Review 分级 : 2.1.307 API 版本 2026-10-21 : 2.1.309 sed -i 改走真实 Bash / ultrareview 需要信任工作区 : 2.1.310 Monitor 工具支持第三方云
    10-26 ~ 10-27 : 2.1.311 ultrathink 单轮 xhigh : 2.1.312 hooks 并发上限 / 移除 safety_event
    10-30 ~ 10-31 : 2.1.314 blockWritesOutsideWorkingDirectories / idle compaction 进 VS Code 和桌面端 : 2.1.316 CLAUDE_CODE_SUBAGENT_EFFORT / Opus 4.8 fast mode 弃用

2. Claude Mods:本月最大的新东西

2.1 是什么

2.1.287(10/01):「Added Claude Mods: plugins may now modify deeper behavior」。

按 Addy Osmani 的官方入门文章,mod 就是插件里的一个 JS/TS 模块,导出 register(on, options),用 on(event, matcher?, hook) 注册钩子。钩子像中间件一样串成一条链:

flowchart LR
    E["事件<br/>例如 tool.call"] --> H1["你的 mod<br/>($, e, next)"]
    H1 -- "next(e)" --> H2["其他插件的 mod"]
    H2 -- "next(e)" --> CC["Claude Code 默认行为<br/>(真正执行工具)"]
    CC -- "result" --> H2
    H2 -- "result" --> H1
    H1 -. "也可以不调用 next:<br/>拦截 / 改写 / 重试" .-> X["自定义结果"]

一个 mod 可以在 prompt 发给模型之前改写它,可以拦截、改写或重试工具调用,可以批准或拒绝权限请求,可以在 Claude 读到工具输出之前脱敏,还可以在终端或桌面端画 band、pane、toast、/command。

2.2 本月 Mod API 的扩展(按版本)

版本 新能力
2.1.287 Mods 上线;内置 You should know:一个旁路 agent 盯着输出,标出你或 Claude 可能漏掉的东西(/plugin enable cc-plugin-you-should-know@builtin)
2.1.288 $.ui.selection():读取全屏模式下选中的文本
2.1.289 teammates 也会触发 agent.spawn;$.agent.list() 带 idle/waiting 状态
2.1.290 turn.step 带 serverToolUses;tool.check 带 agentId、ceiling;claude plugin validate 会列出 gating hooks
2.1.292 prompt.autocomplete 事件;$.model.complete 支持 prompt caching;workflow agents 也进入 agent.spawn
2.1.293 $.tool.register 的 isDeferred: false,工具 schema 一开始就放进 prompt
2.1.295 $.ui.notify 原生通知;Button 可以带子元素
2.1.299 $.prompt.media(托管 mod 可以读附件字节)、$.session.identity()、Text 的 size/weight/mono、session.append 的 queue door
2.1.300 virtualText(只显示、不进入 prompt 的文字)、$.ui.view({ agentId })、prompt.change 事件、RTL 文字、agent.spawn 可改写 workflow agent 的 prompt 和 model
2.1.301 Input 支持多行(rows);.catch 只在 hook 自己抛错或超时时运行
2.1.304 tool.check 返回 decider: "person"(只能由人批准)、e.isReadOnly;settings.read 能拿到每一层设置,托管 mod 可以把组织设置当作上限

2.3 社区反应


3. 上下文、压缩与缓存

3.1 changelog 要点

版本 变化
2.1.287 Opus 4.7+ / Fable 在 Bedrock、Vertex、Foundry、网关上默认使用 1M 上下文(CLAUDE_CODE_DISABLE_1M_CONTEXT=1 保留 200K)
2.1.288 /autocompact 改为按模型保存窗口
2.1.296 子代理 frontmatter 支持 autoCompactWindow;Read 工具新增 allow_large
2.1.299 idle compaction:200K+ 的会话闲置约 54 分钟,在 1 小时 prompt cache 过期前压缩;CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS 调整阈值,"idleCompaction": false 关闭
2.1.301 切换到上下文更小的模型时,先由原模型做总结
2.1.302 /config 新增 Idle compaction 开关,压缩提示里会告诉你怎么关
2.1.304 压缩后重新把 skill 列表发给 Claude;/reload-skills 只发新增或修改过的 skill
2.1.311 标准上下文会话超过 200K 时不再报「Usage credits required for 1M context」,改为自动压缩后继续;不起作用的 [1m] 后缀被去掉
2.1.312 子代理的 autoCompactWindow 可以下调 CLAUDE_CODE_AUTO_COMPACT_WINDOW,但不能上调
2.1.314 idle compaction 扩到 VS Code 和桌面端 Code tab;关闭遥测的订阅用户也会触发;Bedrock / Vertex / Foundry / LLM 网关开启 1 小时缓存后同样生效。PreCompact hook 的输出截到 10,000 字符,避免压缩失败或反复压缩;Bedrock 上图片多的会话不再报「Input is too long」,而是先删旧图再压缩
2.1.316 /model <id> 选了当前版本不认识的模型时会提醒:auto-compact 将按 200K 窗口处理
flowchart TD
    A["会话 ≥ 200K tokens"] --> B{"闲置约 54 分钟?"}
    B -- 否 --> C["继续保持 1h prompt cache"]
    B -- 是 --> D["在 cache 过期(60 分钟)前自动压缩"]
    D --> E["回来时是一份「温」的摘要<br/>不用整段重新写缓存"]
    D -. "代价:压缩有损" .-> F["关闭:idleCompaction: false<br/>或在 /config 里关"]

3.2 社区声音


4. 模型、推理力度与 ultrathink

版本 变化
2.1.292 Agent 工具新增 effort 参数,子代理可以用指定的 effort 运行
2.1.293 Claude Haiku 5.5(claude-haiku-5-5)成为 API 默认 Haiku,1M 上下文,$0.10 / $0.50 每 MTok(>100K prompt 为 $0.50 / $2.50)
2.1.296 Sonnet 5.5 缓存读取按 $0.10/MTok 计价(原来是 $0.20);新增 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL
2.1.299 agent view 里可以用 /effort、/fast 设置新会话的默认值
2.1.302 CLAUDE_CODE_AUTO_MODE_MODEL:选择客户端 auto mode 分类器使用的模型
2.1.304 Opus 5.5 的 /fast 去掉「research preview」标签
2.1.311 ultrathink 在交互终端里让这一轮以 xhigh 运行(Opus 5.5 / Sonnet 5.5 / Haiku 5.5 / Fable 5.1,仅 Anthropic API)。Claude 工作时输入,会把这一轮剩下的部分提升到 xhigh;彩虹高亮只在真正生效的位置显示
2.1.312 中途改 effort 时,提示会说明「可能要等到你的下一条消息才生效」
2.1.314 管理员给某个模型设了 effort 上限时,不再每轮报「Invalid effort level」,而是自动降级重试并说明用了哪一级;网关后面写成 claude-opus-4.8(带点)的模型 ID 不再被当成旧模型
2.1.316 CLAUDE_CODE_SUBAGENT_EFFORT:没有别处指定时子代理用这个 effort,不再继承会话的;CLAUDE_CODE_DISABLE_ULTRATHINK 关掉 ultrathink 关键词;VS Code 里 ultrathink 也改为单轮 xhigh 并彩虹高亮;Opus 4.8 fast mode 10/30 起弃用,11/30 移除,之后请求直接报错、不回退到普通 Opus 4.8,需要迁到 Opus 5.5

社区:


5. 用量风波与 /usage

flowchart LR
    A["10/22 用户:<br/>额度掉得快 5 倍?"] --> B["@bcherny:在查<br/>请大家提交 session ID"]
    B --> C["10/28 结论"]
    C --> D["没有单一根因<br/>也没有 Claude Code 回归"]
    C --> E["发现几处小的 token 浪费<br/>正在修"]
    C --> F["多数情况是一两个重度会话:<br/>xhigh / /goal / Workflows /<br/>Agent Teams / 长 SDK 任务"]
    F --> G["子代理默认继承 effort<br/>会迅速累积"]

6. 子代理、后台会话与 agent view


7. 权限、安全与 hooks

版本 变化
2.1.287 通过仓库里提交的符号链接写入敏感文件或工作区外的 shell 写操作,必须等人确认
2.1.290 项目设置不能再开启 Claude in Chrome;pyright 不再算只读命令;更多 ps 形式需要审批;仓库设置不能再设置 CLAUDE_CODE_DISABLE_ATTACHMENTS
2.1.295 command/HTTP hook 新增 onFailure: "block":hook 启动失败、超时或异常退出时阻止动作
2.1.299 MCP allow 规则精确匹配:mcp__a 不再放行 a__b;UserPromptSubmit 在 skill 展开之前运行;文件名含隐藏或方向控制字符的 skill 不再加载;退出时打印的 resume 命令改用 ID
2.1.300 PreToolUse/PermissionRequest 返回的 updatedInput 会按工具 schema 校验
2.1.304 /auto-mode-setup:读项目和最近会话,向 auto mode 介绍你的环境
2.1.305 sandbox.allowNestedUserNamespaces(Linux 上的 Chromium、rootless podman)
2.1.307 新增 OTel 事件 claude_code.safety_event
2.1.309 sed -i 改为走标准 Bash 权限(/rewind 不再能恢复它);bypass 模式下危险 rm/rmdir 直接拒绝并给出改写提示(桌面/VS Code);claude ultrareview 需要信任工作区
2.1.302 / 2.1.312 prompt/agent hooks 并发上限:同一事件最多 12 个同时运行,之后每个会话最多 24 个,超时排队的另外最多 12 个
2.1.312 停止发送 claude_code.safety_event(只存在了 2.1.307 → 2.1.311 这几天)
2.1.314 permissions.blockWritesOutsideWorkingDirectories:Write / Edit / NotebookEdit 在所有权限模式下拒绝写工作区外的路径;hook 的 if 条件可以写 Monitor(tail *),匹配 Bash 的 hook 也会作用于 Monitor 启动的命令(可以阻止或询问,不能批准或改写);/permissions 的审查页改名 Recently blocked,命令显示不全时不允许批准;文件工具编辑本地的组织托管设置副本前先询问;Bash 工具的 shell 清掉继承来的 which 别名;/ultrareview 运行 git 前先检查工作区信任;修复 claude -p --resume 进入的 worktree 不受 sandbox 保护、--setting-sources 排除的设置文件仍生效
2.1.316 不带 "$defaults" 的 autoMode.allow 不再移除定时任务 prompt 的内置规则;Team / Enterprise 从 Anthropic API 拉取的托管设置直接生效、不再弹审批,校验不过的本地副本会被拒绝;修复 --restricted 会话在 Read allow 规则覆盖时上传工作区外文件;PowerShell hook 以类型转换、param 等开头时 exit 2 也能阻止

Reddit 对 2.1.305–2.1.309 的整理 建议:升级前给不想加载的 MCP server 显式写 deniedMcpServers,因为 2.1.305 的 allowedMcpServers 不再过滤只在 env 里用 ${VAR} 的 stdio server;依赖 sed -i 预览的 hooks 和脚本要检查。


8. MCP


9. 性能与体验


10. Code Review / ultrareview / claude-api skill


11. 企业、云和 Claude Tag(简述)


12. 对我来说值得做的事

  1. 调整压缩阈值:/autocompact 300k(或 250k),并在 CLAUDE.md 或项目文件里记录关键决定;如果不想要 idle compaction,在 /config 里关掉。
  2. 管住 effort:主会话按需使用 ultrathink 做单轮 xhigh,不要整个会话长期开着 xhigh;子代理默认继承 effort,升到 2.1.316 后可以直接设 CLAUDE_CODE_SUBAGENT_EFFORT(比如 medium),再给子代理配较便宜的 model。
  3. 定期看 /usage,按 f 应用修复建议;长时间离开的会话考虑设置 promptCacheTtl / subagentPromptCacheTtl。
  4. 试一个 mod:按 @Voxyz_ai 的提示词让 Claude 先翻 session 日志找需求;可以先装 cc-stretch 或类似 ccoverhead 的上下文/缓存监视器看看。
  5. 检查权限配置:MCP allow 规则改用 mcp__<server>__* 的完整写法;依赖 sed -i 预览或 /rewind 恢复的流程要调整;想要 hook 失败时阻止动作,就加上 onFailure: "block";不希望 Claude 写工作区外的文件,就开 permissions.blockWritesOutsideWorkingDirectories。
  6. 还在用 Opus 4.8 fast mode 的,11/30 前迁到 Opus 5.5,到期后请求会直接报错。

参考链接

官方

X 书签与社区

Reddit

Read this report as Markdown · Cite it (BibTeX)