03 · 安装与登录（Mac / Windows / Linux）

桌面端和 CLI 怎么装、怎么登录，以及装坏了该从哪里查

📚 系列导航 上一篇〈02 · Codex 核心概念速览〉，咱们讲清了代理、沙箱、审批、AGENTS.md 和记忆。这一篇正式动手，把 Codex 装到 macOS、Windows 或 Linux 上，完成登录并跑通第一个任务。下一篇〈04 · 订阅与计费〉，再把额度和花钱方式说明白。

刚开始装 Codex 时，最容易踩的坑不是命令太复杂，而是：

你搜到的教程可能已经过期了。

有人告诉你必须先装 Node.js，有人让 Windows 用户一律使用 WSL，还有人让你下载一个叫“Codex App”的独立软件。

这些说法不一定完全错，但可能只适用于某个历史版本。

截至 2026 年 7 月，Codex 原来的独立桌面应用已经合并进新的 ChatGPT 桌面应用。macOS 和 Windows 用户可以直接在 ChatGPT 桌面端进入 Codex；Linux 用户目前主要使用 Codex CLI 或 IDE 扩展。(OpenAI Help Center )

所以这一篇不堆一大堆旁门左道，只讲目前最稳的两条路线：

不喜欢终端：安装 ChatGPT 桌面应用；
开发者或 Linux 用户：安装 Codex CLI。

看完以后，你应该能做到：

在 macOS、Windows 或 Linux 上正确安装 Codex；
分清独立安装脚本、Homebrew 和 npm；
使用 ChatGPT 账号或 API key 登录；
在服务器、SSH 和无浏览器环境中完成认证；
遇到 PATH、Windows 沙箱和登录回调问题时知道怎么排查；
创建一个测试目录，跑通第一个本地任务。

⚠️ Codex 更新速度很快。文中的命令按当前官方文档整理，版本号和界面文字以你实际看到的内容为准。

01 安装前，先确认三件事

先别急着复制命令。

安装之前，把下面三件事确认清楚，可以少走很多弯路。

第一件：你准备从哪里使用 Codex

安装这件事主要有两条路线。

路线	支持平台	适合谁
ChatGPT 桌面应用里的 Codex	macOS、Windows	不喜欢终端、想图形化查看任务和 diff 的人
Codex CLI	macOS、Windows、Linux	开发者、服务器用户、自动化和终端工作流

桌面端适合直观操作：

打开项目文件夹；
同时运行多个任务；
查看代码差异；
在不同项目之间切换；
管理较长时间运行的任务。

CLI 则更通用：

三大平台都能使用；
可以在 SSH 服务器上运行；
可以配合脚本和 CI；
不依赖图形桌面；
更适合开发者的日常工具链。

我的建议是：

完全不想碰终端，就先用桌面端；准备认真学 Codex，迟早还是要把 CLI 跑通。

第二件：准备一个登录方式

Codex 当前包含在 ChatGPT 的 Free、Go、Plus、Pro、Business、Edu 和 Enterprise 等套餐中，但不同套餐的使用限额不同。大多数个人用户直接使用 ChatGPT 账号登录即可。(OpenAI Help Center )

除此之外，Codex 本地客户端也支持使用 OpenAI API key 登录。

两种方式的区别先简单记住：

登录方式	用量从哪里扣	适合什么场景
ChatGPT 账号	ChatGPT 套餐额度或相关 Credits	日常使用、桌面端、云端功能
API key	OpenAI Platform API 账户	脚本、CI/CD、程序化本地工作流

API key 可以运行本地 Codex，但部分依赖 ChatGPT 工作区或 OpenAI 云服务的功能可能不可用。(OpenAI Developers )

账号和费用细节，下一篇再专门展开。

第三件：确认网络和系统环境正常

安装脚本、桌面应用下载和登录认证都需要访问 OpenAI 的官方服务。

开始前至少确认：

你所在的国家或地区支持相关服务；
当前网络可以正常访问 OpenAI 官方站点；
公司电脑没有拦截安装脚本或登录回调；
系统时间和时区没有严重错误；
企业网络使用自签名证书时，已经配置公司要求的根证书。

使用时应遵守所在地法律、OpenAI 的服务条款以及公司的网络与安全政策。

💡 一句话总结：

装之前先决定用桌面端还是 CLI，再准备 ChatGPT 账号或 API key，并确认网络和系统没有把官方服务挡住。

02 路线一：安装 ChatGPT 桌面应用

不喜欢终端的话，桌面端是最省心的入口。

不过要先修正一个容易过时的叫法：

现在不再需要单独寻找“Codex App”，Codex 已经并入新的 ChatGPT 桌面应用。

新的桌面应用在 macOS 和 Windows 上整合了 Chat、Work 和 Codex。原来已经安装 Codex App 的用户，正常更新以后会迁移到新的 ChatGPT 桌面应用，已有项目和任务应当继续保留。(OpenAI Help Center )

下载与安装

进入 OpenAI 官方下载页面，根据系统下载安装包。

平台	当前情况
macOS	支持 ChatGPT 桌面应用
Windows	支持 ChatGPT 桌面应用
Linux	暂无官方桌面应用，优先使用 CLI

安装过程和普通软件基本一样：

下载对应系统的安装包；
完成安装；
打开 ChatGPT；
使用 ChatGPT 账号登录；
在产品入口中选择 Codex；
打开一个项目文件夹或创建项目；
输入任务。

官方桌面端快速上手流程同样是：安装应用、登录、选择工作位置，再发送第一条消息。(OpenAI Developers )

第一次打开应该做什么

登录后，不要急着让它重构半个项目。

先做三件简单的事：

1. 选择 Codex

新的桌面应用里可能同时存在 Chat、Work 和 Codex。

需要处理代码仓库、运行开发工具或修改本地项目时，选择 Codex。

2. 打开一个项目文件夹

Codex 需要知道自己在哪里工作。

最好选择一个明确的项目目录，而不是直接把整个用户主目录、桌面或系统盘交给它。

例如：

~/code/my-project

或者 Windows：

C:\Users\你的用户名\code\my-project

3. 先让它只读分析

第一句话可以写：

请先阅读这个项目，介绍它的目录结构、技术栈和启动方式。
暂时不要修改任何文件。

这样可以同时验证：

项目是否打开正确；
Codex 是否能读取文件；
模型是否能正常响应；
当前权限是否符合预期。

💡 一句话总结：

桌面端现在统一装 ChatGPT 桌面应用，打开后选择 Codex、选择项目文件夹，再从一个只读分析任务开始。

03 路线二：安装 Codex CLI

如果你准备长期使用 Codex，CLI 是最值得先跑通的一条线。

当前官方提供四种常见安装方式：

独立安装脚本；
Windows PowerShell 安装脚本；
npm；
Homebrew。

官方独立安装脚本不要求你提前安装 Node.js，适合大多数新手。npm 和 Homebrew 更适合已经习惯用对应包管理器的人。(GitHub )

macOS / Linux：官方独立安装脚本

打开终端，运行：

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

这个命令会：

从 OpenAI 官方地址下载安装脚本；
下载适合当前系统架构的 Codex；
把可执行文件放进用户可访问的目录；
必要时提示你配置 PATH。

安装完成后，建议关闭当前终端，再重新打开一个新终端窗口。

官方文档当前也建议 macOS 和 Linux 用户优先使用这条独立安装命令。(OpenAI Developers )

Windows：PowerShell 安装脚本

Windows 用户打开 PowerShell 或 Windows Terminal。

注意，不是传统 CMD。

运行：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

这里几个部分分别是：

irm：下载官方安装脚本；
iex：执行下载到的脚本；
-ExecutionPolicy ByPass：仅为这一次 PowerShell 进程临时放行脚本执行。

它不会永久修改整台电脑的 PowerShell 执行策略。

如果系统提示：

'irm' is not recognized

你大概率是在 CMD 里运行了 PowerShell 命令。

关掉当前窗口，搜索并打开：

PowerShell

再重新执行。

Windows 官方安装命令同样收录在 OpenAI 的 Codex 官方仓库中。(GitHub )

备选一：npm 安装

已经装好 Node.js，并且习惯用 npm 管理命令行工具，可以运行：

npm install -g @openai/codex

npm 方式支持 macOS、Windows 和 Linux。

不过它多了一层 Node.js 环境依赖，可能遇到：

npm 全局目录没有进入 PATH；
Node 版本管理混乱；
全局安装权限错误；
旧版 Codex 没有正确升级；
npm 版和独立安装版同时存在。

因此，新手没有必要专门为了 Codex 安装 Node.js。

也不建议看到权限错误就直接使用：

sudo npm install -g @openai/codex

长期使用 sudo 安装全局 npm 包，可能留下文件归属和权限问题。

优先换用官方独立安装脚本，会更省心。

备选二：Homebrew 安装

macOS 用户已经长期使用 Homebrew，可以运行：

brew install --cask codex

注意是：

--cask

不是普通 formula 安装。

这种方式的优点是软件统一交给 Homebrew 管理，后续升级和卸载比较方便。

三种方式怎么选

安装方式	前置要求	优点	建议
官方独立脚本	无额外包管理器	简单、独立、官方首选	大多数人选它
Homebrew	已安装 Homebrew	软件统一管理	Mac 老用户可选
npm	已安装 Node.js	适合现有 Node 工具链	已经习惯 npm 再选

💡 一句话总结：

macOS 和 Linux 优先运行官方 curl 安装脚本，Windows 用 PowerShell 官方脚本；Homebrew 和 npm 都能装，但属于备选。

04 Windows：原生运行还是 WSL2

Windows 用户通常会遇到一个选择：

Codex 应该直接在 Windows 里跑，还是进入 WSL2 再跑？

现在的答案和早期教程已经不一样了。

Codex 已经支持原生 Windows 沙箱，不再要求 Windows 用户必须安装 WSL。官方目前建议优先使用原生 Windows；只有需要 Linux 工具链、项目本来就在 WSL2，或者原生沙箱无法正常工作时，再选择 WSL2。(OpenAI Developers )

路线一：原生 Windows

原生 Windows 有两种沙箱实现：

模式	特点	建议
`elevated`	独立低权限沙箱用户、文件权限边界和防火墙规则	首选
`unelevated`	使用当前用户派生出的受限令牌和 ACL 边界	elevated 失败时备用

elevated 更强，但首次设置可能需要管理员批准。

公司电脑可能因为以下策略导致它配置失败：

禁止创建本地用户或用户组；
禁止修改防火墙规则；
禁止授予沙箱用户登录权限；
UAC 管理员请求被拒绝；
设备被组织策略统一锁定。

这种情况下，不要反复乱改系统策略。

可以先切换到 unelevated，然后联系公司的 IT 管理员。官方同样把 unelevated 定位为原生强沙箱无法启用时的备用方案。(OpenAI Developers )

Windows 版本要求

当前官方建议使用 Windows 11。

较新的 Windows 10 属于尽力支持，实际要求至少具备现代控制台能力；官方文档指出，Windows 10 通常需要 1809 或更新版本，并建议系统提供 winget。(OpenAI Developers )

因此：

Windows 11：优先；
已完全更新的 Windows 10：可能可用；
很老的 Windows 10：不建议继续折腾，先升级系统。

路线二：WSL2

适合下面这些情况：

项目本来就在 Linux 环境里；
依赖 Linux Shell、包管理器或系统工具；
团队开发环境统一使用 Linux；
原生 Windows 沙箱在公司设备上无法正常工作。

管理员 PowerShell 中运行：

wsl --install

安装完成并按系统提示重启后，进入 WSL：

wsl

进入 Linux Shell 后，再安装 Codex：

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

WSL2 的目录别放错

在 WSL2 中使用 Linux 工具链时，项目最好放在 Linux 家目录：

~/code/my-project

不要长期把大型仓库放在：

/mnt/c/...

Windows 挂载目录可能出现：

文件读写速度较慢；
符号链接行为不同；
权限判断异常；
文件监听器性能下降。

官方同样建议把 WSL 项目放在 /home/... 下，以获得更好的性能和更少的权限问题。(OpenAI Developers )

另外，WSL1 已经不再受到新版本 Codex 支持。Codex 从 0.115 开始在 Linux 沙箱中使用 bubblewrap，需要使用 WSL2。(OpenAI Developers )

💡 一句话总结：

Windows 默认先用原生 elevated 沙箱，失败再退到 unelevated；只有需要 Linux 环境时才选 WSL2，并把项目放进 Linux 家目录。

05 验证安装是否成功

安装完成后，重新打开一个终端窗口。

运行：

codex --version

预期会看到类似：

codex-cli 0.x.x

数字不需要和教程一致。

只要正常显示版本号，就说明：

系统找到了 Codex；
可执行文件能够启动；
PATH 基本正常。

然后运行：

codex --help

你应该能看到当前版本支持的参数和子命令。

查看系统到底调用了哪一个 Codex

macOS、Linux 或 WSL：

command -v codex

想检查是不是装了多个：

which -a codex

Windows PowerShell：

Get-Command codex -All

如果列出多个路径，说明系统里可能同时存在：

官方脚本安装版；
npm 安装版；
Homebrew 安装版；
手工下载的旧二进制。

多个版本同时抢占 codex 命令，可能出现：

明明升级了，版本号却没变；
卸载后命令仍然存在；
不同终端显示不同版本；
某些功能突然消失。

后面排错时，这一步非常有用。

怎样升级

使用什么方式安装，就用什么方式升级。

官方独立脚本

重新运行安装命令即可：

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

npm

npm install -g @openai/codex@latest

Homebrew

brew upgrade --cask codex

官方 CLI 文档目前明确支持通过重新运行独立安装脚本完成更新。(OpenAI Developers )

💡 一句话总结：

codex --version 能显示版本号就说明安装成功；版本不对时，先查系统里是不是藏着多个 Codex。

06 登录：让 Codex 认得你

安装完成后，在终端运行：

codex login

也可以直接进入项目目录运行：

codex

没有有效登录状态时，Codex 会自动进入登录流程。

方式一：使用 ChatGPT 账号

这是大多数人的默认选择。

运行：

codex login

Codex 会：

启动一个本地登录回调；
打开浏览器；
让你登录 ChatGPT；
把认证结果返回给 CLI；
在本地保存登录状态。

ChatGPT 桌面端、CLI 和 IDE 扩展目前都使用浏览器完成 ChatGPT 账号认证。(OpenAI Developers )

适合：

日常本地开发；
使用 ChatGPT 套餐额度；
需要 ChatGPT 工作区能力；
准备使用 Codex Cloud；
想让 CLI 和 IDE 扩展共享登录状态。

方式二：使用 API key

先把 API key 安全地放进环境变量。

macOS、Linux 或 WSL：

export OPENAI_API_KEY="你的_API_Key"

然后运行：

printenv OPENAI_API_KEY | codex login --with-api-key

Windows PowerShell：

$env:OPENAI_API_KEY="你的_API_Key"
$env:OPENAI_API_KEY | codex login --with-api-key

不要直接把真实 API key 写进教程、Git 仓库或公开脚本。

API key 登录的费用从 OpenAI Platform 账户扣除，不会使用 ChatGPT 套餐内的 Codex 额度；某些依赖 ChatGPT 工作区和云端服务的功能可能受限。(OpenAI Developers )

查看当前登录状态

运行：

codex login status

退出登录：

codex logout

登录凭据保存在哪里

Codex 会把登录状态保存在：

操作系统的凭据存储；
或 ~/.codex/auth.json 文件中。

CLI 和 IDE 扩展共享登录缓存。你从其中一边退出，另一边下次启动时也需要重新登录。(OpenAI Developers )

如果你的系统使用文件方式保存：

~/.codex/auth.json

请把它当成密码文件。

它可能包含访问令牌，因此：

不要提交到 Git；
不要上传网盘；
不要粘进报错工单；
不要发给别人；
不要截图公开。

可以在 config.toml 中通过下面的选项控制凭据保存位置：

cli_auth_credentials_store = "keyring"

支持的常见值包括：

file
keyring
auto

💡 一句话总结：

日常使用优先用 ChatGPT 登录，自动化可以使用 API key；auth.json 里可能有访问令牌，必须当密码保护。

07 远程服务器和无浏览器环境怎么登录

在本机电脑上，浏览器登录通常很顺。

但下面这些环境经常卡住：

SSH 远程服务器；
云主机；
没有图形界面的 Linux；
Docker 容器；
浏览器不在运行 Codex 的那台电脑上；
本机网络阻止 localhost 登录回调。

这种情况下，首选设备码登录。

方法一：设备码登录

运行：

codex login --device-auth

它会显示：

一个登录地址；
一次性验证码。

你可以在任意有浏览器的可信设备上：

打开给出的地址；
登录 ChatGPT；
输入一次性验证码；
回到终端等待完成。

设备码登录目前属于 Beta 功能，并且需要先在个人 ChatGPT 安全设置或组织工作区权限中允许。(OpenAI Developers )

方法二：SSH 转发登录回调

如果设备码不可用，可以把远程服务器的本地回调端口转发到自己的电脑。

在本机运行：

ssh -L 1455:localhost:1455 user@remote

进入这个 SSH 会话后，在远程服务器运行：

codex login

然后在本机浏览器打开终端给出的地址。

Codex 当前默认使用：

localhost:1455

接收登录回调。(OpenAI Developers )

方法三：复制登录缓存

还可以先在一台带浏览器的可信电脑上完成登录：

codex login

确认生成：

~/.codex/auth.json

再复制到远程服务器：

ssh user@remote 'mkdir -p ~/.codex'
scp ~/.codex/auth.json user@remote:~/.codex/auth.json

这份文件包含访问令牌，复制过程和目标机器都必须可信。

官方把复制认证缓存列为设备码不可用时的备用方法，并明确要求把 auth.json 当成密码保护。(OpenAI Developers )

对于正式 CI/CD，优先使用 API key 或企业提供的专用访问令牌，不要把个人登录缓存随意塞进公开流水线。

💡 一句话总结：

远程服务器登录先用 codex login --device-auth，不行再考虑 SSH 转发或安全复制认证缓存。

08 动手：从零跑通第一个任务

现在用一个空目录，验证安装、登录、读写和终端执行都正常。

第一步：创建测试目录

macOS、Linux 或 WSL：

mkdir -p ~/codex-test
cd ~/codex-test

Windows PowerShell：

mkdir $HOME\codex-test
cd $HOME\codex-test

第二步：初始化 Git

先创建一个 Git 仓库：

git init

创建一个说明文件：

macOS、Linux 或 WSL：

echo "# Codex Test" > README.md

Windows PowerShell：

"# Codex Test" | Set-Content README.md

提交第一个检查点：

git add README.md
git commit -m "Initial checkpoint"

如果 Git 提示没有配置用户名和邮箱，先按照提示配置，再重新提交。

官方 CLI 快速上手同样建议在任务前后创建 Git 检查点，方便随时回退。(OpenAI Developers )

第三步：启动 Codex

在当前目录运行：

codex

第一次启动没有登录时，按前面的方式完成认证。

进入以后，可以先输入：

/status

确认：

当前目录；
使用的模型；
权限模式；
沙箱状态；
登录方式。

第四步：下达第一个任务

输入：

请创建一个 Python 文件 hello.py。

要求：
1. 定义一个 main 函数；
2. 运行时打印 hello codex；
3. 完成后运行这个文件验证输出；
4. 最后告诉我创建了什么、运行结果是什么。

Codex 可能会：

查看当前目录；
创建 hello.py；
运行 Python；
检查终端输出；
汇报结果。

预期文件内容类似：

def main() -> None:
    print("hello codex")


if __name__ == "__main__":
    main()

预期运行结果：

hello codex

一个必须纠正的误区

不要预设 Codex 每修改一个文件都会先弹出：

是否允许？Yes / No

如果当前使用的是 workspace-write，而且它只修改当前工作区里的文件，这些操作可能直接执行。

只有当它准备：

修改工作区外的文件；
访问受限目录；
使用网络；
执行需要更高权限的命令；
越过当前沙箱边界；

才会根据审批策略停下来询问。

所以真正的安全习惯不是“等每一步都弹窗”，而是：

动手前创建 Git 检查点；
查看它执行的命令；
完成后检查 diff；
跑测试；
确认后再提交。

第五步：检查修改

退出 Codex 后运行：

git status
git diff

查看文件：

cat hello.py

Windows PowerShell：

Get-Content hello.py

确认没有问题后，再提交：

git add hello.py
git commit -m "Add Codex hello example"

到这里，你已经完整跑通：

安装 → 登录 → 进入项目 → 下达任务 → 修改文件 → 执行命令 → 检查 diff → Git 提交

💡 一句话总结：

第一个任务别追求复杂，先用空目录验证完整链路；真正的保险是 Git、diff 和测试，不是幻想每一步都会弹审批框。

09 常见报错速查

报错或现象	常见原因	优先处理方式
`command not found: codex`	安装目录没进 PATH，或终端没有重启	重启终端，查看安装脚本输出，再检查 PATH
Windows 提示找不到 `codex`	PATH 未刷新	重新打开 PowerShell，运行 `Get-Command codex -All`
`irm is not recognized`	在 CMD 中运行了 PowerShell 命令	换到 PowerShell
登录浏览器一直转圈	localhost 回调被拦截	使用 `codex login --device-auth`
API key 登录后部分功能消失	功能依赖 ChatGPT 工作区或云服务	改用 ChatGPT 账号登录
升级后版本号没变	安装了多个 Codex	macOS/Linux 用 `which -a codex`，Windows 用 `Get-Command codex -All`
Windows 沙箱错误 `1385`	系统策略阻止沙箱用户登录	临时使用 `unelevated`，公司设备联系 IT
WSL 中运行很慢	仓库放在 `/mnt/c`	移到 `~/code/...`
公司网络 TLS 报错	企业代理使用自定义根证书	按 IT 要求配置 `CODEX_CA_CERTIFICATE`
`auth.json` 复制后仍未登录	当前系统使用操作系统凭据存储	改用设备码，或明确配置文件凭据存储

坑一：找不到 codex

macOS、Linux 或 WSL：

command -v codex
which -a codex

Windows：

Get-Command codex -All

如果一个路径都没有，说明：

安装没有完成；
或安装目录没有加入 PATH。

如果出现多个路径，则先确认每个版本来自哪里。

例如卸载 npm 版：

npm uninstall -g @openai/codex

卸载 Homebrew 版：

brew uninstall --cask codex

保留一种安装方式即可。

坑二：Windows 沙箱报错 1385

错误 1385 通常不是 Codex 模型坏了，而是 Windows 拒绝了沙箱用户需要的登录类型。

常见于：

公司域策略；
本地安全策略；
禁止特定服务账号登录；
组织策略没有同步完整。

临时可以使用 unelevated 沙箱继续工作，但长期应由 IT 管理员处理策略问题。官方排错指南也建议收集：

CODEX_HOME/.sandbox/sandbox.log

但不要提交：

CODEX_HOME/.sandbox-secrets/

因为其中可能包含敏感数据。(OpenAI Developers )

坑三：企业网络证书错误

公司网络如果通过 TLS 代理检查流量，可能会出现证书验证失败。

按照公司 IT 提供的根证书路径设置：

export CODEX_CA_CERTIFICATE=/path/to/corporate-root-ca.pem
codex login

不要从陌生网站下载所谓“万能证书”，更不要为了省事关闭 TLS 校验。

Codex 官方支持通过 CODEX_CA_CERTIFICATE 或 SSL_CERT_FILE 指定企业根证书。(OpenAI Developers )

💡 一句话总结：

报错先定位环境：找不到命令查 PATH，版本混乱查多重安装，登录失败用设备码，Windows 沙箱问题先看系统策略。

10 小结

这一篇，咱们把 Codex 从“知道是什么”推进到了“机器上真的能跑”。

两条安装路线

macOS 和 Windows 可以使用 ChatGPT 桌面应用里的 Codex；
macOS、Windows 和 Linux 都可以使用 Codex CLI；
Linux 暂时没有官方桌面应用。

CLI 怎么装

macOS / Linux：官方独立安装脚本；
Windows：PowerShell 官方安装脚本；
Homebrew 和 npm：可以使用，但属于备选。

Windows 怎么选

首选原生 Windows；
原生优先使用 elevated 沙箱；
配置失败时使用 unelevated；
只有需要 Linux 工具链时才使用 WSL2；
WSL 项目尽量放在 ~/code/...，不要放在 /mnt/c/...。

怎么登录

日常使用优先选择 ChatGPT 账号；
API key 适合本地程序化工作流和 CI/CD；
远程服务器优先使用设备码登录；
auth.json 必须当密码保护。

怎么验证

codex --version
codex login status
codex

最后再完成一个小任务，检查：

git status
git diff

你现在应该已经能独立完成：

安装 Codex、完成登录、进入项目、运行第一个任务，并处理最常见的安装和认证故障。

这一篇最该带走的经验是：

安装报错不要条件反射地重装。先分清是 PATH、登录、网络、系统沙箱，还是多个版本在打架。

下一篇〈04 · 订阅与计费〉，咱们把钱的事彻底算明白：

ChatGPT 各档套餐怎样使用 Codex；
套餐额度和 Credits 是什么关系；
API key 为什么是另一套账；
什么情况下会触发额外费用；
日常开发到底选套餐还是按 API 用量付费。