适用：国内无代理环境，不使用npm、不执行官方irm安装脚本，关闭自动更新，纯二进制绿色部署
cmd查看USERPROFILE路径：echo %USERPROFILE%
二进制路径：%USERPROFILE%\.local\bin\claude.exe
配置目录：%USERPROFILE%\.claude（目录名称为程序硬编码，不可修改）
国内加速镜像为社区第三方公益服务，非官方；仅用于下载公开二进制，切勿上传隐私数据。

首次安装步骤

1. 创建两个本地文件夹

• C:\Users\你的用户名\.local\bin
• C:\Users\你的用户名\.claude

2. 创建配置文件 C:\Users\你的用户名\.claude\settings.json

⚠️ 关闭文件管理器「隐藏已知文件扩展名」，确保文件名不是 settings.json.txt

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

可选：可以将 ANTHROPIC_AUTH_TOKEN API Key写入env配置项，迁移直接复制配置文件即可。

3. 添加用户PATH环境变量

• Win+R 输入 sysdm.cpl → 高级 → 环境变量
• 在用户变量找到 Path → 编辑 → 新增一行：

%USERPROFILE%\.local\bin

保存全部窗口。

4. 获取 claude.exe
   优先顺序：
   ① 官方GitHub(https://github.com/anthropics/claude-code/releases/latest)下载： claude‑win32‑x64.zip
   ② 备用地址：https://github.com/ProjectAILeap/claude-code-releases/releases

解压压缩包，取出 claude.exe，拷贝到路径：
C:\Users\你的用户名\.local\bin\claude.exe

5. 完全关闭所有PowerShell、VSCode，新开PowerShell验证安装

Get-Command claude | Format-List Source
claude --version

✅ 预期正确输出：Source : C:\Users\xxx\.local\bin\claude.exe

VSCode Claude Code插件会自动读取系统PATH识别exe，无需额外配置。

🔄 版本升级操作（新/老电脑通用）

1. 关闭VSCode，终止全部claude进程

Get-Process claude -ErrorAction SilentlyContinue | Stop-Process -Force

2. 获取最新版 claude‑win32‑x64.zip
   优先官方Release，网络不佳使用国内备用加速链接下载。
3. 解压得到新版 claude.exe，直接覆盖旧文件：
   C:\Users\xxx\.local\bin\claude.exe
4. 新开PowerShell校验版本

claude --version

📦 换电脑迁移备份清单

仅需要备份2份资料：

1. 完整文件夹：%USERPROFILE%\.claude（包含settings.json、API密钥、会话缓存）
2. 最新版本的 claude.exe

新电脑恢复：

1. 将 .claude 复制到用户根目录
2. 将 claude.exe 复制到 .local\bin
3. 手动添加PATH环境变量 %USERPROFILE%\.local\bin

⚠️ 重要避坑事项

1. 修改PATH环境变量后，所有终端、VSCode必须完全重启，否则无法识别claude命令。
2. 本机无代理软件，禁止设置 HTTP_PROXY / HTTPS_PROXY 用户环境变量，否则各类工具报连接拒绝。
3. 不要执行 irm https://claude.ai/install.ps1 | iex，国内裸网二进制下载会超时失败。
4. DISABLE_AUTOUPDATER:"1"：仅关闭后台定时更新；claude update 命令依然存在，国内裸网无法执行，直接忽略。
5. 升级前必须关闭VSCode，插件会占用锁住 claude.exe，导致文件覆盖失败。
6. 第三方国内加速镜像仅用于下载公开Release，不要上传任何隐私、密钥信息。

🛠️ 故障排查命令

# 查看claude实际调用程序路径
Get-Command claude | Format-List Source

# 检查是否残留代理环境变量
Get-ChildItem Env: | Where-Object {$_.Name -like "*PROXY*"}

# 强制终止所有claude进程
Get-Process claude -ErrorAction SilentlyContinue | Stop-Process -Force