OpenAI Codex 指南：CLI、IDE 插件和 Codex Cloud
最后核对：2026-11-09 · 来源：Codex CLI 文档↗、Codex 价格与用量↗、IDE 插件↗、Codex Cloud↗、GitHub openai/codex↗
#快速回答：Codex 是什么？怎么装？要花多少钱？
Codex 是 OpenAI 的编程 Agent：它读你的仓库、改文件、跑命令，最后把 diff 交给你审。同一个账号可以在四个地方用：终端里的 Codex CLI、VS Code 系编辑器里的 IDE 插件、ChatGPT 里跑在云端的 Codex Cloud，以及 ChatGPT 桌面 App。CLI 用 Rust 写成，在 GitHub 上以 Apache-2.0 开源。
截至 2026-11-09：
- 安装：
npm install -g @openai/codex或brew install --cask codex，当前版本 0.167.0；也有官方安装脚本 - 完整 CLI / IDE / 云端从 ChatGPT Plus 开始：Plus $20/月，可用 GPT-6.1 Sol 和 GPT-6 Luna
- Free（$0）和 Go（$8/月）：只在桌面 App 里提供 GPT-6 Luna（标准速度，逐步开放）
- Pro：$100、$200、$500 三档/月，官方写明目前没有 5 小时限额
- Business：年付每人每月 $20（至少 2 人），月付 $25；Enterprise / Edu 联系销售
- API key：按 API 价格计费，例如
gpt-6.1-sol每百万 token 输入 $2 / 输出 $10
#Codex 现在有哪几种用法？
| 入口 | 跑在哪里 | 适合做什么 |
|---|---|---|
| Codex CLI | 你的电脑，直接操作本地仓库 | 日常改代码、调试、codex exec 接进脚本和 CI |
| IDE 插件 | VS Code、Cursor、Windsurf、VS Code Insiders；Xcode 和 JetBrains 用各自的内置集成 | 不离开编辑器，边看代码边派任务 |
| Codex Cloud | OpenAI 的云端环境，连你的 GitHub 仓库 | 把任务丢到云上跑，电脑休眠也继续；审完直接提交或开 PR |
| ChatGPT 桌面 App | 本机，带原生沙箱 | 不想开终端的人；Windows 上支持 PowerShell |
本地和云端可以互通：在终端里用 codex cloud 就能查看云端任务、提交新任务，并把结果应用到本地仓库。
#怎么安装 Codex CLI？
任选一种：
bash# macOS / Linux：官方安装脚本（再跑一次就是升级） curl -fsSL https://chatgpt.com/codex/install.sh | sh # npm npm install -g @openai/codex # Homebrew brew install --cask codex brew upgrade --cask codex
Windows PowerShell：
powershellpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
然后进项目目录运行 codex。第一次会让你选 Sign in with ChatGPT 或其他登录方式（例如 API key）。第一个任务可以就问：
textTell me about this project
动手改代码前先提交一次 Git，改完再提交一次，这样随时能回滚。官方最佳实践也是这么建议的。
#Plus 方案每 5 小时能用多少？
官方给的是 Plus 和 Business 标准席位的本地消息估算区间（每 5 小时）：
| 模型 | 每 5 小时本地消息 |
|---|---|
| GPT-6 Astra | 5–45 |
| GPT-6.1 Sol | 15–160 |
| GPT-6.1 Terra | 35–285 |
| GPT-6 Sol | 15–150 |
| GPT-6 Luna | 350–3,000 |
区间很宽，是因为一条消息读多少文件、跑多少命令差别很大。云端任务比本地消息更耗额度，另外还可能有周限额，官方没有给具体数字。GPT-5.5 已于 2026-10-14 从 ChatGPT 登录的 Codex 中下线（API key 会话不受影响）。
#AGENTS.md 怎么写、放在哪？
AGENTS.md 是给 Codex 的项目说明书：构建和测试命令、目录约定、哪些地方不能碰。Codex 每次启动都会读。
读取顺序（来自官方文档）：
- 全局：
~/.codex/AGENTS.override.md，没有就读~/.codex/AGENTS.md（设置了CODEX_HOME则读那个目录） - 项目：从项目根目录（通常是 Git 根）一路往下到你当前所在目录，每一层依次找
AGENTS.override.md、AGENTS.md，再找project_doc_fallback_filenames里配置的文件名，每层最多取一个 - 所有文件按从根到当前目录的顺序拼起来，越靠近当前目录的越后出现，优先级越高
- 合计上限
project_doc_max_bytes默认 32 KiB，超出部分不再加载
一个够用的起步版本：
markdown# AGENTS.md ## Commands - Install: pnpm install - Test one file: pnpm jest path/to/file.test.ts - Lint: pnpm eslint --max-warnings 0 <changed files> ## Rules - TypeScript strict; no `any` in new code - Do not edit generated files under src/generated/ - Never run database migrations against production
想让 Codex 也读团队已有的说明文件，在 ~/.codex/config.toml 里加：
tomlproject_doc_fallback_filenames = ["TEAM_GUIDE.md", ".agents.md"] project_doc_max_bytes = 65536
检查到底加载了哪些说明：
bashcodex --ask-for-approval never "Summarize the current instructions." codex --cd services/payments --ask-for-approval never "List the instruction sources you loaded."
#权限和沙箱怎么设？
Codex 用“沙箱模式 + 审批策略”两个开关控制它能做什么：
| 组合 | 命令 | 效果 |
|---|---|---|
| Auto（Git 仓库里的默认） | codex --sandbox workspace-write --ask-for-approval on-request | 工作目录内可读写、可跑命令；改目录外文件或要联网时先问你 |
| 只读 | codex --sandbox read-only --ask-for-approval on-request | 只看不改，适合先讨论方案；非 Git 目录默认就是只读 |
| 完全放开 | --yolo | 不设沙箱，不建议在自己的主力机器上用 |
几个容易踩的点：
workspace-write默认不联网，npm install这类命令会被拦，要在配置里打开网络- 工作目录里的
.git、.codex、.agents永远是只读的，Codex 改不了你的 Git 历史和自己的配置 - 旧的
approval_policy = "untrusted"已经不再支持 - 会话里随时用
/permissions切换，用/model换模型和推理强度
#配置文件在哪？
个人默认配置在 ~/.codex/config.toml；项目级覆盖放在仓库里的 .codex/config.toml（只有你信任该项目时才加载）。CLI、IDE 插件和桌面 App 共用同一套配置层。官方示例：
tomlmodel = "gpt-6.1-sol"
常用命令速查：
| 命令 | 作用 |
|---|---|
codex | 在当前目录开交互会话 |
codex exec "..." | 非交互执行，适合脚本和 CI |
codex resume | 回到之前的会话 |
codex --image err.png "..." | 带截图提问 |
codex --search | 这次运行允许实时联网搜索 |
codex cloud | 查看 / 提交云端任务，把结果应用到本地 |
codex mcp | 添加和查看 MCP server |
/review | 让 Codex 审当前改动，只报问题不改文件 |
在 GitHub PR 里评论 @codex review，可以让云端 Codex 审这个 PR。
#Codex、Claude Code、Cursor 怎么选？
| OpenAI Codex | Claude Code | Cursor | |
|---|---|---|---|
| 形态 | CLI + IDE 插件 + Codex Cloud + ChatGPT 桌面 App | CLI + VS Code / JetBrains 插件 + 桌面 App + 网页 | 编辑器（基于 VS Code）+ CLI（agent）+ Cloud Agent |
| 项目说明文件 | AGENTS.md（默认上限 32 KiB） | CLAUDE.md，也能读仓库里的 AGENTS.md | .cursor/rules/*.mdc 或 AGENTS.md |
| 模型 | OpenAI 自家 GPT-6 / 6.1 系列 | Anthropic 自家 Claude 系列 | 多家可选：Composer 2.5、Claude、GPT、Gemini、Grok |
| 个人最低完整可用价 | ChatGPT Plus $20/月 | Claude Pro $20/月（年付折合 $17） | Free $0；Plus $8/月只能用 Grok；Premium $30/月起可用第三方模型 |
| 按量计费 | 可以用 OpenAI API key | 可以用 Console API key | 超出方案额度按 token 计费 |
价格截至 2026-11-09，来源见 Claude 价格↗、Cursor 价格↗。
我的判断：
- 已经付了 ChatGPT Plus：先用 Codex，不用再多一份订阅；云端任务和 GitHub PR 审查是它最省事的地方
- 团队主力在终端、看重长链路任务的稳定性：Codex 和 Claude Code 都值得拿同一个真实任务各跑一遍再定，别只看排行榜
- 更习惯在编辑器里边看边改：Cursor 的体验更顺；而且 Codex 插件本身就能装进 Cursor
三个工具的项目说明文件都能用 AGENTS.md，团队规范写一份就能三边共用。
#常见问题
#Codex 和 2021 年那个 Codex 模型是一回事吗？
不是。2021 年的 Codex 是一个代码补全模型，早已停用。今天的 Codex 是 OpenAI 的编程 Agent 产品，底层用的是当前的 GPT 模型。
#公司代码能放进 Codex Cloud 吗？
Codex Cloud 需要连接 GitHub 仓库，并在云端环境里安装依赖、跑测试。涉及敏感代码时先让管理员确认 ChatGPT 工作区的数据和网络策略；只想本地跑，就只用 CLI 或 IDE 插件。
#Free 账号能用 Codex CLI 吗？
截至 2026-11-09，官方价格页只写了 Free 和 Go 能在桌面 App 里用 GPT-6 Luna（逐步开放）。要在 CLI、IDE 和网页里完整使用，从 Plus 开始；或者用 API key 按量付费。
