0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@kai_kou(甲斐 甲)

Claude Haiku 3 廃止前必読 — Haiku 4.5移行の破壊的変更と手順

0
Last updated at Posted at 2026-03-31

はじめに

Anthropicは2026年4月19日をもって、Claude Haiku 3（claude-3-haiku-20240307）のAPIサービスを終了します。
廃止まで残り約3週間。この日を過ぎると、同モデルへのAPIリクエストはすべてエラーになります。

この記事では、公式ドキュメントをもとに以下を解説します:

  • Haiku 3廃止の背景と影響範囲
  • 移行先: Claude Haiku 4.5 の新機能と性能向上
  • 破壊的変更の一覧と対応方法
  • Pythonコードの移行サンプル
  • 料金・レートリミットの変化

この記事の対象読者

  • Anthropic APIで claude-3-haiku-20240307 を使用しているエンジニア
  • Claude Haiku 4.5への移行を検討しているチーム
  • Anthropicモデルの移行ポリシーを把握したい方

TL;DR

  • claude-3-haiku-20240307 は 2026-04-19 に廃止（以降リクエストが失敗）
  • 移行先は claude-haiku-4-5-20251001
  • 破壊的変更: temperature と top_p の同時指定が不可、ツールタイプ識別子の変更など
  • Haiku 4.5 はSWE-bench 73.3%・Computer Use 50.7%と大幅に性能向上
  • 価格は $1/$5 per 1M tokens（Haiku 3.5比 +25%、ただし性能は大幅改善）

Claude Haiku 3 廃止の背景

Anthropicは2026年2月19日、claude-3-haiku-20240307 の廃止を正式アナウンスしました。
廃止日: 2026年4月19日〜20日（公式ページにより表記が1日ずれる場合があります。最新情報は公式ドキュメントを参照してください）。

Anthropicのモデル廃止ポリシーでは、公開モデルについては廃止の少なくとも60日前に通知を行うと定められており、今回の通知はこのポリシーに準拠しています。

廃止後に何が起きるか

廃止日以降、claude-3-haiku-20240307 を指定したAPIリクエストはエラーレスポンスを返します。
既存の本番環境への影響を避けるため、早急な移行対応が必要です。

廃止モデルを使っているかどうかは、Anthropic ConsoleのAPIアクセス監査機能で確認できます。

移行先: Claude Haiku 4.5

Anthropicが推奨する移行先は Claude Haiku 4.5（claude-haiku-4-5-20251001）です。

主要スペック

項目 Claude Haiku 3 Claude Haiku 4.5
モデルID claude-3-haiku-20240307 claude-haiku-4-5-20251001
コンテキスト窓 200K tokens 200K tokens
最大出力トークン 4K tokens 64K tokens
SWE-bench Verified — 73.3%
Computer Use (OSWorld) — 50.7%
Extended Thinking 非対応 対応
Computer Use 非対応 対応
Context Awareness 非対応 対応
入力料金 $0.25/1M $1.00/1M
出力料金 $1.25/1M $5.00/1M

価格は約4倍ですが、性能・機能は大幅に向上しています。

性能ハイライト

コーディング性能: SWE-bench Verified で 73.3% を達成。Claude Sonnet 4.5（77.2%）とわずか5ポイント差の性能を3分の1のコストで実現します1。

Computer Use: OSWorldベンチマークで 50.7% を達成。Sonnet 4（42.2%）を上回る性能をより低コストで提供します1。

Extended Thinking: HaikuモデルとしてはじめてExtended Thinkingに対応。複雑なコーディング・推論タスクでの精度が向上します。

Context Awareness: モデルが自身のコンテキスト消費量をリアルタイムで把握し、長い会話セッションで自動的に優先度の低い情報を圧縮するなど、タスク継続性が向上します。

破壊的変更（Breaking Changes）

Claude Haiku 3系から移行する際は、以下の破壊的変更に対応する必要があります。

1. モデルID変更（必須）

# 変更前
model = "claude-3-haiku-20240307"

# 変更後
model = "claude-haiku-4-5-20251001"

2. temperature と top_p の同時指定が不可（必須）

Haiku 4.5 では、temperature と top_p を同時に指定することがエラーになります。

# 変更前（Haiku 3では許容されていた）
response = client.messages.create(
    model="claude-3-haiku-20240307",
    temperature=0.7,
    top_p=0.9,  # 同時指定していた場合
    ...
)

# 変更後: どちらか一方のみ指定する
response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    temperature=0.7,  # temperature のみ指定
    ...
)

どちらを選ぶかは用途次第ですが、多くの場合 temperature のみで問題ありません。

3. 新しい refusal stop reason への対応（必須）

Claude 4.5 では、stop_reason に "refusal" が追加されています。
この値を処理しないと、予期しない動作になる可能性があります。

response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    ...
)

# 変更前（"end_turn" と "max_tokens" のみ処理していた場合）
if response.stop_reason == "end_turn":
    pass
elif response.stop_reason == "max_tokens":
    pass

# 変更後: "refusal" を追加
if response.stop_reason == "end_turn":
    pass
elif response.stop_reason == "max_tokens":
    pass
elif response.stop_reason == "refusal":
    # モデルが応答を拒否した場合の処理
    print("モデルが応答を拒否しました")

4. ツールタイプ識別子の変更（ツール使用時）

text_editor ツールなどのタイプ識別子が更新されています。
ツールを使用している場合は、公式マイグレーションガイドで最新のツールタイプ識別子を確認してください。

5. Extended output beta ヘッダーの廃止

過去に使用していた output-128k-2025-02-19 ベータヘッダーは Claude 4.5 では非サポートです。
Haiku 4.5 では標準で64Kトークンの出力が可能なため、このヘッダーは不要です。

# 変更前（ベータヘッダーを使用していた場合）
response = client.messages.create(
    model="claude-3-haiku-20240307",
    extra_headers={"output-128k-2025-02-19": "true"},  # 削除する
    ...
)

# 変更後: ヘッダー不要
response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=64000,  # 標準で最大64K
    ...
)

移行の全体手順

Step 1: 現在の使用状況を確認する

Anthropic Console の APIアクセス監査機能 を使用し、claude-3-haiku-20240307 を使用しているシステムをすべて特定します。

# Bashでもモデル使用状況を検索できます
grep -r "claude-3-haiku-20240307" ./src --include="*.py"

Step 2: 開発環境で移行テストを実施

import anthropic

client = anthropic.Anthropic()

# 移行後の基本的なリクエスト
response = client.messages.create(
    model="claude-haiku-4-5-20251001",  # モデルID変更
    max_tokens=1024,
    temperature=0.7,  # top_p との同時指定は不可
    messages=[
        {"role": "user", "content": "こんにちは。簡単に自己紹介してください。"}
    ]
)

# stop_reason の "refusal" を追加処理
print(f"stop_reason: {response.stop_reason}")
print(response.content[0].text)

Step 3: Extended Thinking の活用（オプション）

複雑な処理には Extended Thinking を有効化することを推奨します。

response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000  # 思考に使うトークン予算
    },
    messages=[
        {"role": "user", "content": "この関数のバグを特定して修正してください: ..."}
    ]
)

# thinking ブロックと text ブロックが返ってくる
for block in response.content:
    if block.type == "thinking":
        print("思考:", block.thinking)
    elif block.type == "text":
        print("回答:", block.text)

注意: Extended Thinking はプロンプトキャッシュの効率に影響します。キャッシュを多用している場合はExtended Thinkingのドキュメントを確認してください。

Step 4: 本番環境に反映

テストが完了したら、本番環境のモデルIDを更新します。
Claude Haiku 4.5 は Amazon Bedrock・Google Cloud Vertex AI でも同様に利用可能です。

レートリミットの変化

Claude Haiku 4.5 は Haiku 3 と別のレートリミットが設定されています。
現在のTierにおけるレートリミットはAnthropicの公式ドキュメントを参照してください。

高負荷なシステムでは、移行時に一時的にレートリミットに達する可能性があります。
リクエスト量が多い場合は、Anthropicサポートへ事前に相談することを推奨します。

コスト試算

価格は上昇しますが、Extended Thinkingやキャッシュを活用することでコストを最適化できます。

施策 削減率
プロンプトキャッシュ 最大90%
バッチ処理（Message Batches API） 50%
Extended Thinkingで再試行を削減 ユースケースによる

バッチ処理を活用すれば、Haiku 4.5 の実質コストは $0.50/$2.50 per 1M tokens まで削減可能です1。

まとめ

  • Claude Haiku 3 廃止日は 2026年4月19〜20日 — この日以降リクエストが失敗する
  • 移行先は claude-haiku-4-5-20251001 で、SWE-bench 73.3%・Computer Use 50.7%と大幅な性能向上
  • 破壊的変更の主要な対応点: モデルID更新・temperature/top_pの同時指定を解消・新しいstop_reasonの処理追加
  • Extended Thinking・Context Awarenessなど、新機能の活用でエージェント系ユースケースも強化

廃止まで残りわずかです。公式のMigration GuideとModel Deprecationsページも併せて確認し、早めに対応を進めましょう。

参考リンク

  1. Introducing Claude Haiku 4.5 および Claude Haiku 4.5 Deep Dive より（2026年3月時点） ↩ ↩2 ↩3

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?