推荐：先接入 API，再跟着教程练

1. 1打开 mrwhale.ai 注册，在控制台创建 Token（建议命名 Codex）。
2. 2阅读 接入 MrWhale 或主站 Codex 接入文档。
3. 3按下方学习路线使用桌面 App / CLI；教程正文来自开源 CodexGuide，未改字。

导读

这份教程适合谁

本站不是一份命令速查表，而是一份围绕真实工作流组织的 Codex 实践指南。它帮助不同背景的人回答三个问题：我该从哪个入口开始，怎样把需求交给 Codex，怎样确认它交付的是可靠结果。

17 节系统指南从桌面 App、CLI、IDE 到 Cloud，按阶段建立完整使用习惯。13 个实战案例把 Codex 放进 PPT、Draw.io、Playwright、Obsidian、飞书、CI 等真实场景。4 类配置主题覆盖 CLI 选项、config.toml、MCP/Skills/Subagents 与安全管理。3 组实践方法任务设计、非开发工作流、团队 playbook，帮助你把经验沉淀下来。

路径

三条推荐学习路径

不同起点不需要读同一条路。先选与你当前工作最贴近的路径，再回头补全基础概念。

第一次使用 Codex安装电脑端客户端，了解界面，完成第一个低风险任务。适合初学者、产品、运营、技术写作者开发者本地提效在 CLI 中读项目、改代码、跑测试，形成可验证的工程闭环。适合前端、后端、全栈、开源维护者团队落地与规范用 AGENTS.md、权限边界、案例库和复盘模板统一协作方式。适合技术负责人、团队 Lead、内部工具负责人

入口

先选对入口

Codex 的能力会出现在 App、CLI、Cloud、IDE、ChatGPT 和集成生态里。入口不同，任务节奏也不同：本地小步修改适合 CLI，长任务和并行任务适合 Cloud，贴近编辑器的解释与局部改动适合 IDE，跨工具流程适合 App 和插件体系。

查看入口地图了解桌面 AppVS Code 使用方式

方法

把一次任务做成闭环

好用 Codex 的关键不是把 prompt 写得花哨，而是让它始终知道目标、范围、约束、验证方式和交付格式。教程会反复训练这一套闭环。

说明写清目标、范围、禁止事项、上下文和期望输出。执行理解 Codex 如何读文件、运行命令、小步修改和汇报状态。控制设置沙盒、审批、网络和凭据边界，让任务可控。验证用测试、构建、截图、日志和 PR 检查结果是否可靠。沉淀把成功任务整理成模板、案例和团队规则。

案例

精选实战场景

案例库不是展示清单，而是可改写的任务样本。你可以直接换成自己的项目、工具、账号和验证方式。

一句话生成演示文稿学习如何调用 Skill，把主题变成结构化 slide deck。让 Codex 操控浏览器用 Playwright MCP 打开页面、点击、截图、检查状态。连接 Obsidian 知识库在本地笔记中生成内容、配图和可追踪引用。CI 失败自动修复从失败日志定位问题，让 Codex 修复并生成 PR。

工程

为真实项目准备

当 Codex 进入团队项目，真正重要的是边界、复现和共识。教程会把每次任务拆成可检查的输入与输出，帮助你减少“看起来完成了，但没人敢合并”的尴尬时刻。

• 用 AGENTS.md 写清项目命令、代码风格和禁止事项。
• 用 沙盒与审批 管理文件、网络、凭据和高风险命令。
• 用 团队 playbook 统一任务模板、复盘结构和案例沉淀。
• 用 排障手册 快速定位登录、权限、依赖和执行异常。

开始

建议从这里开始

如果你只有二十分钟，先完成桌面 App 路线的前五节；如果你已经在项目里写代码，直接从 CLI 安装和第一次本地任务开始。读完第一轮后，再回到配置、权限和案例库，把真实流程固化为可复用的工作方法。

接入 MrWhale API进入学习路线主站接入文档

基础资料最后核对：2026-05-27。涉及功能、价格、可用性与安全策略，请以 OpenAI 官方资料为准。教程正文基于 CodexGuide（MIT），由 MrWhale 编排呈现。