Codex CLI 是 OpenAI 开源的本地智能体编程工具，它在 2026 年围绕”agentic coding（智能体式编码）”工作流彻底重建——你给它一张设计稿或一句需求，它自己拆待办、读代码、改文件、跑测试，把过去要人盯一整天的编码任务压成一条命令端到端交付。
Codex 家族里，CLI 处在什么位置
Codex 现在是一个产品系列：Codex CLI（终端）、 Codex IDE 扩展（VS Code / Cursor）、 Codex 云环境，以及背后统一的 Codex 框架（agent loop）。 CLI 是离开发者最近、最轻量的入口，开源在 github.com/openai/codex，所有能力都基于同一套 agent loop 。可以把 CLI 理解成”把前沿编码模型直接接进你本地终端的驾驶舱”。
这次重建，到底新在哪
- 图片上下文：可以直接把截图、线框图、架构图贴进 CLI，让模型基于同一份视觉上下文理解设计意图。
- 待办清单：复杂任务会自动拆成 to-do，逐步推进，你随时能看到进度。
- Web 搜索与 MCP：内置 web search，并能通过 MCP 连外部系统，工具调用更准。
- 三级审批模式：见下表，从最保守到最放手逐级放开。
- 会话压缩：长会话自动 compact，状态不丢、上下文不爆。
| 模式 | 范围 | 适合场景 |
|---|---|---|
| 只读 + 显式批准 | 只能在 workspace 内读，改动作逐个确认 | 第一次跑陌生仓库 |
| 自动（auto） | 完整 workspace 访问，workspace 外需批准 | 日常功能开发 |
| 完全访问 | 可读任意文件、带网络跑命令 | 可信环境批量重构 |
30 秒上手
- 用 npm 全局安装：npm install -g @openai/codex（需要 Node 18+）。
- 登录：在 ChatGPT 里开启 Codex，CLI 首次运行会引导你用 ChatGPT 账号授权。
- 进入项目目录，跑 codex 进入交互；或单行执行 codex “把 utils/format.ts 里的日期格式改成 ISO 8601 并补一个单测”。
- 用 /approval 切换审批模式，用 /personality 在”简洁务实”和”爱聊”两种风格间切换。
一个真实例子：改函数 + 跑测试
假设你让 Codex 给一个解析函数加边界处理，它会：读相关文件 → 改实现 → 写/改测试 → 跑 npm test → 把 diff 和测试结果汇报给你。关键是你不用手写样板，模型自己维护待办并检查。
# 单行模式：给需求，Codex 端到端处理
codex "在 src/parser.ts 的 parseAmount 中处理空字符串和千分位，
并补一个覆盖这两种情况的单元测试，跑通 npm test 后再停"
# 交互模式
codex
> /approval auto
> 把登录接口的超时从 5s 调到 30s，并加一个重试最多 3 次的实现官方明确建议：GPT-5-Codex 这类模型只用于 Codex 或类 Codex 的 agentic coding 环境，不要用它做通用聊天。选对模型，质量和安全性都更稳。
什么时候该用，什么时候先别
适合 Codex CLI 的场景
- 跨多文件的重构、迁移
- 批量补测试、改样板
- 给 PR 做自动代码评审（Codex 现在内置 code review，会对照 PR 意图、跑测试找关键缺陷）
- 在 GitHub 上委派重复但重要的任务
暂时不适合的场景
- 你对仓库完全不熟悉、又没有测试兜底时，先用只读 + 显式批准模式
- 涉及生产密钥、对外网络的操作，务必留在沙箱或限定 workspace
常见问题
Codex CLI 和 Claude Code 有什么区别？
两者都是终端智能体编程工具，都把”读代码—改文件—跑命令”串成 agent loop 。 Codex CLI 开源、深度绑定 OpenAI 的 Codex 模型与 ChatGPT 账号体系，并内置 code review 与 GitHub 集成；Claude Code 则绑定 Anthropic 模型、强调子代理与权限分级。选型看团队已用的模型生态。可对比《 GitHub Copilot 和 Claude Code 区别怎么选》。
Codex CLI 免费吗？
ChatGPT Plus / Pro / Business / Enterprise / Edu 订阅内含 Codex 使用额度，Free 和 Go 用户也有一段限时体验；超出额度可单独购买 credits 。企业还可对云环境做管理员管控。
它会在我的电脑上乱跑命令吗？
默认不会。审批模式分三级，最保守的”只读 + 显式批准”模式每个改动都要你点头；即使开了完全访问，也建议把敏感操作留在 workspace 内、对外部网络保持警惕。
能接入我自己的工具链吗？
可以。 Codex CLI 内置 web search，并支持 MCP 连接外部系统；还发布了 Codex SDK（TypeScript）和 GitHub Action，能把同一套 agent 嵌进你自己的 CI/CD 与工程工作流。详见《OpenAI Agents API 公开测试版：把智能体编排压成一次 API 调用》。
评论 (0)