Bible Network Crypto DeFi Onchain RWA AI Agent Stablecoin Chain SAFU CryptoTax DeFAI AGI Claude Me Claude Skill Claude Design Claude Cowork
獨立知識媒體
與任何項目無關聯
探索AI智慧的思維邊界
claude-me.com
最新
Claude 自主發現類 CRISPR 新酵素系統:950 個 Agent、21 小時、還有科學家的保留態度  ·  Claude Code 新增模型版本鎖定:availableModelsMatch: exact 與 deniedModels 怎麼用  ·  Claude Code 的 rm 指令新規則:兩分鐘沒人確認,就自動拒絕而不是卡住  ·  Claude Code 螢幕閱讀器模式怎麼設定?給視障開發者的完整指南  ·  Claude Artifacts 能讀即時 MCP 資料,但不能公開分享連結——這條互斥規則,任何方案都一樣  ·  Claude Code Auto Mode 的安全分類器改免費了,但用 Gateway 的人可能還在被收費
practice

Claude Code 新增模型版本鎖定:availableModelsMatch: exact 與 deniedModels 怎麼用

30 秒速讀
availableModelsMatch: exact 加上 deniedModels,等於把模型版本控制從「大致鎖定家族」升級成「鎖死到具體版本號」。

完整解析 +
01 · 為什麼發生?

如果我只用 deniedModels,不搭配 availableModelsMatch: exact,可以達到一樣的鎖定效果嗎?

不完全一樣。單獨使用 deniedModels 只能排除你明確列出的特定模型,對於「還沒出現、未來才會發布」的新版本沒有任何約束力——新模型上線後,只要沒被加進 deniedModels,一樣會被允許清單放行。而 availableModelsMatch: "exact" 的關鍵價值在於反過來限制允許清單本身的比對方式,讓「沒有被明確列出的模型,一律預設擋下」,這對於要防堵「未來會出現、但現在還不知道名字」的新版本,才是真正有效的機制。

兩者疊加使用,才能同時做到「精準排除已知問題版本」與「阻擋所有未經核准的未來版本」。

02 · 運作原理是什麼?

這個設定是不是只有用 Claude Enterprise 或大型組織才需要?

主要適用情境確實偏向有集中治理需求的團隊——文件把它定位成 managed settings,代表設計目標是讓 IT 或平台團隊統一派發、個別開發者無法自行覆蓋。如果你是個人開發者或小團隊,通常不需要這種嚴格程度的版本鎖定,用預設的自動更新行為,反而能更快用到新模型的能力提升。

但如果你的團隊即使規模不大,也有合規審查或客戶合約層級的模型版本承諾(例如跟客戶簽約時載明使用哪個模型版本),這個設定同樣值得採用,不是只有大型企業才有這種需求。

03 · 如何應用

如果團隊已經把 availableModelsMatch 設成 exact,之後想升級到新模型,正確的操作流程是什麼?

正確流程是先在 availableModels 裡明確加入新模型的完整名稱,而不是期待任何形式的自動放行或模糊比對生效。由於 exact 模式下比對是逐字精確的,新模型的版本字串(通常包含日期或版本號)必須跟官方發布的名稱完全一致,建議直接從官方公告或 /status 顯示的可用模型清單複製,避免手動輸入時的拼字誤差導致設定看似生效卻實際沒有放行。

升級前也建議先在小範圍測試環境驗證新設定能正常運作,再推送到全體團隊的 managed settings。

04 · 我該怎麼做?

availableModelsMatch 設成 exact 之後,會不會影響到一般開發者日常使用 Claude Code 的體驗?

對日常操作沒有直接體驗上的改變——這個設定影響的是「哪些模型可以被選用」,而不是介面操作方式或指令用法。唯一會被實際感受到的情況,是開發者嘗試切換到一個沒有被明確列在允許清單裡的模型時,會被擋下並收到提示,這時候需要聯繫管理員確認該模型是否應該被加入清單,而不是自己在本機設定裡想辦法繞過去(managed settings 本來就不該被個人端覆蓋)。

對管理員來說,這代表往後每次要放行新模型,都需要一個明確的動作去更新允許清單,而不能仰賴預設的自動延伸行為。

完整內容 +

對於在企業環境裡集中管理 Claude Code 的團隊,模型自動升級一直是個兩難:不鎖版本,新模型上線後團隊可能在沒有測試的情況下被自動切到新行為;鎖版本又擔心設定方式不夠精確,導致某些子版本仍能溜過去。近期版本新增的 availableModelsMatch: "exact" 與 deniedModels 兩個 managed settings,正是針對這個痛點設計的精確控制機制。

availableModelsMatch: exact 解決什麼問題

在這個設定出現之前,availableModels 允許清單的比對邏輯比較寬鬆,管理員列出的模型名稱,實務上可能連帶放行相近的子版本或別名。把 availableModelsMatch 設為 "exact" 之後,行為變得嚴格:availableModels 裡列出的每一個項目,只允許該項目字面上完全對應的那個模型版本,新發布的模型即使名稱相似,只要沒有被明確加進允許清單,就一律被擋下,不會有任何隱性放行的空間。這對需要嚴格版本控制的場景很關鍵——例如團隊在某個模型版本上完成了合規審查或內部評測,不希望任何人在審查完成前,因為新版本自動可用而不小心用到未經驗證的模型。

deniedModels:允許清單之外的第二道防線

deniedModels 則是反向邏輯:即使某個模型出現在 availableModels 的允許清單裡,只要同時出現在 deniedModels,一樣會被擋下。這代表管理員現在有了允許清單(allow-list)與封鎖清單(deny-list)兩種機制可以疊加使用,而不是只能二選一。實務上一個常見用法是:availableModels 設定得相對寬鬆(涵蓋整個模型家族),再用 deniedModels 精準排除其中一兩個已知有特定問題(例如某個版本在特定任務上表現不穩定,或還在內部驗證階段)的子版本,而不必為了排除一兩個版本,重寫整份允許清單。

典型的組合用法:把團隊釘在特定版本上

把 availableModelsMatch: "exact" 和 deniedModels 搭配使用,可以達到「把整個團隊釘死在指定版本,且新版本上線也不會被自動放行」的效果——這正是文件裡舉出的典型應用情境。對照過去只能用寬鬆比對的 availableModels,這等於是把版本控制的精確度,從「大致鎖定某個模型家族」提升到「鎖死到某一個具體版本號」。

這跟你的錢有什麼關係

如果你所在的組織需要對 AI 工具的行為做合規審查、內部評測、或成本控管(不同模型版本的定價可能不同),這個更新讓你不再需要依賴「團隊自律不手動升級」這種軟性約束,而是能在 managed settings 層級做出真正可被驗證、可稽核的版本鎖定。升級到支援這個功能的版本後,建議先盤點目前 settings.json 裡 availableModels 的既有設定,確認是否要一併加上 availableModelsMatch: "exact"——因為在寬鬆比對模式下運作良好的既有清單,切換成嚴格比對後,可能會意外擋下一些原本仰賴模糊比對才能通過的合法模型名稱,值得先在測試環境驗證一輪再全面套用。

資料來源:Claude Code changelog
圖解
Allow-List and Deny-List Working TogetheravailableModelsMatch: exact 限定允許清單精確比對,deniedModels 再從中排除特定版本Model Access: Allow-list vs Deny-listavailableModels (exact)claude-sonnet-5-20260615claude-opus-5-5-20260701Only these exact versions passNew releases blocked by defaultdeniedModelsclaude-opus-5-5-20260701Blocked even if allow-listedOverrides availableModelsResult: only claude-sonnet-5-20260615 is actually usableClaude Me · claude-me.com
歡迎截圖分享,轉載請註明來源
提問
請至少輸入 10 個字
相關文章
Claude Code 的 rm 指令新規則:兩分鐘沒人確認,就自動拒絕而不是卡住
practice · 09/28
Claude Code Auto Mode 的安全分類器改免費了,但用 Gateway 的人可能還在被收費
practice · 09/26
Claude Code 開始支援 AGENTS.md:四種 instructionFiles 模式與 CLAUDE.local.md 的優先權陷阱
practice · 09/26
Claude Artifacts 能讀即時 MCP 資料,但不能公開分享連結——這條互斥規則,任何方案都一樣
practice · 09/26
更多相關主題