# 影片筆記：3步接入第三方AI模型，省钱又高效 | CodeX/Claude Code/Hermes完整教程丨中转站API丨DeepSeek

## 一句話總結

影片講解如何透過設定 Base URL、API Key 與模型名稱這三個核心要素，將第三方「中轉站 API」接入至 Hermes Studio、CodeX++ 及 Cloud Code 等 AI Agent 工具中，並示範了具體的操作步驟。

## 核心重點

1.  **API 接入三要素**：成功接入第三方模型需掌握三個關鍵資訊：
    *   **Base URL**：伺服器訪問地址，如同路口，負責將資訊傳輸至大模型網站。
    *   **API Key**：API 令牌，用於識別用戶身份，確保訊息精準發送與返回，避免混淆。
    *   **模型名稱**：用於識別所使用的具體模型。
2.  **API Key 的管理與安全**：
    *   API Key 代表帳戶金額，需嚴格保密。
    *   建議為 API Key 設定名稱以區分用途（例如區分用於 Hermes Studio 或 Mac mini M4）。
    *   可設定模型限制（僅限特定模型）或選擇默認分組。
3.  **多工具接入實戰**：
    *   分別演示了如何在 Hermes Studio、CodeX++ 和 Cloud Code (配合 CC Switch) 中配置自定義供應商（Provider），填入 Base URL 與 API Key 後獲取模型列表並進行對話測試。

## 詳細大綱

### 1. API 基礎概念解析
*   **Base URL**：定義為伺服器訪問地址或返回網址，功能是作為路口將資訊傳輸至大模型網站。
*   **API Key**：定義為 API 令牌，功能是識別用戶身份，確保訊息精準發送與返回，避免混淆。
*   **模型名稱**：功能是識別所使用的具體模型。

### 2. API Key 的創建與管理
*   以 DeepSeek API 開放平台為例，說明如何在控制台創建 API Key。
*   **注意事項**：
    *   API Key 代表帳戶金額，需保密。
    *   可設定名稱以區分用途（如接在 Hermes Studio 或 Mac mini M4）。
    *   可設定模型限制（如僅限特定模型）或選擇默認分組。

### 3. 工具接入實戰演示

#### A. Hermes Studio
1.  從 GitHub 下載對應系統版本（arm64 .dmg 或 x64 .exe）。
2.  在模型設置中添加 Provider，選擇「自定義」而非「預設」。
3.  填入 Base URL 與 API Key。
4.  獲取模型列表（如 GLM 5.1/5.2），進行對話測試。

#### B. CodeX++
1.  從 GitHub 下載並安裝至應用程式。
2.  在管理工具中點擊「供應商配置」，添加供應商（純 API）。
3.  填入 Base URL 與 API Key。
4.  獲取模型後保存並重啟 CodeX++。

#### C. Cloud Code (CC Switch)
1.  從 GitHub 下載 CC Switch 並安裝。
2.  設置中跳過 Cloud Code 初次安裝確認。
3.  打開路由通道，添加自定義配置（供應商）。
4.  填入 API Key 與請求地址。
5.  獲取模型列表並啟用。
6.  最後在 Cloud Code 桌面端進行測試。

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

*   **平台/服務**：
    *   Deepseek / DeepSeek API 開放平台
    *   OpenAI
    *   Astorpeak（疑點，需查證）
    *   Hermes Studio
    *   CodeX++
    *   Cloud Code
    *   CC Switch
*   **開發平台**：
    *   GitHub
*   **模型名稱**：
    *   GLM 5.2
    *   GLM 5.1
    *   質樸的 JOM5.2（疑點，需查證）
    *   minimax
    *   cloud 的 ops4-7（疑點，需查證）
    *   質樸模型
    *   質樸的 coding plan
*   **硬體/系統**：
    *   Mac mini M4
    *   M 芯片（蘋果）
    *   英特爾（蘋果）
    *   Windows
    *   arm64 .dmg
    *   x64 .exe
    *   x64 .dmg
    *   .MSI

## 操作流程整理

### 通用接入流程
1.  **準備資訊**：從 API 開放平台（如 DeepSeek）獲取 Base URL 和 API Key。
2.  **配置供應商**：在目標工具中找到供應商（Provider）或供應商配置選項。
3.  **選擇模式**：選擇「自定義」或「純 API」模式，而非預設模式。
4.  **填入憑證**：輸入 Base URL 和 API Key。
5.  **驗證與測試**：獲取模型列表，確認模型顯示正常，並進行對話測試。

### 各工具特定步驟
*   **Hermes Studio**：下載對應架構版本 -> 添加 Provider -> 選擇自定義 -> 填入 URL/Key -> 測試 GLM 系列模型。
*   **CodeX++**：安裝應用 -> 供應商配置 -> 添加純 API 供應商 -> 填入 URL/Key -> 保存並重啟。
*   **Cloud Code**：安裝 CC Switch -> 跳過初次確認 -> 打開路由通道 -> 添加自定義供應商 -> 填入 URL/Key -> 啟用模型 -> 桌面端測試。

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

1.  **API Key 安全性**：API Key 直接代表帳戶金額，若洩露可能導致資金損失，需嚴格保密。
2.  **模型限制設定**：若未正確設定模型限制，可能會產生預期外的費用或調用錯誤的模型。
3.  **系統架構兼容性**：下載工具時需嚴格區分系統架構（arm64 對應 M 芯片，x64 對應英特爾），下載錯誤版本可能無法運行。
4.  **重啟需求**：部分工具（如 CodeX++）在修改供應商配置後，必須重啟軟體才能生效。

## 逐字稿辨識疑點

*   **Astorpeak**：逐字稿提及「OpenAI 和這個 Astorpeak」，疑似為某平台名稱，但常見拼寫可能為其他名稱，保留原樣。
*   **質樸的 JOM5.2**：逐字稿提及「我只想用其中的某一个，比如说质朴的 JOM5.2」，「JOM5.2」疑似為模型名稱聽寫錯誤，保留原樣。
*   **cloud 的 ops4-7**：逐字稿提及「我只想用 cloud 的 ops4-7」，疑似為模型名稱聽寫錯誤，保留原樣。
*   **APM 一样**：逐字稿提及「找到我们的 APM 一样」，語境中應指 API Key，但聽寫為 APM 一样，保留原樣。
*   **DeepZim GLM**：逐字稿在 CodeX++ 設置供應商名稱時提到「DeepZim GLM」，疑似為 DeepSeek 或其他名稱的聽寫錯誤，保留原樣。
*   **DPZ**：逐字稿在 Cloud Code 設置供應商時提到「供应商还是我们刚刚的 DPZ」，疑似為 DeepSeek 或其他名稱的聽寫錯誤，保留原樣。
*   **codex 加价**：逐字稿提及「点击之后我们点这个重启 codex 加价」，疑似為「CodeX++」的聽寫錯誤，保留原樣。
*   **coding 笔组**：逐字稿標題提及「最后是我们的 coding 笔组，cloudcode」，疑似為「Coding 筆組」或類似名稱的聽寫錯誤，保留原樣。
*   **礼行**：逐字稿結尾提及「给大家发一个礼行」，疑似為「例行」或「你好」等詞的聽寫錯誤，保留原樣。

## 可延伸追問

1.  中轉站 API 的收費模式與直接調用官方 API 相比，具體節省了多少成本？
2.  若 API Key 洩露，應如何快速在 DeepSeek 等平台進行撤銷或重置？
3.  Hermes Studio、CodeX++ 與 Cloud Code 在處理長上下文或特定任務時，接入中轉站 API 後是否有性能差異？
4.  對於「模型限制」功能，若設置錯誤導致無法調用模型，應如何排查與修復？
5.  CC Switch 作為 Cloud Code 的路由通道，其穩定性與延遲表現如何？