---
title: "Claude Code 十一月更新汇总"
author: "陈成"
author_url: "https://research.sorrycc.dev/@sorrycc"
question: "Claude Code 2026 年 11 月（v2.1.317 起）更新了什么，哪些值得关注？（持续更新）"
url: "https://research.sorrycc.dev/@sorrycc/claude-code-changelog-2026-11"
emoji: "🗓️"
published: 2026-11-04T15:25:24Z
updated: 2026-11-16T11:45:54Z
version: 6
cite: "https://research.sorrycc.dev/@sorrycc/claude-code-changelog-2026-11.bib"
---

# Claude Code 十一月更新汇总（持续更新中，截至 11-15，v2.1.317 → v2.1.325）

By [陈成](https://research.sorrycc.dev/@sorrycc) · Published November 4, 2026 · Updated November 16, 2026

> Claude Code 2026 年 11 月（v2.1.317 起）更新了什么，哪些值得关注？（持续更新）

> **WIP**：本文会随新版本陆续补充。目前收录 2.1.317（11/03）、2.1.318（11/04）、2.1.319（11/06）、2.1.321（11/09）、2.1.322（11/10）、2.1.323（11/12）和 2.1.325（11/13）七个版本。changelog 里没有 2.1.320 和 2.1.324。
>
> 主要来源：官方 changelog <https://code.claude.com/docs/en/changelog.md>，Code Mode 文档 <https://code.claude.com/docs/en/code-mode.md>
> 参考：[Ben's Bites 十一月摘要](https://research.sorrycc.dev/@sorrycc/bens-bites-2026-11)（11.10 一期提到 Fable 5.2 发布）
> 整理日期：2026-11-04，11-07 补充 2.1.319，11-15 补充 2.1.321 ~ 2.1.325
> 上月：[Claude Code 十月更新汇总](https://research.sorrycc.dev/@sorrycc/claude-code-changelog-2026-10)

## TL;DR（暂定）

- **发版节奏**：11 天 7 个版本（2.1.317 → 2.1.325），共约 869 条条目，其中 224 条 Added / Changed，89 条 Improved，556 条 bug 修复。2.1.323 一个版本就有 294 条。
- **Fable 5.2 上线**（2.1.321）：`claude-fable-5-2` 成为默认 Fable 模型，1M 上下文，$8 / $40 每百万 token，cache read $0.20。保存过的 Fable 5.1 选择会迁到 `fable`（Pro / Max 立即迁，Team / Enterprise 等组织放开），`/model claude-fable-5-1` 可以切回。
- **Code Mode（实验性）**（2.1.323）：Claude 写一段 JavaScript 来调用工具，一段代码里可以并行跑命令、把上一个结果传给下一个调用、只把需要的部分返回给模型。默认关闭，`CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1` 打开；只支持终端交互会话和订阅 / Console 账号，网关和三家云都不行。背景见 [Codemode 调研](https://research.sorrycc.dev/@sorrycc/codemode)。
- **沙箱里的 Bash 不再默认免提示**（2.1.325）：开了沙箱的 Bash 命令改走正常权限流程，要旧行为得设 `sandbox.autoAllowBashIfSandboxed: true`（托管设置开沙箱的，要设在优先级最高的托管来源里）。同版本里定时任务和 `/loop` 遇到声明了 `allowed-tools` 或 hooks 的 skill 会先问。**这是本月对无人值守流程影响最大的一条。**
- **未知模型 ID 默认按 1M 上下文算**（2.1.323）：之前是 200K。网关后面接其他厂商小窗口模型的，要提前设 `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`，否则窗口满了会每轮报错直到 `/clear`。
- **会话之间互发消息的上限**：同一台机器上会话互相发消息不用你介入的上限，从约 20 条提到 100,000 条（2.1.323）。
- **MCP tasks 进了终端**（2.1.319）：MCP server 把工具调用作为 task 跑时，Claude Code 直接转后台，跑完再通知 Claude；Bedrock / Vertex / 网关这些拿不到 feature flag 的环境也能用。
- **两个会改变默认行为的 2.1.319 Changed**：自行调度的 `/loop` 在某一轮结束时没有重新调度就会结束，不再自动排一个兜底唤醒（`CLAUDE_CODE_LOOP_KEEPALIVE=1` 恢复旧行为）；关闭遥测或 feature flag（包括走 LLM 网关）时，auto mode 不再退回内置分类器，服务端判断不了的调用会询问或拒绝。
- **effort 继续收口**：上月 2.1.316 加了 `CLAUDE_CODE_SUBAGENT_EFFORT`，2.1.317 又改成「子代理或 teammate 用的模型和主会话不同时，用那个模型自己保存的 effort 或默认值」，不再套用会话 effort。2.1.318 给 mod 的 `$.model.fork` 加了 `effort`，旁路小任务可以固定跑 `low`。
- **保护 prompt cache**：后台子代理里的 shell 命令跑满 3 分钟就转到后台（所有 provider），避免缓存过期；SendMessage 发给后台 agent 时，它正在跑的命令也会转后台，消息更早送达。
- **安全**：2.1.321 修了 MCP OAuth 在 server 重定向时把 refresh token 等发给另一个 host；2.1.323 / 2.1.325 又修了一长串 Bash 权限检查和沙箱的漏洞。web 或 shell 工具调用要把你的账号邮箱发到网络上时会先问（2.1.321 收窄为只拦带 User-Agent 的 shell 命令，2.1.325 又扩到脚本、文件写入、web fetch 和 MCP 调用）；Agent SDK 的 hook callback 也支持 `onFailure: "block"`；`deniedMcpServers` 的 URL 条目现在也能挡住 Anthropic 提供的同 URL server 和云会话里的 connector。
- **登录与配置文件更稳**：`claude auth status` 显示 `loginExpiresAt`，`claude -p` 在 claude.ai 登录到期前 10 天往 stderr 打警告；一大批修复针对网络共享 home 目录下 `~/.claude.json` 被清空、被替换或写丢的问题。
- **两个可能影响流程的 Changed**（2.1.317 / 2.1.318）：在 IDE 终端里启动 Claude Code 时不再自动安装或更新 IDE 扩展；Read 工具去掉了「file unchanged since your last Read」占位，重复读同一文件会返回完整内容。

---

## 1. 2.1.325（11-13）

**重点**

- **沙箱里的 Bash 改走正常权限流程**：之前开了沙箱的 Bash 命令默认不弹提示，现在要 `sandbox.autoAllowBashIfSandboxed: true` 才保留旧行为。托管设置里开沙箱的组织，这个值要写在优先级最高的托管来源里。
- **定时任务和 `/loop` 遇到「有权限」的 skill 先问**：skill 声明了 `allowed-tools` 或 hooks 时，定时任务和 `/loop` 会先询问；要无人值守地跑，把 `Skill(name)` 加进 `permissions.allow`。
- **桌面端 / IDE / SDK 的「Always allow」变了**：只有保存的规则真能放行下一次同样的命令时，才会单独提供「只存规则」的选项。依赖它的定时任务可能会停下来等你。
- **只读 git 命令在陌生仓库里先问**：仓库不是项目本身也不是你信任过的，就会询问。用 `--add-dir` 指定这个仓库可以免提示，`additionalDirectories` 设置不算。
- **沙箱保护范围扩大**：`--add-dir` 加进来的目录里的 `.claude` 设置、skills、agents、commands 和 hooks，沙箱内也不能写；isolated worktree 里禁止 `git bisect run`、`git maintenance register|start` 和 `scalar` 的设置命令。
- **子代理被输出上限截断时**会被要求更简短地重答一遍，不再只返回答案的结尾。

**其他**

- **安全**：修复 zstd 压缩响应的解码问题；Bash allow 规则可能运行另一个程序；部分复合命令不经询问就运行；沙箱对 worktree 的设置、hooks 和共享 git 目录保护不全；沙箱内命令在某些情况下能写原生更新器的下载目录。
- **凭据**：沙箱自己起的辅助程序（比如网络桥）不再继承 Claude Code 的登录 token 和 API key；ripgrep、本地 git 和沙箱辅助程序拿不到 mTLS 客户端私钥的口令。
- **权限**：相对路径的 deny / ask 规则（如 `Read(./.env)`）在 `cd` 之后仍覆盖项目，也作用于 `--add-dir` 目录；`mcp__plugin_*_` 开头的规则不再因为大小写不同漏掉插件 MCP。
- **Artifact**：外部可见的 artifact，子代理修改或上传前一定会问；auto mode 的同意只覆盖那一次修改。读自己的 artifact 不再弹权限提示。
- **子代理**：修复 `opusplan` / `haiku` 设置下有独立模型的子代理被换成 plan mode 的模型；修复换了模型的子代理按主会话模型给文件读取和 MCP 结果定大小。
- **上下文 / 模型**：`CLAUDE_CODE_MAX_CONTEXT_TOKENS` 也作用于不认识的 `claude-` 开头模型 ID（比如网关的 `claude-sonnet-latest`）；修复很多第三方网关和 Foundry 上每轮报上下文过长而不压缩；修复保存的 `sonnet[1m]` 在新安装里被改成 API 不认的 ID。
- **Mods**：`/cost`、`$.session.usage()`、`--max-budget-usd` 和成本指标开始计入 mod 的 `$.model.complete` / `$.model.classify` 调用。
- **MCP tasks**：在后台 MCP task 的问题上按 Esc 改为「稍后回答」，问题留在 `/tasks`；task 等你回答时 Claude 会被告知并能提示你去 `/tasks`；问题不会再盖住你正在打的字。
- **插件**：`.mcpb` / `.dxt` 改解压到插件目录下，只读的插件文件夹也能加载；托管设置声明的远程 marketplace 里的插件算组织的，`pluginDigests` 废弃；marketplace 的 `ref` 可以写分支或 tag 上任意 commit 的完整 ID（旧版客户端克隆不了这种 pin）。
- **skills**：`--plugin-dir` 插件里的 `.claude/skills` 不再从上层目录启动的会话加载，要在插件目录里启动。
- **teammate**：tmux / iTerm2 teammate 和 agents view 里按 ← 开的新会话，在会话的目录里启动，不再跟 shell 最后 `cd` 的位置走。
- **prompt suggestions**：连续 8 轮由后台或定时任务发起时刷新得更少，按键或回到终端后恢复。
- **CLI**：`/login` 改隐私设置前会问；`claude -p` 在没有缓存账号数据时先等数据再发第一个请求，干净环境里首次运行会慢几秒。
- **Remote Control**：`claude remote-control` 自己停下时退出码 4（单会话仍是 0），注册失败时 69，方便 service manager 重启；连着的会话有分享链接时，`/resume` 和 `/teleport` 先断开。
- **云会话**：Claude Code on the web、云定时任务和 Cowork 云会话在设了 `sandbox.failIfUnavailable` 时也能启动（托管容器本来就没有命令沙箱）；云会话里 tool search 加载的 MCP 工具描述上限从 4,096 提到 16,384 字符。
- **runner**：自托管 runner 拒绝会话目录或仓库路径是符号链接的会话（`checkout` hook 产生的除外）。
- **VS Code**：新增 prompt suggestions（Tab 接受，`promptSuggestionEnabled: false` 关闭）；新增不创建 API key 的 Console 登录；effort 选择器不再提供超过组织上限或 `maxEffortLevel` 的档位。

---

## 2. 2.1.323（11-12）

这是本月最大的一个版本：78 条 Added / Changed、21 条 Improved、195 条修复。

**重点**

- **Code Mode（实验性，默认关闭）**：Claude 不再一个个请求 Bash / Read / Edit，而是写一段 JavaScript 来调用工具，一段代码里可以并行跑命令、把一个结果用在下一个调用里、只返回需要读的部分。
  - 打开：`CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1`（shell 或 `~/.claude/settings.json` 的 `env`；项目设置里写了不生效）。首次会要求确认，然后重启。组织可以在托管设置里设 `0` 禁用，但不能替用户开启。
  - 限制：只支持终端里的交互式 `claude`，不支持 `-p`、Agent SDK、VS Code、桌面端和云会话；只支持订阅或 Console 账号，网关、Bedrock、Vertex、Foundry 都不行；模型限 Opus 5.5 / Sonnet 5.5 / Haiku 5.5 / Fable 5.2；不能和 Remote Control、Claude in Chrome、computer use、agent teams、OTel 导出、`DISABLE_TELEMETRY` 同时用；代码默认最多跑 10 分钟；Code Mode 会话只能在开着 Code Mode 时恢复。
  - 权限：代码里的每次工具调用仍走 deny / ask 规则和 `PreToolUse` hooks；auto mode 的分类器审的是整段代码，看不到运行时才算出来的值（比如从搜索结果里取的路径）。
  - 界面上看到的还是一个个工具调用，代码要按 `Ctrl+O` 在 transcript 里展开 **Code** 行才看得到。
  - 和 [Codemode 调研](https://research.sorrycc.dev/@sorrycc/codemode) 里 Pi、Codex、Factory Droid 的做法是同一类。
- **未知模型 ID 的上下文窗口从 200K 改为 1M**：`/autocompact` 可以提早压缩，`CLAUDE_CODE_DISABLE_1M_CONTEXT=1` 保持 200K。接其他厂商小窗口模型的，窗口满了会每轮失败直到 `/clear`，所以要在用满之前设好这个变量。
- **会话之间互发消息**：同机会话之间不经你确认可以发的消息数从约 20 提到 100,000；桌面端 Code tab 也从 20 提到 100,000（2.1.321 刚从 10 提到 20）。
- **插件 `engines["claude-code"]`**：`plugin.json` 可以声明支持的 Claude Code 版本范围，超出范围的不安装、不更新、不加载，安装和更新会挑最新的合适版本。`claude plugin validate` 新增对 TypeScript hooks 模块的类型检查（`--strict` 下失败）。
- **MCP 登录要确认**：Claude 用来完成 MCP server 登录的工具在 bypass 和 auto mode 下也会询问；`dontAsk` 这类没人能回答的模式请改用 `/mcp`。v1 MCP 客户端移除，`MCP_SDK_GENERATION=v1` 改为用 v2 客户端的兼容模式。
- **外部可见的 artifact 更新前一定会问**，即使有 allow 规则；Claude 判断不了谁能看到时也会问。
- **`CLAUDE_CODE_DISABLE_AGENT_PROGRESS_SUMMARIES=1`**（2.1.318 起就能用）关闭子代理进度摘要和生成它的请求（anthropics/claude-code#86879）。

**其他**

- **权限**：`/security-review` 运行前先问；「don't ask again」生成的规则像是包含密钥，或者会写进被 git 跟踪的 `settings.local.json` 时，只在本次会话有效，不保存。
- **权限**：`PreToolUse` hook 返回 allow 后权限检查出错，按「没有 hook 回答」处理；`PermissionRequest` hook 改写过的输入检查失败时，再问一次或拒绝。
- **权限**：启动时警告变量值里带 `*` 的 Bash allow 规则（如 `Bash(PORT=* npm run dev)`）；修复 `Bash(ls*)` 这类紧贴通配符的规则在某些情况下跳过提示，`Bash(NODE_ENV*)` 这种以变量名开头的现在会问；修复经 `sudo`、`env` 等包装的命令漏过 deny / ask 规则；修复 `defaultMode: auto` 在 auto mode 不可用时进入可能放行更多的模式，现在退回 Manual。
- **沙箱**：macOS / Linux 上 `git worktree add|move|remove` 以只读失败，在非本会话的 worktree 里 commit 也一样；经由可写目录里的符号链接授予的写权限会被忽略，要授予真实路径；`--settings` 文件不是合法 JSON 又带 `sandbox` 键时直接停止启动。
- **凭据**：Claude Code 自带的 ripgrep 和大部分内部 git 命令不再带着它的登录 token 和 API key 运行，挂在这些 git 命令下的 credential helper 或 hook 拿不到它们。
- **Mods**：对 `engine.create` 的 `*`、命名空间或取反 hook 只能观察，要增删 `$` 名词得按名字 hook `engine.create`；`claude plugin validate` 会拒绝写法不对的；mod 的 pane 新增 `isPromptCovered` 属性；修复 mod 能改写 Claude Code 自己的确认问题。
- **插件**：git submodule 不在记录的 commit 上时安装失败；安装命令写了 stderr 时显示警告而不是成功；`claude plugin install --json` 新增 `unsetOptionCount`；插件的 `agent` 设置废弃（仍生效，但会警告）；移除 `subagentStatusLine` 设置（2.1.319 才给它加了 `${CLAUDE_PLUGIN_ROOT}`）。
- **hooks**：`claude -p` 和 SDK 里 hook 跑得久时每 30 秒发一次进度心跳，宿主（比如桌面端）不会以为卡死而结束这一轮；`PreCompact` / `PostCompact` 和压缩后的 `SessionStart` hook 在子代理压缩时带上 `agent_id` 和 `agent_type`。
- **代理**：组织设置和策略请求不再用只由 `ALL_PROXY` 设置的代理，需要代理请设 `HTTPS_PROXY`（和 2.1.319 证书修复的方向一致）。
- **环境变量**：新增 `CLAUDE_CODE_RESUME_HINT_COMMAND`，启动 Claude Code 的程序可以让退出提示显示自己的恢复命令；`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS` 上限从 64,000 提到 300,000；Perforce 项目会提示一次 `CLAUDE_CODE_PERFORCE_MODE`。
- **用量**：模型需要的 usage credits 关闭或用完时，弹出选项菜单（停止、改用 credits、升级）；修复 Fable 周限额不显示重置时间和选项菜单。
- **压缩 / 会话**：修复再次 `/compact`（或在 `/context` 之后）把还没回答的消息压掉；修复恢复的会话把你的下一条消息接到一条没恢复的中断消息上；修复改了很大的文件后下一次输入时内存暴涨；多个子代理时，结束的子代理的 transcript 更早释放。
- **登录**：一批修复针对后台会话在具名 Anthropic profile、shell 里的 API key 之间悄悄切换登录，现在会停下并说明；`/logout` 在后台会话里现在会登出本机所有会话并删除保存的 MCP 登录和插件密钥。
- **teammate**：分屏 teammate 会校验请求来自它的 lead，lead 不在了的请求会被拒绝；`/clear` 或 `/resume` 后要重发计划批准。
- **workflow**：桌面端 Code tab 里的 workflow 碰到用量上限会暂停，重置后继续。
- **Remote Control**：切 Wi-Fi 或重连 VPN 后不再显示断开一分钟以上；在同一目录 4 小时以后重启也保留身份（最长 30 天）。
- **OTel**：只配了 endpoint 没配协议时默认 `http/protobuf`；导出超时上限改为 25 秒（之前 30 秒）；一条格式错误的 `OTEL_RESOURCE_ATTRIBUTES` 不再丢掉整个变量。
- **VS Code**：未信任的文件夹首次会话前先弹信任提示；运行中的 Bash / PowerShell 命令输出直接显示在命令卡片下面。
- **云会话**：自托管环境的新会话也有 No repository 选项；定时任务因为设置要求沙箱而起不来时发失败通知；删除会话时提醒会暂停在其中运行的定时任务。
- **Claude Tag**：Enterprise 计划下 Slack 里发起的 Claude Tag 会话进入 Compliance API（beta）。
- **Code Review**：管理设置新增 Download CSV，按仓库、按月 / 周 / 日导出 review 成本。
- **其他**：Artifact 工具的资源上传支持 `.docx`；`/stickers` 改为提示贴纸已领完。

---

## 3. 2.1.322（11-10）

- Vertex 的 global、us、eu 区域支持 fast mode，Vertex 拒绝时回退到标准速度。只有这一条。

---

## 4. 2.1.321（11-09）

**重点**

- **Claude Fable 5.2**（`claude-fable-5-2`）成为默认 Fable 模型：1M 上下文，$8 / $40 每百万 token，cache read $0.20。
  - 保存过的 Fable 5.1 选择迁到 `fable`：Pro / Max 立即迁，Team / Enterprise 等组织放开；`/model claude-fable-5-1` 切回。
  - 社区反应见 [Ben's Bites 十一月摘要](https://research.sorrycc.dev/@sorrycc/bens-bites-2026-11) 的 11.10 一期（Ben 建议几乎所有事都用 medium / low 推理档）和 [Fable 5.2 改进代码库 Prompt 合集](https://research.sorrycc.dev/@sorrycc/fable-5-2-prompts)。
- **Mods 的工具调用不再弹权限提示**：`$.tool.call`、`$.mcp.call` 即使碰上你的 ask 规则，或者在 `dontAsk` 和 `-p` 下，也不提示；deny 规则和组织策略照样生效。Claude 写的 mod 在 auto 和 bypass 模式下直接开启，在 `dontAsk` 下不加载。
- **fast mode 被限流或过载时**先在同一个模型上试标准速度，不再丢回复、换模型或重试好几分钟；fast mode 的标签改为显示当前模型名，去掉「(Opus only)」。
- **账号邮箱检查收窄**：只拒绝同时带着你的邮箱和 User-Agent 的 shell 命令（不再询问），其他命令和定时运行不会再卡在它的提示上。2.1.325 又把范围扩到脚本、文件写入、web fetch 和 MCP 调用。
- **MCP OAuth 安全修复**：server 重定向时，refresh token 等秘密被发给另一个 host。
- **`claude remote-control --settings <file>`**：给它启动的每个会话套用一个设置文件；Remote Control 会话固定在启动目录，连上的客户端不能再把它挪走。

**其他**

- **权限**：`/bin/cp` 这种带路径的 `cp` / `mv` 也做路径检查；修复 `cp` / `mv` 到目录时 deny 规则和受保护文件提示不生效；修复只读 Bash 命令在沙箱外不经提示运行。
- **上下文**：后台命令通知和 TaskStop 结果里超过 1,000 字符的命令只给 Claude 看开头和结尾；图片多到一个请求放不下时，Claude 会知道被丢掉的图片它是否已经看过。
- **skills**：`~/.claude/plugins` 里的 `.claude/skills` 不再因为 Claude 在那里改文件而加载；headless 会话在 `.claude/skills` 里的 mod 文件变化时会重载（`CLAUDE_CODE_PLUGIN_DIR_WATCH=0` 关闭）。
- **托管设置**：托管的 `extraKnownMarketplaces` 声明的名字不能再从其他来源添加，被接管的数据保留 `cleanupPeriodDays` 天，选项和密钥保留到 `claude plugin restore-set-aside`。
- **Windows**：找 git 等程序时跳过相对路径、UNC 和指向网络共享的 PATH 条目；启动和首个命令更快。
- **`/model`**：「More models」变成列表底部不编号的一行，旧模型收在下面，不会打乱其他编号。
- **网关**：Bedrock / Vertex / Foundry upstream 忽略网关环境里的 `ANTHROPIC_*_BASE_URL`，要换 endpoint 就在 upstream 上设 `base_url`；`policy_mode: layered` 下托管 MCP server 会叠加所有匹配的策略；花费上限错误按本地时间显示重置时刻。
- **runner**：被服务端拒绝的按需 runner 改为以 0 退出（2.1.323 又改回 1）。
- **修复**：网络路径（UNC、WSL、`/net`）上 Edit 改错匹配、空 `old_string` 替换整个文件、`NotebookEdit` 覆盖第一个单元格；回复中途断开时报 `EPROTO`；`/config` 把 auto 默认模式显示成 Manual；长会话反复读大文件单行的高内存。
- **安装**：`claude install` 和安装脚本快 2 ~ 4 秒；加载 TLS 证书更快，启动更快。

---

## 5. 2.1.319（11-06）

**重点**

- **终端支持 MCP tasks**：MCP server 把工具调用作为 task 运行时，Claude Code 立即把它转到后台，跑完后把结果告诉 Claude。`CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND` 改为在工具调用里等待；不依赖 feature flag，Bedrock / Vertex / Foundry / LLM 网关 / `DISABLE_TELEMETRY` 下都能用，`CLAUDE_CODE_DISABLE_MCP_TASKS=1` 关闭。背景见 [MCP Tasks 与 Elicitation](https://research.sorrycc.dev/@sorrycc/mcp-tasks-elicitation)。
- **`permissions.denyInsteadOfPrompting`**：本来要等权限提示的工具调用直接拒绝，这一轮继续跑。终端会话、子代理和 teammate 都适用，适合无人值守的场景。
- **auto mode 不再退回内置分类器**：关闭遥测或 feature flag（包括走 LLM 网关）时，服务端检查不了的调用会询问或拒绝；`CLAUDE_CODE_AUTO_MODE_SERVER=0` 继续用内置分类器（Bedrock / Vertex / Foundry 不变）。网关后面用 `CLAUDE_CODE_AUTO_MODE_SERVER=1` 可以在设了 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` 时仍开启服务端检查。
- **自行调度的 `/loop` 行为变了**：某一轮结束时没有重新调度，loop 就结束，不再排一个兜底唤醒；`CLAUDE_CODE_LOOP_KEEPALIVE=1` 恢复旧行为。
- **`/tasks` 新增「Earlier in this session」**：列出已结束的子代理，离开列表或重启后也能重新打开并给它发消息。
- **几个安全修复**：构造的环境变量前缀能让部分命令躲过权限检查（Bash 权限绕过）；创建 worktree 时的沙箱逃逸；`sed` 命令在 accept-edits 和 auto mode 下可能跳过权限检查；带引号的命令漏过 Bash deny / ask 规则。

**其他**

- **环境变量**：新增 `CLAUDE_CODE_DISABLE_FEATURE_FLAGS`，只停 feature flag 拉取、不关遥测，所有 flag 用内置默认值。
- **登录**：claude.ai 登录到期后改用 `ant auth login` 的登录继续时会警告（费用记到 Claude Console 组织），启动时也会打一行说明计费的 Console 组织。
- **权限**：会话里精确的 Bash / PowerShell ask 规则被更宽的 deny 规则覆盖时，直接拒绝，不再询问。
- **权限**：Bash 工具运行带了查询 / 显示以外参数的 `which` 前会询问；`timeout 30 rg foo` 这类用 `timeout` 包一层的只读命令不再弹权限提示。
- **权限**：项目设置文件或插件不能再把你在项目外关掉的 auto mode 服务端检查重新打开；Monitor 的 WebSocket watch 对每条 Bash 命令都走规则（deny 拒绝；ask 规则下 Monitor 的 allow、bypass 或 auto mode 都不再跳过提示）。
- **权限**：`--add-dir` 的目录要先接受它自己的 trust 对话框才会注册插件 marketplace；开了 Bash 沙箱时，起始目录下层的 `.claude/skills` 只有从那里启动或 `/cd` 过去才加载。
- **auto mode**：修复 `claude -p` 在 auto mode 因为没有安全检查而被拒绝时仍以 0 退出（现在 1）；修复 `/status` 在服务端检查没到达会话时仍显示「Auto mode server: Enabled」；权限规则或 `autoMode` 设置很大时会说明拒绝原因。
- **hooks**：新消息打断这一轮后才完成的工具调用，也会跑 PostToolUse hook（最多 10 秒）。
- **子代理**：safeguards 停掉子代理后，Claude 会用更窄的 prompt 重试或告诉你，不再自己把活干了。
- **子代理**：修复 `/clear` 停掉仍在运行的后台 agent、teammate 和 workflow 的命令；修复后台 agent 之后的报告被拒绝时静默丢失；修复压缩后子代理被告知去等它没启动过的后台 agent 的完成通知。
- **上下文**：`/context` 在终端给 Claude 读的表格变短（每个列表保留最大的 10 行，按需加载的 MCP 工具每个 server 一行）；修复 `/context` 每轮都把完整的可视化网格发给 Claude。
- **MCP**：修复走旧握手的 MCP server 因为 Claude Code 声明了新扩展而连不上或返回空结果；修复 claude.ai connector 上长时间运行的工具调用在 `--resume` 后不报结果。
- **配置文件**：Windows 上存配置时等其他程序释放文件更久，`~/.claude.json` 更不容易被清空；home 里有新旧两个名字的配置文件时，stderr 会说明用的是哪个；在只读目录或 bind-mount 文件上磁盘写满时，配置和编辑的文件不再变成空或被截断。
- **CLI**：`/model` 把旧模型收进「More models」；打错模型名（比如 `opus-5-5`）会建议你想要的模型，不再让你更新 Claude Code；修复开头有空格、Tab 或换行的斜杠命令被当成普通文本发出。
- **CLI**：修复 401 请求每次重试都刷新登录，导致其他会话也 401；修复 Linux 上项目在 NFS / SMB / Lustre 等网络文件系统时启动会列出所有文件。
- **Bash**：修复几乎立即结束的后台 Bash 命令丢输出却被报告为完成；修复 Write 读不到要覆盖的文件时把这一轮当成拒绝结束。
- **代理 / 证书**：只设了 `ALL_PROXY` 时不再自动修复 TLS 检查代理的证书，改设 `HTTPS_PROXY`；`CLAUDE_CODE_PROXY_RESOLVES_HOSTS` 在宿主管理网络时只能从进程环境变量设，设置文件不再生效。
- **Claude in Chrome**：短暂断开后最多等 6 秒等会话自己的浏览器回来；`javascript_tool` 最多 60,000 字符的结果留在对话里；移除 `shortcuts_list` 和 `shortcuts_execute`。
- **Mods / 插件**：修复 `claude plugin update`、`/plugin` 的「Update now」和后台自动更新不安装新版插件新增的依赖；插件的 `subagentStatusLine` 命令支持 `${CLAUDE_PLUGIN_ROOT}`。
- **云会话**：会话迁到新 worker 时不再丢掉会话级 deny / ask 规则（保不住时会丢掉会话级 allow 规则，可能会再问一次）；`/loop` 确认信息提醒计时器会随容器停止；Send now 不再停掉正在跑的后台 agent。
- **runner**：**`CLAUDE_RUNNER_CHECKOUT_PATH` 改为每个仓库一个文件夹**，同名文件夹加 `-2`、`-3`…；会话结束时不再上传 debug 日志；`--trust-workspace false` 也会阻止仓库设置文件和 skill 里的 hook。
- **Remote Control**：修复 `claude remote-control` 在首次运行问题没有回答时静默以 0 退出（现在说明原因并以 1 退出）；不带换行的管道 `y` 也算回答 yes。
- **网关**：没有花费上限的开发者在 `/usage` 里能看到今天、本周、本月的花费；新增 `admin.pooled_conflict_rule` / `admin.pooled_priority_order`，决定开发者属于多个组时先扣哪个共享预算（`pooled_budget`，十月 2.1.316 新增）；新增 `login_notice`、`CLAUDE_GATEWAY_LOG_FORMAT=json`；花费上限错误改为「spend limit reached · resets Dec 1」。
- **网关**：新增几条启动警告，包括策略没有 `desktopHome` 却依赖 `coworkTabEnabled: false` 或 `chatSessionRetentionDays`（为 Claude Desktop 11/10 的变化做准备）。
- **OTel**：`claude_code.session.count` 不再把没被认领的 Agent SDK `prewarm()` 进程算进去。
- **VS Code**：超过 50,000 字符的 prompt 不再被静默截断；修复窗口重载后执行未批准的计划。
- **Code Review**：解绑 GitHub 组织时同时关掉它在 Code Review 里的 All repositories 设置，重新绑定后要手动打开。

---

## 6. 2.1.318（11-04）

**重点**

- **后台子代理里的 shell 命令跑满 3 分钟就转后台**：所有 provider 都这样，避免命令运行期间 prompt cache 过期。
- **`$.model.fork` 新增 `effort`**：mod 的旁路小任务可以不管会话 effort 固定跑 `low`，结果里会报告实际发送的 effort。
- **`deniedMcpServers` 的 URL 条目也会挡住上游 URL 匹配的 Anthropic 提供的 server**，以及云会话和自托管 runner 里的 connector；其他 connector 按名字拒绝。
- **登录到期提醒**：
  - `claude auth status` 新增 `loginExpiresAt`，`claude -p` 的 JSON 结果新增 `credential_expires_at`
  - claude.ai 登录到期前 10 天，`claude -p` 文本输出会往 stderr 打一行警告
  - 到期时的错误会直接说明，并在 `claude -p` 里提示用 `claude auth login` 或 `claude setup-token`
- **不再自动装 IDE 扩展**：在 IDE 终端里启动不再自动安装或更新 IDE 扩展，需要从外部终端跑 `/ide`，或者去编辑器的扩展视图里装。
- **云会话 No repository 选项**：Anthropic 托管环境的云会话可以不选仓库直接启动。

**其他**

- **子代理**：Bedrock / Vertex / Foundry 或关闭遥测时，子代理进度摘要遇到冷缓存可以最多等 5 分钟子代理的响应。
- **子代理**：「Switch models when a message is flagged」设为「Ask each time」时，子代理直接停下，不再自己换模型。
- **子代理**：修复 workflow 在用量上限后恢复时重跑已完成的 agent；修复后台子代理运行时「Now using usage credits」大约每 30 秒弹一次。
- **Mods**：Claude Code 问你要不要开启它在会话里写的 mod 时，会记录你的回答。
- **Mods**：mod 在 `prompt.submit` 附加的内容留在用户这一轮里，不再作为 system message 发出。
- **Mods**：修复 headless 和 SDK 会话里 mod 挂了 `turn.step` 时，被 API 错误截断或被停掉的回复被报告为成功。
- **Mods**：You should know 的 toast 文案从「press 2」改为「try again」（「press 2」只在终端里有效）。
- **上下文**：撤回了 2.1.288 的一个修复：从 2.1.286 或更早版本开始的会话，恢复时之前的 thinking 可以被丢掉。
- **压缩**：修复 idle compaction 用一条不是摘要的回复替换了整段对话。
- **权限**：修复发完消息后紧接着敲的键，或慢出现的权限提示之前敲的键，被当成权限提示的回答。
- **权限**：`/claude-api managed-agents-onboard` 给新 agent 的内置工具和模板里的 MCP 工具默认使用 `auto` 权限策略（「Judge risky actions」），和 Claude Console 一致；说「run without asking」可以不用。
- **权限**：`/permissions` 的规则详情、内置规则和删除确认改用标准对话框，按两次 Ctrl+C 是返回或取消，不再退出。
- **配置文件（网络共享 home 目录）**：一大批修复。`~/.claude.json`、设置文件和登录信息更不容易被删、被短暂清空或被旧副本替换；配置文件被误报不存在时会再找一次；`/logout`、`claude mcp remove` 等在写不进配置时不再假装成功；磁盘满但还能新建文件时，登录信息不会被替换成空文件。
- **配置文件（`~/.claude.json` 损坏）**：非交互启动遇到不是合法 JSON 的 `~/.claude.json`，不再用默认值覆盖，而是直接失败并说明怎么恢复（anthropics/claude-code#87551）；空文件且没有备份时按「文件不存在」正常启动；`claude -p` 和 SDK 在没有改动时不再每次都重写这个文件。
- **CLI**：用量上限菜单里的「Ask your admin for more usage」一步发出请求；自动更新验证时的短暂网络错误会立即重试。
- **MCP**：工具还没加载就被调用时，MCP 错误会带上它的 input schema；版本探测时就退出的 stdio server 不再每次启动都重新探测，3 秒内因自身原因退出的 server 会固定走旧握手 7 天；`claude mcp add` / `remove` 写配置时会等锁。
- **云会话**：内置 Chromium 有了常见的 Chrome 名字，Playwright 以外的工具也能通过 `google-chrome` 和 `CHROME_PATH` 找到它。
- **云会话**：connector 搜索结果会告诉 Claude 只搜了 connector 目录的一部分；`gh run view --log` 和 `gh api` 读 GitHub Actions 日志在大多数环境里能拿到内容了。
- **runner**：spawn-runner hook 环境变量新增 `CLAUDE_RUNNER_SPAWN_REASON`（如 `runner_lost`、`resumed`）。
- **runner**：**orchestrator 日志格式变了**：`ok session=…` 在所有日志级别都打到 stdout，`nack session=…` 的 `reason=…` 移到 `retryable=…` 后面。匹配 `retryable=true:` / `retryable=false:` 的脚本要改。
- **Remote Control / runner**：更新或清理版本删掉仍在运行的进程的二进制后，`claude remote-control`、后台 daemon 和 runner 不再报 `spawn ENOENT` 起不来新会话。
- **网关**：`mantle` upstream 支持 `assume_role`，可以用另一个 AWS 账号里的角色，也能按开发者归属 AWS 成本。

---

## 7. 2.1.317（11-03）

**重点**

- **子代理和 teammate 用的模型和主会话不同时，用该模型保存的 effort 或其默认值**，不再用会话的 effort。
  > 和十月的关系：10/28 @bcherny 的用量调查结论里，「子代理默认继承 xhigh」是主要原因之一。2.1.316 的 `CLAUDE_CODE_SUBAGENT_EFFORT` 是手动开关，2.1.317 把「换了模型的子代理」也默认从会话 effort 里摘出来了。
- **web 或 shell 工具调用要把你的账号邮箱发到网络上之前，先询问。**
- **Agent SDK 的 hook callback 支持 `onFailure: "block"`**，callback 出错时阻止动作（十月 2.1.295 只给了 command/HTTP hook）。
- **Read 工具去掉「file unchanged since your last Read」占位**：重复读没改过的文件也会返回内容。好处是不会因为占位丢信息，代价是重复读会多花 token。
- **网关成本报表 API** `GET /v1/organizations/analytics/cost`：按日期范围看历史花费，可以看总数，也可以按开发者、按天、按 IdP 组拆分。

**其他**

- **子代理**：SendMessage 发给正在运行的后台 agent 时，它正在跑的命令转到后台（不会停掉），消息更早送达。
- **子代理**：修复在提示符按 Ctrl+C 清空输入时把所有后台 agent 一起停掉。
- **effort**：修复项目里的 `effortLevel` 对桌面端 Code tab 这类「先预启动、再打开到项目」的会话不生效。
- **Mods**：内置 `plugin-authoring` skill 在你做的 mod 跑通后，会主动提一次帮你分享。
- **Mods**：修复 Remote Control 和 SDK 宿主对 mod 的工具调用提供「don't ask again」。
- **压缩**：修复 CLAUDE.md 很大且有改动时，自动压缩后报「Prompt is too long」。
- **压缩**：修复压缩不得不缩短自己的请求时，超长会话丢掉之前的摘要。
- **压缩**：修复网关吞掉 Bedrock 的「Input is too long.」，会话每轮报「upstream rejected the request」而不去压缩。
- **缓存**：`DISABLE_PROMPT_CACHING_OPUS` / `DISABLE_PROMPT_CACHING_SONNET` 对 `[1m]`、其他区域和不带日期的默认模型写法也生效了。
- **工具**：Grep / Glob 搜索超时只拿到部分结果时，Claude 不会再当成完整结果。
- **权限**：`/schedule` 新建云端定时任务时，如果带上了你没要求的 connector，会警告并告诉你怎么去掉。
- **权限**：auto mode 对子代理的工具调用给不出判断时，主视图会显示提示（之前什么都不显示）。
- **权限**：修复 agent team 的 teammate 在 tmux / iTerm2 面板里以 auto mode 启动，而 lead 会话是手动模式。
- **CLI**：`claude -p` 在磁盘满或配额用尽导致 transcript 或 `~/.claude.json` 写丢时，打印错误并以 1 退出（之前是 0）。
- **CLI**：退出时打印的「Resume this session with」会带上你启动时的参数（比如 `--chrome --debug`）。
- **MCP**：云会话新增**链接卡片**：MCP server 要你打开某个链接时，可以打开或拒绝，不会再被忽略。这接着十月 2.1.316 的表单卡片，云会话里两种 elicitation（表单和 URL）都有了 UI。
- **MCP**：修复部分桌面端会话里项目和本地 MCP server 在第一轮之后断开；修复 stdio MCP server 在 env 里把 `AWS_BEARER_TOKEN_BEDROCK` 设为空时收到空值，现在会直接 unset。
- **云会话**：新建定时任务默认用管理员选的组织默认环境。
- **runner**：`CLAUDE_CODE_DISABLE_NESTED_SESSION_ID=1` 让 session 里跑的 `claude -p` 继续用该 session 的 ID 和 transcript（旧行为）；默认已修成不再共享。
- **runner**：遇到 501 / 529 以外的 5xx，或心跳没有回应时，改为新开连接，不再复用出错的连接。
- **网关**：设置了 `admin:` 的网关每天记录每个开发者所在的 IdP 组，保留 `admin.identity_retention_days` 天，成本报表按它分组。
- **网关**：修复组共享预算（`pooled_budget`，十月 2.1.316 新增）用完后，状态栏和 `/usage` 把个人额度显示成 100% 已用。
- **OTel**：metrics、events、spans 新增 `anthropic.plan`、`anthropic.seat_type`、`anthropic.provider`、`anthropic.custom_base_url`；修复经代理导出时卡死或连接风暴，导出超时 10 秒（`OTEL_EXPORTER_OTLP_TIMEOUT` 最多 30 秒）。
- **桌面端 Code tab**：组织的远程托管设置还没加载到会话时会显示提示，加载完再提示一次。
- **Claude Tag**：在 Slack 新贴的 artifact 链接显示为带 Open 按钮的简洁卡片，点开直接在 Claude 里打开。

---

## 8. 本月要记住的日期

| 日期 | 事项 | 来源 |
|---|---|---|
| ~~11/10~~ | Claude Desktop 变更：网关策略没有 `desktopHome`、却依赖 `coworkTabEnabled: false` 或 `chatSessionRetentionDays` 的，网关启动时会警告（已过） | 2.1.319 |
| 11/09 起 | Fable 5.1 的保存选择迁到 `fable`（即 Fable 5.2）：Pro / Max 立即，Team / Enterprise 等组织放开 | 2.1.321 |
| **11/30** | Opus 4.8 fast mode 移除，之后请求直接报错，不回退到普通 Opus 4.8 | 2.1.316（十月） |
| 12/14 | 独立版 Claude Design（claude.ai/design）关闭；2.1.317 起 `/design-sync` 会提前提示设计系统已迁到 Claude | 2.1.302（十月）/ 2.1.317 |

---

## 9. 对我来说值得做的事（暂定）

1. **还在用 Opus 4.8 fast mode 的，11/30 前迁到 Opus 5.5。**
2. 给子代理配了不同模型的，升到 2.1.317 后检查它们实际用的 effort：现在跟着各自模型保存的值走，不再跟会话。
3. 写 mod 时，旁路任务的 `$.model.fork` 加上 `effort: "low"`。
4. 依赖在 IDE 终端里自动装扩展的，改成手动 `/ide` 或在扩展视图里装。
5. CI 里用 `claude -p` 的：看一下 stderr 的登录到期警告，或者用 `claude auth status` 的 `loginExpiresAt` 做监控；自托管 runner 的日志匹配脚本按新格式改。
6. 依赖自行调度 `/loop` 一直挂着的，升到 2.1.319 后确认 loop 还在；要旧行为就设 `CLAUDE_CODE_LOOP_KEEPALIVE=1`。
7. 走 LLM 网关或关了遥测、又在用 auto mode 的：2.1.319 起不再退回内置分类器，确认 `/status` 里 auto mode server 的状态，必要时设 `CLAUDE_CODE_AUTO_MODE_SERVER`。
8. 无人值守的会话（CI、teammate）考虑开 `permissions.denyInsteadOfPrompting`，避免卡在权限提示上。
9. 自托管 runner 依赖 `CLAUDE_RUNNER_CHECKOUT_PATH` 目录结构的脚本，按「每个仓库一个文件夹」改。
10. **开了沙箱、靠它免提示跑 Bash 的，升到 2.1.325 前加上 `sandbox.autoAllowBashIfSandboxed: true`**，否则无人值守的会话会卡在提示上。定时任务和 `/loop` 用到带 `allowed-tools` 或 hooks 的 skill 的，把 `Skill(name)` 加进 `permissions.allow`。
11. 网关后面接非 Claude 模型或者模型 ID 不被识别的：2.1.323 起默认按 1M 窗口算，小窗口模型提前设 `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`，或者用 `CLAUDE_CODE_MAX_CONTEXT_TOKENS` 给准确值。
12. 想试 Code Mode：`CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude`，挑一个要改很多文件或要筛搜索结果的任务，`Ctrl+O` 看它写的代码；记住恢复会话时也要开着这个变量。可以和 [Codemode 调研](https://research.sorrycc.dev/@sorrycc/codemode) 里的结论对照。
13. 用 Fable 的：确认 `/model` 已经是 Fable 5.2，留意 $8 / $40 的价格；日常任务按 Ben 的建议用 medium / low effort。
14. 做插件的：在 `plugin.json` 里加 `engines["claude-code"]`；用了 `subagentStatusLine` 或插件 `agent` 设置的，按 2.1.323 的移除 / 废弃调整。

---

## 待补充

- 11/13 之后的版本
- X（@ClaudeDevs / @bcherny / 社区）和 Reddit r/ClaudeCode 对本月改动的讨论，特别是 Code Mode 的实测和沙箱默认值的变化（11/15 搜了一次，还没找到像样的讨论）
- Ben's Bites 后续几期里和 Claude Code 有关的内容

## 参考链接

- Changelog：<https://code.claude.com/docs/en/changelog.md>
- Code Mode 文档：<https://code.claude.com/docs/en/code-mode.md>
- Fable 5.2 发布：<https://www.anthropic.com/claude-fable-and-mythos-5-2>
- 十月汇总：<https://research.sorrycc.dev/@sorrycc/claude-code-changelog-2026-10>
