第 1 章
入门
8 分钟1 / 8认识 Codex:AI 编程智能体是什么
从产品形态、能力边界与适用场景讲起,帮你建立正确预期,再动手安装。
概念
架构
场景

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

三种常见使用面
| 形态 | 适合什么 | 典型入口 |
|---|---|---|
| CLI(终端) | 复杂推理、批量改动、脚本化任务 | 终端里运行 codex |
| IDE 扩展 | 边写边改、就地审阅 diff、快速迭代 | VS Code / Cursor 侧边栏 |
| 云端任务 | 远程跑长任务、多仓库委托 | Codex Cloud / 网页入口 |
本教程站以「本地可复现」为主线:CLI + IDE。云端能力会在进阶章节补充,核心思维是一致的——你给目标与约束,智能体给方案与改动,你做审批与验收。
它擅长什么
- 在陌生仓库里快速建立地图:目录结构、构建方式、关键模块
- 实现中等规模功能:跨多个文件的增删改,并尽量保持风格一致
- 修 bug:根据报错栈、复现步骤与测试线索定位并提交修复
- 重构与清理:重命名、抽模块、补类型、统一错误处理
- 写与更新测试、文档、脚本,把重复劳动交给代理
它不擅长什么(请设边界)
- 缺少业务上下文时「凭空猜产品需求」——你要写清目标与非目标
- 在无审批的高权限模式下盲目跑危险命令——权限策略必须由你定
- 替代架构评审与安全审计——关键路径仍要人读 diff
- 保证一次完美——把工作拆小、用测试验收,成功率会高很多
推荐工作流(四步)
- 1
定义任务
用一句话目标 + 成功标准 + 不要碰的区域。例如:「给 /api/users 加分页;测试覆盖;不改鉴权中间件」。
- 2
让代理探索
先让它读相关目录与现有模式,再动手改。探索阶段可以用更严格的审批模式。
- 3
审阅 diff
按文件看意图是否正确、边界条件、命名与风格。拒绝「看起来能跑但语义错」的改动。
- 4
验证与收口
跑测试 / 类型检查 / 本地预览。通过后再提交;失败则把日志贴回对话继续修。
下一章预告
下一章会从零安装 CLI 与 IDE 扩展,完成登录,并做一次「只读探索」热身,确认工具链可用。