Claude Code 2.1.323:插件版本闸门
v2.1.323(11-12)新增实验性 Code Mode 与插件版本闸门,移除 subagentStatusLine、弃用插件 agent 字段,并集中修复 Bash 权限与沙箱问题。
2026-11-13 17:23:23 · Editor: 刘立永Claude Code v2.1.323 于 2026 年 11 月 12 日 22:12 UTC 发布(GitHub Release 时间戳)。这一版新增实验性 Code Mode 与 plugin.json 的 engines["claude-code"] 版本闸门,同时移除 subagentStatusLine 设置、弃用插件的 agent 字段、把 v1 MCP 客户端换成 v2 兼容模式。影响很直接:升级后插件能不能装、老配置还生不生效,要按版本与权限规则重新判定,不是「升完照旧」。
三项退出与弃用,都在本版生效
官方 CHANGELOG 的原文口径如下,三条均无缓冲期,自 2.1.323 起生效:
• Removed:subagentStatusLine 设置被移除,子代理行一律用默认样式;设置文件里仍保留该键也能照常加载,但不再生效。CHANGELOG 未给替代项,也未写未来生效日期。
• Deprecated:插件的 agent 设置仍生效,但启动时、claude plugin list 与 claude plugin validate 三处会告警;官方只写「仍生效」,未写何时移除。
• Changed:MCP_SDK_GENERATION=v1 改为让 v2 MCP 客户端以兼容模式运行(更早的握手、放宽的 OAuth 登录检查),原因是 v1 MCP 客户端已被移除。
另有一条已公告时间点、但不属于本版的弃用:Claude Platform 中文发布说明 2026 年 10 月 30 日条目写明「已弃用 Claude Opus 4.8 的快速模式,并将于 2026 年 11 月 30 日移除」,移除后带 speed: "fast" 的请求返回错误且不回退,需迁移到 Opus 5.5;v2.1.316(10-31)CHANGELOG 有同一条。距今 17 天,要在升级窗口里单独排期。
Code Mode 与插件版本闸门
Code Mode 的官方定义是「实验性、需主动开启」,Claude 写 JavaScript 来调用自己的工具,可在组织级关闭,说明指向 code.claude.com/docs/en/code-mode。本次检索(11-13)多家媒体实测该文档页仍返回 404,官方也未公布吞吐或成本实测数据,因此只能按「新增开关」记录,不能当成性能结论。
engines["claude-code"] 更工程:插件在 plugin.json 里声明支持的 Claude Code 版本范围,超出范围的插件不安装、不更新、不加载,安装与更新会自动挑符合范围的最新版本。同一版还给 claude plugin validate 加了插件 TypeScript hooks 模块的类型检查,每条发现是警告,--strict 才判失败。对维护内部插件市场的团队,这等于把「客户端版本兼容性」从人工核对变成安装期硬约束。
这一版真正的大头是权限与沙箱
CHANGELOG 里成批的 Fixed 与 Changed 指向同一类问题:命令本该弹权限确认却没弹。可核实的几条包括:带尾部通配符的 Bash allow 规则过去会跳过权限提示,含变量名的规则现在一律要问;--permission-mode auto 在 auto 不可用时过去会落进更宽松的模式,现在回退 Manual 先问;claude -p 与 Agent SDK 在 --settings 校验失败时会无沙箱运行 Bash,现在启动即停并点名非法设置;写 .git、.claude 等敏感路径不再提供「don't ask again」。还有一条影响凭据链:Claude Code 自己的 ripgrep 与多数内部 git 命令不再携带登录 token 与 API key,依赖这些令牌的 git credential helper 或 hook 会拿不到。
两个默认值也变了
未识别模型 ID 的上下文窗口假设由 200K 提到 1M,可设 CLAUDE_CODE_DISABLE_1M_CONTEXT=1 保持 200K;第三方小窗口模型若走网关,容易错过压缩点,填满后每轮都可能失败直到 /clear。同机各会话之间无需人工确认的互发消息数由约 20 提到 100,000,Claude Desktop 的 Code tab 同样。这两项不改功能,但会改「什么时候该有人盯一眼」。
给企业技术团队的三条动作
第一,锁版本并读 Removed / Deprecated / Changed 三段。团队统一一个客户端版本,升级前逐条核对这三段——它们改变既有行为,比 Added 更容易让老脚本与插件静默失效;本次三项退出都在 2.1.323 立即生效,没有缓冲期。
第二,升级窗口顺带审一遍共享 allow 规则与 settings 基线。通配符规则现在会重新弹确认,把基线纳入版本管理与变更审计,避免一台构建机改了、其他没改;同时借窗口做凭据轮换,因为内部 git 命令不再透传令牌。
第三,把 11 月 30 日写进变更日历。Opus 4.8 fast mode 移除后请求直接报错,先在测试环境验证 speed: "fast" 调用点,再定迁移到 Opus 5.5 的时间。
我们给山东的制造、商贸客户做用友、金蝶、管家婆等 ERP 实施与系统集成时,升级最怕的不是新功能,而是「老配置还写着、实际已经不生效」:权限基线、接口凭据、作业参数都出现过这种静默漂移。编码 Agent 接入共享开发环境后按同一套办法管——版本锁、基线审计、弃用日历三样都要落表,别只靠启动时那一行告警。
参考来源:
1. GitHub anthropics/claude-code Release v2.1.323(2026-11-12,published_at 2026-11-12T22:12:13Z,含 Code Mode、engines["claude-code"] 及移除/弃用条目) https://github.com/anthropics/claude-code/releases/tag/v2.1.323
2. GitHub anthropics/claude-code CHANGELOG(2026-11-13 检索,2.1.323 / 2.1.321 / 2.1.319 / 2.1.316 条目原文) https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
3. DevelopersIO《Key Updates in Claude Code v2.1.322–v2.1.323》(2026-11-13,破坏性变更与弃用对照表) https://dev.classmethod.jp/en/articles/20261113-cc-updates-v2-1-323
4. Claude Code Daily Briefing 2026-11-13(版本时间线与 2.1.323 变更摘要,第三方口径) https://claude-news.today/en/briefings/briefing-2026-11-13
5. Claude Platform 发布说明(中文,2026-10-30 条目:Opus 4.8 fast mode 弃用与 11-30 移除时间点) https://platform.claude.com/docs/zh-CN/developer-newsletter/july2024