優雲API 優雲API 文件

Claude Desktop 第三方 Provider 設定指南

本教學將指導你如何在 Claude Desktop 客戶端中設定第三方 API Provider,使其通過自定義網關連接到不同的 AI 服務(如 yycode、Kimi 等)。

前置準備

在開始設定之前,請確保:

  1. 已下載並安裝 Claude Desktop 客戶端
  2. 擁有第三方服務的 API Key
  3. 了解該服務的 Gateway 地址(Base URL)

下載 Claude Desktop

存取官方下載頁面取得最新版本:

Claude Desktop 下載

Claude Desktop 下載頁面

macOS 設定流程

第一步:啟用開發人員模式

  1. 打開 Claude Desktop 客戶端

    Claude Desktop 主介面

  2. 點選頂部菜單欄的 Help(幫助),依次選擇 TroubleshootingEnable Developer Mode

    啟用開發人員模式

  3. 在確認對話框中點選 Enable,應用將自動重啟

    確認啟用開發人員模式

第二步:設定第三方介面

  1. 重啟後進入歡迎介面,先不要登入。保持客戶端處於選中狀態,此時頂部菜單欄會出現 Developer 選項

    Developer 菜單

  2. 點選 DeveloperConfigure Provider,打開設定面板

  3. 填寫第三方介面資訊。以 DragonCode 為例:

    設定第三方介面

    設定項
    Gateway base URL https://yycode.net
    Gateway API key 你的 yycode API Key
  4. 點選右下角的 Apply locally

  5. 在彈出的確認框中選擇 Relaunch now 重啟應用

    重啟確認

  6. 重啟後點選 Continue with gateway,即可進入主介面

    Continue with gateway

介面說明

進入主介面後,可以使用以下快捷鍵切換視圖:

快捷鍵 功能
Command + 1 Cowork 介面(預設)
Command + 2 編碼介面

功能驗證

設定完成後,可以通過簡單對話驗證連接是否成功。例如詢問目前使用的模型:

驗證模型連接

插件與技能說明

如果你已在 Claude Code CLI 中設定並啟用了插件或技能,Desktop 端會自動同步這些設定。你也可以手動在 Desktop 端上傳技能檔案:

插件與技能同步

高級設定

設定最高權限

預設情況下,Claude Desktop 執行敏感操作時會彈出確認框。如需關閉確認提示,可設置最高權限:

  1. 點選左下角的 Cowork 3P | Gateway 狀態區域,或按 Command + , 打開設置

    打開設置

  2. 在設置面板中調整權限級別

    權限設置入口

    權限設定詳情

保持電腦活躍

執行長時間任務時,建議開啟 Keep computer awake 功能,防止電腦進入休眠狀態導致任務中斷:

Keep computer awake

注意:此功能可防止電腦進入待機狀態,顯示屏仍可自動關閉。但合上筆記本電腦蓋子仍會使設備進入睡眠狀態

設定多個 Provider

Claude Desktop 支援設定多個第三方介面,方便在不同服務間切換:

  1. 重複啟用開發人員模式的步驟

  2. 進入 DeveloperConfigure Provider

  3. 點選右上角的下拉菜單(顯示目前設定名稱,如 default

  4. 選擇 New configuration 建立新設定

    新建設定

  5. 填寫新的 Gateway 地址和 API Key(如 Kimi 的設定資訊)

    設定 Kimi

  6. 應用並重啟後,可在已設定的 Provider 間自由切換

    切換 Provider

Windows 設定流程

Windows 端的設定邏輯與 macOS 基本一致,僅開發人員模式的入口方式不同:

啟用開發人員模式

  1. 打開 Claude Desktop,進入歡迎介面的信箱輸入頁面

  2. 按下 Tab 鍵切換焦點,直到左上角的菜單圖標被選中

  3. Enter 鍵打開菜單

    Windows 菜單入口

  4. 選擇 DeveloperConfigure third-party interface

    Windows Developer 菜單

設定介面資訊

填寫 Gateway 地址和 API Key,點選 Apply locally 後重啟生效:

Windows 設定表單

常見問題

問題 解決方案
設定後無法連接 檢查 Gateway URL 是否以 https:// 開頭,API Key 是否有效
切換 Provider 後失效 確保點選了 Apply locally 並重啟應用
權限不足無法執行指令 在設置中將權限級別調整為最高

相關資源

整篇文件已複製