CLAUDE_CODE_MAX_OUTPUT_TOKENSを解説：Claude Code 2.1.265の出力上限とプラグインフォルダー

claude_code_max_output_tokensが制御するもの

環境変数リファレンスでは、 CLAUDE_CODE_MAX_OUTPUT_TOKENS を「ほとんどのリクエストの最大出力トークン数」を設定するものと説明しています。この表現は重要です。これはリクエストの出力予算を指しており、そのデフォルト値と上限はモデルによって異なります。

したがって、この変数はClaude Codeの出力制限を調べる際に関係します。ただし、Claude Codeが扱うあらゆる種類のデータに共通する制限として扱うべきではありません。バージョン2.1.265では、保存されたツール結果に対するディスク容量の制限も導入されていますが、その制限は保存されたツールデータをギガバイト単位で測るものであり、生成出力をトークン単位で測るものではありません。

設定ドキュメントには、過去の情報を扱ううえで留意点があります。 環境変数リファレンス は継続的に更新されており、9月10日時点の正確な版は入手できませんでした。その説明から変数の目的は分かりますが、このページではClaude Code 2.1.265に適用されていたすべてのデフォルト値を確定できません。

日付を明示した記事では、数値に関する最も確かな根拠は、バージョンタグ付きのリリースノートです。これらのリリースノートからは、現在のドキュメントから完全なデフォルト値の一覧を推測することなく、過去の具体的な変更を確認できます。

区別すべき制限

制限を診断する際は、まずどの制限が該当するかを特定してください。トークン予算の設定とディスクストレージの上限は、同じ開発セッション中に現れる場合でも、異なる解釈が必要です。

確認済みのデフォルト値と最大出力制限

この v2.1.77のリリースノートには、2026年3月17日付で、関連する変更が記載されています。Claude Opus 4.6のデフォルト出力トークン数が64kに増加し、Opus 4.6とSonnet 4.6の上限が128kトークンに増加しました。これらの変更は、v2.1.265タグ付きの変更履歴にも記録されています。

この根拠から、「デフォルト32,000、最大64,000」をClaude Code全体に共通するルールとして示すことはできません。また、他のモデルについて不明なデフォルト値を補う根拠にもなりません。

慎重に区別すべきなのは、ドキュメントに記載された変更と、完全な設定リファレンスです。3月のリリースからは上記の変更を確認できますが、入手できた日付付きの情報源では、v2.1.265のモデル別デフォルト値の完全な一覧は確定できません。

新しいモデルの仕様からCLIのデフォルト値は確定できない

この モデルのリリースノート には、Claude Sonnet 5、Claude Opus 5、Claude Fable 5.1について、最大出力128kと1百万トークンのコンテキストウィンドウが記載されています。各モデルの正確なAPI IDは順に claude-sonnet-5, claude-opus-5、および claude-fable-5-1です。

これらの発表は、公開基準日より前に行われていました。Sonnet 5は6月30日、Opus 5は7月24日、Fable 5.1は2026年9月1日です。ただし、これらのモデル仕様は、Claude Codeのデフォルトのリクエスト予算を示す根拠ではありません。

モデルを選ぶ開発者には、 Claude Codeモデルガイド が関連する参考資料になります。モデルの公開された最大値と、CLIが使用するデフォルトの出力予算は区別してください。

変数の設定とコンパクションの理解

現在のドキュメントでは、変数を設定してから claudeを起動する方法、または変数を env キーの下に配置する方法が、 settings.jsonで説明されています。9月10日時点で公開されていたドキュメントの正確な版は入手できなかったため、以下の例は、その歴史的な留意点を伴う、ドキュメントに記載された設定パターンです。

シェルでの設定

提示されたシェルの例では、出力予算を64,000トークンに設定しています。

export CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000

ドキュメントに記載された方法は、Claude Codeを起動する前に変数を設定するものです。この例の数値は、設定値として選ばれたものです。64,000がすべてのモデルのデフォルト値や最大値であると主張するものではありません。

プロジェクトやトラブルシューティングセッションの設定を記録する際は、要求する予算と併せて、選択したモデルを明記してください。モデルが分からなければ、値だけでは、ドキュメントに記載されたデフォルト値と一致するか、記載された上限内に収まるかを説明できません。

settings.jsonでの設定

同等の設定を示す、提示されたJSONの例では、変数を次のキーの下に配置しています。 env:

{"env":{"CLAUDE_CODE_MAX_OUTPUT_TOKENS":"64000"}}

この例では、値は文字列です。シェルでの設定と同様に、このスニペットは要求する予算を表すものであり、モデル固有のデフォルト値を証明するものではありません。

関連するコマンドラインの使用方法については、 Claude Code CLIリファレンスを参照してください。ここでの過去の根拠は、変数の役割と提示された設定例を裏付けていますが、v2.1.265のデフォルト値の全容は未確定のままです。

コンパクションについて確認されていること

v2.1.265タグ付きの変更履歴には、以前のv2.1.69で行われた、 CLAUDE_CODE_MAX_OUTPUT_TOKENS が会話のコンパクション中に無視される問題の修正が記録されています。これは、この設定とコンパクションの動作との間に確認された関連です。

現在の環境変数リファレンスには、この設定値を増やすと、自動コンパクションが行われるまでに利用できる実効コンテキストが減ることも説明されています。この説明の公開日は不明なため、9月10日時点で確認された説明として示すことはできません。

したがって、この設定を、モデルの公開されたコンテキストウィンドウを拡大するものとして説明すべきではありません。日付付きの根拠から確認できるのは、出力予算の制御とコンパクションに関連する修正です。v2.1.265の各モデルについて、正確なコンパクションのしきい値を確定するものではありません。

Claude Code 2.1.265によるプラグインフォルダーの読み込み方法

Claude Code v2.1.265 は2026年9月8日にリリースされ、リリースコミットは 8e02f6dです。フォルダー読み込みの変更により、 --plugin-dir で複数のプラグインを含むフォルダーを指定できるようになりました。

提示された起動コマンドは次のとおりです。

claude --plugin-dir ./plugins

このリリースでは、検出ルールを「マニフェストを持つ各子フォルダーが読み込まれる」と明確に説明しています。また、Claude Codeの実行中に追加と削除が検出されることも記載されています。

これにより、複数のプラグインをまとめて管理する際には、親フォルダーが有用な管理単位になります。ドキュメントで保証されているのは、マニフェストを含む子フォルダーに関する動作です。リリースノートでは再帰的な検出は規定されていません。任意の深さにネストされたディレクトリツリーが検索されると想定しないでください。

マニフェストの配置と過去の情報に関する留意点

現在のプラグインリファレンスでは、マニフェストを .claude-plugin/plugin.json に配置し、 skills/, commands/、および hooks/ などのコンポーネントディレクトリをプラグインのルートに配置しています。このリファレンスの、日付が確認できるv2.1.265時点のスナップショットは入手できませんでした。

9月10日付の記事では、現在の配置に関するガイダンスと、リリースが明示的に保証する「マニフェストを持つ子フォルダーが読み込まれる」という動作を区別してください。このリリースからは、複数のプラグインを含むフォルダーの検出を確認できますが、当時の配置ドキュメントのすべての詳細を確定することはできません。

リリースに含まれるプラグインの修正

バージョン2.1.265では、以下のプラグインの問題も修正されています。

• バックスラッシュを含むプラグインパスによって、macOSとLinuxでシンボリックリンクの包含制約を回避できる場合がありました。
• ドットが連続して並ぶ名前で始まるディレクトリが、誤って拒否されていました。
• 読み取り不能なデフォルトのコンポーネントフォルダーは、通知なくスキップされていました。現在は、 /plugin にエラーコード付きで表示されます。

これらの修正は、プラグインパスとコンポーネントの読み込みに関するものです。プラグインフォルダーを読み込めない場合、関連するリリース情報として役立ちますが、出力トークンの設定では、これらのディレクトリ処理の問題は説明できません。

保存されたツール結果の1 GBの上限は別の制限

バージョン2.1.265では、ディスクに保存されるツール結果に1 GBの上限が追加されています。会話プレビューには、切り詰めが報告されます。

この制限は、保存されたツールデータに関するものです。 CLAUDE_CODE_MAX_OUTPUT_TOKENS は、ほとんどのリクエストの最大出力トークン数に関するものです。リリースでは、この環境変数がディスク容量の上限を制御するものとは説明されていません。そのため、値を増やすことを、保存されたツール結果の切り詰めに対する解決策として示すべきではありません。

また、リリースノートでは、1 GBの上限が結果ごと、セッションごと、あるいは別の単位で適用されるのかも規定されていません。動作を文書化する際は、この不確実性を保ってください。確認されている説明は「ディスクに保存されるツール結果に1 GBの上限」です。

トラブルシューティングでは、開発者に表示される根拠を区別すると役立ちます。切り詰めを報告する会話プレビューは、保存された結果に関する新しい動作に関連します。モデルの生成出力予算に関する疑問は、選択したモデルとトークン設定に関係します。 /plugin に表示されるプラグインのエラーコードは、プラグインの読み込みに関係します。

これらは、同じリリースの文脈で導入または説明された、別個の制御機能と診断機能です。別々に扱うことで、トークン設定の変更を、無関係なストレージやフォルダーの挙動の説明に使うことを防げます。

9月10日までに利用可能になったゲートウェイの後続リリース

バージョン2.1.266も9月8日にリリースされたため、この記事の対象期間に含まれます。その v2.1.266のリリースノート v2.1.265で発生した、次に関連するゲートウェイ認証のリグレッションを修正します： CLAUDE_CODE_USE_GATEWAY.

該当するエラーは「Cloudゲートウェイにサインインしていません」です。リリース情報には、設定変更は不要と記載されています。

v2.1.265でまさにこのリグレッションに遭遇した開発者にとって、後続リリースは直接関係します。出力トークンの予算を増やすことやプラグインフォルダーを再構成することは、文書に記載された修正方法ではありません。

同じワークフローは、AI Prime TechなどのAPIゲートウェイ経由でも実行できます。次を参照してください。 APIキーを使ったClaude Codeの利用 関連するセットアップ手順を参照してください。AI Prime Techは独立して運営されており、AnthropicやOpenAIとは提携していません。

重要なポイント

• CLAUDE_CODE_MAX_OUTPUT_TOKENS は、ほとんどのリクエストで出力トークンの最大数を設定します。デフォルト値と上限はモデルによって異なります。
• v2.1.77では、Opus 4.6のデフォルト値が64kに、Opus 4.6/Sonnet 4.6の上限が128kに引き上げられました。v2.1.265の完全なデフォルト値一覧は、まだ検証されていません。
• モデルの最大出力、モデルのコンテキスト容量、保存されるツール結果のストレージには、それぞれ別の制限があります。
• v2.1.265では、 --plugin-dir は、マニフェストを持つ子フォルダーから複数のプラグインを読み込み、実行中に追加と削除を検出できます。
• v2.1.265では、保存されるツール結果に1 GBの上限が導入されました。v2.1.266では、設定変更を必要とせずにゲートウェイ認証のリグレッションが修正されます。

よくある質問

CLAUDE_CODE_MAX_OUTPUT_TOKENSは何を制御しますか？

CLAUDE_CODE_MAX_OUTPUT_TOKENS は、ほとんどのリクエストで出力トークンの最大数を設定します。デフォルト値と上限はモデルによって異なり、v2.1.265で導入された、ディスクに保存するツール結果の1 GBという上限とは別のものです。

出力のデフォルト値と最大上限はいくつですか？

v2.1.77では、Claude Opus 4.6のデフォルト値が出力トークン64kに、Opus 4.6/Sonnet 4.6の上限が128kに引き上げられました。確認した日付付きの資料では、Sonnet 4.6のデフォルト値や、v2.1.265のモデル別の完全なデフォルト値一覧は確定できません。

設定値を上げるとコンテキストウィンドウは広がりますか？

文書に記載された目的は、出力トークンの予算を設定することであり、モデルの公表されたコンテキストウィンドウを広げることではありません。v2.1.69では、コンパクション中にこの変数が無視される問題が修正されました。ただし、現在公開されているドキュメントにある、自動コンパクションへの影響の説明は、公開日が不明確です。

--plugin-dirはどのように複数のプラグインを検出しますか？

Claude Code 2.1.265では、 --plugin-dir に親フォルダーを指定でき、マニフェストを持つ各子フォルダーが読み込まれます。Claude Codeの実行中に追加と削除が検出されます。再帰的な検出については、リリースノートに記載されていません。