快速修复
# 一键:先探路——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 显式配代理)。
解法
- 先探路再选路:
curl -sI https://codeload.github.com/obra/superpowers/tar.gz/refs/tags/v6.3.0——codeload 可达就走 tarball 直装(命令见「本市场实测」一节,本环境 1.7~1.9s)。 - 给 git 显式配代理后重试:
git config --global http.proxy http://127.0.0.1:<端口>;或开 TUN/透明代理。 - 走加速:gh-proxy 类加速(2026-08-28 实测可用,7.8s),或用国内镜像站下载 zip 后离线安装(见症状 2)。
- 离线兜底:按「症状 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来源与证据
← 技能管理 问题域 | 问题货架 | 遇到其它问题?去 问题空间 提交求助卡