Claude Code の context-mode の使い方: 入れただけでは、実は効いていなかった
context-mode を入れて、もう会話の量は大丈夫だと安心していませんか? Claude Code で長い作業を続けていると、ファイルやコマンドの出力が会話にたまり、すぐに要約(compact)が始まってしまいます。context-mode は、その出力を会話の外に置いて「99% 減らす」とうたうプラグインです。
私も3か月ほど入れていました。ところが、長い作業を続けた会話で減った量を見ると、0.0% でした。入れてあるだけでは、量は減っていなかったのです。
なぜ減らないのか、どうすれば減るのか。context-mode の仕組みを確かめ、同じ作業を「出力をそのまま読む」場合と「context-mode の道具で答えだけを出す」場合とで比べてみました。
環境
- macOS 26.6.2
- Claude Code 2.1.309
- context-mode 1.0.169(2026年8月に入れたもの。11月11日時点の最新は 2.1.7)
- 2026年11月11日に確認
動き
フックは止めずに、案内を出すだけ
context-mode は、Claude Code が Read、Bash、Grep、WebFetch などの道具を使う前に動くフック(PreToolUse)を登録します。
VS Code で開いた context-mode の hooks.json
このフックは、道具を止めません。Read でファイルを開くと、「分析するなら ctx_execute_file を使う」という案内が付くだけで、ファイルの中身はそのまま会話に入りました。context-mode の道具を使うかどうかを決めるのは、Claude Code 自身です。Claude Code がふだんの Read や Bash を選べば、量は減りません。これが「入れただけでは効かない」理由です。
道具を使うと、答えだけが会話に入る
context-mode の道具を使ったときに、どれだけ減るのかを比べました。Markdown のファイル27本から、表の数と、見出しの行が空いた表の数を数える作業です。
答えだけを出すと、会話に入る量は約500分の1になりました。
| やり方 | 会話に入った量 | 比べると |
|---|---|---|
| 本文をそのまま出して読む | 182KB | 1 |
ctx_execute の中で数え、答えだけを出す | 366B | 約500分の1 |
ctx_execute では、コードが context-mode の中で動き、print で出した行だけが会話に戻ります。今回戻ったのは「表 44」のような数行だけでした。
入れただけで効くのは、要約のあとの読み戻し
context-mode は、道具を使った記録を手元のデータベースに残します。こちらはフックが自分で書くので、入れてあるだけで働きます。要約が起きたあとには、それまでの作業の記録が会話の頭に読み戻されていました。
道具を入れておくことで会話が重くなる心配も、ほとんどありません。/context を開くと、context-mode の道具は使うときにだけ読み込まれる形で、MCP の道具の合計は 827 トークンでした。
公式との違い
context-mode の GitHub のページには、ツールの出力を会話の外に置き、会話に入る量を 99% 減らすと書かれています。
GitHub の mksglu/context-mode のページ
この数字は、context-mode の道具を通したときのものです。道具を使わずに Read や Bash で読んだ分は、減りません。私の会話では、減った割合のグラフが、context-mode がないときと同じ 613KB(0.0%)でした。同じ画面の別の欄には 86.3KB を外に置いたとも出ていて、道具を使った少しの分だけが減っていました。
対処
注意点
まとめ
context-mode は、入れてあるだけでは会話の量を減らしてくれませんでした。フックは案内を出すだけで、道具を選ぶのは Claude Code だからです。入れただけで働くのは、要約のあとに作業の記録を読み戻すところだけでした。道具を使わせると、同じ作業で 182KB が 366B になります。
入れているなら、まず CLAUDE.md に道具の使い方を書いて、/context-mode:ctx-stats で減っているかを見てみてください。
参考文献
著書
使い方Orca の権限の初めの設定と直し方: 入れた直後、Claude Code が勝手に起動する
挙動Claude Code の context-mode の使い方: 入れただけでは、実は効いていなかった
使い方Postman が Claude Code と Codex に入れたプラグインの確かめ方: Superset も、開いただけでフックが11個
使い方Claude Code の settings.local.json の秘密が漏れる理由: その API キー、GitHub に出てない?
挙動Claude Code と Codex を並列で動かしたときの動き: worktree で分けたのに、マージで衝突
使い方Claude Code の Stop フックで、終わる前にテストを走らせる手順: テストが通るまで終わらせない
使い方Orca の権限の初めの設定と直し方: 入れた直後、Claude Code が勝手に起動する
検証・比較Orca で Claude Code と Codex を GUI で使う手順: ターミナルだけだった Orca が、チャットの画面で使えるように
挙動Claude Code の context-mode の使い方: 入れただけでは、実は効いていなかった
使い方Postman が Claude Code と Codex に入れたプラグインの確かめ方: Superset も、開いただけでフックが11個
使い方Claude Code の settings.local.json の秘密が漏れる理由: その API キー、GitHub に出てない?
使い方Orca の差分の画面の使い方: エージェントへの指摘、1つずつ送っていない?

