毎日書くことを目指しているけど全然達成できてないブログ
2026.11.21
Claude Code の Code Mode を tmux から動かして、トークンを測ってみた
Claude Code に、Code Mode という実験機能があるらしい。ツールを 1 つずつ呼ぶ代わりに、JavaScript の REPL の中でまとめて実行する仕組みで、有効にするには CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 を付けて起動する。往復が減るならトークンも減るのでは、と思って試した。
結論から言うと、同じ課題で合計トークンは約 4 割減った。ただし 1 回ずつの比較なので、たまたまの可能性は残る。
起動してみる
普段使っている claude-coding(coding 用のプロファイル)の関数に、環境変数を足した。
claude-coding() { CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 _claude_profile coding "$@"; }起動すると、有効にしてよいかの確認画面が出る。bypass permissions で動かしているので、そこは通した。画面には「running N shell commands」と出て、ツールがまとまって動いているのが分かる。使ってみると、間に REPL が挟まっていることで往復が減っているのが実感できた。私は rules に大量にルールを書くスタイルで AI を使っているので、この挙動はとても嬉しい。
バックグラウンドでは効かなかった
最初は claude --bg で別セッションを立てて試した。でも、Code Mode は —bg のセッションでは有効にならなかった。対話式の起動でしか効かないらしい。
なので tmux で対話式のセッションを立てて、指示文を貼り付ける形にした。ここでいろいろ詰まった。
まず、起動直後に指示文を引数で渡せない。--add-dir が可変長の引数なので、あとに続く指示文まで飲み込まれてしまう。起動を待ってから貼り付けることにした。
次に、初めてのフォルダで出る「Yes, I trust this folder」の確認。既定が「No, exit」なので、貼り付けた指示文の Enter でそのまま終了してしまった。画面を見て、Down と Enter で Yes を選ぶようにした。
それから、終わったことの検知。指示文の最後に「終わったら marker ファイルを作って」と足しておき、それを見つけたらログを保存して tmux を閉じる仕組みにした。
トークンの測り方
セッションの記録(~/.claude/projects/ の下の jsonl)に、応答ごとの input・output・cache_write・cache_read が入っている。作業ディレクトリごとに集計する小さなスクリプトを書いた。
入力が極端に少ないのが最初は不思議だった。理由はプロンプトキャッシュで、読み込みの大半は cache_read に入る。今回の測定でも合計の約 88% が cache_read だった。
実際に作らせてみた
Mac で動く電卓アプリを Rust と GPUI で作らせた。結果は、39 応答、合計 1,856,576 トークン、約 8 分。計算ロジック(calc-core)のテスト 16 件は通った。
通常モードと並べる
これだけだと比べる相手がいない。そこで、計算ロジックだけを作る同じ指示を、Code Mode と通常モードで 1 回ずつ流した。
| 項目 | Code Mode | 通常モード |
|---|---|---|
| 応答数 | 15 | 6 |
| 出力 | 9,670 | 9,756 |
| キャッシュ書込 | 154,931 | 181,288 |
| キャッシュ読込 | 495,013 | 884,158 |
| 合計 | 659,622 | 1,075,214 |
| 所要時間 | 約 1 分 4 秒 | 約 1 分 7 秒 |
| テスト | 21 件成功 | 19 件成功 |
合計は Code Mode が通常モードの約 61%。差のほとんどはキャッシュ読込だった。
意外なことに応答数は、往復が減るはずなのに Code Mode のほうが多かった。それなのにトークンは少ない。1 応答あたりのコンテキストが小さくなっているのでは、と考えているけれど、この比較だけでは断定できない。
この一連の手順は /code-mode というスキルにまとめてある。やれるかもしれない。多分。