# 影片筆記：Codex - Full Course for Beginners

## 一句話總結

本影片詳細介紹了 OpenAI 推出的 AI 編程工具 **Codex**，涵蓋了其四種使用介面、桌面應用程式的詳細設定（模型選擇、推理等級、插件安裝）、電腦控制與瀏覽器自動化功能、專案開發流程（含 Git 整合與多人西洋棋遊戲實作），以及進階的命令操作（如 `/plan`、`/goal`、`/compact`）與記憶機制解決方案（`.agent.md`）。

## 核心重點

1.  **Codex 的定位與介面**：
    *   Codex 是 OpenAI 推出的產品，被描述為對標 Claude Code 但功能更豐富的工具。
    *   提供四種使用介面：桌面應用程式（推薦，支援 Win/Mac）、IDE 擴充功能（Cursor, VS Code, Windsurf）、命令列介面 (CLI) 以及雲端瀏覽器版本。
    *   核心能力不僅是編碼，還包含強大的「電腦控制 (Computer Use)」與瀏覽器控制能力。

2.  **桌面應用程式設定與模型選擇**：
    *   **模型建議**：強烈建議使用 **GPT 5.5** 搭配 **Medium 推理等級** 與 **Fast Mode**。
    *   **其他模型**：提及 GPT 5.4、GPT 5.4 mini 以及 5.3 Codec Spark，但講者不建議日常使用 GPT 5.4。
    *   **推理等級**：Light, Medium, High, Extra High。高推理等級會顯著增加耗時（4-10倍）。
    *   **插件**：需安裝 Computer Use 插件與 Chrome 插件以實現電腦與瀏覽器控制。

3.  **電腦控制與自動化**：
    *   透過 `@computer` 指令，Codex 可控制應用程式（如開啟 Notepad、Spotify）、操作瀏覽器標籤頁、搜尋與除錯。
    *   AI 使用自己的游標操作，不與使用者滑鼠衝突，使用者仍可同時操作電腦。
    *   適用於自動化測試、填寫表單及重複性任務。

4.  **專案開發與 Git 整合**：
    *   支援建立本地專案，自動連接 GitHub 建立分支。
    *   演示了建立多人線上西洋棋遊戲 MVP 的過程，包含後端 (WebSockets) 與前端。
    *   提供預覽 (Preview) 與終端機 (Terminal) 視窗，並支援在瀏覽器中直接測試與修改（透過註解功能 Annotation）。

5.  **進階命令與記憶機制**：
    *   **命令**：`/status` (查看限制), `/compact` (壓縮上下文), `/fork` (建立分支/工作樹), `/plan` (規劃模式), `/goal` (目標模式), `/review` (程式碼審查)。
    *   **記憶限制**：Codex 預設不會記住歷史對話，新對話即重置。
    *   **解決方案**：建立 `.agent.md` 檔案，將專案規範、技術堆疊等資訊持久化，讓 Codex 在新對話開始時自動載入，實現長期記憶。

## 詳細大綱

### 第一部分：Codex 介紹與設定指南
*   **簡介**：OpenAI 產品，具備編碼、自動化、電腦控制能力。
*   **四種介面**：
    1.  桌面應用程式 (Desktop Application)：推薦，需 ChatGPT 訂閱登入。
    2.  IDE 擴充功能：支援 Cursor, VS Code, Windsurf。
    3.  CLI：適合 Linux/伺服器，可 24/7 運行。
    4.  雲端版本：瀏覽器運行，支援手機。
*   **桌面版介面解析**：
    *   主聊天視窗：模型選擇器、語音輸入、批准模式、技能/上下文、斜線指令。
    *   側邊欄：專案組織、瀏覽器/終端機切換、設定、日常模式切換。
    *   使用量顯示：講者認為額度寬鬆。
*   **模型與推理設定**：
    *   推薦：GPT 5.5 + Medium 推理 + Fast Mode。
    *   其他選項：GPT 5.4 (較舊，便宜但不建議), GPT 5.4 mini (快速小任務), 5.3 Codec Spark (極速，次要任務)。
*   **插件安裝**：
    *   Computer Use 插件：控制應用程式開啟、瀏覽器存取。
    *   Chrome 插件：控制瀏覽器標籤頁、搜尋、除錯。
*   **贊助商廣告**：Boot Dev 互動式後端開發學習平台，使用代碼 `tech with Tim` 享折扣。

### 第二部分：電腦控制與專案開發實作
*   **外掛安裝**：
    *   GitHub 外掛：推薦，用於版本控制、雲端備份、跨裝置存取。
    *   Computer Plugin：透過 `@` 符號呼叫，允許 AI 控制電腦。
*   **電腦控制演示**：
    *   基本操作：開啟 Notepad，關閉視窗，撰寫筆記。
    *   進階應用：開啟 Spotify 播放 Drake 歌曲。若軟體未安裝，AI 可能轉向使用瀏覽器。
    *   權限：需允許 AI 存取瀏覽器。
*   **專案管理**：
    *   建立新專案：建議獨立聊天視窗。
    *   模式選擇：Codex Web (雲端), Local (本地), Work Tree (克隆，避免衝突)。
    *   Git 整合：自動連接 GitHub，預設建立 `main` 分支。
*   **程式碼生成與執行**：
    *   提示詞：建立多人西洋棋遊戲 MVP (後端 WebSockets, 前端互動介面)。
    *   Codex 運作：生成檔案，提供 Preview Tab 與 Terminal。
    *   驗證：透過 localhost:3000 測試多人連線、ELO 分數。
*   **瀏覽器互動**：
    *   截圖功能：擷取畫面供 ChatGPT 分析。
    *   註解功能 (Annotation)：選取 HTML 元素，輸入修改指令 (如更改標題、顏色、深色模式)，Codex 精準修改程式碼。

### 第三部分：進階命令與功能
*   **狀態與上下文管理**：
    *   `/status`：顯示使用限制 (小時/天數) 與上下文限制。
    *   上下文過大影響表現，建議在 70%-90% 時進行壓縮。
*   **壓縮命令 (`/compact`)**：
    *   生成對話摘要並開始新對話，大幅減少上下文使用量。
    *   建議手動執行而非等待自動壓縮。
*   **分支與並行工作 (`/fork`)**：
    *   複製聊天到本地或新工作樹，允許多個代理 (agents) 並行工作。
    *   工作樹 (Work Tree)：Git 提供的本地環境副本，避免衝突。
*   **聊天管理**：
    *   固定聊天 (Pin chats)：允許在同一專案內建立新聊天，讓不同代理運行。
*   **規劃模式 (`/plan`)**：
    *   適用於複雜任務，透過互動提問生成詳細開發計畫，儲存於倉庫。
*   **目標模式 (`/goal`)**：
    *   設定高層級目標，Codex 自動執行循環 (Plan -> Execute -> Review) 直到達成。
    *   缺點：耗時且消耗大量額度。
*   **程式碼審查 (`/review`)**：
    *   比對當前會話與 GitHub 基礎分支的差異，推送前檢查。

### 第四部分：記憶機制與結語
*   **記憶限制**：
    *   新對話即重置，Codex 預設不保留歷史偏好。
    *   僅檢視當前儲存庫檔案，搜尋歷史對話緩慢且不可靠。
*   **解決方案：`.agent.md` 檔案**：
    *   常見於 CLI 工具與 AI Agent 的記憶體檔案。
    *   儲存專案規範、技術堆疊、運行方式。
    *   操作：指示 Codex 建立該檔案，新對話開始時自動載入，實現長期記憶。
    *   注意：不建議儲存憑證。
*   **排程任務 (Scheduled Tasks)**：
    *   類似雲端代碼工具，可設定自動執行任務 (如每日新聞摘要、每週回顧)。
    *   講者目前未使用。
*   **結語**：
    *   涵蓋約 90% 功能，剩餘 10% (MCP 伺服器、Hooks 等) 未來可能製作進階影片。

## 工具 / 模型 / 名詞整理

*   **OpenAI**：開發者。
*   **Codex**：影片主要介紹的 AI 編程工具/IDE。
*   **Claude Code**：被提及為對標產品。
*   **GPT 5.5**：推薦的主力編碼模型。
*   **GPT 5.4**：較舊世代模型，使用限制較便宜，講者不建議使用。
*   **GPT 5.4 mini**：用於快速、小型任務。
*   **5.3 Codec Spark**：極速模型，用於次要任務或 GPT 5.5 額度用盡時。
*   **ChatGPT**：訂閱帳號登入方式。
*   **Plus plan**：$20/月訂閱方案。
*   **$200 per month plan**：講者使用的方案。
*   **Windows / Mac / Linux**：作業系統。
*   **Cursor / Visual Studio Code / Windsurf**：支援的 IDE。
*   **CLI (Command Line Interface)**：命令列介面。
*   **Spotify**：應用軟體，用於電腦控制演示。
*   **Google Drive**：雲端服務，支援的插件之一。
*   **Boot Dev**：贊助商/互動式後端開發學習平台。
*   **Boots**：Boot Dev 的 AI 導師名稱。
*   **tech with Tim**：Boot Dev 的優惠代碼。
*   **GitHub / Git**：版本控制軟體與雲端儲存服務。
*   **Notepad**：Windows 內建文字編輯器，用於電腦控制演示。
*   **Drake**：歌手名稱，用於搜尋歌曲範例。
*   **Chrome**：網頁瀏覽器，支援的插件之一。
*   **Whisper Flow**：使用者推薦的語音轉文字 (Voice Dictation) 工具。
*   **WebSockets**：用於後端通訊的技術。
*   **ChatGPT / GPT**：提及具備圖片生成與檢視功能。
*   **ELO**：西洋棋評分系統。
*   **Chess.com**：作為 UI 優化目標的參考網站。
*   **Cloud Code**：被提及作為具有類似排程功能的對標工具。
*   **MCP servers**：被提及為進階功能之一。
*   **hooks**：被提及為進階功能之一，未說明具體類型。
*   **Computer Use**：功能名稱，指控制電腦的能力。
*   **Work Tree**：Git 提供的專案本地環境副本，用於並行開發。
*   **`.agent.md`**：用於儲存專案規範與技術堆疊的記憶體檔案，實現長期記憶。

## 操作流程整理

### 1. 安裝與初始設定
1.  下載並安裝 Codex 桌面應用程式 (支援 Windows/Mac)。
2.  透過 ChatGPT 訂閱帳號 (Plus 或 $200/月方案) 登入。
3.  安裝必要插件：
    *   **Computer Use 插件**：授權控制應用程式與瀏覽器。
    *   **Chrome 插件**：授權控制瀏覽器標籤頁、搜尋與除錯。
4.  設定模型與推理等級：
    *   選擇 **GPT 5.5**。
    *   選擇 **Medium** 推理等級。
    *   開啟 **Fast Mode**。

### 2. 建立專案與 Git 整合
1.  在 Codex 中建立新專案 (New Project)。
2.  選擇工作模式：
    *   **Local**：在本地電腦工作。
    *   **Codex Web**：資訊傳送至雲端。
    *   **Work Tree**：專案克隆，用於並行開發。
3.  連結 GitHub 帳號，自動建立儲存庫 (Repository) 與 `main` 分支。
4.  (可選) 切換至 Full Access Mode 以減少確認步驟。

### 3. 開發與測試 (以西洋棋遊戲為例)
1.  輸入提示詞：建立多人線上西洋棋遊戲 MVP，包含後端 (WebSockets) 與前端。
2.  觀察 Codex 生成檔案，並在 **Preview Tab** 與 **Terminal** 中查看狀態。
3.  透過瀏覽器訪問 `localhost:3000` 測試遊戲功能 (多人連線、移動棋子、排行榜)。
4.  使用 **註解功能 (Annotation)**：
    *   在瀏覽器視窗中選取 HTML 元素 (如標題、棋盤)。
    *   輸入修改指令 (如更改顏色、添加圖示、切換深色模式)。
    *   點擊 "Go"，Codex 修改程式碼，刷新頁面後可見更新。

### 4. 進階命令操作
1.  **查看狀態**：輸入 `/status` 檢查使用限制與上下文使用量。
2.  **壓縮上下文**：當上下文使用量達 70%-90% 時，輸入 `/compact` 生成摘要並開始新對話。
3.  **並行開發**：輸入 `/fork` 建立本地或新工作樹，允許多個代理同時工作。
4.  **規劃模式**：輸入 `/plan`，與 AI 互動回答澄清問題，生成詳細開發計畫。
5.  **目標模式**：輸入 `/goal`，設定高層級目標，讓 AI 自動執行循環直到達成。
6.  **程式碼審查**：輸入 `/review`，比對當前會話與 GitHub 基礎分支的差異，修復錯誤後再推送。

### 5. 建立長期記憶
1.  指示 Codex 建立 `.agent.md` 檔案。
2.  在檔案中填入專案規範、技術堆疊、運行方式等重要資訊。
3.  驗證：在新對話中詢問專案規範，Codex 應能立即回應，因為該檔案已在對話開始時自動載入。

## 值得注意的限制或風險

1.  **模型名稱與命名慣例**：影片中提到的模型名稱 (GPT 5.5, GPT 5.4, 5.3 Codec Spark) 與目前公開的 OpenAI 模型命名慣例 (如 GPT-4o, o1) 不符，可能為內部版本、口誤或聽寫錯誤，需謹慎查證。
2.  **推理等級的耗時**：選擇 High 或 Extra High 推理等級會顯著增加回應時間 (可能增加 4-10 倍)，需權衡品質與效率。
3.  **上下文限制**：過大的上下文 (對話歷史、工具呼叫過多) 會影響模型表現，需定期使用 `/compact` 進行壓縮。
4.  **記憶機制限制**：Codex 預設不會記住歷史對話，新對話即重置。若未建立 `.agent.md` 檔案，Codex 無法知道過去的工作內容，必須依賴當前儲存庫檔案。
5.  **電腦控制的權限與異常**：使用 Computer Use 插件需授權，若軟體未安裝，AI 可能轉向使用瀏覽器執行任務，需留意權限設定與異常處理。
6.  **使用額度消耗**：高推理等級、目標模式 (Goal Mode) 與大量上下文會消耗大量使用額度，講者認為額度寬鬆但非無限。
7.  **排程任務的限制**：排程任務需電腦保持開啟狀態，且講者表示目前未使用，功能成熟度或穩定性可能有限。

## 逐字稿辨識疑點

*   **GPT 5.5 / GPT 5.4 / GPT 5.4 mini / 5.3 Codec Spark**：逐字稿中反覆提及這些模型名稱，但與目前公開的 OpenAI 模型命名慣例不符，需查證是否為影片發布時的特定內部版本、口誤或聽寫錯誤。
*   **Codec Spark**：模型名稱中的 "Codec" 疑點，通常為 "Code"，需查證是否為特定模型名稱或口誤。
*   **boot dev / boots**：贊助商名稱在逐字稿中出現 "boot dev" 與 "boots"，需查證正確品牌名稱是否為 "Boot.dev" 或其他拼寫。
*   **slash goal**：開頭提到 "slash goal"，後續介面介紹中僅提到 "slash" (斜線指令) 列出功能列表，未明確解釋 "goal" 指令，需查證是否為特定指令或口誤。
*   **24 over seven**：逐字稿中多次出現 "24 over seven"，應為 "24/7" (全天候) 的口語化表達或聽寫差異。
*   **5 or 10 times the amount of usage**：關於使用額度的比較，講者提到比 Claude Code 多 5 到 10 倍，此為講者個人經驗，非官方數據。
*   **Whisper Flow**：逐字稿中使用者推薦此工具用於語音提示，但需查證該工具是否為正確名稱或為口誤。
*   **Codex Web**：提及此選項會將資訊傳送至雲端，描述較為簡略，需查證其具體運作機制。
*   **Work Tree**：提及這是專案的克隆，用於避免衝突，