Claude mods：讓工具配合你

Claude mods 是 Anthropic 在 2026 年 10 月 1 日推出的功能，讓你替 Claude Code 加上自己想要的畫面和規則。Claude Code 是讓 AI 直接在你的電腦上讀檔案、改檔案、執行工作的工具；mods 可以想成它的改裝零件，讓畫面和做事方式照你的習慣調整。

如果你已經天天用 Claude Code，卻常覺得有些資訊看不到、有些動作想多設一道關卡，這篇會講 mods 解決什麼痛點、好處在哪、怎麼從第一個小改裝開始。我們團隊的日常工作會用 Claude Code，但 mods 我還沒有實際裝來用過，所以以下依官方文件整理，示範情境會特別標出來。

它解決什麼痛點

下面前三個是 Anthropic 自己做成範例的情境，第四個來自官方公告的說明。

「我不知道它的記憶快滿了沒。」 AI 一次能同時記住的內容有上限，這叫 context window，可以想成工作桌的大小。桌面快堆滿時，就得先整理或換新話題。官方範例 token-weather 會在輸入框上方畫出一條「預報」，告訴你桌面現在用了多滿。

「我怕它不小心跑出把檔案刪光的指令。」 有些指令殺傷力很大，例如一次刪掉整個資料夾，或把你本機的版本強制蓋掉雲端上的版本。官方範例 blast-radius 會在這類指令執行前先攔下，列出它會動到什麼，讓你按「繼續」或「取消」。

「它剛剛改了一堆檔案，我想回頭看它到底做了什麼。」 官方範例 replay-theater 加了一個 /replay 指令，可以一步一步重播 Claude 上一輪對檔案做的修改。

「團隊規定動到正式環境前一定要先確認，但全靠大家記得。」 官方公告舉的例子是：碰到正式環境設定的指令時，要求先確認；也可以讓某個 mod 最先載入，替其他 mod 做的每個動作留下紀錄。

用了有什麼好處

想做的事	只靠叮嚀的做法	用 mod 的做法
掌握記憶用量	自己留意，快滿了才發現	輸入框上方常駐顯示用量
擋下危險指令	每次對話都打一句「刪東西前先問我」	危險指令一出現就被攔下，畫面列出會動到什麼
回頭檢查改動	自己打開檔案，一個一個比對	輸入 /replay，重播上一輪的修改

圖：工作桌是概念比喻；功能範圍依官方 mods 文件，自訂改裝需檢查程式。

具體的好處有三個：

1. 把口頭叮嚀變成固定動作。 叮嚀要靠每次都記得說，mod 則是在動作發生的那一刻自動出手。不過它不是萬無一失的保險，限制寫在「費用與限制」。
2. 看得見，才放得了手。 用量、改動、風險動作都顯示在眼前，你比較敢把較長的工作交給 Claude Code 做。這是我的判斷，不是官方說法。
3. 不會寫程式也能起步。 官方說法是，你可以用一般說話的方式描述需求，請 Claude 替你寫 mod，並在同一個工作階段裡載入。但程式是 AI 寫的，不代表你可以不檢查，下面會講怎麼看。

怎麼做：一步一步用上 Claude mods

第 1 步：先判斷是不是真的需要 mod。 官方文件把幾種擴充方式放在一起比較，我整理成白話：

你的狀況	該選哪個
同樣的規則一直在對話裡重貼	Skills（一份 Claude 會去讀的工作說明檔）
想在畫面加面板、加自訂指令，或在動作發生時改寫、攔截	mods
已有現成的腳本，只想在某個時間點擋下或記錄	設定檔裡的 hooks
想讓 Claude 連到外部系統取得資料或工具	MCP（讓 Claude 連外部服務的接口）

這些可以放在同一個外掛包（官方叫 plugin）裡一起安裝與分享，mods 本身就是 plugin 的一種。一句話分辨：只是想教它做事，先用 Skills；想改工具本身，才用 mods。

第 2 步：確認版本和使用的地方。 終端機版需要 Claude Code 2.1.287 或更新，輸入 claude --version 就能看到。桌面版需要 2.1.286 或更新，在 Code 頁籤的本機工作階段輸入 /status，看「Claude Code」那一列。畫面類的改裝只會出現在終端機和桌面版的 Code 頁籤，一般的 Claude 網頁聊天不適用。

第 3 步（做法 A）：請 Claude 幫你做一個。 開一個互動式的 Claude Code 工作階段，用日常說法描述想要什麼。官方文件的範例是：

make a mod that shows the current git branch above the prompt

中文版可以這樣寫。我加了幾條限制，讓它先做小、做得可檢查；這是我的範本，不是官方保證有效的配方：

幫我做一個 Claude Code mod：在輸入框上方顯示目前所在的 Git 分支名稱。
限制：只做這一件事；不要連網；不要執行其他程式；不要讀寫專案以外的檔案。
做完後用白話告訴我，這個 mod 會在什麼時候被觸發、會呼叫哪些功能。

接下來依官方文件，會依序遇到這些畫面：

• 在預設與 acceptEdits 權限模式下，Claude 每建立一個檔案，Claude Code 都會先問你。因為 mod 存在受保護的 ~/.claude 資料夾，請一個一個看過再同意。
• Claude 存下第一個檔案時，會問你要不要為這個工作階段開啟「熱重載」（hot reloading，意思是改完檔案馬上換上新版）。選「Enable for this session」，mod 會在這一輪結束時載入；選「Not now」就先不載入。
• 輸入 /plugin，按 Tab 切到「Installed」分頁，應該能看到這個 mod，也能在這裡關掉它。
• 照官方說法，輸入框上方會出現目前的分支名稱。不合意就直接告訴 Claude 要改什麼，它會在每一輪結束時重新載入。
• Claude 做的 mod 只在這個工作階段有效，存放它的資料夾（~/.claude/dev-mods/ 底下，以工作階段編號命名）過一陣子會被清掉。想長期用，就把資料夾複製到自己的位置，例如 ~/mods/git-branch，之後用 claude --plugin-dir ~/mods/git-branch 載入。

第 3 步（做法 B）：安裝別人做好的。 mod 用安裝外掛的方式安裝，指令格式是「外掛名稱@目錄名稱」，目錄在官方叫 marketplace。官方文件的格式範例：

/plugin install token-chart@your-org

在工作階段裡輸入這行，不會馬上裝，而是打開 /plugin 面板，讓你先看它會加入什麼，再選範圍：只給你（所有專案都有）、這個專案的所有協作者，或只有你在這個專案。裝好後，最後一句會告訴你是「Plugin is now active.」（立刻可用），還是要再執行 /reload-plugins。桌面版則是點輸入框旁的「+」，選「Plugins」再選「Add plugin」，之後管理走「+ > Plugins > Manage plugins」。按鈕名稱以實際畫面為準。

如果同事把 mod 放在他自己的目錄，要先加入目錄再安裝。以下三行是官方入門指南的範例，your-org/my-mods 要換成對方給你的名稱：

/plugin marketplace add your-org/my-mods
/plugin install token-weather@my-mods
/reload-plugins

想先看現成的，Anthropic 在 claude-code-playground 程式庫的 claude-code/mods 資料夾放了三個範例（token-weather、blast-radius、replay-theater）。官方註明這些範例按現狀分享，不提供支援。把程式庫下載後，可以用 --plugin-dir 只在這一次工作階段載入，不會真的安裝：

claude --plugin-dir ./claude-code-playground/claude-code/mods/token-weather

第 4 步：裝之前，先看它會做什麼。 mod 是程式，所以裝之前要看。Anthropic 提供一個不必執行 mod、就能列出它要做什麼的指令。把外掛的檔案拿到本機，例如從它的程式庫下載，在終端機執行：

claude plugin validate ./some-mod

輸出裡有兩行重點。以下是官方文件的範例輸出：

  > ./register.js hooks: session.start, tool.call, ui.render{component=Pane}
  > ./register.js calls: $.fs.read, $.http.fetch, $.store.set, $.ui.open

hooks: 那行是它會在哪些時間點出手，例如 tool.call 代表它看得到 Claude 每一次使用工具；calls: 那行是它要求 Claude Code 替它做哪些事。

看懂 calls 那一行：常見項目對照表

下表依官方「審查 mod」的說明整理，只列最需要留意的項目。

calls: 裡出現	白話意思
$.fs.read、$.fs.write	讀取、寫入你的帳號能碰到的任何檔案
$.process.run、$.process.spawn	以你的身分啟動其他程式
$.http.fetch	連上網路
$.env.get、$.settings.read	讀環境變數與設定檔，裡面可能放著 API 金鑰
$.model.complete	用你的方案或金鑰額度呼叫模型

第 5 步：從小處試，不順就關掉。 先在測試用的資料夾或不重要的專案試。要關掉單一 mod，輸入 /plugin，到「Installed」分頁選中它，按空白鍵停用。想暫時全部關掉，用 claude --safe-mode 開新的工作階段，這也會一併停用你其他的自訂項目。想永久全關，在 ~/.claude/settings.json 設定 "disableAllHooks": true，不過這會連你設定檔裡的 hooks 和自訂狀態列一起停掉。

實際示範：在輸入框上方顯示 Git 分支（示範情境）

以下依官方文件的步驟推演，我沒有實際執行過。

假設你和同事共用一個網站專案，常有人在錯的分支上改東西。Git 分支可以想成同一個專案的不同版本線。你想一眼就看到現在在哪一條線上。

1. 在測試用資料夾開 Claude Code，貼上前面的中文提示詞。
2. Claude 開始建立檔案，每個檔案前你會被問是否允許，逐一看過再同意。
3. 第一個檔案存好時，出現熱重載的問題，選「Enable for this session」。
4. 這一輪結束後，輸入框上方出現分支名稱。輸入 /plugin 切到「Installed」分頁，確認清單裡有這個 mod。
5. 你覺得名稱太長，回一句「分支名稱超過 20 個字時，只顯示前 20 個字」。這一輪結束後，mod 重新載入，你就能看到新的顯示。
6. 用起來順手，就把資料夾複製到自己的位置，之後用 --plugin-dir 載入。
7. 要給同事用之前，先跑一次 claude plugin validate。這個 mod 需要讀取 Git 狀態並畫出畫面，所以 calls: 出現讀檔或執行 git 指令是合理的。如果出現連網或讀環境變數，就該停下來問 Claude 為什麼。

整段的重點是：先做一個只顯示資訊的小改裝，確認 calls: 裡沒有不該有的項目，再考慮做會攔截動作的類型。

費用與限制

• 費用：官方 mods 文件沒有另外標價，mods 跑在你原本的 Claude Code 裡。但 mod 可以呼叫模型，這會用掉你的方案或 API 金鑰的額度。Claude Code 本身需要哪個方案，請看 Anthropic 的方案頁。
• 安全：官方明說 mods 沒有沙盒隔離，與 Claude Code 有相同的電腦存取能力。裝上後，它能讀寫你的帳號碰得到的檔案、啟動程式、連上網路，讀取環境變數與設定檔裡的金鑰，看到你送出的每個提示和 Claude 的每次工具呼叫，改寫它們，甚至在你被詢問之前就先核准某個工具操作。所以只從你信任的作者和目錄安裝。官方也說明：mod 能改變大部分畫面，但改不了權限詢問的畫面，不能偷換你看到的詢問內容。
• 攔截類不是保險：官方提醒，blast-radius 是安全網，不是權限系統。它看的是指令文字，用 $(…)、別名或呼叫刪除指令的腳本都可能繞過。要硬性禁止，請用 Claude Code 的權限規則。
• 平台：畫面只在終端機與桌面版 Code 頁籤出現。桌面版的 WSL 工作階段不支援外掛；VS Code 擴充功能的聊天面板和 claude -p 會執行 mod 的邏輯，但不會畫出畫面。
• 會變動：官方提醒，mods 能使用的事件與方法可能隨版本改變，自己做的 mod 之後可能要跟著調整。
• 請 Claude 寫的 mod：只有在你信任的資料夾、能按下允許的互動式工作階段裡才會載入。
• 組織管理：Team 與 Enterprise 方案，以及有管理設定的電腦，會先載入內建的守衛 sec-default，擋下像覆蓋權限拒絕規則這類危險動作。管理員也能用 allowManagedModsOnly 只允許公司自己的 mods。公司電腦裝不了時，請先問管理員。
• 資訊查核：2026 年 10 月 9 日。功能與安裝方式以官方最新文件為準。

我的建議

• 已經天天用 Claude Code 的人：現在就可以試，從只顯示資訊的類型開始，例如 token-weather 或前面的 Git 分支。每個 mod 都先跑 claude plugin validate，在測試資料夾用一週再決定要不要留。
• 只用網頁聊天、或偶爾才用 Claude Code 的人：可以等。同樣的規則一直重貼，先改用 Skills 就解決大半。
• 小團隊：請一個人先試，把 claude plugin validate 的輸出和 mod 的用途寫成一頁說明，再放進團隊自己的目錄分享，不要每個人各自亂裝。我們對外的內容一定有人看過才發布，對 mod 也是同樣的態度：沒有人看過的程式，不上線。
• 企業：先請管理員決定政策，是只允許公司自己的 mods，還是開放經審查的目錄。
• 從哪件事開始：先做會顯示資訊的，再做會攔截動作的。後者影響你的工作流程，也更需要有人檢查程式。

來源

• Anthropic：Customize Claude Code with mods
• Claude Code：Mods overview
• Anthropic：Getting started with Claude Code mods
• Claude Code：Create a mod
• Claude Code：Manage mods for your organization
• Claude Code：Install and manage plugins