下面我给你一套Windows 原生安装 Claude Code + 对接 DeepSeek API的完整、可直接照着做的教程（2026-05 最新）。

---

一、准备环境（Windows 10/11）

1. 安装 Node.js（必须）

• 官网：https://nodejs.org/zh-cn/download
• 下载 Windows 64位 .msi（推荐 LTS，如 22.x）
• 安装时一路默认即可。

验证（PowerShell / CMD）：

node --version
npm --version

能显示版本就 OK。

2. 安装 Git（推荐，避免路径问题）

• 官网：https://git-scm.com/download/win
• 安装默认选项即可。

---

二、安装 Claude Code（Windows 两种方式）

方式 A：npm 全局安装（最稳）

以管理员身份打开 PowerShell：

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

验证：

claude --version
# 输出类似 2.x.x 即成功

方式 B：官方脚本（PowerShell）

irm https://claude.ai/install.ps1 | iex

---

三、获取 DeepSeek API Key

1. 打开：https://platform.deepseek.com

2. 国内手机号注册、登录

3. 左侧「API Keys」→「创建 API Key」

4. 复制保存（格式：sk-xxxx），只显示一次

5. 先充值 10 元（支付宝），否则无法调用。

---

四、配置 Claude Code 接入 DeepSeek（核心）

1. 找到/创建配置文件

PowerShell：

# 创建目录（不存在时）
New-Item -ItemType Directory -Force "\$env:USERPROFILE\.claude"

# 编辑配置文件
notepad "\$env:USERPROFILE\.claude\settings.json"

2. 写入 DeepSeek 配置

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek密钥",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-pro",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

• deepseek-v4-pro[1m] = 开启 100万上下文（推荐）
• 也可换成：deepseek-chat（普通版）

保存关闭。

3、绕过国内访问限制
# 编辑配置文件 notepad "\$env:USERPROFILE\.claude\.claude.json"
写入配置
{ "hasCompletedOnboarding": true }

---

五、测试是否成功

新开 PowerShell（必须新开，环境变量才生效）：

claude

然后输入一句测试：

写一个快速排序（Python）

如果正常返回代码，说明 DeepSeek 接入成功。

---

六、常见问题

1. 提示“command not found: claude”

   • 把 C:\Users\你的用户名\AppData\Roaming\npm 加入系统 Path，重启终端。

2. 调用时报错 401/Invalid API Key

   • 确认 Key 正确、余额充足、没空格。

3. 超时

   • 在 settings.json 里加：

     "API_TIMEOUT_MS": "600000"
     

---

如果你愿意，我可以直接帮你生成现成的 settings.json 内容，你只需复制粘贴即可。要不要我直接给你生成？