[特殊字符]️ Windows 11 安装 Claude Code 并接入 DeepSeek 技术文档

这份文档整合了在 Windows 11 环境下安装 Claude Code 并配置 DeepSeek V4-Pro 模型的完整流程，涵盖了从环境准备、软件安装到 API 配置及验证的全过程。

一、 环境准备与前置依赖

在安装 Claude Code 之前，请确保 Windows 11 系统已安装以下基础工具：

• Git for Windows：Claude Code 在终端运行需要依赖 Git 环境。安装时请保持默认选项，确保勾选相关命令行工具。
• Node.js (v18+)：部分 CLI 安装方式及运行环境需要 Node.js 支持。

二、 安装 Claude Code

推荐使用 Windows 自带的包管理器WinGet进行安装，这是目前在 Windows 上最稳定且不易受网络拦截影响的方式。

1. 打开PowerShell或CMD终端。
2. 执行以下安装命令：

   winget install Anthropic.ClaudeCode

3. 等待安装进度条完成。

💡 环境变量配置（如遇“无法识别命令”报错）：
安装完成后，如果在新终端输入claude提示无法识别，需手动添加环境变量：

• 按下Win + R，输入sysdm.cpl打开系统属性。
• 点击“高级” -> “环境变量”。
• 在“用户变量”中找到并双击Path，点击“新建”。
• 粘贴 Claude 的默认安装路径（通常为C:\Users\你的用户名\.local\bin），一路点击“确定”保存。
• 彻底关闭并重新打开终端以使配置生效。

三、 配置 DeepSeek 模型（免第三方工具版）

为了让 Claude Code 调用 DeepSeek-V4-Pro 模型，最直接的方法是修改其本地配置文件。

1. 创建配置目录：
   在文件管理器地址栏输入%USERPROFILE%并回车，进入用户主目录。新建一个名为.claude的文件夹（注意包含前面的点）。

2. 创建配置文件：
   进入.claude文件夹，新建一个名为settings.json的文本文档。

3. 写入配置信息：
   打开settings.json，将以下 JSON 代码复制进去并保存（请将你的DeepSeek_API_Key替换为你实际申请的 API Key）：

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

四、 启动与验证

1. 彻底关闭当前终端，重新打开一个新的 PowerShell 或 CMD 窗口。
2. 输入claude并回车启动。
3. 观察启动后的欢迎界面，如果显示出DeepSeek-V4-Pro · API Usage Billing字样，说明配置成功。
4. 你也可以直接在对话框中输入“你是什么模型？”进行最终验证。

---

附录：使用 CC-Switch 图形化工具配置（可选方案）

如果你不习惯手动修改配置文件，也可以使用开源的图形化管理工具CC-Switch来快速切换模型。

1. 下载安装：访问 GitHub Releases 页面，下载最新版的CC-Switch-vx.xx.x-Windows.msi安装包并安装。
2. 添加供应商：打开 CC-Switch，点击“+”号，选择 DeepSeek。
3. 填入密钥：粘贴你的 DeepSeek API Key，软件会自动填入兼容的 Base URL。
4. 启用配置：点击“添加”并在列表中点击“启用 (Enable)”。状态变为 Active 后，重启终端输入claude即可生效。