Codex 是 OpenAI 面向软件开发的 coding agent。它会读取文件、执行命令、修改代码,并通过多轮工具调用完成任务。

从这里开始

Codex 是什么

Codex 是 OpenAI 把模型、工具、环境和审批策略组合起来,让 AI 直接完成软件开发任务的产品。本教程把桌面端 App 作为主线。

LocalWorktreeCloud
1
app/pages/dashboard.tsx
+
renderCodexDesktopGuide()
+
runVisualCheck()

Codex 不是什么

把 Codex 当成「会自动做事的同事」比当成「智能补全」更接近事实。它和以下工具有本质区别:

不是补全工具

它不只在光标处给建议,而是会自己拆解任务、运行测试、回滚错误。

不是聊天机器人

它会真实读写文件、执行命令、调用浏览器,而不是只输出文字。

不是远程黑盒

桌面端默认在本机执行,你能看到每一次 diff、命令和审批节点。

Codex 能做的事

  • 理解陌生代码库,输出架构与启动方式。
  • 实现一个完整功能并补测试。
  • 修复 Bug,给出最小修复和回归测试。
  • 跑前端开发服务器并截图自检。
  • 把 GitHub Issue 自动变成 PR。
  • 把 Slack 讨论 / Linear 工单转成实现计划。
  • 定期跑代码审查、文档维护、依赖升级。

本站学习路径

  1. 先建立基础概念:本章。
  2. 桌面端入门:安装、界面、线程、设置。
  3. 工程工作流:Git diff、Worktree、浏览器、Computer Use。
  4. CLI、IDE、Cloud:补充使用场景。
  5. 核心概念:Agent Loop、Sandbox、Approval、模型。
  6. 配置与扩展:AGENTS.md、Skills、MCP、插件、Hooks。
  7. 实战与集成:常见工作流、GitHub、CI、企业治理。
  8. 最后查速查表与 FAQ。