---
title: "Codex 官方教程中文版"
description: "基於 OpenAI 官方資料，按入口、配置、安全、擴充套件、Cloud、團隊和實戰場景重寫的 Codex 中文查詢手冊。"
verifiedAt: "2026-05-06"
---

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

> [!NOTE]
> 這一頁是功能手冊入口。它不替代 OpenAI 官方文件，而是把官方資料按中文開發者的查詢路徑重排：先選入口，再設邊界，再接擴充套件，最後進入 Cloud、團隊和真實場景。

Codex 的官方事實變化很快，所以本系列正文只固定穩定結構：App、IDE extension、CLI、Cloud 四類入口；`AGENTS.md` / `config.toml` / sandbox / approval 這條安全配置主線；MCP、Skills、Subagents、Hooks 這組擴充套件能力；以及 Cloud、GitHub、Slack、Linear、CI 這類團隊整合。模型、價格、版本更新和功能成熟度以官方頁面為準。

```mermaid
flowchart TB
  Start[新手必讀] --> Entry[產品入口<br/>App / IDE / CLI / Cloud]
  Entry --> Guard[規則、安全與配置<br/>AGENTS.md / config.toml / sandbox / approvals]
  Guard --> Extend[擴充套件能力<br/>MCP / Skills / Subagents / Hooks]
  Extend --> Runtime[雲端與遠端環境]
  Runtime --> Team[團隊企業與整合]
  Team --> Scenarios[實戰場景與學習路線]
  Scenarios --> Versions[版本、遷移與官方影片]
```

## 官方事實基準

- Quickstart 當前把 Codex 入門拆成 App、IDE extension、CLI 和 Cloud。
- Codex App 官方面向 macOS 和 Windows；平臺差異以對應官方頁面為準。
- Codex CLI 官方支援 macOS、Windows 和 Linux，安裝入口包括 `npm install -g @openai/codex` 和 Homebrew。
- IDE extension 官方入口覆蓋 Visual Studio Code、Cursor、Windsurf 和 Visual Studio Code Insiders。
- Codex Cloud 在 `chatgpt.com/codex` 執行，也可以透過 GitHub PR 評論裡的 `@codex` 觸發任務。
- 安全邊界由 sandbox mode、approval policy 和 network access 共同決定；預設網路訪問關閉，本地執行通常受 OS sandbox 限制。

## 按問題選入口

<Cards>
  <Card title="第一次跑通" description="從 quickstart、登入認證、術語和安全清單開始，先建立最小閉環。" href="/zh-Hant/docs/codex/official/00-getting-started" />
  <Card title="選擇使用入口" description="查 App、IDE、CLI、Web、Windows、worktree、本地執行時和瀏覽器能力。" href="/zh-Hant/docs/codex/official/01-products" />
  <Card title="設定安全邊界" description="查 AGENTS.md、config.toml、approval、sandbox、network 和受保護路徑。" href="/zh-Hant/docs/codex/official/02-config-security" />
  <Card title="擴充套件 Codex 能力" description="查 MCP、Skills、Subagents、Hooks、memory、plugins 和 workflow 組合方式。" href="/zh-Hant/docs/codex/official/03-extensions" />
  <Card title="控制成本和速度" description="查提示詞、模型選擇、用量入口、提速方法和功能成熟度；具體價格以官方為準。" href="/zh-Hant/docs/codex/official/04-model-pricing" />
  <Card title="使用 Cloud 和遠端環境" description="查 Cloud runtime、網路許可權和遠端開發環境邊界。" href="/zh-Hant/docs/codex/official/05-cloud-remote" />
  <Card title="團隊與企業落地" description="查 GitHub、Slack、Linear、CI/CD、SDK、企業治理和託管配置。" href="/zh-Hant/docs/codex/official/06-team-integration" />
  <Card title="按場景學習" description="按 Web、遊戲、原生應用、生產系統和效率路線選擇學習順序。" href="/zh-Hant/docs/codex/official/07-learning-paths" />
  <Card title="真實任務模板" description="把 bug 分診、PR review、資料查詢、UI 構建、部署等需求改寫成 Codex 任務。" href="/zh-Hant/docs/codex/official/08-scenarios" />
  <Card title="版本與遷移" description="只用來查官方演示、遷移說明和變更入口；不把高波動時間線當長期教程。" href="/zh-Hant/docs/codex/official/09-versions" />
</Cards>

## 推薦學習順序

1. 先讀 [從原理到實戰](/zh-Hant/docs/codex/understanding)，理解任務、上下文、工具、邊界和驗證。
2. 再跑 [Quickstart](/zh-Hant/docs/codex/official/00-getting-started/01-quickstart)，只做一個可回復的小任務。
3. 立刻補 [第一次安全使用清單](/zh-Hant/docs/codex/official/00-getting-started/first-safe-use-checklist)，不要讓第一次體驗變成大範圍改動。
4. 寫 [AGENTS.md](/zh-Hant/docs/codex/official/02-config-security/05-project-rules)，把專案約定沉澱成 Codex 能穩定讀取的規則。
5. 根據入口選擇 [CLI / App / IDE / Cloud](/zh-Hant/docs/codex/understanding/cli-app-ide-cloud)，不要所有入口同時上手。
6. 需要複用和整合時，再進入 MCP、Skills、Subagents、Hooks 和團隊整合。

## 不硬寫的資訊

- 價格、用量、套餐、模型預設值和上下文視窗。
- 平臺下載按鈕、支援系統的細小差異和版本釋出日期。
- GitHub、Slack、Linear、CI 整合的開關狀態和企業許可權策略。
- changelog、demo video 和遷移時間線。

這些內容只在對應文章裡給官方入口和判斷方法，不在索引頁偽裝成長期事實。

## 官方資料

- 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)
- OpenAI Codex GitHub：[https://github.com/openai/codex](https://github.com/openai/codex)

## 接下來去哪

<Cards>
  <Card title="新手必讀" description="先完成定位、quickstart、認證、術語和安全清單。" href="/zh-Hant/docs/codex/official/00-getting-started" />
  <Card title="產品入口" description="按任務選擇 App、IDE、CLI、Cloud、Windows 或 worktree。" href="/zh-Hant/docs/codex/official/01-products" />
  <Card title="規則安全與配置" description="把 AGENTS.md、config.toml、approval、sandbox 和 network 一次性理清。" href="/zh-Hant/docs/codex/official/02-config-security" />
  <Card title="實戰場景" description="從真實任務模板反推 Codex 的提示詞、邊界和驗收方式。" href="/zh-Hant/docs/codex/official/08-scenarios" />
</Cards>
