Windows 安装 Claude Code 并接入 DeepSeek:2026 完整教程

不需要 Node.js,不需要 npm,不需要 WSL。现在的 Windows 安装 Claude Code 是一行 PowerShell 命令的事。接入 DeepSeek 同样只需要两个环境变量,不用改任何配置文件,不用第三方切换工具。

这篇文章基于 2025 年底发布的原生 Windows 安装路径写成,如果你看到的教程还在叫你先装 Node.js 再 npm install -g @anthropic-ai/claude-code,那个方法已经被官方废弃了,照着做大概率会遇到各种奇怪问题。


安装前需要准备的东西

只有一个:Git for Windows

Claude Code 依赖 Git 做版本管理,Windows 不自带,必须先装好。去 git-scm.com 下载安装包,一路 Next 就行,不需要改任何选项。

装好之后,打开 PowerShell,输入 git --version,能看到版本号就行。

Node.js 不需要装,那是旧方法的依赖。


安装 Claude Code

打开 PowerShell(不需要管理员权限),粘贴这一行:

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

等它跑完,输入 claude --version 验证:

claude 2.x.x

能看到版本号,安装完成。安装程序会把二进制文件放到 %USERPROFILE%\.local\bin,并自动加进 PATH。如果输入 claude 提示 "未找到命令",关掉当前 PowerShell 重新开一个,PATH 更新需要新会话生效。

如果遇到"脚本禁止运行"

这是 Windows 的执行策略限制,报错长这样:

irm : 无法加载文件 ... 因为在此系统上禁止运行脚本。

或者英文环境下:

running scripts is disabled on this system

在同一个 PowerShell 窗口先执行这行,然后再重试安装:

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

提示确认时输入 A 回车。这个命令只改当前用户的策略,不影响系统级设置。


接入 DeepSeek

Claude Code 工具本身免费,但跑任务需要一个大模型后端。接 DeepSeek 是目前成本最低的方式——DeepSeek 官方文档明确支持 Anthropic API 格式(参考文档),Claude Code 可以直接对接,不需要任何中间层。

第一步:拿到 DeepSeek API Key

platform.deepseek.com 注册并创建一个 API Key。新用户会有免费额度,用来跑通流程完全够。

第二步:设置两个环境变量

方式 A:当前会话临时生效(测试用)

在 PowerShell 里运行:

$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的DeepSeekAPIKey"

关掉这个窗口变量就消失,下次需要重新设。

方式 B:永久写入系统环境变量(日常用,推荐)

在 PowerShell 里运行:

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的DeepSeekAPIKey", "User")

写入后关掉 PowerShell,重新打开,变量就永久生效了。

第三步:进入 Claude Code

claude

第一次进入会有几个初始化提示,确认一下就行。进去之后可以问它当前用的是什么模型:

/model

它会列出可用的模型列表。DeepSeek 接通后,应该能看到 deepseek-chat(对应 DeepSeek V3)或 deepseek-reasoner(对应 DeepSeek R1)。


日常使用:几个要知道的基础

选择模型

/model

进入模型选择界面,可以在不同 DeepSeek 模型间切换。

打开一个项目

在你的项目目录下直接运行 claude,它会自动读取当前目录的文件结构。不要在 C:\ 或桌面这类宽泛的位置启动,给它一个明确的项目目录。

权限模式

第一次让它改文件时,默认每步都会问你确认。如果信任当前任务,可以选 "Yes, allow all edits in this session" 让它自动执行,不用每步点击。

上下文文件

在项目根目录创建一个 CLAUDE.md 文件,写上项目背景、技术栈、你的偏好(比如"必须回复中文")。Claude Code 每次启动时会自动载入这个文件,不用每次重复解释。


Token 消耗大概是多少

DeepSeek 按 token 计费,跑不同任务消耗差异很大:

  • 让它回答一个问题:几分钱
  • 让它生成一个完整的网页:几毛到一块
  • 让它重构一个中等规模的功能模块:一到几块

10 块钱的 DeepSeek 充值额度,轻度使用可以撑很久。重度使用(让它跑复杂的多文件任务)消耗会快很多。


常见问题

Q:安装完输入 claude 提示"不是内部或外部命令"

PATH 没刷新。关掉当前 PowerShell,重新打开一个,再试。如果还是不行,手动检查 %USERPROFILE%\.local\bin 目录下是否有 claude.exe,有的话把这个路径手动加进系统 PATH。

Q:设置了环境变量,进去还是提示要登录 Claude 账号

确认变量名拼写正确——是 ANTHROPIC_AUTH_TOKEN,不是 ANTHROPIC_API_KEY。用方式 B 写入后,必须重新打开 PowerShell 才会读到新变量,同一个窗口里不生效。

Q:能用 DeepSeek V4 吗

能。DeepSeek V4 Pro 对应的模型名是 deepseek-chat(DeepSeek 会持续将该接口指向最新的生产版本)。如果想固定用某个具体版本,在 /model 界面查看当前可选的全部名称。

Q:CC Switch 还需要用吗

如果只用 DeepSeek,不需要。直接设环境变量是官方支持的接入方式,CC Switch 是之前的社区解决方案,在原生支持出来之前更流行。现在更简单的方式是直接用环境变量,少一个依赖。

Q:这样用安全吗,代码会上传给 DeepSeek 吗

Claude Code 本地运行,你的项目文件存在本地,不会上传到 Anthropic 服务器。但你发给模型的对话内容(包括你粘贴的代码片段)会通过 DeepSeek API 传给 DeepSeek 服务器处理,这一点和直接在 DeepSeek 官网对话是一样的。涉及公司保密代码的话,需要自行评估合规性。


安装完之后建议做的第一件事:在一个小项目目录下输入 claude,然后问它"帮我看一下这个目录有什么文件,主要做什么的"。看到它实际读你的文件、给出分析,就知道它能干什么了。