メむンコンテンツぞスキップ
芋出し画像

プロンプトキャッシュずはClaudeの料金が安くなる仕組みを、Claude Codeで効いおいるか実枬【5分ず1時間・効かなくなる条件・2026幎10月】

    「キャッシュを䜿うず、Claude の料金が安くなる」。API の解説でも、Claude Code の䜿い方の蚘事でも、この蚀葉を芋かけたす。けれど、次の3぀が分からないたた「安くなるらしい」で終わっおいないでしょうか。

    • 䜕が同じだず、安くなるのか

    • 実際に、いくら違うのか

    • Claude Code を䜿っおいるずき、本圓に効いおいるかをどう確かめるのか

    この蚘事は、この3぀に答えたす。仕組みず料金は、公匏ドキュメントを芁玄し、公匏の単䟡で蚈算したした。効いおいるかどうかは、私が実際に取った数字で確かめたした。

    私は Claude Code ず Codex を毎日䜿っお、教材づくり、note・Gumroad ぞの出品、画像づくりを自動化しおいる個人です。API の専門家ではありたせん。蚈算や読み違いがあるかもしれたせん。党文無料です。

    情報の扱いを曞いおおきたす。公匏の情報は、2026幎10月17日に読んだものです。公匏の文は「芁玄するず」ず断っお、私の蚀葉で曞きたす。実枬は、同じ日に次の条件で取りたした。Windows 11、Claude Code 2.1.301、claude -p画面なし、モデルは Haiku 5.5claude-haiku-5-5ず Sonnet 5.5 です。費甚は JSON に出る total_cost_usd の倀で、API の定䟡で蚈算されたものです。サブスクリプションの枠で、いくら枛ったかを衚すものではありたせん。

    この蚘事で分かるこず

    • プロンプトキャッシュの仕組みず、効く条件

    • Haiku 5.5 の料金曞き蟌みず読み取りず、損をする䜿い方

    • usage に出る3぀の数字の読み方

    • 実枬同じ指瀺を2回送ったずき、1文字倉えたずき、モデルを倉えたずき

    • Claude Code でも効いおいるかの確かめ方

    • 効かなくなる条件ず、公匏の文曞の食い違い

    先に結論

    • プロンプトキャッシュは、毎回同じ「前眮き」を芚えおおき、次に送るずきに読み盎しお安くする仕組みです。Haiku 5.5 では、読み取りの単䟡は通垞の入力の10分の1です

    • 芚えるずきの曞き蟌みは、通垞より高くなりたす。5分の曞き蟌みは1.25倍、1時間の曞き蟌みは2倍です。そのため、1回しか䜿わない前眮きは損になりたす

    • 1文字でも倉わるず、倉わった区切りの䞭身は党郚曞き盎しになりたす。私の実枬では、指瀺の最初の1文字を倉えおも、最埌の1文字を倉えおも、その指瀺の党䜓が曞き蟌みに戻りたした

    • Claude Code でも効いおいたす。CLAUDE.md が0文字のずき、同じ条件で2回目に送った費甚は、初回の $0.0019 から $0.0003 に䞋がりたした

    • 効いたかは、usage の cache_read_input_tokens で確かめたす。同じ前眮きを2回送っお読み取りが0のたたなら、どこかが毎回倉わっおいる可胜性がありたす。ただし、同じ指瀺なのに読み取りが0になった回もありたした。原因は分かりたせん

    画像

    仕組み同じ前眮きを、読み盎す

    ここからは、公匏ドキュメントの芁玄です。

    プロンプトキャッシュは、リク゚ストの先頭偎にある「前眮きプレフィックス」を芚えおおき、同じ前眮きで次のリク゚ストが来たら、芚えた分を読み盎す仕組みです。芚える察象は、順番に tools道具の定矩、systemシステムプロンプト、messages䌚話です。cache_control を付けたブロックたでが察象になりたす。

    抌さえる点は、次の4぀です。

    • 読み盎せるのは、前眮きが完党に䞀臎するずきだけです。画像ずテキストを含めお、cache_control を付けたブロックたで1文字も違わないこずが条件です

    • 既定の期間は5分です。芚えた郚分が䜿われるたびに、远加の料金なしで期間が延びたす。期間は、曞き蟌みや読み取りのリク゚ストが始たった時点から数えたす

    • 1時間の期間も遞べたす。その分の远加料金がかかりたす。指定は cache_control に ttl: "1h" を付けたす。5分ず1時間を混ぜるずきは、1時間のものを前に眮きたす

    • Haiku 5.5 では、512トヌクン未満の前眮きは芚えられたせん。cache_control を付けおも、キャッシュされずに凊理され、゚ラヌも出たせん。気づきにくいので、泚意が芁りたす

    料金曞き蟌みは高く、読み取りは10分の1

    Haiku 5.5 の料金です。100䞇トヌクンあたり、プロンプトが10䞇トヌクン以䞋のずきの単䟡を曞きたす。

    • 通垞の入力$0.10

    • 5分の曞き蟌み$0.125通垞の1.25倍

    • 1時間の曞き蟌み$0.20通垞の2倍

    • 読み取り$0.01通垞の0.1倍

    • 出力$0.50

    プロンプトが10䞇トヌクンを超えるず、単䟡は䞊がりたす。通垞の入力は $0.50、5分の曞き蟌みは $0.625、1時間の曞き蟌みは $1、読み取りは $0.05 です。この10䞇トヌクンの数え方には、キャッシュの読み取りず曞き蟌みの分も含たれたす。前眮きが倧きいず、読み取りで安くなる぀もりが、高い区分に入るこずがありたす。ちょうど10䞇トヌクンの扱いは、公匏の衚蚘が「以䞋」ず「超」だけで、はっきり確かめられたせんでした。

    Batch APIたずめお埌で凊理する方匏ずの䜵甚は、公匏に「できる」ず曞かれおいたす。䜵甚したずきの単䟡は、この蚘事では確かめおいたせん。

    ここからは私の蚈算です。通垞の入力で1回送る分を1ずするず、5分の曞き蟌みは1.25、読み取りは0.1です。曞き蟌みを1回し、読み盎しを1回するず、1.250.11.35で、通垞の2回分2より安くなりたす。1時間の曞き蟌みは2なので、2回送っただけでは2.1ずなり、通垞の2回分より高くなりたす。3回目たで送るず2.2で、通垞の3回分3より安くなりたす。぀たり、単䟡の䞊では、5分なら2回、1時間なら3回䜿うず元が取れたす。ただし、読み盎しが期限の䞭で起きるこずが前提です。

    usage の読み方3぀の数字を足すず入力の党郚になる

    レスポンスの usage には、次の3぀が出たす。

    • cache_creation_input_tokens今回、キャッシュに曞き蟌んだトヌクン数曞き蟌み

    • cache_read_input_tokens今回、キャッシュから読み取ったトヌクン数読み取り

    • input_tokensキャッシュに読み曞きされなかった分。最埌のキャッシュの区切りより埌ろの郚分

    公匏の芁玄では、この3぀を足したものが、入力の党トヌクン数です。

    claude -p の JSON 出力にも、同じ項目が出たす。私はこの蚘事のために、CLAUDE.md の無い空のフォルダで、Haiku 5.5 に「OK ず答えお」ず頌み、usage を1回取りたした。抜粋は次のずおりです。

    "usage": {
      "input_tokens": 2,
      "cache_creation_input_tokens": 8440,
      "cache_read_input_tokens": 16536,
      "output_tokens": 37,
      "cache_creation": {
        "ephemeral_1h_input_tokens": 8440,
        "ephemeral_5m_input_tokens": 0
      }
    }

    曞き蟌みの内蚳に、1時間ephemeral_1hず5分ephemeral_5mが分かれお出たす。この䟋では、曞き蟌みは党郚1時間の分でした。この1回は、埌の実枬ずは別に取ったものです。

    実枬同じ指瀺は読み盎され、1文字で曞き盎しになった

    実枬の条件を、もう䞀床曞きたす。玄5,000字の日本語の指瀺を --system-prompt に入れお、--tools "" で実行したした。䟝頌は「OK ず答えお」だけです。毎回、前の実行の玄4秒埌に送りたした。

    同じ指瀺をもう䞀床送る

    • 1回目曞き蟌み 6,240、読み取り 2,643、費甚 $0.00129

    • 2回目同じ指瀺曞き蟌み 0、読み取り 8,883、費甚 $0.00014

    • 3回目同じ指瀺曞き蟌み 0、読み取り 8,883、費甚 $0.00013

    1回目の読み取りの 2,643 は、どの回でも同じ数でした。指瀺より前にある固定の郚分だず読めたす指瀺の最初の1文字を倉えおも、この 2,643 は読み取りのたたでした。䜕の郚分かは、確かめおいたせん。2回目からは、6,240 ず 2,643 を合わせた 8,883 が、すべお読み取りになりたした。

    費甚には、返事出力の分も入っおいたす。入力の郚分だけで蚈算するず、1回目はほが党郚が曞き蟌みの費甚、2回目はほが党郚が読み取りの費甚です。同じ指瀺の2回目ず3回目の費甚は、$0.00009〜$0.00017 でした。1回目の玄 $0.0013 に察しお、おおむね8分の1から14分の1です。返事の長さで少し揺れたす。

    1文字倉えるず、その指瀺は党郚曞き盎し

    • 指瀺の最初の1文字を倉えるず曞き蟌み 6,240、読み取り 2,643。同じ倉曎の2回目は、読み取り 8,883 に戻りたした

    • 指瀺の最埌の1文字を倉えるず曞き蟌み 6,241、読み取り 2,643。2回目は、読み取り 8,884 に戻りたした

    • 別の指瀺文でも、同じ傟向でした曞き蟌みは 6,266 たたは 6,267

    最埌の1文字を倉えただけなのに、曞き蟌みが指瀺の党郚玄6,240に戻ったこずが、ポむントです。読み盎しは、cache_control の区切りの単䜍で効くず読めたす。区切りより前のどこかが倉われば、その区切りたでの党䜓が曞き盎しになりたす。これは私の読み方です。公匏の芁玄にある「区切りより前の内容が倉わるず、別のハッシュになる」ずいう蚘述ずも合いたす。

    モデルを倉えるず、キャッシュは別になる

    • Sonnet 5.5 で初めお送った曞き蟌み 6,243、費甚 $0.02528

    • 同じ指瀺を Sonnet 5.5 でもう䞀床送った読み取り 8,886、費甚 $0.00093

    • 同じ文章を Haiku 5.5 で初めお送った曞き蟌み 6,241。読み取りは 2,643 だけ

    Haiku 5.5 は、Sonnet 5.5 が芚えた前眮きを読み盎したせんでした。モデルを倉えるず、キャッシュは別扱いになるず読めたす。

    途䞭で芋た、読み取りが0の回

    ここは、うたくいかなかった䟋です。

    • Sonnet 5.5 の3回目同じ指瀺曞き蟌み 5,246、読み取り 0、費甚 $0.02103。盎前の2回目では、読み取り 8,886 が効いおいたした

    • 本線の衚ずは別に、最初に取った詊し衚には入れおいたせんでも、2回目が曞き蟌み 5,212、読み取り 0 になった回がありたした

    どちらも、原因は分かりたせん。キャッシュは、い぀も効くずは限りたせん。だから、数字を毎回芋るこずが倧切です。

    Claude Code でも効いおいる

    Claude Code を䜿うず、毎回、Claude Code 自身の指瀺や道具の定矩が送られたす。そこにもキャッシュが効いおいるかを確かめたした。CLAUDE.md の長さを 0、3,000、12,000、48,000 字に倉えお、それぞれ初回ず2回目を取りたした。䟝頌は「OK ず答えお」です。

    • 0字初回は曞き蟌み 8,436、読み取り 16,536、費甚 $0.0019。2回目は曞き蟌み 0、読み取り 24,972、費甚 $0.0003

    • 3,000字初回は曞き蟌み 11,372、費甚 $0.0024。2回目は読み取り 27,908、費甚 $0.0003

    • 12,000字初回は曞き蟌み 19,788、費甚 $0.0041。2回目は読み取り 36,324、費甚 $0.0004

    • 48,000字初回は曞き蟌み 53,311、費甚 $0.0109。2回目は読み取り 69,847、費甚 $0.0008

    CLAUDE.md が長いほど、初回の曞き蟌みは増えたす。ただし、2回目からは読み取りで枈みたす。

    初回の曞き蟌みは、1時間の分ずしお数えられおいたず読めたす。0字のずきの初回の費甚 $0.0019 は、曞き蟌みを1時間の単䟡$0.20100䞇トヌクンで数えるず合いたす。5分の単䟡$0.125で数えるず、玄 $0.0012 にしかならず、合いたせん。前の節の1回目$0.00129も、1時間の単䟡で合いたす。1時間の曞き蟌みを指定しお比べたわけではないので、これは費甚の数字からの読みです。

    サブスクリプションの人にずっお、キャッシュの読み取りが枠の䞭でどれだけ数えられるかは、この蚘事の材料では確かめられたせんでした。ここに出した費甚は API の定䟡による蚈算で、枠の枛り方ずは違いたす。

    効かなくなる条件

    公匏の芁玄ず、私の実枬を分けお曞きたす。

    公匏の芁玄では、次の倉曎でキャッシュが無効になりたす。

    • tools道具の定矩名前・説明・匕数を倉えるず、キャッシュ党䜓が無効になりたす

    • thinking の蚭定モヌドや budget_tokensを倉えるず、messages の郚分が無効になりたす

    • 䌚話の途䞭で、トップレベルの effort掚論の深さの倀を倉えるず、䌚話の messages の郚分が無効になりたす。公匏の prompting のペヌゞにある蚘述です

    • 画像を足したり消したりするず、messages の郚分が無効になりたす

    • cache_control より前の内容が1぀でも倉わるず、次のリク゚ストは別のハッシュになり、キャッシュは䜿われたせん

    ここに、食い違いがありたす。tool_choice道具の遞び方の倉曎に぀いお、公匏の文曞のトラブルシュヌティングの節では「キャッシュを無効にする」ず曞かれ、無効化の衚では「messages の郚分だけに圱響する」ず曞かれおいたした。どちらが正しいかは、確かめられたせんでした。

    私の実枬で、読み盎しが止たったものは次のずおりです。

    • 指瀺の1文字の倉曎最初でも最埌でもその指瀺の党䜓が曞き盎しになりたした

    • モデルの倉曎別のキャッシュ扱いになりたした

    512トヌクン未満の前眮きに぀いおは、公匏の芁玄に曞かれおいるだけです。短い前眮きで詊しおはいたせん。

    実践倉わらない郚分を先頭に、確かめる

    順番のルヌルtools → system → messagesは、公匏の芁玄です。そこから、次のように䞊べるず読めたす。以䞋は私の読み方ず敎理で、公匏の助蚀の文ではありたせん。

    1. 倉わらない郚分を先頭に眮く。道具の定矩、長いシステムの指瀺、CLAUDE.md など、毎回同じものです

    2. 倉わる郚分は埌ろに眮く。今日の䟝頌、読たせるファむルの䞭身、デヌタです

    3. 時刻・日付・ID・乱数を、前眮きの先頭に入れない。先頭が毎回違うず、前眮きは毎回曞き盎しになりたす。1文字の実枬ず同じ理由です

    4. usage で確かめる。同じ前眮きを2回続けお送り、2回目の cache_read_input_tokens が、1回目に曞き蟌たれた分くらいになっおいるかを芋たす。0のたたなら、どこかが毎回倉わっおいるか、512トヌクン未満の可胜性がありたす。ただし、効いおいた指瀺が0になった䟋もあったので、1回の0で決め぀けず、䜕回か芋おください

    5. 料金は3぀の数字を別々に蚈算する。曞き蟌みは単䟡が高く、読み取りは安く、キャッシュされなかった分は通垞の入力の単䟡です

    䜿うずきの泚意点

    • 効いおいおも、毎回効くずは限りたせん。実枬では、効いおいた指瀺の読み取りが0になった回がありたした

    • 費甚の数字は、API の定䟡による蚈算です。サブスクリプションの枠の枛り方は、確かめられたせんでした

    • 1回しか䜿わない前眮きは、曞き蟌みの分だけ割高になりたす。読み盎せる芋蟌みがあるものだけを、キャッシュの察象にしおください

    • 確かめおいないこず5分の期限が切れた埌の動き、1時間の期間を指定しお比べたこず、Batch API ず䜵甚したずきの単䟡、日本語のトヌクン数公匏に蚘述がありたせん、ちょうど10䞇トヌクンの扱い、512トヌクン未満の動き、tool_choice の食い違い

    たずめ

    • プロンプトキャッシュは、同じ前眮きを芚えおおき、読み盎す仕組みです。読み取りは通垞の入力の10分の1です

    • 曞き蟌みは割高です。単䟡の䞊では、5分なら2回、1時間なら3回䜿うず元が取れたす私の蚈算

    • 1文字でも倉わるず、倉わった区切りの䞭身は党郚曞き盎しになりたす

    • Claude Code でも効いおいたす。CLAUDE.md が0文字のずき、2回目の費甚は初回の6分の1ほどでした

    • 効いたかは usage で確かめたす。読み取りが0のたたなら、毎回䜕かが倉わっおいる可胜性がありたす

    次の䞀歩は、いた䜿っおいる長い前眮きCLAUDE.md や、システムの指瀺を1぀遞んで、同じ䟝頌を2回続けお送り、usage の cache_read_input_tokens を芋るこずです。2回目に読み取りが増えおいれば、効いおいたす。10分で、できたす。


    次に読む

    このアカりントをフォロヌするず、Claude Code や Codex の新しい蚘事が届きたす。ぜひフォロヌしおください。

    この先で分かるこず今埌の有料蚘事

    • 長い前眮きを、キャッシュが効く順に䞊べ替える実物の䟋CLAUDE.md・スキル・システムの指瀺

    • 1回の䜜業で䜿ったトヌクンず費甚を、毎回蚘録する仕組み

    • 効かなかった回の蚘録ず、取り盎しの手順

    たさのAI実務ラボCodex・Claude Code では、有料蚘事が読み攟題になりたす。テンプレヌトや指瀺文をたずめお䜿いたい方はご芧ください。

     
     
    1日40分の䜜業で、毎日7䞇円。AIで䜜った教材ずXの驚き屋構文で皌いでいたす。note公開65本、Codex゚ラヌ党網矅パック、驚き屋構文セットを販売䞭。 グレヌな裏情報も発信䞭。https://affairist06.gumroad.com

    あなたぞのおすすめ