【解決方法】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」の節です。
公式のドキュメントの環境変数のページの CLAUDE_CODE_MAX_OUTPUT_TOKENS の行です。
公式のドキュメントのエラー一覧の最初には、出た文から節を探せる表があります。
解決方法
関連するエラー
出力の上限や、返事の途中で出るエラーには、ほかに次のものがあります。
| 表示される文 | 意味 |
|---|---|
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 で上限を上げてみてください。
参考文献
著書
挙動Codex 画面を閉じても実は動いてた?常駐プロセスの動きについて検証してみた
挙動Homebrew で入れた Claude Code。更新しているつもりが、古いまま使ってませんか?
使い方Claude Code の拡張機能 2.1.312、2.1.313 は偽物。皆さんの Cursor は大丈夫ですか?
使い方知らぬ間に追加された大量のプラグインやフックが、毎回実行され続けていない? 皆さんの Claude Code は大丈夫ですか?
使い方npm のマルウェアが18日で1,753件! 気づいたら、あなたの GitHub に鍵の一覧が公開されているかも
使い方パスワードが GitHub で丸見えに? 原因は、Claude Code の確認で選んだ「Yes, and don't ask again」
使い方その OpenCode、脆弱性の告知がないからと安心してない? 今のままだと乗っ取られるかも
挙動Codex 画面を閉じても実は動いてた?常駐プロセスの動きについて検証してみた
挙動Homebrew で入れた Claude Code。更新しているつもりが、古いまま使ってませんか?
使い方Claude Code の拡張機能 2.1.312、2.1.313 は偽物。皆さんの Cursor は大丈夫ですか?
使い方知らぬ間に追加された大量のプラグインやフックが、毎回実行され続けていない? 皆さんの Claude Code は大丈夫ですか?
使い方npm のマルウェアが18日で1,753件! 気づいたら、あなたの GitHub に鍵の一覧が公開されているかも



