> ## Documentation Index
> Fetch the complete documentation index at: https://aicoding.cscitech.top/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex 是什么

> 本篇介绍 Codex 的定位、能力边界，以及它与普通聊天工具的区别。

# Codex 是什么

本篇先不讲安装和具体命令，只解决一个最重要的问题：**Codex 到底是聊天工具、代码补全工具，还是能真正参与开发的代理？**

读完后，你应该能够：

* 用一句话解释 Codex 的定位；
* 分辨它适合做什么，以及哪些判断仍然必须由人完成；
* 理解 Codex 与 ChatGPT 普通对话的区别；
* 知道下一步应该从哪个入口开始。

> 本篇内容参考了 `参考/codex/01-what-is-codex.md` 和 `参考/codex/02-core-concepts.md` 中的概念整理，并结合 Codex 官方文档核对。模型名称、套餐和界面文案可能随版本变化，请以官方页面和本地实际显示为准。

## 一句话认识 Codex

**Codex 是 OpenAI 的 AI 编程代理（coding agent）。**

“代理”与普通聊天机器人的差别在于：你给它一个目标后，它可以在授权范围内自己读取项目文件、搜索代码、执行命令、修改文件、运行检查，并根据结果继续下一步，而不是只返回一段需要你复制粘贴的代码。

| 方式       | 你需要做什么                | AI 主要做什么            |
| -------- | --------------------- | ------------------- |
| 普通聊天     | 复制代码、粘贴报错、手动修改文件、再次运行 | 解释问题、提供代码和建议        |
| Codex 代理 | 说明目标、限定范围、检查结果        | 读取项目、修改文件、运行命令、验证改动 |

因此，更准确的分工是：

> **人负责目标、范围和最终判断；Codex 负责探索、执行和重复验证。**

## Codex 能做什么

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

### 读懂陌生代码库

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

```text theme={null}
先不要修改任何文件。请查看当前项目的目录结构，说明启动入口、主要模块、测试命令，以及需要注意的依赖关系。
```

### 修复 Bug 和失败测试

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

```text theme={null}
运行失败的测试，定位导致失败的根因。只修改与这个问题直接相关的文件，修复后重新运行该测试，并说明验证结果。
```

### 开发和重构

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

```text theme={null}
先不要修改文件。请分析这个模块的重构方案，列出拟修改的文件、风险和验证命令，等我确认后再执行。
```

### 审查和自动化

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

## 它不是什么

| 不应期待 Codex 自动替你完成的事 | 原因                    |
| ------------------- | --------------------- |
| 替你决定产品需求和技术取舍       | 这些决定依赖业务目标、成本和团队约束    |
| 保证代码百分之百没有 Bug      | 模型输出是候选实现，测试和人工审查仍然必要 |
| 猜中没有说清楚的业务规则        | 缺少上下文时，它只能根据概率作出假设    |
| 在你完全不理解改动的情况下替你发布   | 你无法验收，就无法承担发布结果       |
| 自动获得整台电脑的无限权限       | 沙箱和审批会限制它的文件、命令与网络访问  |

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

## Codex 与 ChatGPT 的关系

Codex 与 ChatGPT 同属 OpenAI，但使用方式不同：

* **ChatGPT 普通对话**更像技术顾问：你提问，它解释概念、给出方案或代码；
* **Codex**更像进入项目工作的执行型搭档：它可以在工作区中读取、修改和验证代码。

你可以先在普通对话中梳理需求，再在 Codex 中让它检查真实项目；也可以在 Codex 中先用只读方式讨论方案，再切换到允许修改的模式。

## 第一次使用的建议

参考材料中反复强调了一个很实用的经验：**先用小项目建立体感，不要一上来拿生产仓库练手。**

建议按下面的最小顺序开始：

1. 准备一个可以随时重建的练习目录；
2. 如果有 Git，先创建一个初始提交作为检查点；
3. 让 Codex 解释一个文件，确认它读到了真实内容；
4. 让它做一处小修改；
5. 查看 diff，运行测试，再决定是否提交。

如果你只是想确认 CLI 是否安装，可以在终端运行：

```bash theme={null}
codex --version
```

看到版本号说明命令已被系统找到；如果提示找不到命令，也不代表 Codex 概念上不可用，只是需要进入下一篇的安装和登录流程。

## 小结

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