官方原文索引： Codex Overview / What is Codex / CLI Introduction
1. 核心架构与原理解析
Codex 不是 ChatGPT 的终端版。 它是 OpenAI 推出的终端原生自主编程 Agent（Autonomous Coding Agent），核心差异在于：
| 维度 | ChatGPT（网页） | Codex CLI |
|---|---|---|
| 执行位置 | 云端对话 | 本地终端 |
| 文件操作 | 手动上传/下载 | 直接读写本地文件 |
| 命令执行 | 不可执行 | 可运行 Shell 命令 |
| 会话持久化 | 云端存储 | 本地 .codex/sessions/ |
| 定位 | 问答顾问 | 结对编程搭档 |
Codex 的三种形态：
Agentic Workflow 执行拓扑：
🛠️ 专家视角 / 架构思考： Codex 的设计哲学是 "Local-first, Cloud-reasoned"——源码永不出境，只有 Prompt 和必要的文件摘要上传至 OpenAI 云端。这意味着：
- 你的
.env文件、密钥、数据库连接字符串默认不会被上传（除非显式@引用）- 企业内网可通过
OPENAI_BASE_URL指向私有 API 网关，实现完全合规- 与 Cursor、Windsurf 等 IDE 插件相比，Codex CLI 的 Agentic 能力更强（可执行命令、运行测试），但交互门槛更高
2. 工程落地：选择你的入口
# 场景 1：快速体验（macOS / Windows）
# 下载 Codex App → 图形界面管理任务
# 场景 2：日常开发（全平台）
npm install -g @openai/codex
codex
# 场景 3：IDE 内嵌（VS Code / Cursor）
# 扩展商店搜索 "OpenAI Codex" 安装订阅要求：
| 计划 | Codex 访问 | 备注 |
|---|---|---|
| ChatGPT Free | 有限访问 | 额度受限 |
| ChatGPT Plus ($20/月) | 完整访问 | 推荐个人开发者 |
| ChatGPT Pro ($200/月) | 完整 + 高用量 | 含 GPT-5.3-Codex-Spark |
| Business / Enterprise | 按席位 | 含合规日志平台 |
模型选型速查：
| 模型 | 上下文 | 速度 | 成本 | 适用场景 |
|---|---|---|---|---|
| GPT-5-Codex | 200K | 中等 | 高 | 复杂重构、架构设计 |
| GPT-5.3-Codex | 128K | 快 | 中 | 日常开发、Bug 修复 |
| GPT-5.3-Codex-Spark | 128K | 极快 | 低 | 代码审查、简单问答 |
3. 场景深入：Codex 在真实工作流中的定位
场景 A：个人开发者快速原型
场景 B：企业代码审查流水线
场景 C：遗留系统现代化
4. 💡 核心避坑与最佳实践 (Takeaways)
- 不要混淆 Codex CLI 与旧的 Codex API：后者是 2021 年已弃用的代码补全 API，前者是 2025 年推出的 Agentic 编程工具
- Node.js >= 22 是硬门槛：低于此版本安装会静默失败，建议用 nvm 管理
- Windows 用户优先用 App：原生 CLI 仍在实验阶段，WSL2 是更稳的选择
- 免费额度会快速耗尽：重度使用者建议直接上 Plus 或配置 API Key 按量计费
- Codex 不是替代你写代码：它是放大器——你越清楚需求，它产出越精准