Agent Model Connector

模型不存在修复指南——Claude Code 与 Codex CLI

Claude Code 或 Codex CLI 接入 DeepSeek、OpenRouter 等服务商时遇到"模型不存在"的分步修复方法。

报错输出

Error: model not found: deepseek-chat {"error":{"message":"Model Not Exist"}}
常见变体
anthropic: Request to Anthropic API failed with status 404: {"error":{"message":"Model not found"}}
Unknown model "gpt-5.3-codex". Available models are listed at https://openrouter.ai/models

具体文本随 Agent 版本与服务商略有差异，以状态码和消息类型为准。

快速定位

打印模型变量——拼写错误或已退役的模型名通常就在这里。

Claude Code 
echo $ANTHROPIC_MODEL $ANTHROPIC_DEFAULT_OPUS_MODEL $ANTHROPIC_DEFAULT_SONNET_MODEL $ANTHROPIC_DEFAULT_HAIKU_MODEL
Codex CLI 
grep "^model" ~/.codex/config.toml

常见原因

  • 模型名称不存在或已退役（deepseek-chat / deepseek-reasoner 于 2026-07-24 退役）。
  • 模型 slug 缺少网关（OpenRouter）要求的服务商前缀。
  • 缓存的旧登录覆盖了环境变量（Claude Code 搭配 OpenRouter）。

按场景修复

1 刚配置完就报错

  • 使用当前模型名：deepseek-v4-pro[1m] 与 deepseek-v4-flash。
  • OpenRouter 的 slug 需要服务商前缀，例如 openai/gpt-5.3-codex——裸模型名无法匹配。
  • Codex × DeepSeek：模型需存在于 models.json 目录中，元数据才会加载。

2 模型已退役

  • deepseek-chat 与 deepseek-reasoner 已于 2026-07-24 退役；更新所有旧配置。
  • 在假设模型仍存在之前，先到服务商文档确认当前名称。
  • 旧博客教程经常引用已退役的名称——以当前文档为准。

3 OpenRouter 返回错误模型

  • 在 Claude Code 内执行一次 /logout——缓存的 Anthropic 登录会覆盖你的模型变量。
  • OpenRouter 场景确认 ANTHROPIC_API_KEY 已置空（""），而不是未设置。
  • 带 ~ 的别名（如 ~anthropic/claude-sonnet-latest）始终解析为最新版本。

Agent 差异修复

Claude Code

修复
将四个模型变量（ANTHROPIC_MODEL 与三个 ANTHROPIC_DEFAULT_*_MODEL）都设为当前模型名。搭配 OpenRouter 时，执行 /logout 并重启可清除缓存覆盖。
验证
`claude /status` 显示模型标识，随后一条简短测试消息成功。

Codex CLI

修复
从服务商目录复制完整 slug，例如 openai/gpt-5.3-codex 或 deepseek/deepseek-v4-flash。直连 DeepSeek 时，模型需在 models.json 目录内。
验证
`codex exec "hi"` 成功，且服务商后台显示预期的模型名。

Claude Code 与 Codex CLI 对照速查

Claude Code Codex CLI
模型变量 ANTHROPIC_MODEL + ANTHROPIC_DEFAULT_*_MODEL model in config.toml
模型目录 Provider docs ~/.codex/models.json (DeepSeek)
缓存登录处理 /logout inside Claude Code codex logout

避免复发

  • 在 OpenRouter 上使用别名（如 ~anthropic/…）自动跟随最新模型。
  • 模型更名后，一次性更新所有配置并记录日期。
  • 关注服务商发布说明，尽早发现模型退役。

相关错误

401 未授权 404 未找到

相关接入指南

Claude Code 接入 DeepSeek 查看接入指南 Claude Code 接入 OpenRouter 查看接入指南 Codex CLI 接入 DeepSeek 查看接入指南 Codex CLI 接入 OpenRouter 查看接入指南

常见问题

为什么 deepseek-chat 找不到了？

DeepSeek 于 2026-07-24 退役了旧别名。请使用当前模型名 deepseek-v4-pro[1m] 与 deepseek-v4-flash。

OpenRouter 模型名前的 ~ 是什么意思？

类似 ~anthropic/claude-sonnet-latest 的别名会自动解析为该模型的最新版本，新版本发布时无需更新配置。

全部排障指南