トラブル対処 2026.04.22

claude-3-haiku-20240307がエラーを返し始めた原因と対処法

タグ：Claude / API / AI / トラブルシューティング / 生成AI

TL;DR

claude-3-haiku-20240307 を使ったAPI呼び出しが突然エラーを返すようになった事象が2026年4月に報告された
原因はモデルIDの廃止（サポート終了）によるもので、移行先モデルへの切り替えが必要
既存のコードを使い続けたい場合は、モデルIDを最新の文字列に書き換えるだけで解消できる

何が起きたのか

dev.toに投稿されたレポート（claude-3-haiku-20240307 just started returning errors — here’s what happened）によると、claude-3-haiku-20240307 というモデルIDを指定してAnthropicのAPIを呼び出していたユーザーが、ある日突然エラーレスポンスを受け取るようになった、という事例が報告されている。

コードに変更を加えていないのにエラーが出る、というのは開発者にとってかなり焦る状況だ。エラーメッセージだけ見ても原因がわかりにくく、自分のコードの問題だと思って調査時間を無駄にしてしまうケースも多い。

エラーが出るコードの例

以下のようなコードで claude-3-haiku-20240307 を指定しているとエラーになる。

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-haiku-20240307",  # ← このIDが問題
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude!"}
    ]
)

print(message.content)

エラーの原因：モデルIDの廃止

ソースによると、このエラーはAnthropicがモデルIDのサポートを打ち切ったことにより発生している。claude-3-haiku-20240307 は以前は有効なモデルIDだったが、現在はAPIが受け付けなくなっている。

Anthropicは時間の経過とともに古いモデルを段階的に廃止し、新しいモデルへの移行を求める運用を続けている。これはコスト・性能・安全性の観点から行われるものであり、一般的なクラウドサービスではよくある仕組みだ。

ただし、こうした廃止がいつ・どのモデルに適用されるかのアナウンスを見落としていると、今回のように突然エラーに直面することになる。

影響を受けるケース

以下のような状況では同じ問題に直面する可能性がある。

古いモデルIDをハードコード（直書き）しているコード
過去のチュートリアルやサンプルコードをそのまま使っているプロジェクト
しばらくメンテナンスしていないAPIを使った自動処理（バッチ処理など）

特に、長期間動かし続けている処理や、他の人が書いたコードをそのまま流用しているケースでは気づきにくい。ある朝突然アプリやスクリプトが動かなくなって初めて気づく、というパターンが多い。

対処法：モデルIDを最新のものに切り替える

解決策はシンプルで、モデルIDを現在サポートされているものに書き換えるだけだ。

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-5-haiku-20241022",  # ← 最新のHaikuモデルIDに変更
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude!"}
    ]
)

print(message.content)

利用可能なモデルIDはAnthropicの公式ドキュメント（https://docs.anthropic.com/en/docs/about-claude/models）で常に確認できる。コードに直書きするのではなく、環境変数や設定ファイルでモデルIDを管理しておくと、次回の廃止にも素早く対応できる。

モデルIDを環境変数で管理する例

import os
import anthropic

client = anthropic.Anthropic()

model_id = os.environ.get("CLAUDE_MODEL_ID", "claude-3-5-haiku-20241022")

message = client.messages.create(
    model=model_id,
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude!"}
    ]
)

print(message.content)

.env ファイルや実行環境の設定でモデルIDを管理すれば、コードを変えずにモデルの切り替えが可能になる。

既存ユーザーへの影響と今後の注意点

移行時の注意

モデルを切り替えた際、出力の文体・精度・返答の傾向が若干変わることがある。本番環境での切り替えは、テスト環境で動作確認してから行うのが安全だ。また、新しいモデルは入力や出力に対する料金が変わっている場合もあるため、コスト感の確認も合わせて行いたい。

廃止スケジュールを確認する習慣を

Anthropicは公式ドキュメントやAnthropicのステータスページでモデルのライフサイクル情報を提供している（※公式の廃止スケジュール通知の具体的な方法はソース未記載のため、公式ドキュメントを定期的に確認することを推奨）。今後も同様の廃止が続くと思われるため、定期的にドキュメントを確認する習慣を持っておくと安心だ。

試し方：現在使えるモデルIDの確認手順

Anthropicの公式モデル一覧ページにアクセスする
- https://docs.anthropic.com/en/docs/about-claude/models
現在サポートされているモデルIDの一覧を確認する
自分のコード内のモデルIDを一覧と照合する
廃止されたIDが使われていた場合、最新のIDに書き換える
テスト環境で動作確認してから本番に反映する