安装并打开 Codex，发出第一条消息

第一次接触这类工具，先完成一件小事：打开软件，选一个文件夹，让 Codex 回答你。先不用学习终端命令。

已经能在桌面版 Codex 里聊天？直接去个人主页教程，不用重新安装。

1. 从官方网站下载桌面应用

1. 打开官方开始指南。
2. 找到 Desktop（桌面版），选择与你电脑对应的下载入口。
3. 下载完成后，打开安装文件，按电脑上的提示安装。
4. 打开应用，用自己的 ChatGPT 账号登录。

登录后，应该能进入应用，而不是一直停留在登录页面。下一步再进入 Codex。

能否使用 Codex，以你的账号和应用里的提示为准。遇到账号或额度提示，先处理这一步，不必继续找命令来绕过。

2. 进入 Codex

在 ChatGPT 桌面应用的产品选择菜单里选择 Codex。如果你已经在 Codex 界面里，就不用再找一遍。

普通聊天主要是回答消息；这次我们要让 Codex 在选好的文件夹里创建网页。界面随版本可能变化，找不到入口时可对照上面的官方指南。

3. 给这次练习准备一个文件夹

先在电脑桌面新建一个空文件夹，叫 我的第一个主页。这个文件夹用来放你待会儿做出来的网页。

再回到应用，打开或添加这个文件夹。如果界面要求先建立本地项目，就先建项目，再添加刚才的文件夹。这里的“项目”只是把这次练习的文件和聊天放在一起。

在这个项目里新建 Codex 对话，然后发送：

我是第一次使用 Codex。
请告诉我现在选中了哪个文件夹，以及能否在里面创建网页。
先不要修改文件，用简单的话回答我。

收到回答后，确认文件夹名字与你刚才创建的一样。如果不一样，先重新选择文件夹；不要接着在不认识的位置做练习。

如果回答说“看不到文件夹”，说明还没选好。回到添加文件夹的地方，选择桌面上的 我的第一个主页，再发一次上面的话。只把文件夹名字写进聊天框，还不算选中了它。

4. 开始做你的第一个主页

能收到回复，也选好了文件夹，就进入个人主页图文教程。下一步是复制一段需求发给它，不需要打开终端。

如果其他课程要求你使用终端

“终端”是输入电脑命令的窗口。下面保留的是另一种使用方式，主要服务后面的代码练习。做个人主页可以跳过。

需要命令行时再展开：macOS CLI 安装与登录

CLI 就是命令行版本。下面的命令在 macOS 的“终端”应用里逐行输入，不是在 Codex 的聊天框里发送。

先让终端能找到 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 下载页安装当前 LTS 版本，再重新打开终端确认两个版本命令都有输出。也可选择官方 CLI 的其他安装方式，但后面的 JavaScript 练习仍需要 Node.js。后续代码练习仍需要 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 校验。

官方项目与文件夹说明 · 返回学习路线