外观
Codex 安装前的网络准备:包管理器走代理与下载失败处理
Codex 安装前的网络准备很重要:安装失败绝大多数是网络问题而不是安装命令错了。终端里的包管理器(如 npm)默认不走系统代理,下载海外资源会很慢或直接超时。安装前先让终端走代理:设置 HTTPS_PROXY 环境变量,或在客户端开 TUN 模式。
具体安装命令以官方文档为准,本文只讲网络准备。
速读要点
- 安装失败绝大多数是终端没走代理,不是命令错
- 环境变量只在当前终端窗口生效,sudo 要加 -E
- 安装阶段看带宽和稳定性,对地区没有登录阶段严格
Codex 安装前的网络准备:先检查三件事
- 客户端已连接且节点可用。 浏览器能打开海外网站。
- 知道客户端的本地端口。 Clash 系客户端默认通常是 7890,以客户端设置页显示为准。
- 终端能走代理。 在终端里执行
curl -I https://registry.npmjs.org,几秒内返回状态码就是通的;卡住说明终端没走代理。
让包管理器走代理:环境变量或 TUN
在终端里执行,再在同一窗口运行安装命令:
bash
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890预期:之后的下载速度明显提升。想长期生效,写进 ~/.zshrc 或 ~/.bashrc。Windows PowerShell 用 $env:HTTPS_PROXY="http://127.0.0.1:7890"。
不想改环境变量的,在客户端里开 TUN 模式,所有程序流量自动走节点。两种方法选一种即可,详见TUN 与代理模式。
部分包管理器有自己的代理设置,环境变量不生效时查对应工具的 proxy 配置项。
核对点:终端里 curl -I https://registry.npmjs.org 几秒内返回 200 一类状态码,才算终端已走代理。
三种环境的走代理分支
| 环境 | 做法 | 注意 |
|---|---|---|
| 本机终端(macOS、Linux、PowerShell) | export HTTPS_PROXY / $env:HTTPS_PROXY | 新窗口要重新设置 |
| 包管理器自带代理配置 | npm config set proxy、pip 的 proxy 参数等 | 与环境变量二选一,别两边都设 |
| Docker 或远程开发容器 | 容器内 127.0.0.1 是容器自己,指向宿主地址 | 客户端开「允许局域网连接」 |
下载失败的 10 秒自检
| 现象 | 最可能原因 | 10 秒自检 |
|---|---|---|
| 下载进度条不动、最后超时 | 终端没走代理 | curl -I https://registry.npmjs.org 是否秒回 |
| 浏览器快、终端慢 | 同上 | echo $HTTPS_PROXY 是否有输出 |
| 下载到一半断掉 | 节点丢包或晚高峰 | 换专线节点或白天重试 |
| 提示证书错误 | 客户端开了 TLS 解密或自签证书 | 关掉相关选项 |
| sudo 安装失败、普通用户正常 | sudo 不继承变量 | 改用 sudo -E |
下载失败的排查顺序
- 确认环境变量在当前终端窗口已生效:
echo $HTTPS_PROXY有输出。 - 端口是否正确:和客户端设置页的混合端口或 HTTP 端口一致。
- 节点是否稳定:下载大包中途断掉,换一个晚高峰稳定的节点重试。
- 规则模式下资源域名是否走代理:临时切全局测试。
- 以上都对仍失败,换地区节点。部分资源 CDN 对某些地区的机房 IP 限速。
节点选择建议
- 安装阶段看带宽和稳定性,对地区没有登录那么严格,美国、日本、新加坡都可以。
- 下载大包时选专线或低丢包节点,避免中途断掉重来。
- 安装完成后登录和使用阶段再按网络环境的要求挑节点。
推荐机场
| 机场 | 付款方式 | 起价 | 入门流量 | 倍率 | 节点地区 | 线路 | AI | 流媒体 | 设备 | 适合谁 | 评测 | 优惠 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 光速云 | 年付 / 月付 / 季付 | 约 ¥7.5/月(年付折算) | 300 GB | 全节点 1.0x 结算,无隐藏高倍率 | 香港、台湾、新加坡、日本、美国 | IEPL / 专线 | 实测 5/5 | 实测 8/8 | 5 台 | 稳定优先、AI 用户、视频用户、性价比 | 评测 | 领优惠 |
| 微风网络 | 季付 / 年付 / 月付 | 约 ¥7/月(年付折算) | 450 GB | 日常节点 1.0x,纯净原生解锁节点 1.2x | 香港、台湾、新加坡、日本、美国 | IEPL / 专线 | 实测 5/5 | 实测 8/8 | 5 台 | 便宜优先、新手、AI 用户、视频用户 | 评测 | 领优惠 |
| 二猫云 | 月付 / 季付 / 年付 / 按量 | ¥20/月起 | 300 GB含不限时 | 标准节点 1.0x,冷门小众地区 1.2x | 香港、台湾、新加坡、日本、美国、马来西亚、英国、法国、德国、土耳其、泰国、巴西 | IEPL / 中转 | 实测 5/5 | 实测 8/8 | 5 台 | 性价比、AI 用户、视频用户 | 评测 | 领优惠 |
| 星岛梦 | 月付 / 季付 / 年付 / 按量 | 约 ¥8/月(年付折算) | 260 GB含不限时 | 常规节点 1.0x,专线节点 1.2x,大流量下载专用 0.5x | 香港、台湾、新加坡、日本、美国 | 专线 / IEPL | 实测 3/5 | 实测 6/8 | 5 台 | 便宜优先、新手 | 评测 | 领优惠 |
| 飞猫云 | 季付 / 年付 / 月付 | 约 ¥7/月(年付折算) | 500 GB | 主力 IEPL 专线 1.0x,直连备用 0.5x | 香港、台湾、新加坡、日本、美国、马来西亚、泰国、土耳其、法国、英国、德国、越南 | IEPL | 实测 3/5 | 实测 7/8 | 3 台 | 便宜优先、新手 | 评测 | 领优惠 |
起价标「年付折算」的是年付套餐折合的月均价,不是月付价。AI / 流媒体:实测 n/m 为站长实测结果(可用项数 / 测试项数,部分可用不计入可用),资料称支持 为品牌资料描述,未测试 为未纳入测试;可用性随平台策略变化,以最新复测为准。
常见问题
浏览器下载很快,终端很慢?
终端没走代理,设环境变量或开 TUN。
设了环境变量没变化?
新开的终端窗口不会继承上一个窗口的 export,要重新执行或写进配置文件。
用 sudo 安装时代理失效?
sudo 不继承环境变量,用 sudo -E 或在 root 下单独设置。
下一步
- 还没选机场,对照实测记录看一家品牌档案:二猫云机场档案
- 不想折腾环境变量,用 TUN 接管全部流量:Windows TUN 模式教程