1. 安装
选择一种方式。
macOS 或 Linux:独立安装程序
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows:独立安装程序
打开一个新的 PowerShell 窗口,然后运行:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npm(任何装有 Node.js 的操作系统)
npm install -g @openai/codex
Homebrew(macOS)
brew install --cask codex
根据 README,独立安装程序从 releases.openai.com/codex 下载,如果无法访问则回退到 GitHub Releases。如需强制使用 GitHub Releases:
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
2. 确认安装成功
打开一个新的终端以刷新 PATH,然后运行:
codex --version
你应该会看到一个版本号。如果看到 “command not found”,请按照这个解决方法操作。
3. 登录
进入一个项目文件夹并启动 Codex:
cd path/to/your/project
codex
选择 Sign in with ChatGPT(使用 ChatGPT 登录)。浏览器会打开,登录完成后会把凭据交回给 CLI。你也可以直接运行 codex login。如果想改用 API 密钥:
printenv OPENAI_API_KEY | codex login --with-api-key
用 codex login status 查看当前使用的登录方式。如果你通过 SSH 工作或在无图形界面的服务器上使用,请运行 codex login --device-auth。更多登录选项。
4. 运行第一条提示词
Tell me about this project
然后继续进行你的第一个真正任务。
常用命令
| 命令 | 作用 |
|---|---|
codex | 在当前文件夹中启动交互式会话 |
codex resume | 重新打开此仓库中最近的一次对话 |
codex exec "..." | 以非交互方式运行,适用于脚本和 CI |
codex --search | 本次运行使用实时网页搜索 |
codex mcp add ... | 连接一个 MCP 服务器 |
codex login status | 显示当前使用的登录方式 |
codex completion | 生成 shell 自动补全脚本 |