T-CREATOR

<div />

【解決方法】Claude Code で出る「response exceeded the 32000 output token maximum」の原因と対処: 頼む量を分けるのが確実

2026年10月30日
【解決方法】Claude Code で出る「response exceeded the 32000 output token maximum」の原因と対処: 頼む量を分けるのが確実

Claude Code に長い出力を頼むと、途中で Claude's response exceeded the 32000 output token maximum が出て止まることがあります。

claude -p で同じことを頼むと、途中までの出力も出ずに、エラーだけが返ってきました。

出たときの表示と、直るまでにしたことを残しておきます。

環境

  • macOS 26.6
  • Claude Code 2.1.309

発生したエラー

上限を20にして実行すると、次のように表示されます。

terminal$ CLAUDE_CODE_MAX_OUTPUT_TOKENS=20 claude -p "1から30までの数字を、1行に1つずつ、数字だけ出力してください"
API Error: Claude's response exceeded the 20 output token maximum. To configure this behavior, set the CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable.
$ echo "exit code: $?"
exit code: 1

上限を変えていないときは、20 の部分が 32000 になります。

原因

Claude の1回の返事が、出力トークンの上限に達したことが原因です。頼んだ量が1回の返事に収まらなかったためで、Claude Code の故障ではありません。対話画面では、切れるたびに3回まで自動で続きを頼み、4回目でこのエラーになります(Claude Code の CLAUDE_CODE_MAX_OUTPUT_TOKENS の動き)。

公式のドキュメントのエラー一覧の「Response exceeded the output token maximum」の節です。

公式のドキュメントのエラー一覧の Response exceeded the output token maximum の節

公式のドキュメントの環境変数のページの CLAUDE_CODE_MAX_OUTPUT_TOKENS の行です。

公式のドキュメントの環境変数のページの CLAUDE_CODE_MAX_OUTPUT_TOKENS の行

公式のドキュメントのエラー一覧の最初には、出た文から節を探せる表があります。

公式のドキュメントのエラー一覧の Find your error の表

解決方法

関連するエラー

出力の上限や、返事の途中で出るエラーには、ほかに次のものがあります。

表示される文意味
exceeded the ... output token maximum for a request sent without streamingストリーミングが失敗して送り直したリクエストが、上限(64,000トークン)に達した。環境変数では上げられないので、頼む量を減らす
API Error: 400 ... max_tokens must be greater than thinking.budget_tokens出力の上限を、考える量(thinking)の上限より小さくした。CLAUDE_CODE_MAX_OUTPUT_TOKENS を大きくする
picking the thought back up (2 of 3)上限で切れた返事の続きを、自動で頼んでいる途中
Server error mid-response. The response above may be incomplete.返事の途中でサーバー側のエラーが起きた。上の返事は途中までの可能性がある
API Error: No response from APIサーバーから返事がなかった
API Error: Stream idle timeout - no chunks received返事のデータが一定時間届かなかった
API Error: Server is temporarily limiting requests (not your usage limit)サーバー側で一時的にリクエストを制限している。自分の利用上限ではない

上限のエラー以外は、頼む量ではなく通信やサーバーの状態が原因です。

注意点

まとめ

response exceeded the 32000 output token maximum が出たら、1回に頼む量を減らすのがいちばん確実です。claude -p では、途中までの出力も残らずにエラーだけが返ってきます。

どうしても分けられないときだけ、CLAUDE_CODE_MAX_OUTPUT_TOKENS で上限を上げてみてください。

参考文献

著書

とあるクリエイター

フロントエンドエンジニア Next.js / React / TypeScript / Node.js / Docker / AI Coding

とあるクリエイターのプロフィール