Windows 安装 Claude Code CLI 完整指南

? 前言

Claude Code 是 Anthropic 推出的新一代 AI 编程助手，支持自然语言交互、代码生成、文件操作等强大功能。本文将详细介绍在 Windows 系统上安装 Claude Code CLI 的两种方式，并解决常见的 PowerShell 执行权限问题。

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

安装步骤

1. 打开 PowerShell

   • 按下 Win + X，选择 Windows PowerShell（或 PowerShell）

2. 执行官方安装脚本

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

3. 等待安装完成

   • 脚本会自动下载并配置 Claude Code CLI

⚠️ 可能遇到的问题

如果执行脚本时报错：

无法加载文件 xxx\install.ps1，因为在此系统上禁止运行脚本

解决方案：

# 以管理员身份运行 PowerShell
Set-ExecutionPolicy RemoteSigned
# 输入 Y 确认

? 方法二：npm 安装方式

? 官方已不再推荐此方式，但如果你遇到官方脚本安装失败，可以尝试此方法

前置条件

确认 Node.js 版本：

node --version

• ✅ 输出示例：v18.17.0（版本需 ≥ 18）
• ❌ 如果提示"命令不存在"，请前往 nodejs.org 下载安装

版本过低处理：

• 如果 Node.js 版本低于 18，建议使用 NVM 管理多版本

安装步骤

1. 全局安装 Claude Code

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

2. 等待安装完成

   • ⏳ 可能需要几分钟，请耐心等待

3. 验证安装

   claude --version
   

   ✅ 输出示例：Claude Code CLI v2.0.xx

⚡ PowerShell 执行权限问题解决

问题现象

运行 claude 命令时出现以下错误：

无法加载文件 C:\xxx\nodejs\claude.ps1，因为在此系统上禁止运行脚本。
有关详细信息，请参阅 https://go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。

解决方案

步骤1：以管理员身份打开 PowerShell

步骤2：执行以下命令：

Set-ExecutionPolicy RemoteSigned

步骤3：输入 Y 确认更改

步骤4：重新运行 claude 命令

claude

✅ 成功启动界面示例：

┌─────────────────────────────────────────────────────────────┐
│  Claude Code CLI v2.0.xx                                   │
│  Type '/help' for available commands                       │
└─────────────────────────────────────────────────────────────┘

? 配置模型与 Token

1. 设置 API Token

在 Claude Code CLI 中输入：

/login

根据提示输入你的 API Key。

2. 选择模型

/model

选择你想要使用的模型（如 deepseek-v4-pro）。

3. 配置文件说明

配置文件位于：C:\Users\<你的用户名>\.claude\settings.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 正确无误
• 检查网络是否能访问对应服务
• 确认 Token 未过期

问题3：模型选择后无法使用

解决方案：

• 检查网络连接
• 确认 API Key 有权限访问该模型
• 尝试重新登录

? 总结

本文介绍了在 Windows 上安装 Claude Code CLI 的两种方式：

1. 官方脚本安装（推荐）：一键安装，自动配置
2. npm 安装：适用于官方脚本安装失败的情况

同时解决了 PowerShell 执行权限问题，并介绍了模型配置方法。现在你可以开始使用 Claude Code 提升编程效率了！