OpenAI Codex 从入门到精通全景全量指南

这份思维导图为 OpenAI Codex 系统化学习指南，按照学习路径划分九大模块，完整覆盖理论认知、实操落地与拓展应用。本图系统拆解 Codex 核心架构：涵盖环境搭建、CLI/TUI 控制、Prompt 设计三原则及安全机制。重点解构文档管理、数据清洗、脚本开发与团队协作四大场景，提供 MCP 扩展、配置文件模板与斜杠命令速查表。一图掌握从底层执行引擎到自动化工作流的全套方法论，解锁 AI 协作新范式！适用人群：后端开发、运维工程师、研发效能工程师、AI 工具爱好者、想要搭建本地代码自动化工作流的技术人员。

OpenAI Codex 从入门到精通全景全量指南

• 1. 基础认知与核心定位
  • 系统定位
    • OpenAI 推出的人工智能工作与代码代理（AI Agent）
    • 核心逻辑：自然语言指令（Prompt） -> 自动化实操执行（Execution）
  • 核心能力全景
    • 文件与项目管理：增删改查、批量重命名、文本/表格格式清洗与转换
    • 本地终端执行：运行 Shell 命令、依赖安装、构建部署、批处理脚本
    • 代码与脚本处理：编写、重构、语法检查、单元测试生成、报错自动修复
    • MCP 协议与生态扩展：连接数据库（PostgreSQL/SQLite）、API、GitHub、Notion
    • 项目记忆与代理控制：通过 AGENTS.md` 自定义行为准则与项目规则
• 2. 环境搭建、安装与初始化
  • 环境准备
    • Node.js / Python 运行时要求
    • API Key 或 ChatGPT 账号授权登录
  • 安装方式
    • NPM 全局安装：`npm install -g @openai/codex
    • Homebrew 安装（macOS/Linux）：`brew install codex
  • 初始化配置
    • 执行 `codex init` 自动生成本地配置目录
    • 检查环境连通性与模型节点
• 3. 命令行（CLI）全量指令与参数
  • 启动模式全集
    • codex`：启动交互式 TUI 界面，用于日常多轮对话与任务控制
    • codex "提示词"：带初始 Prompt 直接启动，快速带入具体任务
    • codex exec "任务"：非交互模式，单次自动执行并退出，适用于 CI/CD 与批处理
    • codex resume`：恢复上一次中断的会话历史
  • 命令行控制参数 Flags
    • -C, --cd <路径>`：切换工作目录
    • -m, --model <模型>`：切换底层 LLM 模型（如 `gpt-4o`）
    • -y, --yes / --auto-approve`：全自动模式，跳过安全审批提示
    • --config <路径>：加载指定的配置文件
    • --verbose`：输出详细的 Debug 日志
• 4. TUI 交互界面全功能与快捷操作
  • 控制快捷键
    • Ctrl + C：终止当前生成或打断命令
    • Ctrl + D`：退出 Codex 终端
    • Tab：智能补全文件路径与文件名
    • PageUp / PageDown：向上/向下滚动查看历史对话
    • Up / Down 方向键`：翻阅历史 Prompt 记录
  • 内置斜杠命令 Slash Commands
    • /help`：显示全部内置命令清单
    • /clear`：清空当前上下文屏幕
    • /compact`：压缩对话历史，精简 Token
    • /history`：查看会话调用日志与操作记录
    • /cost`：查看当前会话消耗的 Token 与估算费用
    • /model`：实时切换调用的模型
    • /approval`：动态切换权限控制模式
    • /undo`：撤销上一步操作
• 5. 配置体系与上下文管理
  • 双层 AGENTS.md 规则注入
    • 全局配置 ~/.codex/AGENTS.md`)：跨项目全局生效，设定个人偏好
    • 项目配置 (`<项目根目录>/AGENTS.md：仅在当前项目生效，设定项目规范
    • 优先级关系：项目级 `AGENTS.md > 全局 `AGENTS.md
  • 全局配置文件 (`config.toml
    • 默认模型设置 model = "gpt-4o"
    • 权限策略 read_files`, `write_files`, `run_commands
    • 忽略文件黑名单 ignore_patterns
    • 超时与重试机制
  • 上下文精准引用与定位
    • @路径/文件名`：精准引入指定文件内容
    • @文件夹/：递归引入整个文件夹结构与内容
    • @git-diff`：引入当前 Git 工作区改动
• 6. 四大底层执行与安全机制
  • 四大底层执行引擎
    • 文件系统全量操作：读取、创建、更新、重构、格式转换
    • 本地 Shell 命令执行：支持 Bash/Zsh/PowerShell 执行与结果捕获
    • 代码与文档分析引擎：语法检查、逻辑推演、自动 Bug 调试与修复
    • MCP 协议扩展引擎：连接第三方数据库、工具 API 及知识库
  • 三层安全与权限防护机制
    • 沙箱隔离 (Sandbox)：限制未授权跨目录访问
    • 交互式安全审批 Approval)：写/删文件或执行命令时确认
    • 配置黑名单 Locking)：锁定敏感文件（如 `.env）
• 7. 高效 Prompt 撰写三原则与模式
  • 核心公式
    • 高效 Prompt = 明确背景 Context) + 边界限制 (Constraints) + 验收标准 Criteria
  • 三原则解析
    • 明确背景：设定角色、目标受众与前置条件
    • 设定边界：限定文件范围、格式要求
    • 明确验收：指定生成成果形式与存盘路径
• 8. 4 大典型实战应用场景
  • 本地知识库与文档处理
    • 自动读取大文档/笔记，提取核心结构并整理为 Markdown
    • 批量重命名文件，整理个人笔记目录
  • 数据清洗与报表自动化
    • 读取 CSV/JSON 数据，使用 Python 脚本自动化清洗与汇总
    • 自动导出格式化 Excel 报表或统计分析 Markdown
  • 项目开发与脚本自动化
    • 从零构建 Python/JS 自动化脚本或 Demo 项目
    • 自动运行测试用例，识别错误并实施自我修复
  • 多工具工作流协同 (MCP
    • 结合 GitHub 提取 Issue/PR 并生成更新日志
    • 结合 Notion/Calendar 进行自动化任务排期与记录
• 9. 环境集成与扩展
  • 编辑器/IDE 集成
    • VS Code / Cursor 插件：侧边栏交互、改动对比与一键 Apply
    • JetBrains 系列 IDE 插件支持
  • 团队协作与标准化
    • 项目仓库中版本控制共享 AGENTS.md
    • 统一团队的 Prompt 规则、代码风格与自动化测试规范