「モデルIDを変えるだけでいい」——そう思っているなら、6月16日の朝に痛い目を見る可能性がある。
6月15日、claude-sonnet-4-20250514とclaude-opus-4-20250514が廃止される。廃止そのものは前日記事でも触れた。だが今日話したいのは「その先」だ。モデルIDを新しいものに変えた後で、なぜコードが壊れるのか。どのユースケースが危険か。6/16以降にエラーが出た場合、何を直せば動くのか。
この記事はその地図だ。
何が廃止されるか——一分でわかる概要
廃止対象と推奨移行先は次の通りだ。
| 廃止モデル | 推奨移行先 | 破壊的変更 |
|---|---|---|
claude-sonnet-4-20250514 |
claude-sonnet-4-6 |
なし(互換) |
claude-opus-4-20250514 |
claude-opus-4-8 |
temperature等廃止・Adaptive Thinking移行 |
Sonnet側は互換性が保たれているのでモデルID変更だけでよい。問題はOpusだ。
⚠️ 重要: 自動フォールバックはない
廃止後、旧モデルIDへのAPIコールは即エラーになる。移行先への自動切り替えは行われない。6/14中に対応を完了させるべきだ。
Opus 4.7/4.8の破壊的仕様変更3点
ここが本題だ。Opusのモデルを新しくすると、これまで問題なく動いていたコードが突然400エラーを吐き始める。原因は3つある。
① temperature・top_p・top_k が使えなくなった
非デフォルト値を指定すると400エラーが返る。「省略する(フィールドごと削除する)」が正解だ。
壊れるコード例:
# ❌ これは 400 エラーになる
response = client.messages.create(
model="claude-opus-4-8",
max_tokens=1024,
temperature=0.9, # ← 削除必須
top_p=0.95, # ← 削除必須
messages=[{"role": "user", "content": prompt}]
)
修正後:
# ✅ パラメータを削除するだけでよい
response = client.messages.create(
model="claude-opus-4-8",
max_tokens=1024,
messages=[{"role": "user", "content": prompt}]
)
なぜこの変更か。個人的な解釈を言うと、Anthropicは「出力の多様性制御はモデル内部で最適化する」方針に舵を切ったのだと思う。ユーザーが雑に触れる余地を減らし、モデルが責任を持つ設計だ。賛否はあるが、移行自体は単純だ。削除すればよい。
② Extended Thinking → Adaptive Thinking へ
Thinking budgetの手動指定が不要になった。Anthropicが自動で推論深度を決める。
# ❌ 旧: budget を手動指定
response = client.messages.create(
model="claude-opus-4-8",
max_tokens=16000,
thinking={
"type": "enabled",
"budget_tokens": 10000 # ← 削除してよい
},
messages=[...]
)
# ✅ 新: thinking を有効にするだけ
response = client.messages.create(
model="claude-opus-4-8",
max_tokens=16000,
thinking={"type": "enabled"},
messages=[...]
)
ストリーミングとExtended Thinkingを組み合わせていたケースは、出力ストリームの構造が変わっている可能性がある。動作確認を忘れずに。
③ Agent SDK課金モデルの変更
6月15日同日、claude -pやGitHub ActionsのAgent SDKがPro/Maxクォータから独立課金に移行する。これまでProプランのクォータ内に収まっていたAgent SDK利用が、別枠での請求になる。
Claude Code GitHub Actionsを使っているチームは今すぐClaude Consoleで使用量設定を確認し、予算上限を設定しておくべきだ。設定なしで放置すると、CI/CDが走るたびに課金が積み上がる。
「壊れやすさ」チェックリスト — あなたのコードは大丈夫か
以下に該当するコードがあれば、今すぐ確認を。
Creative writing系プロンプト
temperature=0.7〜1.0など明示指定しているケース。Opusへの移行時に全削除が必要。
RAGパイプライン
検索結果の多様性調整でtop_p/top_kを使っているケース。パラメータ削除後の出力変化を確認すること。
ストリーミング + Extended Thinking
budget_tokensの削除に加え、ストリーム処理のロジックも動作確認が必要。
Claude Code GitHub Actions
課金モデル変更により、CI/CD実行ごとに独立課金が発生するようになる。上限設定を確認。
6/16以降にエラーが出たときの復旧手順
もし6月16日の朝、本番でエラーが飛んできたとする。落ち着いて以下の順で対処すればよい。
-
エラーメッセージのモデルIDを確認する
model_not_foundまたはdeprecated_modelが出ていれば廃止モデルIDが原因だ。 -
モデル文字列を変更する
claude-sonnet-4-20250514→claude-sonnet-4-6
claude-opus-4-20250514→claude-opus-4-8 -
Opusへの移行ならパラメータを全削除する
temperature・top_p・top_k・budget_tokensを削除してデプロイ。 -
Claude ConsoleでAgent SDK使用量を確認する
課金先が変わっているため、予期しない請求が発生していないか確認する。
これで大半のケースは復旧できる。問題が続くなら公式のModel Deprecationsドキュメントを参照のこと。
残り4日でやること
4日あればコードの確認と修正は十分できる。今日やるべきことを一行で言う。
コードベースで claude-opus-4-20250514 と claude-sonnet-4-20250514 を検索し、全件置換した上でtemperature系パラメータを確認する。
Fable 5の反響に目を向けたくなる気持ちはわかる。だが今週は「移行を終わらせてから」だ。