Claude Code Mods 是什麼：10 月 1 日上線，外掛能改介面和行為，附啟用與驗證步驟
Claude Code mods 是 2026 年 10 月 1 日隨 2.1.287 版本推出的一類外掛能力：官方更新日誌的原話是“Added Claude Mods: plugins may now modify deeper behavior”，也就是外掛可以改動比以前更深的行為，例如畫介面、攔截提示詞、在工具呼叫前後插手。同一版本還內建了第一個 mod，叫 “You should know”。以下內容截至 2026 年 10 月，以 Claude Code 官方更新日誌為準。
Mod、hook、plugin 是什麼關係？
三者是包含關係，不是並列關係。
| 名稱 | 含義 |
|---|---|
| plugin（外掛） | 分發和安裝的單位，可以帶命令、技能、hook 等內容 |
| hook（鉤子） | 在固定時機執行的程式碼，例如 prompt.change、agent.spawn、turn.start |
| mod | 使用 mod API（日誌中以 $. 開頭，如 $.ui、$.model）的外掛，能畫介面、呼叫模型、改寫提示詞 |
更新日誌裡反覆出現的說法是“a mod's hook”“a mod's Input”“a mod's Text”，可見 mod 本質上是一個會註冊 hook、並能渲染介面元素的外掛。這是根據日誌措辭做的歸納，細節以官方文件為準。
內建的 “You should know” 做什麼？
2.1.287 的日誌說明：它是一個內建 mod，由一個旁路 agent 盯著會話，提示你或 Claude 可能漏掉的事。日誌給出的啟用命令是：
/plugin enable cc-plugin-you-should-know@builtin
日誌同時註明適用於“first-party sessions with telemetry on”，即開啟遙測的第一方會話。後續兩次小改動：2.1.288（10 月 2 日）讓提示根據決策者使用“we”“the main agent”或“you”；2.1.290（10 月 5 日）修復了它不按 language 設定輸出語言的問題。
這兩週 mod API 加了什麼？
日誌裡與 mod 相關的條目，按版本整理如下（日期為日誌所標）：
| 版本 | 日期 | 變化 |
|---|---|---|
| 2.1.288 | 10 月 2 日 | $.ui.selection()：返回全屏模式下最近選中的文字 |
| 2.1.292 | 10 月 6 日 | $.model.complete 支援提示快取，文字塊上設 cache: true；claude plugin install 新增 --marketplace <source> |
| 2.1.295 | 10 月 8 日 | $.ui.notify：透過你自己的通知設定發出原生通知 |
| 2.1.299 | 10 月 14 日 | $.prompt.media、$.session.identity()，二者面向由託管設定安裝的 mod |
| 2.1.300 | 10 月 14 日 | prompt 裝飾新增 virtualText；新增 prompt.change 鉤子；agent.spawn 鉤子可改寫工作流 agent 的 prompt 和 model |
| 2.1.301 | 10 月 15 日 | Input 新增 rows，可做多行輸入，Enter 提交，Shift+Enter 換行 |
其中提示快取對成本有直接意義，原理見 Claude prompt caching 怎麼用才省錢。
怎麼裝一個 mod 並確認它能用？
- 升級到 2.1.287 或更高。想用
--marketplace需要 2.1.292 以上。 - 一步裝好並新增來源：
claude plugin install <外掛名> --marketplace <source>。日誌說明它會在需要時先新增 marketplace，並執行與claude plugin marketplace add相同的策略檢查。 - 校驗：
claude plugin validate。2.1.290 起，它會列出 mod 在“可攔截”位置註冊的每個 hook，以及有沒有.catch（加--json時欄位為gatingHooks）。 - 需要自動化測試時可以用
claude plugin test，具體寫法以官方文件為準。 - 在
/plugin裡檢視狀態。組織用託管設定管理 Claude Code 時，可能影響 mod 的安裝與執行，以官方文件為準。
校驗的已知點：2.1.292 起，用重複宣告或重新賦值的頂層 var 讀取 $.state 的模組會被 validate 拒絕。
想自己寫一個 mod，怎麼起步？
最小思路：挑一個鉤子，只做一件小事。例如在 prompt.change 裡讀取提示框文字，用 virtualText 在輸入框裡顯示一句不會進入草稿的提示。具體的檔案結構和 API 簽名我沒有在公開日誌裡核實到，請以官方文件為準。2.1.300 的日誌提到內建的 plugin-authoring 技能負責 mod 的製作和分享，可以讓 Claude 帶著你搭骨架。
寫完先跑 claude plugin validate，再裝進一個臨時專案試，不要一開始就裝到日常工作的環境。
升級前要看什麼？
mod API 在三週內改了很多次，有些是行為變化而不是新增。例如 2.1.301 把 $.env.set 改為設定成功後返回 {}，被拒絕時返回帶原因的 { deny }。已經寫了 mod 的人，升級前應逐條看日誌。cdnping 的 官網動態 會逐行記錄官方更新日誌的增刪，可以訂閱 RSS。
和外掛目錄有什麼關係？
Anthropic 的釋出說明在 2026 年 9 月 25 日寫明，現在可以透過新的開發者門戶把外掛提交到 Claude 目錄，上線後可看到使用分析。這條說的是面向 Claude 的外掛，是否同樣適用於 Claude Code 的 mod，請以官方說明為準。
相關閱讀
- 把 Claude Code 指向自定義介面：Claude Code 自定義 API 與 Codex、OpenCode 介面地址配置
- 升級後連不上：Claude Code 連線超時和報錯怎麼排查
- 響應變慢：Claude Code 慢怎麼辦
- 額度與限制：Claude Max 5x 和 20x 有什麼區別
遇到服務異常，可以先看 Claude Code 是否在故障中 和 Anthropic API 狀態。
