安装 Codex CLI，开始第一次对话

这节课结束时，你会在一个空的练习目录里，让 Codex 回答第一条消息。先不用准备项目，也不用装插件。

下面使用 macOS 终端 + ChatGPT 登录。需要可用网络、具有 Codex 访问权限的账号；npm 安装方式还需要 Node.js。Windows 用户请使用官方 CLI 对应安装选项，不要原样套用这里的目录操作。

1. 让终端能找到 Codex

打开 macOS 的“终端”。下面是 shell 命令，应在系统终端逐行执行。命令前不用额外输入教程里常见的 $ 提示符。

command -v codex
codex --version

第一条查看系统找到哪个 codex；第二条应输出 codex-cli 及版本号。记录自己的实际版本，无需为了跟教程一致而降级。

如果第一条找不到路径、第二条提示找不到命令，才进入安装步骤。已经能显示版本时，先不要叠加另一种安装方式，以免之后不知道更新的是哪一份。

没找到命令？再安装

已经显示版本号，可以直接跳到登录。还没安装且已有 Node.js/npm，按下面操作；没有 npm，则打开官方 CLI 安装区，选择适合你的安装方式，只选一种即可。

在系统终端先检查：

node --version
npm --version

再按官方 npm 选项安装：

npm install -g @openai/codex
codex --version

这条命令会下载并安装软件，执行前确认来源及本机权限。若没有 Node.js/npm，可以改用官方提供的其他安装方式，不要盲目复制多个环境安装脚本。后续代码练习仍需要 Node.js：若 node --version 无法运行，先完成 Node.js 环境准备，不要把“Codex 已安装”当作“练习依赖已齐”。

如果安装后仍找不到命令，重新打开终端再检查路径。遇到权限错误时先保留错误、安装方式和路径信息，不把 sudo、关闭安全限制或清空配置当作通用修法。

2. 登录自己的 ChatGPT 账号

本课选择 Sign in with ChatGPT。账号是否能用 Codex，取决于适用权益和工作区策略；不要为了绕过登录问题，临时换成另一种付费方式。

在终端执行：

codex login

按打开的官方浏览器流程由你本人登录。账号密码、验证码和授权确认应由本人完成；不要发给教程作者或粘贴给 Agent。

返回终端，再检查：

codex login status

成功标准是状态命令明确显示有效登录方法，而不是浏览器曾经打开过。若仍显示 Not logged in，先不要进入下一课的对话步骤。完成登录仍不保证所有模型或功能都对该身份可用。

我已有 API key，和 ChatGPT 登录有什么不同？

API key 使用 OpenAI Platform 的 API 计费，不能把 ChatGPT 订阅理解成自动覆盖 API 费用。它的权限与部分功能可用性也可能不同。确实需要这条路线时，再看官方身份说明；不要把密钥粘贴到对话或公开文件里。

3. 在空文件夹里开始第一次对话

在 Finder 创建一个新的空文件夹 codex-first-project。在终端输入 cd （后面有空格），把文件夹拖进去，回车后执行：

pwd
ls

pwd 应显示以 codex-first-project 结尾的路径；新建空目录中，ls 通常没有输出。下一课再把样例文件放进去。

只读理解任务可使用 CLI 支持的显式权限：

codex --sandbox read-only --ask-for-approval on-request

进入 Codex 输入区后，发送下面这句话。注意：这次输入的是自然语言，不是终端命令。

请告诉我当前工作目录。只回答，不修改文件，不运行安装命令。

核对回答中的路径是否与刚才 pwd 一致。没有实际收到回答，即使已经登录，也还不能说明对话可用；若提示额度或工作区限制，先按提示处理账号问题。

后续教程出现 node、pwd 等命令时，在另一个系统终端窗口运行，并进入同一个目录。需要访问授权时，先看请求内容，不为这个只读任务批准无关写入。

卡住时，对着现象查

你看到的现象	下一步
command not found: codex	确认安装完成，重开终端再检查 command -v codex
Not logged in	回到 codex login 完成本人的浏览器授权，再查状态
浏览器授权打不开	看设备码登录说明，先确认账号允许使用
能登录，但任务报额度或工作区错误	检查账号权益和组织策略，不靠放宽本机权限解决
回答中的目录不对	退出本次会话，cd 到练习目录后重新启动

排障时保留版本、安装方式和脱敏报错即可。不要分享 auth.json，也不要关闭 TLS 校验。

接下来，让它解释真实文件

能收到回答后，下一课把四个教学文件放进这个目录，让 Codex 解释一笔订单。先确认 node --version 能输出版本号：Codex 安装成功，不等于运行样例所需的 Node.js 已经准备好。

参考资料

• CLI Quickstart：安装与项目内启动。
• Authentication：登录命令、身份区别和凭据保护。
• Non-interactive mode：交互式与脚本式用法不同，本课不要求先学自动化。

下一课：先读懂项目，不急着修改 · 返回课程