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 生成，请仔细甄别