Codex Manual
下载与安装
先安装 CLI,再按需打开 App 或编辑器扩展,是最稳妥的入门路线。
macOS
安装 CLI:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex也可以使用 Homebrew:
brew install --cask codex
codex打开桌面 App:
codex app也可以访问官方 Codex App 页面:https://chatgpt.com/codex?app-landing-page=true
桌面 App 提供 macOS、Windows 和 Linux 版本,与 CLI、IDE 扩展共用同一份 config.toml。
Windows 原生
如果你主要使用 Windows、PowerShell、VS Code,并且项目在 Windows 磁盘中,优先用原生方式:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
codex打开桌面 App:
codex appWindows 原生方式使用 Windows 沙箱,不需要 WSL 或虚拟机。官方建议使用 Windows 11;较新的 Windows 10(1809 及以上)为尽力支持。
建议先准备常见开发工具:
winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3
winget install --id GitHub.cliWindows + WSL2
如果你的项目依赖 Linux 工具链,或者你本来就在 WSL 里开发,先安装 WSL2:
wsl --install
wsl进入 WSL 后安装 Codex:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex推荐把项目放在 WSL 的 Linux home 目录中:
mkdir -p ~/code
cd ~/codeLinux
Linux 用户直接安装 CLI:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex也可以通过 npm 安装:
npm install -g @openai/codex
codex升级
用哪种方式安装,就用哪种方式升级:重新运行官方安装命令,或再次运行 npm install -g @openai/codex@latest。
检查安装
运行:
codex --version
codex如果 codex 能进入交互界面,说明 CLI 已可用。之后你可以继续配置登录方式、模型和权限策略。