如果你想要一个真正能读代码、改代码、跑命令、做代码评审的 AI 编程助手，Codex 是目前很值得上手的一套工具。它既有网页版，也有终端里的 Codex CLI，其中 CLI 对开发者尤其顺手。

Codex 使用教程：从安装到命令行实战

Codex 是什么

Codex 是 OpenAI 面向软件开发场景推出的编码代理产品。它不是单纯的聊天框，而是更偏“能执行任务”的工作方式，比如：

  • 阅读项目代码并总结结构
  • 修改文件并生成补丁
  • 执行命令和测试
  • 做代码评审
  • 在受控权限下完成较长链路任务

截至 2026-04-23，OpenAI 开发者站点已经把 Codex 分成多种使用形态：

  • Web：网页端使用
  • App：桌面应用
  • IDE Extension：IDE 插件
  • CLI：命令行版本

这篇文章主要讲最实用的 Codex CLI，因为它最适合真正写代码的人。

Codex CLI 能做什么

从本机当前版本的 codex --help 来看，CLI 已经支持这些核心能力：

  • 交互式编码会话
  • 非交互执行 codex exec
  • 代码评审 codex review
  • 登录和退出登录
  • MCP 服务管理
  • 插件管理
  • 恢复历史会话
  • 以 MCP Server 形式运行

简单理解，Codex CLI 就像一个住在终端里的 AI 工程师副驾。

使用前需要准备什么

开始前建议准备好下面几样：

  • 一个 OpenAI 账号
  • 可用的 Codex 访问权限
  • Git 项目目录
  • 终端环境

如果你主要在 Windows 上开发，PowerShell、Windows Terminal、WSL2 都可以作为常见入口。

第一种用法：直接用网页端 Codex

如果你暂时不想装命令行，可以先从网页端开始。OpenAI 官方目前提供了独立的 Codex 使用入口，适合：

  • 快速体验
  • 不想先折腾终端配置
  • 主要做轻量代码任务

网页版更适合“先感受能力”，但如果你后面想让它真正读本地仓库、执行命令、参与开发流程，还是建议转到 CLI。

第二种用法：安装 Codex CLI

安装完成后，可以先直接检查命令是否可用：

1
codex --help

如果能正常输出帮助信息，说明 CLI 已经装好。

在你的机器上，当前 CLI 的主命令包括：

1
2
3
4
5
6
7
8
codex exec
codex review
codex login
codex logout
codex mcp
codex plugin
codex resume
codex apply

这些命令已经覆盖了日常开发里的大部分核心场景。

登录 Codex

第一次使用前，先登录：

1
codex login

登录后，Codex 才能使用对应的账户权限和模型能力。

如果你后面需要切换账号，也可以执行：

1
codex logout

然后重新登录。

最常见的启动方式

进入一个 Git 项目目录后，直接运行：

1
codex

这会启动交互式 CLI 会话。你可以直接给它任务，比如：

1
请先阅读当前项目的 README 和 package.json，然后告诉我这个项目如何启动。

或者：

1
分析当前仓库的目录结构，找出主要入口文件和配置文件。

这种模式最适合边看边聊、边做边改。

最实用的几个命令参数

根据当前 CLI 帮助信息，下面这些参数很常用：

1. 指定模型

1
codex -m gpt-5.3-codex

OpenAI 官方模型页显示，gpt-5.3-codex 是目前更强的 agentic coding 模型之一；如果你想要更新、更强的编码模型，可以优先关注 Codex 系列模型页的最新默认项。

2. 指定工作目录

1
codex -C D:\blog

这样可以避免你在错误目录里执行任务。

3. 开启联网搜索

1
codex --search

这个参数适合查文档、查报错、查依赖版本。

4. 全自动低摩擦模式

1
codex --full-auto

这个模式会用更顺滑的默认执行策略，让 Codex 更主动地完成任务，但依然是在受控的沙箱工作流里。

5. 控制沙箱

1
2
3
codex -s read-only
codex -s workspace-write
codex -s danger-full-access

如果你只是先观察它怎么分析代码，建议从 read-only 开始；如果你要让它真正改项目，通常用 workspace-write 更合适。

新手最推荐的使用姿势

第一次用 Codex，不建议一上来就让它“重构整个项目”。更稳的方式是按下面顺序来：

第一步：先让它读，不要让它改

例如：

1
2
3
4
5
请阅读当前仓库，告诉我：
1. 这是个什么项目
2. 入口文件在哪里
3. 启动命令是什么
4. 哪些目录最关键

第二步：再让它做小改动

例如：

1
把 README 里的启动步骤整理成更清晰的中文版本。

第三步：最后再让它跑命令和测试

例如：

1
帮我运行测试，看看当前项目失败在哪里，并给出修复建议。

这个顺序能显著降低跑偏概率。

codex exec 怎么用

如果你不想进入交互界面，而是希望“一条命令执行完就退出”，可以用：

1
codex exec "分析当前仓库，并输出启动步骤"

这类非交互模式适合：

  • 自动化脚本
  • CI 场景
  • 一次性任务
  • 批处理任务

你也可以配合工作目录使用：

1
codex exec -C D:\blog "检查这个项目里有没有明显的 Markdown 链接错误"

codex review 的用法

如果你主要想让 Codex 帮你看代码问题，可以用：

1
codex review

这类模式特别适合：

  • 提交前自查
  • 看回归风险
  • 找潜在 bug
  • 检查缺失测试

和普通“帮我看看代码”不同，review 更偏审查思维，而不是直接帮你改。

常见工作流示例

下面这几个例子，基本就是日常最常用的场景。

1. 理解陌生项目

1
2
3
4
5
阅读当前仓库并总结：
1. 技术栈
2. 主要目录职责
3. 本地启动方式
4. 可能的风险点

2. 修复一个报错

1
运行测试并定位失败原因，只修复最小范围的问题，不要做无关重构。

3. 重写一段说明文档

1
请把当前 README 改写成更适合新手阅读的版本，并保留原有命令示例。

4. 做一次代码评审

1
请审查这次修改，重点关注 bug、行为回归和遗漏测试。

MCP 和插件有什么用

从当前 CLI 命令可以看到，Codex 已经支持：

  • codex mcp
  • codex plugin

这意味着你可以继续扩展 Codex 的能力，比如接外部文档、工具、系统服务或自定义工作流。对新手来说，前期先不用急着配复杂集成，先把基本命令和代码工作流用熟更重要。

如果后面你需要把内部接口、文档中心、团队脚本接进来，MCP 会很有价值。

使用 Codex 时要注意什么

Codex 很强，但不是“闭眼全自动”。

建议牢记下面几点：

  • 重要改动前先让它说明计划
  • 大改前先看它理解是否正确
  • 删除文件、批量替换、数据库脚本要特别谨慎
  • 优先在 Git 仓库里使用，方便回看 diff
  • 先从小任务建立信任，再逐步放权

一句话总结：先把它当成高水平结对程序员，再慢慢把更多执行权交给它。

哪些人最适合用 Codex

如果你属于下面几类用户，Codex 的价值会非常明显：

  • 经常写代码的开发者
  • 需要快速理解老项目的人
  • 要频繁改文档和脚本的人
  • 想让 AI 参与评审、排错、重构的人

如果你只是偶尔问几个编程问题，普通聊天工具就够；但如果你想让 AI 真正进入开发流程，Codex 会更像生产工具。

结语

Codex 的上手门槛并不高。最简单的路径就是：先登录、进入项目目录、启动 codex，然后从“读代码和总结项目”这种低风险任务开始。熟悉之后，再逐步尝试 codex exec、codex review、联网搜索、沙箱控制和更复杂的自动化流程。

截至 2026-04-23，OpenAI 官方已经把 Codex 做成了网页、App、IDE 和 CLI 多入口产品。对开发者来说，CLI 依然是最值得优先掌握的一种，因为它最接近真实开发现场，也最容易发挥 Codex 的核心价值。