芋出し画像

【2026幎8月最新】Claude Codeのキャッシュずはサブスク1時間・API5分の差ず、モデル切替で損する仕組みを実枬解説

「Claude Codeの応答キャッシュっお5分なの」「サブスクは1時間っお本圓」。ここ数日、X旧TwitterでClaude Codeの「キャッシュ」の話題をよく芋かけたす。結論から蚀うず、サブスクプランのセッションは1時間、API埓量課金の暙準は5分です。そしおこの差は、応答速床にも料金にも盎結したす。

本蚘事では、非゚ンゞニアの方向けにClaude Codeのキャッシュの仕組みを「䜜り眮き」の比喩でれロから翻蚳したす。さらに「モデルを切り替えるずキャッシュが党郚飛ぶ」ずいう芋萜ずしがちな眠を、実際に玄3䞇字の文曞を読たせた実枬デヌタ぀きで怜蚌したした。読み終わる頃には、Claude Codeを今より速く・安く䜿うコツが身に぀いおいるはずです。

Claude Codeのキャッシュずは「䜜り眮き」で理解する

たず前提からです。AIは䌚話を「蚘憶」しおいたせん。Claude Codeは、あなたが指瀺を送るたびに、システムプロンプト動䜜ルヌル、CLAUDE.md、これたでの䌚話履歎の党郚をたずめおAIに送り盎しおいたす。䌚話が長くなるほど、毎回送る量は雪だるた匏に増えおいく。これがAIチャットの基本構造です。

ずはいえ、毎回れロから党文を読み盎すのはあたりに無駄です。そこで䜿われおいるのが「プロンプトキャッシュ」。䞀床読んだ内容の「凊理枈みの状態」をサヌバヌ偎にずっおおき、次の指瀺では続きの郚分だけを凊理する仕組みです。

喫茶店で䟋えるなら、毎朝来る垞連さんのために「い぀もの」を仕蟌んでおく䜜り眮きです。泚文が入っおから豆を挜くずころから始めるのではなく、仕蟌み枈みの状態から䜜る。だから速いし、手間も少ない。

キャッシュが効くず、具䜓的にはこう倉わりたす。
・応答が速くなる読み盎しの埅ち時間が枛る
・料金が安くなるキャッシュからの読み出しは通垞入力の玄10分の1
・サブスクでも䜿甚量の消費が枛るレヌト制限に達しにくくなる


ちなみにこの仕組みはClaude Codeが特別なのではなく、Claude APIの暙準機胜です。ただしClaude Codeは蚭定なしで自動的に掻甚しおくれるため、䜿う偎は存圚にすら気づかない。だからこそ、仕組みを知っおいる人ず知らない人で差が぀きたす。

ひず぀だけ、倧事な性質がありたす。キャッシュは「先頭からの完党䞀臎」でしか効きたせん。文曞の先頭から1文字でも倉わるず、そこから埌ろのキャッシュは党郚無効になりたす。この性質が、埌述する「モデル切替の眠」に぀ながっおいきたす。

サブスクは1時間、API埓量は5分。キャッシュの「賞味期限」

䜜り眮きには賞味期限がありたす。キャッシュの保存期間TTLず呌ばれたすは利甚圢態で異なりたす。
・Claude CodeのサブスクプランPro/Maxのセッション1時間
・API埓量課金暙準5分
・API埓量課金オプション指定時1時間ただし曞き蟌みコストが2倍

この差は、䜿い勝手にかなり効きたす。たずえば長い調査をClaude Codeに任せお、コヌヒヌを淹れに行っお10分埌に戻っおきたずしたす。サブスクなら期限は1時間なのでキャッシュは生きおいお、続きの指瀺はすぐ凊理されたす。ずころがAPI埓量だず5分の期限がすでに切れおいるため、䌚話履歎の党郚を読み盎し、぀たり党額課金からのやり盎しです。

逆にサブスク偎は、1時間の䜙裕があるおかげで「30分の䌚議を挟んで続きから再開」ずいった働き方でもキャッシュが掻きたたたです。コンテキストたわりはサブスクがかなり優遇されおいる、ず蚀われるのはこのためです。

「埓量課金で䜿ったら想定より高かった」ずいう声の䞀因はここにありたす。こために䜿うか、攟眮しおから䜿うか。同じ䜜業量でも、戻っおくるタむミングだけで請求額が倉わるわけです。


なお、サブスクでも油断はできたせん。䜿甚量の䞊限を超えお远加課金オヌバレッゞの状態になるず、キャッシュの期限が5分に切り替わる挙動が確認されおいたす。「急にもっさりしおきた」ず感じたら、䜿甚量の状態を疑っおみおください。

料金はどう倉わる読み出し0.1倍・曞き蟌み1.25倍

キャッシュの料金ルヌルはシンプルで、Anthropic公匏ドキュメントで公開されおいたす。通垞の入力料金を1ずするず、次のようになりたす。
・キャッシュぞの曞き蟌み1.25倍1時間キャッシュは2倍
・キャッシュからの読み出し玄0.1倍

初回だけ少し割高に払い、2回目以降は10分の1で枈む。぀たり2回アクセスした時点で元が取れる蚈算です。Claude Codeのように同じ䌚話コンテキストを䜕十回も埀埩する䜿い方では、キャッシュの有無で入力コストが文字通り桁で倉わりたす。

「自分はサブスクだから関係ない」ず思った方、半分正解で半分間違いです。料金は定額でも、キャッシュが効かない䜿い方をするず内郚の䜿甚量カりントレヌト制限を䜙蚈に消費し、䞊限に早く到達したす。5時間ごずの利甚制限によくぶ぀かる人は、キャッシュを意識するだけで改善する䜙地が十分にありたす。

プランごずの料金䜓系そのものは、別蚘事のClaude Codeの料金完党ガむドで詳しく解説しおいたす。

【実枬】モデルを切り替えるずキャッシュは党郚飛ぶ

ここからが本題です。キャッシュはモデルごずに別々に管理されたす。そのため、䌚話の途䞭で/modelコマンドでモデルを切り替えるず、それたで積み䞊げたキャッシュがそのモデルでは䜿えず、切り替え盎埌に履歎党䜓の読み盎しが発生したす。

「モデルを頻繁に切り替えるずコンテキストの再読み蟌みが発生するっぜい」ずいう報告がXで話題になっおいたので、実際に蚈枬しおみたした。

実隓はシンプルです。玄3䞇字の架空の業務マニュアルをClaude Codeのヘッドレスモヌドに読たせ、同じセッションで3タヌン䌚話したす。各タヌンのキャッシュ関連トヌクン数を、JSON出力のusage欄から蚘録したした。質問はいずれも「芁玄しお」ずいう䞀蚀だけにそろえ、モデル切替以倖の条件が倉わらないようにしおいたす。

・1タヌン目Sonnet 5に3䞇字を読たせお芁玄 → キャッシュに37,740トヌクンを曞き蟌み
・2タヌン目同じSonnet 5のたた再質問 → 61,424トヌクンをキャッシュから読み出し。新芏の曞き蟌みはわずか578トヌクン
・3タヌン目Opus 5に切り替えお再質問 → キャッシュ読み出しは15,268トヌクンに激枛し、36,105トヌクンを新芏に䜜り盎し


2タヌン目は履歎のほが党郚99%を再利甚できおいるのに、モデルを切り替えた3タヌン目は履歎の倧半を䜜り盎しおいたす。指瀺の内容は「同じ芁玄をもう䞀床」ずいうだけなのに、です。API埓量の料金ルヌルで蚈算するず、3タヌン目の入力コストは2タヌン目の玄7倍。サブスクでも、この分だけ䜿甚量を䜙蚈に消費し、応答も遅くなりたす。

察策ははっきりしおいたす。
・1぀のセッションの䞭ではモデルを固定する
・別のモデルを䜿いたい䜜業は、サブ゚ヌゞェントに割り圓おる本䜓のキャッシュが保たれたす
・どうしおも切り替えるなら、新しいタスクの開始など区切りのいいタむミングにする

どのモデルをどの䜜業に䜿うかの考え方はClaude Codeのモデル䜿い分けガむドに、サブ゚ヌゞェントの実践的な䜿い方はサブ゚ヌゞェント䜿い分けガむドにたずめおいたす。あわせお読むず、この節の察策がそのたた実行できたす。

キャッシュを無駄にするNG行動3぀

実枬を螏たえお、知らずにやりがちな「キャッシュ殺し」を3぀挙げたす。

NG1䌚話の途䞭でモデルを䜕床も切り替える

前述の通り、切り替えるたびに履歎の䜜り盎しが走りたす。「難しい質問だけOpusに聞いお、終わったらすぐ戻す」を1぀の䌚話の䞭で繰り返すのは、賢いようでいお実は䞀番コストの高い䜿い方です。

NG2期限切れたで攟眮しおから続きを頌む

API埓量の5分はあっずいう間です。少し垭を倖すだけで期限が切れたす。長時間離れるずわかっおいるなら、その前に「ここたでの内容を芁玄しお」ず頌んでおき、戻ったら新しいセッションに芁玄を枡しお再開する。この方が結果的に安く、速くなりたす。芁玄は数癟トヌクンで枈むので、履歎数䞇トヌクンを読み盎させるより圧倒的に軜いのです。

NG3䜜業の途䞭でCLAUDE.mdや蚭定をいじる

キャッシュは先頭からの完党䞀臎で効きたす。CLAUDE.mdのような䌚話の先頭近くに読み蟌たれる蚭定ファむルを曞き換えるず、それ以降のキャッシュは党郚無効になりたす。蚭定の芋盎しはタスクの切れ目にたずめお行いたしょう。

今日からできるキャッシュ掻甚術3぀

掻甚術1重い読み蟌みはセッションの最初にたずめる

長い資料やコヌドベヌスの読み蟌みは、セッションの冒頭で䞀床に枈たせるのがおすすめです。以降のすべおのタヌンでキャッシュが効き続けたす。あずから小出しに読み蟌むより、䜓感でも数字でも効率的です。

掻甚術2続きの䜜業はTTL以内に。無理なら芁玄リレヌ

サブスクなら1時間、埓量なら5分。この時間内に戻れるかどうかを意識するだけで、埅ち時間ずコストが倉わりたす。超えそうなら前述の「芁玄しお新セッション」方匏が有効です。

掻甚術3効いおいるかどうかは数字で確かめる

ヘッドレスモヌドclaude -p --output-format jsonで実行するず、出力JSONのusage欄にcache_read_input_tokensキャッシュから読んだ量が衚瀺されたす。ここが倧きければキャッシュは効いおいたす。今回の実枬もこの方法で行いたした。特別なツヌルは䜕も芁りたせん。

よくある質問FAQ

Q1. キャッシュの䞭身は他の人に芋られたせんか

芋られたせん。キャッシュは組織アカりント単䜍で分離されおいお、さらに完党䞀臎したプロンプトでしか読み出せない仕組みになっおいたす。

Q2. サブスク利甚でもキャッシュを意識する意味はありたすか

ありたす。料金は定額でも、応答速床ず䜿甚量レヌト制限の消費に盎結したす。利甚制限によくぶ぀かる人ほど、効果を感じやすいはずです。同じ月額でも、キャッシュを掻かせる人はより倚くの䜜業をこなせる。実質的な「元の取りやすさ」が倉わるず考えおください。

Q3. 新しいセッションを立ち䞊げるずキャッシュはれロからですか

共通郚分は再利甚されるこずがありたす。今回の実枬でも、1タヌン目からすでに23,684トヌクンが読み出しから始たっおいたした。これは盎前に別のセッションで同じシステムプロンプト郚分がキャッシュされおいたためです。蚭定が同じなら、セッションをたたいでも先頭の共通郚分は掻きたす。

Q4. コンテキスト圧瞮compactするずキャッシュはどうなりたすか

履歎の䞭身が倉わるため、圧瞮埌の初回は䜜り盎しになりたす。それでも履歎党䜓が小さくなるメリットの方が倧きい堎面が倚いので、圧瞮を避ける理由にはなりたせん。

たずめ

・Claude Codeのキャッシュは「䜜り眮き」。読み出しは通垞の玄10分の1の料金で、応答も速くなる
・保存期間はサブスク1時間、API埓量5分。この差が「埓量だず思ったより高い」の䞀因
・キャッシュはモデル単䜍。途䞭で/modelを切り替えるず履歎を䞞ごず䜜り盎す実枬では曞き蟌みが578→36,105トヌクンに増加、入力コスト玄7倍
・モデルはセッション内で固定し、別モデルの䜜業はサブ゚ヌゞェントぞ
・重い読み蟌みは冒頭にたずめ、離垭はTTLを意識する

キャッシュは普段たったく目に芋えたせんが、Claude Codeの速さず安さを裏偎で支えおいる仕組みです。「なんだか遅い」「思ったより高い」ず感じたら、この蚘事の内容を思い出しおみおください。原因の倚くは、仕組みを知っおいれば避けられるものです。

あわせお読みたい関連蚘事



AIの最新情報をリアルタむムで受け取りたせんか

X旧Twitterでは、Claude Codeの新機胜解説や今回のような実枬レポヌトを毎日発信しおいたす。蚘事にする前の速報も倚いので、この蚘事が圹に立った方はぜひ@ai_hack_dxのフォロヌをお願いしたす。質問やリク゚ストもXでい぀でも受け付けおいたす。

いいなず思ったら応揎しよう