OpenAI Codex 知识体系

Codex 是 OpenAI 的编码 Agent：在授权范围内读写代码、执行命令，并在 CLI / IDE / Desktop / Cloud 四入口共享配置与能力。

本文基于仓库知识库 codex/（dg.md + p1–p6.md，源自 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

读图指引：根节点「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

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_dependency.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

• 速成路线（约 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
5. 建模规范：KSB v3.6（ksbv3 skill）
6. 下次复审日期：2026-12-15（Codex 迭代快，建议 3–6 个月对照官方文档复审）
7. 变更记录：v1.0 初版（基于 codex 知识库抽取 73 Atom / 106 边）