メインコンテンツへスキップ
見出し画像

Claude Haiku 5.5が登場。Haiku 4.5との違い、料金、移行で直すところまとめ

    2026年10月7日、Anthropicの小型・高速モデル「Claude Haiku 5.5」(モデルID: claude-haiku-5-5)がリリースされました。分類、ルーティング、抽出、サブエージェントのような、件数が多く応答速度が重視される処理向けのモデルです。

    Haiku 5.5は単なる世代更新ではなく、Haiku 4.5のコードをモデル名だけ差し替えると400エラーになる変更をいくつか含んでいます。この記事では、Claudeの公式ドキュメント(モデル概要、What's new、移行ガイド、料金ページ)をもとに、Haiku 4.5との違い、料金の考え方、移行時に直す箇所を整理します。内容は2026年10月11日時点のものです。

    この記事が関係する人・関係しない人

    関係する人

    • Claude API、Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft FoundryでClaude Haiku 4.5を呼んでいる人

    • 分類、ルーティング、抽出、サブエージェントなど、件数が多く応答速度が重視される処理にClaudeを使っている人

    • Haiku 4.5向けのコードで、budget_tokens、temperature / top_p / top_k、assistantのプリフィル、computer_20250124 を使っている人(Haiku 5.5ではそのまま400エラーになり得ます)

    • Haiku 4.5でPriority Tierの契約がある組織(Haiku 5.5はPriority Tier非対応)

    • Claude Haiku 3.5 / Haiku 3から移る人(この記事の項目に加えて、移行ガイドにある追加の項目も必要です)

    関係しない人

    • Haikuのモデルを使っておらず、乗り換える予定もない人

    • Claude Managed Agentsだけを使っている人(移行ガイドでは、モデル名の変更以外の対応は不要とされています)

    自分が当てはまるかの確認方法

    • コードや設定で指定しているモデルIDを見る。移行ガイドの表では、Haiku 4.5のIDは次のとおりです: Claude APIは claude-haiku-4-5-20251001 または claude-haiku-4-5、Amazon Bedrockは anthropic.claude-haiku-4-5、Claude Platform on AWSとMicrosoft Foundryは claude-haiku-4-5、Google Cloudは claude-haiku-4-5@20251001

    • リクエストに thinking: {"type": "enabled", "budget_tokens": N}、temperature / top_p / top_k、最後がassistantのターンになっている messages が含まれていないかを見る(移行ガイドのチェックリストの項目)

    • レスポンスの最初のcontentブロックを答えとして読んでいないかを見る

    Claude Haiku 5.5の概要

    • モデルID: Claude API、Claude Platform on AWS、Google Cloud、Microsoft Foundryでは claude-haiku-5-5、Amazon Bedrockでは anthropic.claude-haiku-5-5。日付付きのIDや別名(エイリアス)はなく、この1つに固定されています

    • コンテキストウィンドウ: 100万(1M)トークン。Haiku 4.5は20万トークンでした

    • 最大出力: 12.8万(128k)トークン。Haiku 4.5は6.4万トークン。Message Batches APIでは output-300k-2026-03-24 ベータヘッダーで最大30万トークン

    • 思考: adaptive thinking(モデルが思考の要否と量を決める方式)。デフォルトで有効

    • effort: low / medium / high / xhigh / max の5段階に対応し、デフォルトは medium

    • 入出力: テキストと画像を入力し、テキストを出力

    • 知識のカットオフ: 2026年6月

    Claude API、Google Cloudでは、Webページ内の操作を行うbrowser useツール(browser_toolset_20260801)にも対応しました。Haiku 4.5では使えなかったツールです。

    画像

    料金:単価は下がったが、10万トークンを境に2段階

    料金ページによると、Haiku 5.5の単価は次のとおりです(100万トークンあたり、米ドル)。

    • プロンプトが10万トークン以下: 入力 $0.10、出力 $0.50、キャッシュ書き込み(5分)$0.125、(1時間)$0.20、キャッシュ読み取り $0.01

    • プロンプトが10万トークン超: 入力 $0.50、出力 $2.50、キャッシュ書き込み(5分)$0.625、(1時間)$1、キャッシュ読み取り $0.05

    • 参考: Haiku 4.5: 入力 $1、出力 $5、キャッシュ書き込み(5分)$1.25、(1時間)$2、キャッシュ読み取り $0.10

    Claude Haiku 5.5 is priced by prompt length: a request whose prompt is over 100,000 tokens pays higher prices.

    訳: Claude Haiku 5.5の料金はプロンプトの長さで決まり、プロンプトが10万トークンを超えるリクエストは高い方の単価になります。(Pricing)

    注意したいのは次の3点です。

    • 10万トークンの判定はリクエストごと: プロンプト長にはキャッシュの読み書き分も含まれます。キャッシュヒットした部分があっても、合計が10万を超えたリクエストは高い方の単価になります。Claude 4.6以降の他のモデルは1Mまで同一単価ですが、Haiku 5.5はこの例外です

    • 同じ文章でもトークン数が増える: Haiku 5.5はClaude 4.7以降と同じ新しいトークナイザーを使っており、同じ入力テキストがHaiku 4.5より約30%多いトークンとして数えられます

    • 大きな画像はトークンが増える: Haiku 5.5は高解像度の画像枠を使い、長辺2,576ピクセルまたは4,784トークンを超える画像を縮小します(Haiku 4.5は1,568ピクセル / 1,568トークン)。移行ガイドでは、2,000×1,500ピクセルの画像でおよそ2.5倍のトークンになる例が挙げられています

    As with all models that use this tokenizer, the same input text produces approximately 30% more tokens on Claude Haiku 5.5 than on Claude Haiku 4.5.

    訳: このトークナイザーを使うすべてのモデルと同じく、同じ入力テキストでも、Claude Haiku 5.5ではClaude Haiku 4.5よりおよそ30%多いトークンになります。(Claude Haiku 5.5 migration guide)

    Batch APIは入出力とも50%引きです。料金は変わりやすいので、最新は公式の料金ページで確認してください。

    Haiku 4.5のコードで400エラーになる変更

    移行ガイドで「Breaking」とされている変更です。どれも、Haiku 4.5で動いていたリクエストがそのまま400エラーになり得ます。

    1. budget_tokens による思考指定

    thinking: {"type": "enabled", "budget_tokens": N} はエラーになります。adaptive thinkingに切り替え、思考の量は output_config.effort で調整します。

    // Haiku 4.5
    {
      "model": "claude-haiku-4-5",
      "max_tokens": 16000,
      "thinking": { "type": "enabled", "budget_tokens": 8000 },
      "messages": [{ "role": "user", "content": "..." }]
    }
    
    // Haiku 5.5
    {
      "model": "claude-haiku-5-5",
      "max_tokens": 16000,
      "thinking": { "type": "adaptive" },
      "output_config": { "effort": "medium" },
      "messages": [{ "role": "user", "content": "..." }]
    }

    A thinking value of {"type": "enabled", "budget_tokens": N} returns a 400 error, so a request that sends it needs a new thinking value.

    訳: thinking に {"type": "enabled", "budget_tokens": N} を指定すると400エラーが返るため、これを送っているリクエストは thinking の値を変える必要があります。(Claude Haiku 5.5 migration guide)

    Haiku 4.5で思考なし、または小さい予算で動かしていた処理は、低めのeffort(low)を選ぶのが公式の案内です。思考をまったく使わない場合は thinking: {"type": "disabled"} も送れますが、これは high 以下のeffortに限られ、xhigh と max では400エラーになります。

    2. temperature / top_p / top_k

    3つとも省略し、出力の傾向はプロンプトで指示します。指定する場合、temperature は 1、top_p は 0.99(デフォルト値)以外はエラーです。top_k はどの値でもエラー、temperature と top_p を両方指定してもエラーになります。なお、Python SDK v1.0以降ではこの3つの引数自体が削除されており、渡すと TypeError になります。

    3. assistant メッセージのプリフィル

    messages の最後をassistantのターンにして続きを書かせる「プリフィル」は、思考を切っていてもエラーです。最後は必ずuserのターンにします。用途ごとの置き換え先は次のとおりです。

    • 出力形式の固定 → structured outputs、または分類ならenumを持つツール

    • 前置きを省かせる → システムプロンプトで「直接答える」よう指示

    • 途中で切れた出力の続き → userメッセージで「前回の応答は途中で切れて、…で終わっている。続きから書いて」と伝える

    4. computer use の旧ツール

    computer_20250124 はエラーになります。Claude APIとGoogle Cloudでは computer_toolset_20260801 ツールセットへ、Amazon Bedrockでは computer_20251124(ベータヘッダー computer-use-2025-11-24)へ移します。ツールセットでは、アクションの振り分けを input.action ではなく各 tool_use ブロックの name と toolset_name で行うなど、エージェントループ側の変更も必要です。

    5. Amazon Bedrock での structured outputs

    Bedrock上のHaiku 5.5では structured outputs(output_config.format や strict: true のツール)が使えません。形式をプロンプトで指示するか、strict なしのツールを使い、出力はコード側で検証します。

    6. 過去のターンを書き換えたうえでの思考ブロック返送

    Haiku 5.5の思考ブロックは、それより前に送った内容が変わっていない間だけ有効です。system、tools、過去の messages を変えてから思考ブロックを送り返すと400エラーになります。会話は追記のみ(append-only)で組み立てます。

    画像

    エラーにはならないが、挙動が変わる点

    • 応答の先頭に thinking ブロックが来る: adaptive thinkingがデフォルトで有効なので、リクエストで思考を指定していなくても thinking ブロックから始まることがあります。content[0] を答えとして読むコードは、type が "text" のブロックを選ぶ形に直します

    • 思考の本文はデフォルトで空: thinking ブロックは署名(signature)だけを持ち、本文は空です。要約が欲しい場合は thinking: {"type": "adaptive", "display": "summarized"} を指定します

    • 思考トークンは max_tokens に含まれる: max_tokens を小さくしていると、思考だけで上限に達し、本文が出ないまま stop_reason: "max_tokens" で終わることがあります

    • 過去ターンの思考ブロックも入力に残る: Haiku 4.5は直近ターンの分だけでしたが、Haiku 5.5はすべて残り、入力トークンとして数えられます。不要なら thinking block clearing で古いものを消します

    • 短いプロンプトもキャッシュできる: キャッシュできる最小長が4,096トークンから512トークンに下がりました

    • 安全分類器による拒否: stop_reason: "refusal" が返ることがあり、サーバー側のフォールバックはないため、クライアントで扱う必要があります

    • 思考ブロックはアカウントに紐づく: 生成したアカウント(またはリンクされたアカウント)でしか有効になりません。保存した会話を別アカウントで再生すると、思考ブロックは黙って捨てられます

    取り出し部分は、Python SDKなら次のように type で選ぶ形にしておくと安全です。

    response = client.messages.create(
        model="claude-haiku-5-5",
        max_tokens=4096,
        output_config={"effort": "low"},
        messages=[{"role": "user", "content": "次の問い合わせを分類して: ..."}],
    )
    
    for block in response.content:
        if block.type == "text":
            print(block.text)

    effortの選び方

    effortのドキュメントでは、Haiku 5.5について次のように案内されています。

    • medium(デフォルト): エージェント的なコーディングを含む、たいていの処理の出発点

    • low: 最も安く速い。チャット、短いツール処理、単純で件数の多いリクエスト向け。ただし長いエージェントのプロンプトでは、検索や確認を飛ばしたり早めに止まったりしやすい

    • high: ナレッジワーク、長めのエージェントタスク、指示への厳密な追従

    • xhigh / max: 評価で品質の改善が確認できた場合だけ。そのときはClaude Sonnet 5.5とも性能・コスト・速度を比べる

    Claude APIとGoogle Cloudでは、会話の途中でeffortを変えるper-message effort(ベータ、ヘッダー mid-conversation-output-config-2026-07-01)にも対応しています。プロンプトキャッシュを保ったまま、ターンごとに強弱を切り替えられます。

    移行の進め方

    1. モデルIDを claude-haiku-5-5(Bedrockは anthropic.claude-haiku-5-5)に変える

    2. トークン数をHaiku 5.5で数え直し、max_tokens とコスト見積もりを見直す(10万トークンの境目も確認)

    3. 前述の6つの破壊的変更に当たる箇所を直す

    4. レスポンスの読み取りを type で選ぶ形にし、refusal を扱う

    5. effortを low / medium / high で比べ、品質・速度・コストの釣り合う値を決める

    Claude Codeを使っている場合は、同梱のClaude APIスキルで移行を自動化できます。対象範囲(作業ディレクトリ全体、サブディレクトリ、ファイル指定)を確認したうえで、モデルIDの置き換え、パラメータの修正、プリフィルの置き換えなどを行い、手で確認すべき項目のチェックリストを出してくれます。

    /claude-api migrate this project to claude-haiku-5-5

    その他の注意点として、Haiku 4.5でPriority Tierの契約がある場合、Haiku 5.5はPriority Tierに対応していないため、容量は別に計画する必要があります。また、Claude Managed Agentsを使っている場合は、モデル名の変更以外の対応は不要とされています。

    Haiku 4.5は、モデルの廃止予定ページで現時点でもActive(廃止は2026年10月15日より前にはならない、という扱い)です。すぐに止まるわけではありませんが、今後の非推奨化の告知は公式の Model deprecations ページで確認してください。

    まとめ

    • Claude Haiku 5.5は2026年10月7日リリース。1Mコンテキスト、128k出力、adaptive thinking、effortはデフォルト medium

    • 単価はHaiku 4.5より低いが、プロンプト10万トークン超で高い単価になり、トークナイザー変更で同じ文章でも約30%トークンが増える

    • budget_tokens、サンプリングパラメータ、プリフィル、旧computer useツールなどはそのまま400エラーになるので、モデルIDの差し替えだけで済ませない

    • 応答の先頭に thinking ブロックが来るため、content[0] ではなく type でテキストを取り出す

    料金や提供範囲は変わることがあるため、最新は公式ドキュメントで確認してください。

    関連記事

    出典:

    (確認日: 2026年10月11日)

    開発ツールの仕様変更・提供終了の情報を毎朝お届けしています。見逃したくない方は、フォローしてください。

     
     

    HARu

     
     
    バックエンドエンジニア。Claude・GitHub・ローカルLLMなど開発ツールの新機能や仕様変更を、公式ドキュメントをもとに日本語で整理しています。「自分に関係あるか」「何を直せばいいか」がすぐ分かる記事を毎朝更新。記事はClaudeと一緒に作っています。

    あなたへのおすすめ