CODEX 安装教程 · 命令行

Codex CLI 安装与使用教程一条命令装好,账号登录即用

官方一键脚本、npm、Homebrew 三种装法任选,装好后用 ChatGPT 账号登录就能在终端里让 Codex 帮你写代码、改代码、跑任务。

免费安装 · Plus/Pro 登录即用 · macOS/Linux/Windows 全支持

第一步

安装:三种方法选一种

方法一:官方一键脚本(推荐)

不需要提前装任何东西,脚本会自动下载对应平台的程序。更新时重跑同一条命令即可。

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(建议 20 及以上版本)的开发者,装完全局可用。

任意平台

npm install -g @openai/codex

方法三:Homebrew 安装

仅限 macOS,适合习惯用 brew 管理软件的用户。

macOS

brew install --cask codex

装完验证一下:终端输入下面的命令,能显示版本号就说明装好了。

codex --version

第二步

登录:用 ChatGPT 账号授权

  1. 1

    打开终端,进入你的项目目录(cd 到项目文件夹),输入 codex 回车启动。

  2. 2

    首次启动会出现登录选项,选择「Sign in with ChatGPT」,浏览器会自动打开授权页面。

  3. 3

    在浏览器里登录你的 ChatGPT 账号并确认授权。Plus、Pro、Business、Edu、Enterprise 套餐都支持直接登录,用量按套餐计算。

  4. 4

    回到终端,看到登录成功提示后就可以直接输入任务了。也可以改用 API Key 登录,按用量计费,适合没有订阅套餐的场景。

第三步

开始使用:常用命令速查

在项目目录运行 codex 进入交互模式,直接用中文描述任务即可,比如「帮我修复这个报错」「给这个函数加上测试」。下面是最常用的几个斜杠命令:

/init

生成 AGENTS.md 项目说明文件,让 Codex 更懂你的项目

/status

查看当前会话的模型、权限等配置

/model

切换模型和推理强度

/permissions

调整 Codex 的操作权限(只读 / 可改文件 / 可执行命令)

/review

让 Codex 审查当前代码改动

想在脚本或自动化流程里调用,用非交互模式 codex exec,适合 CI 和批量任务。完整参数说明见官方文档:

查看 OpenAI Codex CLI 官方文档 →

常见问题

Codex CLI 常见问题

用 Codex CLI 需要什么套餐?
ChatGPT Plus、Pro、Business、Edu、Enterprise 套餐登录后都能直接用,用量按套餐计算;没有订阅的也可以配置 API Key 按用量付费。需要充值协助时,可在本站选择 Plus 或 Pro。
安装后输入 codex 提示找不到命令怎么办?
先关掉终端重新打开一次再试。还不行的话,npm 方式检查 Node.js 是否正常安装,脚本方式确认安装时没有报错;必要时重跑一遍安装命令。
登录时浏览器没有自动打开怎么办?
终端里会同时显示一个授权链接,手动复制到浏览器打开完成登录即可。前提是当前网络能正常访问 chatgpt.com。
国内网络安装或登录失败怎么办?
绝大多数失败是网络原因。先确认浏览器能正常打开 chatgpt.com 再重试;安装脚本和登录授权都需要连接 OpenAI 服务。仍有问题可通过联系页找我们协助。
CLI 和桌面端、VSCode 插件是什么关系?
同一个 Codex,入口不同。用同一个 ChatGPT 账号登录,额度互通,选顺手的用就行;习惯终端就用 CLI,想要图形界面就用桌面端或 VSCode 插件。

Codex 相关入口

Codex CLI安装教程|一键脚本/npm/Homebrew 安装与登录使用 | GetPlus AI