Codex CLI 安装的4个基础命令

安装结束以后，我没有马上输入一大段提示词，而是先把 PowerShell 关掉，再打开一个新的窗口，确认这套环境到底有没有接上。

我最后固定下来的顺序是：先看版本，再看帮助，然后跑一次 doctor，最后看功能列表。下面这 4 个命令不负责写代码，但能帮我判断问题出在安装、配置，还是后面的模型调用。

先确认 Node.js 和 Codex CLI 在不在

node --versionnpm --versioncodex --version

图 1：本机实际运行的版本检查结果。版本号会随安装时间和 npm 发布变化。

我这次看到的是 Node.js v22.23.2、npm 12.0.2、Codex CLI 0.147.0。你不需要和我的版本号完全一样，关键是三个命令都能返回结果。

如果 node 或 npm 找不到，先解决 Node.js 和 PATH；如果只有 codex 找不到，先关闭当前 PowerShell，再开一个新的窗口。Windows 修改 PATH 后，旧窗口不一定会马上读到新值。

第一个命令：codex --version

codex --version

这个命令只回答一个问题：当前 PowerShell 找到的 Codex 是哪个版本。

我建议每次排错时都先跑一下它。尤其是刚更新过 npm 包，或者电脑里装过多个 Codex 版本时，终端实际调用的版本可能和你以为的不是同一个。

还可以顺手看一下命令来自哪里：

Get-Command codexwhere.exe codex

如果这里显示了多个路径，不用马上删文件。先确认当前使用的是哪一个，再决定是否清理旧安装。

第二个命令：codex --help

codex --help

刚开始我也容易把 Codex CLI 当成只有一个入口的命令。看完帮助以后，我才发现它把不同工作拆成了几个入口：

1. exec：非交互执行一段任务。
2. review：检查代码改动。
3. doctor：诊断安装、配置和运行环境。
4. mcp：管理 MCP 服务。
5. sandbox：在 Codex 提供的沙箱里运行命令。

帮助里还会列出 --sandbox、–cd 等参数。现在我还不建议新手一上来就打开所有选项，先知道它们是做什么的就够了。

图 2：我用 codex --help 看到的命令入口。

遇到教程里的命令和自己电脑上的表现不一致时，我会先看本机的 --help。命令行工具会更新，网上文章里的参数不一定还适用。

第三个命令：codex doctor

codex doctor

这是我现在最常用的排错命令。它会检查 Codex 的运行环境，通常包括系统语言、安装方式、PATH、Git、配置文件、认证状态、沙箱和网络可达性。

我本机这次的诊断摘要是：17 项通过，1 项空闲，0 项警告，0 项失败。这个结果只代表我这台电脑在采集时的状态，不代表所有人的电脑都会一样。

图 3：codex doctor 的脱敏输出。认证值、服务地址和本机路径没有放进截图。

我看 doctor 输出时，主要看下面几项：

安装是否一致

如果安装方式显示为 npm，路径和资源都能找到，通常说明 CLI 本身没有缺文件。这里如果出现失败，先处理安装问题，不要急着折腾模型配置。

配置是否成功加载

配置加载失败时，后面即使输入正确的模型名，也可能仍然调用不到。先把配置文件的格式和路径检查好，再继续排查网络。

认证状态是什么

认证状态只能说明本机有没有配置认证信息，不等于调用一定成功。认证值不能截图，也不能复制进文章、仓库或聊天记录。

网络和沙箱是否正常

网络不可达、代&理不对、沙箱权限受限，都可能让第一次调用失败。doctor 能缩小范围，但它不会替我判断模型回答质量。

第四个命令：codex features list

codex features list

这个命令是看功能开关状态的。我第一次看到列表时，发现有些功能是 stable，有些还在开发中，还有一些默认关闭。

图 4：本机 Codex 功能列表的脱敏展示。不同版本显示的功能名称可能不同。

我现在把它当作查看状态的命令，不把它当成提高效果的按钮。看到一个名字很有吸引力的实验功能时，我也不会马上执行 --enable。先看当前版本说明，确认它解决的问题和可能影响，再决定要不要试。

如果你使用 llapi.org

如果你的 Codex 配置使用 llapi.org 作为 API 中转入口，可以去 llapi.org 创建账号并申请自己的 API Key。具体的 Base URL、模型名称、价格和服务规则，以官网当前页面为准。

我这里不放测试 Key，也不建议把 Key 直接写进命令截图。展示配置时，我会使用下面这种占位写法：

如果你是通过远程 PowerShell 脚本安装，还要记住一件事：irm … | iex 会下载后直接执行脚本。更稳妥的做法是先保存脚本，查看它会下载什么、修改哪些配置，再决定是否执行。

这 4 个命令解决不了什么

我跑完这 4 个命令，只能确认本地环境和配置大体正常，不能证明某个模型一定可用、某个 API 中转服务一定稳定，或者 Codex 已经理解了我的项目。

这些要等我在不暴露 Key 的前提下，使用一个明确的测试请求实际验证。没有跑过的内容，我不会写成实测成功。

我下一步会做什么

现在我已经知道 Codex CLI 是否安装正确，也知道从哪里看帮助和诊断信息。下一篇我准备拿一个很小的、没有密钥的 Node.js 示例项目，让 Codex 先以只读方式分析目录和依赖。

我会先让它读，再决定要不要让它改。这样出了问题，我至少能分清是项目本身、权限设置，还是模型调用的问题。

本文整理时间：2026-08-09。Codex CLI 的命令和功能会随版本变化，实际使用时以本机 codex --help 和 codex doctor 的输出为准。