nekolas note

毎日書くことを目指しているけど全然達成できてないブログ

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通常モード
応答数156
出力9,6709,756
キャッシュ書込154,931181,288
キャッシュ読込495,013884,158
合計659,6221,075,214
所要時間約 1 分 4 秒約 1 分 7 秒
テスト21 件成功19 件成功

合計は Code Mode が通常モードの約 61%。差のほとんどはキャッシュ読込だった。

意外なことに応答数は、往復が減るはずなのに Code Mode のほうが多かった。それなのにトークンは少ない。1 応答あたりのコンテキストが小さくなっているのでは、と考えているけれど、この比較だけでは断定できない。

この一連の手順は /code-mode というスキルにまとめてある。やれるかもしれない。多分。

※ 発信は個人の見解です © nekolas 2026 · プライバシーポリシーRSS