---
title: 思考のトラブルシューティング
url: https://platform.claude.com/docs/ja/build-with-claude/thinking-troubleshooting
description: 最も一般的な思考の失敗を診断して修正します：設定に関する400エラー、空または欠落した思考ブロック、max_tokensによる停止、キャッシュミス。
---
「zero data retention」（ゼロデータ保持）、すなわちZDRがこの機能にどのように適用されるかについては、[APIとデータ保持](https://platform.claude.com/docs/ja/manage-claude/api-and-data-retention)を参照してください。
このページでは、思考を設定する際、または思考ブロックをラウンドトリップする（返された思考ブロックを後続のリクエストで送り返す）際に最もよく発生する失敗について説明します。最初のセクションでは、各モデルがサポートする思考設定と拒否する設定を対応付けています。それ以降の各セクションは、観察される症状から始まるため、エラーメッセージや予期しないレスポンスをその原因と修正方法に直接照らし合わせることができます。思考の仕組みについては、[思考](https://platform.claude.com/docs/ja/build-with-claude/thinking)の概要を参照してください。
## モデル別の思考サポート、デフォルト、拒否される設定
思考設定のエラーのほとんどは、リクエスト内の`thinking.type`の値とモデルがサポートする内容との不一致によるものです。ほとんどのモデルでは、思考は`thinking: {type: "adaptive"}`として実行され、多くのモデルではデフォルトでオンになっています。一部の以前のモデルでは、代わりに「[extended thinking](https://platform.claude.com/docs/ja/build-with-claude/extended-thinking)」（拡張思考）を使用します。これは`thinking: {type: "enabled", budget_tokens: N}`として設定するレガシーの手動モードです。
「Extended thinking」（拡張思考）（`thinking.type: "enabled"` と `budget_tokens` の組み合わせ）は、Claude 4.6モデルでは非推奨です（これを使用するリクエストは引き続き成功します）。Claude 4.7以降のモデルはこれをサポートしておらず、これを使用するリクエストを拒否して400エラーを返します。思考をサポートするClaude 4.5以前のモデルでは、拡張思考が利用可能な唯一の思考モードです。Claude Mythos Previewは両方のモードをサポートしています。両方のモードが利用可能な場合は、代わりに[アダプティブ思考](https://platform.claude.com/docs/ja/build-with-claude/thinking)を使用してください。
この表は、各モデルがサポートする内容、デフォルト、および400エラーで拒否される`thinking.type`の値を示しています。拒否として記載されていない値はすべて受け付けられます。`"between_tools"`を受け付けるのはClaude Sonnet 5.5のみで、`"disabled"`の代わりにこの値を使用します。
| モデル | 思考タイプ | デフォルト | 400で拒否される値 |
| --------------------- | ----------------------- | ----- | ------------------------- |
| Claude Fable 5.1 | アダプティブのみ | 常時オン | `"enabled"`、`"disabled"` |
| Claude Mythos 5.1 | アダプティブのみ | 常時オン | `"enabled"`、`"disabled"` |
| Claude Fable 5 | アダプティブのみ | 常時オン | `"enabled"`、`"disabled"` |
| Claude Mythos 5 | アダプティブのみ | 常時オン | `"enabled"`、`"disabled"` |
| Claude Mythos Preview | アダプティブ、拡張 | 常時オン | `"disabled"` |
| Claude Opus 5.5 | アダプティブのみ | 常時オン | `"enabled"`、`"disabled"` |
| Claude Opus 5 | アダプティブのみ | オン | `"enabled"`、`"disabled"`2 |
| Claude Opus 4.8 | アダプティブのみ | オフ | `"enabled"` |
| Claude Opus 4.7 | アダプティブのみ | オフ | `"enabled"` |
| Claude Sonnet 5.5 | アダプティブ、`between_tools`3 | オン | `"enabled"`、`"disabled"` |
| Claude Sonnet 5 | アダプティブのみ | オン | `"enabled"` |
| Claude Haiku 5.5 | アダプティブのみ | オン | `"enabled"`、`"disabled"`2 |
| Claude Opus 4.6 | アダプティブ、拡張（非推奨）1 | オフ | なし |
| Claude Sonnet 4.6 | アダプティブ、拡張（非推奨）1 | オフ | なし |
| Claude Opus 4.5 | 拡張のみ | オフ | `"adaptive"` |
| Claude Haiku 4.5 | 拡張のみ | オフ | `"adaptive"` |
| Claude Sonnet 4.5 | 拡張のみ | オフ | `"adaptive"` |
*1 これらのモデルでは`enabled`と`budget_tokens`は引き続き動作しますが、非推奨です。代わりにアダプティブ思考を使用してください。*\
*2 Claude Opus 5とClaude Haiku 5.5は、[effort](https://platform.claude.com/docs/ja/build-with-claude/effort)が`high`以下の場合に`"disabled"`を受け付けます。effort `xhigh`または`max`と組み合わせると400エラーが返されます。Claude Opus 5では、この制限はリクエストごとに適用されます。Claude Haiku 5.5では、有効なレベルと異なるメッセージごとのeffortも400エラーを返します。*\
*3 Claude Sonnet 5.5は、effortが`high`以下の場合に`"between_tools"`を受け付けます。effort `xhigh`または`max`と組み合わせると400エラーが返され、有効なレベルと異なるメッセージごとのeffortも同様に400エラーを返します。*
「常時オン」と記載されたモデルでは、思考をオフにすることはできません。「オン」と記載されたモデルは、デフォルトで思考を行います。Claude Opus 5、Claude Sonnet 5、Claude Haiku 5.5は`thinking: {type: "disabled"}`を受け付けます。Claude Sonnet 5.5で事前の思考をオフにするには、`thinking: {type: "between_tools"}`を送信してください。
以前のClaude 4モデル（Claude Opus 4.1、Claude Sonnet 4、Claude Opus 4）は拡張思考のみをサポートしています。これらの提供状況については[モデルの非推奨化](https://platform.claude.com/docs/ja/about-claude/model-deprecations)を参照してください。Claude Fable 5.1、Claude Mythos 5.1、Claude Fable 5、Claude Mythos 5は、Anthropicによって明示的に許可されない限り、[ゼロデータ保持](https://platform.claude.com/docs/ja/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)の下では利用できません。
## 400エラーで `"thinking.type.enabled"` がサポートされていないと表示される
リクエストが400エラーで失敗し、メッセージは次のとおりです。
```text wrap
"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
```
これは、リクエストしたモデルで拡張思考が削除されているために発生します（[モデル別設定表](https://platform.claude.com/docs/ja/build-with-claude/thinking-troubleshooting#rejected-configurations)を参照）。
リクエストを `thinking: {type: "adaptive"}` に切り替え、`budget_tokens` の代わりに `effort` で思考の深さを調整してください。[アダプティブ思考への移行](https://platform.claude.com/docs/ja/build-with-claude/extended-thinking#migrating-to-adaptive-thinking)で変換手順を説明しています。
## `thinking: {type: "disabled"}`を送信した後に400エラーが発生する
リクエストが400エラーで失敗します。Claude Fable 5.1、Claude Mythos 5.1、Claude Fable 5、Claude Opus 5.5、Claude Mythos 5では、メッセージは次のようになります：
```text wrap
"thinking.type.disabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
```
これらのモデルのうち拡張思考を受け付ける唯一のモデルであるClaude Mythos Previewでは、メッセージは次のようになります：
```text wrap
"thinking.type.disabled" is not supported for this model. Thinking defaults to adaptive mode when not specified; use "thinking.type.enabled" with "budget_tokens" for extended thinking.
```
これは、これらすべてのモデルで思考が常時オンであるために発生します（[モデル別の設定表](https://platform.claude.com/docs/ja/build-with-claude/thinking-troubleshooting#rejected-configurations)を参照）。
`thinking`パラメータを省略してください。これらのモデルは設定なしで思考を行います。レスポンスから思考テキストを除外することが目的だった場合は、思考を無効にする代わりに`display: "omitted"`を使用してください。[思考の表示の制御](https://platform.claude.com/docs/ja/build-with-claude/thinking#controlling-thinking-display)を参照してください。
`"disabled"`での400エラーは、[effort](https://platform.claude.com/docs/ja/build-with-claude/effort)が`high`以下の場合にのみ`thinking: {type: "disabled"}`を受け付けるClaude Opus 5とClaude Haiku 5.5でも発生する可能性があります。effort `xhigh`または`max`と組み合わせると拒否されます。effortレベルを下げるか、`thinking`を`{"type": "adaptive"}`に設定してください。
Claude Sonnet 5.5では、`thinking: {type: "disabled"}`はすべてのeffortレベルで400エラーを返します。メッセージは次のようになります：
```text wrap
To turn thinking off on this model, send "thinking": {"type": "between_tools"} instead of {"type": "disabled"}. The model does not think before responding. The short updates it writes between tool calls come back as thinking blocks.
```
Claude Sonnet 5.5で事前の思考をオフにするには、代わりにeffort `high`以下で`thinking: {type: "between_tools"}`を送信してください。
## 400エラーで`"thinking.type.between_tools"`がサポートされていないと表示される
リクエストが400エラーで失敗し、次のメッセージが表示されます：
```text wrap
"thinking.type.between_tools" is not supported for this model.
```
これは、`thinking: {type: "between_tools"}`を受け付けるのがClaude Sonnet 5.5のみであるために発生します（[モデル別の設定表](https://platform.claude.com/docs/ja/build-with-claude/thinking-troubleshooting#rejected-configurations)を参照）。
`between_tools`はClaude Sonnet 5.5にのみ送信してください。その他のモデルでは、`thinking`を省略するか、表で拒否として記載されていない`thinking.type`の値を使用してください。
## 400エラーで思考が無効な場合にeffortレベルがサポートされていないと表示される
Claude Sonnet 5.5で、effort `xhigh`または`max`で`thinking: {type: "between_tools"}`を指定したリクエストは400エラーで失敗し、メッセージは次のようになります：
```text wrap
output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking.
```
これは、Claude Sonnet 5.5が[effort](https://platform.claude.com/docs/ja/build-with-claude/effort)が`high`以下の場合にのみ`between_tools`を受け付けるために発生します。リクエストが`"disabled"`を送信していなくても、`between_tools`には事前の思考がないため、メッセージでは思考が無効であると表示されます。メッセージには、リクエストが送信したレベルが示されます。
effortを`high`以下に下げてください。`xhigh`または`max`で実行するには、アダプティブ思考を使用してください。つまり、`thinking`フィールドを省略するか、`thinking: {"type": "adaptive"}`を送信します。これがメッセージ中の「enable thinking」の意味です。Claude Sonnet 5.5は`"enabled"`を400エラーで拒否します。
Claude Haiku 5.5は、リクエストがeffort `xhigh`または`max`で`thinking: {type: "disabled"}`を送信した場合に同じメッセージを返します。`"disabled"`は`high`以下の場合にのみ受け付けられます。effortを下げるか、`thinking`を`{"type": "adaptive"}`に設定してください。
## 400エラーで思考が無効な場合にeffortを変更できないと表示される
Claude Sonnet 5.5で、`thinking: {type: "between_tools"}`を指定し、[メッセージごとのeffort](https://platform.claude.com/docs/ja/build-with-claude/effort#change-effort-mid-conversation-beta)でレベルを変更するリクエストは400エラーで失敗し、メッセージは次のようになります：
```text wrap
messages.N: output_config.effort 'low' differs from the 'high' in effect before it; effort cannot change when thinking is disabled on this model. Use effort 'high', or enable thinking.
```
`between_tools`には事前の思考がないため、メッセージでは思考が無効であると表示されます。`between_tools`では、会話の途中でeffortを変更できません。有効なレベルと異なるメッセージごとの`output_config.effort`は400エラーを返します。`messages.N`は、新しいレベルを設定したメッセージの位置です。
そのメッセージごとのeffortを削除するか、有効なレベルに設定してください。ターンごとにeffortを変えるには、アダプティブ思考を使用してください：`thinking`フィールドを省略するか、`thinking: {"type": "adaptive"}`を送信します。これがメッセージの「enable thinking」の意味です。
Claude Haiku 5.5は、`thinking: {type: "disabled"}`を指定したリクエストが有効なレベルと異なるメッセージごとのeffortを設定した場合に同じメッセージを返します。そのメッセージごとのeffortを削除するか、ターンごとにeffortを変えるために`thinking`を`{"type": "adaptive"}`に設定してください。
## 400エラーでアダプティブ思考がサポートされていないと表示される
リクエストが400エラーで失敗し、メッセージは次のとおりです。
```text wrap
adaptive thinking is not supported on this model
```
これは、モデルが拡張思考のみをサポートしているために発生します（[モデル別設定表](https://platform.claude.com/docs/ja/build-with-claude/thinking-troubleshooting#rejected-configurations)を参照）。
代わりに `thinking: {type: "enabled", budget_tokens: N}` を使用してください。設定については[拡張思考](https://platform.claude.com/docs/ja/build-with-claude/extended-thinking)を参照してください。
## 400エラーで思考ブロックを変更できないと表示される
ツール結果を返すリクエストが400 `invalid_request_error` で失敗し、メッセージには次の内容が含まれます。
```text wrap
`thinking` or `redacted_thinking` blocks in the latest assistant message cannot be modified
```
マルチターンおよびツール使用の会話では、以前のアシスタントメッセージを、その `thinking` ブロックと `redacted_thinking` ブロックを含めて API に送り返し、API はそれらが変更されずに届いたことを検証します。このエラーは、送り返したアシスタントメッセージが API が返したものと異なる場合に発生します。最も多い原因は、コードがコンテンツブロックをタイプでフィルタリングして `redacted_thinking` ブロックを削除している、またはアシスタントメッセージをそのまま返すのではなく再構築していることです。
アシスタントのターンを、思考ブロックを含めてそのまま送り返してください。ルールについては[思考ブロックの保持](https://platform.claude.com/docs/ja/build-with-claude/thinking#preserving-thinking-blocks)を、すべての SDK での正しいコードについては[ツールおよびマルチターンワークフローにおける思考](https://platform.claude.com/docs/ja/build-with-claude/thinking-tool-workflows#two-turn-tool-use-round-trip)の実例ラウンドトリップを参照してください。
## 400エラーで思考ブロックの署名が無効であると表示される
以前の思考ブロックを再送するClaude Fable 5.1、Claude Opus 5.5、Claude Sonnet 5.5、またはClaude Haiku 5.5へのリクエストが400 `invalid_request_error`で失敗し、メッセージは次のようになります：
```text wrap
messages.{i}.content.{j}: Invalid `signature` in `thinking` block. The block is bound to a different conversation. Remove the block, or set `thinking.block_binding.prefix_mismatch_behavior` to "drop_block".
```
リクエストが`thinking-binding-controls-2026-08-01`ベータヘッダーを送信していない場合、メッセージには``That setting requires the `thinking-binding-controls-2026-08-01` value in the `anthropic-beta` header.``が追加されます。
メッセージは通常、何が変更されたかを示す文で終わります：`system`プロンプト、`tools`リスト、最初に異なるメッセージまたはブロック、欠落しているか新しいコンテンツ、または欠落しているか順序が異なる以前の思考ブロックです。この文は人間とログ向けのものです。文言は変更される可能性があるため、コード内でこれに一致させないでください。
メッセージが``Invalid `signature` in `thinking` block``で終わっている場合は、署名自体が検証されなかったことを意味します。署名が切り詰められたか、変更されたか、空で送り返されたかのいずれかであり、`prefix_mismatch_behavior`は適用されません。思考テキストを編集した場合は別のエラーが返されます。[400エラーで思考ブロックを変更できないと表示される](https://platform.claude.com/docs/ja/build-with-claude/thinking-troubleshooting#error-thinking-blocks-modified)を参照してください。
Claude Fable 5.1、Claude Opus 5.5、Claude Sonnet 5.5、Claude Haiku 5.5では、APIは、再送された思考ブロックより前の`system`プロンプト、`tools`、およびメッセージが変更されていない場合にのみ、その思考ブロックを受け付けます。[プレフィックスを変更しないようにする](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#prefix-check)を参照してください。このエラーは、会話の以前の部分がリクエスト間で変更されたことを意味します。たとえば、ターンの編集、並べ替え、削除、挿入された後に削除されたターンごとのリマインダー、再構築された`system`プロンプトや`tools`配列、または最近のターンとその思考をそのまま保持したクライアント側のコンパクションなどです。このチェックは、2026年8月31日以降に作成された新しいアカウント、および`thinking.block_binding.prefix_mismatch_behavior`を設定したすべてのリクエストに適用されます。サーバー側の[コンパクション](https://platform.claude.com/docs/ja/build-with-claude/compaction)と[コンテキスト編集](https://platform.claude.com/docs/ja/build-with-claude/context-editing)がこのエラーを引き起こすことはありません。
修正するには、履歴を追記のみにしてください：以前のターンは送受信したとおりに正確に渡し、`system`や`tools`を編集する代わりに[会話途中のシステムメッセージ](https://platform.claude.com/docs/ja/build-with-claude/mid-conversation-system-messages)で指示を追加し、トリミングはサーバー側の[コンテキスト編集](https://platform.claude.com/docs/ja/build-with-claude/context-editing)または[コンパクション](https://platform.claude.com/docs/ja/build-with-claude/compaction)に任せます。同じリクエスト本文で再試行してもエラーは解消されません。無効化された推論なしでこのリクエストを続行するには、`thinking-binding-controls-2026-08-01`ベータヘッダーを送信し、`thinking.block_binding.prefix_mismatch_behavior`を`"drop_block"`に設定してください。あるいは、履歴からすべての`thinking`ブロックと`redacted_thinking`ブロックを削除し（少なくとも、示されたブロックとそれ以降のすべてのブロックを、そのターンおよび以降のすべてのターンで削除します）、各ターンの他のブロックはそのまま残して、一度再試行してください。Claude Sonnet 5.5とClaude Haiku 5.5では、`block_binding`は`thinking: {"type": "adaptive"}`でのみ機能します。Claude Sonnet 5.5の`between_tools`、またはClaude Haiku 5.5の`thinking: {"type": "disabled"}`では、履歴を追記のみに保つか、編集したターン以降の思考ブロックを削除してください。
対象モデルが読み取れないモデルからのブロックがこのエラーを引き起こすことはありません。APIはそのブロックを削除し、ベータヘッダーを使用している場合は`input_transformations`で報告します。
## レスポンスの thinking フィールドが空である
レスポンスには `thinking` ブロックが含まれていますが、その `thinking` フィールドは空文字列で、`signature` フィールドのみが設定されています。
これは、新しいモデルでは `display` のデフォルトが `"omitted"` であり、テキストなしで思考ブロックが返されるために発生します。
要約された思考テキストを受け取るには、思考設定で `display: "summarized"` を設定してください。モデルごとのデフォルトについては[思考の表示の制御](https://platform.claude.com/docs/ja/build-with-claude/thinking#controlling-thinking-display)を参照してください。推論ではなく、一部のモデルがツール呼び出しの間に書く短いステータス行のみが必要な場合は、代わりに `display: "updates"`（ベータ）を設定してください。[ツール呼び出し間の進捗更新](https://platform.claude.com/docs/ja/build-with-claude/thinking#progress-updates)を参照してください。
`thinking`フィールドが空のブロックも完全なブロックです。`signature`に推論が保持されています。他のブロックと同様に、ターンと一緒に送り返してください。[アシスタントのターンを返されたとおりに正確に送り返す](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#append-assistant-turns-exactly-as-returned)を参照してください。
## 一部のターンで思考ブロックが表示されない
思考が設定されているにもかかわらず、一部のレスポンスに `thinking` ブロックがまったく含まれていません。
これはアダプティブモードでは正常です。Claude は、直接回答できるほど単純だと判断したリクエストでは思考をスキップします。
より頻繁に、またはより深く思考させたい場合は、`effort` を上げるか、プロンプトで誘導してください。[Claude が思考する頻度の調整](https://platform.claude.com/docs/ja/build-with-claude/thinking-steering-and-cost#tuning-thinking-behavior)を参照してください。
強制的な`tool_choice`（`{"type": "any"}`または名前付きツール）でも`thinking`ブロックは返されません：レスポンスはツール呼び出しから始まります。ツールを呼び出す前にモデルに思考させるには、`tool_choice: {"type": "auto"}`を使用し、いつツールを使用するかをプロンプトで指示してください。
## ツール呼び出しや XML タグがテキスト出力に現れる
レスポンスが `tool_use` ブロックを出力する代わりにツール呼び出しをテキストに書き込んだり、表示テキストに `` やその他の内部 XML タグを含めたりすることがあります。漏れ出たツール呼び出しは実行されず、エージェントループでは漏れ出たテキストが会話履歴に残るため、後続のターンにも影響します。
これは Claude Opus 5 で思考が無効になっている場合に発生し、検索などツールを多用するワークロードで最もよく見られます。モデルに思考しないよう、または推論しないよう指示するシステムプロンプトのルールは、タグの漏出を増加させます。
思考を再度有効にし（デフォルト）、代わりに低い `effort` レベルを使用してトークンコストを制御してください。統合で思考を無効のままにする必要がある場合は、[思考を無効にして実行する](https://platform.claude.com/docs/ja/build-with-claude/prompt-engineering/prompting-claude-opus-5#running-with-thinking-disabled)のプロンプトによる緩和策を適用してください。
## レスポンスが `stop_reason: "max_tokens"` で停止する
レスポンスが `stop_reason: "max_tokens"` で終了し、多くの場合テキストブロックが切り詰められているか欠落しています。
これは、思考トークンが `max_tokens` にカウントされるため、長い思考パスがテキストレスポンスの完了前に予算を消費してしまうことで発生します。
思考とテキストの両方に余裕を持たせるために `max_tokens` を上げるか、Claude が思考に費やす量を減らすために `effort` を下げてください。[コスト管理](https://platform.claude.com/docs/ja/build-with-claude/thinking-steering-and-cost#cost-control)および[思考とコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/thinking#thinking-and-the-context-window)を参照してください。
## 思考設定を変更した後にキャッシュヒットが減少する
以前はキャッシュにヒットしていたリクエストで `cache_read_input_tokens` がゼロになります。
これは、思考設定と effort レベル（またはそのデフォルト）がキャッシュされたプロンプトプレフィックスの一部であるため、いずれかを変更すると新しいプレフィックスが開始されることで発生します。思考モードの切り替え、effort 値の変更、`budget_tokens` の変更はすべてメッセージのキャッシュブレークポイントを無効化し、モデルが設定をどこにレンダリングするかによっては、ツールおよびシステムプロンプトのブレークポイントも無効化する可能性があります。
会話を共有するリクエスト間で思考設定と effort レベルを一定に保ってください。パラメータを明示的にデフォルト値に設定することは省略することと同等であり、無効化は発生しません。[思考とプロンプトキャッシング](https://platform.claude.com/docs/ja/build-with-claude/thinking#thinking-and-prompt-caching)を参照してください。
## effort を設定しても思考が変わらない
`effort` を変更しても、思考の頻度や深さが変わりません。
これは、effort が主要な思考の調整手段となるのはアダプティブモードのみであるために発生します。拡張思考のみのモデルでは、思考の深さは代わりに `budget_tokens` で設定されます。
それらのモデルでは `budget_tokens` を調整するか、モデルがどのモードで実行されているかを確認してください。[思考と effort](https://platform.claude.com/docs/ja/build-with-claude/thinking#thinking-and-effort)を参照してください。effort をサポートする唯一の拡張思考のみのモデルである Claude Opus 4.5 では、effort は予算と組み合わされます。[予算のルールと調整](https://platform.claude.com/docs/ja/build-with-claude/extended-thinking#budget-rules-and-tuning)を参照してください。
## 次のステップ
概要：思考とは何か、設定方法、およびツール、キャッシング、ストリーミングとの相互作用。
思考設定の400エラーとその正確なサーバーメッセージを含む、完全なエラーリファレンス。
`budget_tokens` リクエストを effort を使用したアダプティブ思考に変換します。