# 影片筆記：2026版AI+Codex零基础全套视频课程，Codex从入门到大神AI编程开发，涵盖安装配置、代码分析、Bug修复及完整项目实战 p05 4、 CLI 高效交互指南与规范拆解

## 一句話總結

本節課程詳細講解了 Codex CLI 的高效使用指南，涵蓋從基礎命令查詢、非交互式執行、會話恢復，到進階的代碼審查、圖片處理、Web 搜尋及權限管理等功能，並強調將 Codex 整合進傳統運維腳本或自動化流程中的實踐方法。

## 核心重點

*   **CLI 基礎與執行模式**：區分交互式與非交互式（`exec`）執行，後者適合自動化腳本，直接返回結果而不進入對話頁面。
*   **會話管理**：利用 `resume` 和 `sessionID` 恢復或切換歷史對話，並可使用 `clean` 清理上下文。
*   **進階功能應用**：
    *   **代碼審查**：支援本地文件、PR 審查，可生成對照表格追蹤修復進度。
    *   **圖片處理**：支援輸入圖片分析（如截圖）及生成圖片（調用 API 或 OpenAI 模型）。
    *   **Web 搜尋**：支援默認搜尋及指定外部搜尋工具，可根據需求啟用或禁用。
*   **權限管理**：提供多種權限模式（默認、只讀、自動審查、完全訪問/YOLO），建議開發項目使用完全訪問權限以節省時間。
*   **腳本整合與環境初始化**：強調在啟動 Codex 前初始化環境（如激活虛擬環境、設置目錄權限），以避免浪費 Token，並可結合系統命令（如 `grep`、PowerShell）進行自動化處理。

## 詳細大綱

### 一、 基礎命令與查詢
*   **查詢幫助**：
    *   使用 `Codex help` 查看所有可用命令。
    *   若介面為英文，可執行 `Codex help` 並要求輸出為中文，以輔助理解。
*   **命令列表**：
    *   包含執行、清理上下文、恢復對話等命令。

### 二、 執行模式：交互式 vs 非交互式
*   **交互式執行**：
    *   直接輸入 `Codex` 或 `Codex <提示詞>` 進入對話視窗。
    *   適合需要反覆確認或對話的場景。
*   **非交互式執行 (`exec`)**：
    *   使用 `Codex exec <提示詞>`。
    *   **特點**：不進入對話頁面，直接執行命令並返回結果，適合傳統運維或自動化腳本。
    *   **應用場景**：調用 Codex 作為命令運行，獲取分析結果後退回終端。

### 三、 會話管理與恢復
*   **恢復對話 (`resume`)**：
    *   使用 `Codex resume` 恢復最近的一次對話。
    *   系統會列出歷史對話列表及時間戳，用戶可選擇恢復特定對話。
*   **指定會話 ID (`sessionID`)**：
    *   使用 `Codex status` 查看當前或歷史對話的 `sessionID`。
    *   使用 `Codex resume <sessionID>` 精確切換到指定會話。
*   **清理上下文**：
    *   使用 `clean` 命令清理當前對話上下文。

### 四、 錯誤處理與修正
*   **命令錯誤修復**：
    *   若命令執行報錯，可直接將錯誤信息丟給 Codex。
    *   提示詞範例：「幫我分析這個是什麼錯誤，然後輸出修正的指令」。
    *   Codex 會自動查閱幫助文檔並提供修正後的命令。

### 五、 模型選擇與推理建議
*   **模型推薦**：
    *   **GPT-5.5**：推薦用於對話、推理、研究及任務規劃（如寫文檔）。
    *   **Codex 5.3**：推薦專門用於寫代碼，經過調優，效果較好。
*   **權衡建議**：根據任務類型選擇合適模型，最新模型通常無問題，但特定場景有專用版本。

### 六、 圖片處理功能
*   **圖片輸入與分析**：
    *   支持輸入圖片（如截圖）進行分析。
    *   範例：分析「貪吃蛇」遊戲截圖，識別界面風格與內容。
    *   適用場景：當錯誤難以用語言描述時，直接發送截圖給 AI。
    *   支持格式：PNG、JPEG 等常見格式。
    *   多張圖片可使用 `image` 參數指定。
*   **圖片生成**：
    *   支持生成圖片，可調用 API 或 OpenAI 官方模型（如 DALL-E 3, GPT-4 Image 等，講者口誤提及 L1E3, GBT image2）。
    *   範例：提示「幫我生成一張貓的圖片」。
    *   實現方式：可能調用內置 Scale 或公共 API。

### 七、 界面設置與代碼審查
*   **語法高亮與主題**：
    *   使用 `Theme` 命令更改終端主題（亮色/暗色）。
    *   可調整代碼生成的語法高亮風格。
*   **本地代碼審查 (`review`)**：
    *   **功能**：對本地文件或 PR 進行代碼審查。
    *   **PR 審查**：需配置 GitHub Token 以獲取權限，公共倉庫可能無需 Token。
    *   **本地審查**：
        *   針對未提交的更改（Changes）。
        *   針對已提交的代碼。
        *   針對單個文件。
    *   **工作流程**：
        1.  執行 `Codex review`。
        2.  審查結果可能為英文，可要求翻譯為中文。
        3.  根據審查反饋（P1, P2, P3 問題），提示 Codex 修復代碼。
        4.  要求輸出「對照表格」（原問題、修復關鍵點、修復代碼行、是否已修復）。
        5.  循環檢查直到所有問題修復。

### 八、 Web 搜尋功能
*   **搜尋模式 (`search`)**：
    *   使用 `Codex <提示詞> search` 啟用 Web 搜尋。
    *   默認使用 OpenAI 維護的網頁檢索結果，可能存在緩存，不一定為最新實時數據。
*   **YOLO 模式**：
    *   使用 `YOLO` 參數可減少反覆確認，直接執行。
*   **替代方案**：
    *   若需更準確結果，建議指定外部搜尋工具（如講者提及的 Telry 或 Beamsearch，疑點：具體名稱需查證）。
    *   可安裝插件（如講者提及的 Tile Research，疑點：具體名稱需查證）進行檢索。
*   **禁用搜尋**：
    *   若對話僅依賴內部文檔，應禁用 Web Search 以避免不準確結果。

### 九、 權限管理 (Permissions)
*   **權限模式**：
    *   **默認/授權模式**：執行編輯文件或敏感命令時需要用戶授權。
    *   **只讀模式 (Read-Only)**：僅分析文檔，不允許編輯，推薦用於非管理員場景。
    *   **自動審查 (Auto-Review)**：根據情況進行審查，部分敏感操作仍需授權。
    *   **完全訪問 (Full Access/YOLO)**：無需任何授權，直接執行所有命令，適合不想被反覆確認打斷的開發場景。
*   **APP 設置**：可在左下角設置默認權限，推薦開發項目使用完全訪問權限以節省時間。

### 十、 腳本化與環境初始化
*   **腳本整合**：
    *   將 `Codex exec` 子命令整合進自動化工作流或傳統腳本。
    *   **Linux 環境**：可結合 `grep` 等命令進行過濾處理。
    *   **Windows 環境**：無 `grep`，可使用 `rg` (Ripgrep) 或 PowerShell 命令組合。
    *   範例：結合 `Codex exec` 與系統命令分析目錄結構。
*   **環境初始化 (重要)**：
    *   **目的**：避免在對話中浪費 Token 來詢問環境配置。
    *   **操作**：在啟動 Codex 前，提前激活虛擬環境（如 Python）、設置目錄權限、暴露根目錄。
    *   **好處**：Codex 啟動時已具備完整上下文，可直接進行提問或執行清理、抓取等任務，提升效率。
*   **目錄與路徑指定**：
    *   使用 `-c` 參數指定 Git 倉庫。
    *   使用 `at` 指定特定文件或目錄進行分析或審查。
    *   跨目錄操作時，需配置權限暴露更多根目錄，因為默認僅操作當前會話目錄。

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

*   **Codex**：主要討論的 AI 編程助手/CLI 工具。
*   **GPT-5.5**：講者推薦用於對話、推理、任務規劃的模型。
*   **Codex 5.3**：講者推薦專門用於寫代碼的版本。
*   **L1E3**：講者提及的生成圖片模型（疑點：可能為 DALL-E 3 的聽寫錯誤）。
*   **GBT image2**：講者提及的生成圖片模型（疑點：可能為 GPT-4 Image 或類似名稱的聽寫錯誤）。
*   **Scale**：講者提及的內置模型調用方式。
*   **OpenAI**：提及的官方模型提供方。
*   **GitHub**：提及的代碼託管平台，涉及 PR 審查與 Token 配置。
*   **YOLO**：講者提及的減少確認的模式。
*   **Telry**：講者提及的搜尋工具（疑點：需查證，可能為特定搜尋 API 名稱）。
*   **Beamsearch**：講者提及的搜尋工具（疑點：需查證，可能為特定搜尋 API 名稱）。
*   **Tile Research**：講者提及的檢索插件（疑點：需查證，可能為特定插件名稱）。
*   **DALL-E 3**：講者口誤提及的生成圖片模型（聽似 L1E3）。
*   **Grep**：Linux 下的文本搜索命令。
*   **Ripgrep (RG)**：講者推薦的替代 Grep 的工具。
*   **PowerShell**：Windows 下的腳本環境。
*   **Python**：提及的虛擬環境語言。

## 操作流程整理

1.  **初始化環境**：
    *   在啟動 Codex 前，激活虛擬環境（如 Python）。
    *   設置目錄權限，暴露根目錄。
    *   使用 `-c` 參數指定 Git 倉庫，或使用 `at` 指定特定文件/目錄。
2.  **選擇執行模式**：
    *   一般對話：直接輸入 `Codex <提示詞>`。
    *   自動化腳本：使用 `Codex exec <提示詞>`。
3.  **會話管理**：
    *   查看歷史：`Codex status` 獲取 `sessionID`。
    *   恢復對話：`Codex resume <sessionID>` 或 `Codex resume`。
    *   清理上下文：`clean`。
4.  **執行代碼審查**：
    *   執行 `Codex review`。
    *   若結果為英文，要求翻譯為中文。
    *   根據反饋（P1, P2, P3）提示 Codex 修復。
    *   要求輸出「對照表格」並循環檢查直至修復。
5.  **整合系統命令**：
    *   Linux：結合 `grep` 過濾。
    *   Windows：結合 `rg` (Ripgrep) 或 PowerShell。
6.  **配置權限**：
    *   在 APP 左下角設置默認權限，開發項目建議設置為「完全訪問 (Full Access/YOLO)」。

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

*   **Web 搜尋緩存**：默認 Web 搜尋使用 OpenAI 維護的網頁檢索結果，可能存在緩存，不一定為最新實時數據。
*   **權限限制**：
    *   PR 審查需配置 GitHub Token，公共倉庫可能無需 Token。
    *   默認權限模式下，編輯文件或敏感命令需要用戶授權。
    *   跨目錄操作時，需配置權限暴露更多根目錄，因為默認僅操作當前會話目錄。
*   **Token 消耗**：若未在啟動前初始化環境，Codex 可能會在對話中浪費 Token 來詢問環境配置。
*   **模型口誤風險**：講者提及的部分模型名稱（如 L1E3, GBT image2）可能存在聽寫錯誤，需謹慎確認實際調用的模型。

## 逐字稿辨識疑點

*   **L1E3**：講者口述為生成圖片的模型，疑似為 **DALL-E 3** 的聽寫錯誤。
*   **GBT image2**：講者口述為生成圖片的模型，疑似為 **GPT-4 Image** 或 **GPT-4o** 相關功能的聽寫錯誤。
*   **Telry**：講者提及的搜尋工具，需查證具體名稱，可能為 **Tavily** 或其他搜尋 API。
*   **Beamsearch**：講者提及的搜尋工具，需查證具體名稱，可能為特定搜尋服務。
*   **Tile Research**：講者提及的檢索插件，需查證具體名稱，可能為 **Tavily Research** 或其他插件。
*   **諾一 / 洛伊**：講者多次提及一個項目名稱，聽似「諾一」或「洛伊」，需查證具體項目名稱。
*   **攤志舌 / 貪吃蛇**：講者口述遊戲名稱，聽似「攤志舌」，實際應為「貪吃蛇」，但依規則標為疑點。
*   **殺箱模式**：講者口述權限模式，聽似「殺箱」，需查證是否為特定術語或聽寫錯誤。
*   **審數**：講者口述命令參數，聽似「審數」，需查證是否為特定參數。
*   **記忽**：講者口述「記忽什麼」，疑似為「忽略」或「記住」的聽寫錯誤。
*   **出手法好了**：講者口述「上下文都出手法好了」，疑似為「上下文都準備好了」的聽寫錯誤。

## 可延伸追問

*   如何具體配置 GitHub Token 以進行 PR 審查？
*   「Telry」、「Beamsearch」及「Tile Research」具體是指哪些第三方搜尋工具或插件？
*   在非交互式執行 (`exec`) 中，如何處理需要多輪對話的複雜任務？
*   對於「完全訪問 (Full Access/YOLO)」模式，有哪些潛在的安全風險需要警惕？
*   如何編寫腳本來自動調用 `Codex exec` 並處理其輸出結果？