浏览 AI使用教程
macOS 安装 Codex：同时说明 Linux 的 Shell、目录和权限差异
macOS 和 Linux 上安装 Codex，常见卡点不是命令本身，而是 Shell、PATH、权限和安装位置没有对上。先看清当前环境，再决定该执行哪条命令。
按实际操作顺序推进
每完成一段就检查当前输出，确认结果符合预期后再继续。
同一条安装命令，换到另一个系统为什么就失效了
Mac 用户复制了一段 Windows 安装命令，终端提示找不到包；另一位 Linux 用户虽然安装成功，却把可执行文件装进当前 Shell 找不到的目录。
命令依据 2026-10-11 的官方 CLI 文档；本页未在 macOS/Linux 安装执行，不提供虚构终端记录。
- 平台、架构、Shell 和版本已记录
- 安装来源为当前官方入口
- 重开终端后仍能验证版本
动手前，把材料和不能改的部分定下来
| 需要确认 | 本例内容 |
|---|---|
| 现有材料 | 一台可联网的 macOS 或 Linux 电脑，交互式终端、curl 和可用的 Codex 登录方式。本例选择原生 CLI 安装，Node/npm 不作为这一路线的前置。 |
| 不能越过的边界 | 命令和版本会变化，必须以执行时的官方文档为准；不使用来路不明的一键脚本，不把 API Key 写进 Shell 历史。 |
| 要交付的结果 | 可运行环境与平台核验记录 |
macOS 安装 Codex，从“确认平台”开始做
确认平台
在准备使用 Codex 的终端运行 uname 和 Shell 检查，WSL、远程终端与本机是不同环境。
安装官方 CLI
阅读官方 CLI 页面后执行下方当前命令，保留安装器给出的实际路径与提示。已通过其他来源安装者先检查 type -a codex，避免叠装。
重新开终端验证
分别核对命令路径、版本；找不到命令先处理 PATH。
登录并做只读任务
进入新建练习目录，运行 codex，按界面选择可用登录方式；只让它列出文件，不授权系统配置修改。
macOS/Linux 原生 CLI 路线
命令在终端执行；安装脚本来自 OpenAI 官方域名。账号或 API 方式按你实际拥有的权限选择，不需要为了本练习购买第三方服务。
环境与安装
uname -srm printf '%s\n' "$SHELL" type -a codex curl -fsSL https://chatgpt.com/codex/install.sh | sh
验证和首次进入
command -v codex codex --version mkdir codex-first-check cd codex-first-check printf 'practice\n' > README.txt codex
type -a 在安装前找不到 codex 属正常情况。进入后输入：只读当前目录，告诉我 README.txt 的内容及依据，不创建或修改文件。预期能看到 practice 和文件名；这是任务验收，不是本文已执行记录。
安装失败按阶段处理
下载失败先核对官方域名、网络错误与代理设置；找不到命令看 PATH；能启动但登录失败看账号和登录提示；能登录但读错目录先退出并确认 pwd。不要把四类问题都归为重装。
官方依据：[Codex CLI](https://developers.openai.com/codex/cli)。安装器与支持方式可能更新，执行前以该页为准。
完成后的可运行环境与平台核验记录
预期：新终端中的 command -v codex 返回可执行文件，codex --version 返回版本；进入练习目录运行 codex 后完成登录和只读目录任务。安装、登录、完成任务是三项不同检查。
为什么“安装器显示完成，新终端找不到 codex”还不能交付
安装器显示完成，新终端找不到 codex
- 原因
- Shell 尚未载入安装器提示的 PATH 或存在旧版本覆盖
- 怎么改
- 先保留安装器输出，运行 type -a codex 与 command -v codex；按实际安装目录修正对应 Shell 启动文件，不猜路径、不反复 sudo 安装