VS Code Copilot（自備模型 BYOK） 串接教學

在 VS Code 內建的 Copilot 聊天裡新增 Custom Endpoint，用櫻桃茶的模型寫程式

• 介面：OpenAI Chat Completions
• 網址寫法：寫到 /v1（https://gpt.cherrychat.org/v1）
• 推薦模型：claude-sonnet-5-5、gpt-6.1-sol
• 平台：VS Code

串接步驟

1. 準備：更新 VS Code

   把 VS Code 更新到最新穩定版（「Custom Endpoint」是較新的功能，第三方資料指出 1.122 起的穩定版提供）。使用 Copilot Business / Enterprise 帳號的，需要管理員在 Copilot 原則中允許 BYOK。

2. 新增 Custom Endpoint

   開啟聊天檢視，點模型選擇器中的齒輪「Manage Language Models」（或在命令選擇區執行「Chat: Manage Language Models」）→「Add Models」→ 選「Custom Endpoint」。依提示依序填寫：群組名稱（group name）CherryChat、顯示名稱、API key（在彈框中貼上，VS Code 會存進安全儲存區），API type 選「Chat Completions」。

   • API key（在彈框中貼上）：sk-你的金鑰

3. 編輯 chatLanguageModels.json

   VS Code 會自動開啟 chatLanguageModels.json。apiKey 那一行保持 VS Code 產生的原樣（不要換成明文 key），只把 models 改成下面這樣，然後儲存。

   • url（API 網址）：https://gpt.cherrychat.org/v1（寫到 /v1，VS Code 會補 /chat/completions）
   • id（模型名稱）：claude-sonnet-5-5

   [
     {
       "name": "CherryChat",
       "vendor": "customendpoint",
       "apiKey": "${input:cherrychatApiKey}",
       "apiType": "chat-completions",
       "models": [
         {
           "id": "claude-sonnet-5-5",
           "name": "claude-sonnet-5-5",
           "url": "https://gpt.cherrychat.org/v1",
           "toolCalling": true,
           "vision": true,
           "maxInputTokens": 128000,
           "maxOutputTokens": 16000
         }
       ]
     }
   ]

4. 在聊天中選用

   回到聊天檢視，在模型選擇器的「CherryChat」群組中選取模型，傳一句話測試。模型沒出現時請重新啟動 VS Code。

容易踩的坑

• 要選「Custom Endpoint」；舊的「OpenAI Compatible」與 github.copilot.chat.customOAIModels 設定都已棄用。
• url 填 https://gpt.cherrychat.org/v1 時 VS Code 會自動補 /chat/completions，直接寫全 https://gpt.cherrychat.org/v1/chat/completions 也行；不要把 key 明文寫進 JSON。
• BYOK 只用於聊天和部分輔助任務；Tab 行內程式碼補全、語意搜尋仍走 GitHub Copilot 自己的服務。
• toolCalling 設為 true 才能在 Agent 模式中呼叫工具；vision 只給能看圖的模型開啟。
• Claude 模型也可以單獨設 "apiType": "messages"、url 填 https://gpt.cherrychat.org，走 Claude 原生格式。

錯誤訊息 → 原因 → 怎麼辦

教學核對於 2026-11-02。工具介面改版後可能和這裡略有不同，以官方文件為準。

API 串接 · API 模型價格

Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 內容由 AI 生成，請仔細甄別