T-CREATOR

<div />

Claude Code の context-mode の使い方: 入れただけでは、実は効いていなかった

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。PreToolUse の matcher に Bash と WebFetch が並び、command は node で hooks/pretooluse.mjs を動かすVS Code で開いた context-mode の hooks.json

このフックは、道具を止めません。Read でファイルを開くと、「分析するなら ctx_execute_file を使う」という案内が付くだけで、ファイルの中身はそのまま会話に入りました。context-mode の道具を使うかどうかを決めるのは、Claude Code 自身です。Claude Code がふだんの Read や Bash を選べば、量は減りません。これが「入れただけでは効かない」理由です。

道具を使うと、答えだけが会話に入る

context-mode の道具を使ったときに、どれだけ減るのかを比べました。Markdown のファイル27本から、表の数と、見出しの行が空いた表の数を数える作業です。

答えだけを出すと、会話に入る量は約500分の1になりました。

やり方会話に入った量比べると
本文をそのまま出して読む182KB1
ctx_execute の中で数え、答えだけを出す366B約500分の1

ctx_execute では、コードが context-mode の中で動き、print で出した行だけが会話に戻ります。今回戻ったのは「表 44」のような数行だけでした。

入れただけで効くのは、要約のあとの読み戻し

context-mode は、道具を使った記録を手元のデータベースに残します。こちらはフックが自分で書くので、入れてあるだけで働きます。要約が起きたあとには、それまでの作業の記録が会話の頭に読み戻されていました。

道具を入れておくことで会話が重くなる心配も、ほとんどありません。​/​context を開くと、context-mode の道具は使うときにだけ読み込まれる形で、MCP の道具の合計は 827 トークンでした。

Claude Code の /context の画面。MCP tools は /mcp (loaded on-demand)、25 tools · 827 tokens と出ているClaude Code の /context の画面

公式との違い

context-mode の GitHub のページには、ツールの出力を会話の外に置き、会話に入る量を 99% 減らすと書かれています。

GitHub の mksglu/context-mode のページ。About に Free, local plugin that keeps tool output out of your coding agent's context window と 99% fewer bytes in context と書かれている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 で減っているかを見てみてください。

参考文献

著書

とあるクリエイター

フロントエンドエンジニア Next.js / React / TypeScript / Node.js / Docker / AI Coding