Windows 系统 Claude Code 完整安装配置手册

一、安装概述

本文档记录 Windows PowerShell 环境下 Claude Code 终端工具的完整安装、报错修复、环境变量配置及初始化使用流程，适配官方一键安装脚本，解决国内网络连接报错、命令无法识别等问题。

最终安装版本：Claude Code 2.1.237

默认安装路径：C:\Users\Administrator\.local\bin\claude.exe

二、原始安装命令

官方一键安装脚本（PowerShell 执行）：

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

三、安装报错问题及解决方案

1. 核心报错：网络连接被拒绝

报错信息：

× Installation failed
Failed to fetch version from https://downloads.claude.ai/claude-code-releases/latest after 3 attempt(s): connect
ECONNREFUSED 35.190.46.17:443

报错原因：国内网络无法直连 Claude 官方服务器，HTTPS 连接被拒绝，非脚本损坏问题。

关键说明：官方提示的 --force 参数仅用于跳过校验，无法解决网络连接问题，网络不通时强制安装依旧失败。

2. 网络问题修复方案（必做）

Windows PowerShell 默认不读取系统代理，需手动配置终端代理（替换为你的本地代理端口，默认7890）：

# 配置终端代理
$proxyAddr = "http://127.0.0.1:7890"
$env:HTTP_PROXY = $proxyAddr
$env:HTTPS_PROXY = $proxyAddr
[Net.HttpWebRequest]::DefaultWebProxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials

# 重新执行安装命令
irm https://claude.ai/install.ps1 | iex

四、安装成功后环境变量配置（关键）

1. 安装成功提示

√ Claude Code successfully installed!
  Version: 2.1.237
  Location: C:\Users\Administrator\.local\bin\claude.exe
‼ Setup notes:
  ●Native installation exists but C:\Users\Administrator\.local\bin is not in your PATH.

问题根源：安装路径未加入系统 PATH，直接执行 claude 会提示命令不存在。

2. 临时生效方案（当前终端）

仅当前 PowerShell 窗口可用，重启终端失效，适合临时测试：

$env:PATH += ";C:\Users\Administrator\.local\bin"
# 验证命令
claude --help

3. 永久配置方案（推荐）

1. Win + R 输入 sysdm.cpl 回车，打开系统属性；

2. 切换至【高级】选项卡，点击右下角【环境变量】；

3. 在上方用户变量列表中，找到 Path 变量并双击编辑；

4. 点击【新建】，粘贴路径：C:\Users\Administrator\.local\bin；

5. 依次点击确定保存所有窗口，完全关闭并重启终端生效。

五、安装验证

重启 PowerShell 后，执行以下命令验证是否配置成功：

# 查看版本
claude --version

# 查看帮助文档
claude --help

# 启动交互式使用
claude

输出版本号 2.1.237 即代表安装、配置全部完成。

六、后续使用必备配置

国内网络环境下，每次新开终端使用 Claude Code 需先配置代理，否则接口调用报错：

# 终端临时代理配置
$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

七、环境清理命令

使用完成后，可清空终端代理环境变量：

Remove-Item Env:HTTP_PROXY
Remove-Item Env:HTTPS_PROXY

八、离线安装备选方案

1. 浏览器配置代理，访问：https://downloads.claude.ai/claude-code-releases/latest；

2. 获取最新版本，手动下载 Windows 端压缩包；

3. 解压至 %LOCALAPPDATA%\Programs\Claude Code；

4. 手动将程序路径添加至系统 PATH 环境变量即可。

(Note: May contain AI-generated content.)