Claude Haiku 5.5移行ガイド
この移行ガイドを使用して、以前のHaikuモデルからClaude Haiku 5.5に切り替えます。Claude Haiku 5.5を有効にするためのガイダンスには、新しいモデルID、エラーを返す設定、思考の変更点、および各移行元モデルのチェックリストが含まれます。
Claude Code
Claude Codeにコードの移行を任せる
/claude-api migrate このプロジェクトをclaude-haiku-5-5に移行してくださいこのガイドでは、Claude Haiku 4.5を呼び出すコードをClaude Haiku 5.5に移行する方法を説明します。Claude Haiku 3.5またはClaude Haiku 3を呼び出すコードの場合は、Claude Haiku 3.5以前のHaikuモデルからClaude Haiku 5.5への移行の変更も行ってください。代わりにSonnetまたはOpusモデルに移行する場合は、移行ガイドを参照してください。Claude Haiku 4.5が利用可能な期間については、モデルの非推奨化を参照してください。
移行元モデル別の移行チェックリスト
グループを上から順に進め、現在のモデルが記載されているグループで止めてください。Claude Haiku 4.5を使用している場合は、最初のグループがリスト全体です。各項目は、コードに加える1つの変更です。
すべての移行元モデル
- モデルIDを、お使いのプラットフォーム向けのClaude Haiku 5.5のIDに置き換えます。Claude Haiku 5.5のモデルIDを使用するを参照してください。
- 同じテキストがより多くのトークンとしてカウントされ、大きな画像がより多くのビジュアルトークンとしてカウントされるため、プロンプトのトークン数を再計算し、
max_tokensの上限とコスト見積もりを見直します。トークンを再カウントするを参照してください。 - リクエストで
thinking: {"type": "enabled", "budget_tokens": N}を送信している場合は、thinkingを{"type": "adaptive"}に変更します。思考を設定するを参照してください。 - コードが最初のコンテンツブロックを回答として読み取っている場合は、代わりに
typeでブロックを選択します。思考を設定するを参照してください。 - リクエストから
temperature、top_p、top_kを削除します。サンプリングパラメータを削除するを参照してください。 - モデルに続きを生成させるために
messagesをアシスタントのターンで終えている場合は、代わりにユーザーのターンで終えるようにします。アシスタントのプリフィルを置き換えるを参照してください。 - コンピューター使用ツールを使用している場合は、
computer_20250124をcomputer_toolset_20260801ツールセットに置き換えます。Amazon Bedrockでは、computer_20251124も使用できます。コンピューター使用をツールセットに移行するを参照してください。 - 保存された会話を別のアカウントを通じて再送信している場合は、各会話をそれを生成したアカウントを通じて再送信します。思考ブロックはそれを生成したアカウントを通じて再送信するを参照してください。
- 会話内のリクエスト間でコードが
system、tools、または以前のmessagesを変更し、思考ブロックを送り返している場合は、会話を追記のみ(append-only)に保ちます。以前のターンを変更しないを参照してください。 stop_reason: "refusal"を処理します。Claude Haiku 5.5はリクエストを拒否する可能性のある安全性分類器を実行しており、サーバー側のフォールバックはありません。セーフガードによる拒否を参照してください。- プロンプトでモデルに推論を応答内に書くよう求めている場合(
<thinking>タグや<reasoning>タグ内など)は、それらの指示を削除します。Claude Haiku 5.5は、それらを含むリクエストを拒否し、reasoning_extractionカテゴリを返す可能性があります。セーフガードによる拒否を参照してください。
組織がClaude Haiku 4.5でPriority Tierのコミットメントを持っている場合は、キャパシティを別途計画してください。Priority TierはClaude Haiku 5.5ではサポートされていません。
Claude Haiku 3.5以前
- Claude Haiku 3.5またはClaude Haiku 3のモデルIDを、お使いのプラットフォーム向けのClaude Haiku 5.5のIDに置き換えます。Claude Haiku 3.5以前のHaikuモデルからClaude Haiku 5.5への移行を参照してください。
code_execution_20250522ツールを使用している場合は、code_execution_20250825以降に移行します。- テキストエディタツールを使用している場合は、
text_editor_20250728に移行します。 refusalおよびmodel_context_window_exceededの停止理由を処理します。- コードがツール呼び出しの文字列パラメータを完全一致で照合している場合は、末尾の改行を許容するようにします。
- プロンプトを見直します。
Claude Haiku 5.5のモデルIDを使用する
Claude Haiku 4.5のモデルIDを、お使いのプラットフォーム向けのClaude Haiku 5.5のIDに置き換えます。
| プラットフォーム | Claude Haiku 4.5 | Claude Haiku 5.5 |
|---|---|---|
| Claude API | claude-haiku-4-5-20251001 または claude-haiku-4-5 | claude-haiku-5-5 |
| Amazon Bedrock | anthropic.claude-haiku-4-5 | anthropic.claude-haiku-5-5 |
| Claude Platform on AWS | claude-haiku-4-5 | claude-haiku-5-5 |
| Claude Models on Google Cloud (Anthropic managed) | claude-haiku-4-5-20251001 | claude-haiku-5-5 |
| Claude Models on Google Cloud (Google managed) | claude-haiku-4-5@20251001 | claude-haiku-5-5 |
| Microsoft Foundry | claude-haiku-4-5 | claude-haiku-5-5 |
claude-haiku-5-5は日付サフィックスのない固定のモデルIDであり、別のエイリアスはありません。
トークンを再カウントする
Claude Haiku 5.5は、Claude 4.7以降のモデルと同じ「tokenizer」(トークナイザー)を使用しています。このトークナイザーを使用するすべてのモデルと同様に、同じ入力テキストでも、Claude Haiku 5.5ではClaude Haiku 4.5と比べて約30パーセント多くのトークンが生成されます。正確な増加量はコンテンツによって異なります。リクエスト、レスポンス、ストリーミングイベントの形式は変わりません。変わるのは、トークン単位で測定または予算化しているすべてのものです。
- 同じテキストに対して、
usageフィールドとトークンカウントの結果が大きくなります。 - 一定数のトークンに収まるテキストが少なくなります。
- Claude Haiku 4.5向けに調整した
max_tokensの上限では、同等の出力が途中で切れる可能性があります。 - Claude Haiku 4.5のトークン数から算出したコスト見積もりは、Claude Haiku 5.5のトークン数と料金(長いプロンプトに対するより高い料金を含む)で再計算する必要があります。料金とロングコンテキストの料金を参照してください。
大きな画像もより多くのトークンを消費する可能性があります。Claude Haiku 5.5は高解像度の画像ティアを使用しており、長辺が2,576ピクセルまたは4,784ビジュアルトークンを超える画像を縮小します。Claude Haiku 4.5以前のHaikuモデルは標準ティアを使用しており、長辺が1,568ピクセルまたは1,568ビジュアルトークンを超える画像を縮小します。2,000×1,500ピクセルの画像は、Claude Haiku 5.5ではClaude Haiku 4.5の約2.5倍のビジュアルトークンを消費します。解像度とトークンコストを参照してください。
Claude Haiku 4.5で測定したカウントを再利用するのではなく、modelをclaude-haiku-5-5に設定してプロンプトをカウントしてください。
思考を設定する
Claude Haiku 5.5は、Claude Haiku 4.5とは異なる方法で思考を設定します。thinkingの値が{"type": "enabled", "budget_tokens": N}の場合は400エラーが返されるため、これを送信しているリクエストには新しいthinkingの値が必要です。
変更前は、Claude Haiku 4.5へのリクエストでthinkingをトークン予算付きのenabledに設定していました。
{
"model": "claude-haiku-4-5",
"max_tokens": 16000,
"thinking": { "type": "enabled", "budget_tokens": 8000 },
"messages": [{ "role": "user", "content": "..." }]
}変更後は、Claude Haiku 5.5への同じリクエストで「adaptive thinking」(適応型思考)を使用します。thinkingの値が変わり、output_config.effortでモデルがどの程度思考するかを設定します。
{
"model": "claude-haiku-5-5",
"max_tokens": 16000,
"thinking": { "type": "adaptive" },
"output_config": { "effort": "medium" },
"messages": [{ "role": "user", "content": "..." }]
}適応型思考はデフォルトで有効になっているため、リクエストでthinkingを設定していない場合でも、レスポンスが1つ以上のthinkingブロックで始まることがあります。thinkingを未設定のままにするか{"type": "adaptive"}に設定し、エフォートを制御手段として使用してください。Claude Haiku 4.5で思考なし、またはトークンを節約するために小さな予算で実行していた場合は、より低いエフォートレベルを選択します。低いレベルではモデルの思考量が減り、単純なリクエストでは思考を完全に省略することもあります。プロンプトのガイダンスについては、エフォートを使用して思考を制御するを参照してください。コンテンツブロックは位置ではなくtypeフィールドで選択し、thinkingブロックはツール結果とともに変更せずに送り返してください。
思考トークンはmax_tokensにカウントされるため、max_tokensが小さいリクエストは、thinkingブロックの後、テキストが出力される前にstop_reason: "max_tokens"で停止することがあります。Claude Haiku 4.5向けに小さなmax_tokensを設定していた場合は、思考の余地を残すために値を引き上げるか、より低いエフォートレベルを選択してください。
以前のアシスタントターンの思考ブロックはコンテキストに残り、入力トークンとしてカウントされます。一方、Claude Haiku 4.5は最新ターンのものだけを保持します。そのため、マルチターンの会話では、トークナイザーの変更だけでは説明できないほど多くの入力トークンが発生します。古いブロックを削除するには、思考ブロックのクリアを使用してください。モデル別の思考ブロックの保持を参照してください。
デフォルトでは、Claude Haiku 5.5は各thinkingブロックを空のthinkingフィールドとsignatureのみで返します。一方、Claude Haiku 4.5は要約された思考を返します。要約された思考を受け取るには、thinking: {"type": "adaptive", "display": "summarized"}を設定してください。
Claude Haiku 5.5は強制的なtool_choice(anyまたは名前付きツール)を受け付けますが、レスポンスはツール呼び出しで始まり、thinkingブロックは含まれません。ツールを呼び出す前にモデルに思考させるには、tool_choice: {"type": "auto"}を使用し、プロンプト内でツールを使用するタイミングを指示してください。
Claude Haiku 4.5からClaude Haiku 5.5に切り替えた会話は推論を保持します。その他の切り替えでは、2つのモデルの組み合わせによって異なります。
| 切り替え | 推論を保持するか |
|---|---|
| Claude Haiku 4.5以前、Claude Sonnet 5以前、またはClaude Opus 4.8以前からClaude Haiku 5.5へ | はい |
| その他のモデルからClaude Haiku 5.5へ | いいえ。APIはそのモデルの思考ブロックをエラーなしで除外します。 |
| Claude Haiku 5.5からClaude Opus 5.5、Claude Sonnet 5.5、Claude Fable 5.2、またはClaude Mythos 5.2へ | はい。ただし、Claude APIおよびClaude Models on Google Cloud (Google managed)のみです |
| Claude Haiku 5.5からその他のモデルへ | いいえ |
モデルを切り替えて元に戻すを参照してください。Claude Haiku 5.5が関係しない切り替えについては、Claude APIで推論を保持するモデル切り替えを参照してください。
サンプリングパラメータを削除する
Claude Haiku 5.5では、temperature、top_p、top_kを省略し、代わりにプロンプトでモデルの動作を誘導してください。
アシスタントのプリフィルを置き換える
「prefill」(プリフィル)とは、モデルが続きを生成する、messages内の最後のアシスタントターンです。Claude Haiku 4.5は思考がオフの場合にプリフィルを受け付けます。Claude Haiku 5.5は、思考をオフにしていても400エラーでこれを拒否します。messagesはユーザーターンで終え、各プリフィルをその目的に応じて置き換えてください。
- 出力形式: 構造化出力を使用するか、分類には列挙型フィールドを持つツールを使用します。
- 前置き: システムプロンプトで直接的な回答を求めます。
- 続き: ユーザーメッセージに移動します。例:「前回の応答は中断され、
[previous_response]で終わりました。中断したところから続けてください。」 - コンテキストのリマインダー: ユーザーターンに含めます。
コンピューター使用をツールセットに移行する
Claude Haiku 4.5は、computer-use-2025-01-24ベータヘッダーを指定したcomputer_20250124ツールを通じてコンピューター使用をサポートしています。Claude Haiku 5.5は、computer_toolset_20260801ツールセットを通じてコンピューター使用をサポートしています。computer_20250124を宣言したClaude Haiku 5.5へのリクエストは400エラーを返します。
インテグレーションをツールセットに移行するには、computer-use-2025-01-24ベータヘッダーを削除し、toolsのエントリを{"type": "computer_toolset_20260801"}に置き換えます。その後、computer_20251124からの移行に記載されているその他のリクエストおよびエージェントループの変更を行います。input.actionではなく、各メンバーのtool_useブロックのnameとtoolset_nameに基づいて処理を振り分けます。1つのターン内のそのようなブロックをすべて処理し、結果にtoolset_nameをエコーします。ツールセットではズームがデフォルトで有効になっています。お使いの環境でズームを実装していない場合は、"configs": {"zoom": {"enabled": false}}を追加します。fine-grained-tool-streaming-2025-05-14ベータヘッダーを送信している場合は削除してください。ツールセットのエントリと併用すると、400エラーが返されます。
Amazon Bedrockでは、Claude Haiku 5.5はcomputer-use-2025-11-24ベータヘッダーを指定したcomputer_20251124ツールも受け付けます。
Claude Haiku 5.5は、Webページ内でのタスク向けにブラウザ使用ツール(browser_toolset_20260801)をサポートしています。Claude Haiku 4.5はこれをサポートしていません。
思考ブロックはそれを生成したアカウントを通じて再送信する
Claude Haiku 5.5の思考ブロックは、それを生成したアカウント、またはそのアカウントにリンクされたアカウントでのみ機能します。別のアカウントがこれらのブロックのいずれかを送信すると、APIはモデルが受け取る前にそのブロックを除外し、リクエストはその推論なしで成功します。これは、会話を保存して別のアカウントを通じて再送信するコード、たとえば1つの会話ストアから複数の顧客にサービスを提供するサービスに影響します。各会話は、それを生成したアカウントを通じて再送信してください。アカウントとクラウドプラットフォームを参照してください。
以前のターンを変更しない
会話は追記のみの形で保持してください。Claude Haiku 5.5の思考ブロックは、それより前に送信されたすべての内容、すなわちsystemプロンプト、tools、およびそれ以前のすべてのメッセージが変更されていない間のみ有効です。
プレフィックスチェックに失敗すると、400エラーになる場合もあれば、ならない場合もあります。両方のケースを特定して対処するには、思考ブロックのプレフィックスチェックを参照してください。
エラーを引き起こす変更と、代わりに行うべきことについては、コードがシステムプロンプト、ツール、または履歴を変更する場合を参照してください。
Claude Haiku 3.5以前のHaikuモデルからClaude Haiku 5.5への移行
Claude Haiku 3.5はClaude API、Amazon Bedrock、およびClaude Models on Google Cloud (Google managed)で廃止済みです。Claude Haiku 3はClaude APIおよびClaude Models on Google Cloud (Google managed)で廃止済みです。モデルの非推奨化を参照してください。
いずれのモデルからの移行でも、まず前述のすべてのセクションを適用し、その後に以下の変更を行ってください。
- モデルID:
claude-3-5-haiku-20241022、そのエイリアスclaude-3-5-haiku-latest、またはclaude-3-haiku-20240307をclaude-haiku-5-5に置き換えます。Claude Models on Google Cloud (Google managed)では、claude-3-5-haiku@20241022をclaude-haiku-5-5に置き換えます。Amazon Bedrockでは、Claude Haiku 5.5のモデルIDを使用するに記載のClaude Haiku 5.5のIDを使用します。 - コード実行: Claude Haiku 5.5は
code_execution_20250825以降のバージョンを受け付けます。Pythonのみに対応したcode_execution_20250522を使用している場合は、いずれかのバージョンに移行してください。最新のツールバージョンへのアップグレードを参照してください。 - テキストエディタ: テキストエディタツールを使用している場合は、
text_editor_20250728(ツール名str_replace_based_edit_tool)に移行します。これにはundo_editコマンドがありません。テキストエディタツールを参照してください。 - 停止理由:
refusalとmodel_context_window_exceededを処理します。停止理由とフォールバックを参照してください。 - 末尾の改行: Claude 4.5以降のモデルは、ツール呼び出しの文字列パラメータ内の末尾の改行を保持します。コードがそれらの文字列を完全一致で照合している場合は、改行を許容するようにしてください。
- プロンプト: Claude 4以降のモデルは、より簡潔で直接的なコミュニケーションスタイルを持ち、明示的な指示を必要とします。Claude Haiku 5.5へのプロンプトとプロンプティングのベストプラクティスに照らしてプロンプトを見直してください。
このページは役に立ちましたか?