想在 2026 年最快把 Codex 用起来，结论很直接：先确认自己的 ChatGPT 套餐或准备好 API Key，再按操作系统选一条安装命令装好 CLI，首次启动用 ChatGPT 账号或设备码登录，最后进到项目目录跑第一个任务即可。Codex 不是一个孤立软件，而是 OpenAI 的一套 AI 编码代理，目前有 CLI（终端版）、桌面端、网页端（含 Codex Cloud）和 IDE 扩展几个入口，它们共用同一套账号和额度，区别只在于任务在哪里执行，所以入门阶段不用纠结 "装哪个"，先把最通用的 CLI 跑通，再按需补其他端。之所以要先看套餐再动手，是因为 CLI 的使用权限和订阅绑定，免费档只能在桌面端体验、不能在 CLI 里用，装完发现没权限会白跑一趟；整个过程只需要三步：选安装方式 → 完成认证登录 → 进入项目跑任务，做完这三步，你就已经具备独立使用 Codex 的基础。
一、先搞清楚：Codex 有哪些版本入口
Codex 2026 年已经形成 "四端一云" 的格局，新手最容易混淆的就是入口，先对照下表选一个起点：
| 入口 | 形态 | 任务执行位置 | 适合人群 |
|---|---|---|---|
| Codex CLI | 终端命令行，开源（Apache-2.0）单文件 Rust 二进制 | 当前终端所在的本地目录 | 习惯命令行、要接脚本 / CI、批量改代码的开发者 |
| 桌面端 App | macOS / Windows / Linux 图形客户端 | 分 Local（本机）、Worktree（Git 隔离分支）、Cloud（云端）三种模式 | 想边看文件边审 diff、同时管多个工作区的人 |
| 网页端 / Codex Cloud | 浏览器内 ChatGPT 项目与云端环境 | 云端沙箱，电脑休眠任务继续跑 | 长任务、并行任务、连 GitHub 仓库自动改代码 |
| IDE 扩展 | VS Code / JetBrains 等编辑器插件 | 跟随本地项目 | 不想离开编辑器、边写边调的人 |
入门建议：优先装 CLI，因为它命令统一、更新最快（2026 年 11 月最新稳定版已到 0.167.x），桌面端和网页端后续按需再加。
二、安装前：环境与套餐核对
1. 系统要求（官方 install 文档口径）
- 操作系统：macOS 12 及以上；Ubuntu 20.04+ / Debian 10+；Windows 11 走 WSL2 最稳妥，同时也提供原生 PowerShell 安装器。
- 内存：最低 4 GB，推荐 8 GB。
- Git：建议 2.23+，用于内置的 PR 辅助能力。
- Node.js：只有选 npm 安装方式时才需要，且建议 22 及以上版本；用官方安装脚本则不需要。
2. 套餐与计费（决定能不能登录使用）
- ChatGPT Plus、Pro、Business、Enterprise、Edu 套餐：可在订阅额度内直接使用 CLI，无额外按量计费。
- Free / Go 套餐：只能在桌面端体验 Codex，不能用于 CLI。
- API Key 方式：按 token 用量付费，适合不想订阅或做集成的人，但部分依赖 ChatGPT 工作区和 Cloud 的能力不可用。
- 注意：OpenAI 在 2026 年 11 月宣布，12 月起 Plus / Pro / Business 三档的 ChatGPT 与 Codex 额度合并为一个池子、统一按 token 计量，订阅前建议看一眼当期官方说明。
三、下载与安装：四种方式任选一条
打开终端，按你的系统选下面任意一种，效果相同：
- 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（需要 Node.js 22+）
npm install -g @openai/codex
- Homebrew（macOS）
brew install --cask codex
也可以直接从 GitHub Releases 下载对应平台的压缩包（如 Apple Silicon 的 codex-aarch64-apple-darwin.tar.gz），解压后把二进制文件改名为 codex 放进 PATH 即可。安装脚本优先从 releases.openai.com 拉取，网络不通时会自动回退到 GitHub Releases；如果两者都被拦，可以设置环境变量 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false 强制直连 GitHub。
装完验证（必做）
codex --version 打印 codex-cli 和版本号
codex doctor 检查凭证、磁盘、Git、网络、搜索工具等
全新安装时 codex doctor 报 auth 失败是正常的，下一步登录就会修好。
四、登录认证：三种方式按场景选
运行 codex（或 codex login），首次启动会让你选认证方式：
| 登录方式 | 原理 | 适用场景 |
|---|---|---|
| Sign in with ChatGPT | 自动打开浏览器走 OAuth 授权，凭证缓存在 ~/.codex | 本地有浏览器、有订阅的默认选择 |
| Sign in with Device Code | 给出一次性码，在另一台设备上输入完成授权 | 远程 SSH 服务器、无浏览器环境 |
| API Key | printenv OPENAI_API_KEY | codex login --with-api-key，按 token 计费 | 无订阅、做自动化集成 |
常用登录管理命令：
codex login status 查看当前认证方式
codex logout 清除本地凭证
小提示：自定义了 CODEX_HOME 的话，每个 shell 都要保持一致，因为凭证存在这个目录里。
五、第一次上手：跑通你的第一个任务
- 先 cd 进项目仓库，建议先 git status 确认干净并提交一次，方便随时回滚。
- 启动交互式会话：
codex
或显式指定目录
codex -C /path/to/repository
- 先让它做一件小而边界清晰的事，比如 "先通读项目并说明结构"，确认理解无误再要求改代码。
- 默认是 Auto 权限档：可以在工作目录内读写文件、跑命令，但动目录外内容或联网都要先问你；只想要方案不想让它动手时，用 /permissions 切成只读。
高频命令清单
| 命令 | 作用 |
|---|---|
| codex | 交互式开发会话 |
| codex exec "任务描述" | 非交互执行，适合脚本和 CI |
| codex resume | 恢复最近或指定会话 |
| codex review | 审查本地改动 |
| codex update | 更新 CLI（npm 用 npm install -g @openai/codex，brew 用 brew upgrade --cask codex） |
两个上手技巧：在仓库根目录放一个 AGENTS.md，写上构建、测试、代码风格规则，每次会话都会读取；模型如果被固定成旧款，记得用 /model 或 codex --model gpt-6-sol 切换（旧款模型会陆续停用）。
六、常见报错与排查
- codex: command not found：重开终端让 PATH 生效；npm 装的检查全局 bin 是否在 PATH；二进制包确认已改名 codex 并 chmod +x。
- npm 报 EACCES 权限错误：不要用 sudo npm，改用官方安装脚本，或把 npm 前缀指到用户目录。
- 服务器上登录卡住：改用 Device Code，或直接用 API Key 管道登录。
- 企业网络 / 代理下 WebSocket 失败：CLI 通常可回退 HTTPS，检查代理、VPN 和自定义 CA 配置。
- 装完想彻底清理：卸载命令对应安装方式，再删除 ~/.codex 目录即可。
【常见问题】
问题 1：Codex CLI 怎么下载安装？
回答 1：Codex CLI 在 macOS / Linux 用 curl -fsSL https://chatgpt.com/codex/install.sh | sh，Windows 在 PowerShell 跑官方安装脚本，也可以 npm install -g @openai/codex 或 brew install --cask codex，装完用 codex --version 和 codex doctor 验证。
问题 2：Codex 免费就能用吗？要不要先订阅？
回答 2：Codex CLI 本身开源免费下载安装，但使用需要 ChatGPT Plus / Pro / Business / Enterprise 订阅额度，或者用 API Key 按 token 付费；Free、Go 套餐只能在桌面端体验 Codex，不能在 CLI 里登录使用。
问题 3：没有浏览器的服务器上怎么登录 Codex？
回答 3：在 codex login 里选 Sign in with Device Code，把一次性验证码拿到另一台设备输入即可；也可以用 printenv OPENAI_API_KEY | codex login --with-api-key 直接走 API Key 登录，登录后用 codex login status 确认状态。
问题 4：Codex 的桌面端、网页端和 CLI 有什么区别，新手先装哪个？
回答 4：三者共用同一账号额度，区别在任务执行位置：CLI 在本地终端目录运行，桌面端分 Local / Worktree / Cloud 三种模式，网页端走 Codex Cloud 云端沙箱；新手建议先装 CLI 跑通流程，再按需求补桌面端或网页端。
问题 5：Codex 装完怎么更新和卸载？
回答 5：官方安装脚本装的运行 codex update 或重跑脚本即可；npm 版重装 npm install -g @openai/codex，brew 版 brew upgrade --cask codex；卸载对应执行 npm uninstall -g @openai/codex 或 brew uninstall --cask codex，再视情况删除 ~/.codex。
【参考资料】
- [2026-11-12]（@openai/codex npm 包页面：安装命令与版本信息）npm
- [2026-11-11]（Codex Release Notes & Changelog · November 2026）Releases.sh
- [2026-11-06]（Codex CLI 0.167.0 Ships a No-Daemon Agent Command Center）Automater News
- [2026-11-04]（Codex 产品分析：从写代码的助手到别人产品里的一个零件）今日头条・人人都是产品经理
- [2026-10-22]（2026 Codex 三端完整指南：桌面端、CLI 与网页端怎么选）稀土掘金
- [2026-10-12]（How to Install Codex CLI (2026): Setup, Sign-in and First Run）OpenAgents Blog
- [2026-09-18]（ChatGPT Enterprise and Edu Release Notes：Codex CLI 0.154.0 worktrees）OpenAI Help Center
- [2026-08-25]（openai/codex 官方 install.md：系统要求与安装方式）GitHub
- [2026-07-21]（Codex 全网最全指南：安装、登录、国内登录问题解决）稀土掘金
- [2026-05-02]（Codex 保姆级入门教程：环境要求与安装）今日头条・程序员小灰
【免责声明】
本文基于 2026 年 11 月公开可查的官方文档与社区资料整理，Codex 的版本号、套餐权益、额度规则和登录方式更新频繁，具体以 OpenAI 官方文档与你当期订阅页面为准；文中命令在不同系统、网络环境下可能存在差异，操作前请备份代码，涉及 API Key、订阅付费的决策请自行评估风险，本文不构成任何付费或代购建议。