この記事の目的
Claude Code のコストを検索すると、同じページが 40 回出てくる。プラン階層の表、制限についての段落、そして書き手がその週にたまたま作っていたものに依存する結論だ。表は正しく、そしてほとんど役に立たない。それは「入るためにいくら払うか」に答える。同じプラン、同じリポジトリで、火曜日のセッションが月曜日より 3 倍重く感じた理由には答えない。
2 つ目の問いには算術の答えがあり、その答えはすでにあなたのマシンの上にある。本稿はそれをたどる。1 ターンが実際に何を再送するのか、請求書の 4 行のうちどれが支配的なのか、そして普通の仕事のどこに無駄が潜むのか。製品の話は最後の 3 分の 1 まで取っておく。方法論はそれなしで成立するし、何かを買わないと成り立たないコスト分解はコスト分解ではないからだ。
請求額を説明する 1 つの掛け算
1 ターンはモデルへの 1 往復だ。ハーネスが圧縮するか、あなたがやり直さない限り、それまでの会話すべてが一緒に運ばれる。仕掛けはこれだけであり、一度読んだファイルが一度分の料金で済まない理由でもある。私たちのドキュメントはこれを 1 つの単位、トークンターンで表す。トークン数に、そのコンテンツがコンテキスト内で生き残るターン数を掛けたものだ。
8,000 トークン × 30 ターン = 240,000 トークンターン
15,000 トークン × 37 ターン = 555,000 トークンターン
もう一度読んでほしい。ほとんどの人がここに持ち込む直感が入れ替わるからだ。書くコードが少ないツールが最も節約するのではない。すでに使ったものをコンテキストから外すツールが節約する。ターン 4 に現れて二度と消えない 15k のファイルは、ターン 1 に現れる 8k のファイルの 3 倍以上かかる。そして人々が最適化しようとするのはたいてい後者だ。
1 行ではなく 4 行:請求書の内訳
Anthropic の請求書は入力を 3 つの帯に分ける。新規入力、キャッシュ書き込み、キャッシュ読み込み、それに出力だ。この分割が重要なのは、3 つの入力帯の価格が同じではないからであり、セッションが伸びるにつれて逆方向に動くからでもある。キャッシュ読み込みは基本入力価格のほんの一部で済む。特売のように聞こえるが、キャッシュ読み込みが毎ターン発生すると思い出すまでは。キャッシュ書き込みは通常の入力より高く、キャッシュが失効する前にそのブロックが再び読まれて初めて元が取れる。
その期限こそ、多くの料金記事が省く部分だ。プロンプトキャッシュは短期のリースであり、失効すればメーターはリセットされる。Utilities デモのキャッシュタイマーはまさにこのためにある。温かいキャッシュが数分のアイドルで冷えていく様子を見せ、長い昼休みが次のターンの値段を静かに押し上げる瞬間を目撃できる。割合は価格表とともに変わるが、仕組みは変わらない。
実際、これが同じプロンプト数の 2 つのセッションでコストが大きく違う理由だ。一方は安定したプレフィックスを保ち、温かいままでいる。もう一方はコンテキストの先頭でファイルを編集し、3 ターンごとにプレフィックスを壊し、そのたびにキャッシュを書き直す料金を払う。
トークンは実際どこへ行くのか
5 つのカテゴリが、普通の 1 日の回避可能な重さの大部分を占める。どれも珍しいものではない。すべて、事後にローカルのトランスクリプトで確認できる。
1. 読み続けられるコンテキスト
送るメッセージはどれも、会話全体を引きずる。ターン 40 でも、ターン 3 で開いたファイルはまだ電車に乗り、席を取り、料金を取られている。いつもの対処——新しいセッション——は効くが、人はタイミングを間違える。会話が長く感じたときに再起動し、1 往復あたりのコストがコンテキスト再構築のコストを超えたときには再起動しない。それは別の点であり、更新が報われるのは片方だけだ。
2. 1 つの関数のためにファイル全体
エージェントに validate() を直させるよう頼むと、たいてい auth.ts 全体が渡される。そしてファイル全体が残りのターンのあいだコンテキストに残り、その大半は無関係だ。逆向きにも同じ無駄がある。最初の 20 行で判断できたのに、600 行の一致を返す検索。
3. 誰も読まないツール出力
900 行を出力するテスト実行、モノレポのビルドログ、1 つのパラメータを確認するために取得したドキュメントページの HTML。トランスクリプトはそのすべてを保持する。モデルは必要であろうとなかろうと、次のターンにそのすべてを読む。
4. コードがコンパイルされないと分かるために使うターン
編集が入り、エージェントは完了したと言い、あなたは次を頼み、そのあとで初めて誰かがビルドを実行する。すると、コンパイラなら 2 秒で報告したはずの構文エラーを見つけるための往復があり、直すためにもう 1 往復あり、さらに両方がコンテキストに残るコストがある。普通の午後では、これは 5 つのうち最も静かな項目で、そして私たちの経験では最も見ていて腹立たしい項目だ。
5. 前置きの付いた回答
「良い質問ですね——これから何をするか説明します。」出力トークンを 1 回払い、その後の毎ターン入力トークンを払う。回答が履歴の一部になるからだ。習慣を 40 ターン掛ければ、請求書の 1 行になる。
プラン階層が変えるもの、変えないもの
Claude Code のプランはウィンドウ単位で計測される。5 時間ブロックと週次の上限だ。その構造こそ、料金の議論が堂々巡りする理由である。大きなプランは高い代金で余裕を買う。15k のファイルが毎ターン 15k かかるという事実は変わらないし、再読み込みが安くなるわけでもない。何度もアップグレードすれば、無駄はプランに比例して膨らむ。
正直に言えば、仕事が本当に大きいなら、大きなプランが正しい買い物だ。まず問うべきは、仕事が大きいのか、それともコンテキストが重いだけなのか。外から見れば同じに見え、対処法はまったく違う。
何かを決める前に測る
この記事が具体的でいられるのは、数字がローカルだからだ。Claude Code はトランスクリプトをディスクに書き、ターンごとの実際のトークン使用量を残す。計測レイヤーはどこにも送らずにそれを読める。私たちの計測フロントはそのために存在し、無料だ。Deep Scan は保存された会話を走査して支出を発生源別に分解し、Harness History は閉じたセッションごとのレシートを開き、Inside the Wallet は新規入力・キャッシュ読み込み・キャッシュ書き込み・出力をモデル別に分け、Plan Usage は上限が更新される前に各ウィンドウがどれだけ生んだかを見せる。
先週のいちばんみっともないセッションから始めよう。平均からではない。平均は問題の形を隠す。形こそが動かせるものだ。ターン 2 の巨大なファイル読み込みが 1 回、途中のログが 1 本、600 トークン脱線してから 30 回読み直された回答が 1 つ。
HarnessUp の位置づけ
ここからは何かを売る部分なので、数字と、それを必要とするプランを添える。HarnessUp は Claude Code と Codex の公式フックを通じて動作するローカルレイヤーだ。プロキシではなく、MCP サーバーでもなく、あなたのトークンやキーを読むものは何もない。10 のフロントに 151 のツールがあり、節約フロントの多くは上の 5 カテゴリと 1 対 1 で対応する。
Renew Session は、続けるほうがやり直すより高くつくターンを示し、実際の履歴で測った反実仮想では切り替えが有料コンテキストの 73% に達した。Code Finder は大きなファイルの骨組みを最初の読み込みで返し、本体は要求があったときだけ返す。Delta Read はエージェントがすでに見た範囲を拒否する。Head Limit は百科事典を返す grep に上限をかける。Terminal Guide と Output Diet は長いログの先頭、末尾、エラー行を残す。First Pass は編集直後にコンパイルするので、壊れたビルドは次のターンと一緒に運ばれ、自分のターンを 1 つ消費しない。Response Diet はウォームアップの文章を削る。Memory State はコンテキストファイルを不変の断片に回転させ、コンテキストの 4.27%、298 ターンの生存という測定結果を出した。
私たちが持つ最大の数字は、華やかさはないがもっと役に立つ。Build Now はメッセージの最後にモデルのターンを使わずにビルドを走らせ、2,769 回のビルドと、起こらなかった 806.7M の入力トークン再読み込みを記録した。これらの数字はあなたのものではない。それを走らせたマシンで計測器が測ったものであり、それが反実仮想を提示する誠実な方法だ。だからパネルはあなた自身の削減幅を推定値とは別に表示する。
この分解が約束しないこと
セッション内のすべてのトークンが無駄なわけではなく、そう主張するツールは簡単に検証できる形で嘘をつくことになる。必要なファイルを読むのは無駄ではない。次のターンにそれを読み直すのはモデルの記憶のために払う税であり、その税の一部は仕事の値段だ。算術の狙いはもっと狭い。タスクが要求したものとハーネスが許容したものを分け、どちらに払いたいかを決めることだ。
安いセッションが速いセッションだとも約束しない。ログを圧縮したり前置きを削ったりするとモデルが見るものが変わり、削った詳細こそが重要だった詳細である場合もある。だからここにあるツールはすべて可逆であり、計測レイヤーは無料なのだ。取引を見てから取引すべきだから。