---
title: ツール使用のトラブルシューティング
url: https://platform.claude.com/docs/ja/agents-and-tools/tool-use/troubleshooting-tool-use
description: 症状から修正方法を導く診断表を使って、最も一般的なツール使用のエラーを修正します。
---

表示されている症状またはエラーを見つけ、それに対して記載されている修正方法を適用してください。

## Claudeが間違ったツールを呼び出す

| 症状 | 考えられる原因 | 修正方法 |
| ----- | ----- | ----- |
| ツールBを使ってほしいのにClaudeがツールAを呼び出す | 説明の曖昧さ | 説明を明確にします。ツールが「何をするか」だけでなく、「いつ使うか」によってツールを区別します。[ツールの定義](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/define-tools)を参照してください。 |
| Claudeがツールをまったく呼び出さない | ツール名の衝突、またはスキーマが汎用的すぎる | ツールリスト全体で名前が重複していないか確認します。`input_examples`を追加して、意図した使い方を具体的にします。 |
| Claudeが間違ったパラメータ型で呼び出す | スキーマがあいまい | `strict: true`を追加する（スキーマがサポートされているサブセットに含まれる場合）か、`input_examples`を追加します。 |

## Claudeがツールパラメータを捏造する

| 症状 | 考えられる原因 | 修正方法 |
| ----- | ----- | ----- |
| スキーマに存在しないパラメータ | strictモードなしでのモデルの過剰生成 | スキーマが[サポート対象のサブセット](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/strict-tool-use)に含まれる場合は `strict: true` を追加します。 |
| enumの範囲外のパラメータ値 | strictモードの欠如、または大きすぎるenum | enumを縮小するか、有効な選択肢を示す `input_examples` を追加します。 |

## 並列ツール呼び出しが機能しない

| 症状 | 考えられる原因 | 修正方法 |
| ----- | ----- | ----- |
| 並列のほうが適切な場面でClaudeがツールを順次呼び出す | メッセージ履歴のフォーマット | 複数の `tool_result` ブロックを、ターンごとに1つずつではなく、1つのユーザーメッセージにまとめて送信します。[並列ツール使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/parallel-tool-use)を参照してください。 |
| `disable_parallel_tool_use`が無視されているように見える | 会話内で設定するのが遅すぎる | `tool_use`を返すリクエストで設定します。後のリクエストで設定しても、それ以前のツール呼び出しには影響しません。 |

## キャッシュが無効化され続ける

| 症状 | 考えられる原因 | 修正方法 |
| ----- | ----- | ----- |
| すべてのリクエストがキャッシュミスになる | `tool_choice`、思考の設定、または `output_config.effort` がリクエスト間で変化している | `tool_choice` を一定に保つか、`cache_control` のブレークポイントを変化点より前に配置します。キャッシュされた会話の存続期間中は、思考の設定とeffortレベルを一定に保ちます。[プロンプトキャッシングを伴うツール使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-use-with-prompt-caching)および[思考とプロンプトキャッシング](https://platform.claude.com/docs/ja/build-with-claude/thinking#thinking-and-prompt-caching)を参照してください。 |
| 会話の途中でツールを追加するとキャッシュが壊れる | ツールがtools配列の先頭に追加されている | 後から配列に追加する代わりに、最初のリクエストから `defer_loading: true` を指定してツールを宣言し、ツール検索にインラインでロードさせます。 |

## リクエスト時のエラー

エラー列には各メッセージの一部が表示されており、`...` は内容が変わるテキストを表します。

| エラー | 原因 | 修正方法 |
| ----- | ----- | ----- |
| `tool_use ids were found without tool_result blocks immediately after` | 一部の`tool_use` IDに対する`tool_result`が欠落している、または`tool_result`がユーザーメッセージ内の最初のコンテンツブロックになっていない | アシスタントの応答内のすべての`tool_use`ブロックに対して、`tool_result`を1つずつ返します。`tool_result`ブロックはテキストより前に配置します。[ツール呼び出しを処理する](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/handle-tool-calls)および[並列ツール使用](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/parallel-tool-use)を参照してください。 |
| `was found without a corresponding ... block` | フォローアップリクエストによって、待機中のサーバーツールの実行が妨げられている | [サーバーツール呼び出しに結果ブロックがない](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/troubleshooting-tool-use#a-server-tool-call-has-no-result-block)を参照してください。 |
| `Unsupported regex feature in pattern field: ...` | strictツールの `pattern` が、後方参照、単語境界、大きな `{n,m}` 範囲など、strictモードでコンパイルできない正規表現機能を使用している | パターンを簡素化します。[JSON Schemaの制限](https://platform.claude.com/docs/ja/build-with-claude/structured-outputs#json-schema-limitations)を参照してください。 |
| `Invalid regex in pattern field: ...` | strictツールの `pattern` に先読み、後読み、または構文エラーが含まれている | 先読みや後読みを削除し、構文エラーを修正します。[JSON Schemaの制限](https://platform.claude.com/docs/ja/build-with-claude/structured-outputs#json-schema-limitations)を参照してください。 |
| `All tools have defer_loading: true` | モデルから見えるツールがない | 少なくとも1つのツールは即時ロードされる必要があります。ツール検索ツール自体には決して `defer_loading: true` を設定してはいけません。 |

### サーバーツール呼び出しに結果ブロックがない

[サーバーツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/server-tools)は、その`server_tool_use`または`mcp_tool_use`ブロックに結果ブロックがない場合、まだ実行を待機している状態です。エラー`was found without a corresponding ... block`は、フォローアップリクエストによって待機中のツールの実行が妨げられていることを意味します。その理由はエラーメッセージと直前の`stop_reason`からわかります。最初に該当するケースを適用してください。

* **メッセージが``but no `<name>` tool was provided``または`is not available after the last message`で終わる場合：** ここで、`<name>`は`web_search`などのツール名です。リクエストでそのツールが定義されなくなっています。以前と同じ`tools`配列を送信し、MCPツールの場合は同じ`mcp_servers`も送信します。
* **直前の`stop_reason`が`tool_use`だった場合：** ユーザーメッセージの`tool_result`ブロックの後にコンテンツがありました。クライアントの`tool_use`ブロックごとに1つずつ、`tool_result`ブロックのみを送信します。
* **直前の`stop_reason`が`pause_turn`だった場合：** ユーザーメッセージを追加しています。それを削除し、リクエストが一時停止されたレスポンスを含む`assistant`メッセージで終わるようにします。

詳しい手順については、[サーバーツールがまだ待機している場合](https://platform.claude.com/docs/ja/build-with-claude/handling-stop-reasons#when-a-server-tool-is-still-waiting)および[`pause_turn`停止理由](https://platform.claude.com/docs/ja/build-with-claude/handling-stop-reasons#pause-turn)を参照してください。

## エラー: 思考ブロックは変更できません

ツール呼び出し後に会話を継続する際、リクエストが400 `invalid_request_error` で失敗し、そのメッセージに `` `thinking` or `redacted_thinking` blocks in the latest assistant message cannot be modified `` が含まれている場合、アプリケーションがアシスタントの思考ブロックを送り返す前に変更しています。アシスタントメッセージ全体を変更せずにそのまま送り返し、その後に `tool_result` を追加してください。

完全なエラーと修正手順については、[思考ブロックは変更できません](https://platform.claude.com/docs/ja/api/errors#thinking-blocks-cannot-be-modified)を参照してください。

## Claudeがツール結果をプロンプトインジェクションとしてフラグ付けする

| 症状 | 考えられる原因 | 修正方法 |
| ----- | ----- | ----- |
| Claudeがツール結果に基づく行動を拒否する、またはツール結果に含まれていた指示についてユーザーに確認を求める | 独自の指示が `tool_result` のコンテンツ内で渡されている | Claudeは、ツール結果内の指示を信頼できない可能性のあるサードパーティコンテンツとして扱うよう訓練されています。指示をツール結果の外に移動してください。`tool_result` ブロックの後の `user` ターンで送信するか、サポート対象のモデルでは[会話途中のシステムメッセージ](https://platform.claude.com/docs/ja/build-with-claude/mid-conversation-system-messages)で送信します。ツール結果にはデータのみを含めるようにします。[ジェイルブレイクとプロンプトインジェクションの軽減](https://platform.claude.com/docs/ja/test-and-evaluate/strengthen-guardrails/mitigate-jailbreaks#indirect-prompt-injection)を参照してください。 |

## モデルバージョン間のJSONエスケープの違い

| 症状 | 原因 | 修正方法 |
| ----- | ----- | ----- |
| 新しいモデルでツール入力の文字列比較が失敗する | Unicodeおよびスラッシュのエスケープがモデルバージョン間で異なる | `json.loads()` または `JSON.parse()` でパースします。シリアライズされた入力に対して生の文字列マッチングを行わないでください。 |

## 次のステップ

<CardGroup cols={3}>
  <Card title="ツールの定義" href="https://platform.claude.com/docs/ja/agents-and-tools/tool-use/define-tools">
    Claudeを適切なツールへ導くスキーマと説明を記述します。
  </Card>

  <Card title="ツール呼び出しの処理" href="https://platform.claude.com/docs/ja/agents-and-tools/tool-use/handle-tool-calls">
    ツールを実行し、必要なメッセージ形式で結果を返します。
  </Card>

  <Card title="ツールリファレンス" href="https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-reference">
    Anthropic提供のツールとそのバージョン文字列の完全な一覧です。
  </Card>
</CardGroup>
