DeepSeek V4 正式版来了！联手 Claude Code，百元级顶配 AI 编程实战

DeepSeek V4 正式版来了！联手 Claude Code，百元级顶配 AI 编程实战

2026‑07‑31 DeepSeek V4‑Flash 正式版（0731）重磅上线，Agent与代码工程能力迎来跨越式升级，部分评测指标已经超越 V4‑Pro 预览版。本文记录如何基于全新 DeepSeek V4‑Flash 正式版，通过 Claude Code + CC‑Switch 搭建高性价比的 AI 编程环境，并提供完整的避坑指南。

目录

• 1. DeepSeek V4 发布历程与模型介绍
• 2. 预览版 vs 正式版：区别与选择
• 3. Claude Code 介绍
• 4. CC-Switch 介绍
• 5. 安装与配置
• 6. 最佳实践与避坑指南
  • 6.1 配置避坑清单
  • 6.2 模型映射机制
  • 6.3 CLAUDE.md 编写规范
  • 6.4 权限控制优化
  • 6.5 项目启动建议
• 7. 常见问题 FAQ
• 8. 总结

1. DeepSeek V4 发布历程与模型介绍

1.1 发布时间线

参考来源：DeepSeek V4 预览版发布公告 | 更新日志

1.2 V4-Pro 预览版：性能比肩顶级闭源模型

DeepSeek-V4-Pro 是 V4 系列的旗舰模型，参数规模 1.6T（MoE），激活参数 49B。

核心能力：

• Agent 能力大幅增强：Agentic Coding 评测达到开源模型最佳水平，使用体验优于 Sonnet 4.5，交付质量接近 Opus 4.6 非思考模式
• 丰富的世界知识：在世界知识测评中大幅领先其他开源模型，仅稍逊于顶尖闭源模型 Gemini-Pro-3.1
• 世界顶级推理性能：在数学、STEM、竞赛型代码评测中超越所有已公开的开源模型

注意：当前 API 中的 deepseek-v4-pro 仍为预览版，正式版尚未发布。

1.3 V4-Flash 正式版：更快捷高效的经济之选

DeepSeek-V4-Flash 于 2026 年 7 月 31 日发布正式版（DeepSeek-V4-Flash-0731），是 V4 系列中首个转正的模型。

正式版相比预览版的提升：

测试说明：① 正式版 V4-Flash 使用 DeepSeek Harness 极简模式（即将发布）作为框架测试，max 档位，topp=0.95，temperature=1.0；② DSBench-FullStack 为内部全栈开发测试集，DSBench-Hard 为内部 Coding Agent 难题测试集。

正式版关键特性：

• Agent 能力大幅增强：基准测试远超 V4-Pro 预览版
• 原生支持 Responses API：针对性适配 Codex
• 模型结构不变：与 V4-Flash-Preview 结构、尺寸一致，仅重新进行了后训练

1.4 共同技术特性

两款模型共享 V4 系列的核心技术突破：

1.5 模型规格总览

说明：使用 Claude Code 时，模型名带 [1m] 后缀（如 deepseek-v4-pro[1m]）是 Anthropic 接口的规范写法，建议始终带上。

1.6 API 定价

以下为 DeepSeek 官方定价（单位：元/百万 tokens），实际价格请以 DeepSeek 官方定价页 为准。

⚠️ 价格变动提醒：DeepSeek 官方标注「计划近期整体上调 API 服务定价，预计涨幅较大」，请按需充值并关注官方通知。

省钱关键：95%+ 的缓存命中率意味着实际成本远低于标价。以 V4-Pro 为例，日均 100 万 token 输入中 95% 命中缓存时，实际输入成本仅约 (0.025×0.95 + 3×0.05) × 30 ≈ 5.2 元/月。即使日均消耗 2000 万 token（含输出），月费也仅约百元量级。

1.7 旧模型名迁移提醒

旧有的 API 模型名 deepseek-chat 与 deepseek-reasoner 计划于 2026-07-24 停止使用（以官方实际通知为准）。当前阶段：

• deepseek-chat → 指向 deepseek-v4-flash 的非思考模式
• deepseek-reasoner → 指向 deepseek-v4-flash 的思考模式

⚠️ 建议尽快迁移：即使旧模型名暂时仍可用，也应尽早切换到 deepseek-v4-pro / deepseek-v4-flash，避免停用后服务中断。

2. 预览版 vs 正式版：区别与选择

2.1 什么是预览版和正式版？

DeepSeek V4 采用「先预览、再正式」的发布策略：

• 预览版（Preview）：模型能力的首次公开，用于收集用户反馈和大规模测试。API 可用但可能存在迭代优化。
• 正式版（Official）：经过充分验证后的稳定版本，Agent 能力经过专项增强（重新后训练），适合生产环境使用。

2.2 当前版本状态

2.3 V4-Flash 正式版 vs 预览版对比

关键结论：正式版 V4-Flash 的 Agent 能力已经远超预览版 V4-Pro。如果你的使用场景以 Agent 编程为主，当前应优先选择 V4-Flash 正式版。

2.4 如何选择？

建议：在 V4-Pro 正式版发布前，以 V4-Flash 正式版为主力模型，V4-Pro 预览版作为复杂推理场景的补充。待 V4-Pro 正式版上线后，可全面切换。

3. Claude Code 介绍

Claude Code 是 Anthropic 推出的 AI 编程命令行工具（CLI Agent），核心能力包括：

• 代码理解与生成：在终端内直接与 AI 对话，自动完成编程任务
• 工具调用（Tool Use）：可自动执行读写文件、搜索代码、运行命令等操作
• Agent 模式：能自主规划和执行复杂的多步骤任务
• Skill 机制：支持通过 Skill 扩展领域知识，实现特定技术栈的深度辅助
• 多供应商支持：通过环境变量可接入任何兼容 Anthropic API 的模型供应商

官方文档：Claude Code

4. CC-Switch 介绍

CC-Switch 是一款开源的 Claude Code / Codex / Gemini CLI 图形化配置管理工具，用于一站式管理不同大语言模型供应商的 API 配置。

核心功能

项目地址：cc-switch (GitHub) | 使用教程

5. 安装与配置

5.1 安装 Node.js 环境

Claude Code 依赖 Node.js 运行，推荐使用 LTS 版本（>= 18.x）。

macOS / Linux：

# 检查是否已安装
node –version

# 使用 Homebrew 安装（macOS）
brew install node

# 或使用 nvm 管理多版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install –lts
nvm use –lts

Windows：

# 使用 winget 安装
winget install OpenJS.NodeJS.LTS

# 或从官网下载：https://nodejs.org/
# 推荐使用 nvm-windows 管理多版本：https://github.com/coreybutler/nvm-windows

5.2 安装 Claude Code

macOS / Linux

npm install -g @anthropic-ai/claude-code
claude –version

Windows

Windows 必须先装 Git，因为 Claude Code 底层用 Git Bash 执行命令。

# 1. 安装 Git
winget install Git.Git

# 2. 安装 Claude Code
npm install –g @anthropic-ai/claude-code

# 3. 配置 PATH（重要！）
# Claude Code 可执行文件默认在 C:\\Users\\<你的用户名>\\.local\\bin
# 将此路径添加到系统环境变量 Path 中：
# 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
# 在「系统变量」中找到「Path」→「编辑」→「新建」
# 粘贴路径：C:\\Users\\<你的用户名>\\.local\\bin

# 4. 重启终端后验证
claude —version

5.3 安装 CC-Switch

macOS：

brew tap farion1231/ccswitch
brew install –cask cc-switch

首次打开 macOS 若提示"无法验证开发者"，前往「系统设置 → 隐私与安全性 → 仍要打开」即可。

Windows（推荐）：

• 从 GitHub Releases 下载最新的 CC-Switch-v*-Windows.msi
• 双击安装，按向导完成

Linux：

# .deb 安装
sudo dpkg -i cc-switch_*.deb

# 或使用 AppImage
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

5.4 获取 DeepSeek API Key

安全提醒：API Key 是你的个人凭证，不要分享给他人，不要提交到代码仓库。

5.5 使用 CC-Switch 配置 DeepSeek V4 正式版

点击右上角 「+」 按钮新建配置

注意：deepseek-v4-pro[1m]和deepseek-v4-flash模型可以按自己需求修改配置

配置说明：DeepSeek 官方推荐的主模型为 deepseek-v4-pro[1m]（见 官方文档）。但根据 V4-Flash 正式版的 Agent 基准测试表现（远超 V4-Pro 预览版），本文建议以 V4-Flash 正式版为主力模型，V4-Pro 仅用于复杂推理场景。你也可以按官方推荐使用 deepseek-v4-pro[1m] 作为主模型。待 V4-Pro 正式版发布后，建议全面切换。

5.6 手动配置方式（settings.json）

如果不使用 CC-Switch，可直接编辑 ~/.claude/settings.json：

{
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek_API_Key",
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_MODEL": "deepseek-v4-flash",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
"CLAUDE_CODE_EFFORT_LEVEL": "max",
"API_TIMEOUT_MS": "3000000",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
}
}

说明：当前以 V4-Flash 正式版为主力模型，Opus 槽位保留给 V4-Pro 用于复杂推理。官方推荐配置为 ANTHROPIC_MODEL=deepseek-v4-pro[1m]，你也可按官方建议使用。待 V4-Pro 正式版发布后，建议将 ANTHROPIC_MODEL 改为 deepseek-v4-pro[1m]。

macOS / Linux 等效环境变量（写入 ~/.bashrc 或 ~/.zshrc）：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-flash
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-flash
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
export API_TIMEOUT_MS=3000000
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Windows 等效环境变量（PowerShell，写入 $PROFILE）：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-v4-flash"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
$env:API_TIMEOUT_MS="3000000"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

注意：CC-Switch 和手动配置二选一即可，CC-Switch 本质也是写入 settings.json。

5.7 验证配置

启动 Claude Code 后执行 /status 命令，若显示模型为 deepseek-v4-flash（或你配置的模型名）则表示配置成功。

首次启动时的初始化设置：

• 选择颜色主题（以后可用 /theme 修改）
• 安全提示（仔细阅读，这是保护你代码的机制）
• 确认当前目录是否可信（选「是」）

6. 最佳实践与避坑指南

6.1 配置避坑清单

6.2 模型映射机制

DeepSeek 对 Claude Code / Claude Desktop 传入的模型名会自动进行映射：

用途：在 Claude Desktop APP 的 Developer 模式下，只需修改 base_url 和 api_key，无需改动模型名即可接入 DeepSeek。

6.3 CLAUDE.md 编写规范

CLAUDE.md 是 Claude Code 的"行为准则"，决定 AI 按你的方式写代码，还是按它的猜测写。

文件位置：

• 全局 ~/.claude/CLAUDE.md：适用于所有会话的通用规则
• 项目 项目根目录/CLAUDE.md：当前项目的特殊约定，优先级更高

编写原则：

• 不超过 100 行——经验表明超过后 Claude 会开始遗漏内容
• 只放边界规则：命名规范、测试框架、禁止使用的库、分支策略等
• 避免常识性内容（如"不要写 bug"）

6.4 权限控制优化

刚安装时 Claude Code 每次执行命令都需手动确认，可通过以下方式优化：

• 精细化授权：使用 /permissions 命令，将信任的工具（如 npm run lint、git commit）加入允许列表
• 沙箱隔离：处理高风险操作时，使用 /sandbox 开启沙箱模式

6.5 项目启动建议

不要在根目录或包含大量无关文件的路径下启动 Claude Code。上下文越干净，输出越精准。

cd /你的项目路径
claude

如果你对当前目录有绝对信任，可跳过权限提示：

claude –dangerously-skip-permissions

⚠️ 警告：此命令会跳过所有安全确认弹窗，仅在完全信任的目录下使用，切勿在敏感路径（如 ~/.ssh、系统根目录）执行。

7. 常见问题 FAQ

Q1: V4-Pro 和 V4-Flash 怎么选？

当前 V4-Flash 已发布正式版（0731），V4-Pro 仍为预览版。V4-Flash 正式版的 Agent 能力远超 V4-Pro 预览版，因此：

待 V4-Pro 正式版发布后，可根据实际评测结果重新选择主力模型。

Q2: 为什么模型名要加 [1m] 后缀？

V4-Pro 和 V4-Flash 默认均已支持 1M 上下文。但在 Claude Code 通过 Anthropic 接口调用时，模型名带 [1m] 后缀（如 deepseek-v4-pro[1m]）是官方推荐的写法，可确保百万 Token 上下文被正确激活。建议始终使用带后缀的版本。

Q3: 缓存命中率为什么这么高？

DeepSeek V4 采用了全新的 DSA2 稀疏注意力机制，在处理相似或重复的代码上下文时能高效复用已有计算结果。实际使用中，同一个项目的反复对话、相似代码片段的多次查询都会命中缓存。

Q4: Claude Code 支持哪些 DeepSeek 模型？

目前支持通过 Anthropic 兼容端点接入以下模型：

• deepseek-v4-pro / deepseek-v4-pro[1m]
• deepseek-v4-flash

Q5: 遇到超时怎么办？

8. 总结

通过 DeepSeek V4 + Claude Code + CC-Switch 这套组合，我们获得的不仅是一个 AI 编程环境，更是一套完整的生产力方案：

• 极致性价比：95%+ 缓存命中率，日常重度使用月费轻松控制在百元以内，相比官方 Claude Opus 成本大幅降低
• 百万上下文标配：1M token 超长上下文能容纳整个项目代码库，跨文件重构、全库分析不再受限
• 持续进化的模型：V4-Flash 正式版已发布，V4-Pro 正式版即将上线，模型能力持续增强
• 完全可控的工具链：CC-Switch 让模型切换、配置同步、健康检查全部可视化，所有数据留在本地

这套方案的核心优势就两个字：自由——不再被昂贵的订阅费绑架，不再被封闭的生态锁定，用极低的成本享受顶级的 AI 编程体验。

参考资源

• DeepSeek API 开放平台
• DeepSeek 官方定价
• DeepSeek 接入 Claude Code 官方文档
• DeepSeek 思考模式文档
• CC-Switch 项目主页
• CC-Switch 使用教程
• Claude Code 官方文档