Markdown 版本

AI-translated from English; not yet reviewed by a fluent editor.

# Claude Code mods：建立上下文用量顯示並檢視權限

> Claude Code mods 可在工作階段中繪製介面並改變行為。本指南依據官方文件，說明如何建立上下文用量顯示，以及如何檢視其存取權限。

By BIG CHANGE Editorial

Published: 2026-10-02T04:59:25.238Z
Updated: 2026-10-02T04:59:25.238Z
Canonical: https://bigchange.ai/blog/claude-code-mods-context-display-guide

![Illustrated close-up of a computer display with three mod files, a session usage call, and an orange context strip.](https://bigchange.ai/api/media/file/claude-code-mods-context-hero-v2.png)
AI-generated by OpenAI; BIG CHANGE conceptual editorial illustration.

Claude Code 使用者現在可透過打包成外掛程式的 JavaScript 或 TypeScript 函式，自訂助理介面和行為。Anthropic 於[10 月 1 日推出 mods](https://claude.com/blog/claude-code-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 文件](https://code.claude.com/docs/en/plugins/mods/overview)要求使用 v2.1.287 或更新版本，並指出 mods 預設為啟用。早期存取階段使用的環境變數設定不會控制這個版本。

你必須能使用 Claude Code，並使用已設為信任的工作區。Anthropic 的[設定文件](https://code.claude.com/docs/en/setup)列出 Pro、Max、Team、Enterprise 和 Console 帳戶，以及支援的第三方 API 供應商。Claude 免費聊天方案不包含 Claude Code。組織設定可能會阻止使用者建立的 mods 載入。

請使用互動式終端機工作階段。CLI 和支援的 Desktop 工作階段會顯示 mod 介面。Hooks 也會在 VS Code 聊天面板和無頭工作階段執行，但不會在這些介面中顯示繪製內容。Desktop 的 WSL 工作階段不支援外掛程式。

## 建立並檢視顯示工具

Anthropic 的[10 月 1 日教學](https://claude.dev/blog/getting-started-with-claude-code-mods/)介紹 Token Weather：一種會在每輪對話後讀取上下文用量的顯示工具。其百分比依據前一則回覆使用的上下文量，以及模型的上下文視窗大小計算。這是用量指標，文件並未將其定義為回答品質的衡量方式。

1. 在已設為信任的工作區中啟動 `claude`，並要求它建立一個 mod，在提示詞上方顯示上下文百分比、已使用的權杖數和上下文視窗大小，並在主代理程式每輪工作完成後更新。要求使用文件所述的工作階段用量 API，且只實作顯示功能，不存取檔案、不執行處理程序、不發出網路要求，也不呼叫模型。這是我們針對文件所述建立流程提出的較窄規格；提出要求本身並不能強制實現這些限制。
2. 檢視 Claude 建立的檔案。[建立手冊](https://code.claude.com/docs/en/plugins/mods/create)會將外掛程式放在工作階段目錄下的`~/.claude/dev-mods/`。請檢視其資訊清單、hooks 設定和程式碼。Claude Code 會詢問是否啟用熱載入；若接受，這個工作階段中的 mods 及其後續修訂都會執行。
3. 啟用前，先執行 `claude plugin validate`，後接實際的外掛程式目錄路徑。檢視檢查結果列出的事件 hooks 和 API 呼叫。預期功能只需要讀取用量、保留狀態並繪製介面。也要調查它是否存取檔案、環境變數、處理程序、網路或模型，並檢查原始程式碼中對事件的改寫。驗證成功只代表相容於載入器，不代表安全無虞。
4. 檢視並核准實作後，請執行 `/plugin`，再到 Installed 分頁查看 mod。送出一般要求，確認資訊列會在該輪工作結束後更新。完成的判準是外掛程式已載入、用量數值可見且會更新；只有產生檔案並不能證明功能正常。

這些步驟不保證 Claude 第一次就會產生預期的實作。完整的[Token Weather 實作和測試範例](https://claude.dev/blog/getting-started-with-claude-code-mods/#build-your-first-mod-token-weather)可供比對產生的內容。教學指出，一般工作階段用量讀取不收費；要求用量明細可能會送出權杖計數要求。請 Claude 撰寫或修改 mod，仍會消耗一般 Claude Code 用量。

## 留意程式碼及其權限

在工作階段中建立的 mod 只是暫時性的。建立手冊建議，如要保留，先將其目錄複製到自己的位置，再使用以下命令啟動工作階段：`claude --plugin-dir`，並在命令後指定該位置。每次載入時，系統都會在`.claude-plugin/types/`目錄下寫入與版本相符的宣告；更新時請檢查這些檔案，因為 API 可能改變。

Anthropic 的[管理手冊](https://code.claude.com/docs/en/plugins/mods/admin)說明工具權限規則可能掩蓋的一項限制。Team 或 Enterprise 使用者，以及套用受管理設定的電腦，都會載入內建安全防護機制。使用預設設定時，拒絕規則的優先級高於使用者 mods 對 Claude 工具呼叫的核准。但這些規則不會限制 mod 自行呼叫檔案系統或處理程序 API。管理員可封鎖使用者安裝的 mods，或對其呼叫套用政策 mod。

Pluto Security於[Pluto Security 於 9 月 22 日發布的調查](https://pluto.security/blog/claude-code-function-hooks-security/)指出，研究人員在測試預先發布版本時發現了存取憑證、介面欺騙和遠端變更程式碼等情況。Pluto 銷售這類擴充功能的安全軟體；該報告明確早於正式推出。報告提醒讀者檢查外掛程式原始碼和下載的相依項目，但其中的個別發現不能證明 v2.1.287 的行為。此版本的權限細節應以 Anthropic 現行文件為準。

可透過外掛程式控制項停用 mod。`--safe-mode`這個選項會讓單一工作階段略過已安裝的 mods 和其他自訂項目。

## 用量與成本

Anthropic 的推出公告和 mods 手冊沒有列出額外的 mods 費用。[Claude Code 成本說明](https://code.claude.com/docs/en/costs)指出，訂閱用量會計入方案額度；Console 和雲端供應商用量則按權杖計費。會呼叫模型的 mod 可能會消耗這些用量。請查看`/usage`以及依登入方式適用的計費介面；上下文百分比不是帳單，也不是支出上限。

請一併記錄 Claude Code 版本和已檢視的外掛程式。若加入命令核准或下載輔助工具，就會改變程式碼可執行的操作，因此需要進一步檢視。

## 資料與延伸閱讀

- [Anthropic，《使用 mods 自訂 Claude Code》](https://claude.com/blog/claude-code-mods)，2026 年 10 月 1 日：推出公告、外掛程式打包方式，以及明確的電腦存取警告。Anthropic 開發並銷售 Claude Code。
- [Mods 概覽](https://code.claude.com/docs/en/plugins/mods/overview)，10 月 2 日查閱：版本、支援的工作階段介面、主機權限、驗證和停用控制項。
- [建立 mod](https://code.claude.com/docs/en/plugins/mods/create)，10 月 2 日查閱：建立、核准、熱載入、保留方式和特定版本的型別宣告。文件說明的是預期行為，並非 BIG CHANGE 的測試。
- [Claude Code mods 入門](https://claude.dev/blog/getting-started-with-claude-code-mods/)，Addy Osmani，10 月 1 日：Token Weather 的指標、程式碼和測試範例。示範成果來自 Anthropic。
- [為組織管理 mods](https://code.claude.com/docs/en/plugins/mods/admin)，10 月 2 日查閱：安全防護機制的適用範圍、拒絕規則及管理員選項。這不代表使用者 mods 一般而言與電腦隔離。
- [進階設定](https://code.claude.com/docs/en/setup)和[有效管理成本](https://code.claude.com/docs/en/costs)，10 月 2 日查閱：帳戶前提、依驗證方式而異的計費方法，以及用量追蹤。查閱的推出資料未列出 mods 的額外費用。
- [Pluto Security，《Claude Code 函式掛鉤內幕》](https://pluto.security/blog/claude-code-function-hooks-security/)，9 月 22 日：研究人員對預先發布版本所做的測試及其限制。Pluto 銷售擴充功能安全產品；BIG CHANGE 未重現其測試。

## Sources

- [使用 mods 自訂 Claude Code](https://claude.com/blog/claude-code-mods) — Anthropic 推出公告：CLI 和 Desktop 支援 mods、外掛程式打包方式，以及電腦權限。該供應商也銷售 Claude Code。
- [Mods 概覽](https://code.claude.com/docs/en/plugins/mods/overview) — 持續更新的官方文件：v2.1.287 以上版本、支援介面、權限、驗證和停用方法。這是供應商說明，並非我們的測試。
- [建立 mod](https://code.claude.com/docs/en/plugins/mods/create) — 官方文件說明如何建立、核准、重新載入和保留 mod，以及各版本的型別宣告。生成的程式碼仍需檢視。
- [Claude Code mods 入門](https://claude.dev/blog/getting-started-with-claude-code-mods/) — Addy Osmani 的 Anthropic 教學：Token Weather 指標、完整實作和測試範例。這是供應商示範，並非 BIG CHANGE 的成果。
- [為組織管理 mods](https://code.claude.com/docs/en/plugins/mods/admin) — 官方文件說明內建安全防護機制的適用條件、拒絕規則範圍和管理員控制項。工具拒絕規則不會限制 mod 自行呼叫檔案系統或處理程序 API。
- [進階設定](https://code.claude.com/docs/en/setup) — 帳戶與存取前提：付費訂閱、Console 帳戶或支援的供應商；免費聊天方案不包含 Claude Code。
- [有效管理成本](https://code.claude.com/docs/en/costs) — 方案額度、API／供應商權杖計費及用量追蹤。查閱的推出資料未列出 mods 的額外費用。
- [Claude Code 函式掛鉤內幕：Claude mods 背後的信任問題](https://pluto.security/blog/claude-code-function-hooks-security/) — Pluto 研究人員對預先發布版本進行的安全測試。這些測試不能證明 v2.1.287 的行為；Pluto 銷售擴充功能安全產品。BIG CHANGE 未重現這些測試。