環境変数

CLAUDE_CODE_MAX_CONTEXT_TOKENS

1 に設定すると、LLM ゲートウェイのエイリアスなど、Claude Code が認識できないモデル ID の場合に、事前の自動コンパクションをスキップする。この変数がない場合、Claude Code はその ID に対して想定したコンテキストウィンドウでコンパクションを行う。代わりに CLAUDE_CODE_MAX_CONTEXT_TOKENS を使うと想定されたウィンドウを修正できる。どちらの変数が適用されるかについては Correct the window for a gateway or custom model ID を参照すること。Claude Code v2.1.223 以降が必要である

使い方・用途

  • Claude Code が認識しない LLM ゲートウェイのエイリアスなどで、想定の 200K トークンとは異なる実際のコンテキストウィンドウに合わせてプロアクティブな自動コンパクションを行いたい場合に設定する。
  • 自分の Claude Code のバージョンより新しいモデル ID を使って起動時に警告が出る際、モデルの実際のウィンドウサイズを伝えることで警告を解消する。
  • モデル ID に [1m] 接尾辞がない Vertex 形式 (@YYYYMMDD 接尾辞付き) の未知のモデル ID に対して、宣言したウィンドウサイズでのプロアクティブなコンパクションを機能させたい場合に設定する。
英語原文(公式ドキュメントより)

Set to 1 to skip proactive auto-compaction when Claude Code doesn't recognize the model ID, such as an LLM gateway alias. Without this variable, Claude Code compacts at the context window it assumes for the ID. CLAUDE_CODE_MAX_CONTEXT_TOKENS can correct the assumed window instead; see Correct the window for a gateway or custom model ID for when each variable applies. Requires Claude Code v2.1.223 or later

関連ドキュメント

関連する変更履歴

v2.1.259(1件)

Fixed
Claude Code が認識しないモデルバージョンの Vertex 形式モデル ID(@YYYYMMDD 接尾辞)に対して CLAUDE_CODE_MAX_CONTEXT_TOKENS が無視される問題を修正
英語原文を表示
Fixed CLAUDE_CODE_MAX_CONTEXT_TOKENS being ignored for Vertex-style model IDs (@YYYYMMDD suffix) of model versions Claude Code doesn't recognize

関連ドキュメント

v2.1.98(1件)

Fixed
DISABLE_COMPACT が設定されている場合に、CLAUDE_CODE_MAX_CONTEXT_TOKENS による制限がコンテキストの圧縮無効化設定を正しく尊重するよう修正
英語原文を表示
Fixed CLAUDE_CODE_MAX_CONTEXT_TOKENS to honor DISABLE_COMPACT when it is set.

変更後

特定のデバッグや長文の解析など、会話履歴を一切改変・圧縮せずに保持したい高度なユースケースにおいて、ツールの挙動がより予測可能になります。

関連ドキュメント