is not a model this version of Claude Code recognizes - CC Switch

Quick fix

设置环境变量 CLAUDE_CODE_MAX_CONTEXT_TOKENS 或在模型名后追加 [1m] 以指定正确的上下文窗口大小。

Symptom

报错原文复制

"deepseek-v4-flash" is not a model this version of Claude Code recognizes, so auto-compact will keep this session within 200k tokens (the context window it assumes). If the model accepts more, append [1m] to the model name for 1M, or set CLAUDE_CODE_MAX_CONTEXT_TOKENS to its real window; to make it recognized, map it in the modelOverrides setting or update Claude Code; CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 restores the previous wait-for-the-API behavior.

Cause

当使用 cc-switch 将请求路由到第三方模型（如 DeepSeek、Kimi、GLM 等）时，Claude Code 客户端无法识别这些非 Anthropic 官方模型的名称。由于缺乏内置的上下文窗口元数据，Claude Code 会保守地假设上下文窗口为 200k tokens，并在此限制下触发自动压缩（Auto-Compact）。这会导致两个主要问题：一是如果模型实际支持更大窗口（如 1M），对话会被过早截断；二是自动压缩会改写历史消息前缀，导致后端的 DeepSeek Prefix Cache 失效，从而增加 Token 成本。

目前 cc-switch 在 Claude Code Desktop 侧尚未完全实现像 Codex 侧那样的自动注入上下文窗口环境变量功能（见 Issue #5858 和 #6962 中的 PR-3 规划）。因此，用户需要手动配置以告知客户端正确的窗口大小或关闭强制限制。

Fix

1. 1

   在终端中设置环境变量 CLAUDE_CODE_MAX_CONTEXT_TOKENS 为模型的实际上下文窗口大小（例如 1000000 表示 1M）。

   .bashrc, .zshrc 或系统环境变量

   export CLAUDE_CODE_MAX_CONTEXT_TOKENS=1000000

2. 2

   或者，在模型名称后直接追加 [1m] 后缀来声明 1M 窗口。

   在 cc-switch 配置或 ANTHROPIC_MODEL 变量中

   # 将 deepseek-v4-flash 改为 deepseek-v4-flash[1m]

3. 3

   如果希望完全由 API 响应决定行为，不再主动按 200k 压缩，可以设置禁用标志。

   .bashrc, .zshrc 或系统环境变量

   export CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1

Affected Versions

ToolClaude Code

Version未知

PlatformsWindowsmacOSLinux

Source Issues

本页汇总自 3 个真实 issue

• #5858[Feature Request] 支持为 Claude Code Desktop 供应商自定义上下文窗口大小
• #6221Claude code更新后接deepseek模型提醒
• #6962[Tracking] Split of #5652 — per-model context window & auto-compact sync

FAQ

这个提示是报错吗？必须修复吗？

这不是一个阻断性错误，而是一个警告提示。如果你不介意 200k 的保守截断，或者你的模型确实只支持 200k，可以忽略它。但如果模型支持更大窗口且你希望充分利用，建议按照 fix_steps 配置。

为什么设置了 [1m] 还是没生效？

根据 Issue #6962 的讨论，如果使用代理接管模式，可能需要确保代理层正确处理了 `[1m]` 标记的追加与剥离。此外，直连模式下该后缀应能被客户端识别。如果仍无效，请尝试使用环境变量方式或检查 cc-switch 版本是否为最新（如 v3.19.2+ 可能存在其他路由 Bug，见 Issue #6221 评论）。

cc-switch 什么时候能自动处理这个问题？

根据 Issue #6962 的跟踪计划，PR-3 正在开发中，旨在为 Claude 供应商增加 per-model `contextWindows` 字段并在切换时自动注入 `CLAUDE_CODE_MAX_CONTEXT_TOKENS` 等环境变量。目前该功能尚未合并发布，需手动配置。

相关问题

火山引擎 Agent Plan 自动识别模型列表失败 404手动修改 config.toml 匹配官方文档，并在 modelCatalog 中手动添加模型列表以绕过 404 错误。2 issues mergedHTTP 400 maximum context length Codex升级 cc-switch 以修复 auto_compact_token_limit 缺失问题，或手动修改 model catalog json 配置上下文窗口限制。2 issues merged502 Bad Gateway Codex 代理接管覆盖 config.toml关闭全局代理改规则模式直连127.0.0.1，或升级cc-switch避免全量覆盖config.toml。29 issues merged