Claude プラットフォーム更新ログ 11 月 2 日:Messages API に message threads(メッセージスレッド)がベータ版として追加され、message-threads-2026-08-12 ベータヘッダーが必要になります。初回のリクエストでは、通常の通り完全な会話、system、tools を送信し、さらに "thread": {"type": "create"} を追加します。その後の各ターンでは、新しいメッセージと直前の応答の ID("type": "continue")のみを送信し、サーバー側で完全な会話を再構築してからモデルを呼び出します。スレッドは最後のリクエストから 5 分で期限切れとなり、遅くとも 1 時間以内に削除されます。Claude API、AWS 上の Claude Platform、Google Cloud 上の Claude Models(Anthropic ホスティング)、および Microsoft Foundry 上の Claude で利用可能です。
信頼度:高(80) · イベント時刻 2026-11-02
理由
- スレッドを使用しない場合、各ターンで会話全体を再アップロードする必要があり、API でも再検証とトークン化が行われます。数十から数百回のツール呼び出しを行うエージェントループでは、リクエストボディが肥大化し、最初のトークンまでの遅延(TTFT)が増大します。公式ドキュメントによると、スレッドを使用すると、大部分の処理が新しいターンのみに限定されるため、TTFT がより低く安定するようになります。
- これはプロンプトキャッシュを置き換えるものではありません:キャッシュブレークポイントは引き続き開発者が設定し、トップレベルの cache_control を使用して各ターンを自動的にキャッシュできます。両者を組み合わせることで、遅延とコストの両方を削減できます。
使い方
- リクエストヘッダーに anthropic-beta: message-threads-2026-08-12 を追加します。最初のターンでは thread: {type: "create"} を指定し、その後は thread: {type: "continue", previous_message_id: <直前の応答 ID>} を使用して新しいメッセージのみを送信します(system と tools は送信しません。送信すると 400 エラーが発生します)。公式 SDK には thread ヘルパーオブジェクトがあり、ベータヘッダーと 404 後のリプレイを自動的に処理します。ドキュメントは platform.claude.com/docs の「Message threads」ページを参照してください。
リスク
- スレッドは「ベストエフォート」です:期限切れ、バックアップモデルによる応答生成、ユーザーまたはワークスペースの変更などの状況では、continue リクエストが 404 を返すため、完全な会話で create を再実行する必要があります。したがって、アプリケーション側ではすべてのメッセージを保存し、リプレイロジックを事前に実装しておく必要があります。
- model、thinking、tool_choice などのフィールドは、スレッド全体を通じて変更してはなりません。変更すると thread_fingerprint_mismatch エラーが発生します。Opus 5.5 などのモデルでは、system や tools を変更すると既存の thinking ブロックが無効になります。ベータ段階では挙動が変更される可能性があります。