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

## 一句話總結

影片演示了如何在 JetBrains 的 **Cloud Code** 與 **Codex** 中接入第三方模型（如 DeepSeek V4、阿里百煉/千問）。Cloud Code 配置簡便，透過環境變數即可；Codex 則因僅支援 **Response API** 協議，對於不支援該協議的模型（如 DeepSeek V4），需透過橋接器 **CCX** 進行轉接，並實測了瀏覽器自動化操作（掃雷遊戲）的功能與限制。

## 核心重點

1.  **Cloud Code 接入簡易**：
    *   透過修改全局配置文件中的環境變數即可接入第三方模型。
    *   支援多種模型及長上下文（如 100 萬上下文）。
    *   配置簡單，約 5 到 1 分鐘即可完成。

2.  **Codex 接入複雜且受限**：
    *   Codex 僅支援最新的 **Response API** 協議（專為 Agent 設計，支援複雜返回結構）。
    *   許多第三方模型（如 DeepSeek V4）目前不支援此協議，無法直接接入。
    *   需手動修改隱藏目錄下的 `auth.json` 與 `config.tml` 文件。

3.  **橋接器 CCX 的使用**：
    *   對於不支援 Response API 的模型（如 DeepSeek V4），需使用開源工具 **CCX** 作為橋接。
    *   CCX 可將標準 API 轉換為 Codex 所需的 CodexResponse 格式。
    *   官方建議：不推薦在官方 APP 外額外安裝組件（增加配置與管理成本），建議等待模型原生支援。

4.  **實測功能與限制**：
    *   **支援模型**：阿里百煉/千問（影片中稱「簽問」）支援 Response API，可直接使用。
    *   **不支援模型**：DeepSeek V4 需透過 CCX 橋接。
    *   **高級功能**：透過 CCX 橋接後，DeepSeek V4 Pro 可調用瀏覽器玩掃雷遊戲（非圖像識別，而是讀取 DOM 並調用 PlayWide 工具處理點擊與滾動）。
    *   **多模態限制**：DeepSeek API 目前不支援圖像輸入，導致 Codex 中與截圖相關的功能（如 Command 鍵應用快照）無法使用。預計下個月 4.1 版本可能支援多模態輸入。

## 詳細大綱

### 一、 前言與背景
*   **官方支援現狀**：Codex 和 Cloud Code 官方一直支援接入其他模型（如 DeepSeek V4、多包、本地部署模型）。
*   **接入動機**：
    *   企業合規要求（指定模型）。
    *   安全與隱私考量（本地部署）。
*   **安全聲明**：本影片僅演示官方推薦路徑，避免使用非官方方法或不正規 API 帶來的風險。

### 二、 Cloud Code 接入第三方模型（簡易版）
*   **配置步驟**：
    1.  根據操作系統找到 Cloud Code (CC) 的全局配置文件。
    2.  貼上環境變數配置。
    3.  替換模型名稱、Base URL 及 API Key。
*   **驗證方式**：
    *   在 CC 中使用斜杠 `/Context` 命令檢查配置。
    *   確認模型（如 Deep-seek V4 Pro）及上下文長度（100萬）已生效。
*   **優點**：配置簡單，約 5 到 1 分鐘即可完成。

### 三、 Codex 接入第三方模型（進階版）
*   **初始狀態**：安裝後輸入任意 API Key（如 1024）即可進入界面，但無法真正使用。
*   **配置步驟（以 MacOS 為例）**：
    1.  進入用戶目錄下的隱藏文件夾 `.codex`。
    2.  修改 `auth.json`：填入真實的 API Key。
    3.  修改 `config.tml`：填入模型配置。
*   **關鍵難點：API 協議限制**
    *   Codex 僅支援最新的 **Response API**（專為 Agent 設計，支援複雜返回結構）。
    *   支援此協議的第三方模型較少。
    *   **注意事項**：
        *   需確認模型廠商是否支援 Response API 及支援程度。
        *   區分不同平台的 API Key（例如阿里百煉的 API Key 與 CodingPlan Key 不同）。
        *   配置項必須放在 `config.tml` 的頂層，不可縮進至任何 section。
*   **驗證**：重啟 Codex 後，確認模型生效並調用內置工具讀取配置信息。

### 四、 實測問題與解決方案（DeepSeek 案例）
*   **問題發現**：
    *   使用「簽問 3.7」時，工具調用出錯，高級功能幾乎無法使用（推測因部分參數不支援）。
    *   使用 **DeepSeek V4** 時，因不支援 Response API，無法直接接入。
*   **解決方案：使用橋接器 CCX**
    *   **推薦度**：不推薦在官方 APP 外額外安裝組件（增加配置與管理成本），建議等待模型原生支援。
    *   **CCX 配置流程**：
        1.  從官網下載適合操作系統的 CCX（建議 Desktop 桌面版）。
        2.  啟動服務。
        3.  進入渠道中心，新建 DeepSeek 渠道。
        4.  目標格式選擇 **CodexResponse**。
        5.  輸入 DeepSeek 後台創建的 API Key 並保存。
*   **高級功能測試**：
    *   任務：讓 DeepSeek V4 Pro 調用瀏覽器玩掃雷遊戲。
    *   原理：非圖像識別，而是直接讀取瀏覽器 DOM，調用瀏覽器 API 和 **PlayWide** 工具處理點擊與滾動。
    *   限制：DeepSeek API 目前不支援圖像輸入，導致 Codex 中與截圖相關的功能（如 Command 鍵應用快照）無法使用。預計下個月 4.1 版本可能支援多模態輸入。

### 五、 總結與建議
*   **Cloud Code**：適合日常寫代碼、寫小說，方便好用。
*   **Codex**：適合桌面端需求多的用戶。建議等待下個月 4.1 版本支援多模態輸入後，搭配 DeepSeek 4.1 使用，以減少踩雷風險。

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

*   **Codex**：JetBrains 的智能體工具。
*   **Cloud Code (CC)**：JetBrains 的智能體工具。
*   **DeepSeek V4 / DeepSeek V4 Pro**：第三方大語言模型。
*   **DeepSeek 3.7**：第三方大語言模型（影片中提及）。
*   **簽問**：第三方模型（影片中提及，疑點見下文）。
*   **阿里百煉**：提供 API 服務的平臺。
*   **Response API**：Codex 支援的最新 API 協議。
*   **CCX**：用於橋接 DeepSeek 等不支援 Response API 模型的開源工具。
*   **PlayWide**：影片中提及的用於處理點擊和滾動的工具（疑點見下文）。
*   **CodingPlan**：影片中提及的阿里百煉相關 Key 名稱（疑點見下文）。
*   **auth.json**：Codex 配置文件。
*   **config.tml**：Codex 配置文件（疑點見下文）。

## 操作流程整理

### Cloud Code 接入流程
1.  找到 Cloud Code 的全局配置文件（依操作系統而定）。
2.  貼上環境變數配置。
3.  替換模型名稱、Base URL 及 API Key。
4.  使用斜杠 `/Context` 命令檢查配置，確認模型及上下文長度生效。

### Codex 接入流程（支援 Response API 的模型）
1.  進入用戶目錄下的隱藏文件夾 `.codex`。
2.  修改 `auth.json`：填入真實的 API Key。
3.  修改 `config.tml`：填入模型配置（確保配置項在頂層，不可縮進）。
4.  重啟 Codex，確認模型生效並調用內置工具。

### Codex 接入流程（不支援 Response API 的模型，如 DeepSeek V4）
1.  從官網下載適合操作系統的 CCX（建議 Desktop 桌面版）。
2.  啟動 CCX 服務。
3.  進入渠道中心，新建 DeepSeek 渠道。
4.  目標格式選擇 **CodexResponse**。
5.  輸入 DeepSeek 後台創建的 API Key 並保存。
6.  在 Codex 中配置對應的模型與 API Key，重啟 Codex 進行測試。

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

1.  **API 協議兼容性**：Codex 僅支援最新的 Response API 協議，許多第三方模型（如 DeepSeek V4）目前不支援此協議，導致無法直接接入或高級功能受限。
2.  **橋接器成本**：使用 CCX 橋接器會增加配置與管理成本，官方不推薦在官方 APP 外額外安裝組件。
3.  **多模態輸入限制**：DeepSeek API 目前不支援圖像輸入，導致 Codex 中與截圖相關的功能（如 Command 鍵應用快照）無法使用。
4.  **模型版本預期**：預計下個月 4.1 版本可能支援多模態輸入，屆時搭配 DeepSeek 4.1 使用可能減少踩雷風險。
5.  **配置錯誤風險**：Codex 配置項必須放在 `config.tml` 的頂層，不可縮進至任何 section，否則可能導致配置無效。

## 逐字稿辨識疑點

*   **「簽問」**：逐字稿中多次出現「簽問」或「簽問模型」，疑為「千問」（Qwen）的聽寫錯誤，但依規則標記為疑點。
*   **「CodingPlan」**：逐字稿提及「阿里百煉的 CodingPlan 的 Key」，疑為特定產品名稱或聽寫錯誤，標記為需查證。
*   **「config.tml」**：逐字稿中寫為 `config.tml`，通常配置文件擴展名為 `.toml` 或 `.json`，此處標記為疑點。
*   **「PlayWide」**：逐字稿中提及「PlayWide 工具」，疑為「Playwright」的聽寫錯誤，但依規則標記為疑點。
*   **「Deep-seek」**：逐字稿中部分地方寫為「Deep-seek」，與常見寫法「DeepSeek」略有不同，保留原樣。
*   **「多包」**：逐字稿提及「多包或者本地部署的签问」，「多包」語意不明，標記為疑點。

## 可延伸追問

1.  CCX 橋接器的具體安裝與維護成本為何？是否有更輕量級的替代方案？
2.  阿里百煉的 API Key 與 CodingPlan Key 具體差異為何？在配置時如何正確區分？
3.  Codex 4.1 版本支援多模態輸入後，對 DeepSeek 等模型的接入流程會有何改變？
4.  除了 DeepSeek 和阿里百煉，還有哪些第三方模型目前支援 Response API？
5.  企業用戶在合規要求下，如何評估使用 CCX 橋接器的風險與收益？