約 3 分で読めます

thinking blockのアカウント束縛とテナント分離設計

自社サービスにClaudeを組み込み、顧客ごとの会話履歴をデータベースに保存している中小SaaSでは、ある日突然「モデルが前の推論を覚えていない」という不具合が起きえます。原因がコードの誤りではなく、アカウントをまたいだthinking blockの再利用だった場合、エラーは一切出ません。この記事は、Claude Sonnet 5.5とClaude Haiku 5.5で追加された「アカウント束縛」の挙動と、履歴保存側で取るべき設計を整理します。

thinking blockのアカウント束縛とは何か

Sonnet 5.5とHaiku 5.5が出力したthinking blockは、生成したアカウントか、リンクされたアカウントでしか有効になりません。

公式ドキュメントによると、束縛の対象はClaude Sonnet 5.5とClaude Haiku 5.5が生成したthinking blockです。それ以前のモデルが出力したブロックには影響しません。2026年9月28日のリリースノートにも同じ内容が記載されています。

別アカウントから送られたブロックは、モデルに渡る前にAPIが破棄します。リクエスト自体は成功するため、400エラーのような検知の手がかりがありません。モデルは破棄されたブロックの推論なしで回答します。「リンクされたアカウント」がどう成立するかは、参照した範囲のドキュメントには定義がありません。リンク前提の運用は避けてください。

どんな構成で事故が起きるのか

起きやすいのは、アカウントをまたいで履歴を引き継ぐ構成です。ドキュメントは別アカウントのブロックを再利用していないかの点検を求めています。

中小SaaSで該当しやすいのは次のパターンです。

  • 開発用と本番用でAPIアカウントを分け、本番の履歴をステージングで再現テストに流用する
  • 顧客ごとに別のAPIアカウントを持たせる構成で、履歴ストアが共通になっている
  • アカウントの作り直しや統合の際に、保存済み履歴をそのまま移行する

ドキュメントは、共有プロキシやマルチテナント基盤では他テナントのブロックを別の会話に使い回さず、アカウント単位で保存するよう示しています。

どう検知し、履歴ストアをどう設計するか

検知にはthinking-binding-controls-2026-08-01ベータヘッダーを使います。破棄したブロックがinput_transformationsに記録されます。

このヘッダーを付けると、Claude APIとClaude Models on Google Cloud(Google managed)では、破棄された各ブロックがレスポンスのinput_transformationsに載ります。typeはthinking_dropped、reasonはorganization_binding_mismatchで、pathはmessages.1.content.0のように位置を示します。ヘッダーがなければ破棄は無通知です。

履歴ストアの設計は次の4点を押さえます。

  1. 会話レコードに、生成時のAPIアカウント識別子を必ず持たせる
  2. 別アカウントで再生する場合は、thinkingとredacted_thinkingを取り除き、textとtool_useだけを引き継ぐ
  3. 本番では上記ヘッダーを付け、input_transformationsの件数をログとメトリクスに出す
  4. organization_binding_mismatchが出たら、アカウント跨ぎの経路を調査するアラートにする

なお、別アカウントが良好な状態でなくなっている場合にも、APIがそのアカウントのブロックを省くことがあります。対象はFable、Mythos、Opus 5、Opus 5.5、Sonnet 5.5、Haiku 5.5です。推論の欠落が起きても不具合と決めつけず、まずinput_transformationsを確認してください。

規模別の運用の目安

アカウントが1つだけの小規模サービスでは、この制約に当たる場面は多くありません。環境分離やアカウント統合を予定している段階で、履歴にアカウント識別子を持たせておけば十分です。顧客ごとにアカウントを分ける構成なら、ストアのキーにアカウントIDを含めることが最初の一手です。導入と運用の伴走はAI運用支援サービスで相談できます。

参考

まとめ

thinking blockはアカウントに束縛されます。履歴にアカウント識別子を持たせ、破棄の記録を監視することが最小限の対策です。

別アカウントのブロックは黙って破棄されるため、会話の質の低下として表面化します。保存時にアカウントを記録し、再生時にブロックを整理し、input_transformationsを監視してください。自社の履歴保存の点検や設計は、Kuuのお問い合わせからご相談いただけます。

関連記事

Claude APIキーの種類と漏えい時の初動手順CMEK鍵の障害検知と復旧を三層で設計する方法ClaudeのIP許可リストが守る範囲と守れない範囲Claude Securityプラグインで差分を検査する手順