Windows 安装 Claude Code CLI 完整指南

目录

• 🔥 前言
• 📋 方法一：官方脚本安装（推荐）
• 安装步骤
• ⚠️ 可能遇到的问题
• 📦 方法二：npm 安装方式
• 前置条件
• 安装步骤
• ⚡ PowerShell 执行权限问题解决
• 问题现象
• 解决方案
• 🔧 配置模型与 Token
• 1. 设置 API Token
• 2. 选择模型
• 3. 配置文件说明
• 🎯 常用命令速查
• ❌ 常见问题排查
• 问题1：npm 安装速度慢
• 问题2：API Key 无效
• 问题3：模型选择后无法使用
• 📝 总结

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

如果执行脚本时报错：

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

解决方案：

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

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

确认 Node.js 版本：

node --version

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

版本过低处理：

• 如果 Node.js 版本低于 18，建议使用 NVM 管理多版本（参考：Windows 使用 NVM 管理 Node.js）

1. 全局安装 Claude Code

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

2. 等待安装完成

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

3. 验证安装

   claude --version
   

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

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

无法加载文件 C:xxxnodejsclaude.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                       │
└─────────────────────────────────────────────────────────────┘

在 Claude Code CLI 中输入：

/login

根据提示输入你的 API Key。

/model

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

配置文件位于：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

解决方案：配置国内镜像

npm config set registry https://registry.npmmirror.com

解决方案：

• 确认 API Key 正确无误
• 检查网络是否能访问对应服务
• 确认 Token 未过期

解决方案：

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

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

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

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

到此这篇关于Windows 安装 Claude Code CLI 完整指南的文章就介绍到这了,更多相关Claude Code CLI指南内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！