一、 核心前置准备

1. 系统要求：Windows 10 (1809 版本) 或更高。（需要魔法）
2. 环境要求：官方强烈建议提前安装 Git for Windows，因为 Claude Code 依赖 Bash 环境来读取和理解你的项目代码变更。

---

二、 官方标准安装流程

这是 Anthropic 目前最推荐的安装方式（Native Install），支持后台自动更新。

第 1 步：为 PowerShell 配置全局代理 为了避免再次出现“收到意外的 EOF”或下载到错误的 HTML 拒绝访问页面，请先打开 PowerShell，设置临时环境变量。请将 7890 替换为你实际代理软件的本地端口：

PowerShell

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

**通过 Windows 系统代理设置查看自己的端口

如果你的代理软件已经成功接管了系统流量（开启了“系统代理”功能），Windows 会记录这个端口：

1. 按下快捷键 Win + I 打开 Windows 设置。
2. 进入 “网络和 Internet” -> “代理” (Proxy)。
3. 找到 “手动设置代理” 部分。
4. 如果它是开启状态（或者点击“编辑”进去看），你会看到地址（通常是 127.0.0.1）以及后面的端口号（例如 7890）。

第 2 步：运行一键安装脚本 在同一个 PowerShell 窗口中，执行官方命令：（windows+R输入 PowerShell-->确定）

PowerShell

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

如果你看到屏幕滚动并最终显示 “Claude Code successfully installed!”，说明底层二进制文件已成功拉取。

第 3 步：重启终端并登录

• 关闭当前的 PowerShell 窗口，然后再重新打开一个新的 PowerShell 窗口（这样可以让系统加载最新写入的环境变量）。
• 在你的任意代码项目文件夹下，输入启动命令： PowerShell

  claude
  

• 系统会自动弹出浏览器窗口，按照提示完成账号授权登录即可开始使用。
  如果终端无法识别，或者时在安装后出现黄色警告，像下面的

‼ Setup notes:

  ● Native installation exists but C:\路径 is not in your PATH. Add it by opening: System

    Properties → Environment Variables → Edit User PATH → New → Add the path above. Then restart your terminal.

图形化界面配置方法（推荐）：

1. 按下键盘上的 Win 键，直接搜索 “环境变量”（或者搜索“Edit the system environment variables”）。
2. 在弹出的“系统属性”窗口中，点击右下角的 “环境变量...” (Environment Variables...) 按钮。
3. 在上方 “用户名的用户变量” 区域，找到名为 Path 的变量，选中它，然后点击 “编辑” (Edit)。
4. 在弹出的编辑窗口中，点击右侧的 “新建” (New)。
5. 将 C:\路径 复制并粘贴进去。
6. 一路点击 “确定” (OK)，关闭所有环境变量设置窗口。

**重启终端并验证

环境变量配置完成后，当前的 PowerShell 窗口是不会生效的。

1. 关闭你现在的 PowerShell 窗口。
2. 重新打开一个新的 PowerShell 或 cmd 窗口。
3. 输入以下命令来验证安装是否彻底成功：

PowerShell

claude --help

1. 拓展系统变量 vs 用户变量

它们的作用机制完全一样，唯一的区别在于生效的范围（权限）：

• 系统变量（System Variables）：
  • 范围： 针对这台电脑上的所有用户生效。
  • 比喻： 公司的“全局公告”。不论是前台、销售还是经理，所有员工都必须遵守的规则（例如：公司的主服务器 IP 地址是多少）。
  • 权限： 修改系统变量通常需要管理员权限（Administrator）。
  • 常见例子： ComSpec（指向系统的 cmd 运行路径）、OS（操作系统名称）。
• 用户变量（User Variables）：
  • 范围： 仅对当前登录的这个用户生效。如果电脑有其他账户登录，他们不受影响。
  • 比喻： 员工办公桌上的“个人备忘录”。比如员工 A 习惯把个人文件放在左边抽屉，这只对他自己有效。
  • 权限： 普通用户就可以修改自己的用户变量。
  • 常见例子： 很多针对个人安装的软件（如 Python、Node.js 或者某些命令行工具）会将路径写在用户变量里。

---

2. 环境变量有什么核心作用？

程序在运行时，会大量依赖这些变量来决定自己的行为。最典型的作用有以下几个：

作用一：快捷定位程序（最著名的 PATH 变量）

这是大家最常接触的环境变量。

• 没有 PATH 时： 如果你想在终端里运行某个程序，你必须输入它的完整绝对路径，比如：C:\Program Files\Java\jdk1.8.0\bin\java.exe。这非常麻烦。
• 有了 PATH 后： 你只要把 C:\Program Files\Java\jdk1.8.0\bin 这个目录添加到系统的 PATH 变量中。以后你只需在终端里输入 java，系统就会自动去 PATH 记录的这些目录里挨个寻找，找到了就直接运行。

作用二：统一配置运行环境

很多软件需要依赖特定的环境才能运行，环境变量充当了“向导”的角色。

• 比如 Java 开发常用的 JAVA_HOME 变量，它的值是 Java 的安装路径。Tomcat 等服务器软件启动时，就会去读 JAVA_HOME，从而知道该去哪里找 Java 运行环境。
• 又比如系统的 TEMP 或 TMP 变量，告诉所有软件：“如果你们运行中产生了垃圾临时文件，请统一扔到这个文件夹里，方便系统以后清理。”

作用三：控制网络和代理规则

命令行工具默认通常不走代理软件的流量。通过设置类似 HTTP_PROXY 和 HTTPS_PROXY 的环境变量，就是给当前环境贴上一个标签，告诉所有准备发起网络请求的程序：“请把数据发往 127.0.0.1:xxxx 这个端口，不要直接发出去。”