Claude APIのmessage threadsとは|使い方・5分期限・料金

Claude APIのmessage threadsとは|使い方・5分期限・料金
📅 公開日: 2026年11月4日🔄 最終更新: 2026年11月5日

message threadsは、Claude APIの長い会話で、2回目以降のリクエストに新しいメッセージだけを送れるようにする機能です。公開ベータで、使うにはベータヘッダ message-threads-2026-08-12 が要ります(公式リリースノート)。

スレッドは最後のリクエストの5分後に期限が切れ、遅くとも最後の使用から1時間以内に削除されます。料金とレート制限は変わりません(公式の説明書)。

この記事では、仕組み、使い方、5分で切れたときの戻し方、料金とデータの扱い、向き不向きを順に整理します。確認日は2026年11月3日です。ベータの内容は変わるため、作業の前にリンク先を見直してください。

目次

この記事の読者向け・無料

ChatGPT・Gemini・Claude 仕事別の使い分け実践キット

ChatGPT・Gemini・Claude 仕事別の使い分け実践キットの表紙

中身

  • ChatGPT・Gemini・Claude を仕事別に選ぶ表
  • 目的→機能→入力の許可→比較の順番
  • 有料プランを考える前の確認
  1. 下のボタンから LINE を友だち追加
  2. トークで「AIの使い分け」と送る
  3. ChatGPT・Gemini・Claude 仕事別の使い分け実践キットが自動で届きます

友だち追加は無料です。届いた後はいつでもブロックできます。

LINEで「AIの使い分け」を受け取る

message threadsとは|結論と確認日

LINEでインスタ大学の受取案内を見る

LINEでインスタ大学の受取案内を見る

インスタ大学の受取案内をLINEで確認できます。

LINEでインスタ大学の受取案内を見る

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のヘルパーで始める手順

message threadsをSDKのヘルパーで始める手順を、ヘルパーを作る、最初の発言を送る、次の発言を送る、返答を取り出すの4段で示した図。
ヘルパーで始める4つの手順

いちばん簡単な始め方は、SDKのスレッドヘルパーを使うことです。ヘルパーは、createとcontinueの切り替え、ベータヘッダの付与、期限切れ後の送り直しを代わりに行います。

公式の説明書には、Python、TypeScript、C#、Go、Java、PHP、Rubyの例があります。Pythonでは client.beta.messages.thread(...) でヘルパーを作り、thread.send(...) で1ターンずつ送ります。

  1. モデル、max_tokens、system を指定してヘルパーを作る。この時点ではリクエストは送られない
  2. 最初のユーザー発言を send する。ヘルパーがスレッドを作り、全文を送る
  3. 次の発言を send する。ヘルパーが新しい分だけを送る
  4. 返答の content から、種類が text のブロックを取り出して表示する

最上位の cache_control は任意です。付けると各ターンでプロンプトキャッシュを求められます。付けない場合も、新しいメッセージだけが送られる点は変わりません(公式の説明書)。

キャッシュの考え方は、Claude APIのプロンプトキャッシュの記事で別にまとめています。

cURLなどで自分でリクエストを組む場合は、スレッドの全リクエストに anthropic-beta: message-threads-2026-08-12 を付けます。

毎ターン何を送るか|変えてはいけない項目

continueで送る項目は3種類に分かれます。createだけで送るもの、毎回同じ値で送るもの、ターンごとに変えてよいものです。決まりを外すと400エラーになります。

区分項目ルール
createのみsystem、toolscontinueで送ると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が出たら全文を送り直す

続きのリクエストが404になったときに、全文を送り直して新しい応答のIDから続ける3段の流れを示した図。
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が必要でないかを確かめてください。

最新の内容は、公式の説明書とリリースノートで確認できます。

このサイトは株式会社S.Lineが運営しています。記事内の店舗予約・LINE登録・講座の案内には、当社または当社が集客を担当するサービスの広告(PR)が含まれます。
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

株式会社S.Line 代表取締役。偏差値39から起業し、AIとSNSの活用で「普通の人」が成果を出す方法を発信。

目次