Codex 完整教程

欢迎来到 Codex 完整教程。本教程基于 OpenAI 官方文档(developers.openai.com/codex)与开源实现(openai/codex)整理,以 Codex 桌面应用(Desktop App)为主线,同时兼顾 Codex CLI、IDE 扩展与云端版本,帮助你从「装上能跑」一路走到「理解原理、深度定制、团队落地与自动化」。

Codex 桌面应用主界面

Codex 桌面应用的「新建对话」界面:左侧为导航栏(对话、搜索、插件、自动化、任务、项目、云端),中间是提示输入框与权限、模型、推理强度选择器。


这套教程适合谁

  • 想用 可视化桌面应用 驱动 AI 编程,而不只是敲终端命令的开发者
  • 已经在用 Codex CLI,想系统了解 App、Cloud、Computer Use、Plugins 等新能力
  • 需要在 团队 / 企业 中落地规范(AGENTS.md、Skills、权限、规则与钩子)的技术负责人

教程地图

一、入门基础

章节你将学到
Codex 简介Codex 是什么、产品矩阵(App / CLI / IDE / Cloud)、计费
核心概念Agent 循环、指令链、渐进式披露、三道权限闸门、五层定制
安装与使用下载桌面应用、安装 CLI、登录认证
桌面应用首次启动、添加项目、Local/Cloud、Hand off、并行线程
App 界面说明侧边栏、对话区、Diff 审查、顶部与底部状态栏逐项拆解
基础入门App 与 CLI 各完成一个可验证的小任务

二、配置与定制

章节你将学到
配置与定制config.toml 分层、Profile、CODEX_HOME
权限设置沙箱模式、审批策略、Auto/Read-only/Full access 预设
AGENTS.md持久项目规范的发现、合并与团队落地
Agent SkillsSKILL.md、渐进式披露、Plugin 与插件市场
斜杠命令/status/model/approvals/review/goal
规则与钩子Starlark 命令规则、生命周期 Hooks

三、进阶能力

章节你将学到
电脑操控(Computer Use)看屏、操控 GUI、应用内浏览器、Appshots、Goal 模式
模型选择GPT-5.5 / 5.4 / 5.4-mini / Codex Spark 与推理强度
子代理探索 / 审查 / 专责 MCP 的分工模式
MCP 集成通过 MCP 连接外部系统
集成与连接插件市场、Apps/连接器、Figma/Linear/Slack/GitHub
工作流与 Worktrees多线程并行、worktree 隔离、规划→执行→审查
自动化与 CI/CDApp Automations、非交互模式、GitHub Actions
提示词最佳实践写出高命中率指令的结构与技巧
进阶使用技巧上下文管理、检查点、resume/fork、@提及、图片

四、入口、安全与实践

章节你将学到
IDE 扩展VS Code / Cursor 中使用 Codex
云端版本chatgpt.com/codex、@codex、PR、移动端
安全与企业管理沙箱、requirements.toml、托管配置、审计
实战案例重构、自动审查、Issue→PR 端到端
速查表命令 / 斜杠 / 配置 / 模型一页速览
命令行工具(CLI)CLI 配置、沙箱、模型、Skills、提示词、实用示例
资源与延伸阅读官方文档与社区索引

学习路径建议

阶段目标推荐阅读
第 1 天装好桌面应用,完成第一个小任务简介 → 安装 → 桌面应用 → 基础入门
第 2–3 天看懂界面、理解 Agent 如何工作App 界面说明 → 核心概念 → 权限设置
第 1 周在团队仓库落地规范AGENTS.md → Skills → 斜杠命令 → MCP
进阶用好新能力电脑操控 → 集成与连接 → 工作流 → 自动化
持续规模化与安全合规安全与企业 → 规则与钩子 → CLI → 实战案例

前置知识

  • 熟悉终端与 Git 基本操作(App 大量功能基于 Git)
  • 了解至少一门编程语言
  • 拥有 ChatGPT Plus / Pro / Business / Edu / Enterprise 套餐,或 OpenAI API 额度

版本说明: Codex 迭代很快,模型名称、功能标志与界面会变化,请以 官方文档 为准。本教程基于 2026 年公开文档整理。