Opus 5.5のタスクコストを試算する方法 — ターン数と読み取りで分解

Opus 5.5のタスクコストを決める4要素

Claude Codeのタスクは、モデルが会話を読み、ツールを呼び、結果を読んでまたループする一連の処理です。ループを1周するたびに1回のリクエストが発生し、その積み重ねがタスクの単価になります。

Anthropicのブログ記事「What a task costs on Opus 5.5」は、この単価を4つの要素に分解しています。ターン数・キャッシュ読み取り・出力トークンの種類・モデル選択です。トークン単価が同じ2つのモデルでも、片方が1回でファイルを読み切り、もう片方が読み直しと修正を繰り返せば、後者のほうが高くつきます。ターンが増えるたびに、それまでの会話全体が再送されるためです。

試算の土台になるのは、Opus 5.5のAPIリスト価格です。

ターン数はコストにどう効くか

20,000トークンの文脈から始まり、ファイルやツール結果を読み込むうちに120,000トークンまで増えるタスクで考えます。ターンごとの平均送信量は、40ターンなら約7万トークンです。

• 40ターンで完了した場合: 1タスクあたり約280万トークンの入力が発生し、キャッシュ読み取り率90%なら入力コストは約1.62ドル
• 25ターンで完了した場合: 入力は約175万トークンに収まり、コストは約1.02ドル

会話の最大サイズは120,000トークンで変わらないのに、ターン数が減るだけで入力コストは4割近く下がります。1ターンはそのターンで追加した分だけでなく、それ以前の会話全体を再送するコストを背負うため、減らせるターンが最も安いターンになります。

ターンを減らす具体策として、モデルが自分の作業を確認できる手段(テスト・ビルド・エンドポイント呼び出し)を用意することが挙げられています。確認手段があると、モデルは自分の誤りをその場で見つけやすくなります。ツール呼び出しをまとめてバッチ実行するモデルも、再送の回数が減る分だけ安くなります。

長いセッションは1ターンあたりも高くなる

キャッシュが温まっていても、文脈が育てば1ターンの読み取り費用は上がります。Opus 5.5では、文脈20,000トークンの読み取りが約0.004ドル、150,000トークンなら約0.03ドルです。

150,000トークンの状態で30ターン続けると、読み取りだけで0.90ドルかかります。20,000トークンのまま30ターンなら約0.12ドルです。古いスタックトレースや終わったファイルの中身も、毎ターン再送され続けます。

キャッシュ読み取り率が変える金額

同じ280万トークンの入力でも、キャッシュ読み取り率によって金額は大きく変わります。

キャッシュ読み取りは入力価格の20分の1で課金されるため、他のどの設定よりも入力コストへの影響が大きい項目です。キャッシュの仕組みそのものは自動プロンプトキャッシュが多ターン会話でどう動くかで扱っています。

キャッシュが切れたときの書き込み価格

キャッシュが切れると、読み取りではなく書き込み価格で会話全体を払い直します。書き込みは入力価格の1.25倍(5分キャッシュ)か2倍(1時間キャッシュ)です。

Claude Codeでのキャッシュの寿命は、支払い方で変わります。

• Claudeサブスクリプション: 1時間
• APIキー・クラウドプロバイダー: 既定で5分
• サブスクリプションが利用クレジットを消費している間: 5分

ヒットするたびに寿命は延びます。120,000トークンの文脈では、5分キャッシュの書き込みが約0.60ドル、読み取りが約0.02ドルです。APIキーで6分の休憩を挟むと、次のターンが0.02ドルから0.60ドルに跳ね上がります。同じ大きさの1時間キャッシュの書き込みは約0.96ドルで、APIでは日中の中断をカバーするために、その割増を払う選択肢があります。

次の操作は、安定していたセッションのキャッシュを崩します。

• キャッシュの寿命を超えて手を止める
• Amazon Bedrock・Google CloudのAgent Platform・Claude appsゲートウェイでエフォートを変える
• ファストモードを会話の途中で初めてオンにする
• MCPサーバーを接続・切断する
• モデルを切り替える
• 会話を圧縮して履歴を書き換える

エフォートの変更は、APIキーで使う場合も、Claudeサブスクリプションで使う場合も、キャッシュを保ちます。難しい1ステップだけ上げて、すぐ戻す使い方ができます。

出力トークンとエフォートの関係

Opus 5.5では、出力トークン1個がキャッシュ読み取り100個分の価格に相当します。典型的なタスクの出力6万トークンは1.20ドルで、これはキャッシュから600万トークンを読むのと同じ金額です。

出力にはthinking(モデルの思考過程)も含まれ、画面に要約しか表示されなくても課金対象になります。エフォートは主にこの思考量を左右するため、上げるとタスクの単価が大きく動きます。

Claude Code v2.1.289で claude --help を開くと、--effort の指定値が確認できます。

claude --version
claude --help

2.1.289 (Claude Code)
  --effort <level>    Effort level for the current session
                      (low, medium, high, xhigh, max)

セッション中は /effort high のように変え、/effort status で現在値を見ます。ブログ記事は、maxを1セッション限りのレベルとして扱っています。

Opus 5.5の既定はmediumで、Opus 5の既定だったhighより1段階低い設定です。同じレベル名でも思考量はモデルごとに異なり、Opus 5.5はxhighとmaxで特にOpus 5より多く思考します。Opus 5用に選んでいたレベルをそのまま引き継がないほうが安全です。

エフォートの費用対効果を測る目安になる試算もあります。highでタスク全体に20,000トークンの思考が追加されると仮定すると、Opus 5.5では0.40ドルです。これは、10ターンのリトライループ(キャッシュ済み文脈10万トークン・出力合計1万トークン)とほぼ同額です。

つまりhighは、リトライを1回防げれば元が取れる計算になります。逆に、mediumで1回で終わるタスクにhighを使うと、その分は無駄なコストです。効率化の別の切り口は入力サイズ不明でも最大出力を引き出す実装パターンでも扱っています。

mediumでは足りないときの見分け方

エフォート不足の典型は、修正が1つの層で止まる場合です。たとえばAPIハンドラーのフィールド名を変えるとき、mediumはハンドラーとそのテストを直して終わり、クライアントが旧名のまま送り続けることがあります。頼まれたことはやっていますが、2つ目の呼び出し元までは読んでいません。

highなら書く前に呼び出し箇所を多く読み、両方の層を1回で直します。別の手もあります。クライアント経由のテストをモデルが走らせられるなら、mediumでも旧名の失敗がその場で出ます。エフォートを上げる前に確認手段の有無を見てください。テスト実行が増やすのは1ターンと出力で、エフォートの引き上げは全ターンの思考に効きます。

Opus 5からの価格変化と31%という数字

Opus 5.5では入力・出力トークンがOpus 5より20%安く、キャッシュ読み取りは60%安くなりました。キャッシュ読み取り価格は入力価格の10分の1(Opus 5)から20分の1(Opus 5.5)に下がっています。

同一トークン数で比べると、価格差だけでどれだけ変わるかが分かります。キャッシュ読み取り200万・新規入力20万・出力6万トークンのセッションです。

キャッシュ読み取りの行が$1.00から$0.40へ下がる幅が、このセッションでは最大です。長いエージェント作業ほど入力の大半がキャッシュ読み取りになるため、APIキーで使うClaude Codeには値下げの効きが大きい構造です。キャッシュ中心の作業なら入力で最大60%、キャッシュなしで長い回答が主役の短い質問なら最大20%の削減に収まります。

この31%はトークン単価の変化だけを見た数字で、Opus 5.5が同じタスクをより少ないトークンでこなせるかどうかは含んでいません。「40%安い」という広報上の数値は、既定エフォートでの典型的な作業量まで含めた見積もりであり、トークン単価そのものの下落率とは別物です。この2つの数字の違いは「40%安い」の実際の節約幅を検証するで扱っています。

サブスクリプションでは見え方が違います。Pro・Max・Teamでは、値下げが使用量の上限に反映され、Opus 5より約25%長く使えます。キャッシュ読み取りの追加の値下げはAPI価格だけの変更です。

自分のタスクで試算する手順

測定は、同じタスクを2つのモデルで動かして比べる形で進めます。

/usage のドル表示は、手元のマシンでトークン数からリスト価格で計算した推定値です。サブスクリプションでは請求額ではなく、作業量の目安として読みます。組織が契約単価を modelPricing で設定している場合は、その単価で表示されます。

画面を読むときは、次の3点を確認します。

• キャッシュの比率: 長いセッションなのに低いなら、長い中断・モデル切り替え・途中でのMCP接続を疑います。Prompt cache (main) の行には、直近のミスの推定原因が出ることがあります(v2.1.260以降)
• 入力に対する出力: 小さな変更に出力が多いなら、エフォートが高すぎるか、リトライが起きています
• 会話サイズに対する入力合計: 何倍にもなっているなら、ループが繰り返された可能性が高く、会話を読み返して原因を探る価値があります

チームで見るなら、Claude Code Analytics APIがユーザーごとの推定コストを、Usage and Cost APIがモデル別・キャッシュ別の内訳を返します。

/usageの数字を式に入れて単価を出す

ここまでの試算例は一次ソースの想定値です。自分のタスクの単価を出すには、/usage で確認した3つの数値をそのまま次の式に入れます。

• 入力コスト(ドル)= (キャッシュ読み取りトークン数 × 0.20 + 非キャッシュ入力トークン数 × 4) ÷ 1,000,000
• 出力コスト(ドル)= 出力トークン数(thinking含む)× 20 ÷ 1,000,000
• タスク単価 = 入力コスト + 出力コスト

たとえば、キャッシュ読み取り252万・非キャッシュ入力28万・出力6万トークンなら、入力が0.504ドルと1.12ドルで約1.62ドル、出力が1.20ドルで、合計は約2.82ドルです。入力の内訳はターン数の節の90%の例と同じです。

/usage のSessionブロックの値は、次の表に書き写すだけで埋まります。

どこを動かすと何ドル変わるかは、前段の試算例だけで比較できます。

3つの操作のうち、ターン数を減らすかキャッシュ読み取り率を上げるかは、この例ではエフォートを上げる場合よりも値幅が大きくなります。エフォートを上げるかどうかは、この0.40ドルとリトライ1回分のコストを比べて決めるのが目安です。

リトライと大きな構成変更のコスト

エフォートを上げても解決しない場合の次の一手はモデルの切り替えです。Opus 5.5がxhighで同じ問題に2回つまずいたら、Fable 5.1に切り替え、解決したら戻す運用が示されています。

Fable 5.1のリスト価格は入力100万トークンあたり10ドル、出力50ドルで、Opus 5.5の2.5倍です。キャッシュ読み取りは0.25ドルで、Opus 5.5の1.25倍にとどまります。差が最も小さいのは長くてキャッシュ中心の作業、最も大きいのは書く量の多い作業です。

キャッシュはモデルごとに独立しているため、切り替えた最初のターンは会話全体をキャッシュ書き込み価格で払い直します。/compact で圧縮してから切り替えるか、短い計画メモから新しいセッションを始めると、この初回コストを抑えられます。

圧縮はいつ元が取れるか

150,000トークンでの /compact は、読み取りと数千トークンの要約出力、短くなった文脈の書き込みで約0.25ドルかかります。以後のターンが約0.025ドルずつ安くなるため、約10ターンで元が取れます。終わる直前の圧縮は、節約より費用のほうが大きくなります。

この金額はキャッシュが温かい前提です。休憩のあとで圧縮すると会話全体を読み直して書き戻すため、5分キャッシュで入力だけ約0.75ドルになります。圧縮は休憩の前に済ませます。方向を変えたいだけなら、/rewind で温かいキャッシュの接頭辞に戻る手もあります。

サブエージェントの価格

調べ物やログの読み取りは、サブエージェントをSonnetやHaikuに寄せられます。定義に model: haiku や model: sonnet を書くと、そのサブエージェントだけが小さいモデルで動きます。全員を1つのモデルにするなら、環境変数 CLAUDE_CODE_SUBAGENT_MODEL を使います。定義に書いたモデルは、この変数より優先されます。

サブエージェントはそれぞれ独自のコンテキストウィンドウを持ち、要約だけを親に返しますが、自分の分のトークンは自分で支払います。小さいモデルが検索結果を読み違えると、親モデルが見当違いのファイルを追うことになります。ミスに気づきやすい仕事に限るのが、ブログ記事の指針です。

実験的機能のAgent Teamsは、チームメイトがplanモードで動く場合、標準セッションのおよそ7倍のトークンを消費するとコストに関するドキュメントに記載されています。コスト管理の設定例はAgent Teamsのコスト管理にまとめています。

モデル移行そのものの手順はClaudeモデルの移行ガイド、料金体系全体の比較はClaude APIとサブスクの料金比較で扱っています。モデル横断の解決1件あたりコストはClaudeのモデル選びはタスク単価で比べるで比べています。

プロンプトの棚卸しでコストが下がった実測例

Opus 4.8からOpus 5.5への移行を、社内のカスタマーサポート用ベンチマーク(44件のチケット)で検証した結果もあります。プロンプトには古いモデル向けの儀式的な指示(必須の6ステップ手順・スクラッチパッド指定・二重検証の指示など、互いに矛盾する指示も含む)が複数残っていました。

Opus 5.5への移行を低エフォートで行っただけで、ベンチマークのコストは約18%下がりました。さらに /claude-api prompt-audit コマンドでこうした指示を取り除いたところ、コストはさらに9%下がり、Opus 4.8の基準から見て合計で約25%の削減になりました。ただしこれは1つのベンチマークの結果であり、期待値ではなく一例として捉えるべき数字です。

このコマンドはClaude Codeのスキルや CLAUDE.md も検査します。CLAUDE.md は毎セッションの冒頭で読み込まれて全ターンに再送されるため、コストに関するドキュメントは200行未満を目安にしています。MCPのツール定義は遅延読み込みで、冒頭に載るのはツール名とサーバーの指示だけです。使っていないサーバーは /mcp で確認して切ります。

そのほかの課金ルールと日常の目安

試算に直接は出てこないものの、日々の判断に効く課金ルールもあります。ファストモードはOpus 5.5を最大2.5倍速く動かす代わりに、入力・出力ともに標準の2倍(100万トークンあたり入力8ドル・出力40ドル)を課金します。Claudeのサブスクリプションではプランの上限ではなく利用クレジットに計上されます。

オンにした直後の1リクエストは、会話全体を未キャッシュの価格で払い直します。深い位置で切り替えるより、セッションの開始時にオンにするほうが安く済みます。

Message Batches APIを使うと入力・出力とも半額になり、即時応答が不要なバッチ処理に向きます。日常の支出感覚としては、エンタープライズ導入全体での平均が開発者1人・1稼働日あたり約13ドル、月では150〜250ドルです。利用者の90%は1稼働日あたり30ドル未満に収まります。自分のセッションがこの水準から大きく外れているなら、/usage を見直す良いきっかけになります。

まとめ

Opus 5.5のタスク単価は、ターン数・キャッシュ読み取り率・出力トークン量・モデル選択の4つで決まります。価格改定だけを見て月間コストを見積もると外れるため、/usage の記録を実タスクで両モデル分並べたうえで、エフォートやモデルの切り替えはリトライ1回分のコストと比べて選びます。