SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor

Claudeのこのターンのツール使用上限とは

「このターンのツール使用上限」はプランのクォータ超過とは別です。Claudeが1回の応答で使えるツール呼び出しを使い切った場合の意味と、すぐ作業を再開する方法を説明します。

このターンのツール使用上限が意味すること

このターンのツール使用上限は、アカウントの利用上限に達したためではなく、1 回の応答で使用できるツール呼び出し回数を使い切ったため、Claude が応答の途中で停止したことを意味します。停止するまでに取得した情報は、すべて会話に残っています。続行するようにもう一度メッセージを送ると、新しいターンが開始され、新しい上限が適用されます。

Agent SDK では、ターンはエージェントループを 1 回実行することを指します。Claude がツール呼び出しを含む出力を生成し、クライアントがそれらのツールを実行します。その結果が Claude に返され、次の判断に使われます。このサイクルは、制御がユーザーに戻ることなく繰り返されます。Claude がツール呼び出しを含まない応答を生成すると、ループは終了します。SDK のターン上限では、ツール呼び出しを含まない最終応答も 1 回の実行として数えます。

プランの使用量上限は別の制御です

プランの上限は、一定期間内に使用した量を数えます。2026年11月9日時点で確認した Anthropic のエラーメッセージに関するヘルプセンターのページでは、上限に近い場合は Approaching session limit、上限を超えた場合は 5-hour limit reached - resets [time] と表示されます。週次上限にも、リセットされる曜日と時刻を示す同様のメッセージがあります。いずれの場合も、時刻が明記されます。使用クレジットがなければ、その時刻まで待つことで解消し、それまでに入力しても状況は変わりません。有料プランで使用クレジットを有効にしている場合、ページの説明では、代わりにクレジットを使って作業が継続され、メッセージは 5-hour limit resets [time] - continuing with usage credits になります。この継続は、月間支出上限に達するか、auto-reload を無効にした状態でクレジット残高がなくなると終了します。Verified Ultra アカウントには5時間のセッション上限はありませんが、週次上限は適用されます。

tool use メッセージは、これとは逆の動作をします。タスクの途中で表示され、続けて1通メッセージを送るだけで、作業を直ちに継続できます。すでに実行された tool call は、プランの使用量に引き続き算入されます。継続してもクォータはリセットされません。また、プランの上限に達した後も、使用クレジットによって作業を継続できる場合があります。クォータの場合は、Claude が上限に達したと表示した場合の対処方法に選択肢がまとめられており、Claude の使用量上限の計算方法で、その基準となる期間を説明しています。

1 回のターンにツール予算が必要な理由

ツールを 1 回呼び出すたびにコンテキストを消費します。呼び出しが送信され、ツールが実行され、結果全体が会話に戻されます。大きなファイルを 1 つ読み込んだり、出力が長いコマンドを 1 つ実行したりするだけで、1 回の手順に数千トークンを使うことがあります。そのテキストはセッションの残りの間、コンテキストに保持されます。Anthropic の agent loop のドキュメントは、この結果を明確に説明しています。ターンを重ねるとコンテキストが蓄積するため、多数のツール呼び出しを含むセッションは、短いセッションよりはるかに多くのコンテキストを消費します。

ターンに予算を設定すると、進展しなくなったループを停止できます。検索し、読み込み、再度検索しても何も見つからないエージェントは、割り込みがない限り処理を続けます。予算がその割り込みになります。予算に達すると、作業を方向転換できる時点で制御が戻ります。これは、コンテキストウィンドウの終端までループを実行させるよりも、はるかに少ないコストで済みます。

API でこの上限を確認できる場所

Anthropic の公開エラー文書には、Claude チャットアプリの 1 ターンあたりのツール呼び出し回数が記載されていません。そのため、そこで読んだ正確な数値は推測です。同じ種類の上限は API(application programming interface)について文書化されています。実際の動作は、その文書で確認できます。

Messages API のレスポンスにある stop_reason フィールドは、生成が停止した理由を示します。文書化されている値は end_turn、max_tokens、stop_sequence、tool_use、pause_turn、refusal、model_context_window_exceeded です。このガイドの状況に該当する値は 2 つあります。

pause_turn は、Web 検索などのサーバー側ツールを実行中に、サーバー側のサンプリングループが反復回数の上限に達した場合に返されます。2026年10月25日時点では、stop reasons and fallback ページに、デフォルト値はリクエストあたり 10 回と記載されています。文書に記載された対処方法は、レスポンスを変更せず assistant メッセージとして返すことです。これにより、Claude は停止した位置から処理を続けます。続行を求める新しい user メッセージは追加しません。文書の例でも、元の user メッセージと、停止した assistant の内容だけを送信しています。

max_tokens は、リクエストで設定した出力トークン上限にレスポンスが達したことを示します。不完全な tool use ブロック内で切り詰められた場合、そのツール呼び出しは実行できません。文書に記載された対処方法は、より大きな max_tokens を指定して再試行することです。

ここに記載した値をそのまま信用せず、stop reasons and fallback ページ で現在の値を確認してください。このページのデフォルト値は変更されるため、古い数値は数値がない場合よりも問題になります。

チャットでツール呼び出しを使い切る原因

  • 自然な終了点がない質問。「Xについて書かれたものをすべて探す」と依頼しても、検索が完了したことをモデルに伝える情報がありません。
  • 同じ資料を何度も読み直す。モデルが想定した場所に答えがない場合に発生します。
  • 大きなツール結果。長い Web ページや大きなファイルを1つ読み込むだけで、ターンの残りに必要な余地が失われます。
  • 1つのメッセージに複数の独立した作業を含める。各作業に独自のツール呼び出しが必要ですが、すべて同じ予算から消費されます。
  • このタスクで使用しない connectors や MCP (model context protocol) servers。読み込まれると、各項目が会話内の領域を消費し、モデルがターン内で選べる操作も増えます。

回答を最後まで完了させる方法

「continue」と返信するか、まだ不足している内容を示す短い指示を送ってください。これにより、新しい予算を持つ新しいターンが開始されます。以前の会話は引き続きコンテキストに含まれるため、Claude はすでに実行したツール呼び出しを繰り返さずに作業を再開します。

同じ場所で2回停止した場合は、1ターンにはタスクの範囲が広すぎます。タスクを分割してください。リポジトリ全体の監査を依頼する代わりに、まずファイル一覧を取得し、その後は1メッセージにつき1ファイルについて尋ねます。大きな1ターンでは完了できない作業でも、小さな4ターンに分ければ完了できます。

モデルが探す対象を絞ってください。正確なファイルパスやエラー文字列を指定し、すでにログがある場合は貼り付けます。ログを貼り付ける場合は1メッセージで済みます。モデルにログを探させると複数のツール呼び出しが必要になり、誤ったログを見つける可能性もあります。

現時点で不要な connectors は無効にしてください。Anthropic のヘルプセンターによると、各 connector は会話内の領域を消費します。デフォルトの Auto 設定では、Claude が読み込む connector を選択します。一方、Always available では最初にすべて読み込まれます。読み込まれた connector はそれぞれコンテキストを消費し、モデルが選択できる操作の範囲を広げます。多数の connector を保持する場合は、On demand 設定にすると、Claude が適切な connector を検索した後にのみ読み込まれます。同じ考え方は長時間の coding session にも当てはまります。Claude Code session のコンテキストを小さく保つ方法 が、最後まで完了する agent と途中で停止する agent の違いになります。

エージェントを実行するときはターン予算を自分で設定する

自分のコードから Claude を制御する場合、ループのターン予算は自分で設定します。Claude Agent SDK(ソフトウェア開発キット)では、Python の max_turns と TypeScript の maxTurns が提供されており、ツール呼び出しを伴うターンと、最後のテキストのみの応答を合わせてカウントします。ドキュメントに記載されたデフォルト値は無制限です。

上限に達すると、SDK は subtype が error_max_turns である結果を返します。また、単発の query() 呼び出しでは、Reached maximum number of turns というテキストを含むエラーが発生します。Agent SDK のエージェントループのページには、この単発実行時のエラーで、基盤となる Claude Code プロセスが 0 以外の終了コードを返すことも記載されています。結果には num_turns と session_id も含まれるため、タスクを最初からやり直すのではなく、上限を増やして同じセッションを再開できます。

CLI(コマンドラインインターフェース)では、同じ制御をフラグで指定します。この設定は print mode にのみ適用されます。

claude -p --max-turns 3 "summarise the failing tests"

フラグのリファレンスによると、デフォルトでは上限がありません。--input-format stream-json を指定すると、上限に達した時点でキューに残っているメッセージはそのまま保持されます。次のターンが開始されると、そのメッセージが新しいターンの上限で処理されます。同じ考え方を支出額に適用した設定もあります。Python の max_budget_usd と TypeScript の maxBudgetUsd は、ターン数ではなく支出額のしきい値に達した時点でループを停止します。subagent の支出も合計に含まれます。予算はモデルの応答が到着した後に確認されるため、上限に達した応答の分だけ支出が上限を超えることがあります。また、停止する前に完了したバックグラウンドの subagent の分も加算されます。月額制のサーバーでエージェントを実行する場合は、長時間の実行を始める前に VPS 上で AI エージェントのコストを制御する方法 を設定しておくとよいでしょう。

承認待ちによる一時停止は別の状態です。エージェントが停止し、支出も発生していない場合は、ターン数ではなく permission_mode を確認してください。人間の回答を待つツールが停止している可能性があります。Claude Code の自動モードと権限設定では、確認を求めるモードと、確認なしで実行するモードについて説明しています。

自分で現在の動作を確認する方法

ここで説明する動作は告知なく変わるため、このガイドに記載された数値は固定値ではなく、作成時点の情報として扱ってください。現在の仕様は、次の2か所で確認できます。

  • 停止理由に関する API ドキュメント。サーバーツールの反復回数のデフォルト値と、その上限を超えて処理を続行する方法が記載されています。
  • エラーメッセージに関する Anthropic のヘルプセンターのページ。使用量の上限に関する文言が記載されています。2026年11月9日時点で、このページには5時間および週次の使用量メッセージが記載されています。使用量クレジットに切り替わった場合に表示される文言も含まれますが、ターンごとのツール上限については何も記載されていません。そのため、ここではチャットアプリの公式な数値を示していません。

代わりに、自分の実行結果を測定してください。Claude Code では、/context を使うと現在のコンテキスト使用量を色付きのグリッドで表示し、使用量の大部分を消費しているツールを確認できます。/compact は、それまでの会話を要約して空き容量を確保します。Agent SDK では、すべての結果に num_turns が含まれるため、上限値を決める前に、一般的なタスクで実際に必要となるターン数を確認できます。自分のワークロードから得た数値のほうが、フォーラムの投稿にある数値より信頼できます。

FAQ

ツール使用制限は、Claude の利用制限と同じですか?

いいえ。利用制限は、一定期間内に使用した量を数え、いつリセットされるかを示すものです。そのため、解決策は待つことです。ツール使用メッセージは、1 回の応答でツール呼び出しを使い切ったため、応答の途中で処理を停止したことを示します。別のメッセージを送ると、新しい予算で新しいターンがすぐに始まります。ツールの使用量もプランの利用量として計上されます。Claude の利用制限のカウント方法で、クォータについて詳しく説明しています。

途中で停止したタスクを Claude に完了させるにはどうすればよいですか?

もう 1 件メッセージを送ります。「Continue」でも機能しますが、残っている作業を明示した指示のほうが効果的です。すでに保持しているコンテキストをモデルが再構築する必要がなくなるためです。2 回目も同じ箇所で停止する場合は、タスクを小さく分割し、1 件ずつメッセージで送ります。正確なファイルパスを指定するか、内容を直接貼り付けると、最初に予算を消費した検索処理を省けます。

「límite de uso de herramientas」または「limite de uso de ferramentas」とはどういう意味ですか?

これらは同じメッセージをスペイン語とポルトガル語で表したものです。通常は「límite de uso de herramientas en este turno」または「limite de uso de ferramentas neste turno」と表示されます。どの言語でも意味は同じです。Claude が 1 回の応答内で許可されたツール呼び出しを使い切ったことを示し、プランのクォータは関係ありません。解決策も同じです。続行するよう返信するか、依頼を小さな手順に分割します。課金上限の場合は別のメッセージが表示され、リセット時刻が示されます。

プランをアップグレードすると、1 ターンあたりのツール使用制限は増えますか?

プランのレベルと、ターンごとのツール予算は別の制御項目です。アップグレードで増えるのは、一定期間内に使用できる量です。リセット時刻が示されるのは、この制限です。1 回の応答で実行できるツール呼び出し数は、モデルを実行するループの仕様です。Anthropic は、チャットアプリについてこの数値を公開していません。実際に有効なのは、どのプランでもタスクを小さなターンに分割することです。

自分の agent が数回のツール呼び出しだけで停止するのはなぜですか?

上限を設定していないか確認します。Claude Agent SDK では Python に max_turns、TypeScript に maxTurns を指定でき、コマンドラインインターフェースでは print mode に --max-turns を指定できます。いずれかの上限に達すると、SDK は subtype が error_max_turns である結果を返します。単一実行の query() 呼び出しでは、Reached maximum number of turns というテキストを含むエラーが発生します。どちらもデフォルトは無制限です。上限を設定していないのに実行が停止する場合は、結果の stop_reason を確認します。max_tokens は出力上限に達したことを示し、pause_turn はサーバーのツールループが反復回数の上限に達し、続行できるよう応答を返す必要があることを示します。

この記事は役に立ちましたか?