Claude Code Mod 是什麼？用途與入門

Claude Code Mod 是一種能改變 Claude Code 介面與行為的外掛。它透過 JavaScript 或 TypeScript 寫成的事件處理函式，在工具被呼叫、提示詞送出或畫面更新時介入，替原本的工作環境加入你需要的功能。

例如，你希望 Claude 工作時顯示已使用幾次工具，或想在旁邊放一個狀態面板，就可以用 Mod 製作。這篇會先幫你分清楚 Mod、Skills、MCP 的用途，再從一個工具計數器開始，理解第一次建立、載入與確認結果的方法。

Claude Code Mod 能改變什麼？

如果你已經用過 Claude Code，應該知道它會讀檔案、執行命令，再根據結果繼續工作。Mod 可以在這些事件發生時執行自己的程式，並把有用的資訊呈現在介面上；詳細能力可看 Anthropic 的 Mods 說明。

讓工作狀態變得看得見

Claude Code Mod 可以新增側邊面板、提示框上方的資訊區，也能調整部分原有畫面，例如等待中的轉動圖示。假設你只想知道 Claude 是否持續使用工具，就能在這個圖示旁邊加上計數，不必一直翻前面的對話紀錄。

這類資訊顯示要先決定「數字代表什麼」。工具呼叫次數只代表呼叫發生幾次，不能當成完成百分比，也不能直接換算成費用。若要呈現其他指標，還得另外取得對應資料；介面能做的事可參考官方介面指南。

在事件發生時加上處理

另一種用途是在特定事件發生時，執行你預先寫好的規則。例如工具即將執行時先記錄一次，再把事件交回 Claude Code；也可以設計成修改或接管事件。這些做法牽涉不同程度的權限，第一次練習可先從觀察與顯示開始。

把 Claude Code Mod 想成「替工作台加裝功能」會比較容易理解：工作台仍是 Claude Code，你新增的是顯示方式或處理規則。至於功能是否符合需求，要看實際程式和執行結果，不能只看外掛名稱。

Claude Code Mod 與 Skills、MCP 有何不同？

選擇擴充方式時，先問自己缺的是什麼：固定做法、外部工具，還是介面與事件處理？這幾種需求看起來都像「讓 AI 更好用」，但解法不同，不需要每次都寫一個 Mod。

如果你每天都要貼上「請按照公司格式寫摘要」，先整理成 Claude Skills 通常就能對準問題。

Skill 會告訴 Claude 怎麼做，也能讓它運用工具完成流程；它本身並不是用來繪製 Claude Code 介面的程式。這也是官方 Skills 文件建議的使用方向。

如果問題是「Claude 拿不到另一個系統裡的資料」，則先看 MCP。MCP server 提供的是連線與工具能力；是否能讀取或修改資料，仍取決於連接的服務與授權。

已經有自動檢查腳本的人，也可以沿用 Settings hooks。只有當需求包含互動介面，或需要更深入地處理事件時，再評估 Claude Code Mod。這是按需求選擇，不代表後者會取代前面所有做法。

最後，Plugin 是包裝與載入的單位。官方 Plugin 文件說明，一個 Plugin 可以同時包含 Skills、Hooks、MCP 等元件；帶有 Mod 所需 hooks module 的 Plugin，就能以 Mod 的方式工作。

工商時間

如果你想要更系統化、更輕鬆的學好 SEO 與 AI SEO，歡迎參考我與知識衛星合作的 SEO 線上課程：《SEO 排名攻略學》、《AI SEO 流量變革》。

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

第一次建立 Claude Code Mod，怎麼開始？

第一次可選一個低負擔、看得見結果的目標：計算工具呼叫次數，並顯示在工作中的轉動圖示旁。以下使用終端機中的互動式 Claude Code，依官方建立教學整理操作方式。

1. 檢查 Claude Code Mod 所需版本

先在終端機輸入 claude --version，確認是 2.1.287 或更新版本。從這個版本起，Mods 預設開啟；公司管理的環境仍可能另有限制。版本太舊時先更新 Claude Code，再進入一個你信任的練習資料夾開始。

如果還不知道終端機是哪個視窗，可以先看 CLI 與終端機入門。這裡的版本指令是在電腦的終端機執行；後面以斜線開頭的指令，則是在 Claude Code 對話輸入框裡使用。

2. 用自然語言說清楚小功能

進入 Claude Code 後，描述想做的 Mod。它可以載入內建的 plugin-authoring 技能來協助製作；也能先輸入 /plugin-authoring。下方是一段練習提示詞，目的是把功能與範圍講清楚，不需要先背 API 名稱。

請幫我建立一個 Claude Code Mod，從載入後開始計算工具呼叫次數，在工作中的轉動圖示旁顯示計數，並提供 /tally 指令查看。目前只需要計數與顯示，不主動讀取額外檔案、連網或呼叫模型。請先說明會建立哪些檔案，以及如何確認功能生效。

這段提示詞限制的是 Mod 自己要做的事。Claude 建立程式時仍可能需要讀取開發說明或建立檔案，你要核對它提出的實際操作；不能因為提示詞寫了限制，就假設產出的程式一定符合。

3. 確認檔案與熱重新載入

Claude 會在該次對話的 Mods 資料夾建立檔案。依權限模式，畫面可能要求你逐一同意。第一次存檔時，還會詢問是否開啟 hot reloading，也就是在這次對話中自動載入後續修改。

確認內容後，選擇 Enable for this session。Mod 會在回合結束時載入，之後改動檔案的回合結束時再重新載入。這個選項代表同意程式執行；如果還沒看懂它會做什麼，就先別開啟。

4. 做一個能看見計數變化的測試

先輸入 /plugin，切到 Installed，確認新 Mod 已列在其中。接著請 Claude 列出練習資料夾裡的檔案，並讀取其中一份不含敏感資料的說明文件；這樣才有工具呼叫可供計數。

Claude 工作時，檢查轉動圖示旁的數字是否增加；完成後再輸入 /tally 查看計數。能載入、數字會隨工具使用改變、查詢指令能回應，才是這次練習的完成條件。實際次數依執行過的工具而定，不必和教學示例一樣。

Claude Code Mod 沒反應，先查哪裡？

先看 /plugin 裡是否有載入這個 Mod，再看是不是期待錯了畫面。官方支援範圍區分了「Hooks 能執行」與「Mod 畫的介面能顯示」，兩件事不能混在一起判斷。

終端機支援 Mod 介面；Claude Desktop 的 Code 分頁也支援，但部分元件仍只限終端機。

VS Code 擴充功能的聊天面板可以執行 Mod 的 Hooks，卻不顯示它繪製的介面；Desktop 裡的 WSL 工作階段則因不支援 Plugins，不能套用同一套流程。

如果根本沒載入，再檢查版本、資料夾信任狀態，以及是否啟用了安全模式或受到組織政策限制。官方排錯頁也提醒，出錯的 Hooks 可能被略過，讓功能看起來像沒反應；把錯誤訊息交給 Claude 說明，比反覆重裝更有方向。

另外，Claude 在對話中建立的 Mod，預設只在產生它的工作階段載入。想長期保留時，要把該 Mod 資料夾複製到自己管理的位置，再依建立教學使用 --plugin-dir 載入，或進一步包裝分享；不要把一次練習誤認成已套用到所有對話。

工商時間

如果你想要更系統化、更輕鬆的學好 SEO 與 AI SEO，歡迎參考我與知識衛星合作的 SEO 線上課程：《SEO 排名攻略學》、《AI SEO 流量變革》。

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

安裝 Claude Code Mod 前，先看它能碰什麼

Claude Code Mod 是以你的使用者權限執行的程式，而且沒有沙箱隔離。它可能讀寫帳號能存取的檔案、啟動程式、連上網路，也可能接觸環境變數裡的金鑰。功能看起來只是小面板，不代表背後只能畫圖。

有些 Mod 還能改寫提示詞或工具呼叫，甚至呼叫模型而耗用方案或 API 額度。這些能力與組織控管方式，在 Anthropic 的 Mod 管理文件有完整說明；工作用環境應配合管理者允許的範圍。

取得第三方 Mod 的檔案後，可先用 claude plugin validate 加上該資料夾路徑，查看它處理哪些事件、呼叫哪些能力。這個檢查不會執行 Mod，但也不等於安全認證；仍要判斷作者是否可信，以及功能是否真的需要這些能力。

例如只顯示工具次數的小功能，若又要求讀取金鑰或把資料送到陌生網站，就值得停下來確認原因。已載入的 Claude Code Mod 若造成異常，可到 /plugin 的 Installed 分頁停用對應 Plugin，再檢查問題是否消失。

結語：從一個看得見的小功能開始

Claude Code Mod 適合解決具體的介面與事件處理需求。先找出工作中哪個地方不方便，再決定要不要擴充：固定流程交給 Skills、外部工具連線看 MCP，需要改變 Claude Code 的顯示與處理方式時，再考慮 Mod。

第一次不必做很大的功能。從工具計數器開始，確認自己看得懂它做了什麼、能判斷結果是否正確，也知道如何停用。這些基本功具備後，再逐步加入真正有用的功能。