Mac 安装 Codex - 一条命令搞定
Mac 安装 Codex - 一条命令搞定
Mac 是 Codex 支持得最好的平台: 原生沙箱(Seatbelt)开箱即用, 安装 Codex 只需要一条命令. 这篇是 Codex 安装教程的 Mac 篇, Windows 用户请看 Windows 篇(WSL 方式).
安装方式一: Homebrew(推荐)
brew install codex
codex --version
- 没装 Homebrew 的先装: 官网 brew.sh 首页那条
/bin/bash -c "$(curl ...)"命令. - 升级:
brew upgrade codex.
安装方式二: npm
习惯 Node 生态的话:
npm install -g @openai/codex
- 需要较新的 Node LTS(建议 20+), 推荐 nvm 管理.
- 两种方式二选一即可, 不要都装(容易 PATH 里出现两个版本).
登录与首次运行
进入项目目录运行:
codex
- 首次运行选 Sign in with ChatGPT, 浏览器自动弹出授权页, 用 ChatGPT 付费账号(Plus/Pro/Team 等)登录即可.
- 或者用 API Key:
export OPENAI_API_KEY=...写进~/.zshrc. - 配置文件在
~/.codex/config.toml(模型, 审批策略等, 默认值以官方文档为准).
Apple Silicon 与 Intel
- M 系列芯片和 Intel 芯片都有官方构建, brew 会自动匹配, 无需关心架构.
- 首次在某个目录运行时 macOS 可能弹权限确认(访问文件夹/钥匙串), 允许即可.
常见问题
codex: command not found: 重开终端; brew 安装的确认/opt/homebrew/bin(Apple Silicon)在 PATH 里.- 公司网络/国内网络: 登录和对话需要能访问 OpenAI, 终端里
export https_proxy=http://127.0.0.1:端口走本机代理; 客户端选型见网络代理客户端怎么选. - 卸载:
brew uninstall codex或npm uninstall -g @openai/codex, 配置目录~/.codex/需手动删.