GitHub Copilot BYOK:用自己的 key 接 Claude、GPT 与国产模型
截至 2026-10-07,GitHub Copilot 自带 API key(BYOK)接 Claude,QCode 文档给出配法的入口有两个:VS Code Chat 的 Custom Endpoint(apiType 选 messages)与 Copilot CLI(COPILOT_PROVIDER_TYPE=anthropic)。JetBrains 的自定义端点官方只写了 OpenAI 兼容,经 QCode 能确认可用的只有 GPT 与国产模型。VS Code 官方写明 BYOK 模型不需要 Copilot 套餐;行内补全不走 BYOK。
更新于 2026-10-08
四个关键值
VS Code 接 Claude 的 apiType
VS Code 的 Custom Endpoint 支持 Chat Completions、Responses 与 Anthropic Messages 三种 API;QCode 文档写明 Claude 模型只能用 messages。
Copilot CLI 接 Claude 的 provider 类型
COPILOT_PROVIDER_TYPE 官方取值只有 openai(默认)、azure、anthropic 三种;接 Claude 设成 anthropic,接 GPT 与国产模型用 openai。
两处地址写法相反
VS Code 的 url 写到完整请求路径,如 https://api.qcode.cc/api/v1/messages;CLI 的 COPILOT_PROVIDER_BASE_URL 只写 https://api.qcode.cc/api。QCode 文档的原话是两处形态相反,照抄必错。
VS Code 的 BYOK 要不要 Copilot 套餐
VS Code 官方写明 BYOK 模型不登录 GitHub、没有 Copilot 套餐也能用;Copilot Business 与 Enterprise 的管理员可以用策略把它关掉。
Copilot BYOK 是什么、覆盖哪些入口
截至 2026-10-07,Copilot BYOK 指在 Copilot 客户端里填自己的模型提供商地址与 API key,让聊天与 agent 请求发到你配置的端点,而不是 GitHub 托管的模型。GitHub 文档把它分成两种:本地 BYOK,key 只在客户端处理、存在本机,VS Code、JetBrains、Xcode、Copilot CLI、GitHub Copilot app 与 Copilot SDK 都支持;企业 BYOK,由企业或组织所有者在后台添加 key,面向 Copilot Business 与 Enterprise 用户,目前是公开预览。官方称本地 BYOK 不依赖 GitHub 的 Copilot API,适合隔离网络环境或没有 Copilot 订阅的用户。它只管聊天:VS Code 官方写明行内补全(代码补全)与语义搜索仍需要 GitHub 账号。
为什么现在有人找 BYOK
GitHub 在一个多月里宣布了三轮 Copilot 内置模型弃用。GitHub changelog 写明:2026-09-01 起在大多数 Copilot 体验里弃用 Claude Opus 4.5、Opus 4.6、Sonnet 4.5、Sonnet 4.6 等型号(Sonnet 4.6 对年付个人订阅者保留);2026-10-02 在所有 Copilot 体验里弃用 Claude Opus 4.7 等四个型号;2026-10-19 还将弃用 GPT-5.5、GPT-5.4、GPT-5.4 mini、GPT-5 mini、Gemini 3.7 Flash 与 Grok 4.5 六个型号。BYOK 时型号由你在配置里自己填(VS Code 的 models 列表、CLI 的 COPILOT_MODEL)。Copilot CLI 的发布说明还写明,配置无效时它会给出明确报错,不会悄悄退回 GitHub 托管的模型。
BYOK 在各个 Copilot 入口落地的时间线
Copilot CLI 支持 BYOK 与本地模型:启动前设几个环境变量,就能接 Azure OpenAI、Anthropic 或任意 OpenAI 兼容端点;用自己的模型提供商时不需要 GitHub 登录。
VS Code 1.122 发布:Custom Endpoint 进入 Stable,支持 Chat Completions、Responses 与 Messages 三种 API;BYOK 从这一版起不登录 GitHub 也能用。
GitHub Copilot for JetBrains 扩展 BYOK,可以配置 OpenAI 兼容的自定义端点。官方这条只写了 OpenAI 兼容,经 QCode 用 Claude 走不了这条路。
已确认 vs 没有核实到的
已确认(官方页逐字可核)
以下都能在 GitHub 文档、GitHub changelog、VS Code 文档或 QCode 文档里逐字核到:VS Code 的 Custom Endpoint 支持 Chat Completions、Responses 与 Anthropic Messages 三种 API,vendor 填 customendpoint;Copilot CLI 的 provider 类型只有 openai、azure、anthropic 三种,openai 类型对应 OpenAI Chat Completions 兼容端点;CLI 的模型必须支持工具调用与流式输出,官方建议上下文至少 128k;VS Code 的 BYOK 模型不需要 Copilot 套餐,行内补全与语义搜索仍要 GitHub 账号;JetBrains 自 2026-07-14 起支持 OpenAI 兼容的自定义端点;GitHub Copilot app 的 BYOK 支持 Anthropic 与任意 OpenAI 兼容 HTTP 端点,要登录 GitHub 但不需要 Copilot 套餐;企业 BYOK 处于公开预览。QCode 侧:Claude 模型只能走 Anthropic 协议端点。
未证实与官方未公布
三件事本页不下结论:① JetBrains 端能否用 Anthropic 协议接自定义地址,官方页没有写,QCode 文档也写明未确认,本页不给在 JetBrains 里接 Claude 的配法。② GitHub Copilot app 与企业 BYOK 官方都列了 Anthropic 与 OpenAI 兼容端点,但 QCode 文档没有给这两处的配法,本页不写具体填法。③ QCode 文档按 VS Code 1.138.0 与 Copilot CLI v1.0.86 核实,之后版本的界面与字段名以你的客户端为准。
VS Code 和 Copilot CLI 怎么选
VS Code Chat(Custom Endpoint)
适合在编辑器里聊天和跑 agent。一份 chatLanguageModels.json 可以并排放 Claude(messages)与 GPT、国产模型(chat-completions)两组,模型选择器里同时出现;要在 Agent 模式里用,toolCalling 必须为 true。BYOK 只接管聊天,行内补全仍走 GitHub。
Copilot CLI(BYOK 环境变量)
适合终端里的 agent 工作流。四个环境变量声明一个模型,一次只生效一组;内置子 agent(explore、task、code-review)自动继承同一配置。用自己的模型提供商时 GitHub 登录可选,配置有误时 CLI 直接报错,不会悄悄改用 GitHub 托管的模型。
配置步骤
① VS Code(1.122 及以上):命令面板运行 Chat: Manage Language Models,Add Models 选 Custom Endpoint,VS Code 会打开 chatLanguageModels.json。② 接 Claude 的一组:vendor 填 customendpoint,apiKey 填 QCode 控制台创建的 cr_ 密钥,apiType 填 messages,url 填完整地址 https://api.qcode.cc/api/v1/messages,toolCalling 设为 true,models 里加 claude-sonnet-5 等 ID;name 可自定,文档示例用 QCode Claude。③ 接 GPT 与国产模型另起一组:apiType 填 chat-completions,url 填 https://api.qcode.cc/openai/v1/chat/completions;GPT 也可以用 responses,url 填 https://api.qcode.cc/openai/v1/responses(这个端点只服务 GPT 系)。④ Copilot CLI 接 Claude:设 COPILOT_PROVIDER_TYPE=anthropic、COPILOT_PROVIDER_BASE_URL=https://api.qcode.cc/api、COPILOT_PROVIDER_API_KEY 填 cr_ 密钥、COPILOT_MODEL 填模型 ID,然后运行 copilot。⑤ CLI 接 GPT 与国产模型:类型改为 openai,BASE_URL 改为 https://api.qcode.cc/openai/v1(只到 /v1,不带 /chat/completions);两组二选一,后写的覆盖先写的。⑥ 验证:选中自定义模型发一句话,返回 401 查密钥,返回 404 查地址形态。
在 QCode 上
在 QCode 上,一把控制台创建的 cr_ 密钥不分协议,协议由请求路径决定:claude-sonnet-5、claude-sonnet-5-5、claude-opus-5-5 走 Anthropic 端点 https://api.qcode.cc/api;gpt-6.1-sol 与 glm-5.3、deepseek-v4.1-flash 走 OpenAI 兼容端点 https://api.qcode.cc/openai/v1。Claude 填进 OpenAI 兼容端点会被拒(model_not_available_on_endpoint),所以只支持 OpenAI 兼容协议的 Copilot 入口接不了 Claude,请用 VS Code 的 messages、CLI 的 anthropic 类型,或者直接用 Claude Code。Copilot 2026-10-02 弃用的 Claude Opus 4.7 与 2026-10-19 要弃用的 GPT-5.5,对应的 claude-opus-4-7、gpt-5.5 目前在 QCode 仍可调,以 /models 为准。按 token 计费,各模型单价见 /models,与 Copilot 订阅费用是两回事;每次请求都能在 probe.qcode.cc 按密钥查到。
常见问题
GitHub Copilot 能用自己的 Claude API key 吗?
能,但要选对入口。截至 2026-10-07,VS Code Chat 的 Custom Endpoint 支持 Anthropic Messages API,Copilot CLI 有 anthropic 这个 provider 类型,这两处都能填自定义地址接 Claude。JetBrains 的自定义端点官方只写了 OpenAI 兼容,Anthropic 类型在那里是否可用官方页未确认;在 QCode 上 Claude 模型只能走 Anthropic 协议端点,所以按目前能确认的写法,那里只能接 GPT 与国产模型。
用 BYOK 还需要买 Copilot 套餐吗?
不一定:VS Code 与 GitHub Copilot app 官方写明不需要,JetBrains、Xcode 与企业 BYOK 写的是需要 Copilot 许可。VS Code 官方写明 BYOK 模型不登录 GitHub、没有 Copilot 套餐也能用;Copilot CLI 用自己的模型提供商时 GitHub 登录是可选的;GitHub Copilot app 要登录 GitHub,但用自己的模型提供商时不需要 Copilot 套餐。JetBrains 与 Xcode 的 BYOK 在 2025-09-11 的公告里写的是需要有效的 Copilot 许可。企业 BYOK 面向 Copilot Business 与 Enterprise,用户必须有 Copilot 许可并能联网。
开了 BYOK,行内补全也走我的模型吗?
不走。VS Code 官方写明语义搜索、行内补全(代码补全)和依赖 embeddings 的功能仍需要 GitHub 账号,BYOK 只作用于聊天体验与辅助任务;1.122 的发布说明也写明行内补全与 next edit suggestions 仍要 GitHub 登录。
VS Code 里的 url 该写根地址还是完整路径?
写完整路径。VS Code 官方建议填含 API 路径的完整地址,否则它会自己补 /v1 再拼路径;QCode 文档给的值是 https://api.qcode.cc/api/v1/messages、https://api.qcode.cc/openai/v1/chat/completions 与 https://api.qcode.cc/openai/v1/responses。Copilot CLI 正好相反:COPILOT_PROVIDER_BASE_URL 只写 https://api.qcode.cc/api 或 https://api.qcode.cc/openai/v1。返回 404 多半就是这两处写反了。
公司账号里看不到自定义模型怎么办?
先找管理员查策略。VS Code 官方写明 Copilot Business 或 Enterprise 用户的管理员可以在 GitHub.com 的 Copilot 策略里关掉 Bring Your Own Language Model Key in VS Code;GitHub 文档也写明本地 BYOK 在 IDE 里可被企业或组织策略禁用。另外,模型要在 agent 里出现,必须支持工具调用(配置里 toolCalling 为 true)。
能用 QCode 的 key 这样配吗?
能。在控制台创建一把 cr_ 密钥:VS Code 用 messages、url 填 https://api.qcode.cc/api/v1/messages,接 claude-sonnet-5、claude-sonnet-5-5 或 claude-opus-5-5;用 chat-completions、url 填 https://api.qcode.cc/openai/v1/chat/completions,接 gpt-6.1-sol、glm-5.3 等。Copilot CLI 用 anthropic 类型配 https://api.qcode.cc/api。按 token 计费,各模型单价与当前型号见 /models。
信息来源
Copilot CLI 的 BYOK:GitHub 文档 Adding LLM models to GitHub Copilot CLI,以及 GitHub changelog 2026-04-07(Copilot CLI now supports BYOK and local models)与 2026-06-17(CLI 支持企业 BYOK 模型)。VS Code:VS Code 文档 AI language models in VS Code(BYOK 与 Custom Endpoint 配置参考)与 VS Code 1.122 发布说明。两种 BYOK 与支持的客户端:GitHub 文档 Bring your own key for GitHub Copilot、Enabling custom models for GitHub Copilot in your enterprise、Adding LLM models to the GitHub Copilot app,以及 changelog 2026-06-23(Copilot app)、2026-07-14 与 2025-09-11(JetBrains)。模型弃用:GitHub changelog 2026-08-31、2026-09-18 与 2026-10-02。QCode 侧写法:QCode 文档 GitHub Copilot 接入页(更新于 2026-09-18)与接入点与 API 格式页。以上均于 2026-10-07 抓取。
相关阅读
GitHub Copilot 2026-10-19 下线六个模型
换成哪个、改哪一行、怎么验证。
Copilot 2026-09-01 弃用 Claude / Gemini
从 Copilot 拿掉一批 Claude / Gemini,不是 Anthropic API 当天退休。
Cline 接 OpenAI 兼容 API 指南
Cline 的 OpenAI Compatible 通道怎么填、怎么切模型。
本页步骤与引语核对于 2026-10-07,以 GitHub、VS Code 官方文档与 QCode 文档为准,上游调整不另行通知。客户端界面与字段名随版本变化,以你手上的版本为准;模型可用性以 /models 为准。