codex
openai/codex加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
想象一下这个场景：深夜 11 点，你正对着一段报错信息抓耳挠腮，忽然想起同事提过的一个工具——只要在终端里敲几个字，它就能读懂你的代码、帮你写补丁、甚至直接帮你提交 PR。你半信半疑地试了一下，结果 5 分钟后，一个本来要花两小时调试的 bug 已经被它修好，commit message 都帮你写好了。
这就是 OpenAI Codex CLI 带给无数开发者的真实体验。
图1：Codex CLI 启动界面，展示其终端原生交互体验
Codex 并不是 OpenAI 的新尝试。它的名字早在 2021 年就出现在 OpenAI 的研究论文中——那篇让整个科技圈震惊的论文展示了 GPT-3 如何驱动一个能「读代码、写代码」的 AI 系统。但彼时的 Codex 还是一个需要通过 API 调用的云端服务，速度受网络制约，成本按 token 计费，不是每个开发者都能随时使用。
2024 年，OpenAI 做出了一个关键决策：将 Codex 从云端带到本地，推出 Codex CLI——一个可以直接运行在你电脑终端里的轻量级 coding agent。这个决定的意义远超产品形态的变化：本地运行意味着更低延迟、更低成本、完全离线可用，以及最重要的——你的代码永远不会离开你的机器。
作为 OpenAI 官方出品的开源项目，Codex CLI 的代码完全公开托管在 GitHub，由 OpenAI 内部团队维护。这意味着它能第一时间用上 OpenAI 的最新模型能力，同时社区也可以参与贡献和审计。
Codex CLI 的架构设计体现了 OpenAI 对「工程品质」的极致追求。
项目采用 Rust 语言 作为核心实现，这是一个在性能、安全性和并发处理方面都极为出色的系统编程语言。整个代码库被组织成一个 Bazel 构建的 Cargo workspace，包含超过 80 个独立 crate（子模块），分工明确：
| 模块 | 功能 |
|---|---|
core | 核心 Agent 逻辑与任务规划 |
core-api | OpenAI API 通信层 |
exec | 代码执行引擎（沙箱环境） |
tui | 终端用户界面（TUI） |
cli | 命令行入口封装 |
mcp-server | MCP（Model Context Protocol）服务器实现 |
file-search | 文件系统搜索与索引 |
apply-patch | 代码 Diff / Patch 应用 |
skills | 可扩展技能系统 |
secrets | 密钥安全管理 |
analytics | 使用数据分析 |
这种模块化设计的最大好处是职责清晰、可测试性强。每个 crate 都可以独立开发、单独测试，再通过 workspace 机制整合成完整应用。例如 exec 模块负责在沙箱中安全执行代码，apply-patch 模块负责将 AI 生成的内容以标准 diff 格式写回文件——两个模块互不干扰，通过明确定义的接口通信。
与同类工具（如 GitHub Copilot CLI、Cursor 等）相比，Codex CLI 的独特之处在于它完全脱离 IDE 存在：不依赖 VS Code 插件，不绑定任何编辑器，在任何终端环境里都能工作。这种「无平台依赖」的设计让它可以无缝嵌入现有的 CI/CD 流水线或开发工作流。
Codex CLI 支持两种运行模式：
对话式交互（TUI 模式）：运行 codex 后进入一个全屏终端界面，你可以在里面和 AI 对话、让它读代码、执行命令。TUI 支持语法高亮、分屏展示、多轮对话上下文记忆，交互体验接近一个专属的 AI 结对编程伙伴。
非交互式执行（exec 模式）：运行 codex exec "<你的指令>" 直接执行单条命令，适合在脚本或 CI 流水线中调用。它会将结果以结构化形式输出，便于自动化工具解析。
Codex 能理解整个代码仓库的结构。通过 file-search 模块，它可以快速定位相关文件、理解函数调用关系，在此基础上给出精准的修改建议。它不只是生成代码片段，而是能理解你的意图——你要的是一个功能、一个修复还是一个重构。
特别值得称道的是 apply-patch 模块。当你确认了 Codex 的修改建议后，它会以标准 unified diff 格式展示变更，让你逐行审核，确认后再写入文件。这种「AI 提方案，人做最终决策」的机制，既发挥了 AI 的效率优势，又避免了自动修改破坏代码的风险。
Codex 内置了一个可扩展的技能系统。你可以为自己的项目定义一组常用的操作步骤（比如「运行测试→分析输出→给出报告」），让 Codex 在执行特定任务时调用这些技能。技能以声明式配置文件定义，版本可控、可复用。
代码执行是 coding agent 最敏感的环节——你肯定不想让一个 AI 随意在系统里执行 rm -rf / 这样的命令。Codex 的 exec 模块内置了多层沙箱机制：
linux-sandbox：基于 Linux namespace 的进程隔离process-hardening：进程权限收紧execpolicy：细粒度的执行策略控制这套机制确保 AI 生成的代码在受控环境中运行，不会对主机系统造成破坏。同时 execpolicy 模块还支持用户自定义策略，精细控制哪些操作允许执行。
Codex 还实现了 MCP（Model Context Protocol） 服务器和客户端，这意味着它可以和其他 MCP 兼容的工具互联互通。比如你可以让 Codex 通过 MCP 连接一个数据库工具，直接帮你写 SQL 并执行；或者连接一个文档工具，帮你更新 API 文档。这将 Codex 从一个单纯的编程工具，扩展为一个可以操作各种外部系统的AI agent 平台。
Codex CLI 支持两种认证方式：
ChatGPT 账号登录（推荐）：如果你已经订阅了 ChatGPT Plus、Pro、Business、Edu 或 Enterprise 计划，可以直接用 ChatGPT 账号登录 Codex，所有用量包含在套餐内，无需额外付费。这降低了个人开发者的使用门槛。
OpenAI API Key：适合需要在团队或企业环境中规模化使用的场景。你可以用自己的 API Key 按量计费，灵活性更高，但需要额外的设置步骤（详见 官方文档）。
安装 Codex CLI 非常简单，有三种方式：
一键脚本安装（推荐）
macOS/Linux：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Windows（通过 WSL2）：
irm https://chatgpt.com/codex/install.ps1 | iex
包管理器
# npm
npm install -g @openai/codex
# Homebrew（macOS）
brew install --cask codex
手动下载
在 GitHub Releases 页面下载对应平台的二进制文件，解压后将 codex 可执行文件加入 PATH 即可。
安装完成后，运行 codex 即可启动交互界面。首次使用时会引导你完成账号登录或 API Key 配置，整个过程不超过 2 分钟。
作为一个新兴的 coding agent，Codex CLI 也面临一些挑战和争议：
1. 模型能力边界：Codex 本质上调用的是 OpenAI 的 GPT 系列模型。当面对非常长、非常复杂的代码库时，上下文窗口的限制可能导致它无法「看到」全貌，给出的建议可能缺乏对整体架构的理解。
2. 安全性的双刃剑：虽然沙箱机制提升了安全性，但 AI 生成代码的本质决定了任何自动执行的代码都存在风险。OpenAI 建议用户在生产环境中始终审核 Codex 生成的变更，而不是盲目接受。
3. Rust 项目的维护负担：Codex 选择 Rust 带来了性能和安全性，但 Rust 的学习曲线和编译时间也会增加开发和测试的门槛。
4. 替代品竞争激烈：Claude Code、GitHub Copilot CLI、Cursor 等工具都在快速迭代，Codex 需要在模型能力、交互体验和生态建设上持续发力才能保持竞争力。
Codex CLI 的出现标志着 AI 编程工具进入了一个新阶段：从 IDE 插件走向独立终端。这种转变有几个深远的意义：
首先，终端是开发者最高频的工作环境，比任何 IDE 都更通用。当 coding agent 不再依赖特定编辑器，它的使用场景就大大扩展了——你可以把它集成进 Vim、Emacs、甚至 SSH 远程会话里。
其次，开源意味着透明和可审计。在 coding agent 越来越深入软件开发流程的背景下，开发者对工具的信任至关重要。OpenAI 将 Codex CLI 完全开源，允许任何人审查代码、提交改进，这种透明度在商业 AI 工具中是难得的。
最后，本地化运行是隐私保护的终极形态。对于处理敏感代码的企业和个人开发者，本地运行的 agent 意味着他们的代码永远不会经过第三方服务器，数据主权得到充分保障。
OpenAI Codex CLI 是一款定位清晰的本地终端编程助手，由 OpenAI 官方开发和维护，代码开源，采用 Rust 语言构建，架构模块化、可扩展性强。它将 OpenAI 的强大语言模型能力带到开发者的终端环境中，通过安全沙箱、TUI 交互界面、Skills 系统和 MCP 协议支持，为个人开发者和企业团队提供了灵活、高效的 AI 编程辅助方案。虽然在超大规模代码库和多模型协作方面仍有提升空间，但其开源、透明、低门槛的特性，已经让它成为当前最值得关注的 AI 编程工具之一。
如果你厌倦了在多个工具之间切换，想找一个「随时在终端里待命」的 AI 编程搭档，Codex CLI 值得一试。