Claude Code の請求額はどこへ消えるのか
AI API の支出を 1 行ずつ読む:すべてのリクエストにある 3 つの数字、エージェントの請求を静かに支配する仕組み、そして請求書を監査可能にする 3 つの質問。
月次の API 請求書は、疑問を発見するには最悪の場所です。何に使ったかは分かっても、どこへ行ったかは決して教えてくれない——そしてコーディングエージェントとなると、その行き先は初見では本当に意外です。この記事は、請求ダッシュボードを開く前に全開発者が持っておきたい考え方です。
冒頭で開示します:私は Claude Code と OpenAI SDK ツール向けの API ゲートウェイ「Teapot Router」を運営しています。しかしこの記事の内容はそれに依存しません——以下の解剖は Anthropic 互換のどのエンドポイントにも当てはまります。
すべての行は 3 つの数字
コーディングエージェントのリクエストは 3 つの構成要素で課金されます。身につけたい反射神経はこれです:請求書に驚いたら「どのモデルが高いか」ではなく、行を開いて「3 つの数字のどれが動いたか」を問うこと。
- プロンプトトークン —— モデルが読むすべて:システムプロンプト、プロジェクトの文脈、ここまでの会話、ツール結果。長いセッションでは、これが「あなたの質問」であることはほぼなく、質問+回答のために読み直したすべてです。
- 完了トークン —— モデルが書き戻すもの:コード、推論、ツール呼び出し。エージェントの請求では通常マイナーな部分です。
- キャッシュ読み書き —— プロンプトキャッシュの課金。読み取りは大幅割引、書き込みはキャッシュ生成の対価。ツールとエンドポイントがキャッシュを効かせられるかで実質単価は大きく変わります。
静かな主役:コンテキストは毎回再送される
Claude Code などのエージェントは通信上ステートレスです。毎ターン、クライアントは会話を最初から送り直します——システムプロンプト、ファイル文脈、過去のツール結果も含めて。セッション 15 本目のメッセージは、15 本全部を一気に聞いたのと同じ課金になります。それは欠陥ではなくプロトコルの仕組みですが、直感に反する 2 つの事実を説明します:
安いモデルの長いセッションが、高いモデルの短いセッションより高くつくことがある。そして ROI 最良の対策は通常、割引探しではなくコンテキスト管理——古いツール出力の掃除、セッションを小さく保つ、キャッシュに仕事をさせることです。
3 つのレバー、正直な順に
料金表に触る前に、誠実に節約できる順で:
- タスクに合わせてモデルを選ぶ。定型的な編集や検索にフラッグシップは不要で、難しい設計の依頼にこそ必要です。タスク別のルーティングが最大の正攻法です。
- キャッシュを実際に機能させる。プロンプトキャッシュの読み取りはコールドなトークンの 1 桁安です。安定したシステムプロンプトとセッション構造は、どんな料金表よりも効きます。
- サブスク vs 従量 —— 自分の使い方で計算する。1 モデルへの集中型なら定額が勝ち、多様・不定期・複数ツール分散なら従量が勝ち。万能の答えはなく、あなた自身の計算だけがあります。
どんなプロバイダにも問うべき 3 つの質問
どのエンドポイントでも、この 3 つがブラックボックスを監査ログに変えます:
- リクエストごとのコスト・トークン・レイテンシを見られるか——月次合計だけでなく。エクスポートもできるべきです。
- 機械可読な価格表はあるか。コミット前にスクリプトでコストを計算できるか。ログイン不要の公開 JSON エンドポイントが、私は最低線だと思います。
- 未使用残高はどうなるか——有効期限、返金方針、手数料は。「ずっとそこにある」は雰囲気ではなく書かれた方針であるべきです。
プライバシー:コードをエンドポイントに流す以上
何が保持されるかを問うてください。Teapot Router が保持するのは課金メタデータのみで、プロンプト/応答のアーカイブはありません——そして当社を含め、どのベンダーの「ゼロログ」宣伝も鵜呑みにせず検証するべきです。
コスト最適化の専門家になる必要はありません。必要なのは請求書が「応答可能」であること:ダッシュボードを開き、該当行を見つけ、数字の名前を挙げられること。エンドポイントがそれを与えてくれれば、どんな驚きもサポートチケットではなく 1 行の説明になります。
FAQ
長い Claude Code セッションはなぜ 1 メッセージあたり高くなる?
毎ターンそれまでの会話が再送されるため、15 本目は 1 本目よりずっと大きなプロンプトに対して課金されます。トークン単価が同じでも、セッションが長いほど 1 メッセージあたりのコストは増えます。
キャッシュは請求を減らせる?
はい、大幅に:プロンプトキャッシュの読み取りはコールドトークンの 1 桁安です。プロンプトを安定させ、セッションを小さく保てば、同じ文脈に全額を払わずに済みます。
リクエストごとのコストを監査するには?
ワークスペースでリクエストごとのコスト・トークン・レイテンシとエクスポートがあり、照合できる機械可読な価格表があるエンドポイントを使ってください。その組み合わせが請求書を監査ログにします。