Skip to content

Codex 中文手册先划清边界,再让它写代码

从装上 CLI 到把它交给 CI 的完整中文教程,外加 133 篇官方中文文档镜像。简体繁体都有,一个字都没经过机器翻译。

Codex 中文手册
133篇官方文档镜像
15篇原创教程
2种中文(简 / 繁)
0篇机器翻译

Reading Path / 01—03

三条路径,按你现在的位置进入

不必从头读。第一次装就从「快速上手」,已经在用就跳「进阶」,手上有具体的活就去「实战案例」里找最像的那个,改成你自己的。要查某个配置项,直接进「官方文档」按原目录找。

入门 · 6 篇

快速上手

从装上 CLI 到跑通第一个改动。重点不是介绍功能,是先搞清楚沙盒、审批和 AGENTS.md 这三件事在替你决定什么。

  • 四种装法与登录方式
  • 第一个能验收的改动
  • 沙盒模式 × 审批策略
  • AGENTS.md 分层指令
进入快速上手 →

适合第一次敲 codex 的人

进阶 · 5 篇

进阶教程

把一次成功变成每次都稳。技能、MCP、子智能体、云端与 CI,这些才是从「能用」到「敢交给它」的分水岭。

  • 技能与插件的取舍
  • MCP 接上内部工具
  • 子智能体并行与上下文
  • codex exec 与 GitHub Action
查看进阶教程 →

适合已经用过几周、想稳定下来的人

实战 · 4 例

实战案例

四个能照着改的完整流程。每个都写清楚在什么权限下跑、提示词怎么给、结果怎么验收、哪里最容易翻车。

  • 提 PR 前自审
  • 摸清陌生代码库
  • CI 失败自动修
  • 团队规范固化
浏览实战案例 →

适合手上有具体活要交的人

Start with a real task

你现在卡在哪一步?

带着今天手上的活进来。先跑通一个能验收的改动,比读完整本手册管用。

From task to system

一次跑通,不该只发生一次

这本手册关心的不是「Codex 会什么」,而是怎么把一次跑通的结果,变成稳定、可协作、换个人也能用的工作方式。

先划边界

决定它能写哪里、什么时候必须问你。这一步没定,后面越自动越危险。

跑通一次

挑一个改完能立刻验证的小改动,跑通它,看清楚每一步发生了什么。

写进仓库

把这次成功的约定写进 AGENTS.md 和技能,下次换个人也能跑出同样结果。

交给流水线

固定节奏的活用 codex exec 跑,你只负责看 diff 和验收。

Sources

内容来自哪里

本站是非官方社区教程。「官方文档」区是 learn.chatgpt.com 中文原文的完整镜像,简体和繁体都直接取自官方译文;原创层是我们自己写的,事实以官方页面为准。

还在写

这本手册还没写完

原创层 15 篇已经能走通一条完整路径,但有两块还没到位。先说清楚,省得你翻到一半以为漏了。

  • 界面截图目前只有文字。桌面应用和 IDE 扩展的界面还在快速变,截图过一个月就对不上,暂时不放。
  • 交流群还没开放。等开了会放在顶部导航里,现在那个位置是灰的。

别急着通读,先让它改一行代码

拿不准从哪下手?记住一个原则:第一个任务要小到你能一眼看出对错。「重构这个模块」太大,先改成「给 utils/date.ts 里的 formatRange 补上跨年的单元测试,只改测试文件」。

跑通第一个任务搞清楚它能动什么

非官方社区教程 · 「官方文档」区为 learn.chatgpt.com 中文原文镜像 · 以官方页面为准