Windows系统安装Claude Code CLI完整指南

Claude Code 是 Anthropic 推出的一款领先的 AI 编程助手，支持自然语言交互、代码生成、文件操作等一系列强大功能。如果您正在使用 Windows 系统并希望安装这款工具，本文将为您详细介绍两种可行的安装方法，同时解决常见的 PowerShell 执行权限问题，助您顺利完成部署。

前言

首先明确一点：Claude Code 不仅支持 Linux 和 macOS，在 Windows 系统上同样可以顺畅运行。不过，安装过程中可能会遇到几个小问题，主要集中在 PowerShell 执行策略和 Node.js 环境配置上。接下来，我们将详细剖析两种安装方法，让您发现整个过程并不复杂。

方法一：官方脚本安装（推荐）

安装步骤

1. 启动 PowerShell
   按下 Win + X，选择 Windows PowerShell（或通过搜索直接打开 PowerShell 均可）。

2. 执行官方安装脚本

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

   这一行命令会自动完成下载与配置，非常高效省心。

3. 等待安装完成
   脚本将自动下载并配置 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”即可找到详细教程。

安装步骤

1. 全局安装 Claude Code CLI

   npm install -g @anthropic-ai/claude-code

2. 等待安装完成——该过程可能耗时数分钟，具体取决于您的网络速度。

3. 验证安装

   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"
}

常用命令速查

常见问题排查

问题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 带来的编程效率提升。