AI 编程教程中文版

OpenAI Codex 中文教程

基于 OpenAI 官方资料重写的 Codex 中文教程,覆盖 App、IDE、CLI、Cloud 和安全边界。

📖 本篇术语速查表
英文 / 缩写中文一句话解释
两条阅读路径two paths理解篇和官方教程两条主线,按目标选。
事实基准source of truth教程以官方文档为准、需实时核验的内容。
最低标准minimum bar学完该达到的基本能力门槛。

不想读完?把下面这段提示词丢给 AI 帮你跑完——帮你规划这套 Codex 教程怎么读,按你的目标排出路径和顺序。

你是 Codex 教程导读顾问,帮我按自己的目标排出这套教程该怎么读、先读什么、读到什么程度算够。

【角色】
你了解本教程的两条阅读路径(先理解原理再进官方命令配置)、各章定位、学完后的最低标准,也知道哪些内容以官方为准需实时核验。

【输入】
- 我的目标(快速上手 / 体系化理解 / 团队推广):___
- 我的基础(没用过 Agent / 用过别的工具 / 有经验):___
- 可投入时间:___
- 我最想先解决的问题:___

【工作流程】
1. 按目标和基础选阅读路径(理解篇为主还是直奔官方命令)
2. 排出章节阅读顺序
3. 标出哪些内容必须以官方实时文档为准
4. 给学完的自测标准

【输出规范】
▌一、推荐阅读路径 + 理由
▌二、章节阅读顺序
▌三、需实时核验的内容提醒
▌四、学完的自测标准

【硬约束】
- 路径按我的目标和基础定制,不一刀切
- 先理解后命令,不要一上来背配置
- 版本 / 命令类内容提醒以官方为准
- 自测标准要可检验,不空谈学会了
- 时间不够时给最小必读子集

这组教程只把稳定事实写进正文:Codex 是 OpenAI 的 coding agent,官方入口覆盖 App、IDE extension、CLI 和 Cloud。价格、模型列表、版本变化这类高波动信息只给官方入口,不在正文硬写死。

Codex 不是单一终端工具,也不是只在网页里运行的助手。OpenAI 官方教程现在把它拆成几种入口:本地 App、IDE 扩展、命令行 CLI,以及在 chatgpt.com/codex 运行的 Cloud 任务。你选择哪一个入口,取决于任务要不要贴近编辑器、要不要长期后台运行、要不要受本地 sandbox 和 approval 控制。

flowchart LR
  Need[你的任务] --> Entry{选择入口}
  Entry --> App[Codex App<br/>本地项目与桌面体验]
  Entry --> IDE[IDE Extension<br/>贴近编辑器上下文]
  Entry --> CLI[Codex CLI<br/>终端原生与脚本化]
  Entry --> Cloud[Codex Cloud<br/>后台任务与 PR 流程]
  App --> Guard[Sandbox / approvals / network]
  IDE --> Guard
  CLI --> Guard
  Cloud --> Review[Diff / logs / PR review]
  Guard --> Review

两条阅读路径

先读什么

  • 第一次用 Codex:先读从原理到实战,再跑 quickstart。
  • 已经会用但结果不稳:先补上下文、AGENTS.md、审批和沙箱。
  • 准备团队落地:先看安全边界、Cloud / GitHub 流程、托管配置和审查机制。
  • 想接 MCP、Skills、Subagents、Hooks:先确认这些能力解决的是复用、外部上下文、隔离执行还是自动检查,不要一次性全开。

学完后的最低标准

这套 Codex 教程的目标不是让你记住所有入口,而是能判断“这个任务应该怎么交给 Codex”。学完后至少要能做到:

  • 能区分 App、IDE、CLI 和 Cloud 各自适合的任务。
  • 能给 Codex 一个清楚的目标、范围、边界和验证方式。
  • 能读懂 diff、日志、测试结果和剩余风险。
  • 能用规则、Skills、MCP 或 Subagents 沉淀高频工作,而不是每次临时写长 prompt。
  • 能在安全边界内逐步放权,不把生产项目直接交给最大自治模式。

如果一个任务无法验证,就先不要交给 Codex 修改。先让它分析、分诊、列计划,再进入小范围执行。

事实基准

接下来去哪

延伸学习

本页目录