安装 Codex CLI 教程

安装 Codex CLI 教程

Codex CLI 是 OpenAI 的本地编码代理（coding agent），在终端里运行。本文介绍如何安装、登录并开始使用。

说明：Codex 有多种形态——终端版 Codex CLI、IDE 插件（VS Code / Cursor / Windsurf）、桌面 App、网页版 Codex Web。本教程针对最常见的 Codex CLI。

环境要求

项目 要求
操作系统 macOS 12+、Ubuntu 20.04+ / Debian 10+、Windows 11（源码构建建议使用 WSL2）
Git（可选，推荐） 2.23+，用于内置 PR 辅助功能
内存 最低 4 GB，推荐 8 GB

方式一：官方一键安装（推荐）

macOS / Linux：

1
curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows（在 PowerShell 中运行）：

1
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

方式二：使用包管理器

npm：

1
npm install -g @openai/codex

Homebrew（macOS）：

1
brew install --cask codex

方式三：手动下载二进制

前往 GitHub Releases 最新版 下载对应平台的文件：

  • macOS（Apple Silicon / arm64）：codex-aarch64-apple-darwin.tar.gz
  • macOS（x86_64）：codex-x86_64-apple-darwin.tar.gz
  • Linux（x86_64）：codex-x86_64-unknown-linux-musl.tar.gz
  • Linux（arm64）：codex-aarch64-unknown-linux-musl.tar.gz

解压后，把其中的可执行文件重命名为 codex，放到 PATH 中包含的目录（例如 /usr/local/bin）即可。

验证安装

安装完成后，新开一个终端运行：

1
codex --version

能正常打印版本号即表示安装成功。

登录并开始使用

  1. 在终端运行：

    1
    codex

  2. 首次启动选择 Sign in with ChatGPT，使用 ChatGPT 账号登录。推荐通过 ChatGPT 账号使用，可享受 Plus / Pro / Business / Edu / Enterprise 套餐中的 Codex 额度。

  3. 也可以使用 API Key，但需要额外配置，详见官方说明：Sign in with an API key。

登录后即可直接输入任务，例如：

1
codex "解释一下这个代码库"

其他形态

常见问题

  • 安装源与回退：官方安装脚本默认从 https://releases.openai.com/codex 下载；若元数据或资源下载失败，会自动回退到 GitHub Releases。如需强制使用 GitHub Releases：

    1
    curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
    1
    $env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; irm https://chatgpt.com/codex/install.ps1 | iex

  • 从源码构建：需要 Rust 工具链，步骤见 Installing & building。

参考来源