安装与登录
安装 Codex CLI(可选)
想在终端里用 Codex 时再看:在 macOS、Linux 和 Windows 上安装 Codex CLI,包括官方安装脚本、npm、Homebrew 和 WSL2 的用法,以及升级方法。
大多数人不需要 CLI
日常使用推荐直接用 ChatGPT 桌面应用。CLI 适合习惯终端、需要写脚本或接入 CI、在远程服务器上工作的开发者,并且至少需要 Plus 套餐。CLI 仍由官方持续维护。
Codex CLI 是一个独立的命令行程序(用 Rust 编写),官方提供好几种安装方式,任选一种即可。
系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | macOS 12+、Ubuntu 20.04+ / Debian 10+、Windows(原生或 WSL2) |
| Git | 可选但强烈推荐,2.23+ |
| 内存 | 最低 4 GB,推荐 8 GB |
建议在 Git 仓库里使用 Codex。官方推荐每次任务前后都留一个 Git 检查点(commit),改坏了随时可以回退。
安装
使用官方安装脚本:
curl -fsSL https://chatgpt.com/codex/install.sh | sh以后升级时重新运行同一条命令即可。
装好后确认版本:
codex --version如果安装方式支持自更新,也可以直接运行:
codex updateWindows:原生还是 WSL2
现在 Codex 在 Windows 上有两种用法:
- 原生 Windows:用上面的 PowerShell 脚本安装,命令在 Windows 自带的沙箱里运行,不需要 WSL 或虚拟机。
- WSL2:Codex 运行在 Linux 子系统里,用 Linux 的沙箱。如果你的项目和工具链本来就在 Linux 下,或者原生 Windows 沙箱满足不了你的需求,选这个。
从 Codex 0.115 起,Linux 沙箱改用 bubblewrap,WSL1 不再受支持,必须用 WSL2。
在 WSL2 中安装
安装 WSL
用管理员身份打开 PowerShell 或 Windows Terminal:
# 安装默认的 Linux 发行版(一般是 Ubuntu)
wsl --install
# 进入 WSL 的 shell
wsl把代码放在 Linux 目录下
不要在 /mnt/c/... 这类 Windows 挂载路径里干活,速度慢,还容易遇到软链接和权限问题。把仓库放到 Linux 家目录下:
mkdir -p ~/code && cd ~/code
git clone https://github.com/your/repo.git
cd repo需要从 Windows 资源管理器访问这些文件时,在地址栏输入 \\wsl$ 即可找到。
如果在 WSL 里用 VS Code,请从 WSL 终端里运行 code . 打开项目,确认左下角状态栏显示 WSL: <发行版名>。
配置 Shell 补全(可选)
Codex 能生成 Bash、Zsh、Fish、PowerShell 的补全脚本:
codex completion zsh把输出按你所用 shell 的方式加载即可。
下一步
装好之后,接着看CLI 登录(可选)。