三种CLI安装方案

方案 A：安装 Node.js（可以使用 npm 方式安装 claude CLI）

1. 打开官网下载 LTS 稳定版安装包 地址：https://nodejs.org/

选择 LTS（长期支持版本，不要选最新尝鲜版）

1. 运行 .msi 安装包，全程默认下一步，安装程序自动配置环境变量 PATH
2. 安装完成后，彻底关闭所有 PowerShell、VS Code 窗口，重新打开终端
3. 验证安装：

node -v
npm -v

正常输出版本号即成功，之后再执行安装命令：

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

---

方案 B【备选，不用装 Node.js】直接用官方 PowerShell 脚本安装 Claude CLI

新开 PowerShell 执行这条官方安装指令：

iwr https://code.claude.com/install.ps1 -useb | iex

⚠️安装完成后留意两点：

1. claude 程序默认路径：C:\Users\HU\.local\bin
2. 如果安装完依旧提示 claude 命令找不到，手动把上面路径添加进系统 PATH 环境变量，重启终端生效。

方案C：WinGet 安装（网络不佳时备选）

如果官方脚本下载失败，可以用 Windows 自带的包管理器安装：

winget install Anthropic.ClaudeCode

• 安装完成后，关闭当前所有 PowerShell 窗口，重新打开一个新终端（刷新系统环境变量）
• 验证安装是否成功：

  claude --version
  

  终端输出版本号（如 v1.x.x）即代表安装完成。

三条安装方式完整对比

命令：winget install Anthropic.ClaudeCode 先给结论：WinGet 方式 ≈ 升级改良版方案 B，和方案 A 完全不是一类。

三者底层区分

方案 A：npm install（依赖 Node.js）

• 载体：NPM 包
• 前提：电脑必须安装 Node.js + npm

• 原理：@anthropic-ai/claude-code 是一个npm 软件包。 npm = Node.js 自带包管理器，没有 Node 就无法运行 npm。 流程：安装 Node → 获得 npm → 通过网络下载 claude CLI。

• ✅优点：

1. Node 是通用开发环境，后续如果你写前端、运行很多开源工具都会用到
2. 生态更广，以后其他 js 类工具都可以直接用npm install -g安装 ❌缺点：
3. 额外安装大型软件；如果你只用 claude，属于 “杀鸡用牛刀”

• 缺点：额外占用磁盘，对纯 Python 开发冗余

方案 B：官方 PowerShell 脚本 iwr ... | iex

• 载体：远程 PS1 脚本
• 前提：无依赖
• 原理：脚本自动下载 claude.exe 放到 C:\Users\HU\.local\bin
• 缺点：国内网络可能无法访问，直接下载到网页 HTML，执行报错

方案 C（python内推荐使用）：WinGet winget install Anthropic.ClaudeCode

• 载体：Windows 官方系统自带软件包管理器
• 前提：不需要 Node.js，不需要手动下载压缩包
• 原理：直接从微软官方软件源获取编译好的独立 claude.exe
• ✅优势：

1. Windows 原生工具，系统自带，无需额外软件
2. 自动处理安装、自动配置 PATH 环境变量
3. 后续升级只需要执行：winget upgrade Anthropic.ClaudeCode
4. 文件标准安装在系统程序目录，相比手动解压更加规范

---

核心横向对比表

方式	是否需要 Node.js	安装来源	PATH 自动配置	升级方式
方案 A npm 安装	✅必须	npm 海外源	自动	npm update -g
方案 B 官方 ps1 脚本	❌不需要	Anthropic 官网脚本	大概率自动，网络容易失败	需要重新下载新版本覆盖
方案 C WinGet	❌不需要	微软官方仓库	✅全自动	一条命令winget upgrade

补充：VS Code 插件版本安装（编辑器内直接使用）

如果你习惯在 VS Code 里写代码，可以直接安装官方插件，和编辑器深度联动：

1. 打开 VS Code，按快捷键 Ctrl + Shift + X 打开扩展面板
2. 搜索 Claude Code，找到发布者为 Anthropic 的官方插件
3. 点击「Install」完成安装
4. 安装后左侧边栏会出现 Claude Code 入口，按提示完成密钥配置即可使用。

插件是在侧边栏或者文件内使用，无法在VS code的终端内使用