claude-haiku-4-5をclaude-haiku-5-5に変更するのは、この移行で最も小さな作業です。Haiku 4.5で動いていた5つのリクエストパターンは、今や400エラーを返します。さらに、失敗としては表れないものの、返ってくる内容、コスト、エージェント内でのモデルの振る舞いを変えてしまう変更もいくつかあります。
Anthropicは、既存のHaiku 4.5向けプロンプトは変更なしでHaiku 5.5でもうまく動くはずだと説明しています。一方で、そのプロンプトを囲むリクエストのコードは話が別です。この記事では、遭遇する問題ごとに、何が表示されるか、なぜ起きるか、どう直すかを示し、最後にチェックリストを付けます。正式な参照先は、AnthropicのHaiku 5.5移行ガイドです。
切り分け:症状から照合する
| 表示される内容 | 原因 | 修正方法 |
|---|---|---|
| thinkingの予算を指定したリクエストで400 | 手動の思考設定が削除された | Adaptive thinkingとeffortを使う |
| temperature、top_p、top_kを指定すると400 | サンプリングパラメータが固定された | 削除する |
| messagesがassistantのターンで終わると400 | プリフィルが削除された | userのターンで終わらせる |
| コンピュータユースで400 | 古いcomputerツールが拒否される | computerツールセットに移行する |
| 以前のターンを編集した後に400 | Thinkingが履歴に紐づいている | 履歴は追記のみにする |
| パーサーが空または誤ったテキストを返す | Thinkingブロックが先頭にある | タイプでブロックを選択する |
| 返答が途中で切れる、または返答がない | Thinkingが上限に含まれる | max_tokensを増やすか、effortを下げる |
| トークン数と料金が約30%増加する | 新しいトークナイザー | 新しいモデルで数え直す |
| stop reasonがrefusalのレスポンス | 新しい安全性分類器 | クライアント側で処理する |
最初の5つは明確に失敗します。残りは静かに失敗するため、見つけるのにより多くの手間がかかります。
明確に失敗する5つの問題
1. 手動の思考予算
表示される内容:thinking: {"type": "enabled", "budget_tokens": N}を送信したリクエストはすべて400になります。
理由:Haiku 4.5は、トークン予算を伴う手動の拡張思考のみをサポートしていました。Haiku 5.5はadaptive thinkingのみをサポートし、思考の深さはeffortで制御します。
修正方法:{"type": "adaptive"}を送るか、thinkingを省略し、effortのレベルを選びます。以前の予算がトークン節約のために小さく設定されていた場合は、低いレベルを選びます。
# Before: Haiku 4.5
thinking={"type": "enabled", "budget_tokens": 8000}
# After: Haiku 5.5
thinking={"type": "adaptive"},
output_config={"effort": "medium"},
2. サンプリングパラメータ
表示される内容:リクエストでtemperature、top_p、top_kのいずれかを設定すると400になります。
理由:Haiku 5.5は、デフォルト値のみを受け付けます。temperatureは1、top_pは0.99です。どちらかがそれ以外の値である場合、top_kを指定した場合、またはtemperatureとtop_pの両方を送った場合は、thinkingを使っているかどうかに関係なく400が返されます。top_pが1でも拒否されます。
修正方法:3つすべてを削除します。よくあるケースは、分類器で安定したラベルを得るためのtemperature=0です。これは、構造化出力か、入力が列挙型であるツールに置き換えてください。そうすればラベルの集合は、サンプリングではなくスキーマによって強制されます。また、代わりにデフォルトのサンプリング値を追加するSDKのラッパーやゲートウェイも確認してください。
3. アシスタントのプリフィル
表示される内容:thinkingを無効にしていても、messagesの最後のエントリがassistantのターンだと400になります。
理由:Haiku 5.5では、現行のClaudeラインナップと同様に、プリフィルはサポートされていません。
修正方法:messagesはuserのターンで終わらせ、プリフィルはその目的を果たす別の方法に置き換えます。フォーマットの制御は構造化出力(output_config.format)にします。プリフィルで与えていた前置きは、システムプロンプトで直接回答するよう指示する形にします。途中で止まった返答の続きは、ユーザーメッセージに移します。例:「前回の返答は[テキスト]で終わっていました。そこから続けてください。」
4. コンピュータユース
表示される内容:リクエストでcomputer_20250124ツールを宣言すると、Claude APIまたはGoogle Cloudで400になります。
理由:これらのプラットフォームでは、Haiku 5.5は新しいツールセットであるcomputer_toolset_20260801を通じてのみコンピュータユースをサポートします。
修正方法:computer-use-2025-01-24のベータヘッダーを削除し、ツールの項目を{"type": "computer_toolset_20260801"}に置き換えます。さらにエージェントのループを更新します。tool_useブロックごとに、input.actionではなくnameとtoolset_nameで分岐させ、1つのターン内のそうしたブロックはすべて処理し、結果にはtoolset_nameを返してください。ズームはデフォルトで有効です。環境がズームを実装していない場合は、ツールセットの設定で無効にしてください。Amazon Bedrockでは、バージョンを選ぶ前にコンピュータユースツールの互換性に関する注意書きを確認してください。同じツールセットファミリーにはブラウザ操作も含まれており、Haiku 4.5にはなかった機能です。
5. 以前のターンの編集
表示される内容:システムプロンプト、ツールリスト、または以前のメッセージなど、それより前の内容が変わった後に、thinkingブロックを返すリクエストで400になります。
理由:Haiku 5.5のthinkingブロックは、それより前に送られた内容がすべて変わらない間だけ有効です。このチェックは、2026年8月31日以降に作成されたアカウントではデフォルトで強制され、それ以前のアカウントでは、リクエストがオプトインした場合にのみ適用されます。
修正方法:会話は追記のみにしてください。よくある原因は、タイムスタンプ付きのシステムプロンプト、プラグインの接続時に増えるツールリスト、クライアント側での切り詰め、そして履歴に挿入されて次のターンで取り除かれるリマインダーです。ターンごとの指示には、Haiku 5.5がmessages内のシステムメッセージをサポートしています。ベータヘッダーは不要で、以前の内容を編集せずにコンテキストを追加できます。
目立たない失敗
Thinkingブロックが先頭に来る。Thinkingはデフォルトで有効なので、レスポンスは1つ以上のthinkingブロックから始まることがあります。response.content[0].textを回答として読むコードは、壊れるか空のテキストを返します。typeでブロックを選択してください。
Thinkingのテキストはデフォルトで空。Haiku 4.5は要約されたthinkingを返していました。Haiku 5.5は、テキストフィールドが空で署名だけを含むthinkingブロックを返します。UIに推論の要約を表示していた場合は、thinking: {"type": "adaptive", "display": "summarized"}を設定してください。いずれの場合も、thinkingブロックはツール結果とともに変更せずに返してください。空のブロックを削除するシリアライザーがあると、それらが取り除かれてしまいます。
max_tokensにはthinkingも含める必要がある。短い回答を想定した上限は、thinkingで使い切られてしまうことがあります。その場合、テキストが出る前にstop_reason: "max_tokens"でレスポンスが終わります。上限を引き上げるか、effortを下げてください。
同じテキストでもトークン数が約30%増える。新しいトークナイザーは、usageフィールド、count_tokensの結果、コンテキストの予算、そしてHaiku 4.5向けに調整されたmax_tokensに影響します。また、Haiku 4.5が数えていた場合の100Kトークンの料金の基準線は、約77Kトークンに移動します。コストのダッシュボードを信用する前に、実際のプロンプトをモデルclaude-haiku-5-5に設定して数え直してください。
デフォルトのeffortはmedium。Haiku 4.5にはeffortの設定がありませんでした。Haiku 5.5のデフォルトはmediumで、単純なルートには必要以上の思考になることがあります。明示的に設定してください。
Thinkingブロックは、それを生成したアカウントに紐づいたままになる。サービスが保存された会話を別のAPIアカウント経由で再生している場合、Haiku 5.5のthinkingブロックは黙って削除され、そのリクエストはその推論なしで実行されます。各会話は、それを生成したアカウント経由で再生してください。
Priority Tierは引き継がれない。Haiku 5.5はPriority Tierをサポートしていないため、Haiku 4.5でこれに依存していた場合は、キャパシティを別途計画してください。
実際の権限を持つエージェントにとって重要な振る舞いの変化
拒否応答は新しく、何もそれを捕捉してくれない。Haiku 5.5は、サイバー、バイオ、フロンティアLLM開発、一般的な有害性の4つのカテゴリーで安全性分類器を実行します。拒否は通常のHTTP 200として返され、stop_reason: "refusal"と、stop_details内のカテゴリーが付きます。Haiku 5.5にはサーバー側のフォールバックがありません。フォールバックモデルのリストを送ると400が返り、デフォルトのフォールバックモードでは、リクエストは拒否されたままになります。contentを読む前にstop_reasonを確認し、言い換えるか、より大きなモデルにエスカレーションするか、停止するかを自分のコードで判断してください。発表記事によると、サイバー分野の安全対策はSonnet 5.5より幅広い防御的作業を許可しますが、ペネトレーションテストはブロックします。
ツール結果内のユーザーテキストが無視される可能性がある。Haiku 5.5は、ツール結果を通じたプロンプトインジェクションに抵抗するよう訓練されています。ハーネスがタスクの途中でユーザーが入力したメッセージをtool_resultブロック内で渡す場合、モデルはそれを信頼できないものとみなして無視することがあります。途中のユーザー入力は、最後のツール結果の後のテキストブロックに入れ、ハーネスの通知は別のシステムメッセージに入れてください。
effortが低いと、エージェントが途中で止まったりチェックを飛ばしたりすることがある。長いコーディングエージェントのシステムプロンプトをlowで使うと、Haiku 5.5はタスクが終わる前に作業を返してしまうことがあります。また、lowとmediumでは、テストを実行せずにコード変更が完了したと報告することがあります。AnthropicのHaiku 5.5プロンプティングガイドには、この両方に対する短い指示があります。ファイルの書き込みやコマンドの実行ができるエージェントにとっては、検証されていない「完了」の方が危険です。
ツールを強制するとthinkingが省略される。強制的なtool_choiceは引き続き受け付けられますが、その場合モデルは先に思考せずにツールを呼び出します。副作用のあるツールでは、autoと明確な指示を組み合わせると、モデルは行動する前に推論できます。
検索ツールには当日の日付が必要。Haiku 5.5に検索ツールがある場合、システムプロンプトかツールの説明に現在の日付を入れてください。Anthropicのテストでは、これにより回答が最新の結果に基づくようになりました。
AIHubMix経由で移行したリクエスト
JSON用にtemperature=0と、プリフィルの{を使っていたHaiku 4.5の分類器を、AIHubMix Claude native endpoint上でHaiku 5.5向けに書き換えたものです:
import os
import anthropic
client = anthropic.Anthropic(
api_key=os.environ["AIHUBMIX_API_KEY"],
base_url="https://aihubmix.com",
)
r = client.messages.create(
model="claude-haiku-5-5",
max_tokens=2000, # room for thinking plus the JSON
output_config={
"effort": "low", # thinking is on by default; keep it light
"format": { # replaces the prefill and temperature=0
"type": "json_schema",
"schema": {
"type": "object",
"properties": {
"label": {"type": "string", "enum": ["billing", "bug", "other"]}
},
"required": ["label"],
"additionalProperties": False,
},
},
},
messages=[{"role": "user", "content": "Ticket: 'I was charged twice for October.'"}],
)
if r.stop_reason == "refusal":
raise RuntimeError(f"declined: {r.stop_details}")
text = next(b.text for b in r.content if b.type == "text")
print(text)
ゲートウェイがoutput_configのフィールドや新しいベータヘッダーをそのまま転送するかどうかは、最初のテスト実行で確認する価値があります。移行したルートが評価を通過したら、AIHubMixのモデル一覧から、Haikuで失敗し続けるタスクの種類については、同じコードをSonnet 5.5に向けるのも簡単です。
移行チェックリスト
- モデルIDをclaude-haiku-5-5に変更します。日付のサフィックスは付けません。
- 手動の思考予算はすべて、adaptive thinkingと明示的なeffortレベルに置き換えます。
- temperature、top_p、top_kを削除します。ラッパーが追加したデフォルト値も含めて削除してください。
- 構造化出力、システム指示、またはユーザーターンでの続き書きに置き換える。
- コンピュータ利用をコンピュータツールセットに移し、エージェントループを更新する。
- 思考ブロックを再送する場合は、会話履歴を追記のみ(append-only)にする。
- レスポンスのコンテンツはブロックの種類ごとに読み取り、再送時には空の思考ブロックを残しておく。
- 短い回答を返すルートでは max_tokens を引き上げるか、effort を下げる。
- コンテンツを読む前に refusal の stop reason を処理し、サーバー側のフォールバックは設定しない。
- 新しいモデルで プロンプトのトークン数を数え直し、コストのダッシュボードを基準値から再設定する。
- 100K トークンを超えるようになったプロンプトを確認し、削減するか分割する。
- ユーザーが推論の要約を見ていた場合は、display を summarized に設定する。
- ターン途中のユーザー入力は、ツール結果の外側で配信する。
- 検索を有効にしたエージェントには、本日の日付を与える。
- トラフィックを移す前に、レート制限と Priority Tier の必要性を再確認する。
FAQ
Haiku 4.5 のプロンプトは Haiku 5.5 でもそのまま動きますか?
Anthropic によると、既存のプロンプトは変更なしでも十分に動作するはずです。問題になるのは、その周囲のリクエストパラメータです。思考の予算、サンプリング設定、プリフィル、古いコンピュータ利用ツールはいずれもエラーを返します。
temperature 0 を削除したのに、分類器が失敗するようになったのはなぜですか?
失敗するはずはありませんが、ラベルのばらつきが大きくなる可能性があります。許可されるラベルをスキーマで強制できるよう、構造化出力か enum フィールドを持つツールを使ってください。これは temperature 0 よりも確実です。
今も思考をオフにできますか?
はい、low、medium、high の effort では可能です。xhigh と max では、思考をオフにするとエラーが返ります。Anthropic は代わりに、より低い effort レベルの使用を推奨しています。単純なリクエストではモデルが自ら思考を省略できるためです。
Haiku 5.5 が拒否したとき、コードはどう対応すべきですか?
コンテンツを読む前に stop reason を確認してください。Haiku 5.5 にはサーバー側のフォールバックがないため、言い換えるか、より大きなモデルにリクエストを送るか、ユーザーにエラーを返すかは、あなたのコードが決めます。
移行後にトークン使用量が増えたのはなぜですか?
理由は2つあります。新しいトークナイザーは同じテキストに対して約30%多くのトークンを数えること、そして思考がデフォルトでオンになっており、出力トークンが増えることです。effort を下げ、新しいモデルでプロンプトのトークン数を数え直してください。
プロンプトキャッシュについて何か変更が必要ですか?
通常は必要なく、むしろ簡単になっています。Anthropic の移行ガイドによると、キャッシュ可能な最小プロンプト長は 4,096 トークンから 512 トークンに下がり、前のターンの思考ブロックもデフォルトでキャッシュされたプレフィックスに残ります。前のターンを編集することは避けてください。キャッシュだけでなく、思考ブロックも無効になります。
会話を Haiku 5.5 からより大きなモデルに移せますか?
はい、会話そのものは引き継がれます。Haiku 5.5 の前のターンの思考ブロックが引き継がれるかどうかは移行先のモデルによるため、頼る前に Anthropic の preserved thinking のドキュメントを確認してください。
続けて読む: Claude Haiku 5.5 シリーズ
- 移行を計画する前に、新モデルが品質基準を満たすかどうかを知っておくと役立ちます。Haiku 4.5、GPT-6 Luna、Sonnet 5.5 との比較ベンチマークは、Claude Haiku 5.5 vs Haiku 4.5: What Ten Cents Now Buys をご覧ください。
- チェックリストのステップ2では effort レベルを選ぶよう求めています。各レベルのトークンコストと、どこから始めるべきかについては、Claude Haiku 5.5 Effort Levels: Medium Is the Default, Low Is Often Enough をご覧ください。
- トークナイザーの変更は、価格ラインとダッシュボードの両方に影響します。それが実際の請求額にどう影響するかは、Claude Haiku 5.5 Pricing: The 100K Line Behind the 90% Cut をご覧ください。
出典
- Claude Haiku 5.5 migration guide(Claude Platform Docs)
- Prompting Claude Haiku 5.5(Claude Platform Docs)
- Introducing Claude Haiku 5.5(Anthropic)
- Claude Haiku 5.5 on AIHubMix
- Claude Haiku 5.5 Is Out at $0.10 per Million Tokens. Read the 100K Rule Before You Migrate(Roo's Newsletter)



