環境変数

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.259(1件)

Fixed

Settings

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

変更前

Vertex スタイルのモデル ID（@YYYYMMDD サフィックス）を持つ、Claude Code が認識しないモデルバージョンに対して、CLAUDE_CODE_MAX_CONTEXT_TOKENS 環境変数が適用されず、コンテキストウィンドウの制限が無視されていました。

変更後

Vertex スタイルのモデル ID（@YYYYMMDD サフィックス）を持つ、Claude Code が認識しないモデルバージョンに対しても、CLAUDE_CODE_MAX_CONTEXT_TOKENS 環境変数が正しく適用されるようになりました。

ユーザーへの恩恵

カスタムモデルやゲートウェイ経由のモデルでも、意図したコンテキストウィンドウの制限が正しく機能するようになります。

v2.1.98(1件)

Fixed

Settings

DISABLE_COMPACT が設定されている場合に、CLAUDE_CODE_MAX_CONTEXT_TOKENS による制限がコンテキストの圧縮無効化設定を正しく尊重するよう修正

英語原文を表示

Fixed CLAUDE_CODE_MAX_CONTEXT_TOKENS to honor DISABLE_COMPACT when it is set.

変更前

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

変更後

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