macOS CLI 安装与排错

返回 Codex 教学总目录

目标与准备

按 Command＋Space 开 Spotlight，搜寻 Terminal 并开启。视窗尾端通常显示提示符号；把安装指令贴在这里，不是 ChatGPT 或 Codex 对话方块。你只需一个可写入的新练习资料夹和可登入的帐号；独立安装版不要求先装 npm。图中 1 是确认安装来源，2 是启动正确工作目录，3 是比对档案。

步骤一：先查有没有已安装的 CLI

command -v codex
type -a codex

在 Terminal 逐行执行。command -v 用来看目前 shell 会选哪个 codex；type -a 协助发现多个来源或同名 alias／function。没有安装时可能没有路径或显示找不到，先不要接著执行模型任务。若已找到，跑 codex --version，记录版本及原安装管道，再跳到建立练习资料夹；不要为了跟文章一致而重灌。

官方独立安装路线

需要新装时，从文末官方 CLI 页核对下列命令。它会下载官方安装指令码并交给 sh 执行，因此先确认来源，等待完成后阅读安装位置与 PATH 提示。出现连线或凭证错误时保留原讯息，先解决网路或受管理凭证，不要把网址换成陌生映象或略过 TLS 检查。

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

结束后开新的 Terminal 视窗，重新执行 command -v codex、codex --version 和 codex --help。前者指向已确认的安装，后两者显示版本与说明，才算可以进到下一步。Terminal 内成功不代表你先前已开启的编辑器也立即取得新环境；若 IDE 终端机仍找不到，完整退出编辑器再开启，用相同命令比较。

已使用 Homebrew 或 npm 时

已用 Homebrew 管理工具的人可以选下面的 cask 路线，先跑 brew --version 确认 brew 可用，再安装。未装 Homebrew 的新手可直接使用上一段独立版，不必为了 Codex 多装一套管理工具。官方命令使用 --cask，请保留它；更新时也要使用相同 cask 管道。

brew --version
brew install --cask codex

已具备 Node.js 与 npm，且想沿用 npm 的读者，先确认 node --version、npm --version，再用 npm install -g @openai/codex。若 npm 回报 EACCES，先检查目前 Node.js 管理方式和 npm 全域目录拥有者；不要直接在所有命令前加 sudo。若改选独立版，先记录原来源并检查重复命令，避免之后更新到另一份。

步骤二：建立、定位与备份练习档

在 Finder 选一个自己可写入的位置，建立全新的 codex mac lab 资料夹。用纯文字编辑器建立 note.txt，只有 MAC-CLI-01 一行，再另存 note.original.txt。若用 TextEdit，选「格式 > 制作纯文字」（Format > Make Plain Text），存档时核对名称与 .txt 副档名；按住 Option 再选「档案 > 另存新档」（File > Save As）可储存原始副本；不要把 RTF 档案只改名成 .txt。已有同名资料夹时另取新名称，保留旧练习。

在 Terminal 先输入 cd 和一个空格，再把 Finder 的练习资料夹拖进视窗，确认产生的是它的路径后按 Return。这样可使用自己的真实路径，不需猜使用者名称。也可以自行输入 cd 加上引号括住的完整路径。先执行 pwd 与 ls，再读档；看到 RTF 控制字元或多出 .txt.txt 时回编辑器修正，不能继续假定资料正确。

pwd
ls
cat note.txt
shasum -a 256 note.txt note.original.txt

预期目前目录是你的练习资料夹，有两个文字档，内容为 MAC-CLI-01。两份档案的 SHA-256 应相同；若不同，先查是否多了空格、不同换行或编码，不要叫 Codex 猜哪一份才正确。记录本机算出的值即可，本文不提供固定杂凑，因为不同编辑器的换行可能不同。

步骤三：登入与唯读任务

codex login
codex login status
codex --sandbox read-only

逐行执行并等待完成。浏览器登入确认帐号和工作区，回到 Terminal 看 login 是否结束，再查 status。若系统有凭证储存确认，先核对是此次 Codex 登入；不要把认证档内容放进需求或截图。帐号限制与 API 计费差异见帐号教学。第三行启动后，以下自然语言才贴进 Codex。

Inspect note.txt and note.original.txt in the current folder. Report the current directory, exact content of each file, and whether they match. Do not edit files or use external services. If the folder or files are wrong, stop and report the mismatch.

检查回复有无 MAC-CLI-01、两个档名和正确路径，并看读档工具记录。用 /exit 回到 Terminal，重跑 cat 和 shasum，确认前后内容、杂凑和档案数量未变。若 Terminal 自己读得到、Codex 读不到，记录沙盒讯息再查权限；这是不同执行范围，不是档案突然消失。

补做一次缺档与恢复练习

确认已回到 Terminal 的系统提示符号；若仍在 Codex 内才输入 /exit。接著用 Finder 把练习副本的 note.original.txt 暂改名为 note.reference.txt；已有后者时先停止，避免覆盖。在同一个练习资料夹执行 codex --sandbox read-only 重新启动，再送出同一个读档提示词。预期它能读 note.txt，却明确回报 note.original.txt 不存在，不能凭另一份内容宣称两份已比对。结束后退出，把档名恢复成 note.original.txt，再以 cat、ls、shasum 重验；两份档案应回到原来的相同杂凑。这一步只改练习档名，不更动登入或 shell 设定。

步骤四：重开终端机仍然有效

关闭 Terminal 视窗再开启，先查 command -v codex 和版本，再重新 cd 进练习资料夹，执行 codex resume 并核对刚才那笔任务的目录与时间。新 shell 不一定从上一个工作目录开始；找不到 note.txt 时先看 pwd，不要重新建立另一份同名档案。接续对话不会自动把 Finder 的位置、终端机位置或档案内容都恢复。

若新视窗才找不到 CLI，通常要查 shell 启动环境：把安装程式最后的 PATH 说明和 command -v 结果对照。只修改自己实际使用的 shell 设定档，先备份原档并保留原 PATH。不要把网路上的固定 /opt/homebrew 或 /usr/local 路径当成每台 Mac 都适用，也不要同时把设定复制进多个启动档来碰运气。

更新与错误对照

先退出工作阶段并储存摘要，更新完成才重新启动。若更新后版本没变，先用 type -a 查重复来源。若已能显示 help，却无法登入，安装通常已过第一关，应记录浏览器回呼、帐号或网路错误；若只在特定资料夹失败，则比较该资料夹的存取权限与目前位置。把不同层级的问题分开，才能知道下一个修正会验证什么。

完成后回CLI 共用入门练习指定一行的修改与还原，或进常用指令了解斜线指令和工作阶段。不必完成 Windows 篇才能学本篇；也不要用 Windows 路径或 PowerShell 命令替代 macOS 操作。保留自己的版本、安装来源、前后杂凑与错误纪录，才是这次安装可重现的交付。

返回 Codex 教学总目录

阅读完整文字说明

Three numbered stages: identify the starting point, perform the exercise, and verify the result. Original illustration, not a product screenshot.

• AI 工具
• 教程
• Codex