⌘ K
开源Claude Code Releases·原文 2026年9月26日

Claude Code v2.1.283发布：网关提示头、模型白名单与 /doctor prompt-audit

Anthropic发布Claude Code v2.1.283，新增网关提示头、availableModelsMatch与deniedModels托管设置、/doctor prompt-audit审计命令，以及大量MCP、插件、vim模式和Windows相关修复。

AI解读：Claude Code v2.1.283把管理员的模型管控拆成了两个开关：availableModelsMatch设为exact后，availableModels里的条目只放行它写明的那个模型版本，新版本必须先被列进去才能用；deniedModels则用来点名封禁具体模型，即使availableModels已经允许。对在受管环境里跑Claude Code的团队来说，这相当于把"自动跟进新模型"改成了"审过再放行"。

面向LLM网关运维，新增的x-claude-code-prompt-id请求头让网关能把同一个用户提示触发的多个请求归到一组，需要设置CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 才会启用；网关配置里还加了可选的load_test_mode，请求会照常构造和签名但不发往上游，客户端收到预设回复，用来压测部署链路。

/doctor prompt-audit（同 /checkup prompt-audit）会检查CLAUDE.md、技能、代理和命令里那些为旧模型写的提示模式；按照发布说明，过时的路径、过时的命令和互相矛盾的指令文件会排在报告最前面。这个命令面向的是长期维护提示配置、又跟不上模型换代节奏的团队。

这版的重头戏其实是修复清单：SDK会话提前结束时会丢失延迟工具调用或已完成的工具结果、MCP进度通知在长工具调用转后台后被丢弃、会话结束时仍在启动中的stdio MCP服务器被留在后台、无有效URL的MCP服务器登录报错不透明，另外还修了 /model选择器、插件卸载和installed_plugins.json损坏等一批问题。

其他值得注意的改动包括：/context现在把MCP服务器指令单独列一行并计入总数，MCP工具返回的图片会另存为文件以便Bash、Read等工具打开；交互式会话在第三方提供商或关闭遥测、且未配置权限模式时改为以auto模式启动；2.1.282 对claude-ai名称的保留被回退，同名技能、命令、工作流和MCP服务器技能与提示恢复加载。

Claude Code发布v2.1.283，主要新增网关提示头、两个托管模型设置和 /doctor prompt-audit审计命令，同时包含大量针对MCP、插件、SDK会话、vim模式和Windows的修复。

新增的x-claude-code-prompt-id会被加入网关提示头，让LLM网关能够把服务于同一个用户提示的多个请求归为一组；该功能需要设置CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 才会启用。

托管设置方面，availableModelsMatch设为 "exact" 时，availableModels中的条目只允许它写明的模型版本，新版本在被列出前保持禁用；deniedModels用于封禁特定模型，即使availableModels已允许它们。

网关与托管模型设置的新增项

Claude Code v2.1.283为网关场景增加了若干能力。x-claude-code-prompt-id被加入网关提示头，让LLM网关可以把服务同一个用户提示的请求归组，启用方式是设置环境变量CLAUDE_CODE_GATEWAY_HINT_HEADERS=1。

Claude apps网关配置增加了可选的load_test_mode块：请求会被构造并签名但不发送到上游，客户端收到预设回复，用于对部署做负载测试。该网关还新增了mantle上游提供商，对接Amazon Bedrock的Mantle端点。

托管模型设置新增两项。availableModelsMatch设为 "exact" 后，availableModels条目只允许其指名的模型版本，新发布版本在被列出前保持禁用。deniedModels用于封禁特定模型，即使availableModels允许它们。

  • x-claude-code-prompt-id加入网关提示头，需CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 启用
  • load_test_mode：请求构造并签名但不发上游，客户端收到预设回复
  • 新增mantle上游提供商，对接Amazon Bedrock的Mantle端点
  • availableModelsMatch设为exact时只放行指名的模型版本
  • deniedModels可在availableModels允许的情况下封禁特定模型

prompt-audit与可观测性

新增 /doctor prompt-audit（也可用 /checkup prompt-audit），用于审计CLAUDE.md文件、技能、代理和命令中为旧模型编写的提示模式。发布说明称，过时路径、过时命令和互相矛盾的指令文件会排在报告最前面，Claude Code文档中记录的思考关键词会被保留。

当OTEL_LOG_TOOL_CONTENT=1 时，MCP工具、WebFetch和WebSearch的输出会被加到tool.output的OpenTelemetry span事件中。

/context现在会统计MCP服务器指令，它们显示为单独一行并计入总数。MCP工具返回的图片现在也会保存到文件，Bash、Read等工具可以打开它们。

  • /doctor prompt-audit或 /checkup prompt-audit审计提示模式
  • 过时路径、过时命令、矛盾指令文件排在报告前列
  • OTEL_LOG_TOOL_CONTENT=1 时把工具输出加入tool.output span事件
  • /context把MCP服务器指令列为独立行并计入总数
  • MCP工具返回的图片保存为文件，供其他工具打开

修复：会话、MCP与插件

发布说明列出了一批修复。SDK会话在回合提前结束时丢失延迟工具调用或已完成的工具结果、worker重启后仍持有的审批提示、非流式回退的result.usage都得到修复。

MCP方面，长工具调用转入后台后进度通知被丢弃的问题已修复，后台任务现在显示最新进度；会话结束时仍在启动的stdio MCP服务器不再被留在后台；无状态远程MCP服务器（例如重部署中的代理）短暂返回HTTP 404导致该服务器在会话剩余时间内不可用、却仍显示为已连接的问题也已修复；无有效URL的MCP服务器登录不再抛出难以理解的SDK错误，/mcp也不再为此类服务器提供Authenticate。

插件方面修复了多个问题：claude plugin validate不再声称Claude Code接受它无法安装的插件或市场名称；缺少路径或路径指向插件目录之外的outputStyles、themes、monitors、lspServers不再通过验证；claude plugin details不再对在plugin.json中声明服务器的插件显示 0 个MCP服务器；claude plugin marketplace remove现在会列出随市场一起卸载的已安装插件；claude plugin uninstall不再误删id仅大小写不同的另一个插件及其选项和密钥；installed_plugins.json在含有无效插件id记录时不再显示没有插件，在含有本版本无法读取的记录时不再被重写并丢失记录。

其他修复包括：/model不再在id带日期或 -v1:0 后缀时拒绝Sonnet 4.6或Sonnet 5加 [1m]；model选择器不再在ANTHROPIC_DEFAULT_HAIKU_MODEL指定其他模型时显示硬编码的Haiku版本和价格；模型回退期间启动的动态工作流不再让所有代理都跑在回退模型上；DISABLE_PROMPT_CACHING_HAIKU在Haiku作为会话主模型时生效。

  • SDK会话：修复回合提前结束丢失工具调用、worker重启后审批提示未释放、非流式回退的result.usage
  • MCP后台任务现在显示最新进度，不再丢弃进度通知
  • 会话结束时正在启动的stdio MCP服务器不再被遗留运行
  • 无有效URL的MCP服务器登录不再报不透明SDK错误，/mcp不再提供Authenticate
  • installed_plugins.json损坏或含无法读取记录时的数据丢失问题已处理

vim模式、终端与Windows

vim模式修复了多项行为：`.` 不再丢弃Shift+Enter换行、不再把光标留在带重音的字母内、也不再在 `3J` 或Visual模式的 `J` 于最后一行后重复更早的修改；超过 10,000 字符的提示在普通模式下被召回时，光标不再停在末尾之外，`V` 后接 `p` 会落到第一个非空白字符；`J` 合并行时的间距与Vim一致，`3J` 或Visual模式下最后一行的 `J` 也会像Vim一样移动光标。

终端与密钥方面：Warp终端中的markdown链接恢复为可点击超链接；快速连击的按键（type-ahead、按键重复、经ssh或tmux的突发输入）不再基于过期状态处理；内置快捷键指南不再说和弦 1 秒超时（实际为 3 秒），也不再把cmd称为meta的别名；keybindings.json对拼错的修饰键（如ctl+k）会在调试日志中警告并给出修正建议。

Windows修复了PowerShell工具允许cmd /c rd、rmdir、del或erase删除驱动器根目录、主文件夹以及其他Remove-Item会拒绝的文件夹的问题。

  • vim模式 . 命令、光标位置、J合并行为对齐Vim
  • Warp终端markdown链接恢复为可点击超链接
  • 快速连击按键不再基于过期状态处理
  • 快捷键指南修正和弦超时 3 秒和cmd别名说明
  • keybindings.json对拼错修饰键发出警告
  • Windows修复PowerShell工具可删除驱动器根目录等问题

启动速度、行为变更与回退

性能改进包括：第一条回复迟到的问题——原本在会话第一条回复结束时运行的模式编译步骤现在在回复流式输出时运行；通过复用预连接的API连接改善首次请求延迟；claude -p和Claude Code Remote不再加载交互式UI，自动模式分类器的规则和Artifact工具改为首次使用时加载。

行为变更方面：第三方提供商或关闭遥测且未配置权限模式时，交互式会话以auto模式启动，permissions.defaultMode仍可覆盖；/ultrareview启动对话框改为提示审阅本地分支可能上传已跟踪文件中的未提交变更；/model选择器的Opus行和默认模型名称在Opus已有 1M上下文窗口处去掉 "(1M context)"，窗口本身不变；--system-prompt和 --append-system-prompt现在可以同时接受文本和 -file形式，文件文本在前；Skill(anthropic-skills: ) 拒绝规则同时阻止Claude Desktop以插件形式交付的该技能；artifact自动触发的监听在 3.5 小时无活动后结束。

回退方面：2.1.282 对claude-ai名称的保留被撤销，同名技能、命令、工作流以及MCP服务器的技能和提示恢复加载，Skill(claude-ai:*) 规则变回普通前缀规则。自托管运行器方面，生命周期钩子的git会跳过仓库的Git LFS pre-push钩子、忽略可写的系统core.hooksPath，且在没有 --configure-git时不签署提交；Anthropic管理的git下GIT_SSL_CAINFO和GIT_SSL_NO_VERIFY的行为也有调整。

  • 首条回复的模式编译步骤改为在回复流式输出时运行
  • claude -p和Claude Code Remote不再加载交互式UI
  • 第三方提供商或关闭遥测时默认以auto模式启动，defaultMode可覆盖
  • /model选择器Opus行去掉 "(1M context)" 字样，窗口不变
  • 2.1.282 对claude-ai名称的保留被回退，同名技能等恢复加载
  • 自托管运行器调整Git LFS pre-push钩子和core.hooksPath处理

VS Code、云会话、Claude Tag与代码审查

VS Code扩展修复了权限模式指示器在自动切换失败后仍显示Default而会话继续以auto或bypass模式运行的问题，现在会重试切换直到成功；还修复了从Web传送的会话丢失Claude工作中发送的消息、Web会话在会话列表中保持隐藏并打开空聊天、重新打开的会话在回合中被消息拆分、重新加载的会话显示已被回退的回合或压缩前的行、窄面板中agents药丸图标偏移、长提示中粘贴带换行文本后输入框文本位置偏移等问题。

云会话方面，运行中的云会话添加仓库时，GitHub账号可读但不可推送的私有仓库现在可以以读取方式附加；修复了云会话在服务端重启恢复后偶尔重做已完成步骤（如重复评论或推送）的问题；新例行计划默认设在整点后几分钟，并注明整点设置的例行可能晚几分钟开始。

Claude Tag新增"Channels Claude can search"管理设置，按组织、工作区或频道限制Claude的Slack搜索范围为它已被加入的公开频道；连接Claude账号后的页面新增Back to Slack按钮。修复包括：频道配置页在通过附加规则获得访问包时不列出连接器或插件、访问包仓库搜索在GitHub App安装限定大量选中仓库时漏掉仓库、新消息打断回复时偶尔重复发布同一回复、Slack频道ID变更后旧私有频道的例行停止运行、设为 "Channel only" 的频道在非访客成员加入且Slack确认缓慢时所有对话结束。

代码审查方面，"@claude review" 请求在GitHub未返回拉取请求时不再静默，会重试一次并在仍失败时发表评论说明；在时间限制内停止且未验证任何内容的审查不再计费，显示为未完成并重试一次。

  • VS Code权限模式指示器会重试切换直到成功
  • 云会话可附加只读的私有仓库，避免重做已完成步骤
  • Claude Tag新增Slack搜索范围管理设置和Back to Slack按钮
  • Claude Tag修复重复回复、频道例行停止和访问包显示问题
  • @claude review失败会重试一次并说明
  • 未验证任何内容的超时审查不计费并重试一次

信息来源

Claude Code Releases原始来源