Mac安装Codex卡顿需先换Homebrew和npm国内源:中科大镜像装Homebrew,npmmirror.com配npm registry,再执行npm install -g @openai/codex。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Mac终端安装Codex时卡在npm install -g @openai/codex,进度条纹丝不动,甚至报错curl: (56) Recv failure或ETIMEDOUT,根本不是你网络差,而是Homebrew和npm默认走境外源,国内直连GitHub和registry.npmjs.org基本不可用——必须分两步换源:先让Homebrew装得快,再让npm装得稳。
先让Homebrew飞起来
这一步不搞定,后面所有依赖都卡死。Homebrew本身要从GitHub拉brew本体和homebrew-core配方库,国内直连极大概率超时失败。
方法一:中科大镜像一键安装(推荐,M1/M2/M3芯片必选)
打开终端,一次性粘贴执行以下四行命令:
export HOMEBREW_INSTALL_FROM_API=1
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
然后运行安装脚本:
/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/misc/brew-install.sh)"
等待出现【==> Installation successful!】提示即成功。若卡在Cloning into '/usr/local/Homebrew/Library/Taps/homebrew/homebrew-core'…,说明core仓库没换源,需手动补救。
方法二:Intel Mac用户可跳过环境变量设置,直接用清华镜像安装
执行:
/bin/bash -c "$(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.sh)"
安装完成后,立即验证:
brew --version
输出Homebrew 4.x.x即为正常。若报command not found,请检查PATH是否生效——M1/M2/M3用户必须执行:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc && source ~/.zshrc
强制homebrew-core走国内镜像
很多教程漏掉这步,导致brew install node后npm仍慢如蜗牛。因为node依赖的Formula来自homebrew-core,它默认还是走GitHub。
第一步:进入brew仓库目录
cd $(brew --repo)
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
第二步:把brew本体源换成中科大
git remote set-url origin https://mirrors.ustc.edu.cn/brew.git
第三步:进入core仓库并换源
cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"
git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
第四步:强制更新索引
brew update
这一步耗时较长但必须完成,否则后续所有brew install都会fallback到慢速源。看到Updating Homebrew… → Fetching origin后不再卡住,就说明换源成功。
npm全局安装Codex提速方案
Node.js装好后,npm默认registry是https://registry.npmjs.org,国内访问同样龟速。不换源直接npm install -g @openai/codex,十次有九次失败。
方法1:临时指定镜像安装(适合只装一次)
npm install -g @openai/codex --registry=https://registry.npmmirror.com
方法2:永久配置npm镜像(推荐,一劳永逸)
npm config set registry https://registry.npmmirror.com
npm config get registry # 验证是否生效,应返回https://registry.npmmirror.com
【注意:不要用cnpm代替npm】 Codex CLI依赖特定npm生命周期钩子,cnpm兼容性差,会导致codex命令无法识别。
方法3:如果已装过但失败,先彻底清理再重装
npm uninstall -g @openai/codex
npm cache clean --force
最后验证安装结果:
codex --version
输出类似codex v1.2.0即表示安装完成,可直接使用。

















