環境変数

CLAUDE_CODE_MAX_CONTEXT_TOKENS

アクティブなモデルに対して Claude Code が想定するコンテキストウィンドウのサイズを上書きします(DISABLE_COMPACT が設定されている場合のみ有効)。

使い方・用途

  • ANTHROPIC_BASE_URL を通じてモデルをルーティングしており、実際のウィンドウサイズが組み込みの定義と異なる場合に使用します。
  • DISABLE_COMPACT と併用することで、意図しない自動圧縮や要約を回避し、デバッグなどで会話履歴を完全に保持したい高度なケースに対応します。
英語原文(公式ドキュメントより)

Override the context window size Claude Code assumes for the active model. Only takes effect when DISABLE_COMPACT is also set. Use this when routing to a model through ANTHROPIC_BASE_URL whose context window does not match the built-in size for its name

関連する変更履歴

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.

変更前

コンテキストの自動圧縮を無効化する DISABLE_COMPACT を設定していても、最大トークン数を指定する変数との組み合わせにより、意図せず圧縮ロジックが干渉する可能性がありました。

変更後

設定間の優先順位が整理され、ユーザーが明示的に自動圧縮をオフにしている場合は、トークン制限に達しても勝手に要約や圧縮が行われないよう挙動が統一されました。

ユーザーへの恩恵

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

関連ドキュメント