基础入门 01 Codex 是什么:四种入口与使用场景 Codex 是什么?它是 OpenAI 的 AI 编程代理,能读取项目、修改文件、运行命令并检查结果。教程用四种入口对照表讲清桌面 App、CLI、IDE 扩展与云端 Web 的区别,也说明它和 ChatGPT、Claude Code 的关系。附入口流程图、能力边界、安装检测命令和常见问题,帮你选对起点再动手。 02 Codex 核心概念教程 Codex 核心概念教程讲清代理循环、沙箱、审批、AGENTS.md、记忆与本地/云端执行边界。你会知道 Codex 为什么有时直接动手、有时停下来询问,以及项目规则该写在哪里。附权限关系图、配置对照和只读模式实验,跟着步骤亲眼验证工作区写入怎样被拦截,少走一遍权限配置的弯路,再进入安装与首次任务。 03 Codex 安装与登录教程(Mac / Windows / Linux) Codex 安装教程覆盖 macOS、Windows、Linux,带你选择 ChatGPT 桌面 App 或 CLI,完成安装、验证、登录和首次运行。遇到 command not found、登录回调失败或多版本冲突时,按步骤检查 PATH、设备码登录与安装来源。附平台图、预期结果与排错步骤,照着步骤跑通安装链路。 04 Codex 订阅与计费说明 Codex 订阅与计费说明讲清 ChatGPT Go、Plus、Pro、Business 套餐与 API key 按量付费的区别,并解释滚动限额、积分和用量查看方式。你可以按使用频率、团队规模和是否需要自动化调用判断该选哪种方案,也能在额度不足时找到对应处理办法,开始前先把成本算明白,并查看官方入口。 05 Codex 接入 DeepSeek 等国产模型教程 Codex 接入第三方模型教程讲清自定义 model provider 的工作原理,并以 DeepSeek 为例配置环境变量、config.toml、模型名称和 Responses API。你会知道直连与代理工具各适合什么情况,如何发送最小请求验证连接,以及遇到鉴权、协议或思考深度不兼容时从哪里排查。 06 Codex 第一个任务实战教程 Codex 第一个任务实战教程用一个可回滚的小项目,带你完成只读分析、编写提示词、审查 diff、批准或拒绝改动、运行验证和 Git 回滚。CLI 与桌面端分别给出操作路径和预期结果,让你第一次动手就建立“先看、再改、验证、提交”的安全节奏,而不是看见结果就直接接受。附两种入口的完整操作与检查方法。 使用入口 07 Codex 桌面 App 使用教程 Codex 桌面 App 使用教程说明当前 ChatGPT 桌面应用里的 Codex 工作区,覆盖下载安装到添加项目、Local、Worktree 与 Cloud 运行位置、Diff 审阅、内置终端和并行线程。跟着步骤完成第一个桌面任务,学会判断改动落在哪个工作区、怎样检查结果,以及何时把线程交回本地继续处理。 08 Codex CLI 上手教程 Codex CLI 使用教程从命令结构、交互式 TUI、常用参数、斜杠命令和键盘操作讲起,并带你在 Git 项目里完成第一次只读分析、文件修改、diff 审查与验证。你会分清交互会话和 codex exec 的适用场景,知道权限提示出现在哪一步,也能用界面状态确认模型、工作目录和任务是否真的完成清楚。 09 Codex IDE 扩展使用教程 Codex IDE 扩展使用教程覆盖 VS Code、Cursor 等兼容编辑器的安装、登录、项目上下文、文件引用、权限选择、模型设置和云端委派。跟着步骤完成第一次代码分析与修改,学会用选中代码和 @file 缩小范围、从 diff 检查结果,并在扩展图标不见、上下文不准或任务位置选错时快速定位原因。 10 Codex Cloud 云端使用教程 Codex Cloud 云端使用教程讲清 GitHub 仓库连接、云端环境、设置脚本、环境变量、Secrets、容器缓存、网络白名单和任务交付流程。你会知道什么任务适合放到云端并行跑,怎样配置环境后提交第一个任务、审查 diff 并接回本地,也能避开依赖下载失败、密钥暴露和把未提交代码误当成已上传的坑。 工作流与配置 11 Codex AGENTS.md 项目说明书配置指南 Codex AGENTS.md 项目说明书配置指南讲清全局文件、项目文件、子目录规则和 AGENTS.override.md 的发现与优先级,并给出精简内容清单、备用文件名和大小上限配置。跟着示例创建一份能被 Codex 稳定读取的项目说明书,再用复述指令验证加载结果,避免规矩写了却被更近文件覆盖或被冗长背景淹没。 12 Codex 斜杠命令与快捷键教程 Codex 斜杠命令与快捷键教程按初始化、会话调整、改动审查和退出恢复等场景整理常用操作,并区分 CLI、ChatGPT 桌面应用与 IDE 扩展的命令范围。你会用当前界面的斜杠菜单确认可用命令,分清清屏、开新会话和压缩上下文的差别,再通过最小实操验证状态、diff、排队输入、快捷操作与完整预期结果。 13 Codex 提示词写法指南 Codex 提示词写法指南用“目标、上下文、边界、输出与验证”拆开一个好需求,说明怎样引用文件、粘贴报错、限定改动范围、拆分复杂任务并给出可检查的完成标准。通过同一 bug 的模糊与精确提示对照,你能写出 Codex 少猜、自己会验证的任务说明,也知道什么时候先规划、什么时候直接让它动手,减少来回返工。 14 Codex 日常工作流教程:探索、修 bug、重构、写测试 Codex 日常工作流教程把真实项目中的高频任务拆成探索代码库、修 bug、重构和写测试四类,分别给出可复制的提示骨架、执行顺序、审查重点和验证办法。你会知道只读探索时该给什么上下文,修复时怎样先复现根因,重构时如何保持行为不变,以及写测试时怎样补齐正常路径和边界情况,最后用一个小项目跑通修复闭环。 15 Codex 权限、沙箱与审批配置教程 Codex 权限、沙箱与审批配置教程讲清三种沙箱模式和三种审批策略的区别,提供命令行、config.toml、rules 与权限配置档示例,并说明网络访问、受保护路径和 --yolo 的安全边界。按步骤切换并验证权限,为本机开发、只读审查或隔离自动化选择合适组合,避免把高风险配置设成全局默认等常见误区。 16 Codex 安全与风险边界指南 Codex 安全与风险边界指南讲清沙箱、审批、提示注入与敏感数据泄露的真实边界,说明 Auto-review、Cyber Safety 和 Codex Security 的作用。你可以按高危操作清单检查联网、凭证、删除与提权请求,再通过网络隔离实验验证默认防线,建立适合本机、敏感项目和陌生代码库的安全使用习惯。 17 Codex 电脑操控与浏览器使用教程 Codex 电脑操控与浏览器使用教程讲清内置浏览器、Chrome 扩展和 Computer Use 三条路径,说明各自适合的网页、登录态与桌面应用场景。页面覆盖插件安装、网站与应用审批、macOS 和 Windows 权限、锁定使用及提示注入风险,并带你用本地页面完成一次只读验证。按步骤选择入口并守住不可逆操作边界。 18 Codex config.toml 配置详解 Codex config.toml 配置详解覆盖文件位置、六层优先级和常用参数,讲清模型、审批、沙箱、网页搜索、沟通风格与功能开关的作用。页面提供最小配置、命令行临时覆盖和 profile 切换示例,帮助你判断配置来源、避开项目级受限键与 TOML 顺序错误,并把常用行为保存为稳定默认值,附操作建议。 扩展能力 19 Codex 记忆系统使用教程 Codex 记忆系统使用教程讲清 AGENTS.md 与本地 Memories 的区别,演示如何开启记忆、使用 /memories 控制当前会话,并说明生成、注入、外部上下文过滤与本地存储规则。页面还介绍 Chronicle 的屏幕记忆能力、适用平台和隐私风险,帮助你判断哪些信息值得跨会话保留、哪些内容必须排除。 20 Codex MCP 外部工具接入教程 Codex MCP 外部工具接入教程讲清 STDIO 与 Streamable HTTP 两种 Server 形态,演示使用 codex mcp 和 config.toml 添加、认证、启停及限制工具。页面带你接入 Context7 完成一次文档查询,并说明超时、审批和提示注入风险,帮助你按最小权限连接外部数据与服务。 21 Codex 子代理使用教程 Codex 子代理使用教程讲清什么时候应把代码探索、测试和日志分析拆给并行 Agent,什么时候留在主线程更省成本。页面演示直接委派、使用 /agent 查看线程,以及在 .codex/agents 中创建只读自定义 Agent,并说明模型、推理强度、沙箱继承和并发配置,帮助你完成一次可验证的并行审查。 22 Codex Agent Skills 技能使用教程 Codex Agent Skills 技能使用教程讲清 SKILL.md 结构、渐进式披露和显式、隐式两种触发方式,说明仓库级与用户级技能目录。页面演示用 skill-creator 创建技能、用 skill-installer 安装精选技能,并通过 /skills 验证加载结果,帮助你把重复流程封装为可复用能力。 23 Codex 插件使用教程 Codex 插件使用教程讲清插件如何打包 Skills、Apps、MCP Server 与 Hooks,覆盖插件目录、市场添加、安装启停和 @ 调用流程。说明 plugin.json 与组件目录结构,帮助你判断 Skill 和插件的适用场景,并在安装第三方插件前检查代码执行、数据流向与信任边界。附命令和常见问题排查。 24 Codex 规则与钩子配置教程 Codex 规则与钩子配置教程讲清 Rules 如何控制沙箱外命令,Hooks 如何在工具调用和会话等事件自动执行脚本。页面覆盖 prefix_rule、matcher、信任审阅、stdin JSON、退出码和 stdout 控制,并提供自动格式化、危险命令拦截与触发验证示例。附配置模板、预期结果和钩子不触发排查步骤。 协作与自动化 25 Codex Worktrees 并行隔离教程 Codex Worktrees 并行隔离教程讲清 worktree 如何让多个任务同时推进且互不覆盖,覆盖创建线程、detached HEAD、同一分支检出限制和 Local/Worktree Handoff。页面还说明环境 setup 脚本、清理上限、快照恢复与实操主链,帮助你并行开发。附步骤、预期结果和冲突排查。 26 Codex Git 与 GitHub 集成教程 Codex Git 与 GitHub 集成教程讲清 Pull Request 中的 @codex review、自动审查与 @codex fix,覆盖 AGENTS.md 审查规则、本地 /review 和 gh CLI。页面说明可修改分支、结果验证,以及为何合并和强推必须由人确认。附操作步骤、权限边界与问题排查。 27 Codex 自动化与 CI/CD 教程 Codex 自动化与 CI/CD 教程讲清 GitHub Actions 与 Automations 两条路线,覆盖 codex exec、PR 审查、CI 修复和定时简报。页面拆解 workflow YAML、action 输入、API 密钥、最小权限与网络边界,并带你创建任务。附配置示例、预期结果和失败排查。 28 Codex 非交互模式 codex exec 教程 讲解 Codex 非交互模式 codex exec 的参数、输出和脚本场景,帮助用户把 Codex 放进自动化流程。 29 Codex Slack、Linear 与 SDK 集成教程 介绍 Codex 与 Slack、Linear 和 SDK 的集成方式,帮助团队把 Codex 嵌入现有协作和产品流程。 进阶参考 30 Codex 模型选择指南 Codex 模型选择指南讲清 GPT-5.6 Sol、Terra、Luna 的任务定位,以及推理强度、/model、config.toml 和 -m 参数的切换方法。你可以按复杂度、速度与成本选择默认 Power、日常均衡或批量任务档位,并通过同一任务对比验证效果;附模型示意图、配置示例和旧模型迁移提醒,照着完成设置。
01 Codex 是什么:四种入口与使用场景 Codex 是什么?它是 OpenAI 的 AI 编程代理,能读取项目、修改文件、运行命令并检查结果。教程用四种入口对照表讲清桌面 App、CLI、IDE 扩展与云端 Web 的区别,也说明它和 ChatGPT、Claude Code 的关系。附入口流程图、能力边界、安装检测命令和常见问题,帮你选对起点再动手。
02 Codex 核心概念教程 Codex 核心概念教程讲清代理循环、沙箱、审批、AGENTS.md、记忆与本地/云端执行边界。你会知道 Codex 为什么有时直接动手、有时停下来询问,以及项目规则该写在哪里。附权限关系图、配置对照和只读模式实验,跟着步骤亲眼验证工作区写入怎样被拦截,少走一遍权限配置的弯路,再进入安装与首次任务。
03 Codex 安装与登录教程(Mac / Windows / Linux) Codex 安装教程覆盖 macOS、Windows、Linux,带你选择 ChatGPT 桌面 App 或 CLI,完成安装、验证、登录和首次运行。遇到 command not found、登录回调失败或多版本冲突时,按步骤检查 PATH、设备码登录与安装来源。附平台图、预期结果与排错步骤,照着步骤跑通安装链路。
04 Codex 订阅与计费说明 Codex 订阅与计费说明讲清 ChatGPT Go、Plus、Pro、Business 套餐与 API key 按量付费的区别,并解释滚动限额、积分和用量查看方式。你可以按使用频率、团队规模和是否需要自动化调用判断该选哪种方案,也能在额度不足时找到对应处理办法,开始前先把成本算明白,并查看官方入口。
05 Codex 接入 DeepSeek 等国产模型教程 Codex 接入第三方模型教程讲清自定义 model provider 的工作原理,并以 DeepSeek 为例配置环境变量、config.toml、模型名称和 Responses API。你会知道直连与代理工具各适合什么情况,如何发送最小请求验证连接,以及遇到鉴权、协议或思考深度不兼容时从哪里排查。
06 Codex 第一个任务实战教程 Codex 第一个任务实战教程用一个可回滚的小项目,带你完成只读分析、编写提示词、审查 diff、批准或拒绝改动、运行验证和 Git 回滚。CLI 与桌面端分别给出操作路径和预期结果,让你第一次动手就建立“先看、再改、验证、提交”的安全节奏,而不是看见结果就直接接受。附两种入口的完整操作与检查方法。
07 Codex 桌面 App 使用教程 Codex 桌面 App 使用教程说明当前 ChatGPT 桌面应用里的 Codex 工作区,覆盖下载安装到添加项目、Local、Worktree 与 Cloud 运行位置、Diff 审阅、内置终端和并行线程。跟着步骤完成第一个桌面任务,学会判断改动落在哪个工作区、怎样检查结果,以及何时把线程交回本地继续处理。
08 Codex CLI 上手教程 Codex CLI 使用教程从命令结构、交互式 TUI、常用参数、斜杠命令和键盘操作讲起,并带你在 Git 项目里完成第一次只读分析、文件修改、diff 审查与验证。你会分清交互会话和 codex exec 的适用场景,知道权限提示出现在哪一步,也能用界面状态确认模型、工作目录和任务是否真的完成清楚。
09 Codex IDE 扩展使用教程 Codex IDE 扩展使用教程覆盖 VS Code、Cursor 等兼容编辑器的安装、登录、项目上下文、文件引用、权限选择、模型设置和云端委派。跟着步骤完成第一次代码分析与修改,学会用选中代码和 @file 缩小范围、从 diff 检查结果,并在扩展图标不见、上下文不准或任务位置选错时快速定位原因。
10 Codex Cloud 云端使用教程 Codex Cloud 云端使用教程讲清 GitHub 仓库连接、云端环境、设置脚本、环境变量、Secrets、容器缓存、网络白名单和任务交付流程。你会知道什么任务适合放到云端并行跑,怎样配置环境后提交第一个任务、审查 diff 并接回本地,也能避开依赖下载失败、密钥暴露和把未提交代码误当成已上传的坑。
11 Codex AGENTS.md 项目说明书配置指南 Codex AGENTS.md 项目说明书配置指南讲清全局文件、项目文件、子目录规则和 AGENTS.override.md 的发现与优先级,并给出精简内容清单、备用文件名和大小上限配置。跟着示例创建一份能被 Codex 稳定读取的项目说明书,再用复述指令验证加载结果,避免规矩写了却被更近文件覆盖或被冗长背景淹没。
12 Codex 斜杠命令与快捷键教程 Codex 斜杠命令与快捷键教程按初始化、会话调整、改动审查和退出恢复等场景整理常用操作,并区分 CLI、ChatGPT 桌面应用与 IDE 扩展的命令范围。你会用当前界面的斜杠菜单确认可用命令,分清清屏、开新会话和压缩上下文的差别,再通过最小实操验证状态、diff、排队输入、快捷操作与完整预期结果。
13 Codex 提示词写法指南 Codex 提示词写法指南用“目标、上下文、边界、输出与验证”拆开一个好需求,说明怎样引用文件、粘贴报错、限定改动范围、拆分复杂任务并给出可检查的完成标准。通过同一 bug 的模糊与精确提示对照,你能写出 Codex 少猜、自己会验证的任务说明,也知道什么时候先规划、什么时候直接让它动手,减少来回返工。
14 Codex 日常工作流教程:探索、修 bug、重构、写测试 Codex 日常工作流教程把真实项目中的高频任务拆成探索代码库、修 bug、重构和写测试四类,分别给出可复制的提示骨架、执行顺序、审查重点和验证办法。你会知道只读探索时该给什么上下文,修复时怎样先复现根因,重构时如何保持行为不变,以及写测试时怎样补齐正常路径和边界情况,最后用一个小项目跑通修复闭环。
15 Codex 权限、沙箱与审批配置教程 Codex 权限、沙箱与审批配置教程讲清三种沙箱模式和三种审批策略的区别,提供命令行、config.toml、rules 与权限配置档示例,并说明网络访问、受保护路径和 --yolo 的安全边界。按步骤切换并验证权限,为本机开发、只读审查或隔离自动化选择合适组合,避免把高风险配置设成全局默认等常见误区。
16 Codex 安全与风险边界指南 Codex 安全与风险边界指南讲清沙箱、审批、提示注入与敏感数据泄露的真实边界,说明 Auto-review、Cyber Safety 和 Codex Security 的作用。你可以按高危操作清单检查联网、凭证、删除与提权请求,再通过网络隔离实验验证默认防线,建立适合本机、敏感项目和陌生代码库的安全使用习惯。
17 Codex 电脑操控与浏览器使用教程 Codex 电脑操控与浏览器使用教程讲清内置浏览器、Chrome 扩展和 Computer Use 三条路径,说明各自适合的网页、登录态与桌面应用场景。页面覆盖插件安装、网站与应用审批、macOS 和 Windows 权限、锁定使用及提示注入风险,并带你用本地页面完成一次只读验证。按步骤选择入口并守住不可逆操作边界。
18 Codex config.toml 配置详解 Codex config.toml 配置详解覆盖文件位置、六层优先级和常用参数,讲清模型、审批、沙箱、网页搜索、沟通风格与功能开关的作用。页面提供最小配置、命令行临时覆盖和 profile 切换示例,帮助你判断配置来源、避开项目级受限键与 TOML 顺序错误,并把常用行为保存为稳定默认值,附操作建议。
19 Codex 记忆系统使用教程 Codex 记忆系统使用教程讲清 AGENTS.md 与本地 Memories 的区别,演示如何开启记忆、使用 /memories 控制当前会话,并说明生成、注入、外部上下文过滤与本地存储规则。页面还介绍 Chronicle 的屏幕记忆能力、适用平台和隐私风险,帮助你判断哪些信息值得跨会话保留、哪些内容必须排除。
20 Codex MCP 外部工具接入教程 Codex MCP 外部工具接入教程讲清 STDIO 与 Streamable HTTP 两种 Server 形态,演示使用 codex mcp 和 config.toml 添加、认证、启停及限制工具。页面带你接入 Context7 完成一次文档查询,并说明超时、审批和提示注入风险,帮助你按最小权限连接外部数据与服务。
21 Codex 子代理使用教程 Codex 子代理使用教程讲清什么时候应把代码探索、测试和日志分析拆给并行 Agent,什么时候留在主线程更省成本。页面演示直接委派、使用 /agent 查看线程,以及在 .codex/agents 中创建只读自定义 Agent,并说明模型、推理强度、沙箱继承和并发配置,帮助你完成一次可验证的并行审查。
22 Codex Agent Skills 技能使用教程 Codex Agent Skills 技能使用教程讲清 SKILL.md 结构、渐进式披露和显式、隐式两种触发方式,说明仓库级与用户级技能目录。页面演示用 skill-creator 创建技能、用 skill-installer 安装精选技能,并通过 /skills 验证加载结果,帮助你把重复流程封装为可复用能力。
23 Codex 插件使用教程 Codex 插件使用教程讲清插件如何打包 Skills、Apps、MCP Server 与 Hooks,覆盖插件目录、市场添加、安装启停和 @ 调用流程。说明 plugin.json 与组件目录结构,帮助你判断 Skill 和插件的适用场景,并在安装第三方插件前检查代码执行、数据流向与信任边界。附命令和常见问题排查。
24 Codex 规则与钩子配置教程 Codex 规则与钩子配置教程讲清 Rules 如何控制沙箱外命令,Hooks 如何在工具调用和会话等事件自动执行脚本。页面覆盖 prefix_rule、matcher、信任审阅、stdin JSON、退出码和 stdout 控制,并提供自动格式化、危险命令拦截与触发验证示例。附配置模板、预期结果和钩子不触发排查步骤。
25 Codex Worktrees 并行隔离教程 Codex Worktrees 并行隔离教程讲清 worktree 如何让多个任务同时推进且互不覆盖,覆盖创建线程、detached HEAD、同一分支检出限制和 Local/Worktree Handoff。页面还说明环境 setup 脚本、清理上限、快照恢复与实操主链,帮助你并行开发。附步骤、预期结果和冲突排查。
26 Codex Git 与 GitHub 集成教程 Codex Git 与 GitHub 集成教程讲清 Pull Request 中的 @codex review、自动审查与 @codex fix,覆盖 AGENTS.md 审查规则、本地 /review 和 gh CLI。页面说明可修改分支、结果验证,以及为何合并和强推必须由人确认。附操作步骤、权限边界与问题排查。
27 Codex 自动化与 CI/CD 教程 Codex 自动化与 CI/CD 教程讲清 GitHub Actions 与 Automations 两条路线,覆盖 codex exec、PR 审查、CI 修复和定时简报。页面拆解 workflow YAML、action 输入、API 密钥、最小权限与网络边界,并带你创建任务。附配置示例、预期结果和失败排查。
30 Codex 模型选择指南 Codex 模型选择指南讲清 GPT-5.6 Sol、Terra、Luna 的任务定位,以及推理强度、/model、config.toml 和 -m 参数的切换方法。你可以按复杂度、速度与成本选择默认 Power、日常均衡或批量任务档位,并通过同一任务对比验证效果;附模型示意图、配置示例和旧模型迁移提醒,照着完成设置。