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

關鍵變化

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

安裝前

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

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

Terminal
claude --version
node --version

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

使用能執行外掛 Bash 掛鉤的平台：macOS、Linux、WSL，或為 Claude Code 設定 Git Bash 的 Windows。Claude Code 本身支援原生 Windows PowerShell，但 固定修訂版本的掛鉤比對規則 指定的是 Bash，不是 PowerShell。這些檔案並未證明僅使用 PowerShell 工具時能自動路由。

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

1. 明確選擇安裝範圍

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

Text
/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode

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

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

Terminal
claude plugin list

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

2. 診斷已安裝的外掛

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

Text
/context-mode:ctx-doctor

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

3. 在實際任務觀察路由

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

Terminal
git status --short
git diff --stat

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

Text
/context-mode:ctx-stats

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

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

4. 復原時保留證據

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

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

來源與延伸閱讀