02 · 安装、登录与运行形态

📚 系列导航：上一篇 01 是什么 讲清了 Codex 是什么。这一篇带你装好它、登录、跑通第一次。

---

01 装之前确认三件事

系统要求： macOS / Windows / Linux 均可。CLI 三平台全支持，桌面 App 仅 Mac/Windows。

账号要求： Codex 跟着 ChatGPT 套餐走。Plus、Pro、Business、Enterprise 都包含 Codex 用量。也可以用 OpenAI API key 按量计费——但 API key 登录时部分功能受限（云端 Codex 强制要 ChatGPT 登录）。

网络要求： 全程需要魔法上网。装的时候、登录的时候、平时跑任务都得挂着。

---

02 桌面 App（Mac / Windows）

下载：打开 chatgpt.com/codex，下载对应平台安装包。

平台	注意
macOS（Apple Silicon）	直接下载默认包
macOS（Intel 芯片）	选 Intel build
Windows	下载官网安装包
Linux	暂无桌面 App，用 CLI

装好后打开，登录、选项目文件夹、确认左下角选的是 Local（本机干活），发第一条消息。

---

03 CLI 安装

首选：官方脚本（独立二进制，最干净）

macOS / Linux：

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

Windows PowerShell：

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

备选方式

方式	命令	适合人群
Homebrew（macOS）	brew install --cask codex	重度 brew 用户
npm	npm install -g @openai/codex	习惯 npm 的用户

验证安装

codex --version

预期输出类似 codex-cli 0.139.0。

---

04 登录

cd /path/to/your-project
codex

首次启动引导用 ChatGPT 账号登录，浏览器授权完成即可。

两种登录方式：

方式	怎么登	适合谁
ChatGPT 账号（默认）	启动后选 Sign in with ChatGPT，浏览器授权	大多数人、要用云端功能
API key	选用 API key 登录，从 OpenAI 后台 拿 key	CI/CD、程序化跑 CLI

远程 / 服务器 / WSL 登录卡住： 用设备码登录

codex login --device-auth

会给一个链接和一次性验证码，在任意能上网的浏览器打开、输码即可。

---

05 Windows 特别说明

跑法	需要什么	什么时候用
原生 + elevated	管理员批准的沙箱配置	默认首选
原生 + unelevated	无需管理员级配置	公司策略卡住时的退路
WSL2	启用 WSL 2	需要 Linux 工具链

WARNING

WSL1 已被砍（0.114 之后），要用就上 WSL2。代码仓库别放 /mnt/c/... 下（I/O 慢），放 Linux 主目录。

---

06 动手：从零跑通第一次

mkdir codex-test && cd codex-test
codex

首次启动引导登录。登录后在输入框敲：

在 test.py 里写一个打印 hello world 的函数

预期：Codex 把改动摆给你看，确认后才写文件。exit 退出。

---

07 小结

环节	关键动作
CLI 安装	官方脚本一条命令
桌面 App	下载安装包，双击装
验证	codex --version 出版本号
登录	codex 启动 → 浏览器登录
远程环境	codex login --device-auth
Windows	优先原生 elevated

NOTE

下一篇：03 核心概念：代理循环、沙箱、审批、AGENTS.md——后面天天打交道的词一次讲透。