Claude Codeのトークン9割はファイルの読み書きに消えていた

Claude Codeのトークンの9割は推論でなく読み書きだった

Claude Codeが処理するトークンの約9割は高度な推論ではなく、ファイルの読み込みやコードの生成に使われています。Spotifyのエンジニア、ディミトリ・マズマノフ氏がこの点に着目した手法をSpotify Engineeringのブログで公開しました。

1つのメソッドについて答えるために5つのファイルを読む処理や、既存の20個のテストに合わせて新しいテストを書く処理がその典型です。マズマノフ氏はこうした作業のすべてを高性能モデルに任せる必要はないと考えました。

そこで「読む仕事」と「書く仕事」を軽いAIモデルに振り分けるbulk-readerとcode-writerの2つのモードを用意しました。作業用モデルにはGemini 2.5 Flashを使っています。ほかのモデルに置き換えることもできます。

350行を超えたら止める　shuntが自動で振り分ける

bulk-readerはClaudeの代わりに大きなファイルを読みます。ファイルそのものをClaudeのコンテキストに入れず、必要な情報だけを短くまとめてClaudeに返す仕組みです。数千行のコードではなく要約だけがClaudeに渡ります。

code-writerは逆にコードの「出力」を切り離す役割です。テストコードや設定ファイルのひな型を既存パターンに合わせて書かせます。参考ファイルの指定が必須のため、プロジェクトの命名規則に合ったコードになります。

この振り分けを強制するのがshuntというClaude Codeプラグインです。PreToolUseフックでClaudeのツール実行を監視し、350行を超えるファイルを開こうとするとブロックしてbulk-readerへ回します。読むべき箇所を指定する場合やgrepで絞り込む場合はそのまま通します。

Claude Codeのフックを使えば同じ仕組みは再現できる

マズマノフ氏はSpotifyの開発者向けプラットフォームPortal by Spotify上でこの仕組みを構築しました。当初はCLAUDE.mdに振り分けルールを書いていましたが、Claudeが指示を守らないことがあり安定しませんでした。

shuntプラグインに切り替えたことで、Claudeがルールを無視しても物理的にブロックされるようになりました。shuntのソースコードはGitHubで公開されています。

Claude Code単体でもPreToolUseフックを設定すれば、350行のしきい値でファイル読み込みを止める部分は再現できます。bulk-readerの部分はMCPサーバーや外部スクリプトで軽量モデルを呼ぶ仕組みを別に用意する必要があります。

90%の削減に代償もある　軽いAIは安全性を見落とした

マズマノフ氏がJavaのモノレポで4種類のシナリオを検証した結果、bulk-readerを使ったケースではClaude側のトークン消費を平均約90%削減できました。

ただし何でも別モデルに任せればよいわけではありません。検証では軽量な作業用モデルが表面的なコードパターンは見つけたものの、スレッドセーフティーに関わる問題を見逃した場合もありました。

Claude Codeの費用を抑えたいなら、まず自分のプロジェクトで350行を超えるファイルの読み込みがどれだけあるかを確かめるのが第一歩です。Anthropicもキャッシュの値下げでコストを下げており、あわせて使えば効果はさらに広がります。