Claude Code 2.1.283 能按名字封模型

Claude Code 2.1.283 增加 deniedModels,用来挡住指定模型,即使 availableModels 已经允许。availableModelsMatch 设为 exact 时,名单只放行写明的版本,新发布的模型要等被写进名单。

Claude Code 2.1.283 能按名字封模型

Claude Code 2.1.283 于 2026 年 9 月 25 日发布,给托管设置加了两项目录控制。claude code deniedModels 用来挡住指定模型,即使 availableModels 已经允许它们。另一项 availableModelsMatch 设为 "exact" 时,availableModels 里的一条只放行它写明的那个模型版本,新发布的模型会一直被挡住,直到被写进名单。

作者:CodePass 技术编辑

exact 和「允许这一族」不是同一条

发行说明没有写默认的匹配方式。它只写:带上 "exact" 之后,条目允许的是它点名的版本。不设 exact 时新模型会不会自动落进旧条目,说明没说。要锁住「只准 Opus 5、不准 5.5」这种策略,按说明应把匹配设成 exact,并把允许的 ID 写全。2.1.280 把默认 Opus 换成了 claude-opus-5-5。exact 名单若还停在上一个 Opus ID,升级后的默认模型会被挡住,会话会表现为选不了模型,而不是静默退回旧 ID。说明没有写被挡住时的界面文案。

deniedModels 的优先级写明了:即使允许名单里有,拒绝名单仍然生效。两边都写同一个 ID 时,按这句是拒绝。不要靠允许名单的顺序去覆盖拒绝。

和网关、提示缓存无关

同一版还加了 x-claude-code-prompt-id 网关提示头,要用 CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 才发送,方便网关把同一次用户提示的请求归到一组。那是请求头,不是模型名单。模型封禁写在托管设置里,网关头写在环境变量里。只开了提示头、没有下发 deniedModels 的组织,模型目录不会变。

2.1.282 及更早没有这两个键名。写进托管文件之前先确认客户端已经是 2.1.283,否则旧客户端会不会整份忽略未知键,这版说明没有写。

下发之后用一个不在拒绝名单里的模型开一轮短会话,确认默认 Opus 仍能调用。再在测试账号上把 claude-opus-5-5 放进 deniedModels,看 /model 是否拒绝它。生产名单不要先在全员文件里做这个试验。exact 名单漏写 Fast 的 ID 时,标准档能用、Fast 不能用,也会表现为「同一个模型有时能选有时不能」。Fast 的 ID 在 Cursor 文档里是 claude-opus-5-5-fast,Claude Code 发行说明这一条没有列出 Fast 字符串。两边的拒绝名单要分别写。

参考资料