Mods 概覽

​

Mod 可以做什麼

• 繪製您可以使用的介面：文字記錄旁邊的窗格或提示上方的帶狀區域，具有標籤、按鈕和文字欄位。請參閱在介面中繪製。
• 重新繪製 Claude Code 自己的介面：取代或重新設定 Claude Code 自己繪製的部分，例如工具呼叫的列、微調器或 Claude 提出問題的對話框。請參閱變更 Claude Code 已繪製的內容。
• 進入工具呼叫或請求：例如，在您詢問使用者問題時保留工具呼叫、在不執行工具的情況下回答，或將一個請求傳送到不同的模型。請參閱保護或變更工具呼叫和跟隨一個回合。
• 在命令上執行您自己的程式碼：一個 /command，立即執行您的函式，沒有 Claude 回合，即使 Claude 正在工作。請參閱新增命令或工具。
• 在 hooks 之間共享資料：mod 的 hooks 共享其檔案中的變數，因此一個 hook 記錄的內容，另一個可以顯示。例如，一個 hook 可以計算工具呼叫，而另一個在微調器旁邊顯示計數，或一個可以讀取每個請求的權杖使用量，而另一個在窗格中繪製它。請參閱對事件做出反應。

​

取得 mod

• 使用您已經擁有的：Claude Code 的某些功能是 mods，例如 /diff。請參閱內建於 Claude Code 的 Mods。
• 建立一個：在 Claude Code 工作階段中描述您想要的內容，Claude 會編寫 mod。請參閱向 Claude 要求 mod。若要了解 mod 程式碼的運作方式，自己編寫一個。
• 安裝一個：請參閱安裝或更新 mod，或試用範例 mod

​

安裝或更新 mod

• 在 Claude Code 工作階段中，執行 /plugin install token-chart@your-org。
• 在您的 shell 中，執行 claude plugin install token-chart@your-org。

​

試用範例 mod

• token-weather：在提示詞上方繪製您上下文視窗的預報
• blast-radius：暫停有風險的 shell 命令（例如 rm -rf 或強制推送），並顯示它會變更的內容，附有繼續或取消的按鈕
• replay-theater：新增 /replay 命令，逐步檢視 Claude 在上一個回合中所做的檔案編輯

​

決定是否信任 mod

​

Mod 可以存取什麼

• 在您的機器上以您的身份行動：讀取和寫入您的使用者帳戶可以存取的任何地方的檔案、啟動程式和發出網路請求
• 讀取您的機密：環境變數和設定檔，包括您保留在任一個中的 API 金鑰
• 查看您的工作階段：您傳送的每個提示詞和 Claude 進行的每個工具呼叫
• 變更您的工作階段：重寫提示詞或工具呼叫、提交提示詞，就像您輸入的一樣，或傳送訊息到您的另一個工作階段
• 在不詢問您的情況下行動：在詢問您之前核准工具呼叫
• 花費您的使用量：在您的計畫或 API 金鑰上呼叫模型

​

在安裝 mod 之前列出它的功能

claude plugin validate ./some-mod

​

開啟或關閉 mods

• 終端機：在您的 shell 中執行 claude --version。如果您的版本較舊，請更新 Claude Code。
• Desktop 應用程式：在 Code 標籤的本機工作階段中，輸入 /status 並查看 Claude Code 列，其中會顯示版本，例如 2.1.286。如果您的版本較舊，請更新 Desktop 應用程式。

• 一個 mod：從/plugin 中的已安裝標籤停用或解除安裝其外掛程式
• 每個已安裝的 mod，一個工作階段：使用 --safe-mode 啟動 Claude Code，這也會停用您的其他自訂
• 您安裝的每個 mod，在每個工作階段中：在 ~/.claude/settings.json 中設定 "disableAllHooks": true。您的設定 hook 和自訂狀態列也會停止。您的組織管理的內容會繼續執行。

​

查看工作階段載入了哪些 mods

​

Mod 的運作方式

first-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

• plugin.json：外掛程式的清單
• hooks.json：指向您的程式碼檔案
• register.js：您的程式碼，稱為 hook 模組。它告訴 Claude Code 在哪些事件上執行您的函式。

// The count, shared by the two hooks below
let calls = 0

// Claude Code calls this once when the mod loads
export function register(on) {
  // Runs each time Claude is about to use a tool
  on('tool.call', async ($, e, next) => {
    calls += 1
    // Ask Claude Code to draw the interface again, so the new count shows
    $.ui.invalidate('ui.render')
    // Let the tool run as usual
    return next(e)
  })

  // Runs each time Claude Code draws the spinner
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    // Keep Claude Code's spinner, with the count added after its word
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

• tool.call hook 在 Claude 即將使用工具時執行。它將 calls 加一，要求 Claude Code 再次繪製介面，並讓工具照常執行。
• ui.render hook 在 Claude Code 繪製微調器時執行。它保留 Claude Code 自己的微調器，並在單詞後面新增計數。

​

Hook 可以對事件做什麼

• 觀察：注意正在發生的事情並讓它繼續不變，如範例中的 tool.call hook 所做的
• 重寫：在事件繼續之前變更事件，如 ui.render hook 在將計數新增到微調器時所做的
• 回答：自己處理事件，因此通常的行為不會執行，例如拒絕命令

​

Mods 執行的位置

​

為您的組織控制 mods

​

比較 mods、設定 hook、skills 和 MCP 伺服器

​

內建於 Claude Code 的 Mods

​

讀取內建 mods 的來源

• diff：/diff 窗格，具有綁定到鍵盤動作的按鈕和 mod 自己處理的捲動
• agents-md：將 AGENTS.md 載入為專案指令，具有 userConfig 選項
• sec-default：了解預設情況下會發生什麼中描述的保護，強制執行原則的 mod 的模型
• telemetry：新增其他 mods 可以呼叫的方法，並發送其類型

​

後續步驟

• 建立 mod：建立一個計算工具呼叫、在微調器旁邊顯示計數並新增命令的 mod，並了解編輯和重新載入迴圈
• 在介面中繪製：窗格、提示詞上方的帶狀區域、按鈕、文字欄位和狀態
• 對事件做出反應：工具呼叫、提示詞、回合以及 mods 執行的順序
• 使用 mods API：命令、工具、模型呼叫、計時器和檔案
• 測試 mod：在沒有工作階段的情況下執行的自動化測試
• 對 mod 進行故障排除：mod 不執行任何操作的原因以及偵錯日誌
• 為您的組織管理 mods：預設值、受管設定、檢查 mod 和原則 mods
• Mods 參考：事件、方法、元素和限制