一、Codex CLI 概述

Codex CLI 是 OpenAI 于 2025 年 4 月发布的开源终端编程智能体，定位为开发者工具链的核心组件。

它基于 GPT-4 架构的衍生模型（如 o3、o4-mini），支持自然语言指令直接操作代码、文件系统和终端命令，实现从需求到代码的端到端自动化。

其核心目标是通过自然语言交互提升开发效率，同时通过沙盒隔离和权限控制保障安全性。

二、Codex CLI 的核心特点

1. 开源与社区驱动

• 完全开源（Apache 2.0 协议），允许开发者自由修改和扩展功能，社区贡献了 Python 实现、自定义命令模板等生态工具。
• 支持通过 Markdown 文件定义自定义命令（如 /security-audit），实现自动化工作流。

2. 终端原生集成

• 直接运行于终端环境，无需切换 IDE，支持 macOS、Linux 及 Windows 11 WSL2，兼容 Git 和 CI/CD 流程。
• 提供交互式 REPL 引擎和静默模式（--quiet），适用于开发与自动化场景。

3. 多模态输入与智能推理

• 支持文本、截图、图表输入，结合 GPT-5 的多模态能力，可直接将设计稿转化为代码。
• 内置 192k 长上下文窗口，支持跨文件语义关联，减少重复解释需求。

4. 安全与权限控制

• 三级权限模式：
  建议模式（Suggest）：仅提供建议，需手动确认修改（默认）。
  自动编辑（Auto Edit）：自动修改文件，但需确认命令执行。
  全自动（Full Auto）：在沙盒环境中完全自主操作（禁用网络和文件系统访问）。
• 沙盒隔离技术：macOS 使用 Seatbelt，Linux 通过 Docker 容器化，确保执行环境安全。

5. 高性能与灵活性

• 基于 Rust 编写，内存占用低（最低 4GB），响应速度比同类工具快 30%。
• 支持模型动态切换（如 o3 与 o4-mini），平衡性能与成本。

三、Codex CLI 与 Claude Code 核心优势对比

总结：

• 选 Codex CLI：需快速迭代、精细化控制权限的开发者。
• 选 Claude Code：需 AI 完全接管复杂项目推理的团队。

四、Codex CLI 的安装与配置

1、安装

1.1、下载并安装 Node.js

Gemini CLI 终端安装我们使用 npm 方式，所以我们先来安装 Node.js 。

1. 下载地址：https://nodejs.org/zh-cn/download

1. msi文件下载后，双击安装即可。

2. 安装完成后，按 win + R ，输入 cmd 打开终端后，输入 node -v 命令，如下：

如此，则表示 Node.js 安装成功。

1.2、安装Codex CLI

# 通过 npm 全局安装  npm install -g @openai/codex  # 或使用 Homebrew（macOS）  brew install codex  

• 依赖要求：Node.js ≥22、Git ≥2.23、内存 ≥4GB。

2、配置

1. ChatGPT 套餐

首次启动 Codex CLI 后会提示需要升级到 Plus 套餐。

大家可以看到，只有 Plus 及以上套餐才会包含 Codex 。

1. Codex CLI 相关配置

• API 密钥：

# Windows配置set OPENAI_API_KEY="sk-xxxxxx"# Linux/Mac配置export OPENAI_API_KEY="sk-xxxxxx"

• 模型选择：

codex --model o4-mini  # 默认模型  codex --model o3       # 高精度模型  

• 权限模式：

codex --approval-mode full-auto  # 全自动模式（需谨慎）  

• 自定义指令：在 ~/.codex/instructions.md 中定义全局规则（如禁止使用 any 类型）。

五、Codex CLI 的使用示例

1. 代码生成与重构

codex "将 Dashboard 组件重构为 React Hooks 写法"# 输出：自动生成 Hooks 代码并运行测试  

• 支持批量文件重命名、依赖更新等操作。

2. 测试与调试

codex "为 utils/date.ts 编写单元测试"# 生成测试用例并自动执行，直至通过  

3. 多模态输入

# 上传 UI 设计图，生成响应式页面代码  codex --image design.png "生成登录页代码"

4. CI/CD 自动化

# GitHub Action 静默更新 CHANGELOG  codex --approval-mode auto-edit --quiet "更新 CHANGELOG"

六、总结

Codex CLI 的核心优势在于 终端原生集成、安全可控的权限模型 和 开源生态的灵活性。

其通过细粒度控制（如沙盒隔离、模式切换）和多模态支持，成为开发者提升效率的“智能助手”。

对于需要深度定制化工作流的团队，Codex CLI 的开源特性与社区生态提供了广阔扩展空间，而全自动模式则适合快速原型开发场景。

未来，随着 Rust 版本重构和跨平台能力增强，其性能与安全性将进一步提升。