技能管理 · 收录于 2026-08-29 · 适用 1 工具 ✓ 实测验证

/plugin install 报 fatal: Failed to connect to github.com port 443

已验证 2026-08-29/plugin install 连不上 github 443——先 curl -sI codeload 探路(实测 1.7~1.9s),可达就走 tarball 直装,或给 git 显式配代理。

快速修复

# 一键:先探路——codeload 可达就走 tarball 直装(实测 1.7~1.9s)
curl -sI https://codeload.github.com/obra/superpowers/tar.gz/refs/tags/v6.3.0

探测通过后按「一步步来」第 2 步 tarball 安装;或给 git 显式配代理重试。

你会遇到什么

Claude Code 里执行 /plugin install superpowers@claude-plugins-official 或 @superpowers-marketplace,报 fatal: unable to access 'https://github.com/obra/superpowers.git/': Failed to connect to github.com port 443 after 2045 ms。

应用内配了全局代理也不通——未开 TUN 时 git 子进程不走代理。

本文路径:快速修复(30 秒一段命令)→ 一步步排查(可跳读)→ 原理与变体(症状/原因/证据)。赶时间直接跳到「快速修复」。

为什么会这样

上游 Claude Code 插件市场的安装路径 = git clone GitHub 仓库(市场网站不提供 zip 下载);国内网络直连 github.com:443 不稳定/被阻断;应用级代理不覆盖 git 子进程(除非 TUN/透明代理或给 git 显式配代理)。

通道状态(实测)
codeload tarball✅ 可达,1.7~1.9s
github.com:443 直连❌ 不稳定/被阻断
raw.githubusercontent.com❌ 超时(非安装路径,避免使用)
gh-proxy 加速✅ 实测可用(7.8s)

安装流程的本质是“CLI 程序调用 git 子进程”:/plugin install 时 CLI 自己执行 git clone,下载不是由 CLI 的网络栈完成,而是由它 fork 出的 git 子进程完成。

应用级代理(App 设置里的代理开关)只作用于应用自己的网络栈(HTTP 客户端走的代理),git 子进程是独立的程序,有自己的配置(~/.gitconfig 的 http.proxy 等)——除非代理是 TUN/透明模式(接管整个系统的网络流量),否则 git 子进程根本不知道有代理这回事,仍然直连。

这就是“开了代理还是失败”的机制原因。三个对策对应三个层面:给 git 显式配代理(git config --global http.proxy ...,让子进程走代理);换通道(codeload tarball 直连可达,用 curl 下载压缩包——curl 由 CLI 自己执行,应用级代理也生效);gh-proxy 加速(内容层面替换域名)。

判断路径固定:先看“卡在哪个环节”(clone = git 子进程直连),再选对应层面的对策。

一步步来

1. 先探路再选路 — 必做

curl -sI https://codeload.github.com/obra/superpowers/tar.gz/refs/tags/v6.3.0

codeload 可达就走 tarball 直装(本环境 1.7~1.9s)。

2. tarball 直装(实测 PASS) — 必做

curl -sL https://codeload.github.com/obra/superpowers/tar.gz/refs/tags/v6.3.0 | tar xz

实测:codeload tarball 544K / 2.1s → 安装 PASS。

3. 给 git 显式配代理后重试 — 必做

git config --global http.proxy http://127.0.0.1:<端口>

或开 TUN/透明代理。

4. 加速通道 — 必做

gh-proxy 类加速(2026-08-28 实测可用,7.8s),或用国内镜像站下载 zip 后离线安装;再不行按本地路径方式接入(见症状 6 条目)。

怎么确认修好了

安装流程走完(实测形态):

curl 探路 codeload → HTTP 200
tarball 解压后插件目录结构完整 → 安装 PASS

其它环境的表现

环境说明
应用全局代理不覆盖 git 子进程,未开 TUN 时不生效(CSDN 案例)
显式 git 代理git config --global http.proxy 后重试
gh-proxy实测 7.8s 可用
codeload实测 544K / 2.1s 稳定
离线兜底本地路径方式接入(见症状 6 条目)

症状

Claude Code 中执行 /plugin install superpowers@claude-plugins-official 或 @superpowers-marketplace 报:

fatal: unable to access 'https://github.com/obra/superpowers.git/': Failed to connect to github.com port 443 after 2045 ms

应用内配了全局代理也不通(未开 TUN 时 git 子进程不走代理)。

原因

上游 Claude Code 插件市场的安装路径 = git clone GitHub 仓库(市场网站不提供 zip 下载);国内网络直连 github.com:443 不稳定/被阻断;应用级代理不覆盖 git 子进程(除非 TUN/透明代理或给 git 显式配代理)。

解法

  1. 先探路再选路:curl -sI https://codeload.github.com/obra/superpowers/tar.gz/refs/tags/v6.3.0——codeload 可达就走 tarball 直装(命令见「本市场实测」一节,本环境 1.7~1.9s)。
  2. 给 git 显式配代理后重试:git config --global http.proxy http://127.0.0.1:<端口>;或开 TUN/透明代理。
  3. 走加速:gh-proxy 类加速(2026-08-28 实测可用,7.8s),或用国内镜像站下载 zip 后离线安装(见症状 2)。
  4. 离线兜底:按「症状 6」的本地路径方式接入。
验证证据
  • 网页案例:CSDN m0_58528895/161265224(2026-05)——443 案例全文:@claude-plugins-official / @superpowers-marketplace 均失败,全局代理不通、未试 TUN。
  • 本市场实测 2026-08-28:GitHub 源码下载 200 / 1.91s(站内文档;2026-08-27 基线 1.73s);raw.githubusercontent.com 超时(非安装路径,避免使用)。
  • 本市场实测安装:codeload tarball 544K / 2.1s → PASS(实测记录(本地留存))。

适用工具 (1)

本问题方案已挂到下列工具的方案页——从工具页也能回到这里,双向可达。

superpowers

来源与证据

收录 验证 ✓ 实测验证适用 1 工具
方案含本地实测或来源可复核的解法;未实测项已在文中如实标注。

← 技能管理 问题域 | 问题货架 | 遇到其它问题?去 问题空间 提交求助卡