Claude Code中接入DeepSeek V4的完整教学需要先看清适用场景和关键步骤，避免只记结论却忽略实际限制。

一、前置条件（必须满足）

Node.js 18+（推荐 20.x）

已安装 Claude Code：

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

有 DeepSeek 账号并充值少量余额（10 元足够）

获取 DeepSeek API Key（platform.deepseek.com → API Keys → 创建）

二、方法一：用 cc-switch 一键接入（强烈推荐，带图）

1. 安装 cc-switch

npm install -g cc-switch

2. 打开 cc-switch

终端直接运行：

cc-switch

会弹出可视化界面（类似下面）：

3. 添加 DeepSeek V4 提供商

1.点右上角 + Add Provider

2.搜索选择 DeepSeek

3.填入：

1. API Key：你的 DeepSeek Key
2. Base URL：https://api.deepseek.com/anthropic
3. 模型：deepseek-v4-pro 或 deepseek-v4-flash

4. 启用 DeepSeek

在列表选中刚加的 DeepSeek

点 Enable（变红 / 高亮即生效）

5. 启动 Claude Code 并选模型

claude

进入后输入：

/model

选择 deepseek-v4-pro 或 flash，回车确认。

效果验证

随便问一句，返回正常且左下角显示 deepseek-v4-pro 即成功。

三、方法二：直接改配置文件（无 GUI，纯本地）

1. 找到配置文件

1. macOS/Linux：~/.claude/settings.json
2. Windows：C:Users你的用户名.claudesettings.json

2. 写入 DeepSeek 配置

{  "env": {    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",    "ANTHROPIC_MODEL": "deepseek-v4-pro",    "API_TIMEOUT_MS": 600000  }}

sk-xxx 换成你的 DeepSeek API Key

3. 启动 Claude Code

claude

直接走 DeepSeek V4，无需额外切换。

四、模型说明（2026-05-16）

1. deepseek-v4-pro：满血版，1M 上下文，强推理，适合复杂编码 / 重构
2. deepseek-v4-flash：轻量高速，性价比高，日常对话 / 补全

五、常见坑 & 解决

1. Unable to connect → Base URL 写错，必须是：https://api.deepseek.com/anthropic
2. 401 Invalid Key → Key 复制错 / 没充值 / 过期，重新创建并充值
3. 模型列表为空 → 用 cc-switch 选 DeepSeek 并 Enable；或重启终端

六、一键复制（直接用）

cc-switch 配置参数

1. Provider：DeepSeek V4
2. Base URL：https://api.deepseek.com/anthropic
3. Model：deepseek-v4-pro
4. API Key：你的 sk-xxx

settings.json（直接覆盖）

{  "env": {    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",    "ANTHROPIC_MODEL": "deepseek-v4-pro",    "API_TIMEOUT_MS": 600000  }}