第一步：准备基础环境 (安装 Node.js)

Claude Code 的运行依赖于 Node.js 环境。

1. 访问 Node.js 官网（nodejs.org），下载并安装 LTS（长期支持）稳定版（建议 v18 或更高版本）。
2. 安装过程中，务必勾选 “Add to PATH”（自动加入系统环境变量）选项。
3. 安装完成后，重启电脑或重启你的 PowerShell 终端，然后输入以下命令检查是否安装成功：

   node -v
   npm -v
   

   如果输出了版本号，说明环境准备就绪。

第二步：切换国内镜像并安装 Claude Code

直接使用官方命令在国内容易卡顿或失败，我们需要将 npm 切换到国内淘宝镜像源。

1. 打开 PowerShell，依次执行以下命令：

   # 1. 切换 npm 国内镜像源
   npm config set registry https://registry.npmmirror.com
   npm cache clean --force
   
   # 2. 全局安装 Claude Code
   npm install -g @anthropic-ai/claude-code
   

2. 安装完成后，输入 claude --version 验证。如果显示了版本号（如 v2.x.x），就说明安装成功了。

第三步：获取国产大模型的 API 密钥

因为官方接口国内无法直连，我们可以接入支持 Anthropic 协议的国产大模型（如 DeepSeek、通义千问等），不仅速度快，性价比也极高。

1. 以 DeepSeek 为例，访问 DeepSeek 开放平台（platform.deepseek.com），注册并登录。
2. 在后台找到“API 密钥”管理，创建一个新的 API Key（通常以 sk- 开头），复制并保存好这个密钥。

第四步：配置 Claude Code 使用国产模型

安装好后，我们需要告诉 Claude Code 去哪里调用模型。最简单的方法是通过配置系统环境变量：

1. 在 Windows 搜索栏输入“环境变量”，选择 “编辑此电脑的环境变量”。
2. 点击右下角的 “环境变量” 按钮，在上面的“用户变量”区域，点击 “新建”，依次添加以下 3 项（以 DeepSeek 为例）：
   • 变量名：ANTHROPIC_BASE_URL 变量值：https://api.deepseek.com/anthropic
   • 变量名：ANTHROPIC_MODEL 变量值：deepseek-v4-pro （这是目前编程能力极强的旗舰模型）
   • 变量名：ANTHROPIC_AUTH_TOKEN 变量值：你刚才复制的sk-开头的密钥
3. 全部添加完成后，连续点击“确定”保存。

(注：如果你使用的是阿里通义千问，可以将 URL 换成 https://coding.dashscope.aliyuncs.com/apps/anthropic，模型换成 qwen3-coder-plus，填入对应的百炼 API 密钥即可。)

第五步：跳过初始化并启动使用

由于国内无法访问官方登录页面，我们需要手动跳过登录步骤：

1. 按下 Win + R 键，输入 %USERPROFILE% 并回车，这会打开你的个人用户文件夹。
2. 在文件夹中找到（或新建）一个名为 .claude.json 的文件，用记事本打开它，输入以下内容并保存：

   {
     "hasCompletedOnboarding": true
   }
   

3. 彻底关闭并重新打开 你的 PowerShell 终端（确保刚才设置的环境变量生效）。
4. 进入你任意一个代码项目文件夹，直接输入命令 claude 即可启动！

--------------

恭喜你成功安装了 Claude Code！要在 Claude Code 中使用 DeepSeek V4 模型，核心思路就是“偷梁换柱”：告诉 Claude Code 不要去找国外的官方接口，而是去调用 DeepSeek 的接口。

这里为你提供两套非常实用的操作教程，你可以根据自己的习惯任选其一：

方法一：直接修改配置文件（最轻量，适合固定使用）

这种方法只需要新建一个配置文件，一劳永逸。

1. 找到配置目录
   按下键盘上的 Win + R 键，输入 %USERPROFILE% 并回车，这会打开你的个人用户文件夹（通常是 C:\Users\你的用户名）。
2. 新建 settings.json
   在这个文件夹里，找到（或者新建）一个名为 .claude 的文件夹。进入该文件夹，新建一个名为 settings.json 的文件。
3. 写入配置代码
   用记事本打开 settings.json，将下面的代码复制进去。注意：一定要把 你的DeepSeek_API_Key 替换成你真实的 API 密钥！

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek_API_Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash"
  }
}

(注：[1m] 代表开启 100万 超长上下文，deepseek-v4-flash 是轻量极速版，deepseek-v4-pro 是编程推理能力更强的满血版。)

---

方法二：使用 CC-Switch 图形化工具（最直观，方便随时切换模型）

如果你觉得改代码麻烦，或者想随时在 DeepSeek、Kimi、智谱等多个国产模型之间切换，强烈推荐这个可视化小工具。

1. 下载并安装 CC-Switch
   去 GitHub 搜索 cc-switch，在 Releases 页面下载 Windows 版的 .msi 安装包，双击无脑安装即可。
2. 添加 DeepSeek 供应商

• 打开 CC-Switch 软件，点击右上角的 “+” (添加新供应商)。
• 在列表中选择 DeepSeek。
• 将你的 API Key 粘贴进去。
• 请求地址保持默认：https://api.deepseek.com/anthropic。

1. 配置模型映射
   在模型映射（Model Mapping）区域，将主模型、Opus、Sonnet 等选项全部填写为 deepseek-v4-pro[1m]（或者 deepseek-v4-pro），然后点击“添加”保存。
2. 启用配置
   回到 CC-Switch 主界面，选中你刚添加的 DeepSeek 配置，点击 “Enable” (启用)。只要 CC-Switch 在后台运行，Claude Code 就会自动走这个通道。

---

🚀 启动与验证

无论你用了上面哪种方法，接下来都要做这几步：

1. 跳过首次登录
   按下 Win + R，输入 %USERPROFILE% 回车。在文件夹里新建（或修改）一个名为 .claude.json 的文件，填入以下内容并保存：

{
  "hasCompletedOnboarding": true
}

1. 启动 Claude Code
   彻底关闭并重新打开你的 PowerShell 或 CMD 终端，进入你的代码项目文件夹，输入 claude 并回车。
2. 验证是否成功
   进入交互界面后，直接问它：“你是什么模型？”
   如果它回答“我是 DeepSeek V4 Pro”，恭喜你，大功告成！你也可以输入 /model 命令，查看当前挂载的模型列表。

快去试试吧！如果遇到任何报错，随时把错误信息发给我。