Claude Code mods 完整介紹
什麼是 Claude Code mod?
Claude Code mod(也常簡稱 Claude mod)是提供 hooks module 的外掛。模組註冊工作階段事件處理函式,可加入介面(例如即時面板或狀態列),或改變工具呼叫的處理方式,例如顯示計數器、追蹤花費、增加說明工作流程的指令。Mod 不代表新模型、訂閱升級或品質認證。
你可以把它當作對話裡的小工具:查看花費、接收完成通知、追蹤代理狀態,或在等待時玩小遊戲。
官方文件
Claude Code 的 API 會隨版本更新,請以你所安裝版本的官方文件為準:Mods 概覽、建立 mod、安裝與管理外掛,以及 Claude Code 文件首頁。ClaudeMods 是獨立的社群作品目錄,與 Anthropic 沒有隸屬或背書關係。
用 /plugin 安裝 mod
- 開啟作品頁,閱讀原始來源、README 與權限等級。
- 在 Claude Code 內執行
/plugin瀏覽 marketplace 與已安裝的外掛,或使用命令列:
claude plugin marketplace add owner/repo
claude plugin install plugin-name@marketplace-name
- 將
owner/repo、plugin-name、marketplace-name換成作者文件中的值。不是每個儲存庫都有 marketplace;沒有的話請依 README 操作,或用目前 CLI 支援的--plugin-dir選項試用本機目錄。 - 若作者要求,請重新啟動或重新載入工作階段,確認行為後再加入下一個 mod。移除方式請參考
claude plugin --help與 README。
更多細節:如何安裝 mod。
Mod、外掛、hook、skill 的差異
| 名詞 | 是什麼 | 常見用途 |
|---|---|---|
| 外掛(Plugin) | 你安裝的套件,可包含 skills、hooks、mods 等。 | 透過 marketplace 或儲存庫分享一組工具 |
| Mod | 提供 hooks module(function hooks)的外掛:處理工作階段事件,並可附帶介面。 | 狀態列、儀表板、計數器、通知、小遊戲 |
| 傳統 hook | 事件觸發時執行的設定動作,通常是 shell 指令。 | 驗證變更、執行格式化、發送通知 |
| Skill | 教 Claude 一套可重複流程的說明與資源。 | 發布檢查、團隊風格、檢查清單 |
更完整的比較見Mod、hook、skill 與 MCP 的差異。
權限等級 L0–L3
ClaudeMods 為每個作品標示掃描等級。這是本目錄的掃描分級,不是 Anthropic 的權限模式、沙盒或認證。
| 等級 | 偵測到的能力 |
|---|---|
| L0 | 顯示或純邏輯 |
| L1 | 讀取檔案或環境 |
| L2 | 寫入、執行或改變工具行為 |
| L3 | 網路或模型存取 |
較低的等級不代表程式碼無害,未掃描的作品需要額外檢查。請閱讀Mod 安全:L0–L3 說明,並試用權限掃描器。
三個需要檢查的檔案
.claude-plugin/plugin.json:外掛名稱與版本等資訊。hooks/hooks.json:以 modules 陣列宣告要載入的函式模組。register.tsx:註冊事件與介面的程式碼。
一個儲存庫可能包含多個外掛,不要預設根目錄就是要安裝的作品。入口檔案之外,相依套件也要檢查。
從小實驗開始
在可丟棄的專案裡試用唯讀顯示功能。需要持續資訊時儀表板很合適;一次性的固定動作用傳統 hook 可能更簡單。若干擾其他外掛,應能立即停用,也不要授予自己無法解釋的權限。
評估目錄裡的作品
先依用途分類,再查看原始來源與維護狀態。星數反映關注度,不等於安全;掃描結果只描述看得到的程式模式,可能遺漏動態載入的程式。記錄安裝版本與移除方式。想自己做一個?請看用 TypeScript 寫 Claude Code mod。
熱門 Claude Code mods
已發佈的作品,依社群票數再依 GitHub 星數排序,自動更新。
- token-optimizer★ 2,981
- savvy-progress★ 380
- pixel-crew★ 4
- agent-flow★ 30
- 工作時和 Claude Code 下棋★ 33,441
- rainbow-week★ 2
- 我剛把 'npx RuFlo' 移植到新的 Claude Code Mod 系統。這是下一個層次。我★ 81,451
- ruflo-music★ 81,451
- cache-warmer★ 100
- cache-warmer★ 24
FAQ
什麼是 Claude Code mod?
Claude Code mod 是提供 hooks module 的外掛。它註冊工作階段事件的處理函式,可加入即時面板或狀態列等介面,或改變工具呼叫的處理方式。它不是新模型,也不是訂閱升級。
如何安裝 Claude Code mod?
先閱讀作品的原始碼與權限等級,再在 Claude Code 內執行 /plugin,或用命令列:claude plugin marketplace add owner/repo,接著 claude plugin install plugin-name@marketplace-name。請使用作者文件中的名稱,因為不是每個儲存庫都有 marketplace。
Mod、hook 與 skill 有什麼差異?
外掛是可安裝的套件。Mod 是提供 hooks module、處理工作階段事件並可附帶介面的外掛。傳統 hook 是事件觸發時執行的設定動作,通常是 shell 指令。Skill 則是教 Claude 一套可重複流程的說明。
Claude Code mod 安全嗎?L0–L3 是什麼意思?
ClaudeMods 會掃描每個作品並標示 L0(顯示或純邏輯)、L1(讀取檔案或環境)、L2(寫入、執行或改變工具行為)、L3(網路或模型存取)。這是本目錄的掃描分級,不是認證:低等級不代表程式碼無害,安裝前請先閱讀原始碼。
ClaudeMods 是 Anthropic 官方網站嗎?
不是。ClaudeMods 是獨立的社群作品目錄,與 Anthropic 沒有隸屬或背書關係。官方說明請見 code.claude.com/docs 的 Claude Code 文件。
可以用 TypeScript 寫 Claude Code mod 嗎?
可以。一個 mod 由三個檔案組成:.claude-plugin/plugin.json、hooks/hooks.json,以及 hooks/register.tsx 這類入口。入口從 claude-code 匯入 Register 型別,並為 session.start、command.run 等事件註冊處理函式。用 claude plugin validate 檢查,並以你所安裝的 Claude Code 版本產生的型別宣告為準。
什麼時候該用 MCP 而不是 mod?
MCP 把 Claude 連接到獨立的工具或資料服務,缺少的能力在另一個服務裡時再考慮它。Mod 處理 Claude Code 內的工作階段事件與介面;skill 適合說明流程,傳統 hook 適合固定動作,它們可以在同一個工作流程裡組合。
怎樣安全地試用 mod?
在可丟棄的專案裡,先試唯讀的顯示類 mod。先閱讀原始碼與 L0–L3 等級,並確認能立即停用或移除。不要授予自己無法解釋的權限,並記錄安裝的版本與移除方式。