---
title: "OpenAI Codex 中文教程"
description: "基於 OpenAI 官方資料重寫的 Codex 中文教程，覆蓋 App、IDE、CLI、Cloud 和安全邊界。"
verifiedAt: "2026-05-06"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

> [!NOTE]
> 這組教程只把穩定事實寫進正文：Codex 是 OpenAI 的 coding agent，官方入口覆蓋 App、IDE extension、CLI 和 Cloud。價格、模型列表、版本變化這類高波動資訊只給官方入口，不在正文硬寫死。

Codex 不是單一終端工具，也不是隻在網頁裡執行的助手。OpenAI 官方教程現在把它拆成幾種入口：本地 App、IDE 擴充套件、命令列 CLI，以及在 `chatgpt.com/codex` 執行的 Cloud 任務。你選擇哪一個入口，取決於任務要不要貼近編輯器、要不要長期後臺執行、要不要受本地 sandbox 和 approval 控制。

```mermaid
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
```

## 兩條閱讀路徑

<Cards>
  <Card title="從原理到實戰" description="先建立任務、上下文、許可權、驗證和團隊協作的判斷力。" href="/zh-Hant/docs/codex/understanding" />
  <Card title="官方教程中文版" description="再按 App、IDE、CLI、Cloud、配置、安全、擴充套件和實戰場景查具體用法。" href="/zh-Hant/docs/codex/official" />
</Cards>

## 先讀什麼

- 第一次用 Codex：先讀從原理到實戰，再跑 quickstart。
- 已經會用但結果不穩：先補上下文、AGENTS.md、審批和沙箱。
- 準備團隊落地：先看安全邊界、Cloud / GitHub 流程、託管配置和審查機制。
- 想接 MCP、Skills、Subagents、Hooks：先確認這些能力解決的是複用、外部上下文、隔離執行還是自動檢查，不要一次性全開。

## 學完後的最低標準

這套 Codex 教程的目標不是讓你記住所有入口，而是能判斷“這個任務應該怎麼交給 Codex”。學完後至少要能做到：

- 能區分 App、IDE、CLI 和 Cloud 各自適合的任務。
- 能給 Codex 一個清楚的目標、範圍、邊界和驗證方式。
- 能讀懂 diff、日誌、測試結果和剩餘風險。
- 能用規則、Skills、MCP 或 Subagents 沉澱高頻工作，而不是每次臨時寫長 prompt。
- 能在安全邊界內逐步放權，不把生產專案直接交給最大自治模式。

如果一個任務無法驗證，就先不要交給 Codex 修改。先讓它分析、分診、列計劃，再進入小範圍執行。

## 事實基準

- OpenAI Codex 官方文件：[https://developers.openai.com/codex](https://developers.openai.com/codex)
- Codex quickstart：[https://developers.openai.com/codex/quickstart](https://developers.openai.com/codex/quickstart)
- Agent approvals & security：[https://developers.openai.com/codex/agent-approvals-security](https://developers.openai.com/codex/agent-approvals-security)
- 上游原始碼：[https://github.com/openai/codex](https://github.com/openai/codex)

## 接下來去哪

<Cards>
  <Card title="Codex 是什麼" description="先把 coding agent、聊天助手、本地工具和雲端任務分清。" href="/zh-Hant/docs/codex/understanding/what-is-codex" />
  <Card title="CLI / App / IDE / Cloud 怎麼選" description="按任務型別選擇入口，避免每個入口都裝卻沒有一個用熟。" href="/zh-Hant/docs/codex/understanding/cli-app-ide-cloud" />
  <Card title="官方教程中文版" description="按官方資料查詢安裝、登入、配置、安全、擴充套件和實戰場景。" href="/zh-Hant/docs/codex/official" />
  <Card title="第一次安全使用" description="從只讀理解專案開始，再進入小範圍寫入和驗證。" href="/zh-Hant/docs/codex/official/00-getting-started/first-safe-use-checklist" />
</Cards>

## 引流出口

- Aaron工作流主站：[xiangyugongzuoliu.com](https://xiangyugongzuoliu.com)
- AI 程式設計實操課：[課程頁](https://flowus.cn/xiangyugongzuoliu/share/d392dcad-b537-44ee-a3e2-56ff5af02bce)
