第 1 章
入门
8 分钟1 / 8

认识 Codex:AI 编程智能体是什么

从产品形态、能力边界与适用场景讲起,帮你建立正确预期,再动手安装。

概念
架构
场景

Codex 是 OpenAI 推出的编程智能体(coding agent)。它不只是「补全下一行代码」的插件,而是可以阅读仓库、规划任务、改文件、跑命令、解释 diff,并在你的审批策略下迭代完成工作的代理。

Codex 智能体与代码仓库协作示意
Codex 把「对话」与「对仓库的实际操作」连在一起

三种常见使用面

形态适合什么典型入口
CLI(终端)复杂推理、批量改动、脚本化任务终端里运行 codex
IDE 扩展边写边改、就地审阅 diff、快速迭代VS Code / Cursor 侧边栏
云端任务远程跑长任务、多仓库委托Codex Cloud / 网页入口

本教程站以「本地可复现」为主线:CLI + IDE。云端能力会在进阶章节补充,核心思维是一致的——你给目标与约束,智能体给方案与改动,你做审批与验收。

它擅长什么

  • 在陌生仓库里快速建立地图:目录结构、构建方式、关键模块
  • 实现中等规模功能:跨多个文件的增删改,并尽量保持风格一致
  • 修 bug:根据报错栈、复现步骤与测试线索定位并提交修复
  • 重构与清理:重命名、抽模块、补类型、统一错误处理
  • 写与更新测试、文档、脚本,把重复劳动交给代理

它不擅长什么(请设边界)

  • 缺少业务上下文时「凭空猜产品需求」——你要写清目标与非目标
  • 在无审批的高权限模式下盲目跑危险命令——权限策略必须由你定
  • 替代架构评审与安全审计——关键路径仍要人读 diff
  • 保证一次完美——把工作拆小、用测试验收,成功率会高很多

推荐工作流(四步)

  1. 1

    定义任务

    用一句话目标 + 成功标准 + 不要碰的区域。例如:「给 /api/users 加分页;测试覆盖;不改鉴权中间件」。

  2. 2

    让代理探索

    先让它读相关目录与现有模式,再动手改。探索阶段可以用更严格的审批模式。

  3. 3

    审阅 diff

    按文件看意图是否正确、边界条件、命名与风格。拒绝「看起来能跑但语义错」的改动。

  4. 4

    验证与收口

    跑测试 / 类型检查 / 本地预览。通过后再提交;失败则把日志贴回对话继续修。

下一章预告

下一章会从零安装 CLI 与 IDE 扩展,完成登录,并做一次「只读探索」热身,确认工具链可用。