---
title: "新手必讀"
description: "從定位、快速開始、登入認證、術語和安全檢查開始，建立 Codex 的第一條安全使用閉環。"
verifiedAt: "2026-05-07"
---

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

> [!TIP]
> 第一次接觸 Codex，不要從複雜自動化開始。先完成定位、quickstart、認證、術語和安全清單這 5 步，再讓它改真實專案。

這一章只建立第一條安全閉環：知道 Codex 是什麼，能跑通一個最小任務，認證方式清楚，術語不混淆，第一次改程式碼前有檢查清單。

## 推薦順序

```mermaid
flowchart LR
    A[理解定位] --> B[快速上手]
    B --> C[登入認證]
    C --> D[術語速查]
    D --> E[安全清單]
    E --> F[小範圍真實任務]

    style E fill:#dcfce7,stroke:#22c55e,stroke-width:2px
```

## 章節速查

<Cards>
  <Card title="理解 Codex 定位" description="先分清 Codex 是 coding agent，不是普通聊天框，也不是無邊界自動運維。" href="/zh-Hant/docs/codex/official/00-getting-started/00-codex-positioning" />
  <Card title="快速上手 Codex" description="跑通安裝、啟動、最小任務和結果檢查，先建立第一條閉環。" href="/zh-Hant/docs/codex/official/00-getting-started/01-quickstart" />
  <Card title="完成登入和認證" description="分清 ChatGPT 登入、API key、CI/CD auth 和憑據安全邊界。" href="/zh-Hant/docs/codex/official/00-getting-started/02-auth" />
  <Card title="新手術語速查" description="回查 agent、sandbox、approval、MCP、context、diff 等常見術語。" href="/zh-Hant/docs/codex/official/00-getting-started/glossary" />
  <Card title="第一次安全使用清單" description="第一次讓 Codex 改程式碼前，逐項確認範圍、許可權、驗證和回復。" href="/zh-Hant/docs/codex/official/00-getting-started/first-safe-use-checklist" />
  <Card title="從原理到實戰" description="想先建立完整認知，走 12 篇理解路線。" href="/zh-Hant/docs/codex/understanding" />
</Cards>

## 新手判斷標準

- 能解釋 Codex 會讀檔案、改檔案、跑命令，也會受到當前入口和許可權邊界限制。
- 能完成一次只讀專案理解任務，再進入小範圍修改。
- 能說清認證憑據放在哪裡、哪些資訊不能貼進公開文件或日誌。
- 能在任務結束時找到 diff、測試結果、未驗證項和剩餘風險。
- 能知道遇到陌生詞時回術語頁，而不是憑感覺理解。

## 學完本章你應該做到什麼

學完這章，不要求你掌握所有 Codex 功能，但應該能獨立完成這條最小閉環：

1. 選擇 App、IDE extension、CLI 或 Cloud 中一個入口。
2. 登入並確認當前專案或 repository。
3. 發起只讀專案理解任務。
4. 選擇一個低風險小改動。
5. 檢視 diff。
6. 跑至少一個驗證命令。
7. 記錄未驗證項。

如果這 7 步做不到，先不要繼續學 MCP、subagents、Cloud automation 或團隊治理。

## 本章不解決什麼

這一章不深入講：

- 複雜 `config.toml`。
- MCP server 配置。
- skills / subagents / plugins。
- Cloud environment 高階配置。
- 企業治理、SSO、SCIM、managed config。
- 大型遷移和多 agent 協作。

這些放在後續章節。新手階段先建立正確邊界，避免一開始就把 Codex 當成無邊界自動化工具。

## 配套從原理到實戰

每個新手必讀章節都有對應的深度講解：

- 理解 Codex 定位：[Codex 到底是什麼](/zh-Hant/docs/codex/understanding/what-is-codex)
- 快速上手：[一次任務是怎麼完成的](/zh-Hant/docs/codex/understanding/how-a-task-completes)
- 安全清單：[Codex 為什麼需要審批和沙箱](/zh-Hant/docs/codex/understanding/sandbox-approval)

返回 [官方教程中文版總目錄](/zh-Hant/docs/codex/official)

## 接下來去哪

<Cards>
  <Card title="先理解定位" description="第一篇先建立邊界，避免一開始就用錯入口。" href="/zh-Hant/docs/codex/official/00-getting-started/00-codex-positioning" />
  <Card title="再跑 Quickstart" description="跑通最小任務，不急著接複雜專案。" href="/zh-Hant/docs/codex/official/00-getting-started/01-quickstart" />
  <Card title="補認證" description="把登入、API key、CI/CD 和憑據安全分開理解。" href="/zh-Hant/docs/codex/official/00-getting-started/02-auth" />
  <Card title="最後過安全清單" description="第一次真實改程式碼前，把範圍、許可權、驗證和回復確認完。" href="/zh-Hant/docs/codex/official/00-getting-started/first-safe-use-checklist" />
</Cards>

## 官方資料

- [OpenAI Codex overview](https://developers.openai.com/codex)
- [OpenAI Codex Quickstart](https://developers.openai.com/codex/quickstart)
- [OpenAI Codex App](https://developers.openai.com/codex/app)
- [OpenAI Codex IDE extension](https://developers.openai.com/codex/ide)
- [OpenAI Codex CLI](https://developers.openai.com/codex/cli)
- [OpenAI Codex web](https://developers.openai.com/codex/cloud)
