# 影片筆記：DeepSeek V4正式版+Codex工业Agent开发实战！从零手搓AI数据分析Agent，Responses API调用流程与Codex核心功能详解！ p04 04.Codex接入与核心使用方法介绍

## 一句話總結

本段內容詳細介紹了 OpenAI Codex CLI 的安裝方式、透過官方腳本接入 DeepSeek V4 模型的配置流程，以及解析 Codex 的項目結構（如 `agents.md` 與 `.codex` 資料夾）、核心概念（Profile、Agent、Skill）與相關斜線命令的使用。

## 核心重點

*   **Codex 安裝與生態**：Codex 包含 CLI、桌面端（已與 ChatGPT 合併）、IDE 擴展及 Cloud 環境。開發者需掌握 CLI 操作，建議透過 `CURL`、`NPM` 或 `Home Pro` (MacOS) 安裝，最新版本號為 `0.146.0`。
*   **DeepSeek 模型接入**：
    *   **官方推薦**：使用 `codex-deep-research-setup` 自動腳本，可自動配置模型提供者、介入方法及日誌路徑。用戶可選擇 `DeepSeek V4 Flash` 或 `DeepSeek V4 Pro`（若正式版未上線則僅能選 Flash）。若切回原始環境需重新授權。
    *   **中轉方案**：對於響應格式不符的模型（如 Anthropic），可使用 `CCSWITCH` (或 `Sysswitch`/`SYSWITCH`) 進行本地格式轉換，將 DeepSeek 響應轉為 Codex 可接受格式。因 DeepSeek 已兼容，此方法非必須。
*   **項目結構與核心概念**：
    *   **目錄結構**：`agents.md` 定義全局核心指令與永久記憶；`.codex` 資料夾保存子 Agent 定義（提及 `.TML` 格式）。
    *   **核心對象**：
        *   **Profile**：臨時灌入的上下文與提示詞，指定任務類型。
        *   **Agent (子 Agent)**：保存於 `.codex`，包含名稱、描述、sandbox 權限及 `developer instructions`，用於拆解複雜任務。
        *   **Skill (技能)**：類似 Agent，用於靈活加載技能與上下文。
        *   **Sub-agent**：子 Agent 派發工作的方式。
*   **操作命令**：
    *   `/compact`：壓縮上下文。
    *   `/model`：切換模型。
    *   `/permissions`：設置權限。
    *   `/states`：查看狀態。
    *   **Exec 功能**：輸入完整指令一次性完成任務。

## 詳細大綱

### 一、 Codex 工具生態與安裝
1.  **產品線概覽**：
    *   包含 Codex CLI、桌面端（與 ChatGPT 合併為單一 APP）、IDE 擴展、Cloud 環境。
    *   強調開發者最終需克服命令行 (CLI) 操作，這是開發趨勢。
2.  **安裝方法**：
    *   最常見：使用 `CURL` 命令安裝。
    *   替代方案：若已安裝 `NPM` 可使用 NPM 安裝；MacOS 用戶可使用 `Home Pro` 安裝。
    *   驗證：安裝後輸入 `version` 查看版本，目前最新版本號為 `0.146.0`。

### 二、 模型接入與配置 (DeepSeek 整合)
1.  **官方接入方式 (推薦)**：
    *   使用官方提供的自動腳本 `codex-deep-research-setup`。
    *   **MacOS 用戶**：運行特定命令，腳本會自動完成配置遷移。
    *   **Windows 用戶**：運行對應命令。
    *   **腳本功能**：自動修改底層配置，包括模型提供者 (model provider)、介入方法、`written effort`、`chat log` 保存路徑等。
    *   **選項選擇**：運行後會提示選擇使用 `Deepseek V4 Flash`、`Deepseek V4 Pro` 或回到原始 Codex 環境。
        *   註：DeepSeek V4 Pro 正式版未上線時，僅能選擇 Flash 版本。
    *   **授權**：若切回原始 Codex 環境，需重新進行授權 (Subscription)。
2.  **中轉接入方式 (CCSWITCH / Sysswitch)**：
    *   **背景**：部分模型 (如 Anthropic) 的響應格式不符合 Codex 要求，需進行格式轉換。
    *   **工具**：`CCSWITCH` (或稱 `Sysswitch`/`SYSWITCH`)，原為 Cloud Code 的同步映射工具。
    *   **運作原理**：在本地通過 GUI 頁面運行，將 DeepSeek 的原始響應格式轉換為 Codex 可接受的格式，而非修改 Codex 本身配置。
    *   **現狀**：因 DeepSeek 已兼容 Codex 版本 API 響應格式，此方法非必須，但對於舊有使用者仍可使用。

### 三、 Codex 項目結構與核心概念
1.  **基本目錄結構**：
    *   `agents.md`：位於項目底層，定義全局核心指令、目標、核心功能與規則。此文件不會隨上下文變化，是項目永久的核心記憶。
    *   `.codex` 資料夾：保存子 Agent (Sub-agent) 定義，格式為 `.TML` (或 `.md` 相關格式，文中提及 TML 格式定義)。
    *   其他文件：`profile` (提示詞文件)、`skeema` (架構/模式文件)、`test`、`readme`。
2.  **核心對象解析**：
    *   **Profile**：
        *   定義：每次開啟 Codex 時輸入的文本信息或提示詞。
        *   用途：臨時灌入上下文，指定執行任務類型。
        *   配置：可創建多個 profile 文檔對應不同 Agent 任務。
    *   **Agent (子 Agent)**：
        *   定義：保存在 `.codex` 資料夾中，用於處理特定類型任務 (如 PRD 審查、測試腳本編寫)。
        *   結構：需包含名稱 (name)、描述 (description)、sandbox 權限設置、以及 `developer instructions` (開發者指令，定義每次運行加載的上下文)。
        *   目的：將複雜任務拆解，分派給具備獨立上下文的子 Agent 完成。
    *   **Skill (技能)**：
        *   定義：類似 Agent，需包含名稱、描述及技能文檔。
        *   用途：靈活加載對應的技能與上下文。
    *   **Sub-agent (子代理)**：
        *   定義：子 Agent 派發工作的一種方式。
3.  **其他功能與命令**：
    *   **斜線命令 (Slash Commands)**：
        *   `/compact`：壓縮上下文 (文中提及「去亞洲藏小文」疑為語音識別錯誤，意指壓縮/壓縮上下文)。
        *   `/model`：切換當前模型。
        *   `/permissions`：設置對話權限。
        *   `/states`：查看當前繪畫/運行狀態。
    *   **記憶機制**：Codex 具有全局記憶與跨文檔記憶，但也需透過 `memory` 參數或鉤子系統 (Hook system) 人工設定記憶。
    *   **Exec 功能**：輸入完整指令，一次性完成任務，中途不間斷。

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

*   **Codex**：OpenAI 的命令行工具及相關產品線 (CLI, Desktop App, IDE Extension, Cloud)。
*   **ChatGPT**：與 Codex 桌面端合併的應用。
*   **DeepSeek**：
    *   `DeepSeek V4 Flash`：文中提到的正式版模型。
    *   `DeepSeek V4 Pro`：文中提到正式版尚未上線的模型。
*   **Anthropic**：被提及為響應格式不符合要求的模型提供商。
*   **Cloud Code**：Google 的編碼工具，文中提及曾封號及與 Codex 的對比。
*   **CCSWITCH**：文中主要提及的中轉工具名稱。
*   **Sysswitch / SYSWITCH**：文中交替出現的中轉工具名稱，被描述為 Cloud Code 的編碼形式同步映射工具。
*   **CURL**：安裝命令工具。
*   **NPM**：Node.js 包管理工具，用於安裝。
*   **Home Pro**：文中對 MacOS 安裝工具的稱呼 (疑為 Homebrew 的聽寫錯誤，但依規則保留原樣)。
*   **codex-deep-research-setup**：官方提供的自動配置腳本名稱。
*   **agents.md**：Codex 項目中的全局核心指令文件。
*   **.codex**：保存子 Agent 定義的資料夾。
*   **Profile**：提示詞上下文文件。
*   **Skeema**：文中提到的架構/模式文件 (疑為 Schema 的聽寫錯誤)。
*   **TML**：文中提到的子 Agent 定義格式。

## 操作流程整理

1.  **安裝 Codex CLI**：
    *   根據作業系統選擇安裝方式：
        *   Linux/通用：使用 `CURL` 命令。
        *   已安裝 Node.js：使用 `NPM` 安裝。
        *   MacOS：使用 `Home Pro` 安裝。
    *   驗證安裝：執行 `version` 命令，確認版本號為 `0.146.0`。
2.  **接入 DeepSeek 模型 (官方推薦)**：
    *   執行官方自動腳本 `codex-deep-research-setup`。
    *   根據作業系統 (MacOS/Windows) 運行對應命令。
    *   腳本自動修改底層配置 (模型提供者、介入方法、`written effort`、`chat log` 路徑)。
    *   選擇模型版本：`Deepseek V4 Flash` 或 `Deepseek V4 Pro` (若 Pro 未上線則選 Flash)。
    *   若選擇切回原始 Codex 環境，需重新進行授權 (Subscription)。
3.  **接入 DeepSeek 模型 (中轉方案 - 非必須)**：
    *   若模型響應格式不符 (如 Anthropic)，運行 `CCSWITCH` (或 `Sysswitch`/`SYSWITCH`)。
    *   在本地 GUI 頁面運行，將 DeepSeek 原始響應格式轉換為 Codex 可接受格式。
4.  **配置項目結構**：
    *   建立 `agents.md` 定義全局核心指令與規則。
    *   建立 `.codex` 資料夾，內部定義子 Agent (格式提及 `.TML`)。
    *   建立 `profile` 文件用於臨時上下文灌入。
    *   建立 `skeema` 文件 (架構/模式)。
5.  **使用核心功能**：
    *   使用 `/model` 切換模型。
    *   使用 `/permissions` 設置權限。
    *   使用 `/compact` 壓縮上下文。
    *   使用 `Exec` 功能輸入完整指令一次性完成任務。

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

*   **模型版本限制**：DeepSeek V4 Pro 正式版未上線時，用戶僅能選擇 Flash 版本。
*   **授權風險**：若從 DeepSeek 模型切回原始 Codex 環境，需重新進行授權 (Subscription)。
*   **格式兼容性**：部分模型 (如 Anthropic) 的響應格式不符合 Codex 要求，需依賴中轉工具 (CCSWITCH) 進行轉換，若不使用中轉工具可能無法正常工作。
*   **CLI 操作門檻**：開發者最終需克服命令行 (CLI) 操作，這是開發趨勢，對新手可能有學習曲線。

## 逐字稿辨識疑點

*   **「Home Pro」**：文中提到 MacOS 安裝工具為 `Home Pro`，通常 MacOS 套件管理器為 `Homebrew`，此處可能為口誤或聽寫錯誤。
*   **「去亞洲藏小文」**：在介紹 `/compact` 命令時，文中描述為「去亞洲藏小文」，根據語境推測應為「壓縮上下文」或類似含義，但依規則標記為疑點。
*   **「TML 格式」**：文中提到子 Agent 定義為 `TML` 格式，通常 Markdown 為 `.md`，TML 可能為口誤或特定格式縮寫，需查證。
*   **「CCSWITCH」與「Sysswitch/SYSWITCH」**：文中交替使用 `CCSWITCH`、`Sysswitch` 和 `SYSWITCH` 指代同一個中轉工具，名稱不一致，需查證正確名稱。
*   **「written effort」**：在描述腳本配置時出現 `written effort`，此非標準技術術語，可能為 `token limit`、`write effort` 或其他配置參數的聽寫錯誤。
*   **「Skeema」**：文中提到項目文件中有 `skeema`，通常資料庫架構工具為 `Schemac` 或 `Schema`，此處可能為聽寫錯誤。
*   **「Compac」/「Compact」**：文中斜線命令提及 `Compact`，但口語描述為「去亞洲藏小文」，確認命令為 `/compact`。
*   **「CodexClip」**：文中提到產品線時出現 `CodexClip`，需確認是否為正確產品名稱。

## 可延伸追問

*   `codex-deep-research-setup` 腳本具體的執行參數與配置檔案路徑為何？
*   `CCSWITCH` (或 `Sysswitch`) 的具體安裝與配置步驟為何？
*   `.TML` 格式的子 Agent 定義具體的語法結構是什麼？
*   如何具體編寫 `agents.md` 中的全局核心指令以達到最佳效果？
*   `written effort` 在 Codex 配置中具體代表什麼參數？