docker的异度空间

一、背景

本文记录了在 Windows 10/11 + PowerShell 7 环境下，安装 Claude CLI（Claude Code）并确保其通过本地 v2ray 代理（端口 10808）顺利访问网络的全过程。
目标是：

完整安装 Claude CLI。
配置 PowerShell 代理环境，解决下载卡住问题。
配置 PATH 与便捷命令，提高 CLI 可用性。
确保后续 CLI 使用和下载不会受代理限制影响。

二、安装前问题排查

在最初尝试直接执行安装脚本时：

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

出现如下现象：

Setting up Claude Code...
Installing Claude Code native build latest...

过程长时间无响应或“卡住”。
退出后再次执行仍然卡住。
网络已经可用，浏览器可访问，但 PowerShell 下载仍不成功。

经过分析，问题核心是：

PowerShell 内置的 HTTP(S) 下载器默认 不继承本地代理（v2ray SOCKS5/HTTP），导致脚本无法下载 native build。

三、解决方案

1. 配置 PowerShell 代理环境

v2ray 本地代理端口为 10808，在 PowerShell 中设置 HTTP/HTTPS 代理：

$env:HTTP_PROXY  = "http://127.0.0.1:10808"
$env:HTTPS_PROXY = "http://127.0.0.1:10808"
$env:NO_PROXY    = "localhost,127.0.0.1"

⚠ 注意：
如果本地端口是 SOCKS5，需要先通过 v2ray 或 clash 等工具转成 HTTP 代理，因为 PowerShell 不原生支持 SOCKS5。
以上变量仅在当前会话生效，后续可通过 $PROFILE 固化。

2. 重新执行安装脚本

配置代理后，执行：

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

成功输出示例：

✔ Claude Code successfully installed!
Version: 2.1.17
Location: C:\Users\xxx\.local\bin\claude.exe

Next: Run claude --help to get started
⚠ Setup notes:
  • Native installation exists but C:\Users\xxx\.local\bin is not in your PATH. Add it...

3. 配置 PATH

安装后默认路径为：

C:\Users\xxx\.local\bin

临时验证：

$env:PATH = "$env:USERPROFILE\.local\bin;$env:PATH"
claude --version

永久配置（推荐）：

在 PowerShell Profile 中添加路径和代理变量：

notepad $PROFILE

如果 $PROFILE 不存在，需要先创建：

New-Item -ItemType Directory -Force (Split-Path $PROFILE)
New-Item -ItemType File -Force $PROFILE

在打开的文件中添加：

# 代理设置
$env:HTTP_PROXY  = "http://127.0.0.1:10808"
$env:HTTPS_PROXY = "http://127.0.0.1:10808"
$env:NO_PROXY    = "localhost,127.0.0.1"

# Claude CLI 路径
$claudeBin = "$env:USERPROFILE\.local\bin"
if (Test-Path $claudeBin) {
    if (-not ($env:PATH -split ";" | Where-Object { $_ -eq $claudeBin })) {
        $env:PATH = "$claudeBin;$env:PATH"
    }
}

# Claude 快捷函数
function ca {
    param(
        [Parameter(ValueFromRemainingArguments = $true)]
        [string[]]$Args
    )
    claude ask ($Args -join " ")
}

Write-Host "✔ PowerShell ready | Proxy: 127.0.0.1:10808 | Claude: OK" -ForegroundColor Green

保存文件，关闭 PowerShell 并重新打开。

4. 验证安装

claude --version

ca 测试 Claude CLI 代理是否可用

输出版本号，说明 CLI 正常安装。
通过 ca 命令可测试网络访问是否正常，代理生效。

四、可选优化

快捷函数 ca：在 PowerShell 中用 ca <问题> 快速调用 Claude，类似“工程助手”。
固化代理：将 $env:HTTP_PROXY 和 $env:HTTPS_PROXY 添加到 $PROFILE，永久生效。
CLI 使用习惯：
- 初次登录可能需要 claude auth login。
- 通过 claude whoami 验证授权。

五、总结经验

PowerShell 不会自动继承本地代理（尤其是 SOCKS5），需要手动设置环境变量。
install.ps1 下载 native build 卡住，大概率是代理未生效。
PATH 设置与快捷函数可极大提高 CLI 使用体验。
通过 profile 文件固化设置后，未来所有 CLI 安装/下载脚本都会顺利走代理，无需重复配置。
代理 + PATH + 快捷函数 = Claude CLI 可用性最佳实践。

六、最终效果

Claude CLI 安装完成，版本 2.1.17。
PowerShell 代理正确走本地 v2ray 10808。
CLI 可在任何 PowerShell 会话中直接使用。
用户可通过 claude 或 ca 命令快速访问 Claude，支持中文及命令行操作。

技术记录：在 Windows PowerShell 7 中安装 Claude CLI 并配置本地代理