Claude APIに「会話スレッド」　長い会話を毎回送り直さず答えが早く返る

米Anthropicは日本時間11月3日、Claudeを呼ぶ「Messages API」に、会話をサーバー側に短時間預ける「メッセージスレッド」を公開ベータで加えたと開発者向けの公式アカウントがXで発表した。これまでAPIは毎回、過去の会話をすべて受け取り直していた。スレッドを使うと、2回目からは新しいメッセージと前の応答のIDだけを送ればよい。会話が長いエージェントほど、Claudeが答え始めるまでの待ちが短くなる。ただし使うトークンの量と料金は変わらず、速さのための仕組みだと押さえておきたい。

長い会話ほど待ちが縮む

これまでのMessages APIは会話の状態を持たず、呼ぶ側が毎回、過去のやり取りを全部送っていた。Anthropicの紹介記事によると、コーディングエージェントは1回の作業で数百回もAPIを呼び、そのたびに過去のメッセージと道具の結果を送り直す。会話が数十万トークンに育つと、この送り直しだけで答え始めが遅れる。

スレッドでは、前の回から増えた分だけを送る。公式の説明書は、送り直しがなくなれば、API側で会話を確かめ直したりトークンに分け直したりする手間も新しい回の分だけになると説明している。紹介記事によると、多くのClaude Codeの利用者ではすでに既定でスレッドが使われており、50万〜100万トークンのリクエストで、答え始めるまでの時間の中央値がおよそ35%縮んだ。

向くのは、待ち時間が効く動いている最中の会話だ。紹介記事は、道具の結果やファイルの編集で会話が伸び続けるコーディングエージェント、画面の画像を毎回上げ直さずに済む画面操作のエージェント、文書や画像の多い処理を挙げている。

使い方はパラメーター1つ

使い方は、リクエストに「thread」というパラメーターを1つ足すだけだ。説明書によると、最初の回はいつもどおり会話の全体とシステムプロンプト、道具の定義を送り、threadの項目にtypeを「create」と書いて付ける。次の回からは、増えたメッセージと、typeを「continue」にしたthread、前の応答のIDを送る。システムプロンプトと道具の定義は最初の回の値が残るので、2回目からは送らない。送ると400のエラーになる。

各リクエストには、ベータの印としてmessage-threads-2026-08-12という名前のヘッダーが要る。モデルや思考の設定など一部の項目は、スレッドの途中で変えられない。変えたい時は新しいスレッドを始める。SDKにはスレッドを扱う補助の機能があり、ヘッダーの付与や送り直しを肩代わりする。

対象のモデルは、説明書によるとすべてのモデルだ。提供先は、Anthropic自身のAPIに加え、AWS上のClaude Platform、Microsoft Foundry、Google Cloudの一部でもベータで使える。

5分で消える前提で組む

ただし、預けた会話は長く残らない。説明書によると、スレッドは最後のリクエストから5分で期限が切れ、最後に使ってから1時間以内に消される。期限切れのほか、別のAPIキーからの呼び出しや、途中で別のモデルに切り替わった応答の後なども続きを受け付けず、404のエラーが返る。その時は、手元に残した会話の全体を送り直して新しいスレッドを始める。だから説明書は、会話の原本は呼ぶ側が持ち続け、最初から送り直しの道を組んでおくよう求めている。

使えない機能もある。まとめて投げる「Message Batches」、トークン数の計算、会話を要約して縮める「compaction」は、スレッドと一緒に使えない。会話は暗号化してメモリーに置き、ディスクには書かないというが、データを残さない契約（ZDR）の対象には入らない。

料金は、紹介記事によると通常のトークン単価と今のレート制限のままだ。Claudeは毎回会話の全体を読むので、使うトークンの量も変わらない。キャッシュも自動では掛からず、トークン代を下げたい時は、これまでどおりプロンプトのキャッシュを自分で指定する。

要は、メッセージスレッドはトークン代を下げる仕組みではなく、長く動くエージェントの待ちを縮める仕組みだ。

編集部の見方

自前でClaudeのAPIを呼ぶエージェントを動かしている人には、試す価値が高い。待ちが縮むのは、会話が長く、間を空けずに呼び続ける場面だけで、5分空けば送り直しになる。一方、費用が減るわけではないので、請求額を下げたいならキャッシュの設定を見直すほうが先だ。導入するなら、まず404を受けたら全部送り直す道をSDKの補助の機能で組み、普段のエージェントの1本で答え始めの時間を比べてから広げるのが手堅い。