Codex 是什么？从理解代码到修改、运行和验证 - AIPlan

Codex 是能在你本地仓库里读文件、改代码、跑命令、看输出的编程工具，不是只会给代码片段的聊天窗口。截至 2026 年 10 月 18 日核对，它有 4 个入口：CLI、桌面版、IDE 扩展和 web，云端任务另外算一路。 和普通聊天最实际的区别 聊天窗口给你的是一段文本，你还得自己复制、找文件、粘进去、跑一遍、把报错贴回去。Codex 把这条链路接上了：它自己读文件、自己改、自己跑，报错自己看。 差别体现在回合数上。一个“给这个接口加参数校验”的任务，聊天窗口大约需要 6 到 10 轮往返，Codex 通常 1 到 2 轮。省的不是打字时间，是你来回切窗口的注意力。 另一个差别是它看的是真实仓库，不是你描述的仓库。你说“用户模块”，它会去找 internal/user/ 而不是照你描述的结构写新代码。 4 个入口各适合什么 入口 适合 不适合 Codex CLI 终端工作流、脚本、CI 需要看图的任务 桌面版 长时间任务、审查面板 无图形界面的服务器 IDE 扩展 边写边改、行内反馈 跨仓库大改 Codex web / 云端 手机上看任务、电脑关机后继续 Free 和 Go 账号 Codex Cloud 在 OpenAI 托管的机器上跑任务，可用性覆盖符合条件 Plus、所有 Pro 档位、Business、Enterprise、Healthcare 和 Education 账号，受推送和工作区设置约束。Free 和 Go 不含云端。 云端有个实用特性：电脑睡眠时任务继续。前提是你先在桌面或 web 上创建并发布一个环境，之后才能在手机上选它。 装 CLI 的 4 条命令 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 用户走 cask： brew install --cask codex 4 种方式装完是同一个东西，升级命令就是重跑安装命令。装完先跑 codex --version 确认版本，Astra 需要 0.153.0 或更新。 第一次登录走 ChatGPT 账号 在项目目录里运行 codex，第一次会问登录方式，选 Sign in with ChatGPT。用 ChatGPT 账号登录走的是你套餐里的用量，用 API key 走的是 API 计价，两条账完全分开。 这个区别常被搞混。官方在定价页写得很直接：API 的 token 价格与订阅用量是两回事，不要拿 API 价格去估算套餐能跑多少任务。 用 ChatGPT 账号时，Codex 的能力跟着套餐走。Free 和 Go 也能用，但 Go 的限制是“轻量编码任务”。Plus 的描述是“每周几次专注的编码会话”，另外包含 web、CLI、IDE 扩展和 iOS。Pro 分 $100、$200、$500 三档。 Astra 看不到就先更新版本 官方说明了两个前置条件：Codex CLI 0.153.0 或更新，桌面 App 也要更新到最新。如果 Chat、Work 或 Codex 里看不到 Astra，从菜单里点 Menu > Check for Updates，即使刚收到过自动更新通知也要点一次，然后完整重启。 Plus 在 Work 和 Codex 里有 Astra，但 Chat 里的 GPT-6 Pro 不包含。Chat 里的 GPT-6 Pro 由 Astra 驱动，只在符合条件的 Pro、Business 和 Enterprise 上提供。 桌面版第一次打开的三个位置 左上角菜单能选 ChatGPT 或 Codex。选 ChatGPT 后，页面顶部有 Chat 和 Work 的切换。Codex 是独立视图，历史和 ChatGPT 的历史分开存。 输入框下方是权限控制。CLI 里对应的命令是 /permissions。默认建议从 Ask for approval 开始，它在超出工作区时暂停。 想在桌面版审查改动，输入 /review，选 Review against a base branch 或 Review uncommitted changes。审查面板只在项目位于 Git 仓库内时可用，没仓库会提示你建一个。 额度在哪里看 Settings > Usage，能看到剩余额度、用量窗口和下次重置时间。Work 和 Codex 共享同一份额度，在任意一边用都从同一个池子扣。 Plus 和标准 Business 席位在 5 小时窗口内的估算范围，官方给的是按模型分的 4 行： 模型 Plus 标准 Business GPT-6 Astra 5–45 5–45 GPT-6.1 Sol 15–160 15–160 GPT-6 Sol 15–150 15–150 GPT-6 Luna 350–3,000 350–3,000 这 4 行数字是估算，不是保证的消息数。Pro 100、Pro 200、Pro 500 目前在 Work 和 Codex 里没有 5 小时限制，但仍有用量上限。 额度用完可以等重置、用保存的重置，或者用 Credits 继续。官方明确说支持不能手动重置额度，只能调查计数错误。 一个 30 分钟的第一次实践 • cd 到仓库根目录，跑 codex，登录 • 输入 Tell me about this project，核对它说的入口文件对不对 • 打一个 Git 检查点 • 让它做一处 1 个文件内的小改动 • 跑 git diff 看差异，跑项目测试看结果 • 再打一个检查点 第 3 步和第 6 步是官方快速上手文档里就建议的动作，理由很直接：改坏了能退回去。 哪些事它做不了 它读不到你没打开的文件，跑不了没装的工具，也看不到你屏幕。云端任务需要先发布环境，本地任务的远程访问需要那台电脑在线且连着。 它也不会替你判断需求对不对。你给的验收标准错了，它会按照错的标准做出一个自洽的实现。判断需求这件事，工具的进步改变不了。 如果你只是偶尔问问题，Plus 和 Go 的差别值得先弄清楚：Go 有 Luna 和 Think，但没有 Codex 额度。订阅和 API 的账怎么算，见 订阅和 API 该选哪个。 $20 的 Plus 按 1 美元 ≈ 6.69 元折算约 ¥133.80，覆盖 CLI、桌面版、IDE 扩展和 iOS 四个入口；¥115.50 的菲区官充 Plus 月卡 走同一套 Codex 能力，付款方式不同。 装完之后别急着上大任务，先把仓库跑通，再往下走，具体步骤在 第一次让 Codex 进入项目要完成的第一步。 参考资料资料核对日期：2026-10-17 • Codex CLI • Permissions 延伸阅读• 第一次让 Codex 进入项目，先跑通一个最小任务 • 给 Codex 下任务怎么写？让目标、边界和验收都可检查 • ChatGPT 订阅和 API 有什么区别？先看你从哪里使用