2026-06-22

DeepSeek Chat 迁移到 V4：旧别名下线前的中文工程检查表

如果你的代码、脚本或 Claude Code 配置里还写着 `deepseek-chat` 或 `deepseek-reasoner`，现在应该主动迁移到明确的 V4 模型名。旧别名是兼容层，不是长期产品名；继续依赖它会让团队看不清实际跑的是 Flash、Pro，还是某个兼容回退。本页给出面向中文开发团队的迁移路径：先替换 OpenAI 兼容 SDK，再清理 Claude Code / Anthropic 格式配置，最后用日志确认模型、成本和输出质量。

1. 旧别名和 V4 模型名怎么对应

`deepseek-chat` 和 `deepseek-reasoner` 的问题不只是名字旧，而是它们隐藏了真实路由。迁移到 V4 后，团队应该显式选择 `deepseek-v4-flash` 或 `deepseek-v4-pro`，这样成本、上下文和质量策略都能被记录下来。

一般迁移规则是：原来承接高频聊天、普通代码补全、RAG 后续问答的 `deepseek-chat`，优先迁到 Flash；原来承担复杂推理或代码审查的 `deepseek-reasoner`，先评估是否需要 Pro，不能无脑全部升到 Pro。

旧模型名迁移建议
旧写法	更明确的新路由	适合场景
deepseek-chat	deepseek-v4-flash	聊天、常规代码、工具循环、高频 API 流量
deepseek-reasoner	deepseek-v4-flash + thinking 或 deepseek-v4-pro	复杂推理、代码审查、长链分析
自定义别名	团队内部映射到 Flash / Pro	需要日志能看出真实模型

Sources checked

DeepSeek 官方 API 文档 - 确认当前模型名、OpenAI 兼容接口和迁移基线。
DeepSeek 官方更新日志 - 确认 V4 上线与兼容别名变化。

2. 先改 OpenAI SDK 中的模型名

DeepSeek 的 OpenAI 兼容 base URL 不需要大改，多数项目只要替换 model 字符串。先从服务器端共享配置、SDK wrapper、测试夹具和内部文档开始搜，不要只改业务代码里最显眼的一处。

迁移时建议先把默认路线设为 Flash，再把少量高风险任务显式升级到 Pro。这样可以避免因为旧 reasoner 名称而把所有流量都打到更贵路线。

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.DEEPSEEK_API_KEY,
  baseURL: "https://api.deepseek.com",
});

const response = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages,
});

const review = await client.chat.completions.create({
  model: "deepseek-v4-pro",
  messages: codeReviewMessages,
});

3. Claude Code 配置要单独清理

Claude Code / Anthropic 兼容格式不要只做字符串替换。DeepSeek 官方 Claude Code 配置把主模型和 subagent 分开：主路径可以用 Pro，重复的子任务用 Flash。这比把所有别名都映射到同一个模型更可控。

迁移后一定要从 DeepSeek 侧看实际用量或日志。桌面端显示的模型标签、代理层别名或内部配置名，都不能替代供应商侧记录。

export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-..."
export ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"

Sources checked

DeepSeek Claude Code 集成文档 - 官方 Anthropic 兼容端点与 Claude Code 模型配置来源。

4. 上线前的搜索清单

在 monorepo 或团队项目里，旧模型名通常藏在很多地方：环境变量默认值、README、CI smoke test、Postman collection、prompt playground、内部脚手架、后台任务和客户部署文档。

建议把迁移做成一次可审计变更：列出旧模型名出现位置、替换后的 V4 路由、负责人、上线时间和回滚条件。上线后至少观察 tokens、延迟、重试率和人工采纳率。

迁移上线检查表
检查项	为什么重要
rg 搜索 deepseek-chat / deepseek-reasoner	避免漏掉脚本、测试和文档里的旧别名。
记录 Flash / Pro 路由规则	让成本和质量策略可解释。
上线后看模型名日志	确认实际供应商侧模型与配置一致。
保留小流量灰度	发现输出质量或成本异常时能快速回滚。

5. 迁移后怎么做内部链接

中文站内结构应该把这篇迁移指南链接到 Python、Node.js、Claude Code 和 Pro vs Flash 页面。这样用户可以从旧模型名搜索落地，再继续理解代码接入、模型选择和购买边界。

注意：迁移指南解释的是模型调用和配置，不代表任何模型自动成为本站在售商品。是否可购买仍以 /zh/pricing 的真实库存卡片为准。

FAQ

deepseek-chat 和 deepseek-reasoner 还能继续用吗？

不建议继续依赖。它们是兼容别名，长期维护风险高；新项目应直接使用 deepseek-v4-flash 或 deepseek-v4-pro。

deepseek-reasoner 是否必须迁到 Pro？

不一定。高风险推理和代码审查更适合 Pro，普通思考型任务可以先用 Flash 并开启相应 thinking 配置。

迁移需要改 base URL 吗？

OpenAI 兼容接口通常不需要改 base URL，主要改 model 字符串；Claude Code / Anthropic 格式要按官方端点和环境变量检查。

迁移后怎么验证成功？

看供应商侧日志、用量记录、tokens、延迟和实际模型名，不要只看客户端 UI 上显示的名称。

DeepSeek V4 迁移的重点是把隐藏在旧别名背后的模型路由显式化。默认高频流量走 Flash，复杂审查和高信任推理走 Pro，再用日志确认真实模型和成本，这比继续依赖 `deepseek-chat` / `deepseek-reasoner` 更稳。

阅读 Pro 与 Flash 选择指南