● 安装指南

Mac 安装 Codex 指南

在 macOS 上安装 OpenAI Codex CLI 的完整步骤教程

💻
适用环境
  • macOS 12 (Monterey) 及以上
  • Apple Silicon (M1 / M2 / M3 / M4) 或 Intel x86_64
  • 终端: Terminal.app 或 iTerm2

一、安装前置依赖

1

安装 Node.js(建议 LTS 版本)

Codex CLI 通过 npm 分发,需要 Node.js 18 或以上。

最简单的方式是直接去 Node.js 官网下载安装包:

https://nodejs.org/zh-cn

下载 LTS 版本的 macOS 安装包,双击安装并一路继续即可。

如果你已经装了 Homebrew,也可以用它安装 Node.js:

brew install node
✅ 验证: 执行下面两条命令,都能输出版本号即成功 
node -v
npm -v

二、安装 Codex CLI

2

通过 npm 全局安装官方包

npm install -g @openai/codex

验证安装是否成功:

codex --version
which codex
💡 常见安装位置
  • Apple Silicon: /opt/homebrew/bin/codex
  • Intel Mac: /usr/local/bin/codex
  • 自定义 npm prefix: $(npm config get prefix)/bin/codex
3

命令找不到时的修复

如果执行 codex --version 提示 command not found,把 npm 的 bin 目录加入 PATH:

echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

然后重新执行 codex --version 验证。

三、验证可用

4

生成你的专属启动脚本

在下面输入你的下游 Key(以 lbk_ 开头),点击 下载启动脚本,会生成一份内置你 Key 的 new_codex.sh。

💡 Key 只在你浏览器本地拼接进脚本,不会上传到任何服务器。
5

运行启动脚本

下载得到 new_codex.sh 后,打开终端进入下载目录(一般是 ~/Downloads):

cd ~/Downloads
💡 也可以先把 new_codex.sh 拷贝到自己的项目目录,后续直接在项目里 ./new_codex.sh 启动。

给脚本加可执行权限:

chmod +x new_codex.sh

启动 Codex:

./new_codex.sh
⚠️ 第一次运行如果 macOS 提示"无法验证开发者",到 系统设置 → 隐私与安全性 里点击"仍要打开"。

进入 TUI 后,输入一句话测试:

你好,你是谁?
✅ 模型正常返回回答即代表接入成功

四、常见问题

1. codex: command not found
  • 确认 npm install -g @openai/codex 没报错。
  • 检查 npm config get prefix 输出的目录下 bin/codex 是否存在。
  • 把该 bin 目录加到 PATH,重新打开终端。
2. 远程网关不可达
  • 检查能否访问 https://aitoolproxygateway.liuwanqin.com/health。
  • 如果用 Clash / V2Ray 等代理,需要把这个域名加入直连规则,或者临时关闭代理。
  • 公司网络可能拦截 80 端口,换网络再试。
3. 当前不是交互式终端,Codex TUI 无法启动
  • 不要用 ./codex-demo75.sh < /dev/null 之类的方式启动。
  • 直接在 Terminal.app / iTerm2 里运行脚本即可。
4. auth.json 一直被改回旧值
  • demo75 脚本每次启动都会覆盖 ~/.codex/auth.json。
  • 如果你同时用官方 Codex 登录态,建议另起一份 profile,或者只在需要时跑脚本。
5. 模型 gpt-5.4 不识别
  • 这个模型名由上游代理站定义,不是官方 OpenAI 公开模型。
  • 如需切换模型,改 codex-demo75.sh 里 DEMO75_MODEL,或在 -c 'model="..."' 里指定。
6. 想退出 / 切回官方 Codex
  • 删除 ~/.codex/auth.json,然后 codex login 重新走官方登录。
  • 或者直接编辑 ~/.codex/auth.json 把 OPENAI_API_KEY 换回官方 sk-xxx。

五、卸载

6

卸载 Codex CLI

npm uninstall -g @openai/codex
rm -rf ~/.codex

如果不再使用 Node.js,可一并卸载:

brew uninstall node

六、在桌面客户端使用 Codex

7

下载并打开 Codex 桌面客户端

访问官方页面,下载并安装 macOS 客户端:

👉 https://openai.com/zh-Hans-CN/codex/

装完直接打开就能用 —— 不用登录、不用改任何设置。

✅ 打开客户端,直接发一句话,有回答就说明接入成功。
8

Key 过期 / 换新 key 时怎么办

当下游 Key 过期或代理地址变化时,不需要手动改环境变量或客户端设置,流程就两步:

  1. 到原页面输入新 Key,重新下载 new_codex.sh 覆盖旧文件。
  2. 跑一次 ./new_codex.sh。
⚠️ 桌面客户端如果已经在运行,新 key 生效前请退出客户端再重新打开(右键 Dock 图标 → 退出)。
✅ 这样客户端和终端永远共用同一份配置,密钥更新一键搞定。

七、联系我们

有问题?联系管理员

扫码加我微信,有任何使用上的疑问都可以问。

管理员微信二维码

扫一扫上面的二维码图案,加我为朋友