Claude Code 接入 DeepSeek V4

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

Node.js 18+（推荐 20.x）
已安装 Claude Code：

bash 复制代码

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

有 DeepSeek 账号并充值少量余额（10 元足够）
获取 DeepSeek API Key （platform.deepseek.com → API Keys → 创建）

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

1. 安装 cc-switch

bash 复制代码

npm install -g cc-switch

2. 打开 cc-switch

终端直接运行：

bash 复制代码

cc-switch

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

3. 添加 DeepSeek V4 提供商

点右上角 + Add Provider
搜索选择 DeepSeek
填入：
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 并选模型

bash 复制代码

claude

进入后输入：

Plain 复制代码

/model

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

✅ 效果验证

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

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

1. 找到配置文件

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

2. 写入 DeepSeek 配置

json 复制代码

{
  "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

bash 复制代码

claude

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

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

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

五、常见坑 & 解决

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

六、一键复制（直接用）

cc-switch 配置参数

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

settings.json（直接覆盖）

json 复制代码

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