Claude Code 使用者現在可透過打包成外掛程式的 JavaScript 或 TypeScript 函式，自訂助理介面和行為。Anthropic 於10 月 1 日推出 mods，CLI 和 Claude Desktop 的 Code 分頁皆支援這項功能。開發者可在對話中加入上下文用量顯示。
Anthropic 表示，mods 會以使用者在電腦上的權限執行，且不受沙箱隔離。mod 也可能讀取工作階段資料或呼叫模型。安裝前，請檢視程式碼和發布者。
本指南適用於已使用 Claude Code，並想加入小型可視化自訂功能的開發者。目標是建立上下文視窗用量顯示、檢視產生的外掛程式，並決定是否保留。以下步驟依據文件，於 10 月 2 日對照 Claude Code v2.1.287 及更新版本核查。BIG CHANGE 未執行這套流程，也未獨立測試產生的程式碼。
重大變化
- 變化所在：Claude Code mods 可透過既有外掛程式系統加入函式，改變事件處理方式，並在助理介面中繪製內容。
- 重要性：開發者可在工作階段中加入用量顯示或工作流程控制，但也因此讓這些程式碼存取自己的電腦和對話內容。
- 後續觀察：mod 實際發出的呼叫與行為是否符合用途、組織適用哪些控制措施，以及 Claude Code 版本更新帶來的 API 變更。
確認版本、帳戶和工作區
在 shell 中執行 claude --version。目前的 mods 文件要求使用 v2.1.287 或更新版本，並指出 mods 預設為啟用。早期存取階段使用的環境變數設定不會控制這個版本。
你必須能使用 Claude Code，並使用已設為信任的工作區。Anthropic 的設定文件列出 Pro、Max、Team、Enterprise 和 Console 帳戶，以及支援的第三方 API 供應商。Claude 免費聊天方案不包含 Claude Code。組織設定可能會阻止使用者建立的 mods 載入。
請使用互動式終端機工作階段。CLI 和支援的 Desktop 工作階段會顯示 mod 介面。Hooks 也會在 VS Code 聊天面板和無頭工作階段執行，但不會在這些介面中顯示繪製內容。Desktop 的 WSL 工作階段不支援外掛程式。
建立並檢視顯示工具
Anthropic 的10 月 1 日教學介紹 Token Weather：一種會在每輪對話後讀取上下文用量的顯示工具。其百分比依據前一則回覆使用的上下文量，以及模型的上下文視窗大小計算。這是用量指標，文件並未將其定義為回答品質的衡量方式。
- 在已設為信任的工作區中啟動
claude，並要求它建立一個 mod，在提示詞上方顯示上下文百分比、已使用的權杖數和上下文視窗大小，並在主代理程式每輪工作完成後更新。要求使用文件所述的工作階段用量 API，且只實作顯示功能，不存取檔案、不執行處理程序、不發出網路要求，也不呼叫模型。這是我們針對文件所述建立流程提出的較窄規格；提出要求本身並不能強制實現這些限制。 - 檢視 Claude 建立的檔案。建立手冊會將外掛程式放在工作階段目錄下的
~/.claude/dev-mods/。請檢視其資訊清單、hooks 設定和程式碼。Claude Code 會詢問是否啟用熱載入；若接受，這個工作階段中的 mods 及其後續修訂都會執行。 - 啟用前，先執行
claude plugin validate，後接實際的外掛程式目錄路徑。檢視檢查結果列出的事件 hooks 和 API 呼叫。預期功能只需要讀取用量、保留狀態並繪製介面。也要調查它是否存取檔案、環境變數、處理程序、網路或模型，並檢查原始程式碼中對事件的改寫。驗證成功只代表相容於載入器，不代表安全無虞。 - 檢視並核准實作後，請執行
/plugin，再到 Installed 分頁查看 mod。送出一般要求，確認資訊列會在該輪工作結束後更新。完成的判準是外掛程式已載入、用量數值可見且會更新；只有產生檔案並不能證明功能正常。
這些步驟不保證 Claude 第一次就會產生預期的實作。完整的Token Weather 實作和測試範例可供比對產生的內容。教學指出，一般工作階段用量讀取不收費；要求用量明細可能會送出權杖計數要求。請 Claude 撰寫或修改 mod，仍會消耗一般 Claude Code 用量。
留意程式碼及其權限
在工作階段中建立的 mod 只是暫時性的。建立手冊建議，如要保留，先將其目錄複製到自己的位置，再使用以下命令啟動工作階段：claude --plugin-dir，並在命令後指定該位置。每次載入時，系統都會在.claude-plugin/types/目錄下寫入與版本相符的宣告；更新時請檢查這些檔案，因為 API 可能改變。
Anthropic 的管理手冊說明工具權限規則可能掩蓋的一項限制。Team 或 Enterprise 使用者，以及套用受管理設定的電腦，都會載入內建安全防護機制。使用預設設定時，拒絕規則的優先級高於使用者 mods 對 Claude 工具呼叫的核准。但這些規則不會限制 mod 自行呼叫檔案系統或處理程序 API。管理員可封鎖使用者安裝的 mods，或對其呼叫套用政策 mod。
Pluto Security於Pluto Security 於 9 月 22 日發布的調查指出，研究人員在測試預先發布版本時發現了存取憑證、介面欺騙和遠端變更程式碼等情況。Pluto 銷售這類擴充功能的安全軟體；該報告明確早於正式推出。報告提醒讀者檢查外掛程式原始碼和下載的相依項目，但其中的個別發現不能證明 v2.1.287 的行為。此版本的權限細節應以 Anthropic 現行文件為準。
可透過外掛程式控制項停用 mod。--safe-mode這個選項會讓單一工作階段略過已安裝的 mods 和其他自訂項目。
用量與成本
Anthropic 的推出公告和 mods 手冊沒有列出額外的 mods 費用。Claude Code 成本說明指出，訂閱用量會計入方案額度；Console 和雲端供應商用量則按權杖計費。會呼叫模型的 mod 可能會消耗這些用量。請查看/usage以及依登入方式適用的計費介面；上下文百分比不是帳單，也不是支出上限。
請一併記錄 Claude Code 版本和已檢視的外掛程式。若加入命令核准或下載輔助工具，就會改變程式碼可執行的操作，因此需要進一步檢視。
資料與延伸閱讀
- Anthropic，《使用 mods 自訂 Claude Code》，2026 年 10 月 1 日：推出公告、外掛程式打包方式，以及明確的電腦存取警告。Anthropic 開發並銷售 Claude Code。
- Mods 概覽，10 月 2 日查閱：版本、支援的工作階段介面、主機權限、驗證和停用控制項。
- 建立 mod，10 月 2 日查閱：建立、核准、熱載入、保留方式和特定版本的型別宣告。文件說明的是預期行為，並非 BIG CHANGE 的測試。
- Claude Code mods 入門，Addy Osmani，10 月 1 日：Token Weather 的指標、程式碼和測試範例。示範成果來自 Anthropic。
- 為組織管理 mods，10 月 2 日查閱：安全防護機制的適用範圍、拒絕規則及管理員選項。這不代表使用者 mods 一般而言與電腦隔離。
- 進階設定和有效管理成本，10 月 2 日查閱：帳戶前提、依驗證方式而異的計費方法，以及用量追蹤。查閱的推出資料未列出 mods 的額外費用。
- Pluto Security，《Claude Code 函式掛鉤內幕》，9 月 22 日：研究人員對預先發布版本所做的測試及其限制。Pluto 銷售擴充功能安全產品；BIG CHANGE 未重現其測試。
