Claude Media
thinking block mismatchエラーの原因とrewindでの直し方

thinking block mismatchエラーの原因とrewindでの直し方

Claude Codeで会話履歴が壊れると出るtool use / thinking blockの不整合エラー。5つの表示パターンと修正履歴、rewindでの復旧手順を扱います。

Claude Codeの拡張思考モードでツール呼び出し中に会話が中断すると、次のターンで API Error: 400 が返り作業が止まることがあります。原因は会話履歴に含まれる tool_use / tool_result / thinking ブロックの並び順がAPIの想定と食い違う状態です。文言は5種類ありますが、直し方は /rewind で壊れる前のチェックポイントまで戻る操作に集約されます。

thinking block mismatchとはどんなエラーか

Claude Codeはツール呼び出しの結果と拡張思考の内容を、会話履歴の中に tool_use・tool_result・thinking という3種類のブロックとして保持しています。この並び順がAPIの期待する形と一致しない状態になると、次のリクエストが 400 エラーで即座に拒否されます。

エラーリファレンスは次の5つの表示を同じ原因として並べています。

  • API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
  • API Error: 400 orphaned tool_result in conversation history. Run /rewind to recover the conversation.
  • API Error: 400 duplicate tool_use ID in conversation history. Run /rewind to recover the conversation.
  • API Error: 400 ... unexpected \tool_use_id` found in `tool_result` blocks`
  • API Error: 400 ... thinking blocks ... cannot be modified

文言は違っても意味は同じで、履歴の中のブロックの並びがAPIの期待する形式と噛み合わなくなっています。Claude Code CLIで「tool use concurrency issues」という文言が出るケースの発生条件とバージョン別の修正経緯は、Claude Code「Tool Use Concurrency」エラーの原因と対処法にまとめています。

なぜ会話履歴が壊れるのか

起きる要因として考えられる例は2つあります。ひとつはツール呼び出しの途中でのセッション中断です。ツールの結果を受け取る前に接続が切れたり強制終了したりすると、tool_use だけが残り、対応する tool_result が欠けた履歴になりえます。もうひとつはターンの編集です。過去のプロンプトを書き換えて再送すると、その後に続いていたツール呼び出しや思考ブロックの連鎖が、前提を失った状態になりえます。

拡張思考を使っているセッションでは thinking ブロックも履歴に含まれるため、影響を受ける対象がさらに広がります。自前でcontext editingを組む場合は、thinking blockのクリアをtool result clearingより先に並べる必要があります。thinking blocks ... cannot be modified という文言は、履歴の中の思考ブロックが書き換わったことを示しています。

更新で直るケースは/rewindが効かない

Opus 4.7またはOpus 4.8を使っていて、Claude Codeがv2.1.156より前の場合は、通常のツール利用中にもこのエラーが出ることがあります。エラーリファレンスは、この場合 /rewind でも解消しないと明記しています。履歴は壊れていないのに、Claude Code側の不具合でAPIとのやり取りが食い違うためです。先に更新してから /rewind を試します。

claude update

thinkingブロック絡みの400エラーは、これまでにも別々の原因で何度か修正されています。changelogに載っている主なものは次のとおりです。

あゆみ

thinkingブロック絡みの400エラーの修正

  1. v2.1.30(2026年2月3日)/login 後の400

    /login を実行したあと、会話にthinkingブロックが含まれていると起きる400エラーが直りました。

  2. v2.1.33(2026年2月6日)ストリーミング中断

    ストリーミング中に中断したとき、空白だけのテキストとthinkingブロックが組み合わさり、無効なリクエストになる問題が直りました。

  3. v2.1.47(2026年2月18日)並行エージェント

    複数のエージェントを並行させたセッションで、ストリーミング中のブロックが入り混じって thinking blocks cannot be modified になる問題が直りました。

  4. v2.1.136(2026年5月8日)redacted thinking

    拡張思考がツール呼び出しの後にredacted thinkingブロックを出したときの400エラーが直りました。

  5. v2.1.156(2026年5月29日)Opus 4.8

    Opus 4.8でthinkingブロックが書き換わり、APIエラーになる問題が直りました。

エラーリファレンスの該当節はOpus 4.7とOpus 4.8の両方を挙げていますが、changelogのv2.1.156にはOpus 4.8の修正としてだけ載っています。

v2.1.289で claude --help を実行すると、復旧と再開に使うフラグは次のように出力されます。--fork-session は --resume か --continue と組み合わせて使う指定です。

  -c, --continue                        Continue the most recent conversation in
                                        the current directory
  --fork-session                        When resuming, create a new session ID
                                        instead of reusing the original (use
                                        with --resume or --continue)
  -r, --resume [value]                  Resume a conversation by session ID, or
                                        open interactive picker with optional
                                        search term

Fable 5.1では別の原因で似たエラーが出ることがある

Fable 5.1を使うAPI連携では、ここまでの不整合とは別の原因で、次の400エラーが返ることがあります。

messages.5.content.0: Invalid `signature` in `thinking` block. The block is bound to a different conversation.

Fable 5.1のthinkingブロックは、それより前の system プロンプト・ツール定義・過去のメッセージが変わっていないことを前提に有効です。過去のターンを編集・並べ替えたり、ターン限りのリマインダーを tool_result の後ろに足して次のリクエストで消したりすると、以降のthinkingブロックが無効になります。

この検証が既定で効くのは2026年8月31日以降に作成された新規アカウントです。それより前のアカウントでは、リクエストで thinking.block_binding.prefix_mismatch_behavior を指定したときだけ検証が作動します。Claude Code・claude.ai・Managed Agents・Agent SDKが履歴を管理する場合は、前提部分を保つ作りになっています。messages 配列を自前で組み立てる実装は対象になります。

エラーが出たときの選択肢は2つです。1つは履歴から thinking ブロックを外して1回だけ再試行する方法です。もう1つは thinking-binding-controls-2026-08-01 のベータヘッダーを付け、prefix_mismatch_behavior を "drop_block" にする方法で、不一致のブロックとそれ以降のthinkingブロックがまとめて落ちます。同じリクエストのまま自動再試行を繰り返しても通りません。

モデルを切り替えた場合は別の扱いです。Fable 5.1の会話が古いモデルに移ると、APIは読めないブロックを自動で取り除くため、エラーにならずリクエストは通ります。Fable 5.1の仕様全体はClaude Fable 5.1の仕様解説にまとめています。

復旧手順 — /rewindで壊れた地点まで戻る

対処は一貫して同じです。壊れたターンより前のチェックポイントまで会話を巻き戻し、そこから再開します。

手順

壊れた会話を /rewind で戻す

  1. 1

    メニューを開く

    プロンプト入力欄が空の状態で /rewind を実行するか、Esc を2回押します。入力欄に文字が残っていると、Esc の2回押しは下書きを消す操作になります。

  2. 2

    壊れる直前のプロンプトを選ぶ

    メニューには、セッション内で送った各プロンプトの一覧が並びます。プロンプトを送るたびにチェックポイントが1つ作られるためです。

  3. 3

    戻し方を選ぶ

    コードと会話の両方、会話だけ、コードだけのいずれかを選びます。違いは下の表のとおりです。

  4. 4

    プロンプトを送り直す

    巻き戻した地点のプロンプトは入力欄に復元されるので、そのまま、または手直しして再送します。

/rewind
選択肢効果使うタイミング
Restore code and conversation効果コードと会話の両方を巻き戻す使うタイミングツール呼び出しの結果ごと状態を戻したいとき
Restore conversation効果会話だけ巻き戻し、コードは現状維持使うタイミングファイル変更は保持したまま履歴だけ直したいとき
Restore code効果ファイル変更だけ取り消し、会話は維持使うタイミング会話の流れは壊れておらずコード変更だけ戻したいとき

コードを戻す2つの選択肢は、選んだ地点以降にファイル編集が記録されているときだけ表示されます。メニューには「Summarize from here」「Summarize up to here」もありますが、こちらは会話を要約して圧縮する操作で、履歴の不整合を直す手段ではありません。

セッションを一度終了して --continue や --resume で再開した場合も、チェックポイントは会話と一緒に保存されているため /rewind は使えます。

元のセッションを残したまま試したいときは/branch

/rewind は同じセッションの中で過去に戻る操作です。壊れる前の状態は残しつつ別のアプローチを試したいときは /branch を使います。元のセッションを温存したまま試せます。

くらべる

/rewind と /branch の違い

同じセッションで戻る

/rewind

履歴を過去のチェックポイントまで巻き戻して、そのまま続けます。コードも一緒に戻せます。

コピーに移る

/branch

会話をコピーした新しいセッションに切り替わり、元のセッションは残ります。名前を省くと、会話の最初のプロンプトから自動で名付けられます。

コマンドラインからは claude --continue --fork-session や claude --resume --fork-session でも同じことができ、元のセッションへは /resume で戻れます。

ただし /branch で複製されるのはファイルではなく会話履歴です。コピー元の履歴がすでに tool_use / thinking ブロックの不整合を抱えていれば、新しいブランチにも引き継がれます。分岐する地点は、壊れたターンより前を選びます。

セッションを再開しても再発する理由

--continue や --resume でセッションを再開すると、ツール呼び出しとその結果を含む会話履歴が丸ごと復元されます。壊れた tool_use / tool_result / thinking の並びも復元対象なので、そのまま再開して送信すると同じ400エラーが返ります。エラーが出た直後にメッセージを送り直しても同じです。再開後の最初の操作は、通常のプロンプトではなく /rewind にします。

再開したセッションの全ターンが400で失敗する場合は、ANTHROPIC_BASE_URL で設定したサードパーティのプロキシが残した非対応のツール内容が原因のことがあります。v2.1.246以降のClaude Codeは、Anthropic APIへ直接つなぐ場合にこれを取り除き、跡に [Unsupported tool content removed] という行を残して続行します。古いバージョンなら claude update してから再開します。この行の意味と除去される条件は「Unsupported tool content removed」とはにまとめています。

非対話モード(-p)での再開

claude -p --continue は、-p やAgent SDKで作ったセッションも含めて直近の会話を引き継ぎます。履歴が壊れたセッションにこの形で接続し続けると、同じ400エラーを繰り返しやすくなります。--continue を付けずに実行すると新しいセッションになるため、履歴は持ち越されません。

チェックポイントの限界

/rewind が追跡するのは、Claude Codeのファイル編集ツールが加えた変更です。rm や mv のようなbashコマンドでのファイル操作は対象外なので、巻き戻しても復元されません。サブエージェントによる編集も、フォアグラウンドで動く context: fork のスキル以外は復元されず、gitで戻すことになります。シンボリックリンクとハードリンクのパスも巻き戻されず、スキップした旨の警告が出ます。

ファイルスナップショットは1セッションあたり直近100件のチェックポイント分だけ保持されます。古いチェックポイントを破棄すると、他から参照されなくなったスナップショットは削除されます。ただし各ファイルの最初のスナップショットは、VS Code拡張がセッション内差分の基準として使うため残ります。

スナップショットはセッションと一緒に保存され、最後に保存してから約30日の保持期間で削除されます(cleanupPeriodDays 設定で変更可能)。スナップショットが消えた後に巻き戻すと、No files were restored で失敗することがあります。

よくある質問

/rewindを実行しても直らないときは何を確認するか

まず、表示が Invalid data in redacted_thinking block なら、ここまでとは別のエラーです。v2.1.282以降のClaude Codeは、この400が返ると会話内のthinkingブロックを落として1回だけ再試行するので、古ければ更新します。それ以外、または更新後も解消しないときは、/rewind で選ぶチェックポイントをさらに前に戻します。それでも直らなければ、/clear で会話を打ち切って新しいセッションから作業をやり直します。

拡張思考を使っていないセッションでも起きるか

起きます。orphaned tool_result や duplicate tool_use ID のように、表示文言の中には thinking を挙げていないものがあるためです。拡張思考を有効にしていると thinking ブロックの制約が加わり、不整合が起きうる箇所が増えます。エラーメッセージに thinking blocks ... cannot be modified が含まれていれば、拡張思考のブロックが関わっています。

まとめ

再開直後は通常のプロンプトを送らず、先に /rewind で壊れる前の地点へ戻します。別のアプローチも試したいときは、その地点で /branch を使えば元のセッションが残ります。Claude Codeの他のエラー全般の切り分けはClaude Codeインストールエラーの切り分けチェックリストに、/rewind の操作はClaude Code rewindコマンドで/clear前まで戻るに、チェックポイントを含む作業の流れはClaude Codeワークフロー — Ultraplan/Ultrareview/Checkpointingにあります。

参照した一次ソース

この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。

  1. code.claude.com/docs/en/errors
  2. code.claude.com/docs/en/checkpointing
  3. platform.claude.com/docs/en/models/fable-5-1/migration-guide
  4. code.claude.com/docs/en/changelog
  5. code.claude.com/docs/en/sessions
  6. code.claude.com/docs/en/commands
この記事を共有:XはてブLinkedIn