◉CLAUDE LABEN
●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です●CC 2.1.330 — Claude Code 2.1.330 で、長い会話を圧縮した直後に数分固まる問題が直りました●SONNET 4.5 — Claude API の Sonnet 4.5 は 11/30 で提供終了、残り8日です。推奨の移行先は claude-sonnet-5-5 です●MCP 401 — MCP サーバーが 401 を返しても、エラーにならず無言でタイムアウトする、という報告が出ています●NEW — 新着:Desktop が毎回 worktree を作るとき、確かめる3か所●OPUS 4.5 — Opus 4.5 の 11/24 は「これより前には廃止しない」下限日で、廃止の告知ではありません●SCHEMA — Agent SDK と Messages API の構造化出力は、同じスキーマでも返り値の形を一度見比べると安心です
記事一覧/API & SDK
⬡ API & SDK/2026-06-15上級

Anthropic API のベータヘッダを一元管理し、機能の引退でバッチを止めない設計

anthropic-beta ヘッダを散らばったまま使うと、ベータ機能の引退や GA 昇格でバッチ全体が 400 で落ちます。ケイパビリティ登録簿と起動時プリフライトで、機能の世代交代に耐える小さな抽象化を実装します。

Claude API148Anthropic SDK5ベータ機能本番運用36レジリエンス3

✦ プレミアム記事

2026 年 6 月 15 日、API から Sonnet 4 と Opus 4 が引退し、同じ週に Fable 5・Mythos 5 がいったん利用停止になりました。モデル ID の差し替えはすぐ気づけますが、見落としやすいのが anthropic-beta ヘッダの方です。個人開発で続けている Dolice Labs の 4 サイトでは、記事の自動投稿をひとつのバックエンドが支えています。私自身、ある朝の夜間バッチが 1 件も完走していないことに気づきました。原因は、半年前に書いた context-1m-2025-08-07 というベータ識別子をまだ送り続けていた呼び出しで、ベータの提供窓が閉じた瞬間に 400 Bad Request を返すようになっていた、というものでした。

厄介なのは、この 1 行が特定の 1 リクエストではなく、同じヘッダを共有していた複数の呼び出しを巻き込んで落とした点です。ベータ機能は便利な反面、世代交代が速く、引退・GA 昇格・名称変更が数か月単位で起こります。ここではその変化を 1 か所で吸収するために、anthropic-beta を「ケイパビリティ登録簿」として抽象化し、起動時プリフライトと段階的フォールバックまで含めて実装します。

ベータヘッダ1行が、夜間バッチを丸ごと止めた

最初の実装は、よくある形でした。長文コンテキストとプロンプトキャッシュを使いたい呼び出しに、その都度ヘッダを直書きしていたのです。

# Before: 呼び出しごとにヘッダを直書き(各所にコピーされ、散らばっていく)
resp = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=4096,
    messages=messages,
    extra_headers={
        "anthropic-beta": "context-1m-2025-08-07,prompt-caching-2024-07-31"
    },
)

この書き方の問題は、同じ文字列が記事生成・要約・タグ付け・翻訳の各モジュールにコピーされ、最終的に 14 箇所へ増えていたことでした。context-1m-2025-08-07 が無効になったとき、私はそのうちのどこが該当するのかをすぐに言えませんでした。grep で探して 1 箇所ずつ直す間、バッチは止まったままです。1 回の夜間バッチの取りこぼしは翌朝の手動再実行で取り戻せますが、これが週 1〜2 回起きると、運用の信頼性そのものが揺らぎます。

なぜ「機能の引退」がヘッダ経由でパイプラインを壊すのか

anthropic-beta ヘッダは、まだ正式版になっていない機能を明示的に有効化するスイッチです。問題は、このスイッチが 3 つの異なる理由で「効かなくなる」ことにあります。

ひとつ目は引退です。1M コンテキストのように期間限定で提供されたベータは、窓が閉じると未知の識別子として扱われ、組み合わせによっては 400 を返します。ふたつ目は GA 昇格です。プロンプトキャッシュのように正式版へ移ると、ヘッダは不要になります。多くの場合は当面そのまま受理されますが、いつまでも残しておくのは将来の拒否リスクを抱え込むだけです。みっつ目は名称・日付の変更で、code-execution-2025-05-22 のように日付入りの識別子は、仕様改定で新しい日付版へ差し替わることがあります。

共通するのは、いずれも「コード側が知っている世界」と「API が受け付ける世界」がずれた瞬間に壊れる、という構造です。だからこそ、ヘッダ文字列を散らさず、世代交代を 1 か所で表現できる形にしておく価値があります。

✦

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦anthropic-beta ヘッダを Capability 列挙とレジストリに集約し、14箇所の指定を1ファイルへ畳む手順
✦起動時プリフライトで未対応ベータを検出し、その機能だけを無効化して残りを走らせる実装
✦ベータの引退・GA 昇格・407 系エラーに対する3段階フォールバックと、無効化履歴の残し方
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Claude Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

⬡ API & SDK2026-05-24
Claude API のレスポンスを Cloudflare R2 にアーカイブする実装メモ — 監査・再現性・障害分析の3軸設計
Claude API のリクエストとレスポンスを Cloudflare R2 に保存して、監査・障害分析・本番リプレイの3つに使う設計を、Workers の waitUntil パターンと D1 メタデータインデックス込みで実装メモにまとめました。
⬡ API & SDK2026-05-04
Bun × Claude API で本番運用するエッジAIサービス — Node.js移行の判断軸と落とし穴を回避する実装パターン
Claude APIをBun上で本番運用するための実装ガイド。Node.jsからの移行判断軸・組み込みSQLite/WebSocketの活用・ストリーミング最適化・典型的な落とし穴の回避策まで、動作するコードと実測値で解説します。
⬡ API & SDK2026-04-30
Claude API で多言語翻訳 SaaS を本番運用する設計ガイド — 用語集・スタイル・ドメイン適応の実装
多言語翻訳SaaSをClaude APIで本番運用するための設計を通しで解説します。タグやプレースホルダーを失わせない前処理、用語集の注入と強制、スタイルガイドによるトーン制御、Few-shotでのドメイン適応、品質ゲートとコスト最適化まで、具体的なコードと運用ノウハウでまとめました。