Claude Code 是 Anthropic 推出的一款领先的 AI 编程助手,支持自然语言交互、代码生成、文件操作等一系列强大功能。如果您正在使用 Windows 系统并希望安装这款工具,本文将为您详细介绍两种可行的安装方法,同时解决常见的 PowerShell 执行权限问题,助您顺利完成部署。
前言
首先明确一点:Claude Code 不仅支持 Linux 和 macOS,在 Windows 系统上同样可以顺畅运行。不过,安装过程中可能会遇到几个小问题,主要集中在 PowerShell 执行策略和 Node.js 环境配置上。接下来,我们将详细剖析两种安装方法,让您发现整个过程并不复杂。
方法一:官方脚本安装(推荐)
安装步骤
启动 PowerShell
按下Win + X,选择 Windows PowerShell(或通过搜索直接打开 PowerShell 均可)。执行官方安装脚本
irm https://claude.ai/install.ps1 | iex
这一行命令会自动完成下载与配置,非常高效省心。
等待安装完成
脚本将自动下载并配置 Claude Code CLI,通常情况下无需额外操作。
⚠️ 可能遇到的问题
如果执行脚本时遇到报错:
无法加载文件 xxxinstall.ps1,因为在此系统上禁止运行脚本
解决方法十分简单:以管理员身份运行 PowerShell,然后执行以下命令:
Set-ExecutionPolicy RemoteSigned
输入 Y 确认即可。该命令的作用是允许系统运行受信任的本地脚本。完成后重新执行安装命令即可正常安装。
方法二:npm 安装方式
虽然官方已不再推荐此方式,但如果您因网络限制或官方脚本问题导致安装失败,npm 方法仍是一个可靠的备选方案。
前置条件
确认 Node.js 版本
node --version
输出示例:v18.17.0,要求版本 ≥ 18。
如果提示“命令不存在”,说明尚未安装 Node.js,请前往 nodejs.org 下载最新的 LTS 版本并安装。
如果版本低于 18,建议使用 NVM(Node Version Manager)来管理多个 Node.js 版本,Windows 上同样支持,具体搜索“Windows 使用 NVM 管理 Node.js”即可找到详细教程。
安装步骤
全局安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code
等待安装完成——该过程可能耗时数分钟,具体取决于您的网络速度。
验证安装
claude --version
如果输出类似
Claude Code CLI v2.0.xx,则表示安装成功。
⚡ PowerShell 执行权限问题解决
问题现象
当运行 claude 命令时,有时会出现以下错误:
无法加载文件 C:xxxnodejsclaude.ps1,因为在此系统上禁止运行脚本。
这并非软件故障,而是 Windows 系统的默认安全策略所致。实际上,许多用户在首次使用 Node.js 全局命令时都会遇到此问题。

解决方案
步骤1:以管理员身份打开 PowerShell
步骤2:执行以下命令更改执行策略:
Set-ExecutionPolicy RemoteSigned
步骤3:输入 Y 确认更改
步骤4:重新运行 claude 命令:
claude
如果一切正常,您将看到如下界面:
┌─────────────────────────────────────────────────────────────┐ │ Claude Code CLI v2.0.xx │ │ Type '/help' for a vailable commands │ └─────────────────────────────────────────────────────────────┘

配置模型与 Token
1. 设置 API Token
在 Claude Code CLI 中输入以下命令:
/login
随后根据提示输入您的 API Key。
2. 选择模型
/model
输入以下命令选择模型:
/model
然后选择您要使用的模型,例如 deepseek-v4-pro。
3. 配置文件说明
配置文件通常存储在 C:Users<您的用户名>.claudesettings.json,示例如下:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "sk-你的API-Key",
"ANTHROPIC_MODEL": "deepseek-v4-pro"
},
"model": "deepseek-v4-pro"
}
常用命令速查
| 命令 | 功能说明 |
|---|---|
| claude | 启动 CLI |
| claude --version | 查看版本 |
| /login | 登录并配置 API Key |
| /model | 选择模型 |
| /help | 查看帮助 |
| /exit | 退出 CLI |
常见问题排查
问题1:npm 安装速度慢
此现象很常见,尤其在国内网络环境下。通过配置国内镜像源即可解决:
npm config set registry https://registry.npmmirror.com
问题2:API Key 无效
首先确认 API Key 是否正确复制,其次检查网络能否正常访问对应的 API 服务,并确认 Token 是否已过期。
问题3:模型选择后无法使用
此问题通常与网络连接有关。请检查您的 API Key 是否具备该模型的访问权限,或尝试重新登录。
总结
本文全面介绍了在 Windows 上安装 Claude Code CLI 的两种方法:官方脚本安装(推荐)和 npm 安装(备选)。前者一键安装并自动配置,适用于多数场景;后者作为官方脚本失效时的可靠备选。此外,文章还提供了 PowerShell 执行权限问题的解决方案,以及模型与 Token 的详细配置说明。
整个安装与配置过程只需十分钟左右,完成后您即可开始享受 Claude Code 带来的编程效率提升。
