Favicon02

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 Code Mod 的三種用途:工作狀態、執行流程與專用指令

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 時使用。

依需求選用 Skills、MCP、設定型 Hooks 或 Mod


第一次建立 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 查看計數。能載入、數字會隨工具使用改變、查詢指令能回應,才是這次練習的完成條件。實際次數依執行過的工具而定。

建立工具計數 Mod 的四步:檢查版本、說明需求、載入與驗收

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,開啟載入它的新工作階段。這個做法只為該次工作階段載入外掛;要讓團隊安裝與更新,則可再包裝到市集分享。



安裝 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 沒有沙箱隔離,應一併檢查它能接觸的檔案與資料。

Frank Chiu
Frank Chiu

SEO/GEO 顧問、行銷顧問。協助本地企業與跨國企業導入 SEO、GEO 跟行銷方案,包括:雀巢、凱基銀行、大人學、居家先生、IKEA、vocus 等。

訂閱電子報