Claude Mod 是什麼?Claude Mod 用途、建立與載入教學
Claude Mod 可自訂介面與事件處理。比較 Claude Mod、Skills 與 MCP,從工具計數器學會建立、載入、排錯與跨工作階段使用。

Claude 持續在工作,你想知道它用了幾次工具,卻得回頭翻對話紀錄。如果能在畫面旁直接看到計數,就更容易掌握目前狀態。Claude Mod(也常稱 Claude Code Mod)是能改變 Claude Code 介面與行為的外掛,可以用來加入這類功能。
接下來我會先說明 Mod 能改變哪些工作方式,再幫你分清楚它與 Skills、MCP 的用途。最後從一個工具計數器開始,帶你理解第一次建立、載入、確認結果,以及在其他工作階段繼續使用的方法。
Claude Mod 是什麼?
Claude Mod 是用來擴充 Claude Code 介面與工作行為的外掛,透過 JavaScript 或 TypeScript 撰寫的事件處理函式,在工具呼叫、提示詞送出或畫面更新等時機執行自訂程式。開發者可以取得事件資訊、套用處理規則,再把計數或其他工作狀態顯示在介面中,也能依所用能力調整部分事件的處理方式。這讓對話中的工作,多了可觀察與自訂的功能,適合補上使用者反覆需要的狀態顯示或流程處理。
例如,你想知道這次工作呼叫了幾次工具,可以寫一個 Mod,在每次工具呼叫發生時累加計數,再把數字顯示在畫面旁。當 Claude 接著讀檔或執行命令,數字就隨事件更新,你也能直接看出計數變化。這個例子把事件當成資料來源,把介面當成顯示位置,兩者一起形成自訂功能。
延伸資料:Claude Code、Anthropic 的 Mods 說明。
讓工作狀態變得看得見
Claude Mod 可以新增側邊面板、提示框上方的資訊區,也能調整部分原有畫面,例如等待中的轉動圖示。假設你只想知道 Claude 是否持續使用工具,就能在這個圖示旁邊加上計數,不必一直翻前面的對話紀錄。
這類資訊顯示要先決定「數字代表什麼」。工具呼叫次數記錄的是呼叫發生幾次;完成進度與費用各需要對應的資料才能計算。選好要呈現的指標,再準備所需資料;介面能做的事可參考官方介面指南。
在事件發生時加上處理
另一種用途是在特定事件發生時,執行你預先寫好的規則。例如工具即將執行時先記錄一次,再把事件交回 Claude Code;也可以設計成修改或接管事件。這些做法牽涉不同程度的權限,第一次練習可先從觀察與顯示開始。

Claude Mod 與 Skills、MCP 有何不同?
選擇擴充方式時,先問自己缺的是什麼:固定做法、外部工具,還是介面與事件處理?不同擴充方式各有適合的工作,先用下面的對照表找出需要的能力。
| 方式 | 主要負責什麼 | 適合的需求 |
|---|---|---|
| Skill | 用 SKILL.md 保存指令與流程 | 每次都要按照同一套規則整理報告 |
| MCP server | 提供連接外部系統的工具 | 讀取專案管理系統、資料庫或其他服務 |
| Settings hook | 在事件發生時執行既有腳本等處理 | 編輯完成後跑檢查,或依規則擋下工具呼叫 |
| Claude Code Mod | 在 Claude Code 內處理事件,也能繪製介面 | 顯示計數面板、調整工具執行時的行為 |
| Plugin | 把一組擴充元件包在一起載入與分享 | 讓團隊安裝同一組 Skills、MCP 或 Mod |
如果你每天都要貼上「請按照公司格式寫摘要」,先整理成 Claude Skills 通常就能對準問題。
Skill 會告訴 Claude 怎麼做,也能讓它運用工具完成流程;繪製 Claude Code 介面的程式則屬於 Mod 的用途。這也是官方 Skills 文件建議的使用方向。
如果問題是「Claude 拿不到另一個系統裡的資料」,則先看 MCP。MCP server 提供的是連線與工具能力;可讀取或修改哪些資料,由連接的服務與授權決定。
已經有自動檢查腳本的人,也可以沿用 Settings hooks。只有當需求包含互動介面,或需要更深入地處理事件時,再評估 Claude Mod。
最後,Plugin 是包裝與載入的單位。官方 Plugin 文件說明,一個 Plugin 可以同時包含 Skills、Hooks、MCP 等元件;帶有 Mod 所需 hooks module 的 Plugin,就能以 Mod 的方式工作。
如果要安裝別人做好的 Claude Mod,可在 Claude Code 輸入 /plugin install token-chart@your-org;這是官方示例,請將 token-chart 換成外掛名稱、your-org 換成提供者告知的市集名稱。
若在終端機用 claude plugin install 安裝或更新,已開著的工作階段要再執行 /reload-plugins 才會載入;也可以在下次啟動 Claude Code 時使用。

透過《SEO 排名攻略學》獲得穩定的 SEO 流量與實戰經驗。
再搭配《AI SEO 流量變革》看懂 AI 搜尋趨勢,搶佔 AI 搜尋紅利。

第一次建立 Claude Mod,怎麼開始?
第一次可選一個低負擔、看得見結果的目標:計算工具呼叫次數,並顯示在工作中的轉動圖示旁。以下使用終端機中的互動式 Claude Code,依官方建立教學整理操作方式。
1. 檢查 Claude Mod 所需版本
先在終端機輸入 claude --version,確認是 2.1.287 或更新版本。從這個版本起,Mods 預設開啟;公司管理的環境也要符合組織設定的載入條件。版本太舊時先更新 Claude Code,再進入一個你信任的練習資料夾開始。
如果還不知道終端機是哪個視窗,可以先看 CLI 與終端機入門。這裡的版本指令是在電腦的終端機執行;後面以斜線開頭的指令,則是在 Claude Code 對話輸入框裡使用。
2. 用自然語言說清楚小功能
進入 Claude Code 後,描述想做的 Mod。它可以載入內建的 plugin-authoring 技能來協助製作;也能先輸入 /plugin-authoring。下方是一段練習提示詞,目的是把功能與範圍講清楚,不需要先背 API 名稱。
請幫我建立一個 Claude Mod,從載入後開始計算工具呼叫次數,在工作中的轉動圖示旁顯示計數,並提供 /tally 指令查看。目前只需要計數與顯示,不主動讀取額外檔案、連網或呼叫模型。請先說明會建立哪些檔案,以及如何確認功能生效。
這段提示詞限定 Mod 的功能範圍。Claude 製作程式時可能需要讀取開發說明或建立檔案,請核對它提出的操作,再檢查產出的程式是否只做計數與顯示。
3. 確認檔案與熱重新載入
Claude 會在該次對話的 Mods 資料夾建立檔案。使用 default 或 acceptEdits 權限模式時,畫面會要求你逐一同意建立檔案;第一次存檔時,還會詢問是否開啟 hot reloading,也就是載入這次對話產生的 Mod,並自動載入後續修改。
看懂程式的動作與權限後,選擇 Turn them on。Mod 會在回合結束時載入,之後改動檔案的回合結束時再重新載入;這項選擇會保留在同一工作階段,包含日後恢復該階段。
若選 Not now,目前先不載入,檔案仍會保留,下次啟動同一工作階段時會載入。想讓它之後也不再載入,請刪除該 Mod 的資料夾;若只是暫停使用,可在 /plugin 的 Installed 分頁停用。
使用 auto 或 bypassPermissions 模式時,Claude Code 可以直接開啟熱重新載入,回合結束後就載入 Mod。第一次練習若希望先看到詢問,請在要求建立第一個 Mod 前切換到 default 或 acceptEdits。
4. 做一個能看見計數變化的測試
先輸入 /plugin,切到 Installed,確認新 Mod 已列在其中;在終端機也可看分頁下方的 mods active 列是否列出它的名稱。接著請 Claude 列出練習資料夾裡的檔案,並讀取其中一份不含敏感資料的說明文件;這樣才有工具呼叫可供計數。
Claude 工作時,檢查轉動圖示旁的數字是否增加;完成後再輸入 /tally 查看計數。能載入、數字會隨工具使用改變、查詢指令能回應,才是這次練習的完成條件。實際次數依執行過的工具而定。

Claude Mod 沒反應,先查哪裡?
先看 /plugin 裡是否有載入這個 Mod,再確認目前使用的介面支援哪些功能。官方支援範圍分別列出「Hooks 能執行」與「Mod 畫的介面能顯示」的條件,可按下面的使用介面逐一檢查。
終端機支援 Mod 介面;Claude Desktop 的 Code 分頁也支援,但部分元件仍只限終端機。
VS Code 擴充功能的聊天面板可以執行 Mod 的 Hooks。若要顯示 Mod 介面,擴充功能須為 2.1.299 以上。若工作階段不會取得功能開關設定,例如使用 Amazon Bedrock,則須為 2.1.304 以上。部分元件仍只在終端機顯示。
Claude Desktop 的 WSL 工作階段不支援 Plugins,請改用支援 Plugins 的介面測試 Mod。
如果根本沒載入,再檢查版本、資料夾信任狀態,以及是否啟用了安全模式或受到組織政策限制。接著在終端機執行 claude plugin validate ./first-mod,將 ./first-mod 換成實際 Mod 資料夾路徑,檢查事件名稱、manifest 與模組是否可讀。
出錯的 Hooks 可能被略過,讓功能看起來像沒反應。開著熱重新載入時,對話紀錄會出現帶有 Mod 名稱的錯誤行;一般已安裝的 Mod 則可用 claude --debug 啟動工作階段,從除錯紀錄查看原因。把完整錯誤行貼給 Claude,才能讓它針對出錯位置修改;常見訊息可對照官方排錯頁。
Claude 在對話中建立的 Mod,預設只在產生它的工作階段載入。想帶到其他工作階段繼續使用,先把該 Mod 的完整資料夾複製到自己管理的位置,例如專門存放 Mods 的資料夾,避免工作階段資料日後被清理時一併刪除。
假設你保留的工具計數器位於目前資料夾下的 first-mod,就在終端機輸入 claude --plugin-dir ./first-mod,開啟載入它的新工作階段。這個做法只為該次工作階段載入外掛;要讓團隊安裝與更新,則可再包裝到市集分享。
透過《SEO 排名攻略學》獲得穩定的 SEO 流量與實戰經驗。
再搭配《AI SEO 流量變革》看懂 AI 搜尋趨勢,搶佔 AI 搜尋紅利。

安裝 Claude Mod 前,先看它能碰什麼
Claude Mod 是以你的使用者權限執行的程式,而且沒有沙箱隔離。它可能讀寫帳號能存取的檔案、啟動程式、連上網路,也可能接觸環境變數裡的金鑰。
有些 Mod 還能改寫提示詞或工具呼叫,甚至呼叫模型而耗用方案或 API 額度。這些能力與組織控管方式,在 Anthropic 的 Mod 管理文件有完整說明;工作用環境應配合管理者允許的範圍。
取得第三方 Mod 的檔案後,可先用 claude plugin validate 加上該資料夾路徑,在不執行 Mod 的情況下,查看它處理哪些事件、呼叫哪些能力。安全判斷則要核對原始碼、作者來源,以及功能是否真的需要這些能力。
例如只顯示工具次數的小功能,若又要求讀取金鑰或把資料送到陌生網站,就值得停下來確認原因。已載入的 Claude Mod 若造成異常,可到 /plugin 的 Installed 分頁停用對應 Plugin,再檢查問題是否消失。
結語:從一個看得見的小功能開始
Claude Mod 適合解決具體的介面與事件處理需求。先找出工作中哪個地方不方便,再決定要不要擴充:固定流程交給 Skills、外部工具連線看 MCP,需要改變 Claude Code 的顯示與處理方式時,再考慮 Mod。
第一次不必做很大的功能。從工具計數器開始,確認自己看得懂它做了什麼、能判斷結果是否正確,也知道如何停用。這些基本功具備後,再逐步加入真正有用的功能。
重點整理
Claude Mod 一定要會寫程式才能用嗎?
你可以在互動式 Claude Code 中描述需求,讓內建的 plugin-authoring 技能協助製作 Mod。產出後,先理解程式的動作與權限,再確認授權並實際測試結果,這些是使用自然語言建立 Mod 時要一起完成的工作。
Claude Mod 要另外開啟實驗功能嗎?
Claude Code 2.1.287 或更新版本已預設開啟 Mods,載入時也要符合安全模式、設定與組織政策的條件。早期使用的 CLAUDE_CODE_ENABLE_FUNCTION_HOOKS 環境變數在這些版本會被忽略,請從目前設定與組織政策確認載入條件。
Claude Mod 和 Plugin 是一樣的東西嗎?
Mod 是具有特定事件處理模組的 Plugin。Plugin 是擴充元件的包裝與載入單位,可以包含 Skills、Hooks、MCP 等內容;具有 Mod 所需 hooks module 的 Plugin,則能在 Claude Code 內處理事件與繪製介面。
為什麼 VS Code 裡看不到 Claude Mod 的面板?
先在 Claude Code 用 /plugin 確認 Mod 已載入,再檢查 VS Code 擴充功能版本。顯示 Mod 介面需要 2.1.299 以上。使用 Amazon Bedrock 等不會取得功能開關設定的工作階段,則需要 2.1.304 以上。部分元件只在終端機顯示,可切換到終端機驗證。
Claude Mod 通過 validate 就代表安全嗎?
claude plugin validate 的檢查範圍,是在不執行 Mod 的情況下列出事件處理與能力呼叫。安全判斷要另外核對原始碼、作者來源,以及功能是否需要這些能力。Mod 沒有沙箱隔離,應一併檢查它能接觸的檔案與資料。



