"deepseek-v4-flash" is not a model：Claude Code 未识别模型

Quick fix

多数相关 issue 仍未解决；升级到 CC Switch v4 后，为第三方模型填写其真实上下文窗口；仅在模型确实支持 1M 时使用 [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

Claude Code 2.1.224 无法识别 `deepseek-v4-flash` 的上下文窗口，因此按保守的 200k 窗口规划自动压缩。这是未知模型提示，不代表请求本身必然失败；如果模型实际窗口更大，会出现提前压缩的问题。

相关跟踪讨论表明，CC Switch 的按模型窗口、环境变量注入和路由模式联动仍在分阶段推进；`[1m]` 与任意数值窗口也不是同一种机制。维护者因 v4.0 的界面和配置写入方式已大幅变化而关闭原报告，但没有确认该提示在所有第三方模型上已经彻底解决。

Fix

1. 1

   先升级到 CC Switch v4，并重新配置供应商；这是维护者关闭原报告时给出的处理建议。升级后若仍出现提示，应附上版本与复现步骤重新报告。

2. 2

   确认第三方模型的真实上下文窗口。只有模型确实支持 1M 时，才在模型名后添加 `[1m]`；不要用 `[1m]` 表示 256K、400K、500K 或 800K 等窗口。

3. 3

   需要数值窗口时，在 Claude Code 配置中写入 `CLAUDE_CODE_MAX_CONTEXT_TOKENS`。下列 512000 是 issue 中的手工配置示例，并非已确认的 DeepSeek V4 窗口值，实际值必须替换为供应商给出的真实窗口。

   ~/.claude/settings.json

   {
     "env": {
       "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "512000",
       "DISABLE_COMPACT": "1"
     }
   }

4. 4

   如果使用较新的 Claude Code Desktop，可参考线程中报告的新配置方式，同时保留自动压缩；其中 262144 仅是该用户场景的配置值，不能直接视为 DeepSeek V4 的窗口。

   ~/.claude/settings.json

   {
     "env": {
       "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "262144",
       "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "262144",
       "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "90"
     }
   }

Affected Versions

ToolClaude Code

Version2.1.224（原始提示的报告版本）

Platforms未知

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

为什么在设置中勾选 1m，更新后仍没有显示？

报告中的模型名不在 Claude Code 的已知模型列表中，因此客户端仍按未知模型处理。维护者建议先升级并重新配置 CC Switch v4；相关跟踪讨论也说明，路由、环境变量和按模型窗口之间的完整联动仍在推进。

可以通过 `CLAUDE_CODE_MAX_CONTEXT_TOKENS` 自定义窗口吗？

可以。线程提供了手动写入 `~/.claude/settings.json` 的配置方式，但数值必须来自模型的真实窗口，不能把其他模型的 512000 或 262144 示例直接套到 DeepSeek。

给模型名添加 `[1m]` 能解决所有自定义窗口问题吗？

不能。跟踪讨论指出，`[1m]` 只适合真实支持相应容量的模型，不能表达任意数值窗口；错误标记还可能让客户端按超过上游上限的容量规划。

修改 `settings.env` 后必须重启 Claude Code 吗？

线程中的 Claude Code 2.1.292 实测显示，修改已有的 `CLAUDE_CODE_MAX_CONTEXT_TOKENS` 值可让运行中会话重算窗口；但删除该键不会清除进程中已经应用的旧值，而且共享用户配置会同时影响多个 CLI 会话。

相关问题

火山引擎 Agent Plan 自动识别模型列表失败 404手动修改 config.toml 匹配官方文档，并在 modelCatalog 中手动添加模型列表以绕过 404 错误。2 issues merged就是桌面端无法看到模型 Codex 桌面端登录官方 ChatGPT、开启「切换第三方时保留官方登录」并启用本地路由后，重启 Codex 桌面端查看模型。6 issues mergedHowever, this session isn't eligible更新到包含 #7893 修复的版本；该修复会在代理切换时将 `CLAUDE_CODE_AUTO_MODE_SERVER` 写入 settings.json。1 issues merged