03 · 安装与登录：Mac、Windows、Linux

Codex CLI 在三大平台上的安装、升级、登录与验证步骤，以及网络和权限相关的常见问题。

安装 Codex 本身并不难，真正容易卡住的是两件事：网络和登录。这一篇我们把三平台的安装步骤理顺，再把最常踩的坑提前讲掉。

在 macOS 上，最省事的是用 Homebrew：一条命令就能装上，升级也是同一条。Linux 和 Windows 则主要走官方提供的安装脚本或包管理方式。无论哪个平台，装完之后第一件事是敲版本命令验证它真的可用了——很多「装上了却报错」的情况，其实是环境变量没生效。

登录这一步，是把你本机的 Codex 和你的账号绑定起来。它通常会在浏览器里打开一个授权页面，你登录确认后，终端里会收到一个回执。登录成功后建议立刻验证一下当前身份，避免后面执行任务时才发现用的是错误账号。

网络问题是国内用户最容易卡住的地方。安装脚本要从官方源下载、登录要连官方服务器，如果网络不通，就可能卡在「下载不动」或「授权页打不开」。解决思路通常是配置合适的网络环境，或者使用官方提供的镜像/代理方式，具体要看你所处的网络条件。

权限问题也常见，尤其是在 Linux 上，某些安装位置需要 sudo，或者当前用户对目标目录没有写权限。Windows 上则要注意 PowerShell 的执行策略，以及是否用了 WSL——这两者的安装方式不完全一样。

验证是否装好的标准很简单：能查到版本号，能登录成功，能在任意一个空目录里成功启动一次会话。这三点都通了，就说明基础环境没问题，可以进入下一篇，去跑你的第一个任务。

如果你在安装过程中遇到了报错，别急着到处搜，先把报错原文记下来，后面第七组有一篇专门的排查指南，可以按现象快速定位。

安装失败的常见根因：你看着「报错一大堆」，其实 90% 的安装问题可以归到三类——网络问题（拉不到包）、权限问题（写不到目录）、依赖问题（系统缺包）。记住这三个分类，比背任何具体报错都管用。

新手最常问的「我装完了为什么还是用不了」：通常是因为 PATH 没刷新（重启终端解决）、或者登录态丢了（重新登录）、或者版本太旧（升级）。三步排查，五分钟搞定。

动手试一下：比起看十遍，不如立刻打开 Codex 跑一个小任务验证你理解的概念。比如这一篇讲的概念，你可以找一个一分钟能完成的小需求，让它跑一遍，看实际行为是不是和你理解的一致。

动手试一下：你可以花 5 分钟做一个最小验证——找一个真实的代码任务，让 Codex 跑一遍，看它的行为是不是和这一篇描述的一致。理论与实践对照，才知道「懂」和「会用」是两件事。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

判断决策树：用三个问题判断该不该用——① 这件事值不值得用 Codex 做？② 用的话该用哪个入口？③ 风险高不高需不需要审批？三个问题的答案一出来，怎么做就清楚了。