Claude Code で長い出力の途中に API Error: Claude's response exceeded the 32000 output token maximum. と出て止まったときの手順です。まず continue と送って続きを出させ、同じことが繰り返されるなら、CLAUDE_CODE_MAX_OUTPUT_TOKENS を上げるか、出力を 1 ファイル・1 節ずつの小さな単位に分けて頼みます。
確認環境は Claude Code 2.1.319、macOS、2026-11-09 です。
症状
返答の途中で、次のエラーが出ます。数字は 32000 が多く、モデルによって変わります。
API Error: Claude's response exceeded the 32000 output token maximum. To configure this behavior, set the CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable.
環境変数を設定してあるのに出る場合は、次の形になっていることがあります。
API Error: Claude's response exceeded the 64000 output token maximum for a request sent without streaming. The CLAUDE_CODE_MAX_OUTPUT_TOKENS environment variable cannot raise this limit.
issue #24055 では、大きな実装を頼んで 8 分ほど考えたあとにこのエラーが出て、画面上はまだ考えている表示が続いたという報告があります。
結論
- 1 回の返答(思考の分も含む)が、その要求で許された出力トークン数の上限に達して、途中で切られた状態です。
- 途中まで書かれた文章があるなら、対話画面で
continueと送れば続きを出させられます(公式)。 - 繰り返すなら、
CLAUDE_CODE_MAX_OUTPUT_TOKENSを上げます。ただし上限はモデルごとに決まっていて、それを超える値は下げられます。 - 根本的には、1 回の返答で書かせる量を減らします。1 返答につき 1 ファイル、1 節にします。
原因
公式の Error reference(Response exceeded the output token maximum)は、「返答が、その要求で許された最大の出力トークン数に達して、そこで切られた」としています。
出力トークンに数えられるのは、画面に見える文章だけではありません。公式の費用のページは、思考(extended thinking)のトークンも出力トークンとして課金されると書いています。長く考えさせたうえに大きなファイルを一度に書かせると、思考と本文の合計が上限に達しやすくなります。この「思考も上限を食う」という点は、公式の記述からの私の整理です。
もうひとつの形(for a request sent without streaming)について、公式は次のように説明しています。ストリーミングの要求が失敗して、Claude Code が非ストリーミングで送り直した場合、返答は 64,000 出力トークンまでに制限されます。この形では環境変数で上限を上げられません。v2.1.299 より前は、この送り直しで切られても、メッセージなしで返答が終わったように見えていたそうです。
手元で確かめた結果
エラーの文言そのものは、インストールされている Claude Code 本体の中に入っています。本体のファイルを読むだけのコマンドで確かめました(通信も課金もありません)。
2 つの形が、どちらも本体に入っていることが確認できます。${n} の部分に実際の上限値が入って画面に出ます。
このエラー自体を手元で再現することはしていません。再現するには長い返答を実際に生成させる必要があり、課金が発生するためです。以降の対処は、公式のドキュメントと issue の報告に基づいています。
直し方
1. まず continue
返答が途中まで出ているなら、対話画面で次のように送ります。
continue
公式は、切られるまでに書かれた文章は会話に残るので、続きを頼めると書いています。
2. 環境変数を上げる
シェルで設定してから claude を起動します(公式の環境変数のページにある設定方法です)。
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000
claude
毎回の起動で使うなら、~/.zshrc や ~/.bashrc に同じ export の行を足します。設定ファイル(settings.json の env)に書いても同じ効果になります。
注意点が 2 つあります。
- 公式は、この値を上げると、自動圧縮が働く前に使える実質のコンテキスト窓が小さくなると書いています。むやみに大きくしないほうが安全です。
- 公式によると、モデルごとの上限より大きい値は上限に下げられます。Claude Code が知らないモデル ID では、既定が 32000、上限が 128000 です。
3. 出力を分けて頼む
公式が挙げているもうひとつの対処です。「1 つのファイル、1 つの節ずつ」のように、返答を小さく区切ります。たとえば次のように頼みます。
まず設計の方針だけ書いてください。コードはまだ書かないでください。
次に、src/api.ts だけを書いてください。ほかのファイルは次の返答で書きます。
大きなファイルを 1 回の返答で丸ごと書かせるより、骨組みを作らせてから、関数ごとに追記させるほうが、上限に当たりにくくなります。
直らないとき
環境変数を設定したのに 32000 のまま
issue #24159 では、CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000 を設定しても 32000 のままだという報告がありました(2026-02、Claude Code 2.1.37、Opus 4.6)。この issue には、メンテナーの ashwin-ant からの 2026-04-19 付けのコメントがあり、v2.1.42 で修正済みで、Opus 4.6 では 64K まで効くようになったと書かれています。古い版を使っているなら、まず更新してください。
claude --version
claude update
最新版でも再現する場合は、版と再現手順を添えて issue に書くよう、同じコメントで求められています。
長い思考のあとに出る
issue #24055 には、「複雑な依頼で思考が長くなったあとに出る」という報告が多く寄せられています(2026-11 時点で 👍 86、コメント 139)。issue は、一度 completed になったあと再び open になっています。推測ですが、思考と本文の合計で上限に当たるので、依頼を小さく分けるのが確実です。思考の量を減らす(effort を下げる)案も、この issue の周辺で挙がっていますが、効果は報告ごとに違います。
for a request sent without streaming の形が出るとき
環境変数では上げられません。公式の対処は、出力を小さく分けることです。この形が頻繁に出るなら、推測ですが、ネットワークやプロキシでストリーミングが失敗している可能性があります。その場合は、ストリームが途中で止まる系のエラーの記事も参考になります。
同じ原因で出る別のメッセージ
-
API Error: 400 ... max_tokens must be greater than thinking.budget_tokensは、思考の予算が出力上限以上になっている場合に出ます。公式の対処は、同じくCLAUDE_CODE_MAX_OUTPUT_TOKENSを思考の予算より上に上げることです。 - 会話が長すぎて出る
Prompt is too longは、入力側の上限の話で、原因が別です。
Claude Code で出るほかの英文エラーと、それぞれの対処は、早見表にまとめています。
参考
- 公式 Error reference(Response exceeded the output token maximum): https://code.claude.com/docs/en/errors#response-exceeded-the-output-token-maximum
- 公式 Environment variables(CLAUDE_CODE_MAX_OUTPUT_TOKENS): https://code.claude.com/docs/en/env-vars
- 公式 Manage costs(思考トークンは出力として課金): https://code.claude.com/docs/en/costs
- issue #24055(32000 output token maximum): https://github.com/anthropics/claude-code/issues/24055
- issue #24159(環境変数が効かない。2.1.42 で修正): https://github.com/anthropics/claude-code/issues/24159
