在 Windows 上跑起 Claude Code,核心步骤就四个:装 Node.js、装 Git、装 VSCode、装 Claude Code CLI。国内用户额外需要配置 npm 镜像加速,以及处理登录问题——Anthropic 对中国大陆有访问限制,直接走官方登录流程容易失败,可以通过配置国内兼容 API 来绕开这个问题。 Windows 安装 Claude Code 第一步:安装 Node.js
Node.js 是很多 AI 工具的运行环境,Claude Code CLI 的安装依赖它自带的包管理器 npm。
下载地址:nodejs.org/zh-cn/download
打开官网会看到两个版本选项:LTS 版本(长期支持,稳定,推荐)和 Current 版本(最新功能但可能不稳定)。选 LTS 版本,点击 Windows Installer (.msi) 下载。
安装过程跟装普通软件差不多,有一步要注意:在"Custom Setup"界面,确保勾选"Add to PATH",这个选项会自动配置环境变量,不勾的话后面命令行会找不到 node 命令。其他步骤保持默认,一路 Next 到 Finish。
Windows 安装 Claude Code 第二步:安装 Git
Git 是 Claude Code 的强依赖,不只是用来管理代码,工具本身的安装和更新也会用到它。
下载地址:git-scm.com,打开后会自动检测系统版本,点对应版本下载。
安装时同样注意勾选"Add to PATH",其他选项保持默认就行。
配置 npm 国内镜像
装完 Node.js 和 Git 之后,建议立即配置 npm 镜像,否则后续安装包的速度会很慢,甚至直接失败。
打开 PowerShell,运行:
验证是否生效:
输出 https://registry.npmmirror.com 就说明配置成功了。
Windows 安装 Claude Code 第三步:安装 VSCode
VSCode 是使用 Claude Code 最顺手的编辑器,轻量、插件丰富,目前也是最主流的选择。
下载地址:code.visualstudio.com,点"Download for Windows"下载。
安装时有两个选项要勾上:"Add to PATH" 和 "Register Code as an editor"(桌面右键菜单关联),其他保持默认。
配置插件市场国内镜像
无代理环境下,VSCode 默认从微软官方插件市场下载可能很慢。按 Ctrl+,(英文逗号)打开设置,右上角点"打开设置(JSON)"图标,在 settings.json 里加入:
保存后重启 VSCode,插件下载速度会明显改善。
安装中文界面
按 Ctrl+Shift+X 打开扩展面板,搜索"Chinese",安装"Chinese (Simplified) Language Pack for Visual Studio Code",重启后界面就变成中文了。
Windows 安装 Claude Code 第四步:安装 Claude Code CLI
前面几步都完成后,打开 PowerShell 运行:
等安装完成,验证一下:
能看到版本号就说明安装成功。
Windows 安装 Claude Code 第五步:安装 VSCode 插件
除了命令行,Claude Code 还有 VSCode 插件,可以在编辑器里直接交互,更方便。
按 Ctrl+Shift+X 打开扩展面板,搜索"Claude",找到"Claude Code for VS Code"插件安装,装完后左侧边栏会出现 Claude 图标。
Windows 安装 Claude Code 第六步:处理登录问题
这一步是国内用户最容易卡住的地方。Anthropic 对中国大陆有访问限制,直接走官方登录流程基本会失败,甚至有封号风险。
可行的处理思路是:跳过官方账号体系,配置国内兼容 API,让 Claude Code 客户端通过第三方模型服务运行。
需要注意的是,这种方式绕过了 Anthropic 的官方授权流程,请自行评估是否符合你的使用场景和相关服务条款。
第一步:创建基础配置文件
找到以下路径(如果文件不存在就手动创建):
用 VSCode 打开,粘贴以下内容并保存:
第二步:配置模型 API
找到以下路径(目录或文件不存在就手动创建):
以接入国内兼容 API 为例,将以下内容粘贴进去,替换为你实际使用的服务 API Key 和接口地址:
几个配置项说明:ANTHROPIC_BASE_URL 填你使用的服务商 API 地址;API_TIMEOUT_MS 设为 3000000(即 50 分钟),适合长任务;CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 设为 1 可以减少非必要的网络请求干扰。
国内目前有多家提供 Claude 兼容接口的服务商,具体选哪家、用什么模型,建议根据你的实际需求和预算自行选择和评估,本文不做具体推荐。
验证 Claude Code 是否跑通
配置完成后,打开终端输入:
如果看到 Claude Code 的欢迎信息和命令提示符,说明整个环境配置成功。输入 exit 或按 Ctrl+C 退出。
整套流程走下来,Claude Code 在 Windows 上的环境配置并不算复杂,主要的坑在于 npm 镜像和登录问题这两块。环境搭好之后,无论是命令行还是 VSCode 插件,Claude Code 的实际使用体验都相当顺手,值得花这点时间把环境配置好。