Skip to main content

​
Codex 是什么

本篇先不讲安装和具体命令，只解决一个最重要的问题：Codex 到底是聊天工具、代码补全工具，还是能真正参与开发的代理？ 读完后，你应该能够：
  • 用一句话解释 Codex 的定位；
  • 分辨它适合做什么，以及哪些判断仍然必须由人完成；
  • 理解 Codex 与 ChatGPT 普通对话的区别；
  • 知道下一步应该从哪个入口开始。
本篇内容参考了 参考/codex/01-what-is-codex.md 和 参考/codex/02-core-concepts.md 中的概念整理，并结合 Codex 官方文档核对。模型名称、套餐和界面文案可能随版本变化，请以官方页面和本地实际显示为准。

​
一句话认识 Codex

Codex 是 OpenAI 的 AI 编程代理（coding agent）。 “代理”与普通聊天机器人的差别在于：你给它一个目标后，它可以在授权范围内自己读取项目文件、搜索代码、执行命令、修改文件、运行检查，并根据结果继续下一步，而不是只返回一段需要你复制粘贴的代码。 因此，更准确的分工是：
人负责目标、范围和最终判断；Codex 负责探索、执行和重复验证。

​
Codex 能做什么

Codex 的工作对象不是一个孤立的代码片段，而是一个工作区或代码仓库。常见任务包括：

​
读懂陌生代码库

你可以先让它扫描目录、查找入口文件和关键调用关系，再用适合初学者的语言解释项目结构：

​
修复 Bug 和失败测试

把复现命令、报错信息和验收条件一起告诉它，它就可以沿着“读取代码 → 复现问题 → 修改 → 再验证”的路径工作：

​
开发和重构

Codex 可以跨文件修改功能、补测试、整理重复逻辑、更新配置或迁移接口。但任务越大，越应该先让它出方案：

​
审查和自动化

它可以检查未提交改动、分析潜在边界条件，也可以通过 CLI 的非交互模式接入脚本和 CI。更长的任务还可以交给云端运行，完成后查看 diff 或 Pull Request。

​
它不是什么

第一次接触 Codex 时，不要直接把“重构整个项目”作为任务。更好的顺序是：先让它解释，再让它修改一处小范围代码，最后检查 diff 和测试结果。

​
Codex 与 ChatGPT 的关系

Codex 与 ChatGPT 同属 OpenAI，但使用方式不同：
  • ChatGPT 普通对话更像技术顾问：你提问，它解释概念、给出方案或代码；
  • Codex更像进入项目工作的执行型搭档：它可以在工作区中读取、修改和验证代码。
你可以先在普通对话中梳理需求，再在 Codex 中让它检查真实项目；也可以在 Codex 中先用只读方式讨论方案，再切换到允许修改的模式。

​
第一次使用的建议

参考材料中反复强调了一个很实用的经验：先用小项目建立体感，不要一上来拿生产仓库练手。 建议按下面的最小顺序开始：
  1. 准备一个可以随时重建的练习目录；
  2. 如果有 Git，先创建一个初始提交作为检查点；
  3. 让 Codex 解释一个文件，确认它读到了真实内容；
  4. 让它做一处小修改；
  5. 查看 diff，运行测试，再决定是否提交。
如果你只是想确认 CLI 是否安装，可以在终端运行：
看到版本号说明命令已被系统找到；如果提示找不到命令，也不代表 Codex 概念上不可用，只是需要进入下一篇的安装和登录流程。

​
小结

  • Codex 是能读取、修改和运行代码的 AI 编程代理，不只是会生成代码的聊天框；
  • 它适合探索代码库、修复问题、开发功能、补测试、审查改动和执行自动化任务；
  • 人仍然负责需求、范围、风险判断和最终发布；
  • 可靠的使用节奏是“先理解，后修改；先看 diff，再提交”；
  • 具体入口和运行位置，请继续阅读四种入口。