安装 Codex CLI

使用 OpenAI 的独立安装程序安装 Codex CLI。在 macOS 或 Linux 上,运行 curl -fsSL https://chatgpt.com/codex/install.sh | sh。在 Windows 上,新开一个 PowerShell 窗口运行 install.ps1 命令。也可以使用 npm install -g @openai/codex 或 brew install --cask codex。然后在项目文件夹中运行 codex,并选择 Sign in with ChatGPT。

适用于: Codex CLI, macOS, Linux, Windows

本页译自英文指南。命令和文件名保持不变。如两者有出入,以英文页面和官方来源为准。

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 自动补全脚本

常见问题

我应该用哪种安装方式?

独立安装程序是 OpenAI 列在首位的方式,而且不需要 Node.js。如果你已经在用 npm 或 Homebrew 管理工具,也可以用它们。不要混用多种方式,否则 PATH 中可能会出现两个副本。

可以强制安装程序从 GitHub 下载吗?

可以。README 说明,设置 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false 后,安装程序会改用 GitHub Releases,而不是 releases.openai.com。

调试时如何查看 Codex 在做什么?

运行 codex -c log_dir=./.codex-log 写入纯文本日志,然后用 tail -F ./.codex-log/codex-tui.log 实时查看。

来源

本页的每条说明都附有官方来源链接。如果本页内容与官方来源不一致,请以官方来源为准,并告诉我们。