openai/codex · 上手攻略

  • 仓库：openai/codex
  • 链接：https://github.com/openai/codex
  • 分类：ai
  • 作者：Jay
  • 更新：2026-08-17

是什么

Codex CLI 是 OpenAI 官方推出的轻量级终端编程智能体（coding agent），于 2025 年 4 月开源发布。与面向 IDE 插件的 Codex（Codex for IDE）不同，Codex CLI 是完全运行在终端的独立工具，支持 macOS、Linux、Windows 全平台。它由 OpenAI 的编码专用模型驱动，能理解代码库、读写文件、执行命令，帮开发者完成日常编程任务。

Codex 有三种使用形态： - Codex CLI：本地终端工具（本案攻略对象） - IDE 插件：VS Code、Cursor、Windsurf 内使用 - Codex Web/App：chatgpt.com/codex 网页端和桌面 App

解决什么问题

大多数 AI 编程工具要么是 IDE 插件（绑定编辑器），要么是云端网页工具（数据出境）。Codex CLI 的核心价值在于：在任意终端环境里，用本地文件权限和真实 shell 环境做 AI 编程，不依赖任何 IDE，不把代码上传到非必要的地方。适合习惯命令行工作流、或者需要自动化脚本场景的开发者。

快速安装

macOS / Linux（一键脚本）

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows（PowerShell）

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

通过 npm 安装

npm install -g @openai/codex

通过 Homebrew 安装

brew install --cask codex

手动下载二进制

前往 GitHub Releases 手动下载对应平台二进制，解压后将可执行文件重命名为 codex 并加入 PATH。

安装后直接运行：

codex

首次运行会提示 Sign in with ChatGPT，按指示完成认证即可。

使用 API Key（可选）

如果不想用 ChatGPT 账号，也可以配置 OpenAI API Key 认证，详见 官方认证文档。

核心用法

基本命令

codex                    # 交互式对话，启动 AI 编程 session
codex app               # 启动桌面 App 模式

典型工作流

  1. codex 启动，进入交互式 CLI
  2. 描述你想完成的任务（例如："帮我把这个 Python 脚本加上类型注解"）
  3. Codex 读取当前目录文件，理解上下文
  4. 提出修改方案，用户确认后执行

价格体系

Codex 使用 ChatGPT 订阅计划：

计划 价格 Codex 访问
ChatGPT Plus $20/月 有（标准）
ChatGPT Pro $200/月 有（增强，5x 使用量）
ChatGPT Team 共享 有
ChatGPT Enterprise 协商定价 有

⚠️ 实际限制政策由 OpenAI 随时调整，建议查看 官方计划说明 确认最新额度。

典型适用场景

  • 终端原生开发者：不打开 IDE，直接在 terminal 里完成代码修改、重构、bug 修复
  • CI/CD 脚本自动化：在 pipeline 里调用 Codex 执行代码生成任务
  • 跨项目批量修改：用脚本批量对多个仓库执行相同格式的代码改动
  • 习惯 CLI 的效率党：不想切换到 VS Code 的重度命令行用户

坑与注意

  1. 网络认证问题：Codex 安装脚本和认证流程依赖 chatgpt.com 国内直连可能不稳定，可以设置 CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false 强制从 GitHub Releases 下载二进制绕过。
  2. API Key vs 账号体系：两者是独立认证路径，混用可能产生混淆，建议选定一种方式。
  3. 非 IDE 环境限制：Codex CLI 没有 IDE 插件的代码高亮、跳转等上下文感知能力，对复杂项目的理解深度不及 Claude Code 等竞品。
  4. Windows 兼容性：虽然在 Windows 上可用，但官方推荐 macOS/Linux，部分边缘功能在 Windows 上行为可能不同。
  5. 代码权限：Codex CLI 会读写本地文件、执行 shell 命令，首次使用务必确认工作目录正确，避免误操作覆盖重要文件。

与同类对比

维度 Codex CLI Claude Code Cursor CLI
推出时间 2025年4月 2025年2月 2025年
底层模型 GPT-5.3-Codex-Mini Claude Opus 4.6/Sonnet 4.6 Claude/自定义
SWE-bench 得分 69.1% 72.7%（80.9% in 2026 data） ~70%
Terminal-Bench 2.0 77.3%（领先） 较低 中等
Token 效率 高（4x 节省） 较低（4x 消耗更多） 中等
IDE 集成 无（纯 CLI） 有（+ VS Code/JetBrains） 有
开源 是（Apache 2.0） 否 部分
最低费用 $20/月（Plus） $20/月（Pro） 视具体方案

总结：Codex CLI 在 token 效率和 Terminal-Bench 基准测试上领先，但复杂代码任务的完成质量略输 Claude Code。适合追求轻量、开放、终端原生体验的开发者；需要深度代码理解的项目建议选 Claude Code。

一句话推荐结论

如果你主要在终端工作、想要一个开源的 AI 编程工具、且对 token 效率敏感，Codex CLI 是值得一试的免费（需 ChatGPT 订阅）选项；如果是复杂多文件项目，Claude Code 的代码理解深度目前仍有优势。

来源

  • https://github.com/openai/codex（README、安装文档）
  • https://developers.openai.com/codex（官方文档）
  • https://www.nxcode.io/resources/news/claude-code-vs-codex-cli-terminal-coding-comparison-2026（2026年对比数据）
  • https://blog.openreplay.com/openai-codex-vs-claude-code-cli-ai-tool（Codex vs Claude Code）
  • https://composio.dev/content/claude-code-vs-openai-codex（定价与功能对比）