Windows 安装 Claude Code 并接入 DeepSeek:2026 完整教程
不需要 Node.js,不需要梯子登录,不需要 Claude 账号。Windows 原生一行命令安装 Claude Code,两个环境变量接入 DeepSeek API,十分钟跑通。
不需要 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,然后问它"帮我看一下这个目录有什么文件,主要做什么的"。看到它实际读你的文件、给出分析,就知道它能干什么了。