Claude Messages API で、長時間の会話を行う「coding / computer-use」エージェントを実行する際、パブリックベータ版 メッセージスレッド 「歴史をあまり教えない=費用を抑えられる」と誤解されがちです。結論から言うと:Threads は遅延ツールであり、請求ツールではありません――これは主に、アップロードと重複検証による TTFT を削減するものです。モデルは引き続き対話全文を読み込み、トークンの使用量や料金体系に変更はありません。コスト削減は依然として プロンプトのキャッシュ(および圧縮、編集、トラフィック分散)。以下は公式資料の解説です(検証日:2026年11月5日、Asia/Shanghai)。当サイトの負荷テスト数値は含まれていません。
一言で判断
- Threads は何を解決するのか
- 長時間の対話において、各ラウンドごとに履歴全体を再送信することによるアップロード/検証の遅延。公式リソースによると、多くのClaude Codeのシナリオにおいて、約500k~1MトークンのリクエストにおけるTTFTの中央値は約35%低下する。
- Threadsでは解決されないこと
- 価格設定やレート制限を変更しません。プロンプトキャッシュを代行しません。セッションを永続的に保存しません。
- 請求額をどう削減するか
- 引き続きPrompt Caching(自動または明示的なブレークポイント)を使用し、必要に応じて要約の圧縮や編集戦略と組み合わせて活用してください。
まず区別しておく:遅延ツール vs 請求書管理ツール
Agentのループにおいて、各ループごとにsystem、tools、メッセージ全体を再度アップロードすると、ネットワークやサーバー側の検証処理に時間がかかりすぎる TTFT。「Message Threads」を使用すると、作成時に全データを送信し、その後の「continue」では新規メッセージと前回のレスポンスのみを送信できます。 id;APIは、サーバー側で会話を再構築してからモデルを呼び出します。
再構築は、「モデルが新しいメッセージのみを参照する」ということとは異なります。公式の説明には明確に記されています:リクエストのサイズは小さくなりましたが、 Claudeは依然として各ラウンドで対話全文を読み込み、トークンの使用量は変わらない;Threads 価格設定やレート制限を変更しない.
| 次元 | メッセージスレッド | プロンプトのキャッシュ |
|---|---|---|
| 主な収益 | アップロード/検証による TTFT の低減 | 重複するプレフィックスの課金対象入力数を削減する(キャッシュ読み取りはベース入力よりもはるかに少ない) |
| 明細書 | 公式発表:価格据え置き。利用量は会話全体に基づいて計算される | 明示的/自動 cache_control;キャッシュの書き込み/読み取りには別途料金がかかります |
| ライフサイクル | 約5分間アイドル状態が続くとタイムアウト;最大で約1時間後に削除;ベストエフォート | デフォルトのTTLは約5分ですが、1時間に設定することも可能です。スレッドとは独立しています。 |
| クライアントの役割 | 会話の完全なコピーを必ず用意し、404エラーの再再生に備えておく必要があります。 | キャッシュ可能なプレフィックスを安定させ、usage 内の cache フィールドを監視する |
Threadsを「無料の請求書圧縮ツール」と見なすと、アーキテクチャ設計を誤ることになる。遅延は改善されるが、請求額はほとんど変わらない。まず、ボトルネックがTTFTなのか、それとも成功したタスクあたりのコスト($/成功タスク)なのかを見極め、その上でツールを選定すべきだ。

どのような場合にThreadsを開く価値があるのか
- 適用:ロングセッションが活発化――Agentのtool_resultが数百ラウンド分蓄積、computer-useのスクリーンショットが山積み、ドキュメントや画像の容量が非常に大きく、TTFTはコンテキストに応じて明らかに悪化している。
- あまり適していない:短いQ&A、不定期なシングルラン、アイドル時間が5分を超えるがリプレイパスがない場合、Message Batches/オンデマンド・コンパクション/組織によるHIPAAレディネスまたはInference hooksの有効化(公式にはThreadsは非対応と明記されている)。
- コンプライアンスに関する注意事項:スレッド ZDRの対象外;コンテンツはメモリ内で暗号化され、ディスクには保存されず、最終使用から約1時間以内に削除されます。ZDRパスが必要な場合は、デフォルトでThreadsをバインドしないでください。
接続時に必ず準備すべき3つのこと
- Beta ヘッダー:各ラウンドのベルト
anthropic-beta: メッセージスレッド-2026-08-12(または SDK ヘルパーによって自動的に追加される)。 - 「作成/続行」フィールドのルール:
system/ツール「create」の場合のみ;「continue」の場合は再度400が返される。モデルおよびいくつかのfingerprintフィールドは、「create」と一致している必要がある。 - 再生パス:continue 出会う
thread_not_found(404)が発生した場合は、ローカルコピーを使用して「create」をすべて実行し、スレッドを再作成してください。SDKヘルパーが一度リプレイを実行できますが、プロセス外の永続化については、ご自身で保存する必要があります。

# 例:第1ラウンドの create(完全な対話)→ 第2ラウンドの continue(新規追加分のみ送信)
# 正式なフィールドについては、当日のドキュメントを参照してください。これはSDKの型チェックに代わるものではありません
curl -sS https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2026-10-21" \
-H "anthropic-beta: message-threads-2026-08-12" \
-H "content-type: application/json" \
-d '{
"model": "claude-opus-5-5",
"max_tokens": 1024,
"cache_control": {"type": "ephemeral"},
"system": "You are a coding agent.",
"messages": [{"role":"user","content":"… first turn …"}],
"thread": {"type": "create"}
}'
請求額の削減:引き続き「Prompt Caching」に注目(Threadsと併用可能)
公式の章には次のように明記されている:スレッドは、あなたの代わりにプロンプトキャッシュを作成することはありません。キャッシュのルールはワイヤレスと同様です――トップレベルまたはブロックレベルで指定する必要があります cache_control。ドキュメントの例は、Threads リクエストの最上位に配置されています cache_control: {"type":"ephemeral"}、各ラウンドで以前のキャッシュを読み取り、新しいラウンドのデータを書き込むようにする。
重ねて使用する際は、いくつかの制限事項を覚えておいてください(ドキュメントの確認):
- 带
スレッドの要求は最大で約 4 个cache_controlbreakpoint;最上位の自動キャッシュもその一角を占めている。 - create を上に配置する
system/ツールのブレークポイントは、その後の continue でカウントが再開されます。create を再生する際は、古いメッセージ上のブレークポイントを整理し、上限を超えないようにしてください。 - usage を参照:
cache_read_input_tokens/cache_creation_input_tokens/input_tokens、「リクエスト本文が小さくなった」という点だけを見てはいけません。

チェックリストの重ね合わせ(公開前)
- ボトルネックは TTFT か?→ スレッドを開き、アイドル時間が 5 分未満であるか、またはリプレイが可能かどうかを確認する。
- ボトルネックはトークンの入力処理か?→ プロンプトキャッシュを設定する。キャッシュ可能な最小長さとTTLを確認する。
- 両方とも?→ Threads + 各ラウンドで同じトップレベル
cache_control;「転送量が少ない=課金も少ない」と仮定するのではなく、キャッシュヒットを監視すること。 - セッションをプロセス間/日跨ぎで維持したい?→ 独自にストレージを構築し、要約データを圧縮する。Threadsをセッションデータベースとして使用しないこと。
転倒ポイントには適用されません
- 有効期限:約5分間リクエストがない場合、処理を継続できなくなる可能性があります。ローカルでのフルリプレイが必要となります。
- append-only:元のスレッド内で履歴を変更することはできません。編集/ブランチ = 新規作成となります。公式のオンデマンド・コンパクションはスレッドと互換性がありません。要約処理はローカルで完了させてから、新しいスレッドを立ち上げる必要があります。
- フォールバック/拒否:fallback モデルで生成されたラウンドは、スレッドに保存されない可能性があります。refusal の後は、古いスレッドを continue しないでください。
- 指紋が一致しない:model などの固定フィールドを変更すると、
thread_fingerprint_mismatch.
証拠の説明:本稿は以下に基づいて 「メッセージスレッド」のドキュメントそしてAnthropic リソース記事とともに プロンプトのキャッシュに関するドキュメント(2026年11月5日 確認済み)。TTFT「約35%」は、Claude Codeのシナリオに関する公式の記述であり、当サイトによる負荷テストの結果ではありません。実行環境がないため、一人称で「動作確認済み」という数値は記載しません。


评论列表 (0条):
加载更多评论 読み込み中...