Windows 实操教程 · 2026 年 7 月 28 日更新
Windows 安装 Claude Code
接入 DeepSeek V4
已经装好 Claude Code 的用户可以直接更新模型变量;第一次安装的用户从环境检查开始。 你只需要自己的 DeepSeek API Key,全程不需要把 Key 交给第三方。
手动教程永久免费;自检不读取电脑文件,也不要求输入 API Key。
- 适用系统
- Windows 10 / 11 64 位
- 预计时间
- 已有环境约 5 分钟;首次安装 15–30 分钟
- 需要准备
- DeepSeek 账号与 API Key
- 费用
- 教程免费,API 用量由 DeepSeek 计费
01
开始前先确认四件事
电脑需要是 Windows 10 或 Windows 11 的 64 位版本,并且能够联网下载安装依赖。 按 DeepSeek 当前的 Windows 接入说明,建议先准备 Node.js 18+ 与 Git for Windows。 DeepSeek API Key 需要从自己的 DeepSeek Platform 账号创建。
Windows 10 / 11 64 位
Node.js 18+ 与 Git for Windows
可以安装软件的 Windows 用户
自己的 DeepSeek API Key
API Key 相当于账户凭证。不要发到群聊、评论区或截图中,也不要使用来历不明的共享 Key。
02
先认准终端,再安装 Claude Code
Anthropic 当前推荐使用原生安装程序。先看命令提示符:以
PS C:\ 开头的是 PowerShell;只有 C:\、没有
PS 的是 CMD。两种终端必须使用各自对应的命令。
PowerShell:
irm https://claude.ai/install.ps1 | iex
CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
也可以使用 WinGet:
winget install Anthropic.ClaudeCode
安装结束后完全关闭当前终端,重新打开一个新窗口,再确认版本和命令路径:
claude --version
where.exe claude
不要把 PowerShell、CMD 和 macOS/Linux 命令混着复制。看到
'irm' 不是内部或外部命令,通常说明你在 CMD 里运行了
PowerShell 命令;看到 '&&' 不是有效的语句分隔符,
通常说明你在旧版 PowerShell 里运行了 CMD 命令。
DeepSeek 官方接入文档仍提供 Node.js 18+ 与 npm 安装路径。如果你选择该路径,
请先运行 node --version 和 npm --version,再执行:
npm install -g @anthropic-ai/claude-code
claude --version
03
把 Claude Code 指向 DeepSeek API
如果你以前只配置了两个变量,或仍在使用旧模型名,请按下面这组当前配置完整更新。
在新的 PowerShell 窗口中设置环境变量,并把
你的 DeepSeek API Key 替换成自己创建的 Key,不要保留尖括号。
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="你的 DeepSeek API Key"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
上面的 $env: 写法只对当前 PowerShell 会话生效。关闭窗口后如果不想重复输入,
可以使用 Windows 用户环境变量持久保存;保存前请再次确认变量名和 Key 没有多余空格。
具体检查和保存顺序见
关闭 PowerShell 后配置失效的独立教程。
DeepSeek 已将 Claude Code 的当前模型配置切换为 V4 Pro 与 V4 Flash。
旧的 deepseek-chat、deepseek-reasoner 配置不应继续沿用。
04
进入项目目录并启动
先进入自己的项目文件夹,再启动 Claude Code:
cd C:\你的项目目录
claude
第一次打开时可能出现主题选择。按界面提示选择主题,进入输入区域后先问一个简单问题, 例如“请概括当前目录的文件结构”。如果能够正常返回内容,基础配置已经完成。
运行产生的模型费用由 DeepSeek 直接从你的 API 账户余额扣取,智域科技不会代收 API 费用。
05
最常见的六类错误
提示 irm 不是内部或外部命令
当前窗口是 CMD,不是 PowerShell。不要继续重复执行;改用 CMD 安装命令,
或重新打开 PowerShell 后执行以 irm 开头的命令。
提示 && 不是有效的语句分隔符
当前窗口通常是旧版 PowerShell,却粘贴了 CMD 命令。请使用 PowerShell
安装命令,或打开 CMD 再执行包含 && 的命令。
提示 claude、node 或 git 不是命令
安装没有完成或 PATH 尚未刷新。完全关闭终端后重新打开,运行
claude --version 和 where.exe claude;只有选择
npm 安装路径时才需要继续检查 Node.js。若当前错误就是
“claude 不是内部或外部命令”,请按
Windows Claude Code 命令找不到专项教程
逐项判断终端刷新、安装结果和 PATH。
Claude Code 找不到 Git Bash
Git for Windows 目前是可选项:安装后 Claude Code 可使用 Git Bash;未安装时
会使用 PowerShell。若已经安装但仍找不到,可在配置中设置
CLAUDE_CODE_GIT_BASH_PATH 指向实际的 bash.exe。
返回 401、认证失败或 Key 无效
检查 API Key 是否完整、是否复制了空格,并确认 DeepSeek 账户状态和余额正常。
关闭 PowerShell 后配置失效
$env: 只写入当前会话。需要把同名变量写入当前 Windows
用户环境变量,或每次启动前重新执行配置。
06
不想逐项排错时,再考虑自动配置
手动配置本身是免费的。如果你已经能看懂命令、会检查 PATH 和环境变量,没有必要购买工具。 Claude Code Bridge 适合第一次配置、希望自动检测 Node、Git、VS Code、Claude Code, 并把当前 V4 变量持久写入 Windows 用户环境的用户。
先免费确认电脑与账号条件;符合后再决定是否一次性 ¥19.9 购买,不自动续费。
自检不读取电脑文件,也不要求输入 API Key。售价不包含 DeepSeek API Key 或 API 额度; 电脑不符合已声明要求时,可按退款规则处理。