Claude Code v2.1.300:Mods生态再升级,增强稳定性和可观测性

Anthropics 于近日发布了 Claude Codev2.1.300。本次更新共包含 90+ 项变更:8 项新功能、40 余项修复、多项行为改进,并针对 VS Code 插件、云端会话、Slack 集成和 Code Review 场景进行了专项打磨。

✨ 亮点速览

• Mods 插件系统大升级:新增virtualText提示框装饰、$.ui.view()视图 API、prompt.change钩子,agent.spawn钩子首次支持改写工作流 Agent 的 prompt 和 model
• OpenTelemetry 可观测性对标 GenAI 语义规范:追踪 Span 新增gen_ai.provider.namegen_ai.tool.name等标准属性,缓存写入按 5 分钟/1 小时生命周期拆分统计
• Claude Platform on AWS 新增 /advisor 命令
• 修复一个致命的 MCP 问题:API 拒绝 MCP 工具的输入 schema 时不再导致整个会话每轮 400 报错
• 大请求默认启用 gzip 压缩,即便关闭遥测也生效
• Artifacts 更新提速:小改动一次调用完成"修改+发布",大修改单轮响应内完成

本次更新的新功能几乎全部围绕Mods 插件体系展开,官方持续加码其可扩展性:

新能力

virtualText提示装饰

可在输入框中绘制永不进入草稿和提交内容的提示文本

$.ui.view({ agentId })

在主视图中展示某个 Agent 的完整转录,$.ui.view({})一键返回

dir属性

Mods 的Text组件支持从右到左(RTL)文本,Windows 和 VS Code 终端中右对齐显示

prompt.change钩子

输入框文本因"非打字方式"变化时触发:历史回溯、清空、撤销、插件填充

agent.spawn钩子增强

从"只能拒绝工作流 Agent"升级为可改写其 prompt 与 model

/advisor(AWS 版)

Claude Platform on AWS 新增顾问功能,可用环境变量一键关闭

此外,Windows / VS Code 终端下的 RTL 文本渲染也一并就位,国际化支持更进一步。

可观测性:向 GenAI 语义规范看齐

对于重度依赖遥测的团队,这版是重要的里程碑:

• 追踪 Span 加入 OpenTElemetry GenAI 语义约定属性gen_ai.provider.namegen_ai.conversation.idgen_ai.tool.nameerror.type等,开箱即达行业标准
• api_request 事件新增 cache_creation_5m_tokens / cache_creation_1h_tokens,缓存写入成本可按生命周期精细分账
• 本地会话转录开始记录每次 API 请求的 system prompt、工具与参数——你分享出去的转录现在可以完整复现原始请求

会话与稳定性

• MCP 工具 schema 报错不再拖垮会话:此前 API 一旦拒绝某个 MCP 工具的输入 schema,之后每一轮对话都会 400 报错;现在该工具会在会话剩余时间内以无参数形式发送
• 压缩(compaction)后的消息丢失问题:修复了 headless / Agent SDK 会话在恢复时丢失压缩保留的近期消息、甚至"穿越"回压缩前历史的两类场景
• 会话恢复后第一条转录不再丢失(崩溃截断转录末行的场景)
• 自动工具搜索(ENABLE_TOOL_SEARCH=auto)不再在 MCP 服务器重连时中途失效

本版对 git 新一代reftable引用存储做了集中排障:

• 修复分支显示为.invalid--worktree无法重开 worktree 的问题
• 修复 diff 视图(Claude Desktop / Remote Control)感知不到 reftable 仓库中的冲突 cherry-pick / revert
• 修复git commit -q后 OpenTelemetry 事件丢失git_commit_id
• 修复 worktree 会话从错误提交启动(标签/分支名长得像 commit ID 时)

• 修复 forceLoginOrgUUID 拒绝登录后仍残留被拒组织的 token(可能在 /login 后继续存活)——企业用户建议尽快升级
• Hooks 的updatedInput(PreToolUse / PermissionRequest)现在与 Claude 自身输入同等校验:未知键被丢弃,工具拒绝的输入将直接否决调用

• claude daemon stop --any不再"假报停止":现在会等待、必要时强杀,若服务仍在则如实以退出码 1 报告
• 修复远程控制服务器在短暂登录错误(如钥匙串锁定)后放弃续约连接——现在会持续重试并提示需要claude /login
• 退出时对仍在运行的后台命令延迟 1.5 秒后强制结束,全屏模式下不再遗留僵尸进程

VS Code 插件(12 项变更):新增claudeCode.attachSelection设置可阻止编辑器选中文本自动进入消息;修复 fast mode 在额度耗尽后仍滞留导致请求反复被拒、Windows 下 Shift 拖拽文件插入乱码路径、WSL/SSH/Dev Container 中拖拽文件无响应、回车误触发斜杠命令等一串高频痛点。

云端会话(Cowork):修复组织策略读取失败时每轮卡顿 5 分钟的问题;修复 Write/Edit/NotebookEdit 对本机路径"假成功"(文件根本没写入);WebFetch 现在会告知 Claude"页面刚刚访问失败"而不是盲目重取。

Claude Tag(Slack 集成):新增 Slack Connect 共享频道支持(默认关闭);新增私密的"允许一次/拒绝"卡片,Claude 需要审批时会主动询问而非直接拒绝;支持读取 Slack 语音消息转录。

Code Review:修复了 GitHub 组织成员关系设为私有的写权限用户发出的@claude review被忽略的问题。

⚙️ 值得注意的行为变更

• 大请求对 api.anthropic.com 默认 gzip 压缩(与遥测开关解耦),可用CLAUDE_CODE_GZIP_REQUEST_BODIES=0关闭
• claude remote-control 移除了无效的 --sandbox / --no-sandbox 标志,传入会直接报错;请改用设置中的sandbox.enabled
• 托管会话(CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST)将忽略设置中的 CA 证书包、工具代理和 git TLS 变量(如SSL_CERT_FILE
• 次要(暗淡)文本在深色 ANSI 主题和 16 色终端下不再与普通文本难以区分

v2.1.300 是一个典型的"夯实底座"版本:Mods 插件能力、可观测性规范化和大量边缘场景修复三线并进。如果你正在做以下任何一件事,建议立即升级:

1. 在生产环境用 OpenTelemetry 监控 Claude Code(GenAI 语义属性 + 缓存分账)
2. 开发 Mods 插件(新钩子 + 视图 API 大幅扩展了玩法)
3. 企业环境依赖forceLoginOrgUUID或 Hooks 做安全管控(token 残留与输入校验修复很关键)
4. 使用 MCP 服务器或重度使用 git worktree / reftable 仓库

完整变更日志:anthropics/claude-code/releases/tag/v2.1.300