Appearance
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:
bash
curl -fsSL https://chatgpt.com/codex/install.sh | shWindows PowerShell:
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 的用户 |
验证安装
bash
codex --version预期输出类似 codex-cli 0.139.0。
04 登录
bash
cd /path/to/your-project
codex首次启动引导用 ChatGPT 账号登录,浏览器授权完成即可。
两种登录方式:
| 方式 | 怎么登 | 适合谁 |
|---|---|---|
| ChatGPT 账号(默认) | 启动后选 Sign in with ChatGPT,浏览器授权 | 大多数人、要用云端功能 |
| API key | 选用 API key 登录,从 OpenAI 后台 拿 key | CI/CD、程序化跑 CLI |
远程 / 服务器 / WSL 登录卡住: 用设备码登录
bash
codex login --device-auth会给一个链接和一次性验证码,在任意能上网的浏览器打开、输码即可。
05 Windows 特别说明
| 跑法 | 需要什么 | 什么时候用 |
|---|---|---|
| 原生 + elevated | 管理员批准的沙箱配置 | 默认首选 |
| 原生 + unelevated | 无需管理员级配置 | 公司策略卡住时的退路 |
| WSL2 | 启用 WSL 2 | 需要 Linux 工具链 |
WARNING
WSL1 已被砍(0.114 之后),要用就上 WSL2。代码仓库别放 /mnt/c/... 下(I/O 慢),放 Linux 主目录。
06 动手:从零跑通第一次
bash
mkdir codex-test && cd codex-test
codex首次启动引导登录。登录后在输入框敲:
text
在 test.py 里写一个打印 hello world 的函数预期:Codex 把改动摆给你看,确认后才写文件。exit 退出。
07 小结
| 环节 | 关键动作 |
|---|---|
| CLI 安装 | 官方脚本一条命令 |
| 桌面 App | 下载安装包,双击装 |
| 验证 | codex --version 出版本号 |
| 登录 | codex 启动 → 浏览器登录 |
| 远程环境 | codex login --device-auth |
| Windows | 优先原生 elevated |
NOTE
下一篇:03 核心概念:代理循环、沙箱、审批、AGENTS.md——后面天天打交道的词一次讲透。