[開発者向け]Claudeの「メッセージスレッド」とは?長時間エージェントの応答開始を速くする新機能

目次

はじめに

 Anthropicは2026年11月2日、メッセージスレッド(message threads)の公開ベータを発表しました。Claude PlatformのMessages APIで、会話履歴を毎回送り直さずに差分だけを送れる機能です。長時間動くエージェントでは、応答が始まるまでの待ち時間を短くできます。仕組みと使い方、注意点を解説します。

参考記事

要点

  • Claude PlatformのMessages APIに、メッセージスレッドが公開ベータとして追加された。
  • 初回に会話全体を送ってスレッドを開始し、以降は新しいメッセージと直前の応答のIDのみを送る。
  • Claude Codeでは、50万〜100万トークンの要求でTTFTの中央値が約35%短縮された。
  • スレッドは最後の要求から5分で失効し、トークン使用量は従来と変わらない。
  • ネイティブのClaude Platformに加え、AWS、Microsoft Foundry、Google Cloud上の提供形態でも利用できる。

詳細解説

メッセージスレッドとは

 Anthropicによると、メッセージスレッドはMessages APIの新機能です。会話を一度送れば、その後のターンではAPIが新しい部分だけを受け取ります。現在はClaude Platformで公開ベータとして提供されています。

 Messages APIは、アプリやエージェントからClaudeを呼び出すための基本的なAPIです。これまでは要求のたびに、過去のメッセージやツール結果をすべて含めて送る必要がありました。エージェントは、AIがツールを呼び出しながら自分で作業を進める仕組みです。1回の作業で多くの要求を重ねるため、毎回の再送が積み重なります。

何が変わるのか:応答が始まるまでの時間

 コーディングエージェントは、1回のセッションで数百回の要求を送ることがあります。各要求には、それまでのメッセージとツール結果がすべて含まれます。会話が数十万トークンに達すると、その再送だけで応答開始が遅れます。

 メッセージスレッドでは、前回のターン以降に増えた分だけを送ります。これにより、最初のトークンが返るまでの時間(TTFT: time to first token)が短くなります。TTFTは、要求を送ってから応答の最初の部分が届くまでの待ち時間です。エージェントでは、この待ち時間がターンの数だけ積み重なります。

 Anthropicによると、Claude Codeの大半のユーザーではメッセージスレッドが既定で有効です。その環境で、50万〜100万トークンの要求ではTTFTの中央値が約35%短くなりました。

 この数値は、Claude Codeでの非常に長い要求を対象にした中央値です。トークンはAIが文章を処理する単位で、100万トークンはかなり大きな会話量にあたります。発表では、エージェントが持つコンテキストが多いほど短縮効果が大きくなるとしています。短い会話では、短縮幅は小さくなるとみられます。自分の用途での効果は、実際の要求サイズで測るのが確実です。

使い方:スレッドの開始から失効まで

 メッセージスレッドを使うには、Messages APIの要求に `thread` パラメータを加えます。流れは次のとおりです。

  1. 最初の要求に会話全体を含めて送り、スレッドを開始します。
  2. 2回目以降は、新しいメッセージと直前の応答のIDだけを送ります。
  3. スレッドは最後の要求から5分で失効します。失効後は、クライアントが会話全体を送り直して新しいスレッドを始めます。

 実装面では、クライアント側でも会話全体を保持し続ける必要があります。スレッドが失効したときに、全体を送り直せるようにするためです。人の承認待ちや長いテスト実行などで5分以上間が空くと、スレッドは失効します。発表には具体的なリクエスト例が含まれていないため、実装時は後述の公式ドキュメントで書き方を確認してください。

トークン使用量・料金・データの扱い

 メッセージスレッドを使うと、1回ごとの要求は小さくなります。ただし、Claudeは毎ターン会話全体を読み込みます。そのため、トークン使用量は従来と変わりません。料金は通常のClaudeのトークン料金で、既存のレート制限もそのまま適用されます。

 つまり、この機能の効果は待ち時間の短縮で、コスト削減ではありません。費用を抑えたい場合は、不要なツール結果を会話から外すなど、別の工夫と組み合わせることになります。

 スレッドはターンの間、メモリ上に保持されます。保持中は暗号化され、ディスクには書き込まれません。保持期間も最後の要求から5分と短く設定されています。社内規程でデータの保存場所を確認する必要がある場合、判断材料の一つになりそうです。

向いている用途

 Anthropicによると、メッセージスレッドは待ち時間が重要になる進行中のセッションに向いています。具体例は次の3つです。

  • 長時間動くコーディングエージェント:ツール結果やファイル編集のたびに会話が増えていく用途です。
  • コンピューター操作(computer use)エージェント:スクリーンショットがスレッドに残るため、毎ターン再アップロードせずに済みます。
  • 文書や画像を多く扱うワークフロー:要求のサイズを小さくできます。

 コンピューター操作(computer use)は、AIが画面を読み取り、クリックや入力を行う機能です。スクリーンショットは画像として会話に積み重なるため、再送の負担が大きくなりがちです。一方、短い質問と回答を繰り返すチャットボットでは、効果は限られるとみられます。

提供範囲と始め方

 メッセージスレッドは、次の環境で公開ベータとして利用できます。

  • ネイティブのClaude Platform
  • Claude Platform on AWS
  • Claude in Microsoft Foundry
  • Claude Models on Google Cloud(Anthropic managed)

 始め方は、Claudeの公式ドキュメントにあるメッセージスレッドのページで案内されています。公開ベータの段階のため、パラメータの仕様や挙動は今後変わる可能性があります。本番環境に組み込む場合は、失効時に会話全体を再送する処理を先に用意しておくと安全です。

まとめ

 メッセージスレッドは、長い会話を扱うエージェントの待ち時間を減らす機能です。トークン料金は変わらないため、効果は速度面に限られます。数十万トークン規模の会話を回すエージェントほど、効果を得やすい機能です。公開ベータのため、仕様の変化と5分の失効に備えながら試していくのが良さそうです。

この記事が気に入ったら
フォローしてね!

  • URLをコピーしました!
  • URLをコピーしました!
目次