Claude Code 2.1.323:未知のモデルIDで1Mコンテキストエラーを修正
Claude Code 2.1.323では、認識できないモデルIDに対して想定するコンテキストウィンドウが200Kから1Mトークンに変わりました。実際の上限が小さいゲートウェイでは、長いセッションのリクエストが繰り返し失敗する場合があります。2.1.325の修正内容、CLAUDE_CODE_MAX_CONTEXT_TOKENSによる上限設定、/autocompactの優先順位、BetterTokenでのDeepSeek・Kimi接続例、失敗したセッションの復旧方法を説明します。
目次

Claude Code 2.1.323では、認識できないモデルIDのコンテキストウィンドウを、従来の200Kではなく1Mトークンと想定するようになりました。接続先のモデルやAPIゲートウェイがそれより少ないトークンしか受け付けない場合、自動圧縮が間に合わず、リクエストが毎回失敗することがあります。まずClaude Codeを2.1.325以降に更新し、実際のコンテキスト上限か、より早い自動圧縮のしきい値を設定してください。
DeepSeek、GLM、Kimiを使うすべてのセッションを、一律に200Kへ制限する必要はありません。1Mトークンに対応するモデルもあります。不要な制限を設定すると、コードの解析に必要な会話履歴まで早く要約されてしまいます。
ここでは、2.1.323から2.1.325までの変更点、影響を受けるモデルID、設定方法の使い分け、すでに失敗しているセッションの復旧手順を説明します。
Claude Code 2.1.323、2.1.324、2.1.325では何が変わりましたか?
未知のモデルIDに対する想定ウィンドウが変わったのは2.1.323です。その後の2.1.324と2.1.325では、モデルIDの判定とゲートウェイ経由のコンテキストエラーに関する修正が入りました。
Claude Codeの公式CHANGELOGには、次の変更が記録されています。
| バージョン | コンテキスト関連の変更 | 対応方法 |
|---|---|---|
| 2.1.323 | 未認識のモデルIDについて、想定ウィンドウを200Kから1Mへ変更しました。 | 長いセッションを始める前に、実際の上限を確認します。 |
| 2.1.323 | 他社の小さなウィンドウを持つモデルでは、履歴が上限に達すると、/clearまで毎回失敗する場合があります。 | 履歴が上限に達する前に設定します。 |
| 2.1.324 | CLAUDE_CODE_MAX_CONTEXT_TOKENSが、claude-で始まる未認識IDにも適用されるようになりました。 | ゲートウェイがそのような別名を使う場合は更新します。 |
| 2.1.325 | 多くの外部ゲートウェイとFoundryで、圧縮せずに毎回コンテキスト長エラーで停止する問題を修正しました。 | ほかの回避策を試す前に更新します。 |
2026-11-15時点では、npmの@anthropic-ai/claude-codeでlatestは2.1.325、stableは2.1.311でした。
stableの2.1.311には、2.1.323で導入された新しい想定ウィンドウはありません。一方、2.1.324と2.1.325の修正も含まれていません。
まず、インストール済みのバージョンを確認します。
claude --version
Claude Codeをネイティブインストーラーで導入した場合は、公式の更新コマンドを使用します。
claude update
claude --version
意図的にstableチャネルを使っている場合は、実行ファイルのバージョンを確認してから設定を変更してください。latestの変更が、自分の環境に適用されているとは限りません。
2.1.325で改善されたのは、公式説明では多くのゲートウェイです。すべてのゲートウェイで復旧する保証はありません。また、ゲートウェイ側が設定した上限を自動検出する機能でもありません。
未知のモデルIDで長いセッションが失敗するのはなぜですか?
Claude Codeは、認識できるモデルの情報とローカル設定を使って、会話履歴を圧縮するタイミングを決めます。
自動圧縮は古いメッセージを要約し、次のリクエストがモデルのコンテキストウィンドウに収まるようにする処理です。ゲートウェイが独自のモデルIDを公開していると、Claude Codeは実際のモデルを特定できないことがあります。
例えば、ゲートウェイがmy-coding-modelというIDを公開し、実際には200,000トークンまで受け付けるとします。
2.1.323より前のClaude Codeは、この未知のIDについて200Kを想定していました。2.1.323以降は、別の設定がなければ1Mを想定します。
モデルやゲートウェイの性能が変わったわけではありません。Claude Code側の見積もりだけが大きくなっています。
会話履歴が実際の上限を超えると、ゲートウェイはリクエストを拒否する場合があります。失敗しても長い履歴はセッションに残ります。そのため、次のリクエストも同じ理由で失敗することがあります。
Anthropicはこの問題を2.1.323の変更履歴に明記しています。2.1.325では多くのゲートウェイで復旧動作が改善されましたが、実際のウィンドウが小さい場合は正しい値を設定する必要があります。
どのモデルIDが影響を受けますか?
Claude Codeが想定するウィンドウが、実際のAPIルートで使用できるウィンドウより大きい場合に問題が起こります。
次のようなIDを確認してください。
deepseek-v4.1-flash-1017やkimi-k3.1-proなど、Claude Codeが認識していない他社モデルのID。my-coding-modelなどのゲートウェイ独自の別名。接続先が本物のClaudeモデルでも対象になる場合があります。claude-sonnet-latestなど、claude-で始まる未認識ID。2.1.324で上限設定の適用方法が変更されました。[1m]という接尾辞が付いたID。これには別の上書きルールがあります。
未知のモデルIDであることだけでは、コンテキストの不一致は判断できません。
モデルとゲートウェイが本当に1Mトークンを受け付けるなら、新しい初期値で動作する場合があります。問題になるのは、実際のモデル、ゲートウェイ、デプロイ環境のいずれかが、それより小さい上限を適用しているときです。
Claude Codeは、他社のIDに含まれるClaudeモデル名を認識する場合もあります。完全に未知のIDと、既知のClaudeモデルへ解決されるIDでは、環境変数の動作が異なります。
IDの見た目だけで判断せず、AnthropicのゲートウェイやカスタムモデルIDのウィンドウ設定を確認してください。
コンテキストウィンドウはどの方法で修正すべきですか?
実際の上限が分かっていて、そのモデルIDが上書きに対応するなら、CLAUDE_CODE_MAX_CONTEXT_TOKENSが適しています。すぐに200Kへ制限したい場合はCLAUDE_CODE_DISABLE_1M_CONTEXT=1を使います。余裕を持って履歴を圧縮したい場合は、自動圧縮のしきい値を下げます。
| 方法 | 適した状況 | 制約 |
|---|---|---|
CLAUDE_CODE_DISABLE_1M_CONTEXT=1 | 実際の上限が200K以上で、以前の制限に戻したい場合。 | 本来1Mを使える一部のモデルも200Kに制限します。200K未満のモデルには不十分です。 |
CLAUDE_CODE_MAX_CONTEXT_TOKENS | 未知のモデルやゲートウェイの別名について、実際のウィンドウを指定する場合。 | IDの認識方法、バージョン、[1m]の有無によって適用条件が変わります。 |
/autocompact、--autocompact、CLAUDE_CODE_AUTO_COMPACT_WINDOW | 想定ウィンドウの上限より早く履歴を圧縮したい場合。 | 設定可能な最小値は100Kです。実際のAPI上限に合う値を選びます。 |
この3つは同じ設定ではありません。1つ目は200Kの制限、2つ目は想定ウィンドウ、3つ目は圧縮開始のタイミングを調整します。
方法1:200Kの制限に戻す
モデルまたはゲートウェイが少なくとも200Kトークンを受け付ける場合は、Bashで次のように起動します。
export CLAUDE_CODE_DISABLE_1M_CONTEXT=1
claude
これは2.1.323のCHANGELOGでAnthropicが案内した回避策です。
設定を次回以降の起動でも使うには、~/.claude/settings.jsonのenvに追加します。
{
"env": {
"CLAUDE_CODE_DISABLE_1M_CONTEXT": "1"
}
}
この設定を有効にすると、Claude Codeのモデル選択画面から[1m]のバリエーションも削除されます。
通常は1Mのウィンドウを使うモデルでも、自動圧縮が有効なら200Kの境界で履歴を圧縮します。自動圧縮が無効の場合は、その境界に達するとコンテキスト制限エラーで停止します。
ただし、未知のモデルIDには例外があります。ほかの設定によって200Kの制限が適用されない場合です。
次の警告が表示されたら確認が必要です。
CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced for <model>, so this session can grow past it.
CLAUDE_CODE_MAX_CONTEXT_TOKENSを200Kより大きく設定していないか確認します。また、未知のモデルに対するウィンドウ制限を無効にしていないかも確認してください。
Anthropicのエラー対処リファレンスでは、200Kの境界を守る必要がある場合にCLAUDE_CODE_AUTO_COMPACT_WINDOW=200000を設定する方法が案内されています。
ゲートウェイが200K未満しか受け付けない場合、この方法だけで解決しようとしないでください。
方法2:CLAUDE_CODE_MAX_CONTEXT_TOKENSで実際の上限を指定する
ゲートウェイの上限が確認できている場合は、その値を直接指定する方法がより正確です。
例えば、管理者が特定のモデルルートについて200,000トークンを上限と確認したとします。Claude Codeを起動するBash環境で次を設定します。
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000
claude
ここでの200,000は仮のゲートウェイ上限です。DeepSeek、GLM、Kimiを含め、すべてのモデルに推奨する値ではありません。
claude-で始まらず、[1m]も付いていない未認識IDの場合、環境変数は直接適用されます。指定したウィンドウに基づく事前の自動圧縮も維持されます。
公式のモデルID別適用ルールには、次の例外があります。
[1m]を含む未認識IDで小さなウィンドウへ修正するには、CLAUDE_CODE_DISABLE_1M_CONTEXT=1も設定します。これにより事前の自動圧縮を維持できます。- 既知のClaudeモデルとして認識されるIDでは、
DISABLE_COMPACTも設定しないと、この上書きは適用されません。ただしDISABLE_COMPACTは圧縮を全面的に無効にするため、通常の長いセッションには適していません。
claude-で始まる未認識IDへの直接の上書きは、2.1.324以降で対応しています。古いバージョンでは結果が異なる場合があります。
ゲートウェイが本物のClaudeモデルに別名を付けている場合は、modelOverridesまたはmodelPicker.behavesAsで既知のClaudeモデルに対応付けられます。
警告を消すためだけに、Claude以外のモデルをClaudeモデルとして登録しないでください。
設定すべき値は、実際に選択したAPIルートの有効な上限です。モデルの公開仕様が1Mでも、プロキシがそれより小さな上限を適用するなら、プロキシ側の上限を使用します。
方法3:/autocompactで圧縮を早める
自動圧縮のしきい値を下げると、ゲートウェイがリクエストを拒否する前に履歴を要約する余裕が生まれます。
実際の上限が200Kと確認できているセッションなら、次の値が余裕を持たせた設定例です。
/autocompact 150k
Claude Codeのセッション内で実行します。通常、このコマンドは現在のモデル用のしきい値をmodelSettingsに保存し、その場で適用します。
/autocompactの応答を読み、実際に適用されたしきい値を確認してください。 管理者による設定など、優先順位の高い設定がある場合は、入力した値が保存されてもセッションには適用されないことがあります。その場合、コマンドの応答に上書きされたことが表示されます。
管理者設定によって値を変更できない場合は、管理者にポリシーを確認してもらってください。Anthropicの自動圧縮設定リファレンスによると、起動時の--autocompactフラグは管理者設定によって上書きされません。
1回の起動だけに適用する場合は、次を使います。
claude --autocompact 150k
スクリプトやコンテナなどでは、環境変数を使う方法もあります。
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=150000
claude
/autocompactコマンドと--autocompactフラグは100K–1Mトークンを受け付けます。CLAUDE_CODE_AUTO_COMPACT_WINDOWの設定可能範囲は100000から1000000です。
環境変数の値が有効な場合は、コマンド、フラグ、保存済み設定より優先されます。この状態で/autocompactを実行すると、上書きの存在が報告され、新しい値は保存されません。
すべてのモデルに共通の設定を保存する場合は、~/.claude/settings.jsonのautoCompactWindowを使用できます。ただし、同じ設定範囲では、モデルごとに/autocompactで保存した値が共通設定より優先されます。
150kは200Kを受け付けるAPIルート用の例です。実際の上限が小さいモデルに、そのまま使えるとは限りません。
設定可能な最小値は100Kです。100K未満のモデルでは、モデルIDの上書きルールとクライアントの動作を確認してください。/autocompact 50kが使えると想定してはいけません。
BetterTokenの例:Claude CodeからDeepSeekまたはKimiを使う
BetterTokenは、対応モデル向けにhttps://bettertoken.aiでAnthropic互換APIを提供しています。Claude CodeのANTHROPIC_BASE_URLには**/v1を付けません**。
ただし、BetterTokenの接続手順とAnthropicの公式サポート範囲は異なります。AnthropicはLLMゲートウェイのドキュメントで、どのゲートウェイを使う場合も、Claude CodeをClaude以外のモデルへ接続する構成はサポートしないと説明しています。
BetterTokenが独自の接続方法を公開していても、それがAnthropicによるサポートを意味するわけではありません。モデルの互換性、ツール呼び出し、ゲートウェイの上限は、選んだルートごとに確認してください。
2026-11-15時点で確認されたBetterTokenのモデル情報は次のとおりです。
| BetterToken Model ID | 公開されているコンテキスト | Anthropic Messagesルート |
|---|---|---|
deepseek-v4.1-flash-1017 | 1Mトークン | 記載あり |
kimi-k3.1-pro | 1Mトークン | 記載あり |
glm-5.3 | 1Mトークン | このモデルには記載なし。モデル情報にはOpenAI互換アクセスを記載 |
qwen3.8-max | 1,000,000トークン | このモデルには記載なし。モデル情報にはOpenAI互換アクセスを記載 |
これらのモデルが公開するコンテキストは、Claude Codeが想定する1Mより必ず小さいわけではありません。一方、実際に受け付けられる上限は、プロバイダーやAPIルートによって異なる場合があります。
BetterTokenのモデル一覧に掲載されていることは、すべてのAPIプロトコルに対応することを意味しません。Claude Codeで使うモデルを選ぶ前に、最新のモデル一覧を確認してください。
以下のBash設定では、Anthropic互換ルートが記載されたDeepSeekのIDを使います。BetterTokenのClaude Code接続ガイドに沿った例です。
まずClaude Codeをインストールし、BetterTokenのコンソールで自分のAPI Keyを作成します。その後、専用のBashシェルで次を実行してください。
read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY
export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export ANTHROPIC_AUTH_TOKEN="$BETTERTOKEN_API_KEY"
export ANTHROPIC_MODEL="deepseek-v4.1-flash-1017"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
unset CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT
claude -p "Reply with only: OK"
claude
最初のコマンドが入力を待ったら、作成したAPI Keyを貼り付けてEnterを押します。キーは画面に表示されず、コマンドの文字列にも埋め込まれません。
ANTHROPIC_AUTH_TOKENはClaude Codeに認証情報を渡します。3つのANTHROPIC_DEFAULT_*_MODEL変数は、Haiku、Sonnet、Opusという組み込みのモデル役割を、選択したBetterTokenのモデルへ割り当てます。必要なら、各役割に別の対応モデルを指定することもできます。
Kimiを使う場合は、3つの役割用変数をexportする前に、ANTHROPIC_MODELをkimi-k3.1-proへ変更してください。
すでにDeepSeekの設定を実行した場合は、同じBashシェルで次の4行をすべて再実行します。その後、Claude Codeを新しく起動してください。
export ANTHROPIC_MODEL="kimi-k3.1-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
ANTHROPIC_MODELだけを変更しても、先にexportした3つの変数は更新されません。それらの値はDeepSeekを指したままです。モデルIDと接続方法はBetterTokenのKimi K3.1 Proドキュメントにも記載されています。
未認識IDに[1m]が付いていない場合は、確認済みのウィンドウを明示できます。選択したAPIルートが本当に1,000,000トークンを受け付けるなら、次を使います。
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=1000000
Claude Codeを起動する前に設定してください。ゲートウェイの上限が小さい場合は、1000000を確認済みの上限へ置き換えます。必要なら自動圧縮も早めます。
次の例をDeepSeekやKimiに無条件で適用しないでください。
# Example only: the gateway's verified limit is 200000 tokens.
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=150000
最初の変数は想定ウィンドウ、2つ目は圧縮開始のしきい値を指定します。別のゲートウェイで使う場合は、両方の値を個別に確認してください。
モデルとゲートウェイの接続先を確認するには?
Claude Codeを起動したら、次を実行します。
/status
Anthropic base URLにhttps://bettertoken.aiが表示されることを確認します。認証元はclaude.aiへのログインではなく、ANTHROPIC_AUTH_TOKENになっている必要があります。
次に、現在選択されているモデルIDを確認します。必要なら/modelで目的のIDを選択してください。モデル役割用の環境変数を変更した場合は、Claude Codeを再起動して新しい値を読み込ませます。
先ほどのclaude -p "Reply with only: OK"は、基本的な接続とモデルへのアクセスを試すコマンドです。正常な応答があれば、短いリクエストが成功したと分かります。ただし、長いコンテキストや1Mトークンの処理能力を確認したことにはなりません。
コーディング用途の確認では、リポジトリ内の小さなファイルを読ませ、特定の関数を変更せずに説明させてください。回答で正しいファイルを参照しているか確認します。
接続や認証が失敗する場合は、コンテキスト設定とは分けて調べます。HTTP 403などの問題はClaude Codeの403エラー診断ガイドを参照してください。
DeepSeekのモデル選択と接続確認については、Claude CodeとDeepSeekの接続ガイドも役立ちます。Kimi固有の動作はKimi K3.1 Proのコーディングガイドで確認できます。
すでに毎回リクエストが失敗する場合は?
まず、失敗の原因がコンテキスト長の超過かどうかを確認してください。2.1.323の変更履歴には連続失敗の記述がありますが、すべてのゲートウェイに共通するエラーメッセージは示されていません。
ゲートウェイによって返す文言は異なります。Anthropicのゲートウェイのトラブルシューティング資料には、次の例があります。
ContextWindowExceededError
または次の形式です。
prompt token count of N exceeds the limit of M
これらはゲートウェイ側のエラー例です。2.1.323の問題で必ず出る文字列ではありません。
できるだけ会話履歴を失わない順番で復旧を試してください。
- セッションの内容をまだ確認できるなら、作業状態を会話の外に保存します。変更したファイル、テスト結果、次に実施する作業を記録してください。
- Claude Codeを2.1.325以降へ更新し、インストール済みバージョンを確認します。
- ゲートウェイの実際の上限を確認します。再起動前に
CLAUDE_CODE_MAX_CONTEXT_TOKENSまたは適切な自動圧縮のしきい値を設定します。 - セッションがコマンドを受け付けるなら、
/compactを手動で実行します。 - 圧縮も継続もできない場合は、
/clearを使います。保存した作業記録を基に再開してください。
ゲートウェイがコンテキスト長超過のエラーを独自の文言へ変換していると、Claude Codeが原因を認識できないことがあります。その場合、自動圧縮と再試行が動かない可能性があります。
2.1.325では多くのゲートウェイでこの問題が修正されましたが、対応するすべてのゲートウェイ名は公開されていません。
手動圧縮にも失敗する場合は、Claude CodeとDeepSeekの入力長エラーからの復旧ガイドを参照してください。
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1を汎用的な修正策として設定しないでください。Anthropicの説明では、この値は未知のモデルIDに対する事前の自動圧縮を無効にします。クライアントは、認識できるAPIエラーが返るまで待つことになります。ゲートウェイがエラーの形式を変えている場合は、復旧しにくくなる可能性があります。
古い説明では未知のモデルが200Kとなっているのはなぜですか?
このリリースの前後で、公式ドキュメントの記述が変わりました。
2026-11-13に取得されたモデル設定の説明では、未知のIDの想定ウィンドウがまだ200Kとなっていました。しかし、2026-11-15に確認されたモデル設定の公開ページでは、警告にcontext assumed to be 1m tokensと表示されていました。
古い200Kの警告を現在の動作の根拠にしないでください。実際にインストールされているバージョン、セッションに表示される警告、有効な設定を確認する必要があります。
モデルが認識されるか、正しいウィンドウが設定されると、未認識IDの警告が消える場合があります。それはClaude Codeが設定を受け入れたことの確認にすぎません。ゲートウェイがそのサイズのリクエストを処理できる証明にはなりません。
状況別の推奨設定
未知のモデルIDを使い、ゲートウェイの上限が1M未満の場合は、Claude Code 2.1.325以降に更新し、確認済みの実際のウィンドウを設定してください。 出力用の余裕が必要なら、自動圧縮を早めます。
上限が200Kと確認できたゲートウェイでは、CLAUDE_CODE_DISABLE_1M_CONTEXT=1が手早い回避策になります。正確に制御したい場合は、ウィンドウと圧縮のしきい値をそれぞれ指定します。
モデルとAPIルートが本当に1Mに対応している場合は、理由なく小さくする必要はありません。短い履歴を使いたい場合や、ゲートウェイの上限が小さい場合だけ制限してください。
[1m]付きの未知のIDや、認識済みのClaudeモデルには別のルールがあります。CLAUDE_CODE_MAX_CONTEXT_TOKENSだけですべてのモデルIDを上書きできるとは限りません。
Claude Codeの初期推定値ではなく、実際に使用するAPIルートが受け付けるコンテキスト上限に合わせて設定してください。