Claude Code 接入 DeepSeek V4

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. 找到配置文件

• macOS/Linux：~/.claude/settings.json
• Windows：C:\Users\你的用户名.claude\settings.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）

• deepseek-v4-pro：满血版，1M 上下文，强推理，适合复杂编码 / 重构
• 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 配置参数

• Provider：DeepSeek V4
• Base URL：https://api.deepseek.com/anthropic
• Model：deepseek-v4-pro
• 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
  }
}