こんにちは、あかりんです。このガイドは「Claude APIを使っているすべての開発者」向けです。特に claude-sonnet-4-20250514 や claude-opus-4-20250514 を本番環境で呼んでいる方は、6月14日(日)の夜までにこの記事の手順を完了してください。
Anthropicの過去3回のモデル廃止は全て予告日通りに実施されています。「たぶん延期されるだろう」は禁物です。6月16日(月)朝にAPIリクエストが全件エラーになってから慌てないために、今日一緒に進めてみましょう。
⏰ 廃止タイムライン
- 2026年6月15日(月):
claude-sonnet-4-20250514/claude-opus-4-20250514APIコール終了 - 同日: Agent SDK課金がPro/Maxのサブスクリプション枠の外に分離
- 6月16日(火)朝: 未対応の全APIリクエストがエラー応答を返す
はじめに——6月15日に何が起きるのか
今回の廃止は実質2つの変更がセットになっています。
変更1: モデルIDの廃止。claude-sonnet-4-20250514 と claude-opus-4-20250514 がAPIから削除されます。これらのIDをリクエストに含めると、6月15日以降は即座にエラーが返ります。
変更2: Agent SDK課金の分離。claude -p(CLIのPipelineモード)、Agent SDK、Claude Code GitHub Actionsなどの利用が、Pro/Maxの月次利用枠とは別の課金バケットに移動します。要するに、月$20払っていても「Agent SDK枠は別」という二重財布になります。
この2つを同時に対応するのがこのガイドの目的です。では、ステップごとに見ていきましょう。
廃止対象モデルIDと移行先の対応表
| 廃止モデルID | 移行先モデルID | 用途 |
|---|---|---|
| claude-sonnet-4-20250514 | claude-sonnet-4-6-20251120 | バランス型・コーディング・チャット |
| claude-opus-4-20250514 | claude-opus-4-8-20260528 | 高性能推論・複雑タスク |
エイリアス(claude-sonnet-4-6 のような最新版を指すエイリアス)を使うことも可能ですが、本番環境では固定バージョンIDを明示するのが推奨です。エイリアスは将来のモデルアップデートで自動的に切り替わり、出力品質が予告なく変わる可能性があります。
移行5ステップ(コード付き)
Step 1: 旧モデルIDをgrepで一括検索
まず「どこに旧IDが残っているか」を全ファイルで検索します。これが一番大事で、一番見落としやすいステップです。
# リポジトリのルートで実行
grep -rn "claude-sonnet-4-20250514\|claude-opus-4-20250514" . \
--include="*.py" \
--include="*.ts" \
--include="*.js" \
--include="*.json" \
--include="*.yaml" \
--include="*.yml" \
--include="*.env*" \
--include="*.sh" \
--include="*.toml" \
--include="*.md"
ここで迷いやすいのが「どのファイルを対象にすべきか」という点。上のコマンドは主要な拡張子を網羅していますが、プロジェクト固有の設定ファイル(.cfg、.iniなど)がある場合は --include に追加してください。
出力例:
./src/api_client.py:12: model="claude-sonnet-4-20250514",
./.github/workflows/review.yml:34: ANTHROPIC_MODEL: claude-sonnet-4-20250514
./scripts/summarize.sh:8:claude -p --model claude-sonnet-4-20250514
このように、コード・GitHub Actions・シェルスクリプトに分散して残っていることがよくあります。出力をテキストファイルに保存しておくと次のステップが楽になります。
grep -rn "claude-sonnet-4-20250514\|claude-opus-4-20250514" . > migration_targets.txt
cat migration_targets.txt
Step 2: モデルIDを1行更新
見つかった箇所を一括置換します。
# macOS(sed の -i には空文字列が必要)
find . -type f \( -name "*.py" -o -name "*.ts" -o -name "*.js" \
-o -name "*.yaml" -o -name "*.yml" -o -name "*.sh" \) \
-exec sed -i '' \
-e 's/claude-sonnet-4-20250514/claude-sonnet-4-6-20251120/g' \
-e 's/claude-opus-4-20250514/claude-opus-4-8-20260528/g' \
{} +
# Linux
find . -type f \( -name "*.py" -o -name "*.ts" -o -name "*.js" \
-o -name "*.yaml" -o -name "*.yml" -o -name "*.sh" \) \
-exec sed -i \
-e 's/claude-sonnet-4-20250514/claude-sonnet-4-6-20251120/g' \
-e 's/claude-opus-4-20250514/claude-opus-4-8-20260528/g' \
{} +
置換後、再度grepで残存がないか確認します。
grep -rn "claude-sonnet-4-20250514\|claude-opus-4-20250514" . && echo "⚠️ 旧IDが残っています" || echo "✅ 置換完了"
Step 3: Agent SDK課金バケットの影響を確認
6月15日から claude -p(Pipeline / Agent mode)の呼び出しが別課金になります。影響を受けるのは以下のいずれかを使っている場合です。
- CLIで
claude -pを呼ぶスクリプトやcronジョブ - Python/TypeScript SDK の
Agentクラス - Claude Code GitHub Actions
- claude.ai の Projects 機能の自動化
まず現在の使用箇所を洗い出します。
# CLI呼び出しの検索
grep -rn "claude -p\|claude --pipe" . --include="*.sh" --include="*.yml" --include="*.yaml"
# Python SDK の Agent 利用
grep -rn "from anthropic import.*Agent\|anthropic.Agent\|sdk.*agent" . --include="*.py"
# TypeScript SDK
grep -rn "from @anthropic-ai.*agent\|new Agent" . --include="*.ts" --include="*.js"
次に、自分のプランのAgent SDK月次クレジットを確認します(後述の早見表を参照)。月のどの時点でクレジットが枯渇しそうかを試算しておきましょう。
Step 4: ステージング環境で検証
モデルIDを更新したら、いきなり本番に当てる前に最低24〜48時間ステージングで動かしてみることを強くおすすめします。確認ポイントは3つです。
①出力品質の確認。Sonnet 4.6とSonnet 4(旧)では応答スタイルが微妙に変わっているケースがあります。特に厳密なフォーマット(JSON出力、特定の語尾・敬語)を求めているプロンプトは要チェックです。
②プロンプトキャッシュの再利用可否。モデルIDが変わるとキャッシュキーが変わります。大量のプロンプトキャッシュに依存しているサービスは、切替え直後にAPI応答コストが一時的に上昇する可能性があります。
③コンテキスト長・tool_choice の動作確認。新モデルのトークン上限・ツール呼び出しのフォーマットに変化がないかをサンプルリクエストで確認します。
# 簡単な動作確認スクリプト例(Python)
import anthropic
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-sonnet-4-6-20251120", # 移行後のモデルID
max_tokens=256,
messages=[{"role": "user", "content": "Hello, respond with 'Migration OK'"}]
)
print(response.content[0].text)
# → "Migration OK" が返れば接続確認完了
Step 5: CI/CDパイプラインと環境変数を忘れずに
最後にして最も見落とされるのがこのステップです。コードは直したのにCI/CDの設定が古いまま、というパターンが一番多い。
GitHub Actionsの場合。.github/workflows/ 以下のyamlを全て確認します。
# 検索
grep -rn "claude-sonnet-4-20250514\|claude-opus-4-20250514\|ANTHROPIC_MODEL" .github/
# 典型的な修正箇所(.github/workflows/review.yml など)
# Before:
# env:
# ANTHROPIC_MODEL: claude-sonnet-4-20250514
# After:
# env:
# ANTHROPIC_MODEL: claude-sonnet-4-6-20251120
環境変数の更新。本番・ステージング・開発環境それぞれの環境変数(.env ファイル、Secrets Manager、Vercel/Renderなどのダッシュボード設定)も確認します。
# .env.example / .env.template の更新
ANTHROPIC_MODEL=claude-sonnet-4-6-20251120 # 旧: claude-sonnet-4-20250514
クレジット上限アラートの設定。Agent SDK課金が分離されたことで、課金バケットが枯渇してもデフォルトでは通知されません。Anthropic Consoleでクレジット残量アラートを設定しておきましょう。
# Anthropic Console → Billing → Usage Alerts
# 推奨: 残量80%・50%・20%の3段階でメール通知を設定
プラン別Agent SDK課金上限と損益分岐点
「自分のプランで月何件処理できるか」を把握しておくと、課金枯渇の事前対策が立てやすくなります。
| プラン | 月額 | Agent SDKクレジット | 典型ユースケース別の枯渇目安 |
|---|---|---|---|
| Pro | $20 | $20相当/月 | ソロ開発者(週4プッシュ×PRレビュー): 3週目で枯渇リスク |
| Max 5x | $100 | $100相当/月 | 小チーム(2〜3名、中規模自動化): 概ね安全圏 |
| Max 20x | $200 | $200相当/月 | 中規模チーム(CI/CD本格活用): 余裕あり |
| Team Standard | $20/席 | $20相当/席/月 | 自動化多用チームは不足の可能性、追加購入を検討 |
| Enterprise Standard | 要交渉 | 0(別途購入必須) | Agent SDK利用は全額別途課金。今すぐ見積もりを |
| Enterprise Premium | 要交渉 | $200相当/席/月 | 大規模チームでも基本安全圏 |
Proプランの方へひとつ補足です。$20のAgent SDKクレジットは「月$20のAPI利用相当」であり、実際の消費速度はモデルと入力長に依存します。Sonnet 4.6レートで計算すると、典型的なPRレビュー1回で約$0.30〜$0.80の消費。週4プッシュ×4週だと$5〜$12で、複数プロジェクトを並行していると簡単に上限に達します。
よくある落とし穴3選
落とし穴1: .env ファイルの更新漏れ。コードは直したのに本番サーバーの環境変数が古いまま、というのが一番多いパターンです。デプロイ先(Vercel、Render、Fly.io、ECS、GCP Cloud Runなど)の環境変数設定画面を必ず確認してください。
落とし穴2: 複数リポジトリへの分散。モノレポでなくマイクロサービス構成の場合、サービスごとにリポジトリが分かれていることがあります。claude-sonnet-4-20250514 の検索を各リポジトリで実行してください。組織全体での管理にはGitHub の Code Search(org:yourorg claude-sonnet-4-20250514)が便利です。
落とし穴3: ログ・モニタリング設定の古いモデル名。DatadogやOpenTelemetryでモデル名をタグに使っている場合、ダッシュボードのフィルタ条件も合わせて更新しておかないと、移行後にメトリクスが取れなくなります。
まとめ——6月14日(日)の夜中に本番デプロイを終わらせよう
5つのステップを振り返ります。
- Step 1:
grep -rnで旧モデルIDを全ファイルから洗い出す - Step 2:
sedで一括置換し、再grepで確認 - Step 3: Agent SDK課金バケットの影響範囲を棚卸し、プラン別上限を把握
- Step 4: ステージングで24〜48時間の出力品質検証
- Step 5: CI/CD・環境変数・クレジット上限アラートを設定
一つひとつは難しい作業ではありません。でも「どこかに残っているかもしれない旧ID」を全て洗い出すのが、実はこの移行の最大の山場です。grepの結果をチームで共有して、6月14日(日)の夜までに本番デプロイを完了させましょう。
Anthropicの公式移行ガイドも合わせて参照してください。
参照: Anthropic — Models Migration Guide(公式)
関連記事
- 【2026年6月7日】AIニュース速報 — ホワイトハウスAI大統領令・Microsoft MAI発表・Claude API廃止あと8日・Gemini 3.5 Pro秒読み
- 【2026年6月7日】Claude最新情報 — Agent SDK課金損益分岐点・Microsoft MAI対Anthropic・Anthropic IPO SEC審査フェーズ