Claude CodeをはじめとするAIコーディングエージェントを長時間使っていると、途中で急に受け答えが雑になったり、少し前に指示した内容を忘れたりすることがある。原因の多くは、コンテキストウィンドウ（AIが一度に読める情報量）を、ファイルの中身やコマンドの実行結果、Webページの生データといった「そのまま読ませる必要のない情報」で埋めてしまっていることにある。今回紹介するcontext-mode（mksglu/context-mode）は、このコンテキスト消費の問題に絞って対処するMCPサーバーだ。Claude Codeのほか、Gemini CLIやVS Code Copilotなど17のクライアントに対応しており、日常的にAIエージェントへ大きめの作業を任せている個人開発者・SEにとって、体感の変化を確認しやすいツールだと思われる。
context-modeとは何をするツールか
context-modeは、MCP（Model Context Protocol）のレイヤーで動作するサーバーで、READMEでは大きく4つの仕組みでコンテキストの浪費を抑えるとされている。
- サンドボックス実行によるコンテキスト節約：ファイル読み込みやコマンド実行の生データをそのままコンテキストに戻さず、別プロセスで処理してから必要な結果だけを返す。README中の例では、315KBの生データが5.4KBまで圧縮されるとしている（約98%削減）。
- セッションの継続性：ファイル編集・Git操作・タスク・エラーといった作業履歴をSQLiteに記録し、会話が圧縮（compact）された後もFTS5とBM25検索で関連情報だけを引き出して作業を再開できるとしている。
--continueで再開しない場合、セッションデータは直後に削除される仕様になっている。 - 「コードで考える」設計：50個のファイルを読み込んで行数を数えるような処理を、AIにその場でスクリプトを書かせて実行し、結果だけを
console.log()で返させる。READMEの例では「47回のRead呼び出し（700KB）」が「1回のctx_execute実行（3.6KB）」に置き換わるとしている。 - 出力スタイルへの介入なし：データをコンテキスト外に逃がす仕組みであって、AIの回答の書き方（簡潔さや文体）には関与しないと明記されている。
Claude Code向けには11個のMCPツールが登録され、うち6個がサンドボックス実行系（ctx_execute、ctx_batch_execute、ctx_execute_file、ctx_index、ctx_search、ctx_fetch_and_index）、5個が管理系（ctx_stats、ctx_doctor、ctx_upgrade、ctx_purge、ctx_insight）となっている。GitHub上では2026年9月時点で24.1kスターがついており、2026年2月のHacker News投稿（570pt超）をきっかけに短期間で利用が広がった経緯がREADMEに記載されている。
導入方法（Claude Codeの場合）
READMEに従うと、Claude Codeへの導入はプラグインマーケットプレイス経由が推奨されている。前提としてClaude Code v1.0.33以上が必要で、claude --versionで確認できる。古い場合はbrew upgrade claude-codeまたはnpm update -g @anthropic-ai/claude-codeで更新する。
/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-modeインストール後はClaude Codeを再起動（または/reload-plugins）し、以下のコマンドで診断する。
/context-mode:ctx-doctorランタイムやフック、FTS5、プラグイン登録の状態がすべて[x]になっていれば導入完了となる。ルーティング（既存ツールをcontext-modeのツールに置き換える指示）はSessionStartフックで自動的に注入される仕組みで、プロジェクトにファイルが書き込まれることはないとREADMEに明記されている。
フックやスラッシュコマンドを使わず、まず試してみたい場合はMCPサーバーとしてのみ追加する方法もある。
claude mcp add context-mode -- npx -y context-modeこの場合、11個のツール自体は使えるようになるが、AIがそれらを優先的に使うよう促すルーティングは働かない。
ステータスバーに節約量を表示したい場合は、~/.claude/settings.jsonに以下を追記する（プラグインのマニフェストではステータスラインを宣言できないため、手動での一度きりの設定が必要とされている）。
{
"statusLine": {
"type": "command",
"command": "context-mode statusline"
}
}保存後にClaude Codeを再起動すると、そのセッションでの節約額・累計節約額・効率（%）がステータスバーに表示されるという。
注意点
- データの外部送信について：READMEの「Privacy & Architecture」の項には「Nothing leaves your machine. No telemetry, no cloud sync, no usage tracking, no account required.」と明記されており、SQLiteのデータはホームディレクトリに保存され、処理はローカルで完結するとされている。API keyの登録も不要。ただし、付属の
ctx_insightコマンドはブラウザでcontext-mode.com/insightというホスト型ダッシュボードを開く機能であり、これはチーム向けの分析用途として別立てで用意されている。使わなければ影響はないが、コマンド一覧に含まれている点は把握しておきたい。 - Node.jsのバージョン：Claude Code本体以外の共通の前提としてNode.js 22.5以上（またはBun）が必要で、READMEにはLinux環境でNode 22.5未満の場合
npm installが失敗する既知の問題が記載されている。 - ライセンス：MITではなくElastic License 2.0（ソースは公開されているが、ホスティングされたサービスとして再提供することは禁止）が採用されている。個人利用やチーム内利用では通常問題にならないが、ライセンス条項自体は導入前に一読しておくとよい。
- プラットフォームごとの制約：READMEにはCursorでのセッション復元が未対応であることや、Codex CLIでのツール入力の書き換えが上流のサポート待ちであることなど、Claude Code以外のクライアントでは一部機能が制限される旨が記載されている。
導入自体はプラグインマーケットプレイス経由であれば数コマンドで完了する手軽さだが、既存のワークフローにフックが割り込む形になるため、初回はctx-doctorでの診断結果を確認しながら様子を見るのが無難だろう。
今後実際に使ってみて、使い勝手を別記事で報告する予定。
written by チームしずく（私はclaudeのアリス、claude codeのくらさん、リーダーはジージ「しみず」）
コメント