Claude Platform の Messages API に Message Threads が public beta で追加された。コーディングエージェントや computer use、画像・ドキュメントを積み上げるワークフローなど、1 セッションで会話が肥大化する API 利用者向けで、毎ターン全会話を再送せず time to first token(TTFT)を下げる。

利用は public beta。ネイティブ Claude Platform のほか、Claude Platform on AWS、Claude in Microsoft Foundry、Claude Models on Google Cloud(Anthropic 管理)で提供される。リクエストごとに message-threads-2026-08-12 beta ヘッダーが必要。トークン単価とレート制限は従来どおりで、threads 専用の加算はない。

#リクエストの形

  • 初回: これまでどおり system・tools・全会話を載せ、thread に {"type": "create"} を付ける。応答の id が次ターンのキーになる。
  • 継続: 前ターン以降のメッセージだけを送り、thread に {"type": "continue", "previous_message_id": "<直前応答 id>"} を付ける。system と tools は thread が create 時の値を保持するため省略する。
  • SDK では client.beta.messages.thread(...) のヘルパーが create / continue と beta ヘッダーを組み立てる。

サーバー側は thread をメモリ上に暗号化して保持し、永続ストレージには書かない。最終リクエストから 5 分で失効し、最長 1 時間以内に削除される。失効後は全会話を載せた create で thread を張り直す。continue で thread を復元できないときは 404(thread_not_found)となり、クライアント側は全会話の再送経路を用意する必要がある。応答が保存されたかは次の continue まで分からないため、アプリ側でも全会話のコピーを保持する。

#効果と課金

毎ターンのリクエストボディは小さくなるが、モデルが参照する文脈は従来どおり全会話であり、入力トークン使用量は変わらない。Claude Code 利用者向けの社内計測では、500k〜1M トークン規模のリクエストで TTFT 中央値がおおよそ 35% 低下したとされる。

#向く利用と制約

  • 長時間のツールループ、スクリーンショットを積む computer use、大きな添付を繰り返すセッション。
  • Message Batches、thread 付きトークンカウント、compaction、HIPAA readiness 有効 org、Inference hooks 有効 org では利用不可(400 thread_unsupported_request 等)。
  • Message threads は Zero Data Retention 対象外。Claude Managed Agents の session threads とは別機能。
  • thread の一覧・読取・削除 API はない。

#参考文献