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 --version

输出示例：v18.17.0。版本必须 ≥ 18。

如果提示“命令不存在”，说明你还没装 Node.js，去 nodejs.org 下载一个 LTS 版本装上就行。

如果版本低于 18，建议用 NVM 来管理多个 Node.js 版本，这在 Windows 上也能实现，具体方法可以搜一下“Windows 使用 NVM 管理 Node.js”，不复杂。

安装步骤

1. 全局安装 Claude Code

   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 全局命令时都会遇到它。

解决方案

：以管理员身份打开 PowerShell
：执行：

Set-ExecutionPolicy RemoteSigned

：输入 Y 确认
：重新运行 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

选择你想要使用的模型，比如 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	启动 Claude Code 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 带来的编程效率提升了。