# OpenAI Codex 知识体系

> Codex 是 OpenAI 的编码 Agent：在授权范围内读写代码、执行命令，并在 CLI / IDE / Desktop / Cloud 四入口共享配置与能力。
> 本文基于仓库知识库 `codex/`（dg.md + p1–p6.md，源自 [developers.openai.com/codex](https://developers.openai.com/codex)）按 KSB v3.6 构建三层四图知识体系。
> 结构：顶层主干广度 → 中间维度交叉 → 底层关联网络 → 左到右学习路线。

## 〇、领域界定（建模前置）

【领域】：OpenAI Codex 使用与工程化
【核心定义】：以自然语言驱动的编码 Agent，在沙箱与审批约束下完成本地/云端软件工程任务。
【范围边界】：
  - 包含：四入口、安装认证、CLI/Slash、IDE/Desktop、Sandbox×Approval、config.toml、AGENTS/Skills/MCP/Plugins、Cloud/Review/exec/CI
  - 不包含：底层模型训练细节、非 Codex 的通用 LLM 应用开发、IDE 非 Codex 功能（调试器/语言服务）
  - 前置依赖：命令行基础、Git 基础、对本机项目目录结构的基本了解
【目标受众与用途】：开发者日常提效 / 团队落地规范 / 自动化接入
【典型应用场景】：本地修测试、IDE 边写边审、Cloud 跑隔离任务后 apply、CI 中 codex exec
【三层粒度规划】：主干 8（左右各 4）；维度 3（入口×主题×难度）；底层 Atom 73 个；depends 占比 79.2%

## 一、顶层知识：领域主干（思维导图式展开）
> 📊 查看对应图表：[knowledge_top.html](knowledge_top.html)
> 读图指引：根节点「OpenAI Codex」居中，8 个主干左右双侧展开到三级。右侧偏产品入口与交互面，左侧偏安全、配置、定制与自动化（按奇偶分配）。

### 1.1 产品入口与形态
- 定义：产品入口与形态是 Codex 知识主干之一，覆盖该模块的核心概念与可操作知识点。
- 核心要点：① 先建立该主干下的关键术语 ② 再落到可执行命令/配置 ③ 与安全或定制主干交叉时优先补 depends 边
- 可验证实例：在对应 HTML 图谱中筛选 category=产品入口与形态，可见 6 个底层 Atom（如 Codex编码Agent、CLI入口、IDE扩展入口）。
- 关键子主题：见顶层导图二级/三级节点；底层代表节点：Codex编码Agent、CLI入口、IDE扩展入口、Desktop入口、Cloud入口。

### 1.2 安装与认证
- 定义：安装与认证是 Codex 知识主干之一，覆盖该模块的核心概念与可操作知识点。
- 核心要点：① 先建立该主干下的关键术语 ② 再落到可执行命令/配置 ③ 与安全或定制主干交叉时优先补 depends 边
- 可验证实例：在对应 HTML 图谱中筛选 category=安装与认证，可见 8 个底层 Atom（如 官方安装脚本、npm安装、Homebrew安装）。
- 关键子主题：见顶层导图二级/三级节点；底层代表节点：官方安装脚本、npm安装、Homebrew安装、版本验证、ChatGPT登录。

### 1.3 CLI交互与会话
- 定义：CLI交互与会话是 Codex 知识主干之一，覆盖该模块的核心概念与可操作知识点。
- 核心要点：① 先建立该主干下的关键术语 ② 再落到可执行命令/配置 ③ 与安全或定制主干交叉时优先补 depends 边
- 可验证实例：在对应 HTML 图谱中筛选 category=CLI交互与会话，可见 12 个底层 Atom（如 交互式TUI、子命令工具箱、Slash命令）。
- 关键子主题：见顶层导图二级/三级节点；底层代表节点：交互式TUI、子命令工具箱、Slash命令、/model、/plan。

### 1.4 IDE与Desktop
- 定义：IDE与Desktop是 Codex 知识主干之一，覆盖该模块的核心概念与可操作知识点。
- 核心要点：① 先建立该主干下的关键术语 ② 再落到可执行命令/配置 ③ 与安全或定制主干交叉时优先补 depends 边
- 可验证实例：在对应 HTML 图谱中筛选 category=IDE与Desktop，可见 8 个底层 Atom（如 IDE侧边栏、chatgpt设置、CodeLens）。
- 关键子主题：见顶层导图二级/三级节点；底层代表节点：IDE侧边栏、chatgpt设置、CodeLens、IDE-Slash、/worktree。

### 1.5 沙箱与审批
- 定义：沙箱与审批是 Codex 知识主干之一，覆盖该模块的核心概念与可操作知识点。
- 核心要点：① 先建立该主干下的关键术语 ② 再落到可执行命令/配置 ③ 与安全或定制主干交叉时优先补 depends 边
- 可验证实例：在对应 HTML 图谱中筛选 category=沙箱与审批，可见 10 个底层 Atom（如 Sandbox层、Approval层、read-only）。
- 关键子主题：见顶层导图二级/三级节点；底层代表节点：Sandbox层、Approval层、read-only、workspace-write、danger-full-access。

### 1.6 配置体系
- 定义：配置体系是 Codex 知识主干之一，覆盖该模块的核心概念与可操作知识点。
- 核心要点：① 先建立该主干下的关键术语 ② 再落到可执行命令/配置 ③ 与安全或定制主干交叉时优先补 depends 边
- 可验证实例：在对应 HTML 图谱中筛选 category=配置体系，可见 8 个底层 Atom（如 用户config.toml、项目config、配置优先级）。
- 关键子主题：见顶层导图二级/三级节点；底层代表节点：用户config.toml、项目config、配置优先级、profile叠加、model配置。

### 1.7 项目定制
- 定义：项目定制是 Codex 知识主干之一，覆盖该模块的核心概念与可操作知识点。
- 核心要点：① 先建立该主干下的关键术语 ② 再落到可执行命令/配置 ③ 与安全或定制主干交叉时优先补 depends 边
- 可验证实例：在对应 HTML 图谱中筛选 category=项目定制，可见 11 个底层 Atom（如 AGENTS.md、AGENTS分层发现、/init）。
- 关键子主题：见顶层导图二级/三级节点；底层代表节点：AGENTS.md、AGENTS分层发现、/init、Skills、skills目录。

### 1.8 Cloud审查与自动化
- 定义：Cloud审查与自动化是 Codex 知识主干之一，覆盖该模块的核心概念与可操作知识点。
- 核心要点：① 先建立该主干下的关键术语 ② 再落到可执行命令/配置 ③ 与安全或定制主干交叉时优先补 depends 边
- 可验证实例：在对应 HTML 图谱中筛选 category=Cloud审查与自动化，可见 10 个底层 Atom（如 Cloud-Setup、Cloud-Agent、域名白名单）。
- 关键子主题：见顶层导图二级/三级节点；底层代表节点：Cloud-Setup、Cloud-Agent、域名白名单、codex-apply、/review。


## 二、中间层知识：多维矩阵（知识矩阵式展开）
> 📊 查看对应图表：[knowledge_middle.html](knowledge_middle.html)

### 2.1 维度定义
- 维度① 使用入口：CLI / IDE / Desktop / Cloud
- 维度② 能力主题：安装认证 / 交互操作 / 安全配置 / 定制扩展 / 自动化
- 维度③ 难度层级：入门（绿）/ 进阶（浅黄）/ 高级（深黄）

### 2.2 矩阵解读
- 重点交叉（CLI×交互操作）：TUI、Slash、/plan、/diff，是日常主路径。
- 重点交叉（CLI×安全配置）：workspace-write、on-request、config.toml，决定能否安全落地。
- 盲区标注：Desktop×自动化、Desktop×定制扩展条目稀薄——深度自动化应回到 CLI/Cloud；Cloud×安装认证几乎收敛为 ChatGPT 登录。

## 三、最底层知识：知识网络（图谱式展开）
> 📊 查看对应图表：[knowledge_bottom.html](knowledge_bottom.html)
> 依赖路径：[knowledge_bottom_dependency.html](knowledge_bottom_dependency.html) · 地铁图：[knowledge_dependency_metro.html](knowledge_dependency_metro.html)

### 3.1 核心节点群（按主干分类）
- **产品入口与形态**（6）：Codex编码Agent、CLI入口、IDE扩展入口、Desktop入口、Cloud入口、共享配置层
- **安装与认证**（8）：官方安装脚本、npm安装、Homebrew安装、版本验证、ChatGPT登录、APIKey登录、codex-login、首次会话
- **CLI交互与会话**（12）：交互式TUI、子命令工具箱、Slash命令、/model、/plan、/permissions、/diff、/compact、/status、codex-resume、codex-fork、全局CLI参数
- **IDE与Desktop**（8）：IDE侧边栏、chatgpt设置、CodeLens、IDE-Slash、/worktree、Desktop-Work、Desktop-Codex、WSL选项
- **沙箱与审批**（10）：Sandbox层、Approval层、read-only、workspace-write、danger-full-access、受保护路径、network_access、web_search、on-request审批、双层安全组合
- **配置体系**（8）：用户config.toml、项目config、配置优先级、profile叠加、model配置、Windows沙箱配置、features开关、requirements.toml
- **项目定制**（11）：AGENTS.md、AGENTS分层发现、/init、Skills、skills目录、MCP、MCP-STDIO、MCP-HTTP、codex-mcp-add、Plugins、Memories
- **Cloud审查与自动化**（10）：Cloud-Setup、Cloud-Agent、域名白名单、codex-apply、/review、codex-review、codex-exec、exec-json、GitHub-Action、ephemeral执行

### 3.2 关联类型与网络特征
- 节点总数：73；边总数：106；平均度：2.90
- depends 边：84（占比 79.2%）→ 本领域以**前置依赖**组织知识，已输出 DAG 与地铁图。
- 高频关系：depends / contains 主导；contrast 用于登录方式、沙箱模式、TUI vs exec 等对照。
- 关键枢纽节点（Top 10）：Slash命令、Codex编码Agent、codex-exec、用户config.toml、workspace-write、交互式TUI、子命令工具箱、首次会话、Sandbox层、ChatGPT登录——建议优先掌握。

### 3.3 推荐学习路径（差异化）
> 📊 查看对应图表：[knowledge_learning_path.html](knowledge_learning_path.html)

- **速成路线（约 2–3 小时）**：官方安装脚本/npm → 版本验证 → ChatGPT登录 → 首次会话 → 交互式TUI → 双层安全组合（workspace-write + on-request）→ /plan → /diff。前置：命令行与 Git。
- **系统学习路线（约 1–2 天）**：速成路径 → 用户config.toml/配置优先级 → AGENTS.md → Skills → MCP → /review → Cloud Setup/Agent → codex apply → codex exec / GitHub Action。前置：理解 Sandbox×Approval 双层模型。
- **安全加固路线**：Sandbox层 → Approval层 → workspace-write → 受保护路径 → network_access/web_search → Windows elevated → requirements.toml。
- **自动化路线**：APIKey登录 → codex-exec → exec-json → GitHub-Action；Cloud 侧补 ChatGPT登录 → Cloud入口 → apply。

## 附录 A：图表索引
- 浏览器可读文档：知识体系_OpenAI_Codex.html（网页直接打开显示为文档）
- Markdown 源文件：知识体系_OpenAI_Codex.md
- 顶层思维导图：knowledge_top.html
- 中间层知识矩阵：knowledge_middle.html
- 最底层知识图谱：knowledge_bottom.html
- 左到右学习路线图：knowledge_learning_path.html
- 依赖路径视图：knowledge_bottom_dependency.html
- 地铁线路图式学习路径：knowledge_dependency_metro.html
- 结构化数据：knowledge_graph.json / knowledge_graph.csv
- 索引页：index.html

## 附录 B：版本与更新记录
- 创建日期：2026-07-15
- 知识来源：
  1. 本地知识库 `codex/dg.md` + `p1.md`–`p6.md`
  2. https://developers.openai.com/codex
  3. https://github.com/openai/codex
  4. https://developers.openai.com/codex/llms-full.txt
- 建模规范：KSB v3.6（ksbv3 skill）
- 下次复审日期：2026-12-15（Codex 迭代快，建议 3–6 个月对照官方文档复审）
- 变更记录：v1.0 初版（基于 codex 知识库抽取 73 Atom / 106 边）