国内 Claude Code 使用 DeepSeek 模型的正确打开方式
将 DeepSeek 模型接入 Claude Code 不需要安装额外的工具,只需通过配置文件来指定 API 地址和模型名称。
Claude Code 如何使用 DeepSeek 模型
第一步:获取 DeepSeek API Key
你需要从 DeepSeek 平台获取一个有效的 API Key。
第二步:修改配置文件
找到或创建 Claude Code 的配置文件 settings.json,路径通常在 ~/.claude/settings.json(Mac/Linux)或 用户目录/.claude/settings.json(Windows)。然后根据你的需求,选择下面两种配置方式之一。
推荐直接改配置文件:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "你的DeepSeek_API_Key",
"ANTHROPIC_MODEL": "deepseek-v4-pro",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-flash-vision-exp",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash"
}
}利用 DeepSeek 不同的模型版本,来匹配 Claude Code 的三个档位。将最强大的模型(如 deepseek-v4-pro)分配给 opus 用于复杂任务,将速度更快、成本更低的模型(如 deepseek-v4-flash)分配给 haiku 用于简单任务,从而在保证效果的同时优化成本。当然,土豪全部配置 deepseek-v4-pro 也是可以的。
注意:
deepseek-v4-flash-vision-exp是一个实验性模型,其纯文本能力与正式版deepseek-v4-flash相当,但视觉能力是其主要提升点。它可能不是最终名称,请以官方最新文档为准。
DeepSeek 最新模型清单,知道如何选择模型
根据当前可获取的信息,DeepSeek V4 系列目前主要包含三个核心模型版本,它们在定位、技术规格和价格上存在显著差异。
DeepSeek V4 系列模型比对表
| 特性 | DeepSeek-V4-Pro | DeepSeek-V4-Flash | DeepSeek-V4-Flash-Vision-Exp |
|---|---|---|---|
| 定位 | 旗舰级,追求极致性能,用于处理最复杂的任务。 | 经济高效型,在性能与成本/速度间取得平衡,适合日常大规模使用。 | 实验性视觉模型,是 V4 系列首款支持图像输入的模型,专为多模态任务设计。 |
| 总参数量 | 1.6 万亿 (1.6T) | 2840 亿 (284B) | 未明确公开,属于 Flash 系列 |
| 激活参数量 | 490 亿 (49B) | 130 亿 (13B) | 未明确公开 |
| 上下文长度 | 100 万 (1M) Token | 100 万 (1M) Token | 100 万 (1M) Token |
| 核心能力 | Agent 能力强,逼近顶级闭源模型如 Opus 4.6 非思考模式;世界知识与推理能力顶尖。 | 推理能力接近 Pro 版;在简单 Agent 任务上与 Pro 版旗鼓相当,但高难度任务有差距。 | 在纯文本能力上与 V4-Flash 基本持平,主要新增图像识别与理解能力。 |
| API 价格(每百万 Token) | 输入:$1.74(约 12 元) 输出:$3.48(约 24 元) | 输入:~$0.14 - 0.15(约 1.0 - 1.1 元) 输出:~$0.28 - 0.29(约 2.0 元) | 价格与 V4-Flash 完全一致 |
| 主要用途 | 复杂推理、深度编码、长上下文 Agent 任务。 | 高吞吐量聊天、快速摘要、路由、成本敏感型任务。 | 需要理解图像或截图的场景,如 UI 自动化、看图编码等。 |
特别说明:DeepSeek-V4-Flash-Vision-Exp 的价格并未因加入视觉能力而上涨。该模型对图片的处理方式是先按尺寸换算成 Token,再与文本 Token 一起计费,因此实际成本取决于图片的复杂度和官方换算规则。
选型建议
- 追求最佳效果,且成本不敏感:选择 DeepSeek-V4-Pro。它在处理复杂 Agent 任务、深度推理和编码方面性能最强,是旗舰首选。
- 追求极致性价比,任务量大:选择 DeepSeek-V4-Flash。它的纯文本能力已足够强大,能以极低的成本完成绝大多数日常任务。
- 处理需理解图像/截图的任务:选择 DeepSeek-V4-Flash-Vision-Exp。这是目前 V4 系列中唯一支持视觉的选项,且成本与 Flash 版相同,是处理多模态任务的不二之选。
了解 Claude Code 的模型"档位"
Claude Code 内置了三个模型档位,你也可以将它们理解为处理任务复杂度的三个级别:
- Opus:旗舰级模型。专为复杂架构设计、多文件重构、调试棘手的并发或竞态条件问题而生。它推理能力最强,但速度最慢、成本最高。
- Sonnet:主力模型。Claude Code 的默认选项,非常适合日常开发任务:编写新功能、代码审查、编写和修复测试等。它在速度、成本和能力之间取得了平衡。
- Haiku:轻量级模型。速度最快、成本最低(比 Sonnet 便宜 80%),适合处理明确定义的重复性任务,比如生成模板代码、重命名、简单的格式化操作等。
Claude Code 模型查看和切换命令
Claude Code CLI(终端 claude 命令):
/status:输出会显示当前会话使用的模型别名、base_url、子 Agent 模型、环境变量值。
切换模型(会话内即时切换,不用重启),执行 /model 会弹出交互式菜单直接选别名;也可以直接指定别名:
/model claude-sonnet-vision
/model claude-opus-4-7
/model claude-reasoner启动会话时一次性指定模型:
claude --model claude-sonnet-vision