Claude Code Mod 怎麼做？用對話做出第一個 Mod，從試用、留存到安裝別人的版本

在終端機的互動對話裡，做一個 Claude Code Mod 的基本流程是四步：確認 Claude Code 在 v2.1.287 以上（Desktop 的 Code 分頁為 v2.1.286 以上）、在對話中描述你要的功能、在 Claude 存檔時選擇本次工作階段（session，同一次對話從開始到結束）啟用、用 /plugin 確認已載入。前提是這個資料夾已經接受信任提示，而且 Mod 沒有被停用或被公司設定擋下。依 Claude Code 官方的建立 Mod 說明，Claude 會依內建的 plugin-authoring skill 寫好 Mod，之後每一輪修改結束都會自動重新載入。要特別注意的是，Claude 寫的 Mod 只在寫它的那個工作階段有效，想長期使用，得把它的資料夾複製出來另外載入。

說完需求，輸入框上方多了一行活動倒數

一個常見的開始方式，是請 Claude 在輸入框上方放一行字，顯示距離下一檔活動上線還有幾天。需求說完、核准 Claude 建立的檔案，這一輪對話結束時，那行字通常就出現了。不喜歡顏色或寫法，再說一次要怎麼改，下一輪結束就會換成新版本。

這種「說完就看到」的節奏，是 Mod 和過去擴充方式最不一樣的地方。以前想在 AI 工具裡多一個小功能，得找工程師、等排程；現在描述清楚就能先試，實際要花多久，看需求複雜度和來回修改幾次。

做好的 Mod，隔天為什麼不見了

第一次用對話做 Mod，最容易遇到的尷尬不是做不出來，而是做好了、用得很順，隔天開新對話卻找不到它。我們讀官方文件時特別留意到，這是刻意的設計：Claude 寫的 Mod 只屬於寫它的那次對話，要不要長期留下，由使用者自己決定。

這篇照實際操作的順序寫，把容易卡住的地方放在對應的步驟裡。Mod 是什麼、和 Skill 有什麼不同，如果還不熟，可以先讀〈AI Agent 是什麼？和 Agent Skill 差在哪〉，再回來動手。

動手前：確認版本與 Mod 已經開啟

依 官方的 Mods 總覽，Mod 預設開啟，終端機版需要 v2.1.287 以上，Claude Desktop 的 Code 分頁則從 v2.1.286 起支援。確認方式如下：

版本太舊就先更新 Claude Code。如果公司有統一管理 Claude Code 的設定，管理員可能限制了哪些 Mod 能載入，遇到裝了卻沒反應的情況，先問 IT 是否有這類限制。

先試官方範例，摸清 Mod 能做什麼

Anthropic 在 claude-code-playground 的 mods 資料夾放了三個範例：token-weather 在輸入框上方畫出對話脈絡（context window）用量的天氣預報，blast-radius 攔下高風險指令並顯示影響範圍，replay-theater 新增一個 /replay 指令，逐步回放 Claude 上一輪改過的檔案。官方說明這些範例是「照現狀分享、不提供支援」。

試用不需要正式安裝。把範例資料夾下載到電腦後，用 --plugin-dir 只在這一次對話載入：

claude --plugin-dir ./token-weather

載入後在 Claude Code 輸入 /plugin，分頁下方會有一行灰字，列出這次對話載入了幾個 Mod 與名稱。關掉這次對話，範例就不會再出現，很適合拿來低風險地摸索。

用對話做出第一個 Mod：描述、核准、確認、修改

1. 描述你要的功能

在 Claude Code 的互動對話中，用自己的話說出需求，例如「幫我做一個 Mod，在輸入框上方顯示目前的 git 分支」。官方文件說明，Claude 會依內建的 plugin-authoring skill 寫 Mod，這份 skill 告訴它該寫在哪、你的版本有哪些事件與方法可用。也可以自己輸入 /plugin-authoring 先載入它。

Claude 會把 Mod 寫在這個工作階段專屬的資料夾，路徑是 ~/.claude/dev-mods/ 加上工作階段的 ID。在預設與 acceptEdits 權限模式下，這個資料夾屬於受保護路徑，Claude 每建立一個檔案都會先請你核准。

2. 選擇本次工作階段啟用

Claude 存下第一個檔案時，Claude Code 會問要不要在這個工作階段開啟熱重載（hot reloading，也就是改完自動更新）。選「Enable for this session」，這一輪結束時 Mod 就會載入，之後每一輪有改到 Mod，結束時都會自動重新載入。選「Not now」則暫時不載入，檔案留在原處，下次回到這個工作階段時才載入。

3. 確認已經載入

輸入 /plugin，按 Tab 切到 Installed 分頁，就能看到剛做好的 Mod，也可以在這裡把它關掉。

4. 試用，不滿意就繼續說

直接使用你要的功能。不符合期待，就告訴 Claude 哪裡要改，例如「字改成綠色」「只在工作日顯示」。Claude 改完、這一輪結束，新版本通常就會生效，不必重開；如果沒變，請 Claude 檢查有沒有錯誤訊息。

把做好的 Mod 留下來

這是最容易被忽略的一步。依官方的建立 Mod 說明，Claude 寫的 Mod 只在寫它的那個工作階段載入，而且那個工作階段的 Mod 資料夾超過設定的保留天數（cleanupPeriodDays）就會被清除。

要長期使用，做法是把 Mod 的資料夾從 ~/.claude/dev-mods/ 底下複製到自己的位置，例如 ~/mods/campaign-countdown，之後依用途選擇載入方式：

1. 自己用：開 Claude Code 時加上 --plugin-dir，例如 claude --plugin-dir ~/mods/campaign-countdown。
2. 給幾位同事：直接傳資料夾或壓縮檔給對方。
3. 給整個團隊：放進團隊自己的 marketplace，例如一個私有的程式碼儲存庫，大家從同一個來源安裝與更新。

想之後再請 Claude 修改這個 Mod，也是用 --plugin-dir 指到它的資料夾開對話，這樣 Claude 改完的內容會在同一次對話直接重新載入。

安裝別人寫的 Mod：先加市集，再安裝

依官方的 Mods 總覽，Mod 是以 plugin 的形式從 marketplace 安裝的。格式是外掛名稱、一個 @、再接市集名稱，在 Claude Code 對話中或終端機都能裝：

/plugin install token-chart@your-org
claude plugin install token-chart@your-org

如果 Mod 放在 GitHub 上，官方的外掛安裝說明是先把那個儲存庫加成 marketplace，再從裡面安裝。在對話中輸入 /plugin marketplace add 帳號/儲存庫名稱 加入市集；也可以在安裝指令加上 --marketplace 與儲存庫來源，一次完成加入與安裝。在終端機安裝時，如果 Claude Code 的對話已經開著，要在對話中輸入 /reload-plugins 才會載入，否則等下次啟動。

安裝前先看它會做什麼

這一步請不要省。官方文件說明，Mod 以你的權限執行，能讀寫檔案、啟動程式、連上網路，也看得到你送出的每一則訊息，而且沒有沙箱隔離。安裝前先把 Mod 的檔案下載下來，在終端機跑：

claude plugin validate ./some-mod

輸出中的 hooks: 列出它會處理哪些事件，calls: 列出它會呼叫哪些能力，例如讀檔或連網。一個只是顯示倒數的 Mod，卻要求連網或讀取設定檔，就值得停下來問清楚。第三方擴充的審查原則，可以對照〈第三方 AI Skill 與 MCP Server 怎麼審？〉。

管理與關閉 Mod

日常管理大多在 /plugin 介面完成，也可以用終端機指令。官方的外掛安裝說明列出這些常用操作：

行銷人可以直接照抄的需求描述：寫清楚位置、觸發與預設

以下三段是我們整理的示意寫法，複製後依自己的工作調整細節，再交給 Claude。第二段要能發揮作用，前提是 Claude 已經透過 MCP 或其他工具接上信箱、內容管理系統或廣告平台：

1. 活動上線檢查面板：「幫我做一個 Mod，在對話旁邊開一個面板，列出活動上線前要檢查的項目：UTM、圖片尺寸、優惠代碼、追蹤事件。每一項可以打勾，打勾狀態要保存，下次開對話還在。」
2. 發佈前確認關卡：「幫我做一個 Mod，當 Claude 準備呼叫會寄信、發佈文章或修改廣告設定的工具時，先暫停並顯示它要送出的內容摘要，讓我選執行或取消，沒有回答就當作取消。」
3. UTM 產生指令：「幫我做一個 Mod，新增 /utm 指令，輸入網址、活動代號和通路，就直接回傳加好 UTM 參數的網址，格式固定用小寫和底線。」

描述越具體，Claude 第一版就越接近你要的樣子。最有用的三個細節是：東西要出現在畫面哪裡、什麼情況下觸發、沒有回應時預設怎麼做。第二段把「沒有回答就當作取消」寫進去，是因為官方事件說明的範例也採用相同的安全預設。

Mod 做不出來或沒反應時，先查核准、信任與停用設定

1. 這次對話能不能跳出核准視窗：用 claude -p 這類非互動模式，或 dontAsk 權限模式時，沒有人可以核准，Claude 寫的 Mod 不會載入。
2. 這個資料夾是否已經信任：第一次在某個資料夾開 Claude Code，沒有接受信任提示的話，Mod 也不會載入。
3. Mod 是否被整體關閉：啟動時加了 --safe-mode 或 --bare、設定檔開了 disableAllHooks，或公司的統一設定擋下，都會讓 Mod 停止載入。

這三件事都排除了還是沒反應，可以請 Claude 讀官方的疑難排解說明陪你一步步查。

先做一個每週都會用到的小東西

回到開頭那一行活動倒數。它很小，卻是理解 Mod 最好的起點：說完需求、看到結果、決定要不要留下。從一個每週都會用到的小東西做起，比一次想做完整儀表板容易持續用下去。

工具改得順手之後，被收回來的往往是那些每天重複、沒有人會記得算進工時的零碎時間。

常見問題

Q1：做好的 Mod 可以分享給同事嗎？

A1：可以。人數少時直接傳 Mod 的資料夾或壓縮檔；團隊共用時放進團隊自己的 marketplace，大家從同一個來源安裝與更新；整個組織要統一安裝，則由管理員透過統一管理的設定處理。

Q2：為什麼開新對話後，Mod 不見了？

A2：Claude 寫的 Mod 只在寫它的那個工作階段載入。要長期使用，把 Mod 資料夾從 ~/.claude/dev-mods/ 複製到自己的位置，再用 claude --plugin-dir 載入，或放進 marketplace 正式安裝。

Q3：可以直接安裝 GitHub 上別人分享的 Mod 嗎？

A3：可以，但要照官方流程：先用 /plugin marketplace add 把那個儲存庫加成 marketplace，再用 /plugin install 安裝。安裝前建議先下載檔案，跑 claude plugin validate 看它會處理哪些事件、呼叫哪些能力。

Q4：Mod 做好要多久才能看到效果？

A4：選擇本次工作階段啟用後，Claude 寫完的 Mod 會在那一輪對話結束時載入。之後每次修改，也是在那一輪結束時自動重新載入，不必重開 Claude Code。

Q5：請 Claude 做 Mod，為什麼一直沒有載入？

A5：先查三件事：是否用 claude -p 或 dontAsk 這類沒人能核准的模式、這個資料夾是否接受過信任提示、Mod 是否被 --safe-mode、--bare、disableAllHooks 或公司設定停用。排除後再請 Claude 對照官方疑難排解說明檢查。

Q6：Mod 出問題時怎麼暫時關掉？

A6：單一 Mod 可以在 /plugin 的 Installed 分頁停用。想讓這次工作階段不載入已安裝的 Mod，啟動 Claude Code 時加上 --safe-mode，這也會一併停用其他自訂設定，但內建 Mod 不受影響。

延伸閱讀

• 第一個 Agent Skill 怎麼做？行銷人的每月報表 Skill 手把手教學
• MCP server 怎麼裝？行銷人不會寫程式也能開始，關鍵在挑對入口
• 用 Claude 定期自動跑廣告報告：跨平台月報從吃掉兩週到自動排程產檔

想和 91APP 團隊聊聊 AI 工具怎麼放進你的行銷流程，歡迎透過官網與我們聯繫。