Claude API Message Threadsは、Messages APIが短期間の会話をサーバーに保持できるようにする機能です。これにより、後続の各ターンでは履歴全体を再送せず、新しいメッセージだけを送信します。2026年11月初旬に公開ベータとして発表されたこの機能は、長時間のエージェント実行でリクエストサイズと最初のトークンまでの時間を削減しますが、課金対象のトークン使用量はまったく変わりません。
コーディングアシスタントや複数ステップのツールループを構築したことがあれば、40ターン目の厄介さをご存じでしょう。モデルがコマンドを実行したりスクリーンショットを確認したりするたびに、クライアントはそれまでのプロンプト、応答、ツール結果をすべてまとめ、ネットワーク経由で丸ごと送り直します。Message Threadsは、この転送と検証のボトルネックに対するAnthropicの解決策です。ただし、有効化する前に設計上考慮すべき、5分での期限切れ、prompt caching、データ保持に関する厳格なルールがいくつかあります。
Claude API Message Threadsとは?
Message ThreadsはClaude Messages API向けのサーバー側会話キャッシュで、ベータ版ではヘッダー message-threads-2026-08-12 によって有効になります。すべてのAPI呼び出しをチャット履歴全体が必要な白紙の状態として扱う代わりに、サーバーがターン間で会話をメモリに保持するため、クライアントは前回の応答から変わった内容だけを送信します。
Anthropicの2026年11月2日のリリースノートとドキュメントによると、これはClaude Managed Agentsのセッションスレッドとは別のものです。ベータ版のすべてのモデルで /v1/messages に直接対応し、直接利用するClaude API、Claude Platform on AWS、Claude Models on Google Cloud(Anthropic管理)、Claude in Microsoft Foundryで利用できます。
ターン間、Anthropicはサーバー管理キーで暗号化したスレッドをサーバーメモリに保持し、永続的なディスクストレージには一切書き込みません。
Message Threadsで削減できるものと、できないものは?
Message Threadsは長い会話でネットワークへのアップロード量と最初のトークンまでの時間(TTFT)を削減しますが、課金されるトークン数は減らず、レート制限も変わりません。
エージェントのセッションが数十万トークンに膨らむと、これはコーディングループが大きなファイルを読んだり、コンピューター操作エージェントがスクリーンショットをやり取りしたりする場合によくありますが、毎ターンそのペイロードを再送して検証することで、モデルが生成を始める前に目立つ遅延が生じます。Anthropicによると、ほとんどのClaude Codeユーザーに対してMessage Threadsがデフォルトで有効になっており、500k〜1Mトークンを含むリクエストではTTFTの中央値が約35%低下します。
一方、請求額には影響しません。HTTPリクエストに最新のユーザーメッセージまたはツール出力しか含まれていなくても、Claudeは毎ターン会話全体を読みます。標準のトークン料金が適用されます。2026年11月時点で、Claude Opus 5.5の公表価格は入力100万トークンあたり$4(キャッシュ時は$0.20)、出力100万トークンあたり$20です。一方Sonnet 5.5は入力が$2(キャッシュ時は$0.10)、出力が$10です(各料金の比較はAI API料金比較とClaude Opus 5.5とSonnet 5.5の比較ガイドをご覧ください)。
| Message Threadsで変わること | 変わらないこと |
|---|---|
| 後続ターンのHTTPリクエストのペイロードが小さくなる | 毎ターン会話全体のトークンが読み取られ、課金される |
| 最初のトークンまでの時間が短くなる(Anthropicによると、Claude Codeの500k–1MトークンのリクエストでTTFT中央値が約35%低下) | 標準のAPIトークン料金と既存のレート制限 |
スレッド作成時に system と tools を一度送信する |
メッセージ履歴の正本は引き続きアプリが保持する |
スレッドを作成し、続けるには?
通常の /v1/messages リクエストに "thread": {"type": "create"} とベータヘッダー message-threads-2026-08-12 を付けてスレッドを開始し、次のターンでは応答の id を previous_message_id として渡して続行します。AnthropicのSDKを使う場合、ヘルパー client.beta.messages.thread(...) が作成から続行までを管理し、ベータヘッダーを自動的に付加します。
最初の create 呼び出しには、その時点までの会話全体と system、tools を含めます。
{
"model": "claude-sonnet-5-5",
"max_tokens": 2048,
"system": "You are a careful repository refactoring assistant.",
"tools": [
{
"name": "run_tests",
"description": "Run the project test suite",
"input_schema": { "type": "object", "properties": {} }
}
],
"thread": {
"type": "create"
},
"messages": [
{ "role": "user", "content": "Check why the auth test is failing." }
]
}
APIは、Claudeの応答を含む保存済みの会話を表す id(例:msg_01XYZ...)を持つ標準のメッセージ応答を返します。次のターンでは、tool_result やユーザーの次のプロンプトなど新しいメッセージだけを送り、その id を参照します。
{
"model": "claude-sonnet-5-5",
"max_tokens": 2048,
"thread": {
"type": "continue",
"previous_message_id": "msg_01XYZ..."
},
"messages": [
{
"role": "user",
"content": [
{
"type": "tool_result",
"tool_use_id": "toolu_01ABC...",
"content": "FAIL src/auth.test.ts: expected 200, got 401"
}
]
}
]
}
ドキュメントを読まないとつまずくルール
Anthropicはスレッドの存続期間を通じて厳密な一貫性を求めます。
- 作成時のみのフィールド: すべての
continueリクエストでsystemとtoolsを省略する必要があります。再送すると400エラーが返されます。 - 固定フィールド:
model、tool_choice、thinking、mcp_servers(各サーバーの認証トークンを除く)、context_management、output_config、コンテナースキル、トップレベルのcache_control、およびanthropic-betaヘッダー値の正確な組み合わせは、最初のcreate呼び出しと一致しなければなりません。いずれかを変更すると400のthread_fingerprint_mismatchエラーが発生します。 - ターンごとのフィールド:
max_tokens、stop_sequences、stream、metadata、service_tierはターンごとに自由に変更できます。 - 追記専用の履歴: 各応答の
idは一度しか続行に使えず、必ず最新の応答のidから続行する必要があります。以前のメッセージを編集したり会話を分岐したりする必要がある場合は、createで新しいスレッドを開始しなければなりません。
Message Threadの有効期間は?
Message Threadは最後のリクエストから5分後に期限切れとなり、最後の使用から遅くとも1時間以内にサーバーメモリから完全に削除されます。応答の保存に成功するたびに、5分のタイマーがリセットされます。
スレッドは揮発性メモリにベストエフォートのキャッシュとして保持されるため、特定のターンが保存に成功したかどうかをAPI応答が事前に知らせることはありません。わかるのは次の continue 呼び出しのときだけです。5分の猶予期間が過ぎた場合、またはサーバーがスレッドを早期に削除した場合、APIは 404 エラーを返します。
クライアントが 404 を受け取った場合、復旧方法は簡単です。会話履歴全体を(system と tools とともに)新しい "thread": {"type": "create"} リクエストで再送します。アプリケーションは正本であり続け、すべてのメッセージとツール結果の完全なコピーを独自に保持する必要があります。
Message Threadsとprompt cachingはどう連携する?
Message Threadsとprompt cachingは長いコンテキストの問題の異なる部分を解決します。スレッドを有効にしてもprompt cachingは自動的には有効になりません。Message Threadsはネットワーク経由でアップロードして検証するバイト数を減らし、prompt cachingは繰り返される入力トークンの料金を下げます(たとえば、AI API料金比較で詳しく説明しているように、Sonnet 5.5の入力トークンは100万あたり$2から$0.10になります)。
TTFTの高速化と入力トークン費用の削減を両方得るには、両方を有効にする必要があります。スレッド内の各ターンをキャッシュするには、最初の create リクエストにトップレベルの cache_control を含め、すべての continue リクエストでも同じトップレベルの cache_control を送り続けます(トップレベルの cache_control は、スレッド全体で一致しなければならない固定フィールドの一つです)。Anthropicは thread が設定されている場合、cache_control のブレークポイントを最大4つまで許可しています。
誰がMessage Threadsを有効にすべきか?
長期にわたるコーディングループ、コンピューター操作のワークフロー、または大量の文書を扱う複数ターンのエージェントを運用するチームが最も明確な恩恵を受けます。一方、厳格なコンプライアンス要件があるチームやバッチパイプラインを使うチームは、見送る必要があるかもしれません。ツールを使うループと通常のチャットボットの違いに初めて触れる方は、AIエージェントとは何かのガイドで基本を確認できます。
Message Threadsが特に適する場面:
- コーディングエージェント: ファイルを読み、コンパイラーを実行し、有効な5分間の枠内で何十回もの素早いターンを繰り返すループ。(AnthropicはすでにほとんどのClaude Codeユーザーに対してデフォルトで有効にしています。)
- コンピューター操作エージェント: 各ターンで新しいデスクトップやブラウザーのスクリーンショットを添付するワークフロー。以前のスクリーンショットをサーバーに保持すれば、ステップごとに数メガバイトのbase64画像データを再アップロードせずに済みます。
- 文書や画像の多いチャット: ユーザーが大きなPDFや画像セットをアップロードし、次々に追加質問をする対話型セッション。エージェントが外部のメディアパイプラインを統括する場合、たとえばAI Studioのようなツールでスクリプトを書いてレンダリングを開始する場合でも、重い計画コンテキストと参照画像をサーバー側のスレッドに保持すれば、調整ループの応答性を保てます。
2026年11月時点で利用がブロックされる、またはサポートされない場面:
- Zero Data Retention(ZDR)およびHIPAAの組織: Message ThreadsはZDRの対象ではなく、HIPAA対応を有効にしている組織は利用できません。
- サポートされないAPI機能:
threadはMessage Batches、threadを含むトークン数カウントリクエスト、オンデマンドの圧縮、ほとんどのコンテキスト編集戦略(clear_thinking_20251015とkeep: "all"の組み合わせを除く)、またはInference hooksを有効にした組織では使用できません。
私なら実際にこうする
Claude Messages API上のエージェント基盤を管理しているなら、コンプライアンス上の要件が許す限り、単一タスクが定期的に100kトークンを超え、ターン間隔が5分未満となるあらゆる場所でMessage Threadsを有効にします。私なら次のチェックリストに沿って導入します。
- ローカルの会話ストアはそのまま維持する。 サーバーに保持されたスレッドはあくまで転送の高速化手段として扱い、データベースとしては使いません。ユーザーの各ターン、アシスタントの応答、ツール結果はこれまでどおりローカルに追加します。
continueに自動の404フォールバックを組み込む。continue呼び出しが404を返したら(5分間のアイドル状態でも、ベストエフォートによる削除でも)、それを捕捉し、"thread": {"type": "create"}、system、toolsとともにローカルの履歴全体を直ちに再送します。- トップレベルの
cache_controlと組み合わせる。 請求額が下がると期待してMessage Threadsを有効にしてはいけません。createとcontinueの両方の呼び出しでトップレベルのcache_controlを設定し、TTFTの高速化とともにキャッシュ済み入力の90%以上の割引を得ます。AI API料金比較で、500kトークンにおけるキャッシュなしとキャッシュありの入力費用を試算してください。 - 作成時にスレッド設定を固定する。 エージェントループを監査し、タスクの途中で
tools、system、thinking、anthropic-betaヘッダーを動的に変更しないようにします。変更すると400のthread_fingerprint_mismatchエラーが発生します。 - まずZDRとHIPAAの設定を確認する。 ワークスペースがZero Data RetentionまたはHIPAA対応に依存している場合は、Message Threadsを無効のままにします。このベータ版はどちらの対象にもなりません。
よくある質問
Message ThreadsはClaude APIのトークン費用を下げる?
いいえ。後続の各HTTPリクエストには新しいメッセージしか含まれませんが、Claudeは毎ターン会話履歴全体を読みます。入力と出力の全トークンに標準のClaude料金が課金され、既存のレート制限も引き続き適用されます。繰り返されるコンテキストの入力トークン料金を下げるには、Message Threadsとprompt cachingを組み合わせてください。
Message Threadsを使う場合もprompt cachingは必要?
はい。Message Threadsは以前のメッセージをネットワーク経由で再アップロード、再検証せずに済むよう、会話をサーバーメモリに保持するだけです。prompt cachingは自動的に有効になりません。各ターンでキャッシュ済み入力の料金を適用するには、最初の create リクエストと後続のすべての continue リクエストにトップレベルの cache_control を送ります(ブレークポイントは合計最大4つ)。
5分間操作しないとどうなる?
Message Threadは最後のリクエストから5分後に期限切れとなります(最後の使用から遅くとも1時間以内にメモリから削除されます)。スレッドの期限切れ後に continue リクエストを送ると、APIはステータスコード 404 を返します。クライアントはその 404 を捕捉し、"thread": {"type": "create"} とともに会話全体を再送して新しいスレッドを開始する必要があります。
Message ThreadsはAWS、Azure、Google Cloudで利用できる?
はい。Anthropicの2026年11月2日のリリースノートによると、公開ベータ(message-threads-2026-08-12)は直接利用するClaude API、Claude Platform on AWS、Claude Models on Google Cloud(Anthropic管理)、Claude in Microsoft Foundryで利用できます。
Claude CodeはすでにMessage Threadsを使っている?
はい。Anthropicによると、Message ThreadsはほとんどのClaude Codeユーザーに対してデフォルトで有効になっており、500k〜1Mトークンのリクエストでは最初のトークンまでの時間の中央値が約35%短縮されます。
機能の詳細は2026年11月3日に最終確認。次回の確認:2026年12月3日。
出典
- Anthropic、Claude Platformリリースノート(2026年11月2日)、2026年11月3日確認
- Anthropic、Message Threadsで長時間稼働するエージェントを高速化、2026年11月3日確認
- Anthropicドキュメント、Message Threads(
message-threads-2026-08-12)、2026年11月3日確認 - LoTook、AI API料金比較、2026年11月3日確認



