Skip to content

Codex 中文手冊先劃清邊界,再讓它寫程式碼

從裝上 CLI 到把它交給 CI 的完整中文教程,外加 133 篇官方中文文件映象。簡體繁體都有,一個字都沒經過機器翻譯。

Codex 中文手冊

關於繁體版:官方文件區的繁體是 OpenAI 自己維護的 zh-Hant 譯文,直接鏡像,沒有從簡體轉換。本站自己寫的教程與案例是簡體原稿, 繁體由 OpenCC 轉換,用詞已對齊官方譯法。

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 中文原文映象 · 以官方頁面為準