---
title: Claude Haiku 5.5移行ガイド
url: https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide
description: この移行ガイドを使用して、以前のHaikuモデルからClaude Haiku 5.5に切り替えます。Claude Haiku 5.5を有効にするためのガイダンスには、新しいモデルID、エラーを返す設定、思考の変更点、および各移行元モデルのチェックリストが含まれます。
---

<Note>
  このガイドでは、[Messages API](https://platform.claude.com/docs/ja/build-with-claude/working-with-messages)のコードの移行について説明します。[Claude Managed Agents](https://platform.claude.com/docs/ja/managed-agents/overview)を使用している場合は、モデル名の更新以外に変更は必要ありません。
</Note>

Claude Codeにコードの移行を任せる

```text
/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への移行](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide#migrating-from-haiku-35)の変更も行ってください。代わりにSonnetまたはOpusモデルに移行する場合は、[移行ガイド](https://platform.claude.com/docs/ja/about-claude/models/migration-guide)を参照してください。Claude Haiku 4.5が利用可能な期間については、[モデルの非推奨化](https://platform.claude.com/docs/ja/about-claude/model-deprecations)を参照してください。

## 移行元モデル別の移行チェックリスト

グループを上から順に進め、現在のモデルが記載されているグループで止めてください。Claude Haiku 4.5を使用している場合は、最初のグループがリスト全体です。各項目は、コードに加える1つの変更です。

### すべての移行元モデル

1. モデルIDを、お使いのプラットフォーム向けのClaude Haiku 5.5のIDに置き換えます。[Claude Haiku 5.5のモデルIDを使用する](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide#use-the-claude-haiku-5-5-model-id)を参照してください。
2. 同じテキストがより多くのトークンとしてカウントされ、大きな画像がより多くのビジュアルトークンとしてカウントされるため、プロンプトのトークン数を再計算し、`max_tokens`の上限とコスト見積もりを見直します。[トークンを再カウントする](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide#recount-tokens)を参照してください。
3. リクエストで`thinking: {"type": "enabled", "budget_tokens": N}`を送信している場合は、`thinking`を`{"type": "adaptive"}`に変更します。[思考を設定する](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide#configure-thinking)を参照してください。
4. コードが最初のコンテンツブロックを回答として読み取っている場合は、代わりに`type`でブロックを選択します。[思考を設定する](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide#configure-thinking)を参照してください。
5. リクエストから`temperature`、`top_p`、`top_k`を削除します。[サンプリングパラメータを削除する](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide#remove-sampling-parameters)を参照してください。
6. モデルに続きを生成させるために`messages`をアシスタントのターンで終えている場合は、代わりにユーザーのターンで終えるようにします。[アシスタントのプリフィルを置き換える](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide#replace-assistant-prefill)を参照してください。
7. コンピューター使用ツールを使用している場合は、`computer_20250124`を`computer_toolset_20260801`ツールセットに置き換えます。Amazon Bedrockでは、`computer_20251124`も使用できます。[コンピューター使用をツールセットに移行する](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide#computer-use-toolset)を参照してください。
8. 保存された会話を別のアカウントを通じて再送信している場合は、各会話をそれを生成したアカウントを通じて再送信します。[思考ブロックはそれを生成したアカウントを通じて再送信する](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide#replay-thinking-blocks-through-the-producing-account)を参照してください。
9. 会話内のリクエスト間でコードが`system`、`tools`、または以前の`messages`を変更し、思考ブロックを送り返している場合は、会話を追記のみ（append-only）に保ちます。[以前のターンを変更しない](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide#keep-earlier-turns-unchanged)を参照してください。
10. `stop_reason: "refusal"`を処理します。Claude Haiku 5.5はリクエストを拒否する可能性のある安全性分類器を実行しており、サーバー側のフォールバックはありません。[セーフガードによる拒否](https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#safeguard-refusals)を参照してください。
11. プロンプトでモデルに推論を応答内に書くよう求めている場合（`<thinking>`タグや`<reasoning>`タグ内など）は、それらの指示を削除します。Claude Haiku 5.5は、それらを含むリクエストを拒否し、`reasoning_extraction`カテゴリを返す可能性があります。[セーフガードによる拒否](https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#safeguard-refusals)を参照してください。

組織がClaude Haiku 4.5で[Priority Tier](https://platform.claude.com/docs/ja/api/service-tiers#supported-models)のコミットメントを持っている場合は、キャパシティを別途計画してください。Priority TierはClaude Haiku 5.5ではサポートされていません。

### Claude Haiku 3.5以前

1. Claude Haiku 3.5またはClaude Haiku 3のモデルIDを、お使いのプラットフォーム向けのClaude Haiku 5.5のIDに置き換えます。[Claude Haiku 3.5以前のHaikuモデルからClaude Haiku 5.5への移行](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide#migrating-from-haiku-35)を参照してください。
2. `code_execution_20250522`ツールを使用している場合は、`code_execution_20250825`以降に移行します。
3. テキストエディタツールを使用している場合は、`text_editor_20250728`に移行します。
4. `refusal`および`model_context_window_exceeded`の停止理由を処理します。
5. コードがツール呼び出しの文字列パラメータを完全一致で照合している場合は、末尾の改行を許容するようにします。
6. プロンプトを見直します。

## 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`フィールドと[トークンカウント](https://platform.claude.com/docs/ja/build-with-claude/token-counting)の結果が大きくなります。
* 一定数のトークンに収まるテキストが少なくなります。
* Claude Haiku 4.5向けに調整した`max_tokens`の上限では、同等の出力が途中で切れる可能性があります。
* Claude Haiku 4.5のトークン数から算出したコスト見積もりは、Claude Haiku 5.5のトークン数と料金（長いプロンプトに対するより高い料金を含む）で再計算する必要があります。[料金](https://platform.claude.com/docs/ja/about-claude/pricing)と[ロングコンテキストの料金](https://platform.claude.com/docs/ja/about-claude/pricing#long-context-pricing)を参照してください。

大きな画像もより多くのトークンを消費する可能性があります。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倍のビジュアルトークンを消費します。[解像度とトークンコスト](https://platform.claude.com/docs/ja/build-with-claude/vision#evaluate-image-size)を参照してください。

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`に設定していました。

```json
{
  "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`でモデルがどの程度思考するかを設定します。

```json
{
  "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"}`に設定し、[エフォート](https://platform.claude.com/docs/ja/build-with-claude/effort)を制御手段として使用してください。Claude Haiku 4.5で思考なし、またはトークンを節約するために小さな予算で実行していた場合は、より低いエフォートレベルを選択します。低いレベルではモデルの思考量が減り、単純なリクエストでは思考を完全に省略することもあります。プロンプトのガイダンスについては、[エフォートを使用して思考を制御する](https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5#use-effort-to-control-thinking)を参照してください。コンテンツブロックは位置ではなく`type`フィールドで選択し、`thinking`ブロックはツール結果とともに変更せずに送り返してください。

思考トークンは`max_tokens`にカウントされるため、`max_tokens`が小さいリクエストは、`thinking`ブロックの後、テキストが出力される前に`stop_reason: "max_tokens"`で停止することがあります。Claude Haiku 4.5向けに小さな`max_tokens`を設定していた場合は、思考の余地を残すために値を引き上げるか、より低い[エフォート](https://platform.claude.com/docs/ja/build-with-claude/effort)レベルを選択してください。

以前のアシスタントターンの思考ブロックはコンテキストに残り、入力トークンとしてカウントされます。一方、Claude Haiku 4.5は最新ターンのものだけを保持します。そのため、マルチターンの会話では、トークナイザーの変更だけでは説明できないほど多くの入力トークンが発生します。古いブロックを削除するには、[思考ブロックのクリア](https://platform.claude.com/docs/ja/build-with-claude/context-editing#thinking-block-clearing)を使用してください。[モデル別の思考ブロックの保持](https://platform.claude.com/docs/ja/build-with-claude/thinking#thinking-block-preservation-by-model)を参照してください。

デフォルトでは、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からその他のモデルへ | いいえ |

[モデルを切り替えて元に戻す](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#switching-models)を参照してください。Claude Haiku 5.5が関係しない切り替えについては、[Claude APIで推論を保持するモデル切り替え](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#which-model-switches-keep-reasoning)を参照してください。

## サンプリングパラメータを削除する

Claude Haiku 5.5では、`temperature`、`top_p`、`top_k`を省略し、代わりにプロンプトでモデルの動作を誘導してください。

## アシスタントのプリフィルを置き換える

「prefill」（プリフィル）とは、モデルが続きを生成する、`messages`内の最後のアシスタントターンです。Claude Haiku 4.5は思考がオフの場合にプリフィルを受け付けます。Claude Haiku 5.5は、思考をオフにしていても400エラーでこれを拒否します。`messages`はユーザーターンで終え、各プリフィルをその目的に応じて置き換えてください。

* **出力形式:** [構造化出力](https://platform.claude.com/docs/ja/build-with-claude/structured-outputs)を使用するか、分類には列挙型フィールドを持つツールを使用します。
* **前置き:** システムプロンプトで直接的な回答を求めます。
* **続き:** ユーザーメッセージに移動します。例：「前回の応答は中断され、`[previous_response]`で終わりました。中断したところから続けてください。」
* **コンテキストのリマインダー:** ユーザーターンに含めます。

## コンピューター使用をツールセットに移行する

Claude Haiku 4.5は、`computer-use-2025-01-24`ベータヘッダーを指定した`computer_20250124`ツールを通じて[コンピューター使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/computer-use-tool)をサポートしています。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`からの移行](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/computer-use-tool#migrate-from-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ページ内でのタスク向けに[ブラウザ使用ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/browser-use-tool)（`browser_toolset_20260801`）をサポートしています。Claude Haiku 4.5はこれをサポートしていません。

## 思考ブロックはそれを生成したアカウントを通じて再送信する

Claude Haiku 5.5の思考ブロックは、それを生成したアカウント、またはそのアカウントにリンクされたアカウントでのみ機能します。別のアカウントがこれらのブロックのいずれかを送信すると、APIはモデルが受け取る前にそのブロックを除外し、リクエストはその推論なしで成功します。これは、会話を保存して別のアカウントを通じて再送信するコード、たとえば1つの会話ストアから複数の顧客にサービスを提供するサービスに影響します。各会話は、それを生成したアカウントを通じて再送信してください。[アカウントとクラウドプラットフォーム](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#account-bound-thinking)を参照してください。

## 以前のターンを変更しない

会話は追記のみの形で保持してください。Claude Haiku 5.5の思考ブロックは、それより前に送信されたすべての内容、すなわち`system`プロンプト、`tools`、およびそれ以前のすべてのメッセージが変更されていない間のみ有効です。

[プレフィックスチェック](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking/prefix-checks#prefix-check)に失敗すると、[400エラー](https://platform.claude.com/docs/ja/api/errors#thinking-block-conversation-mismatch)になる場合もあれば、ならない場合もあります。両方のケースを特定して対処するには、[思考ブロックのプレフィックスチェック](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking/prefix-checks)を参照してください。

エラーを引き起こす変更と、代わりに行うべきことについては、[コードがシステムプロンプト、ツール、または履歴を変更する場合](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking/prefix-checks#what-to-check)を参照してください。

## 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)で廃止済みです。[モデルの非推奨化](https://platform.claude.com/docs/ja/about-claude/model-deprecations)を参照してください。

いずれのモデルからの移行でも、まず前述のすべてのセクションを適用し、その後に以下の変更を行ってください。

* **モデル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を使用する](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide#use-the-claude-haiku-5-5-model-id)に記載のClaude Haiku 5.5のIDを使用します。
* **コード実行:** Claude Haiku 5.5は`code_execution_20250825`以降のバージョンを受け付けます。Pythonのみに対応した`code_execution_20250522`を使用している場合は、いずれかのバージョンに移行してください。[最新のツールバージョンへのアップグレード](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/code-execution-tool#upgrade-to-latest-tool-version)を参照してください。
* **テキストエディタ:** テキストエディタツールを使用している場合は、`text_editor_20250728`（ツール名`str_replace_based_edit_tool`）に移行します。これには`undo_edit`コマンドがありません。[テキストエディタツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/text-editor-tool)を参照してください。
* **停止理由:** `refusal`と`model_context_window_exceeded`を処理します。[停止理由とフォールバック](https://platform.claude.com/docs/ja/build-with-claude/handling-stop-reasons)を参照してください。
* **末尾の改行:** Claude 4.5以降のモデルは、ツール呼び出しの文字列パラメータ内の末尾の改行を保持します。コードがそれらの文字列を完全一致で照合している場合は、改行を許容するようにしてください。
* **プロンプト:** Claude 4以降のモデルは、より簡潔で直接的なコミュニケーションスタイルを持ち、明示的な指示を必要とします。[Claude Haiku 5.5へのプロンプト](https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/prompting-claude-haiku-5-5)と[プロンプティングのベストプラクティス](https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/claude-prompting-best-practices)に照らしてプロンプトを見直してください。
