版本 v2.1.128–v2.1.136,2026年5月4-8日。本周功能相对精简,但对插件分发和 Agent 安全控制有实质改进。

核心新功能

插件从 .zip 归档和 URL 加载

是什么:

  • --plugin-dir 现在接受 .zip 文件(之前只支持目录)
  • 新增 --plugin-url flag,从 URL 获取插件归档用于当前会话

使用方式:

claude --plugin-url https://example.com/my-plugin.zip
claude --plugin-dir ./my-plugin.zip

意义:

  • 在加入 marketplace 前试用插件
  • 从制品库(artifact store)分发内部插件,无需 git 仓库
  • 降低了内部工具链的分发门槛

跨项目历史搜索(v2.1.129)

是什么:Ctrl+R 反向搜索默认覆盖所有项目的提示历史(恢复 v2.1.124 之前的行为)。

范围切换:搜索中按 Ctrl+S 缩小到当前项目或会话。

意义:记得上周在另一个仓库运行过某个命令,但不记得具体内容时,可以直接搜索找到。

其他值得关注的改进

worktree.baseRef 设置

控制新 worktree 从哪里分支:

  • fresh(默认):从远程默认分支,未推送的提交不会进入新 worktree
  • head:从本地 HEAD

适用于 --worktree flag、EnterWorktree 工具和 Agent 隔离 worktree。

Auto mode hard deny 规则

是什么:settings.autoMode.hard_deny 中的规则无条件阻止匹配操作,无论 allow 例外如何。

与普通 deny 的区别:普通 deny 可以被 allow 规则覆盖,hard deny 不能。

适用场景:某些操作永远不应该自动运行,即使有更宽泛的 allow 规则覆盖。

Hooks 获取 effort 级别

Hooks 现在通过两种方式获取当前 effort 级别:

  • JSON 输入字段:effort.level
  • 环境变量:$CLAUDE_EFFORT

Bash 工具命令也可以读取 $CLAUDE_EFFORT。

意义:hooks 可以根据推理深度调整行为,例如在 max effort 时执行更严格的检查。

其他改进

  • CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1:退出全屏 alt-screen 渲染器,保持对话在终端原生滚动缓冲区
  • CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE:Homebrew 或 WinGet 安装可在后台运行升级并提示重启
  • CLAUDE_CODE_SESSION_ID 现在在 Bash 工具子进程环境中可用,与传递给 hooks 的 session_id 一致
  • /mcp 显示已连接服务器的工具数量,标记连接了 0 个工具的服务器
  • 子 Agent 进度摘要命中 prompt cache,cache_creation token 成本降低约 3 倍
  • 多个 OAuth 和凭证可靠性修复:并行会话不再在 refresh token 竞争后死锁于 401

对 Agent 工程师的意义

Auto mode hard deny 规则是 Agent 安全控制的重要补充。在构建自主 Agent 时,某些操作(如删除生产数据库、推送到 main 分支)应该永远不自动执行,hard deny 提供了这种无条件保障。Hooks 获取 effort 级别则允许构建”智能 hook”——在高 effort 模式下执行更严格的验证,在低 effort 模式下快速通过。子 Agent 进度摘要的 prompt cache 优化对于大量使用子 Agent 的工作流有显著的成本影响。

与其他概念的关联

  • env-vars — CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN、CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 等
  • cli-reference — --plugin-url、--plugin-dir flags
  • interactive-mode — Ctrl+R 历史搜索行为