Claude Codeのトークンコスト:1セッションで実際に何を消費するか

結論:1セッションはセントではなくドル単位を見込む

Claude Codeはチャットウィンドウではなく、エージェント型のツールです。あなたからの1回のリクエストが何十回ものモデル呼び出しを引き起こし、それぞれの呼び出しが増え続ける会話全体を入力トークンとして再送します。そのため、コストを左右するのは出力ではなく入力量です。出力トークンは、入力に比べればたいてい誤差の範囲に収まります。 コミュニティで報告されているおおよその数字では、中規模リポジトリでの本格的な1時間のセッションはおよそ500万〜2,000万トークンです。Sonnet 4.6のAnthropic直接レート(入力100万あたり$3、出力100万あたり$15)では、キャッシュ割引前でほとんどのセッションが約$2〜$40に収まり、Opusを多用する日はそれをはるかに超えます。プロンプトキャッシュは単純計算より実際の請求額を下げますが、傾向は変わりません。大きなリポジトリでの長いセッションは実際にお金がかかります。 レバーは3つあります。コンテキストウィンドウに入るものを減らすこと、定型作業を安いモデルにルーティングすること、そしてリクエストの課金先を変えてトークンあたりの単価を下げることです。このページの残りでは、それぞれを具体的な数字とともに見ていきます。

トークンは実際どこへ消えるのか

これを和らげる仕組みが2つあります。1つはAnthropicのプロンプトキャッシュです。Claude Codeは安定した接頭辞をキャッシュ可能としてマークし、キャッシュ書き込みはプレミアムがかかりますが、キャッシュ読み取りは通常の入力レートのおよそ10分の1で課金されます。もう1つはコンテキストの圧縮です。/compactコマンドは履歴を要約し、生の会話ログを破棄します。どちらも大きく効きますが、基本ルールは変わりません。ウィンドウに存在するものはすべて、それを含む呼び出しのたびに課金されます。 これが、同じプロンプトでもリポジトリによってコストが大きく変わる理由です。軽量なCLAUDE.mdを持つ新しいセッションでの質問は安く済みます。同じ質問を、十数個の大きなファイルを読み込んだセッションの30ターン目に投げると、6桁規模のトークンウィンドウの上に乗ることになります。

• システムプロンプトとツール定義:おおよそ15,000〜20,000トークンで、モデル呼び出し1回ごとに再送されます。
• CLAUDE.md、ルールファイル、MCPツールスキーマ:セッション開始時に読み込まれ、以降のすべての呼び出しで運ばれます。
• ファイル読み込み:500行のソースファイルはおよそ5,000〜7,000トークンで、一度読み込まれるとウィンドウに残り続けます。
• ツールの実行結果:テスト出力、grepのヒット、ターミナルログは会話に追加され、以降のすべてのターンで入力として再課金されます。
• エージェントのループ自体:「この失敗したテストを直して」という1つの指示が、Claude Codeが応答を返すまでに10〜40回のモデル呼び出しを生むことがあります。

現実的なセッションコストの計算

勘に頼らず、ターンごとにモデル化しましょう。典型的な中規模セッションはおよそ40回のモデル呼び出しを行います。いくつかのファイルとテスト出力が蓄積された後、ウィンドウ全体は1回の呼び出しあたり平均約90,000トークンになります。40回の呼び出しに90,000トークンをかけると、入力トークンは360万です。出力は小さく、40回の呼び出しにそれぞれ約1,000トークンとして、出力トークンはおよそ40,000です。 下の表は、3つのセッションプロファイルをAnthropicの直接定価で価格付けしたものです。これらは上限として扱ってください。プロンプトキャッシュは繰り返される接頭辞を大きく割り引くため、キャッシュされたセッションは通常もっと低くなります。それでもパターンは開発者の報告と一致します。たまの午後なら数ドル、Opusを毎日常用してAPIで動かすと月に数百ドルに達することもあります。

プランとAPI:Claude Codeが安くなるのはどちらか

AnthropicはClaude Codeを2通りで販売しています。ローリングウィンドウで使用量上限を課す定額サブスクリプションプランにまとめる方式と、APIでトークン単位に計測する方式です。Claude CodeのAPI料金は単に、上のモデルレートをセッションが消費した量に適用したもので、上限も打ち切りもありません。 損益分岐点は単純な算数です。典型的なセッションが直接レートのSonnetで約$11かかるなら、$20のプランは上限内に収まる限り月2セッションほどで元が取れます。問題は上限そのものです。ヘビーなエージェント利用こそ、まさにローリング制限に引っかかるパターンであり、セッションの途中で締め出された瞬間、定額はもう安くありません。API課金はこれを逆にします。締め出されることはなく、消費した分だけ支払います。多くのヘビーユーザーはハイブリッドに落ち着きます。対話的な作業にはプランを、CIジョブやあふれ分にはAPIキーを使うという形です。

Claude Codeのトークンコストを減らす方法

最後の2つのレバーは組み合わせが効きます。安いモデルを割引されたエンドポイント経由でルーティングすれば、定型作業では$10のセッションが1ドル未満に収まることもあります。 ゲートウェイの選択肢の1つがAPIsRouterです。従量課金でサブスクリプション不要のOpenAI互換APIで、グローバルモデルは公式定価より20%安く、中国製モデルは公式レートより安く設定されており、初回チャージには+100%の残高が付き、登録不要の/topupのチェックアウトは先に支払いを受けてからキーをメールで送ります。以下のカタログは、実際のルーティングの段階分けがどう見えるかを示しています。予算ティアとして好みなら、Kimi K2.6(kimi-k2.6)も利用できます。

• CLAUDE.mdを軽く保つ。1行1行が、すべてのセッションのすべてのモデル呼び出しで繰り返し課金される項目です。
• タスクごとに新しいセッションを始め、長いセッションが膨らんできたら/compactを実行する。150,000トークンのウィンドウは、呼び出しのたびに150,000トークン分が課金されます。
• 読み込む範囲を絞る。Claude Codeを特定のファイルに向け、勝手に巡回させないようにし、ビルド出力やベンダーディレクトリは除外する。
• 使っていないMCPサーバーは無効にする。そのツールスキーマは、すべての呼び出しでシステムプロンプトに乗り続けます。
• モデルでルーティングする。設計や厄介なデバッグにはOpusを残し、デフォルトはSonnetで動かし、定型コード・テストの雛形・コミットメッセージは安いモデルに回す。
• ベースURLをゲートウェイに向けることで、トークンあたりの単価そのものを下げる。直接の定価で課金するのをやめる。

設定例:Claude Codeの向き先を変えて検証する

Claude Codeは起動時にANTHROPIC_BASE_URLを読み込むため、トークンの課金先を切り替えるのはワークフローの変更ではなく設定変更です。エンドポイントとキーを~/.claude/settings.jsonに置けば、すべてのセッションがそれを取り込みます。モデルIDはそのまま、ツール実行は引き続きあなたのマシン上でローカルに行われ、ロールバックは1行をコメントアウトするだけです。 OpenAI互換のツールやスクリプトでは、ベースURLは/v1で終わります(https://api.apisrouter.com/v1)。日常的に使う前に、一度のcurlでキーを検証してください。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apisrouter.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-APIsRouter-...",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6"
  }
}

よくある質問