游乐游手机版
首页/AI教程/文章详情

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

时间:2026-06-11 16:21
Windows安装ClaudeCodeCLI推荐官方脚本一键安装,也可用npm。需以管理员身份运行PowerShell并设置执行策略解决权限问题,随后配置模型与Token即可使用。

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

常用命令速查

命令功能说明
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 带来的编程效率提升。

来源:https://www.jb51.net/ai/1030492.html
上一篇年Claude Code常用命令速查大全 下一篇年Claude Code命令使用完全指南
本站内容用于信息整理与展示,如有侵权或内容问题请及时联系处理。

相关推荐

补充同频道和同主题内容,方便继续浏览更多相关内容。

同类最新

继续查看同栏目最近更新的文章。

更多
批处理BAT入门教程第一篇
AI教程 · 2026-07-03

批处理BAT入门教程第一篇

提供13个批处理实战技巧,覆盖全盘查找并删除文件夹或文件、拷贝移动文件、创建畸形文件夹及设置隐藏属性等场景,可一键完成系统维护与文件管理工作,极大提升自动化操作效率和便捷性。

从零开始批处理命令For循环详解与实战案例
AI教程 · 2026-07-03

从零开始批处理命令For循环详解与实战案例

批处理For命令支持 d、 l、 r、 f四个参数。 d仅列出当前目录下的目录名; r递归搜索指定路径及其子目录中的文件; l生成数值序列; f可解析文件、字符串或命令输出,通过delims、tokens、skip、eol等选项灵活处理内容。

批评你的人是你生命中的贵人
AI教程 · 2026-07-03

批评你的人是你生命中的贵人

批评你的人往往最值得珍惜,因为他们关注你、助你成长。面对批评应包容反思,用行动改进而非辩解。接受批评是自我完善的过程,能让人少走弯路,避免重复犯错。这样的人正是生命中的贵人,值得感恩与珍惜。

测试人员角色定位与职责详解
AI教程 · 2026-07-03

测试人员角色定位与职责详解

测试人员角色经历了从找问题、保证质量到分析风险的转变,最终核心职责是提供关键信息,协助团队创造优秀产品。这包括识别问题、评估风险及帮助团队了解项目状态,而非单纯把关或追求完美。

经营成功测试生涯的实用方法与策略
AI教程 · 2026-07-03

经营成功测试生涯的实用方法与策略

一、测试生涯的起点 1989年,我在田纳西大学攻读研究生时,意外地从软件开发人员转行成为一名软件测试工程师。这并非我主动选择,说起来还有些戏剧性——某个早晨,教授质问我为何缺席那么多开发会议,我解释说这些会议总是安排在周末早上,对我这个第一次离家、刚入学的学生来说实在不便。结果呢?等待我的不是解聘通