Codex 怎么用？CLI 安装、ChatGPT 登录与额度入门

Codex 是 OpenAI 的编程智能体：能读仓库、改代码、跑命令、审查改动。日常入口有四个——命令行 CLI、IDE 扩展、ChatGPT 桌面应用，以及网页版 Cloud。本文按官方文档，带你从安装、ChatGPT 登录到额度查看走完第一遍，并说明 12 月起 Plus/Pro/Business 与 ChatGPT 共用额度的变化。

1. Codex 是什么，能在哪里用？

官方把 Codex 描述为编程智能体：在本地或云端检查代码、做修改、运行已安装的工具，并在你确认后再采纳改动。常见入口：

• Codex CLI：在终端里跑 codex，适合不离开命令行的工作流。
• IDE 扩展：VS Code、Cursor、Windsurf 等可装 Codex 扩展；Xcode、JetBrains 有各自集成。
• ChatGPT 桌面应用：应用内的 Codex 模式，可配合本地权限与浏览器能力。
• Codex Cloud（网页）：任务跑在 OpenAI 托管环境，电脑休眠也能继续；需符合套餐资格。

本地客户端（桌面、CLI、IDE）支持用 ChatGPT 登录，也支持用 API Key；Cloud 必须用 ChatGPT 登录。

2. 哪个会员档位够用？Cloud 谁能开？

帮助中心写明：Codex 包含在各档 ChatGPT 套餐中，含 Free 与 Go。额度随档位变化，具体以账号里的用量面板为准。定价页对个人档的定性是：

• Free / Go：有限的试用式 Codex 访问，用来试能力。
• Plus：每周能支撑若干次专注编程会话；可用 Codex 桌面应用，并可接插件。
• Pro：面向每天更长、更重的会话，Codex 任务额度更高。

Codex Cloud：仅对符合条件的 Plus、全部 Pro 档、Business、Enterprise、Healthcare、Education 开放（受 rollout 与工作区设置影响），不含 Free 与 Go。Guest、K–12、Enterprise 只读席位不能创建云端环境。

站内参考价（核对于 2026-11-06 商品页）：Go ¥80、Plus ¥165、Pro 100 ¥800。美元官网价仍以 openai.com/chatgpt/pricing 为准。选档细节见第 93 篇，本文不重复展开。

3. 安装 Codex 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"

也可以用包管理器：

npm install -g @openai/codex
brew install --cask codex

1. 装好 CLI：任选上面一种方式，装完在终端执行 codex --version（或直接 codex）确认命令可用。
2. 进入项目目录：cd 到你要改的仓库根目录再启动，这样上下文才对准。
3. 首次启动：运行 codex，按提示选择登录方式。

IDE 用户：在 VS Code / Cursor / Windsurf 安装 Codex 扩展后，点侧栏 Codex 图标；找不到就用命令面板运行 “Codex: Open Codex Sidebar”。

4. 用 ChatGPT 登录（推荐）

官方默认路径是 Sign in with ChatGPT：打开浏览器完成授权后，凭证会回到本地客户端。CLI 也可单独执行：

codex login

1. 发起登录：运行 codex 或 codex login，选择用 ChatGPT 登录。
2. 浏览器授权：在弹出的页面登录你的 ChatGPT 账号并确认授权。
3. 回到终端：授权成功后 CLI/IDE 会缓存登录状态；CLI 与 IDE 扩展共用同一份缓存。
4. 无头/远程环境：浏览器回调不通时，可用设备码登录（需在 ChatGPT 安全设置里开启）：codex login --device-auth。

凭证可能写在 ~/.codex/auth.json 或系统钥匙串。官方提醒：把它当密码对待，不要提交到 Git，也不要粘到工单或聊天里。查看状态用 codex login status，退出用 codex logout。

5. 备选：用 API Key 登录

适合 CI/CD 或只要本地、按量计费的场景。CLI 示例：

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

费用走 OpenAI Platform 的 API 账单，按 API 价计费，不消耗 ChatGPT 会员附带额度。API Key 路径下，依赖 ChatGPT 工作区或云端能力的功能会受限或不可用；Cloud 本身也不支持仅靠 API Key。

6. 第一次任务：怎么问、怎么看额度

登录后，用自然语言描述目标即可，例如「解释这个项目的结构」或「复现并修复这个报错，跑通相关测试」。官方建议大改前先做 Git 提交，方便回退。

• /init：生成项目级 AGENTS.md，写入结构、启动/测试命令与规范，之后 Codex 会优先读它。
• /status：在活跃 CLI 会话里查看当前配置与剩余额度。
• /permissions：设定改文件、跑命令要不要先问你。
• /model：切换模型与推理强度；快到限额时可改用更省额度的模型。
• /review：只审查改动、不改工作区。

用量也可在 Codex usage dashboard 或 ChatGPT 的 Settings → Usage 查看。帮助中心说明：ChatGPT 登录时，auto-review 安全检查免费，不计入套餐用量。

7. 12 月起：ChatGPT 与 Codex 共用额度

OpenAI 帮助中心（Understanding ChatGPT and Codex usage limits）写明：从 12 月起，Plus、Pro、Business 的用量将在 ChatGPT 与 Codex 之间按 token 共享，以便把 Work 的智能体能力并入主 ChatGPT 体验。Instant 即时对话不占用这份用量。合并后可在 Settings → Usage 看剩余额度与重置时间；用尽后可等待重置、升级，或购买 credits。更早的说明也写在站内Codex 插件与额度合并相关文章的更新提示里。