message threadsは、Claude APIの長い会話で、2回目以降のリクエストに新しいメッセージだけを送れるようにする機能です。公開ベータで、使うにはベータヘッダ message-threads-2026-08-12 が要ります(公式リリースノート)。
スレッドは最後のリクエストの5分後に期限が切れ、遅くとも最後の使用から1時間以内に削除されます。料金とレート制限は変わりません(公式の説明書)。
この記事では、仕組み、使い方、5分で切れたときの戻し方、料金とデータの扱い、向き不向きを順に整理します。確認日は2026年11月3日です。ベータの内容は変わるため、作業の前にリンク先を見直してください。
この記事の読者向け・無料
ChatGPT・Gemini・Claude 仕事別の使い分け実践キット

中身
- ChatGPT・Gemini・Claude を仕事別に選ぶ表
- 目的→機能→入力の許可→比較の順番
- 有料プランを考える前の確認
- 下のボタンから LINE を友だち追加
- トークで「AIの使い分け」と送る
- ChatGPT・Gemini・Claude 仕事別の使い分け実践キットが自動で届きます
友だち追加は無料です。届いた後はいつでもブロックできます。
LINEで「AIの使い分け」を受け取るmessage threadsとは|結論と確認日
message threadsとは、Messages APIの会話をサーバー側に預け、次のリクエストでは新しいメッセージだけを送る機能です。リクエストが小さくなり、最初のトークンが出るまでの時間(TTFT)が短くなります。
公式の説明書は、スレッドなしでは毎ターン会話の全文を送り直し、APIがそのたびに検証とトークン化をやり直すと書いています。スレッドありなら、その作業の大半は新しいターンの分だけで済みます(公式の説明書)。
先に要点だけ並べます。
- 最初のリクエストで会話を預け、以降は新しいメッセージだけを送る
- ベータヘッダは
message-threads-2026-08-12 - 期限は最後のリクエストから5分、削除は最後の使用から1時間以内
- 料金とレート制限は変わらない
- ZDR(ゼロデータリテンション)の対象外
仕組み|最初に全文、次からは差分だけ
スレッドは、最初のリクエスト(create)で会話を預け、2回目以降のリクエスト(continue)で前の応答のIDを指定して続ける仕組みです。続きでは新しいメッセージだけを送ります。
createでは、これまでどおり会話の全文、system、tools を送り、"thread": {"type": "create"} を足します。APIはClaudeの返答まで含めて、応答の id のもとに保存します。
continueでは、前の応答以降のメッセージだけを送り、"thread": {"type": "continue", "previous_message_id": "<前のid>"} を足します。system と tools は送りません。スレッドが最初の値を保持しています(公式の説明書)。
次のターンでは、毎回、新しい応答の id を使います。同じ応答のIDから続けられるのは1回だけです。
3ターンの流れ(仮の例)
サポート窓口のチャットを作る場合の、仮の例です。送る中身は公式の説明書の流れに合わせています。
| ターン | 送るもの | threadの指定 |
|---|---|---|
| 1回目 | system、tools、最初のユーザー発言 | create |
| 2回目 | 2つ目のユーザー発言だけ | continue(1回目の応答のid) |
| 3回目 | 3つ目のユーザー発言だけ | continue(2回目の応答のid) |
ツールを使うなら、新しいメッセージは tool_result ブロックから始まります。これは公式の説明書にある使い方です。
使い方|SDKのヘルパーで始める手順

いちばん簡単な始め方は、SDKのスレッドヘルパーを使うことです。ヘルパーは、createとcontinueの切り替え、ベータヘッダの付与、期限切れ後の送り直しを代わりに行います。
公式の説明書には、Python、TypeScript、C#、Go、Java、PHP、Rubyの例があります。Pythonでは client.beta.messages.thread(...) でヘルパーを作り、thread.send(...) で1ターンずつ送ります。
- モデル、
max_tokens、systemを指定してヘルパーを作る。この時点ではリクエストは送られない - 最初のユーザー発言を
sendする。ヘルパーがスレッドを作り、全文を送る - 次の発言を
sendする。ヘルパーが新しい分だけを送る - 返答の
contentから、種類がtextのブロックを取り出して表示する
最上位の cache_control は任意です。付けると各ターンでプロンプトキャッシュを求められます。付けない場合も、新しいメッセージだけが送られる点は変わりません(公式の説明書)。
キャッシュの考え方は、Claude APIのプロンプトキャッシュの記事で別にまとめています。
cURLなどで自分でリクエストを組む場合は、スレッドの全リクエストに anthropic-beta: message-threads-2026-08-12 を付けます。
毎ターン何を送るか|変えてはいけない項目
continueで送る項目は3種類に分かれます。createだけで送るもの、毎回同じ値で送るもの、ターンごとに変えてよいものです。決まりを外すと400エラーになります。
| 区分 | 項目 | ルール |
|---|---|---|
| createのみ | system、tools | continueで送ると400エラー(null でも同じ) |
| 毎回同じ値 | model、tool_choice、thinking、context_management、output_config、最上位の cache_control、anthropic-beta の値の組 | 違うと thread_fingerprint_mismatch の400エラー |
| 変えてよい | max_tokens、stop_sequences、stream、metadata、service_tier | ターンごとに変えられる |
表は公式の説明書「What to send on each request」の内容です。
途中で model や thinking を変えたいときは、新しいスレッドをcreateで始めます。MCPサーバーのURLや認可トークン、コンテナのIDはAPIが保存しないため、使うリクエストごとに送ります。
5分で期限が切れたとき|404が出たら全文を送り直す

スレッドは最後のリクエストから5分で期限が切れます。続きのリクエストが404(thread_not_found)を返したら、手元の会話の全文を新しいcreateで送り直し、その応答のIDから続けます。
公式の説明書によると、スレッドはベストエフォートです。期限は最後のリクエストの5分後で、APIは最後の使用から1時間以内に削除します。保存された応答があるたびに、5分は数え直されます(公式の説明書)。
404は期限切れだけで出るわけではありません。公式が挙げる原因には、次のものがあります。
- 前のターンをAPIが保存していなかった(例:
max_tokensで途切れたツール呼び出し) - 前の応答がまだ生成中だった
- 別の組織やワークスペース、別のユーザーやサービスアカウントからのリクエストだった
- フォールバックのモデルが前の応答を書いた
応答には、保存されたかどうかが書かれていません。次のcontinueで分かる作りなので、アプリ側が会話の全文を自分で持ち、送り直しの手順を最初から用意します。
SDKのヘルパーは、thread_not_found などが返ると全文を1回だけ送り直します。ただし、ヘルパーが会話を持つのはメモリ上だけです。プロセスをまたぐ会話は、自分で保存してください。
実践用の「ChatGPT・Gemini・Claude 仕事別の使い分け実践キット」を無料で配布しています。LINE で「AIの使い分け」と送ると届きます。LINEで受け取る
料金とレート制限|変わらないのは何か
スレッドを使っても、料金とレート制限は変わりません。公式の説明書の「Pricing and rate limits」に、そう書かれています。
Claudeは各ターンで会話の全文を読むため、トークンの使用量も変わりません。小さくなるのはリクエストの大きさで、料金の中身ではないという整理です(公式記事)。
速度については、公式記事に条件付きの数字があります。Claude Codeの多くのユーザーでスレッドが既定でオンになっており、50万〜100万トークンのリクエストで、TTFTの中央値がおよそ35%下がったと書かれています(公式記事)。
この数字は、その条件での観測です。ご自身の環境で同じになるとは限りません。既定オンの対象条件(バージョンやプラン)は、公式記事に記載がありません。
Claude Codeでの使用量とコストの見方は、Claude Codeの使用量とコストの確認方法で確認できます。
データの扱い|ZDR対象外の意味
message threadsは、ZDR(ゼロデータリテンション)の対象外です。ZDRの契約で使っている組織は、この機能の利用を決める前に、データの扱いを確認する必要があります。
公式の説明書は、スレッドの中身(会話、system、tools)をメモリ上に置き、サーバー管理の鍵で暗号化し、永続的な保存先には書かないと説明しています。削除は最後の使用から1時間以内です(公式の説明書)。
この機能を使っても、ほかのZDR対象の機能の扱いは変わらないとも書かれています。ファイルは参照として持つため、スレッドを使う間は、会話が使うファイルを手元で残しておく必要があります。
使うかどうかの判断|向く場合と向かない場合
message threadsは、長い会話やエージェントのループで、ターンが続けて来る使い方に向きます。ZDRが必須の場合や、ターンの間隔が5分を超えやすい場合は、向きません。
公式の説明書は、スレッドが最も効くのは長いエージェントのループだと書いています。その前提で、判断の目安を表にします。
| 状況 | 判断 | 根拠 |
|---|---|---|
| 長い会話でターンが続けて来る | 向く | 毎回の全文送信が不要になる |
| ZDRで運用している | 向かない | ZDR対象外と明記されている |
| ターンの間隔が5分を超えやすい | 効果が薄い | 期限切れで全文の送り直しになる |
| 途中で古いターンを要約に置き換えたい | 新しいスレッドが必要 | スレッドは追記のみ。要約からの新規作成になる |
| スレッドを一覧・取得・削除したい | できない | そのためのAPIがない |
表の最後の2行は、公式の説明書の「Compact a conversation」と「Limitations」の記載です(公式の説明書)。
提供先は4つで、いずれもベータです。対象は、Claude APIとClaude Platform on AWSです。あとはClaude Models on Google Cloud(Anthropic managed)とClaude in Microsoft Foundryです。
モデルは、Claude Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.1などが対応一覧に載っています。
モデルごとの違いは、Claude Opus 5.5とはとClaude Sonnet 5.5とはで確認できます。
よくある質問(FAQ)
- Q1. message threadsを使うには何が必要ですか?
- ベータヘッダ
message-threads-2026-08-12を、スレッドの全リクエストに付けます。SDKのヘルパーは、このヘッダを自動で付けます。 - Q2. スレッドはいつ切れますか?
- 最後のリクエストから5分で期限が切れ、最後の使用から1時間以内に削除されます。切れた後のcontinueは404になるため、全文を送り直します。
- Q3. 料金は安くなりますか?
- 変わりません。公式の説明書は、スレッドが料金とレート制限を変えないと書いています。Claudeは毎ターン全文を読むため、トークン使用量も同じです。
- Q4. ZDRの組織でも使えますか?
- 使えません。message threadsはZDRの対象外と、公式の説明書に書かれています。
- Q5. 会話の途中でモデルを変えられますか?
- 同じスレッドでは変えられません。
modelは毎回同じ値で送る項目です。変えるなら新しいスレッドをcreateで始めます。 - Q6. Claude Codeでは何か設定が要りますか?
- 公式記事は、多くのClaude Codeユーザーで既定オンと書いています。対象のバージョンやプランの条件は、公式記事に記載がありません。
読み終わったら、手元に残す
ChatGPT・Gemini・Claude 仕事別の使い分け実践キット
中身
- ChatGPT・Gemini・Claude を仕事別に選ぶ表
- 目的→機能→入力の許可→比較の順番
- 有料プランを考える前の確認
LINE を友だち追加して「AIの使い分け」と送ると、無料で届きます。
LINEで「AIの使い分け」を受け取るまとめ
message threadsは、長い会話の2回目以降を、新しいメッセージだけで送れるようにするベータ機能です。料金とレート制限は変わらず、ZDRの対象外です。
使う前に、アプリが会話の全文を持っているか、5分より空くターンが多くないか、ZDRが必要でないかを確かめてください。
最新の内容は、公式の説明書とリリースノートで確認できます。
あわせて読みたい・姉妹メディア

