Context Mode は Claude Code のサードパーティ製プラグインです。一部の大きなツール結果を独自のツール経由で処理し、セッションイベントの索引をローカルに保存します。開発者は作業中に何が会話へ渡されたかを調べられます。統計が示すのは出力処理であり、作業の正しさを判断するのは変更ファイルと受け入れ検証です。本稿は管理者のバージョン 1.0.169 のファイルと Claude Code の現在のプラグイン手順に基づき、2026年10月20日に確認しました。BIG CHANGE は本稿のためにプラグインを導入したり開発セッションを実行したりしていません。

大きな変化

  • 変わったこと： 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

2番目のコマンドは Claude Code の現在の導入手順に従ってプラグイン詳細画面を開きます。スキル、フック、MCP サーバーを調べます。より広い範囲が認可されていなければ、 ローカル範囲 を選び、このリポジトリ内で自分だけが試すようにします。利用者範囲は自分の全プロジェクト、プロジェクト範囲は導入した共同作業者に有効です。導入の概要と、次の画面の Errors タブを確認します： /plugin 。指定された再読み込み手順に従うか、Claude Code を再起動します。強制的な /reload-plugins --force はプロンプトキャッシュを無効化してキャッシュなしの要求を発生させる可能性があるため、現在のセッションですぐ有効化したい場合だけ使います。

次の画面の Installed タブに Context Mode が意図した範囲で表示されることを確認します： /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 とモデルの利用には引き続きアカウントまたは提供元の条件が適用されます。

会話が圧縮された場合や再開時は、次の編集を許可する前に復元された状態を調べます。実際のファイル、差分、元の受け入れコマンドを確認し、フィルタ済み抜粋を判断するため必要な完全な結果を取得します。ローカル索引は以前の判断を探せますが、記憶された状態はリポジトリの検証ではありません。最後に実際の検証を実行し、差分を自分で確認します。コマンド、終了結果、対象ファイル、未解決の失敗を記録します。失敗時も報告は役立ちますが、失敗を合格に変えてはいけません。

4. 証拠を捨てずに復旧する

経路制御で必要なツールが遮断されたら、正確なエラーと診断報告を保存し、次の画面の Errors タブを調べます： /plugin。プラグインが原因なら、次の画面の Installed タブから Context Mode を無効にします： /plugin。操作するのは 有効化に使われた範囲です。ローカル、プロジェクト、利用者の設定は範囲と優先順位が異なります。新しい Claude Code セッションを開き、無効化を確認して、標準ツールと実際の作業状態が使えるか調べます。原因説明に必要な報告と元の出力を保存します。

無効化してもローカル索引は削除されません。 プラグインの消去スキル は意図して実行する不可逆の操作 /context-mode:ctx-purge を説明します。セッション範囲では正確な ID が必要で、その行と検索断片を削除し、他のセッションとプロジェクト統計は残します。プロジェクト範囲では索引内容、全プロジェクトセッションのイベント、イベントファイル、統計を削除します。必要な証拠を保存した後に範囲を判断し確認してください。どちらも通常の問題解決手順ではありません。 /clear と /compact は Context Mode の保存データを削除しません。

出典と参考資料