跳到主内容

Claude Code v2.1.304：/auto-mode-setup 引导配置上线，Code Review 支持三档强度，并修掉两处会丢数据的删除路径

Claude Code v2.1.304 发布：新增 /auto-mode-setup 引导配置与 Code Review 三档强度，并修掉 worktree 被静默删除、挂载盘 rm -r 缺安全提示两处数据安全问题。

2026-10-21 · Claude Code 官方 CHANGELOG（2.1.304 原始条目，2026-10-21 一手核对）/ GitHub Releases API（tag v2.1.304，published_at 2026-10-19T21:34:39Z）

发布 2026-10-21核实 2026-10-21

常青入口：Claude Code 工具卡 · Claude Code vs Codex 对比 · AI 编程工具评测 · AI 概念百科

要点速览

  • v2.1.304 是当前 stable，GitHub Releases 的 tag 时间戳为 2026-10-19T21:34:39Z（上一版 v2.1.303 为 2026-10-18T22:26:54Z）。
  • 新增 /auto-mode-setup：一次引导式配置，读取你的项目与近期会话来教 auto mode 认识你的环境。官方同时写明它 "now also available on Bedrock, Vertex, Foundry, Claude apps gateway and telemetry-disabled sessions"——这条是覆盖面扩张，不只是给直连 API 的用户。
  • Code Review 加三档强度：组织可选 Quick / Standard（默认）/ Deep，且可以给单个仓库单独设档；另可一键覆盖整个 GitHub 组织的所有仓库（含以后新建的）。
  • 两处会丢数据的删除路径被修：① claude --worktree 在 HEAD 分离或在别的分支上时，退出会连 worktree 和分支一起删掉且不问，可能丢 commit；② 对挂载盘或顶层目录（/Volumes、/media、WSL 的 /mnt/c）执行 rm -r，此前拿不到 rm -rf /Applications 那种安全提示。
  • Pro / Max 恢复旧会话会先给警告：当恢复一个非活跃会话会吃掉 5 小时用量上限里"可观的一部分"时，提示你可以继续恢复，也可以开新会话——官方说开新会话后你提到上一个会话时 Claude 能自己去找。
  • Mods 的权限模型再收紧：tool.check 的答复新增 decider: "person"（只有权限对话框或宿主回调能批准，无人可问时按 mod 给出的理由拒绝）；事件新增 e.isReadOnly。
  • 沿用既有口径：官方 CHANGELOG 的版本标题下不标注发布日期，本版日期取自 GitHub Releases 的 tag 时间，非厂商在 CHANGELOG 中公布的发布日。

/auto-mode-setup：把 auto mode 从"猜"变成"教"

auto mode 是 Claude Code 里让客户端侧分类器自行判断该用什么力度的开关。此前它的问题一直是"它不知道你的项目是什么"——分类器只看到当前请求，看不到你的测试怎么跑、构建脚本在哪、哪些目录不该碰。

v2.1.304 的 /auto-mode-setup 是官方给的答案：一次引导式流程，主动读你的项目结构和最近几次会话，把这些信息喂给 auto mode。这不是配置项的堆砌，而是把"环境认知"这件事产品化。

更值得注意的是它的覆盖面。官方原文点名了 Bedrock、Vertex、Foundry、Claude apps 网关，以及关闭遥测的会话。参照本站此前的记录，Claude Code 的企业平台支持是从 v2.1.281 起才扩到 Bedrock / Vertex / Foundry 的，而这条 /auto-mode-setup 已经默认覆盖到这些通道——说明企业平台侧不再是"二等公民"，新能力开始同步落地。

行动建议：升级到 2.1.304 后，在依赖 auto mode 之前先跑一次 /auto-mode-setup。否则 auto mode 仍然是在没有项目上下文的情况下猜。

Code Review：从"开或关"到"三档 + 组织级"

这是本次最容易被忽略、但对团队影响最大的一项。此前 Code Review 的组织级配置基本是开关粒度，v2.1.304 把它做成了强度档位：

档位官方定位
Quick快速评审
Standard默认值
Deep深度评审

三条配套变化：

  1. 档位可由组织所有者统一设定，也可以给单个仓库单独设档——大仓库用 Deep、文档仓库用 Quick 这种差异化配置终于成立。
  2. 新增"审查组织内所有仓库"的选项，包含以后新加的仓库，不用再一个个勾选。
  3. 修了一个静默失败：管理员刚打开 Code Review 那一两分钟内创建的 PR 会被无声跳过，现在会重试并补评审。

两处删除路径：都是"不问就删"

这两条放在一起看最说明问题——它们都不是功能缺陷，而是安全提示的覆盖盲区：

场景修复前修复后
claude --worktree 退出，且 HEAD 分离或在其他分支直接删掉 worktree 与分支，不询问（可能丢 commit）会询问
对 /Volumes、/media、WSL /mnt/c 等挂载盘顶层执行 rm -r拿不到 rm -rf /Applications 那种安全提示得到同样的安全提示

用 worktree 跑并行 agent 的团队建议立刻升级——本站 git worktrees 并行 agent 方案里推荐的正是这套工作流，而"HEAD 分离时退出即删"恰好是该工作流的高发状态。

其他值得知道的变更

配置与兼容性

  • CLAUDE_CODE_AUTO_COMPACT_WINDOW=200k 此前会静默设成 100K——现在接受 k 与 M 后缀（与 --autocompact 一致），越界或被忽略时会警告。
  • 自定义 ANTHROPIC_BASE_URL 后面，tool search 改为默认开启；网关返回 400 / 422 时会自动不带该字段重试。
  • 修了 LLM 网关后的 context_management: Extra inputs are not permitted 报错——现在会去掉该字段重发。
  • 组织策略在启动时批准 ANTHROPIC_API_KEY、或在 /config 里切换"Use custom API key"后，不再等到每小时那次检查才刷新。

Mods 与 skills

  • settings.read 钩子改为收到每一层配置并重写合并后的结果，于是受管 mod 可以把组织的某项配置变成"上限"（官方点名包括保留期清理用的 cleanupPeriodDays）。
  • 单个来源（一个仓库 / 你的目录 / 一个插件）的 skill 钩子每会话上限 1,024 个钩子、16,384 个 matcher 字符。
  • 压缩后会再发一次 skill 列表；/reload-skills 现在只发新增或有变更的 skill。
  • 新增 /claude-api managed-agents-secure：拿一个 Managed Agents agent 的配置去比对 Anthropic 公布的安全指南，不做任何修改。

其他修复：agent teams 里在主会话批准关闭请求不再把整个 CLI 一起退出；claude --help 中 --tools / --resume / --debug / --json-schema / --disable-slash-commands / --system-prompt-snapshot / claude update 的说明改为与实际行为一致；Windows 上直接调用 Git for Windows 的 git.exe 而不是走 cmd 启动器，git 命令启动更快；Opus 5.5 的 /fast 对话框标题去掉了"(research preview)"标签。

AI 之家 观点

第一，这一版的真正主线是"把默认行为从猜改成问"。 /auto-mode-setup 是问你的环境、worktree 退出是问你要不要删、挂载盘 rm -r 是问你是不是认真的、Pro/Max 恢复旧会话是问你要不要花这份额度。四件事分属不同模块，但方向完全一致——Claude Code 正在系统性地回收"自作主张"的默认行为。对长任务 agent 来说，这个方向的正确性高于任何单点功能。

第二，Code Review 三档强度是一个被低估的信号。 GitHub 侧 Copilot code review 在 10-02 已经把默认 effort 从 Lite 改成 Balanced，Claude Code 这边紧接着给出 Quick/Standard/Deep。两家在同一周做了同一件事，说明"AI 评审的成本必须可调"已经从可选项变成了刚需。有评审成本看板的团队，现在应该把"每仓库档位"当成一项配置资产来管，而不是默认全站一档。

第三，decider: "person" 值得单独看。 它把"这个操作必须有人点头"写成 mod 能声明的一等概念，而不是靠钩子返回 deny 来模拟。区别在于：无人可问时按 mod 给的理由拒绝，而不是放行或静默通过。自建 agent 权限体系的话，这个语义比任何实现细节都值得抄。

判断建议：① 立刻升级，尤其是用 worktree 并行与挂载盘路径的；② 升级后先跑 /auto-mode-setup 再依赖 auto mode；③ 用 Code Review 的组织，本周把每仓库档位配一遍，别等默认 Standard 跑满一个月才发现账单价。

待核实

  • v2.1.297 / v2.1.298 仍然缺失：官方 CHANGELOG 与 GitHub Releases 中均无这两个版本，本站已连续第七次确认。不作推断，不补写编号。
  • 本版的官方公布发布日：CHANGELOG 版本标题下无日期，本版日期取自 GitHub Releases tag 时间 2026-10-19T21:34:39Z。
  • Code Review 三档的具体差异：官方只给了 Quick / Standard / Deep 三个名字与"Standard 为默认"，未公布每档的评审深度、耗时或额度消耗差异。
  • /auto-mode-setup 到底读了什么、写进了哪里：官方只有一句功能描述，未说明产物落在哪个配置文件、是否随项目提交。
  • decider: "person" 在无人值守（headless / SDK）场景的确切行为：官方称"无人可问时按 mod 的理由拒绝"，未定义什么算 nobody can be asked。
  • skill 钩子的 1,024 / 16,384 上限是否可配置：官方未说明超出时的报错形态。
  • Opus 5.5 的 /fast 去掉 research preview 标签是否意味着转正：官方未发独立公告，本站不作等价推断。

来源

口径说明：本文的 /auto-mode-setup 功能描述与覆盖平台名单、Code Review 三档名称与默认值、两条删除路径修复、CLAUDE_CODE_AUTO_COMPACT_WINDOW 后缀支持、decider: "person" 与 e.isReadOnly 语义、skill 钩子上限、/claude-api managed-agents-secure 用途，均取自上述官方 CHANGELOG 原文，其中英文引号内为官方原句。版本日期取自 GitHub Releases tag 时间戳，非 CHANGELOG 标注的发布日。官方未给的信息（各档差异、配置落点、上限是否可配）本站留空并列入待核实。

相关对比

Aider vs Claude Code：终端 AI 编程双雄怎么选

Aider vs Claude Code 2026 选型对比：开源 BYOK 多模型 vs Anthropic 订阅长任务 Agent，从编程能力、多模型支持、价格、Git 集成、国内可用性和适合人群判断，帮你选对终端 AI 编程工具。

Cursor vs Aider：GUI IDE 还是 CLI？2026 对比

Cursor vs Aider 2026 选型对比：GUI IDE vs Git 原生 CLI，从 Composer vs Architect 双模型、Tab 补全、多模型 BYOK、价格计费、开源与否和适合人群判断，帮开发者选对。Cursor 是闭源 VS Code fork 月费 $20，Aider 是开源 Apache-2.0 CLI 自带 API key。

Augment Code vs Cursor：企业 AI 编程怎么选？Context Engine vs AI IDE 对比

Augment Code vs Cursor 2026 选型对比：Context Engine 全仓索引的企业 AI 平台 vs SpaceX 收购的 AI IDE 天花板，从形态、Context 覆盖、长任务、价格、合规、中文支持和适合人群 8 个维度判断，帮你选对企业 AI 编程工具。

Claude Code vs Cline：CLI AI Agent 怎么选？2026 对比

Claude Code vs Cline 2026 选型对比：Anthropic 官方闭源 CLI Agent vs Apache-2.0 开源 VS Code 插件。从模型绑定、工作流、MCP 支持、价格、隐私和适合人群 6 个维度帮你选对 CLI AI 编程工具。

Claude Code vs Codex CLI：终端 AI Agent 双雄对比

Claude Code vs Codex CLI 2026 选型对比：Anthropic 与 OpenAI 两大官方终端 Agent 的模型、长任务、MCP 生态、Windows 支持、订阅打包价格和国内可用性全方位对比，帮你判断该用哪个终端 AI Agent，以及能不能两个一起用。

Claude Code vs Crush：Anthropic 官方 vs 多模型 TUI（2026 实测选型）

Claude Code vs Crush 怎么选：Anthropic 官方 CLI（长任务最稳），对上 Charmbracelet 开源 TUI（多模型切换 + LSP）。按模型、长任务、价格对比。

相关评测

AI 编程工具选型决策树：30 个场景告诉你该用哪个

整合 AI 之家 编辑部 11 篇深度评测的结论：按角色、预算、规模、网络环境四维度的 AI 编程工具决策树。Cursor / Claude Code / Aider / Trae / v0 / Lovable 等主流工具一图看完该选哪个，附 30 个真实场景对应表。

2026 年 AI 编程工具全景图：18 款实测排行

2026 年 AI 编程工具全景：18 款实测按 IDE / CLI / 插件 / Agent / Builder / 本地分桶，给出 Top 10 排行、5 维评分方法论，以及国内 / 海外 / 学生党的选型建议。

Aider 深度评测：把 AI 编程当 git 工作流的极客派最爱

Aider 深度评测：git-native 心智的真实代价、Architect 双模型经济学、与 Claude Code 的决策边界、何时不该选 Aider。AI 之家 编辑部基于官方文档与社区公开反馈整合，非厂商付费内容。