切換色彩模式
第 1 章 Codex 是什麼
Codex 是一種會依照任務實際處理工作的人工智慧助手能理解文字要求並協助完成工作的軟體。，也稱為 Agent像一位會照指示做事的電腦小幫手。。它不只回答問題，也能在你允許的範圍內讀取檔案、修改內容、執行命令並回報結果。
Codex 可以在桌面 App、CLI、網頁雲端與 IDE 中使用。這些是不同的工作入口，不是不同的 Codex。
圖 1｜ch-01｜Codex 使用入口地圖｜繁中教學示意
Codex 和一般聊天工具差在哪裡
一般聊天工具主要提供回答；Codex 除了回答，還能在你允許的範圍內使用檔案和工具，把工作推進到一個可以檢查的產物。
同樣是「幫我把這份筆記整理成摘要」，差別不在誰比較聰明，而在誰動手改檔案：
| 一般 AI 對話 | Codex | |
|---|---|---|
| 你給它什麼 | 把檔案內容貼進對話框 | 指定一個資料夾 |
| 它做什麼 | 回你一段文字 | 自己讀檔、改檔、執行命令 |
| 誰動手改檔案 | 你自己複製、貼回去、存檔 | 它直接改，然後列出改了哪幾行 |
| 你要做的最後一步 | 存檔 | 檢查它改對了沒有 |
圖 01-A｜同一個需求的兩種結果。左邊一般聊天只給你一段回答，你得自己複製貼回去；右邊 Codex 會讀檔、規劃、執行，交出一個你能直接打開檢查的檔案。
例如，你可以讓 Codex：
- 讀取一組訪談筆記，整理成報告。
- 清理 CSV 或 Excel 資料，輸出一份乾淨副本。
- 修改網頁文字與圖片，產生可預覽先看看成品長什麼樣子，還沒有正式交出去。版本。
- 查看一個專案你交給 Codex 處理的那個資料夾。，說明結構、風險和下一步。
因為它會動你的真檔案，所以你多了一個責任：驗收你自己打開產物，確認真的做對了。。
入口對照表
| 入口 | 更適合 | 典型任務 | 建議起點 |
|---|---|---|---|
| 桌面 App | 不熟悉命令列、需要看見檔案與結果 | 文件、資料整理、網頁修改、多 Agent、Skills、排程任務 | ★ 非開發新手從這裡開始 |
| CLI | 需要頻繁查看命令輸出 | 修 bug、補測試、跑命令、解釋程式碼儲存庫 | 熟悉終端機後 |
| IDE | 正在編輯特定程式檔案 | 局部修改、解釋、程式碼審查 | 開發者日常使用 |
| Codex cloud | 任務較長或需要背景執行 | 隔離雲端環境中的儲存庫任務、PR、背景分析 | 熟悉本機流程後 |
| ChatGPT 中的 Codex | 從對話交付完整任務 | 連接 GitHub、理解儲存庫、協作推進 | 依帳號能力選擇 |
原教程把 CLI 放在開發者主線。對沒有終端機經驗的人，先使用桌面 App 是更穩妥的順序。入口不用集郵，能安全把任務做完的那一個，就是現在適合你的入口。
台灣版編者｜官方校正｜2026-10-14：上表保留原作者「ChatGPT 中的 Codex」用語與儲存庫任務語境；目前閱讀時仍要分清一般 ChatGPT web 對話與 Codex cloud 的隔離雲端程式任務。本書另外介紹 ChatGPT 桌面 App 裡的 Codex、CLI、IDE 擴充功能與 Codex cloud；手機 Codex（舊版叫 Remote）也是不同流程。
如何選擇入口
- 第一次用，還不確定要做什麼：桌面 App。
- 需要頻繁看命令輸出：CLI。
- 需要多 Agent、Skills像小幫手的工具箱，遇到特定工作時拿出合適工具。 或排程任務把重複工作排好時間，讓電腦到時候自動執行。：桌面 App。
- 任務較長、要背景跑或產生 PR把修改送去請人檢查，還不代表已經正式上線。：Codex cloud。
- 正在編輯特定檔案：IDE。
- 想從對話中交付整個專案的任務：使用帳號當下支援的 ChatGPT Codex 入口。
第一次學習建議
- 先用桌面 App 建立最小閉環：選一個資料夾，交代一個小任務，自己驗收結果。
- 熟悉之後再學 CLI，體驗命令輸出與快速迭代做一小步、看一次、再修一點，像慢慢把積木蓋好。。
- 再進入 Codex cloud，學習長任務、PR 與團隊協作。
- 閱讀 CLI 選項 與 config.toml，補上設定基本功。
- 把常用範本沉澱到
AGENTS.md、案例庫與團隊規範。
台灣版編者｜Vivi 老師提醒：如果你完全沒有終端機基礎，可以先用桌面 App 完成第 6 章的小任務，再回來學 CLI；這是非開發新手的替代路線，不取代原作者的開發者學習順序。
四個常見任務詞
一次任務有四個階段，人和 Codex 輪流負責。這本書後面每一章都繞著同一個循環：
- 提示詞（Prompt你交給 Codex 的問題或工作說明。）：由你說明要得到什麼、可以處理哪些檔案、有哪些限制。
- 計畫（PlanCodex 在執行前列出的工作步驟。）：複雜或有風險時，Codex 先提出打算怎麼做，由你確認。
- 執行（ExecuteCodex 實際讀檔、寫檔、使用工具或執行命令。）：Codex 動手，讓工作真正發生。
- 驗收（Verify用檔案、預覽、差異或測試確認結果。）：由你自己核對結果。
圖 01-B｜四個階段，人和 Codex 輪流負責。你交代目標與範圍，它提出打算怎麼做並等你確認，接著動手，最後由你檢查結果。頭尾兩段都是你的。
第 1 和第 4 個階段是你的，不能外包。它顯示「完成」，不等於產物正確。
下面的設定表是進階參考，第一次閱讀可以先跳過，不必全部學會才進下一章。
入口和設定的關係
| 設定主題 | 主要影響入口 | 學習頁 |
|---|---|---|
AGENTS.md | CLI／桌面 App／Codex cloud | AGENTS.md |
| CLI 選項 | CLI | CLI 選項與命令 |
config.toml | CLI | 設定檔 config.toml |
| Skills | App／CLI | 技能與外掛 |
| Worktrees | 桌面 App | 桌面工作區 |
| Environments | Codex cloud／App | Codex cloud |
| Sandbox 與 Approvals | CLI／IDE／桌面 App 的本機工作 | 沙盒與核准 |
| 隔離環境與網路設定 | Codex cloud | Codex cloud |
新手詞語卡
Agent：像一位會照指示做事的電腦小幫手。
專案：你交給 Codex 處理的那個資料夾。
任務：你這一次要它完成的一件事。
改動（diff）：它改了哪幾行，紅色是刪掉的、綠色是新增的。
驗收：你自己打開產物，確認真的做對了。
Skills：像小幫手的工具箱，遇到特定工作時拿出合適工具。
排程任務（Scheduled tasks，原文稱 Automations）：把重複工作排好時間，讓電腦到時候自動執行。
bug：程式裡讓結果出錯的小問題。
儲存庫：放專案檔案並記錄修改歷史的總資料夾。
PR：把修改送去請人檢查，還不代表已經正式上線。
Sandbox（沙盒）：替工具圍出可以工作的範圍，避免碰到不該碰的地方。
Approval（核准）：工具做到重要步驟前，先停下來請人確認。