自学教程 学编程从这里开始

Win PowerShell 安装 Claude Code 失败

现象

  1. irm https://claude.ai/install.ps1 | iex 报错:System.Xml.XmlDocument 找不到命令

原因:访问 claude.ai/install.ps1 返回的不是PowerShell脚本,而是网页HTML,管道把网页内容当成代码执行,触发报错。国内网络直连被拦截,这个一键安装命令不可用。

  1. winget install Anthropic.ClaudeCode 报错:0x80072efd InternetOpenUrl() failed

原因:winget能检索到包信息,但下载二进制文件需要访问 downloads.claude.ai,国内直连失败。winget本身不读PowerShell代理,需要系统全局代理才生效。


✅ 推荐方案:手动部署 Claude Code(Windows,无需winget/在线脚本)

1. 下载 claude.exe(版本2.1.292,和winget检索到的版本一致)

官方直链:

https://downloads.claude.ai/claude-code-releases/2.1.292/win32-x64/claude.exe
  • 用浏览器打开链接下载(浏览器网络独立于PowerShell)
  • 如果链接打不开,去GitHub Releases下载压缩包:
    https://github.com/anthropics/claude-code/releases → 找到v2.1.292 → 下载 claude-code-windows-x64.zip,解压得到claude.exe

2. 配置环境变量(添加到PATH)

  1. 在D盘新建目录,例:D:\Tools\ClaudeCode,把claude.exe放入
  2. 此电脑右键 → 属性 → 高级系统设置 → 环境变量
  3. 用户变量 → Path → 编辑 → 新增:D:\Tools\ClaudeCode → 保存全部窗口

3. 验证安装

关闭所有旧终端,新开PowerShell

claude --version

正常输出示例:2.1.292 (Claude Code)

可选校验文件签名(确认文件未篡改)

Get-AuthenticodeSignature D:\Tools\ClaudeCode\claude.exe

签名发行者应为:Anthropic, PBC

4. 登录使用

claude

会唤起浏览器,支持两种登录方式:

  • Claude Pro / Max 账号登录
  • API Key 按流量计费

5. 更新方法

下载新版claude.exe,直接覆盖旧文件即可。


📌 备选:代理方式使用winget(需要系统全局代理)

winget底层使用WinINet,不会读取PowerShell内设置的代理,必须开启系统全局代理后,再执行:

winget install Anthropic.ClaudeCode

⚠️ 重要注意事项

  1. 修改PATH环境变量必须重启终端,旧终端不会加载新路径;
  2. 不建议放到C:\Windows\System32,容易触发Windows Defender误报;
  3. 放弃 irm https://claude.ai/install.ps1 | iex 这条一键安装命令,国内直连环境无法使用。
标签:

0 条笔记