コスト解説 · 2026-11-20 時点

Claude Code のプロンプトキャッシュ費用: 5 分か 1 時間かは支払い方法で決まる

2026-11-20 時点では、答えは請求方法によって変わります。Claude サブスクリプションでプラン内の利用量の範囲なら 1 時間キャッシュを要求し、API キー、利用クレジット、クラウドプロバイダーは既定で 5 分です。API キーの経路では、promptCacheTtl を 1h に設定すればメイン会話を 1 時間にできます(Claude Code v2.1.242 以降)。Anthropic の公式倍率もそのまま適用されます。5 分のキャッシュ書き込みは入力価格の 1.25 倍、1 時間の書き込みは 2 倍、キャッシュ読み取りはほとんどのモデルで 0.1 倍です。

更新日 2026-11-20

価格は変わります。QCode では Claude・GPT・中国系モデルをトークン単位の課金、最新単価は /models で確認。

#5 分 vs 1 時間#キャッシュ読み取り 0.1x#キャッシュ書き込み 1.25x / 2x#promptCacheTtl=1h

覚えておきたい 4 つの数字

5 分

API キー経路の既定のキャッシュ寿命

API キー、利用クレジット、クラウドプロバイダーではリクエストごとに 5 分です。サブスクリプションが 1 時間になるのはプラン内の利用量の範囲だけで、利用クレジットに移るとメイン会話も 5 分に戻ります。

1.25x

5 分のキャッシュ書き込み: 入力価格の 1.25 倍

キャッシュへの書き込みは、同じトークンを通常の入力として送るより高くつきますが、その後のヒットはキャッシュ読み取りの料金で請求されます。Anthropic の価格ページでは 5 分の書き込みを基本入力価格の 1.25x と記載し、エントリは 5 分間有効です。

2x

1 時間のキャッシュ書き込み: 入力価格の 2 倍

1 時間の書き込みは基本入力価格の 2x で請求され、エントリは 1 時間温かいまま保たれます。数分から 1 時間ほど離れて戻るセッションに向きますが、5 分を超えてアイドルにならない短い連続作業では、この割増は使われません。

0.025x

Fable 5.2 のキャッシュ読み取りは 0.025x のみ

Fable 5.2、Mythos 5.2、Fable 5.1、Mythos 5.1 はヒットが入力価格の 0.025x で請求され、Fable 5.2 では百万トークンあたり $0.20 になります。Opus 5.5 と Sonnet 5.5 は 0.05x、その他のモデルはすべて 0.1x です。

5 分になるリクエストと 1 時間になるリクエスト

2026年11月20日時点で、ドキュメントはすべてのリクエストを2つのバケットに振り分けています。メイン会話(対話的なターン、非対話の -p 実行、Agent SDK のターン、さらに Claude Code がインラインで実行する補助処理)と、それ以外のすべて(サブエージェント、workflows、プロセス内の teammates、fork、コンパクション、セッションタイトル)です。

Claude Code はリクエストごとに TTL を選びます。自分で指定しない限り、1時間を要求するのはプラン内の利用量における Claude サブスクリプションだけで、API キー、利用クレジット、クラウドプロバイダーではメイン会話に5分が適用されます。サブスクリプションでもそれ以外は5分のままで、Anthropic がサーバー側で制御する少数の補助リクエストだけが1時間になります。

API キー、利用クレジット、クラウドプロバイダーではどちらのバケットも5分です。公式の一文は次のとおりです: Unless you choose a TTL yourself, Claude Code requests the one-hour TTL only on a Claude subscription within your plan's included usage. コミュニティの混乱はまさにここに集まり、ある開発者はフォーラムにこう書いています: I still don't understand if cache lasts for 5 minutes or one hour.

変わったこと: TTL 制御、キャッシュパネル、そして変わらない書き込み割増

2026-11-20 時点のドキュメントで、この請求に直接関わる点は 3 つあります。

  1. 1TTL は自分で選べます。promptCacheTtl または CLAUDE_CODE_PROMPT_CACHE_TTL がメイン会話を、subagentPromptCacheTtl または CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL がそれ以外を対象にし、4 つの制御はいずれも Claude Code v2.1.242 以降が必要です。FORCE_PROMPT_CACHING_5M=1 が最優先で、次にそのバケットの環境変数、最後にそのバケットの設定が続きます。
  2. 2キャッシュの状態が見えます。v2.1.251 以降、/usage の Session ブロックに Prompt cache (main) の行が追加され、ヒット率、ミス回数、キャッシュが温かいかどうか、有効な TTL が表示されます。v2.1.260 からは、ツール定義の変更など、最後のミスの考えられる原因も示されます。
  3. 3倍率は変わっていません。5 分の書き込みが 1.25x、1 時間の書き込みが 2x、読み取りはモデルに応じて 0.025x から 0.1x です。2026-11-15 と 2026-11-17 のコミュニティのスレッドでは、あるユーザーが壊れたキャッシュのせいでワークフローの費用が増えたと分析し、別のユーザーはキャッシュが 5 分なのか 1 時間なのかをまだ尋ねていました。比較として、OpenAI の gpt-6.2-sol の公式表ではキャッシュ書き込みを 30m write と 12h write に分けており(入力 $2.00、出力 $10.00、キャッシュ入力 $0.10、30m write は $2.50、12h write は $5.00)、この区分名は Claude の 5 分と 1 時間とは同じではありません。

3 つの日付: コミュニティの 2 つのスレッドと 1 つの公式確認

2026-11-15

あるユーザーが分析を投稿し、壊れたキャッシュのせいで Claude Code のワークフローの一部が高くついたと述べています。スレッドは、セッション途中でのモデル切り替え、ツール定義の編集、キャッシュの寿命より長く離れた後の最初のメッセージを原因として挙げています(コミュニティの報告であり公式の結論ではありません。金額はここでは引用しません)。

2026-11-17

別のスレッドで、ある開発者がキャッシュが 5 分なのか 1 時間なのかまだ判別できないと書いています。公式ドキュメントは 2 行の表でこれに答えています。プラン内の利用量の範囲のサブスクリプションはメイン会話で 1 時間、API キー、利用クレジット、クラウドプロバイダーは 5 分です。

2026-11-20

2026-11-20 時点の公式ルール: プラン内の利用量の範囲のサブスクリプションは既定で 1 時間、API キーとクラウドプロバイダーは既定で 5 分、TTL の変更には v2.1.242 以降が必要で、倍率は 5 分の書き込みが 1.25x、1 時間の書き込みが 2x、読み取りが 0.025x 以上です。

確認済みの課金ルールとコミュニティの誤解

確認済み(Claude Code のキャッシュドキュメントと Anthropic の価格ページ)

2026年11月20日時点で次のとおり検証できます。

  1. 1デフォルト: プラン内の利用量におけるサブスクリプションはメイン会話に1時間、それ以外に5分が適用され、Anthropic がサーバー側で制御する少数の補助リクエストのみ1時間です。API キー、利用クレジット、クラウドプロバイダーではどちらのバケットも5分です。
  2. 2倍率: 5分の書き込みは基本入力の1.25倍、1時間の書き込みは2倍、読み取りはほとんどのモデルで0.1倍です。
  3. 3モデル別のヒット価格: Fable 5.2 と Mythos 5.2 は0.025x(百万トークンあたり $0.20)、Fable 5.1 と Mythos 5.1 は0.025x($0.25)、Opus 5.5 は0.05x($0.20)、Sonnet 5.5 は0.05x($0.10)、その他のモデルはすべて0.1xです。
  4. 4同じ行の価格: Fable 5.2 は入力 $8、出力 $40、1時間の書き込み $16、Opus 5.5 は $4 と $20 で1時間の書き込みが $8、Sonnet 5.5 は $2 と $10 で1時間の書き込みが $4 です。
  5. 5検証: claude -p "hello" --output-format json を実行すると、ephemeral_1h_input_tokens が1時間の書き込み、ephemeral_5m_input_tokens が5分の書き込みを意味します。
  6. 6タイミングと最小値: ヒットのたびに追加コストなしでエントリが更新され、寿命はリクエストの時点から始まります。キャッシュ可能なプロンプトの最小は、Fable 5.2、Mythos 5.2、Fable 5.1、Mythos 5.1、Opus 5.5、Sonnet 5.5、Haiku 5.5 で512トークンです。

コミュニティの誤解と、まだ公開されていない事項

  1. 1「API キーでも 1 時間を追加費用なしで得られる」— 既定では得られません。promptCacheTtl を 1h に設定した場合に限られ、メイン会話以外のリクエストは、そのバケットの TTL も設定するまで 5 分のままです。
  2. 2「1 時間の方が常に安い」— ドキュメントは、5 分を超えてアイドルにならない短い連続作業では逆になると説明しています。そこではより高い書き込み料率が適用され、長い寿命は使われません。
  3. 3「キャッシュヒットには費用がかからない」— ヒットはモデルに応じて 0.025x から 0.1x で請求され、通常の入力料率より低いもののゼロではありません。
  4. 4「effort を変えると必ずキャッシュが再構築される」— Fable 5.1 以降、Opus 5.5、Sonnet 5.5、Haiku 5.5 では、API キーまたはサブスクリプションで既定によりキャッシュはそのまま保たれます。その他のほとんどのモデルでは、effort レベルごとに独自のキャッシュがあります。
  5. 5「サブエージェントは親のキャッシュを読む」— プレフィックスが異なるため、最初のリクエストでは読みません。フォークは親をそのまま継承するため読みます。
  6. 6単一の公式回答はありません。1 時間が各クラウドプラットフォームやゲートウェイでどこまで利用できるかは、そのプラットフォームのドキュメント次第であり、Anthropic 自身のドキュメントは Amazon Bedrock ではモデルによって異なると述べているだけです。

既定の 5 分を維持する場合とメイン会話を 1 時間に設定する場合

既定の 5 分: 間隔が 5 分未満の連続作業

5 分のキャッシュは使われるたびに追加費用なしで更新されるため、リクエストの間隔が 5 分未満であればエントリは温かいままで、1.25x の書き込みは新しい内容にだけ適用されます。長時間の編集作業や連続するツール呼び出しに向いています。5 分を超えて離れると、戻ってからの最初のメッセージでコンテキスト全体が再処理されます。

promptCacheTtl を 1h に設定: 離れてから戻る場合

メイン会話を 1h に設定すると、書き込みは 2 倍で課金され、アイドル状態の空きに対する 1 時間の猶予を得られます。ドキュメント自身のトレードオフの文: It costs more on short bursts of work that never idle past five minutes, where the higher write rate applies and the longer cache lifetime goes unused. つまり、頻繁に離席して戻る使い方なら、この追加料金はコンテキスト全体の再処理を省くために支払うものになります。

5 つの手順:有効な TTL を確認してから変更するか決める

  1. 1まず実際の TTL を確認します:claude -p "hello" --output-format json を実行し、usage.cache_creation を見ます。ephemeral_1h_input_tokens が 1 時間の書き込み、ephemeral_5m_input_tokens が 5 分の書き込みを示します。セッション内では /usage が Prompt cache (main) 行にヒット率、ミス回数、キャッシュが温まっている間の有効な TTL を表示します。
  2. 21 時間にするには settings.json に "promptCacheTtl": "1h" を書くか、CLAUDE_CODE_PROMPT_CACHE_TTL=1h を設定します(v2.1.242 以降)。両方のバケットを 1 時間にするには ENABLE_PROMPT_CACHING_1H=1 を設定します。ANTHROPIC_BASE_URL 経由でゲートウェイに接続する場合、公式の注意書きでは 1 時間のリクエストの一部が anthropic-beta ヘッダーで送られるため、ゲートウェイはそれをそのまま転送する必要があります。設定後は手順 ① で ephemeral_1h_input_tokens が現れることを確認します。
  3. 3デバッグ時は FORCE_PROMPT_CACHING_5M=1 で両方のバケットを 5 分に強制して比較します。これは他のすべての制御より優先されます。
  4. 4キャッシュの再構築を避けます:セッションの途中でモデルを切り替えたり、ツール定義を編集したり、作業ディレクトリを変更したりしないでください。キャッシュは実質的に 1 台のマシンと 1 つのディレクトリに紐づくためです。サブエージェントには subagentPromptCacheTtl で長い TTL を設定でき、Fable 5.1 以降、Opus 5.5、Sonnet 5.5、Haiku 5.5 では effort の変更でキャッシュが既定で保持される点に注意してください。
  5. 5QCode では ANTHROPIC_BASE_URL を https://api.qcode.cc/api に、ANTHROPIC_AUTH_TOKEN を cr_ キーに設定し、手順 ① を繰り返して TTL を確認します。

トークン課金で Claude Code を実行:キャッシュ料金は /models に掲載

QCode はトークン単位で課金します。Claude Code では ANTHROPIC_BASE_URL に https://api.qcode.cc/api を、ANTHROPIC_AUTH_TOKEN に cr_ キーを設定します。TTL 設定の Claude Code 側は上記で説明したとおりです。独自の ANTHROPIC_BASE_URL の背後では、キャッシュはリクエストの転送先に存在するため、キャッシュが機能するかどうかは接続するサービスによります。

設定後は claude -p "hello" --output-format json を実行し、ephemeral_5m_input_tokens と ephemeral_1h_input_tokens をご自身で確認してください。モデル別のキャッシュ書き込みとキャッシュ読み取りの料金は qcode.cc/models にモデルごとに記載されており、そのページが基準です。

月額プランにはまだですか。クォータパックは $4 から、7日以内に使い切る一度限りのクォータとして購入できます。すでに個人プランをお持ちの場合は、クォータが不足したときにブースターパックを追加してください。

よくある質問

同じモデルなのに、API キーではキャッシュが 5 分しかないのはなぜですか

TTL は Claude Code がリクエストごと、かつ課金タイプごとに選ぶためです。公式の表では、プラン内の利用量におけるサブスクリプションはメイン会話に1時間が適用され、API キー、利用クレジット、クラウドプロバイダーではメイン会話に5分が適用されます。メイン会話以外では、サブスクリプションでも5分が適用され、Anthropic がサーバー側で制御する少数の補助リクエストのみ1時間です。API キー、利用クレジット、クラウドプロバイダーでは、これらのリクエストも5分になります。API キーで1時間を維持したい場合は、v2.1.242 以降で promptCacheTtl を 1h にご自身で設定してください。これがドキュメントの定める方法です。

1 時間のキャッシュはそれだけの価値がありますか

リクエスト間の空き時間によります。同じプレフィックスを 5 分ごとより頻繁に使うなら、5 分キャッシュを使い続けてください。追加料金なしで更新され続けるためです。1 時間キャッシュは、5 分ごとより少なく、1 時間ごとより多い頻度で使うプロンプトに向きます。たとえば 5 分を超えて動作するエージェント型のサイドエージェントや、ユーザーの返答を待つ長い会話です。追加コストは、書き込みが入力価格の 2 倍で課金される点です。

キャッシュ読み取りに料金がかかるのはなぜですか

サーバーが実際にそのプレフィックスをもう一度読み取るからです。ただし通常の入力よりはるかに安く、ほとんどのモデルで 0.1 倍、Opus 5.5 と Sonnet 5.5 で 0.05 倍、Fable 5.2、Mythos 5.2、Fable 5.1、Mythos 5.1 で 0.025 倍です。Anthropic の料金ページには計算式があり、5 分の期間で 1.25 倍の書き込みを行うと、1 回のキャッシュ読み取りで元が取れ始めます。

Fable 5.2 のキャッシュ読み取りは実際いくらですか

百万トークンあたり $0.20 です。Fable 5.2 の基本入力は $8/MTok で、ヒットは 0.025 倍で課金されるため、$8 × 0.025 = $0.20 になります。同じ行の 1 時間の書き込みは $16/MTok、5 分の書き込みは $8 × 1.25 = $10/MTok になります(計算例、Anthropic の定価のみで、QCode の価格は含みません)。

途中で effort を変えるとキャッシュは失われますか

Fable 5.1 以降、Opus 5.5、Sonnet 5.5、Haiku 5.5 では既定では失われません。ドキュメントによれば、これらのモデルでは API キーでもサブスクリプションでもキャッシュがそのまま保たれます。他のほとんどのモデルでは effort の各段階が独自のキャッシュを持つため、セッションの途中で effort を変えるとリクエスト全体が再計算されます。ドキュメントは、セッションの冒頭でモデルと effort を選び、/compact はタスク間の自然な区切りに取っておくことを勧めています。

サブエージェントにもキャッシュはありますか

ありますが、別々のキャッシュです。サブエージェントは独自のシステムプロンプトとツールセットで新しい会話を開始するため、最初のリクエストでは親のキャッシュを読めません。その後、自分のターンの間で独自のキャッシュを温めます。メイン会話の TTL バケットの外にあるため、サブスクリプションでも subagentPromptCacheTtl で長い値を選ぶまでは 5 分です。親のキャッシュは影響を受けません。例外は fork で、最初のリクエストで親のキャッシュを読みます。

参考資料

Claude Code 公式のプロンプトキャッシュのドキュメント code.claude.com/docs/en/prompt-caching とコストのページ code.claude.com/docs/en/costs(2026-11-20 に確認)、Anthropic 公式の料金ページ platform.claude.com/docs/en/about-claude/pricing とプロンプトキャッシュガイド platform.claude.com/docs/en/build-with-claude/prompt-caching(2026-11-20 に確認)、OpenAI 公式の料金ページ developers.openai.com/api/docs/pricing(2026-11-20、キャッシュ階層の名称比較のみに使用)、qcode.cc/models(2026-11-20、キャッシュ書き込みとキャッシュ読み取りの料金の基準)、コミュニティの情報は公開のディスカッションスレッドのみに由来し、本文ではユーザーの報告として明示しています。以上はすべて 2026-11-20 に確認しました。

まず TTL を正しく設定し、次にトークン課金のキーへ

QCode アカウントを作成して cr_ キーを取得し、Claude Code で ANTHROPIC_BASE_URL=https://api.qcode.cc/api を設定すると、トークン単位の課金で複数のモデルを呼び出せます。キャッシュ料金は /models に掲載されています。

関連記事

暗号資産チャージガイド

9 通貨・56 ネットワーク、手数料 0 で AI コーディング API クレジットを購入。

Anthropic と OpenAI の料金ページ、および Claude Code の caching と costs のドキュメントは 2026-11-20 に確認済みで、code.claude.com、platform.claude.com、developers.openai.com の内容が正式です。QCode 側の料金は qcode.cc/models に従います。QCode.cc は独立した API アクセスサービスであり、Anthropic、OpenAI などのベンダーと提携関係はなく、承認も受けていません。上記のドル金額はすべてベンダーの公式定価であり、計算例は課金倍数を説明するためのものにすぎません。

どちらから始めるか迷ったら

まず 1 週間試す

小パック $4(枠 $30、7日間)

毎日使う

スターターは月 $9.00、毎日 $5 の枠付き。$1 の枠あたりわずか $0.060で、中パックは約 $0.113です