Kc's blog

Appearance

kc_shen2026-04-06
1136
5.3m

claude安装终端代理 ​

Claude Code 安装踩坑复盘（v2rayN / 代理协议不匹配） ​

结论先说 ​

这次安装卡死/失败的根因是：把 SOCKS5 端口当成 HTTP 代理端口配置了，导致 claude install 的网络请求走代理时出现 协议不匹配，表现为卡住或报错。

1) 现象 ​

执行安装时卡在类似输出不动：

  • Installing Claude Code native build latest...

或者直接失败：

  • The socket connection was closed unexpectedly
  • Failed to fetch version ... : protocol mismatch

2) 一开始为什么误判“网络问题” ​

  • 直接 curl 不走代理访问 storage.googleapis.com 是 OK 的（DNS/TLS/HTTP 都正常）。
  • 但 claude install 走了终端环境里的代理，而代理配置错了，所以只有它失败/卡住。

3) 关键证据：安装进程在连本机代理端口 ​

用 lsof 看到 claude install 在连：

  • localhost:10808

这说明它不是“卡下载源”，而是在通过 本地代理出网。

4) 根因：代理端口协议搞反了 ​

我的终端环境变量当时是：

bash
http_proxy=http://127.0.0.1:10808
https_proxy=http://127.0.0.1:10808
all_proxy=http://127.0.0.1:10808

但 10808 实际是 SOCKS5（不是 HTTP 代理）。

验证方式（能返回 HTTP/2 200 说明 10808 确实是 SOCKS5）：

bash
curl -Iv --socks5-hostname "127.0.0.1:10808" \
  "https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/latest"

因此：

  • claude install 把 http://127.0.0.1:10808 当 HTTP 代理用时，会出现 protocol mismatch 或 socket closed。

5) 解决：在 v2rayN 开启 HTTP 代理端口，并让安装走 HTTP 代理 ​

v2rayN 后来开启了 HTTP 代理端口（例如 10809），测试能看到：

  • HTTP/1.1 200 Connection established

说明 HTTP CONNECT 可用：

bash
curl -Iv -x "http://127.0.0.1:10809" --connect-timeout 5 --max-time 30 \
  "https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/latest"

然后让 claude install 用正确的 HTTP 代理端口（不要再指向 10808）：

bash
HTTP_PROXY="http://127.0.0.1:10809" HTTPS_PROXY="http://127.0.0.1:10809" \
http_proxy="http://127.0.0.1:10809" https_proxy="http://127.0.0.1:10809" \
/Users/kc/.claude/downloads/claude-2.1.92-darwin-x64 install --force

最终成功输出：

  • Claude Code successfully installed!
  • Location: ~/.local/bin/claude

6) 安装后顺手修的一个小问题（PATH） ​

安装完成后提示：

  • ~/.local/bin 不在 PATH

按提示加到 ~/.zshrc：

bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

验证：

bash
which claude
claude --version

7) 以后避免再踩坑的检查清单 ​

  • 先看代理变量（尤其别把 SOCKS 端口写成 http://...）：
bash
env | egrep -i 'https?_proxy|all_proxy|no_proxy'

  • 用 curl 验证端口协议：

    • SOCKS：curl --socks5-hostname 127.0.0.1:PORT https://...
    • HTTP：curl -x http://127.0.0.1:PORT https://...

  • 某些程序只支持 HTTP 代理：这时必须启用 HTTP 端口（如 10809），不要强行用 ALL_PROXY=socks5h://...。

8) 本机终端代理控制命令（v2rayN：SOCKS=10808，HTTP=10809） ​

8.1 一次性检查当前代理变量 ​

bash
env | egrep -i '^(http|https|all)_proxy=|^(HTTP|HTTPS|ALL)_PROXY=|^NO_PROXY=|^no_proxy='

8.2 临时对单条命令开启 SOCKS5（不污染当前 shell） ​

bash
env ALL_PROXY="socks5h://127.0.0.1:10808" all_proxy="socks5h://127.0.0.1:10808" \
  curl -sS https://ipinfo.io/ip

8.3 临时对单条命令开启 HTTP 代理（给只支持 HTTP proxy 的程序） ​

bash
env HTTP_PROXY="http://127.0.0.1:10809" HTTPS_PROXY="http://127.0.0.1:10809" \
    http_proxy="http://127.0.0.1:10809" https_proxy="http://127.0.0.1:10809" \
    ALL_PROXY="http://127.0.0.1:10809" all_proxy="http://127.0.0.1:10809" \
  curl -sS https://ipinfo.io/ip

8.4 常驻别名（写进 ~/.zshrc） ​

bash
# v2rayN ports
export PROXY_SOCKS_PORT=10808
export PROXY_HTTP_PORT=10809

# SOCKS5（默认更通用）
alias proxy_on='unset http_proxy https_proxy HTTP_PROXY HTTPS_PROXY; export ALL_PROXY="socks5h://127.0.0.1:${PROXY_SOCKS_PORT}"; export all_proxy="$ALL_PROXY"'

# HTTP（给只支持 HTTP proxy 的程序）
alias proxy_on_http='unset ALL_PROXY all_proxy; export http_proxy="http://127.0.0.1:${PROXY_HTTP_PORT}"; export https_proxy="$http_proxy"; export HTTP_PROXY="$http_proxy"; export HTTPS_PROXY="$http_proxy"; export ALL_PROXY="$http_proxy"; export all_proxy="$http_proxy"'

# 关闭代理
alias proxy_off='unset ALL_PROXY all_proxy http_proxy https_proxy HTTP_PROXY HTTPS_PROXY'

加载配置：

bash
source ~/.zshrc

8.5 验证是否真的走代理（看出口 IP） ​

bash
curl -sS https://ipinfo.io/ip

8.6 端口协议快速自检（避免把 SOCKS 端口写成 http_proxy） ​

  • SOCKS5 端口（10808）验证：
bash
curl -Iv --socks5-hostname "127.0.0.1:10808" --connect-timeout 5 --max-time 15 https://ipinfo.io/ip
  • HTTP 端口（10809）验证：
bash
curl -Iv -x "http://127.0.0.1:10809" --connect-timeout 5 --max-time 15 https://ipinfo.io/ip
bash
# 开启 SOCKS5 代理（推荐日常使用）
proxy_on

当前终端开始走 SOCKS5 代理。

bash
# 开启 HTTP 代理（部分工具专用）
proxy_on_http

当前终端开始走 HTTP 代理。

bash
# 关闭代理
proxy_off

关闭当前终端代理。

bash
# 查看当前终端是否开启代理
env | grep -Ei 'proxy'
  • 出现 ALL_PROXY/http_proxy → 已开启代理
  • 只有 PROXY_SOCKS_PORT → 未开启代理
bash
# 验证是否真正走代理
curl ipinfo.io
  • 返回代理地区 IP → 已走代理
  • 返回本地 IP → 未走代理
最近更新