# 影片筆記：Codex 和 Claude Code 接入第三方模型 (DeepSeek V4 | Qwen 3.7)，亲测可用的官方方案！

## 一句話總結

影片詳細講解了如何在 JetBrains 環境中，透過官方認可的路線將第三方模型（如 DeepSeek V4 Pro、阿里百煉）接入 **Cloud Code** 與 **Codex** 兩個智能體工具，並針對 Codex 支援的技術痛點（Response API 協議）提供了使用開源橋接器 CCX 的解決方案與實測結果。

## 核心重點

1.  **Cloud Code (CC) 配置簡易**：
    *   只需修改全局配置文件中的環境變量（模型名稱、Base URL、API Key）。
    *   支援如 DeepSeek V4 Pro 等模型，並支援百萬上下文。
    *   適合日常寫代碼或小說，無技術門檻。

2.  **Codex 配置複雜但功能完整**：
    *   需手動修改隱藏文件 `auth.json` 與 `config.tml`。
    *   **關鍵痛點**：Codex 僅支援最新的 **Response API** 協議，導致原生支援該協議的第三方模型較少。
    *   若模型不支援 Response API（如 DeepSeek），需透過開源橋接器 **CCX** 進行轉接。

3.  **DeepSeek V4 Pro 實測方案**：
    *   透過 CCX 橋接器成功在 Codex 中調用瀏覽器插件（DOM 讀取、Playwright）執行掃雷任務。
    *   技術原理為直接讀取瀏覽器 DOM 並調用 API，而非圖像識別。

4.  **當前限制與預期**：
    *   目前 API 尚不支援圖像輸入，導致截圖、應用快照等多模態功能失效。
    *   預計待 Codex 4.1 版本更新後可改善多模態功能。
    *   桌面端高級需求建議等待 Codex 4.1 版本搭配 DeepSeek 使用。

## 詳細大綱

### 1. 前言與動機
*   官方支援接入第三方模型（DeepSeek V4、Dobel、本地部署模型等）。
*   主要驅動因素為企業合規、安全隱私及本地部署需求。
*   強調僅採用官方路線，確保安全性。

### 2. Cloud Code (CC) 接入指南
*   **優點**：配置簡單，無技術門檻。
*   **步驟**：
    1.  找到 CC 全局配置文件（依操作系統路徑）。
    2.  貼上環境變量（模型名稱、Base URL、API Key）。
    3.  使用 `/context` 命令驗證配置是否生效。

### 3. Codex 接入指南
*   **優點**：界面功能完整，但配置需手動修改文件。
*   **步驟**：
    1.  進入用戶目錄隱藏文件 `.codex`。
    2.  修改 `auth.json` 填入 API Key。
    3.  修改 `config.tml` 填入模型配置。
    4.  **關鍵注意事項**：配置項必須放在頂層（Top-level），不可縮進至任何 section。
    5.  重啟 Codex 驗證生效。

### 4. 技術痛點：Response API 協議
*   Codex 僅支援專為 Agent 設計的 Response API。
*   支援此協議的第三方模型較少。
*   需查證模型廠商文檔是否支援該協議及支援程度。
*   若模型（如阿里百煉）原生支援 Response API，可直接配置使用。
*   若模型（如 DeepSeek）不支援，則需透過開源橋接器 **CCX** 進行轉接。

### 5. DeepSeek 接入與橋接器 CCX
*   **問題**：DeepSeek 不支援 Response API，直接接入會導致工具調用錯誤。
*   **解決方案**：使用開源橋接器 **CCX**。
*   **CCX 配置步驟**：
    1.  下載安裝 Desktop 桌面版。
    2.  啟動服務。
    3.  進入渠道中心新建 DeepSeek 渠道。
    4.  目標格式選擇 `CodexResponse`。
    5.  輸入 DeepSeek 後台 API Key。

### 6. 實測與功能限制
*   **實測場景**：使用 DeepSeek V4 Pro 在 Codex 中調用瀏覽器玩掃雷。
*   **技術原理**：非圖像識別，而是直接讀取瀏覽器 DOM，調用瀏覽器 API 與 Playwright 工具。
*   **限制**：目前 API 不支援圖像輸入，導致截圖、應用快照等多模態功能失效。
*   **預期**：Codex 4.1 版本預計支援多模態輸入。
*   **補充資訊**：Deepseek 官網已灰度上線實圖模式（需查證具體功能定義）。

### 7. 總結建議
*   日常寫代碼/小說：推薦 Cloud Code。
*   桌面端高級需求：建議等待 Codex 4.1 版本搭配 DeepSeek 使用。

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

*   **Codex**：JetBrains 智能體工具。
*   **Cloud Code (CC)**：JetBrains 智能體工具。
*   **DeepSeek V4 / DeepSeek V4 Pro**：第三方模型，支援百萬上下文。
*   **DeepSeek 3.7**：提及的模型版本。
*   **Dobel**：提及的模型名稱（疑似聽寫錯誤）。
*   **簽問**：提及的本地部署模型名稱（疑似聽寫錯誤）。
*   **阿里百煉 (Alibaba Bailian)**：模型服務平台。
*   **CodingPlan**：阿里百煉相關 Key 類型。
*   **CCX**：開源橋接器，用於將 DeepSeek 等模型轉接為 Codex 支援的格式。
*   **PlayWide**：提及的瀏覽器工具（疑似 Playwright 聽寫錯誤）。
*   **Response API**：Codex 專用的 API 協議類型。
*   **DOM**：Document Object Model，瀏覽器結構模型。
*   **掃雷 (Minesweeper)**：測試場景。
*   **auth.json**：Codex 配置文件，用於存放 API Key。
*   **config.tml**：Codex 配置文件（原文拼寫，需查證擴展名）。
*   **4.1 版本**：Codex 預期更新版本，預計支援多模態。
*   **1024**：API Key 的佔位符示例。

## 操作流程整理

### Cloud Code 接入流程
1.  定位至 Cloud Code 的全局配置文件（依操作系統而定）。
2.  在配置文件中添加環境變量：
    *   模型名稱
    *   Base URL
    *   API Key
3.  在 Cloud Code 中使用 `/context` 命令，確認配置已生效。

### Codex 接入流程（原生支援 Response API 模型）
1.  進入用戶目錄下的隱藏文件夾 `.codex`。
2.  編輯 `auth.json`，填入 API Key。
3.  編輯 `config.tml`，填入模型配置。
    *   **注意**：配置項必須位於頂層（Top-level），不可縮進至任何 section。
4.  重啟 Codex 應用。
5.  驗證模型是否生效。

### Codex 接入流程（DeepSeek 透過 CCX 橋接）
1.  下載並安裝 CCX Desktop 桌面版。
2.  啟動 CCX 服務。
3.  進入 CCX 渠道中心，新建 DeepSeek 渠道。
4.  在渠道設置中，目標格式選擇 `CodexResponse`。
5.  輸入 DeepSeek 後台獲取的 API Key。
6.  在 Codex 中配置指向 CCX 的相關設置（依影片邏輯推斷，需確保 Codex 能呼叫 CCX 轉接後的接口）。
7.  重啟 Codex 並進行測試（如掃雷任務）。

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

1.  **協議兼容性**：Codex 僅支援 Response API 協議，這大幅限制了可直接使用的第三方模型數量。
2.  **多模態功能缺失**：目前 API 不支援圖像輸入，導致截圖、應用快照等多模態功能無法使用。
3.  **版本依賴**：多模態功能的恢復預計需等待 Codex 4.1 版本更新。
4.  **配置錯誤風險**：Codex 的 `config.tml` 配置若縮進錯誤（未放在頂層），將導致配置失效。
5.  **橋接器依賴**：使用 DeepSeek 等不支援 Response API 的模型時，必須依賴 CCX 橋接器，增加了架構複雜性。

## 逐字稿辨識疑點

*   **Dobel**：逐字稿提及「DeepSeek V4、Dobel或者本地部署的签问」，「Dobel」疑似為某模型名稱的聽寫錯誤，需查證。
*   **签问**：逐字稿提及「本地部署的签问」及後文「实际用签问3.7」，「签问」疑似為某模型名稱的聽寫錯誤（可能為「千問」Qwen 或其他），需查證。
*   **config.tml**：逐字稿提及配置文件為 `config.tml`，通常 JSON 或 YAML 格式常見，`.tml` 擴展名較少見，需查證是否為聽寫錯誤（如 `.toml` 或 `.json`）。
*   **PlayWide**：逐字稿提及「调用浏览器API和PlayWide工具」，疑似為 **Playwright** 的聽寫錯誤。
*   **1024**：逐字稿提及「这里随便敲个1024」，作為 API Key 的佔位符示例。
*   **Deep-seek V4 Pro 100万上下文**：逐字稿提及「Deep-seek V4 Pro 100万上下文」，需注意模型名稱連字符及上下文長度描述的準確性。
*   **灰度上线了实图模式**：逐字稿提及「Deepseek官网已经灰度上线了实图模式」，「实图模式」疑似為「實時圖像」或「多模態」功能的聽寫，需查證。

## 可延伸追問

1.  CCX 橋接器的具體開源地址與維護狀態為何？
2.  `config.tml` 的確切文件格式與語法規範為何？
3.  Codex 4.1 版本預計何時發布，多模態功能支援的具體範圍為何？
4.  除了 DeepSeek 和阿里百煉，還有哪些第三方模型原生支援 Response API？
5.  在企業環境中部署本地模型時，如何確保 CCX 橋接過程中的數據安全與合規性？