02 · 装在哪、怎么登录

装 Codex CLI

四种装法，装出来是同一个 codex，挑你顺手的一种就行。

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"

npm

npm install -g @openai/codex

Homebrew

brew install --cask codex

装完验证一下：

codex --version

管道装脚本这件事

curl ... | sh 是官方给的方式，但把远程脚本直接喂给 shell 终归是要信任对面。 在意的话就用 npm 或 Homebrew，或者先把脚本存下来看一眼再跑： curl -fsSL https://chatgpt.com/codex/install.sh -o install.sh。

Windows 上还有一条路是在 WSL 里装，官方有单独的说明； 原生 Windows 沙盒的行为和 macOS/Linux 不完全一样，见 Windows 沙盒。

装别的界面

• IDE 扩展：在编辑器的扩展市场里搜 Codex 安装。
• 桌面应用：macOS / Windows / Linux 都有，从官方快速入门页下载。 Linux 支持哪些发行版、用什么包，看 Linux 桌面应用。

装哪个不冲突，CLI 和桌面应用可以同时用，登录状态各自独立。

登录：两种方式，差别不只是计费

codex login

会开一个浏览器窗口，登完把凭据传回 CLI。这是默认方式。

另一种是 API 密钥：

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

看着只是计费方式不同——订阅 vs 按量——但登录方式还决定了哪套管理规则和数据处理政策适用于你：

	用 ChatGPT 账号登录	用 API 密钥登录
计费	走订阅额度	按用量计费
管理控制	受 ChatGPT 工作空间权限和 RBAC 约束	受你所属 API 组织的设置约束
数据保留 / 驻留	走 ChatGPT Enterprise 的设置	走 API 组织的保留与共享设置
Codex 云端	可用	不可用，云端必须用 ChatGPT 登录
功能完整性	完整	部分功能可能不可用

所以在公司环境里，这一步基本是被替你决定好的：如果团队的权限、审计、数据驻留 都挂在 ChatGPT 工作空间上，那就得用 ChatGPT 账号登录，API 密钥那条路会绕开这些控制。

检查当前登录状态：

codex login status

第一次进去会看到什么

在项目目录里敲 codex，它会先看这个目录是不是 Git 仓库，然后给出不同的默认建议：

• 已纳入版本控制 → 建议 Auto（工作空间可写 + 按需审批）
• 没纳入版本控制 → 建议 read-only（只读）

这个默认值不是随便定的：有 Git 在，你随时能 git diff 看它改了什么、 git checkout 撤回；没有 Git，改错了就是真没了。

先 git init

在没有版本控制的目录里让智能体写文件，等于取消了你的撤销键。 花十秒 git init && git add -A && git commit -m "before codex"，之后每一步都能回退。

下一步

03 · 跑通你的第一个任务。

相关官方文档

• 快速入门
• 身份验证
• 定价与功能可用性
• Linux 桌面应用 · WSL