この記事のポイント
- 長い会話を扱う開発者は、新しい発言だけを送るベータ機能を選べます。初回は履歴全体を送ります。
- 会話履歴をサーバー側で保持し、送信量と応答開始までの時間を抑える仕組みです。料金体系は変わりません。
- スレッドは最後のリクエストから5分で期限切れに。履歴を自社で保持し、再送できる設計が必要です。
Anthropicは2026年11月2日、Claude APIの「メッセージスレッド」をベータ公開しました。公式仕様を基に、会話履歴の送信方法と保存条件を整理します。
毎回の会話全体送信をやめ、新しい発言だけ送れるようにする
通常のMessages APIは、会話が続くたびに履歴全体を送り直します。メッセージスレッドは初回に履歴・指示・ツールの定義を送ると、APIがサーバー側で一時保持する仕組みです。2回目以降は、新しい発言と直前の応答IDを指定します。APIが履歴を組み立ててモデルに渡します。
リクエストが小さくなり、長い会話では応答開始までの時間を低く安定させるとAnthropicは説明しています。料金体系や利用量の上限は変わりません。履歴の送信量を減らす機能で、モデルに渡す会話内容や課金対象が新しい発言だけになるわけではありません。
対応はClaude API中心、ベータヘッダーの指定が必要
利用にはベータヘッダー「message-threads-2026-08-12」が必要です。対応先はClaude API、Claude Platform on AWS、Claude Models on Google Cloud（Anthropic管理）、Microsoft Foundryです。公式仕様では全モデルでベータ対応としています。
最後のリクエストから5分で期限切れとなり、最後の利用から1時間以内に削除されます。続行できず404が返ったら、新しいスレッドへ履歴全体を送り直します。保存は保証されないため、利用側も会話のコピーを保持する必要があります。
履歴はサーバー管理の鍵で暗号化してメモリ上に保持し、永続保存先には書き込みません。ただし、データを保持しないZDR契約の対象外で、米国医療情報保護のHIPAAにも非対応です。一括処理のMessage Batchesや一部の履歴圧縮機能などとも併用できません。
まとめ
自社でAIエージェントを開発する方は、長い会話の通信量を抑えたい用途と、必要な保存条件を照らして検討するとよいでしょう。OpenTelemetryによる処理の追跡と合わせると、応答の遅延を調べる観点も整理できます。
試す場合は、期限切れから履歴を再送する経路と、自社側の会話保存を先に用意するとよいでしょう。既存の会話管理を残したまま、効果と制約を確認しやすくなります。
※ 2026年11月2日発表の情報に基づきます。
