安装 Codex CLI

预计 10 分钟 最后验证 2026-09-29Codex CLI 0.158.0npm 10 / 11 / 12部分待实测

验证情况

• ✅ 已实测：npm 11、12 下用本页命令安装，codex --version 正常（Linux）
• ⚠️ 待实测：Windows、macOS 真机安装

开始之前

请确认已经完成 第 1 章 的自检清单，特别是：

• node -v 能输出版本号；
• npm config get registry 显示 https://registry.npmmirror.com；
• （Windows）已经执行过 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。

安装

执行安装命令

npm install -g @openai/codex

和 Claude Code 一样，npm 会根据你的系统自动下载对应的原生程序。Codex 不需要运行安装脚本，所以不需要加 --allow-scripts 参数。

你会看到

added 2 packages in 12s

验证安装

新开一个终端窗口，输入：

codex --version

你会看到

codex-cli 0.158.0

运行诊断（可选）

Codex 自带诊断命令，可以检查安装、配置、登录状态和网络连通性：

codex doctor

现在还没配置模型，诊断结果里有几项显示 ✗ 是正常的。接入 DeepSeek 之后，会再用它来检查配置是否正确。

如果提示找不到 codex 命令

• 先关掉所有终端窗口再重新打开；
• Windows 报"禁止运行脚本"：回到 允许 PowerShell 运行脚本；
• 其他情况见 常见问题。

下一步：接入模型（重要）

和 Claude Code 一样，Codex 需要连接一个大模型才能工作：

方式	适合谁	怎么做
DeepSeek（本教程主线）	国内用户、想低成本学习	看 Codex 接入 DeepSeek，按步骤配置
ChatGPT 账号	所在地区支持 OpenAI 服务、有 ChatGPT Plus/Pro 等订阅	运行 codex，选择 Sign in with ChatGPT，在浏览器中登录
OpenAI API Key	有 OpenAI API 账号	运行 codex login --with-api-key，按提示输入 Key

用 DeepSeek 的话，先别急着运行 codex

不做任何配置就运行 codex，它会要求你登录 OpenAI 账号。打算用 DeepSeek 的读者，请先完成第 5 章的配置再启动。如果已经看到了登录界面，按 Ctrl + C 退出即可。

模型接入完成后，回来看 第一次上手。

其他安装方式（了解即可）

下面是官方提供的其他安装方式，需要从海外服务器下载，国内网络可能下载失败：

macOS / Linux 官方脚本

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

Windows 官方脚本

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

macOS Homebrew

brew install --cask codex

不要混用多种安装方式

选一种就好，本教程用的是 npm。

更新与卸载

更新

npm install -g @openai/codex@latest

卸载

npm uninstall -g @openai/codex

Codex 更新很频繁（几乎每天都有新版本），界面和命令可能和本教程略有不同，以实际为准。

配置文件在哪里

位置	内容
~/.codex/config.toml	用户配置：模型、模型提供方、权限等
~/.codex/ 文件夹	登录信息、历史对话、日志等
~/.agents/skills/	你安装的 Skill（第 6 章介绍）
项目里的 AGENTS.md	给 Codex 的项目说明（第一次上手里会讲）

Windows 上 ~ 对应 C:\Users\你的用户名。卸载程序不会删除这些文件。