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

# 在 Claude Code 中安裝 Context Mode 並檢查工作階段輸出

> 在 Claude Code 中安裝 Context Mode，於一項限定範圍的程式設計任務中檢查掛鉤和統計，再核對實際檔案與檢查結果後接受修改。

By BIG CHANGE Editorial

Published: 2026-10-20T06:31:38.884Z
Updated: 2026-10-20T06:31:38.884Z
Canonical: https://bigchange.ai/blog/claude-code-context-mode-plugin-install-verify-guide

![Conceptual charcoal illustration of a single desktop terminal monitor with indistinct output marks and one orange line above a keyboard.](https://bigchange.ai/api/media/file/claude-code-context-mode-terminal-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Context Mode 是 Claude Code 的第三方外掛，會透過自己的工具處理部分大型工具結果，並在本機建立工作階段事件索引。開發人員可用它檢查任務期間哪些資訊進入對話。統計描述外掛如何處理工具輸出；工作是否可靠，仍取決於修改的檔案與任務驗收檢查。本指南依據維護者的 1.0.169 版本檔案及 [Claude Code 目前的外掛說明](https://code.claude.com/docs/en/plugins/install)，查核日期為 2026 年 10 月 20 日。BIG CHANGE 沒有為本文安裝外掛或執行程式設計工作階段。

## 關鍵變化

- **發生什麼變化：** Claude Code 外掛可以攔截部分工具呼叫，將大型結果留在對話之外，並索引事件供日後擷取。讀者必須在自己的工作階段中確認市集安裝版本和啟用中的掛鉤。
- **為何重要：** 在較長的程式設計任務中，可將外掛記錄的路由輸出與實際檔案、測試結果對照，判斷篩選後是否保留決策所需的證據，而非將壓縮數字當作有效工作的證明。
- **需要留意：** 關鍵是預期呼叫在安裝環境中是否確實路由，以及壓縮或恢復工作階段後能否取得原始證據。本機報告無法證明供應商費用或程式正確性。

## 安裝前

使用獲得授權的 Claude Code 終端機工作階段，以及你有權修改的儲存庫。選一項範圍明確、完成檢查已知的任務：相關檔案、既有測試或建置命令，以及必須保持的行為。要比較 Claude Code 內建控制，可閱讀我們的 [檢查上下文並繼續工作階段指南](https://bigchange.ai/blog/claude-code-session-context-continue-guide) ，其中介紹 `/context` 及 `/compact` ，不需要此外掛。

在終端機記錄已安裝的 Claude Code 和 Node.js 版本：

```bash
claude --version
node --version
```

該 [固定修訂版本的外掛套件](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/package.json) 要求 Node.js 22.5.0 或更新版本。其 [Claude Code 資訊清單](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/.claude-plugin/plugin.json) 以下列命令啟動 MCP 伺服器： `node`。確認外掛處理程序能找到 Node，開啟互動工作階段，確認 `/plugin` 可用。若沒有，請依照 [相應 Claude Code 發行方式的設定說明](https://code.claude.com/docs/en/setup)；維護者 README 的舊版最低要求，並非目前控制功能的可靠相容性測試。

使用能執行外掛 Bash 掛鉤的平台：macOS、Linux、WSL，或為 Claude Code 設定 Git Bash 的 Windows。Claude Code 本身支援原生 Windows PowerShell，但 [固定修訂版本的掛鉤比對規則](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/hooks/hooks.json) 指定的是 `Bash`，不是 `PowerShell`。這些檔案並未證明僅使用 PowerShell 工具時能自動路由。

在工作區安裝第三方外掛前取得授權。依組織規定檢查其 [Elastic License 2.0](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/LICENSE)、掛鉤命令及伺服器資訊清單。Claude Code 說明，外掛掛鉤和 MCP 伺服器以使用者權限在工具沙箱外執行；核准模型工具呼叫不會將這些程序放入沙箱。外掛可以處理儲存庫內容，並繼承使用者可存取的檔案和憑證。本機索引也不表示選定的提示與結果不會傳給模型供應商。使用敏感內容前，查閱帳戶的 [資料使用條款](https://code.claude.com/docs/en/data-usage) 。

## 1. 明確選擇安裝範圍

在 Claude Code 互動工作階段輸入以下命令：

```text
/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode
```

第二條命令依照 [Claude Code 目前安裝流程](https://code.claude.com/docs/en/plugins/install)開啟外掛詳細資料面板。檢查列出的技能、掛鉤與 MCP 伺服器。除非已授權更廣範圍，請選擇 **本機範圍** ，僅限自己在此儲存庫試用。使用者範圍會在你的各個專案啟用；專案範圍會為安裝外掛的協作者啟用。閱讀安裝摘要及下列介面的 Errors 分頁： `/plugin` 。依指示重新載入或重啟 Claude Code。強制執行 `/reload-plugins --force` 可能讓提示快取失效，產生未使用快取的請求，因此僅在需要當前工作階段立即啟用時使用。

確認 Context Mode 出現在下列介面的 Installed 分頁中： `/plugin`，且範圍符合預期。在獨立終端機記錄實際安裝版本及狀態：

```bash
claude plugin list
```

研究快照是 1.0.169 版本，對應儲存庫提交 `b31c7ee853cb9ea76121e24d368599390972a997`；市集安裝命令 **不會** 固定該提交。判斷命令或行為變化時，以實際安裝版本為準。維護者另行提供的 `npx` 僅 MCP 安裝方式不含自動掛鉤，因此不等於這裡的外掛安裝。

## 2. 診斷已安裝的外掛

在當前 Claude Code 工作階段執行：

```text
/context-mode:ctx-doctor
```

保留完整報告。 [固定修訂版本的診斷技能](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/skills/ctx-doctor/SKILL.md) 將結果標記為 `[OK]`、 `[FAIL]` 及 `[WARN]`。檢查執行環境、掛鉤註冊、SQLite FTS5 搜尋支援、外掛註冊與版本。依明確原因處理失敗。技能或伺服器缺少時，查看下列介面的 Errors 分頁： `/plugin` ，以及 [Claude Code 外掛疑難排解指南](https://code.claude.com/docs/en/plugins/troubleshooting)。診斷通過只建立設定診斷結果；下一步檢查工作時是否真的路由。

## 3. 在實際任務觀察路由

開始前保存目標、驗收檢查與儲存庫狀態。以下終端機命令有助識別原有修改，但不能歸因於外掛：

```bash
git status --short
git diff --stat
```

在 Claude Code 工作階段執行 `/context-mode:ctx-stats` 並保存完整初始報告。接著完成已授權的任務。觀察實際工具名稱及回傳結果：適用的讀取、搜尋、shell 命令或 MCP 呼叫是否經過 Context Mode 工具？能否取回篩選結果省略的原始細節？之後再次執行相同統計命令：

```text
/context-mode:ctx-stats
```

該 [統計技能](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/skills/ctx-stats/SKILL.md) 報告目前工作階段的輸出並按工具細分。若無適用呼叫，空報告代表未觀察到外掛效果。保存前後報告並對照實際呼叫。維護者的壓縮和工作階段時長數字只是其範例，並非你的任務測量。外掛的 token 或上下文估算既不是供應商帳單，也不證明模型正確編輯。Claude Code 與模型仍適用帳戶或供應商條款。

對話壓縮或恢復後，在允許下一次編輯前檢查復原的任務狀態。核對實際檔案、差異及原始驗收命令；取回評估篩選摘錄所需的完整結果。Context Mode 本機事件索引可協助找回先前決定，但回憶出的狀態無法驗證儲存庫。最後執行真正的任務檢查，親自審查差異。記錄命令、退出結果、涉及檔案及未解決失敗。任務失敗時報告仍可能有用，但不能將失敗說成通過。

## 4. 復原時保留證據

若路由阻擋必要工具，保留精確錯誤與診斷報告，再檢查下列介面的 Errors 分頁： `/plugin`。若問題出在外掛，從下列介面的 Installed 分頁停用 Context Mode： `/plugin`，且須位於 **使它啟用的作用範圍**。本機、專案及使用者設定有不同涵蓋範圍與優先順序。開啟新的 Claude Code 工作階段，確認外掛停用，並檢查普通工具與實際任務狀態是否可用。保留解釋問題所需的報告及原始輸出。

停用不會刪除本機索引。 [外掛清除技能](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/skills/ctx-purge/SKILL.md) 說明一項必須明確決定且無法復原的操作： `/context-mode:ctx-purge` 。工作階段範圍要求精確 ID，刪除該工作階段資料列與搜尋片段，同時保留其他工作階段和專案統計。專案範圍刪除專案索引內容、全部專案工作階段事件、事件檔及統計。先保存必要證據，再決定並確認範圍；兩種清除都不是例行排錯步驟。 `/clear` 和 `/compact` 都不會刪除 Context Mode 儲存的資料。

## 來源與延伸閱讀

- [研究提交版本的 Context Mode README](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/README.md) 記載市集安裝、工具、索引及維護者效能範例。本指南未重現範例；請在本機核對實際版本與輸出。
- [Context Mode 套件、外掛資訊清單及掛鉤設定](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/package.json) 建立固定修訂版本的執行環境、授權識別碼、MCP 啟動及掛鉤比對規則。相應步驟已連結資訊清單與掛鉤。
- [Claude Code 外掛安裝指南](https://code.claude.com/docs/en/plugins/install) 解釋詳細資料面板、安裝範圍、狀態、重新載入及停用。 [安全與信任說明](https://code.claude.com/docs/en/plugins/security) 解釋執行邊界，並未針對你的工作區稽核此外掛。
- [Context Mode 診斷、統計及清除技能](https://github.com/mksglu/context-mode/tree/b31c7ee853cb9ea76121e24d368599390972a997/skills) 定義研究修訂版本的診斷、統計與刪除行為，無法證明讀者安裝環境的程式任務成功。

## Sources

- [研究提交版本的 Context Mode README](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/README.md) — 記載安裝、工具、路由、本機事件索引及維護者效能說法。節省用量與持續工作階段範例未重現；市集安裝未固定提交。
- [Context Mode 套件資訊清單](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/package.json) — 建立研究提交的版本 1.0.169、Node.js >=22.5.0 及 Elastic-2.0 識別碼，無法證明讀者安裝版本或執行成功。
- [Context Mode Elastic License 2.0](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/LICENSE) — 規定原始碼可見的 Elastic License 2.0 條件，不支持稱為 MIT 授權或不受限制的開源軟體。
- [Context Mode 的 Claude Code 外掛資訊清單](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/.claude-plugin/plugin.json) — 宣告固定提交中由 Node 啟動的 MCP 伺服器及技能。宣告本身不證明在讀者工作階段中啟動。
- [Context Mode 掛鉤設定](https://github.com/mksglu/context-mode/blob/b31c7ee853cb9ea76121e24d368599390972a997/hooks/hooks.json) — 列出生命週期掛鉤與工具比對規則，包括 Bash，但無 PowerShell 的 PreToolUse 項目。這建立平台限制條件，並非實際路由或通用 shell 支援的證據。
- [Context Mode 診斷、統計及清除技能](https://github.com/mksglu/context-mode/tree/b31c7ee853cb9ea76121e24d368599390972a997/skills) — 固定版本檔案定義診斷狀態標籤、目前工作階段唯讀統計及工作階段或專案清除效果。未提供實測統計、程式正確性或 BIG CHANGE 清除結果。
- [Claude Code：安裝與管理外掛](https://code.claude.com/docs/en/plugins/install) — 說明目前詳細面板安裝、範圍、摘要、Installed 和 Errors 檢視、版本讀取、重新載入及停用。第三方相容性仍需本機確認。
- [Claude Code：外掛安全與信任](https://code.claude.com/docs/en/plugins/security) — 解釋掛鉤及 MCP 程序以使用者權限在 Claude Code 工具沙箱外執行。並非稽核或保證保護本機檔案與秘密。
- [Claude Code：進階設定](https://code.claude.com/docs/en/setup) — 說明支援的發行方式與 Windows 設定，含原生 PowerShell 和 Git Bash。並未驗證維護者 README 舊版最低要求。
- [Claude Code：外掛疑難排解](https://code.claude.com/docs/en/plugins/troubleshooting) — 說明版本、相依項、載入及 Errors 分頁診斷。支持針對原因修復，而非盲目重裝或刪除。
- [Claude Code：資料使用](https://code.claude.com/docs/en/data-usage) — 提供供應商資料使用背景，與外掛本機儲存不同。未證明全部處理在本機，也未證明選定內容不會進入模型請求。
- [BIG CHANGE：檢查上下文並繼續 Claude Code 工作階段](https://bigchange.ai/blog/claude-code-session-context-continue-guide) — 原生上下文與壓縮的相關基線指南，不涵蓋另行安裝 Context Mode、掛鉤診斷、輸出統計或按範圍復原。