GitHub Copilot 12月14日下线6款模型:迁移、管理设置与BYOK

GitHub Copilot 将于2026年12月14日下线6款托管模型,包括 Claude Fable 5、Claude Haiku 4.5、Gemini 3.8 Flash、Gemini 4 Argon、Grok 4.6 和 Kimi K3。本文整理 GitHub 官方推荐的替代模型、Haiku 4.5 个人年付订阅例外、Copilot Business 与 Enterprise 的管理员启用策略,以及硬编码模型 ID 的迁移方法。如果仍需使用 Kimi K3 等旧模型,还可以了解独立 API、Cline、OpenCode 和 VS Code BYOK 的接入与验证步骤,并区分外部模型访问和 Copilot 托管模型权限。

本文内容
GitHub Copilot 12月14日下线6款模型:迁移、管理设置与BYOK

GitHub Copilot 将于2026年12月14日下线6款托管模型,手动选择这些模型的开发者,以及在集成配置中固定了旧模型标识符的团队都会受到影响。请在截止日期前切换到 GitHub 推荐的替代模型,并检查管理员策略,因为部分替代模型需要明确授权。如果之后仍需使用 Kimi K3、Gemini 4 Argon 或 Claude Fable 5,可以尝试独立服务商提供的兼容接口,但这不会让旧模型重新出现在 GitHub 的托管模型目录中。

对于个人开发者,首先应确认自己的订阅能否选择替代模型。对于团队管理员,需要先检查模型策略,再安排成员验证实际编程任务。如果模型名称被写入脚本或自动化配置,还必须更新这些引用,不能只修改聊天界面中的选择。

GitHub 在11月13日的模型下线公告中确认了日期和替代方案。截至2026年11月16日,需要明确区分两件事:模型从 Copilot 托管目录中移除,以及模型在所有独立接口服务商处停止提供。前者是此次公告确定的变化,不能据此推断后者也会发生。

12月14日有哪些 GitHub Copilot 模型下线?

GitHub 计划在 Copilot Chat、行内编辑、ask 和 agent 模式、代码补全等全部 Copilot 体验中下线以下6款模型。

即将下线的 Copilot 模型下线日期GitHub 推荐的替代模型
Claude Fable 52026年12月14日Claude Fable 5.2
Claude Haiku 4.52026年12月14日*Claude Haiku 5.5
Gemini 3.8 Flash2026年12月14日Gemini 4 Hydrogen
Gemini 4 Argon2026年12月14日Gemini 4 Carbon
Grok 4.62026年12月14日Grok 4.7
Kimi K32026年12月14日To be announced

GitHub 明确规定,使用个人年度订阅的 Copilot 用户可以继续使用 Claude Haiku 4.5,不受此次下线影响。

Haiku 4.5 的例外仅适用于个人年度订阅。GitHub 在这份公告中没有将例外扩大到个人月付订阅,也没有涵盖 Copilot Business 和 Enterprise 席位。

因此,如果你依靠这项例外继续使用旧模型,应先确认实际订阅类型,而不是仅凭模型仍出现在选择器中就认定可以长期使用。团队成员也不能因为个人账户有年度订阅,就推断企业席位享有相同待遇。

对于 Kimi K3,To be announced 表示 GitHub 在11月13日的公告中尚未公布替代模型。不要将 Kimi K3.1 Pro 或其他 Kimi 模型视为 GitHub 官方指定的后继型号。它们可以作为独立接口的候选,但不等于已经进入 Copilot 官方替代名单。

此次下线针对 GitHub 在 Copilot 中托管的模型访问入口。公告没有宣布其他独立服务商也将关闭这些模型,因此需要分别核实每个服务商的实际供应情况。

GitHub 表示,用户无需手动从托管目录中删除已下线模型。不过,保存的模型选择、集成使用的模型标识符,以及团队配置仍应在截止日期前完成迁移。

个人开发者如何在 Copilot 中切换模型?

如果你正在 Copilot Chat 中使用即将下线的模型,先打开模型选择器,切换到 GitHub 推荐的替代模型,再用实际编程任务测试。

在 Visual Studio Code 中:

  1. 打开 Copilot Chat。
  2. 在 Chat 视图底部打开模型选择器。
  3. 如果当前订阅和组织策略允许,选择推荐的替代模型。
  4. 开启一个新对话,重复日常任务,例如读取仓库文件或分析失败的测试。
  5. 确认模型能够响应,所需工具也能正常执行。

GitHub 的Copilot Chat 模型切换文档说明了具体操作。

建议选择能代表日常工作的一项任务,而不是只发送简单问候。例如,让模型解释当前项目中的测试失败原因,或者读取一个包含多个函数的文件并说明调用关系。这样能同时检查基本响应、代码理解和必要的工具权限。

切换聊天模型不会自动改变行内代码建议使用的模型。 如果你依赖自动补全,也需要单独检查该功能。聊天任务成功,不意味着所有编辑器功能已经完成迁移。

根据任务和订阅权限选择替代模型

GitHub 推荐的型号适合作为迁移起点,但新旧模型的能力、上下文窗口、工具调用行为和成本不一定相同。选择时应优先考虑你原本使用模型完成什么任务,以及当前订阅是否拥有替代模型的权限。

原来使用 Gemini 3.8 Flash:优先尝试 Gemini 4 Hydrogen。 它适合作为快速编程辅助和多步骤工具调用的替代候选。

GitHub 在11月13日宣布 Gemini 4 Hydrogen 正式推出。GitHub 将其定位为面向快速代理式编程、工具使用和多步骤工作流的模型,并表示其指令遵循能力相比 Gemini 3.8 Flash 有所提升。

Hydrogen 面向 Copilot Pro、Pro+、Max、Business 和 Enterprise 用户开放,但采用逐步发布方式。公告列出的使用入口包括 VS Code、Visual Studio、Copilot CLI、GitHub coding agent、Copilot 应用、github.com、移动端、JetBrains、Xcode、Eclipse 和 Copilot SDK。

如果模型选择器中没有 Hydrogen,先检查订阅等级、发布进度和组织策略。逐步发布期间暂时看不到模型,不代表它永久无法使用。此时应先确认账户和使用入口是否符合条件,再决定是否采用其他已开放的模型作为临时方案。

如果你还需要修改 Copilot 之外的直接接口调用,可以参考Gemini 4 Hydrogen 接口迁移与定价指南。

原来使用 Gemini 4 Argon:优先尝试 Gemini 4 Carbon。 GitHub 推荐它用于复杂编程、推理和涉及代码安全的开发任务。

GitHub 在11月10日的 Carbon 公告中明确提到了这些场景。Carbon 已面向 Copilot Pro+、Max、Business 和 Enterprise 正式推出,同样采用逐步发布方式。

只有 Copilot Pro 订阅的用户,不应因为 Carbon 是官方推荐替代型号,就认定自己一定能使用。GitHub 公布的适用套餐不包括单独的 Pro。请在制定迁移方案前确认权限。

如果原来的任务涉及复杂代码分析或安全相关修改,建议用相同输入对比新模型的分析过程和修改结果。尤其需要检查它能否按照项目约束完成任务,不能只根据官方推荐关系假设行为完全一致。

如果你的应用直接调用 Google 的模型接口,可以查看Gemini 4 Carbon 接口迁移指南,核对请求参数和计费规则。

原来使用 Claude Fable 5:优先尝试 Claude Fable 5.2。 它适合大型代码库中的复杂、多步骤编程任务。

GitHub 在11月9日的发布公告中表示,早期测试里 Fable 5.2 比 Fable 5.1 解决了更多任务,同时使用更少的步骤和工具调用。这是 GitHub 报告的测试结果,不代表你的仓库也一定获得同样的效果。

Fable 5.2 面向 Pro+、Max、Business 和 Enterprise 正式提供。但 Business 和 Enterprise 管理员必须单独启用它,因为该模型的策略默认关闭。

对于涉及多个文件的修改任务,除了比较最终代码,还应检查工具调用能否完成、测试是否通过,以及管理员是否允许向该模型发送相关代码和数据。

如果需要参考独立的编程任务评估,可以查看Coding Agent Index 对 Fable 5.2 与 Opus 5.5 的分析。

原来使用 Claude Haiku 4.5 或 Grok 4.6: 先分别测试 GitHub 推荐的 Claude Haiku 5.5 和 Grok 4.7。确认模型出现在选择器中,并能完成代表性任务后,再修改团队默认设置。不要仅凭名称中的版本号变化,就假定上下文限制和工具行为保持不变。

原来使用 Kimi K3: GitHub 尚未宣布官方替代模型。如果必须继续使用 GitHub 托管的 Copilot 模型,就需要根据自己的任务比较当前可选型号。

Kimi K3.1 Pro 可以作为独立接口的候选方案,但不是 GitHub 指定的 Kimi K3 后继模型。具体接入方式可参考Kimi K3.1 Pro 编程工具使用指南。

修改默认模型前,先核对计费

模型是否可用,与使用它需要支付多少费用,是两个不同问题。尤其是自动编程任务可能反复读取文件、提交长上下文并调用工具,单次对话的费用不能只看第一条请求。

GitHub 表示,Gemini 4 Hydrogen、Gemini 4 Carbon 和 Claude Fable 5.2 在 Copilot 中采用基于使用量的计费,并按照模型服务商的公开标价收费。

根据Copilot 模型与价格参考文档,交互会消耗输入、输出和缓存 token。不同模型及令牌类型有相应价格,费用随后转换为 GitHub AI Credits,换算关系为 1 AI credit = $0.01 USD。

不同订阅套餐包含的 AI Credits 额度不同。超过套餐内额度后,额外使用量按照文档中的令牌费率计费。

在修改团队默认模型前,应比较相同编程任务的令牌消耗、工具调用次数和最终费用。需要分别记录输入、输出与缓存用量,否则即使总请求次数相同,也可能得出不准确的成本结论。

不要直接把订阅内包含的信用额度与独立接口的令牌单价当成同一种成本来比较。套餐包含额度、超额计费和独立服务商的按量收费,应分别计算。

Copilot Business 和 Enterprise 管理员需要启用什么?

在 GitHub 默认的模型启用策略下,Copilot Business 和 Enterprise 通常会自动启用官方推荐的替代模型。

但如果管理员关闭了全局默认策略、明确禁用了某款模型,或者该模型本身不属于默认启用范围,自动启用就不适用。

Claude Fable 5.2 是一个明确的例外。 GitHub 11月9日的公告指出,它的管理员策略默认关闭,必须手动启用。

因此,管理员不能只检查全局默认设置是否开启。还应逐一查看准备迁移到的模型,并使用真实成员账户确认权限是否已经生效。对于新版本,还要先完成组织要求的合规审查。

组织管理员:检查和启用模型

如果组织拥有模型策略管理权限,可以按以下步骤操作:

  1. 在 GitHub 中打开 Organizations,选择目标组织。
  2. 打开 Settings。
  3. 在 Code, planning, and automation 下选择 Copilot。
  4. 打开 Models。
  5. 找到每个计划迁移到的替代模型,检查当前策略。
  6. 对组织允许使用的模型选择 Enabled。

这些步骤来自 GitHub 的组织模型可用性管理文档。

同一页面还提供 Default availability for released models 设置。对于适用的模型,Delegate to Default Policy 表示继承组织的默认可用性策略。

需要注意,继承默认策略的前提是该模型属于默认策略的适用范围。某些默认关闭的模型,即使全局设置允许其他已发布模型,也仍然需要单独启用。

如果 Enterprise 所有者强制指定了某项模型策略,组织管理员无法覆盖它。这时需要联系企业管理员检查限制,而不是反复修改组织设置。

Enterprise 管理员:配置全局权限

Enterprise 所有者可以集中决定整个企业的模型可用性,也可以将管理权委托给组织或 enterprise teams。

  1. 在 GitHub 中打开 Enterprise 账户。
  2. 选择 AI controls。
  3. 打开 Copilot。
  4. 选择 Configure models。
  5. 为所有用户启用已批准的替代模型,或者将权限委托给组织或 enterprise teams。
  6. 确认目标组织和团队已经获得访问权限。

GitHub 在Enterprise 模型可用性管理文档中说明了这些设置。

如果企业选择加入通过 enterprise teams 控制模型访问权限的预览功能,组织级模型设置会被停用。这种情况下,应通过企业团队管理相应权限。

管理员应先确认企业当前采用哪一种权限管理方式,再指导组织负责人操作。否则,组织管理员可能找不到模型设置页面,即使拥有正常的组织管理权限也无法修改。

为什么 Claude Fable 5.2 需要额外审批?

根据 GitHub 的Claude Fable 5.2 发布公告,使用 Fable 5.2 时,Anthropic 默认需要保留数据,以运行检测有害使用的安全分类器。

保留的数据包括提示词和模型输出。GitHub 表示,这些数据不会用于训练 Anthropic 的模型。但管理员启用 Fable 5.2 策略,就代表认可这项数据保留要求。

如果仓库包含敏感代码或数据,管理员应先核对组织的数据保护与合规要求,再决定是否启用。不能将“不用于模型训练”理解成“不保留数据”,因为两项条件涉及不同的数据处理行为。

GitHub 还公布了一项限时豁免:符合条件的企业客户可以在获得批准后,使用 Claude Fable 5、Fable 5.1 和 Fable 5.2,并采用零数据保留(zero data retention)方式。也就是说,获批客户可以暂时免于遵守默认的数据保留要求。

这项豁免仅持续到2026日历年年底。期间,Anthropic 正在推出 Enterprise Frontier Safeguards (EFS)。

豁免期限结束后,若要按照公告所述安排继续使用这些模型,就需要 EFS。GitHub 表示,EFS 将提供自动化安全监控,并为符合条件的客户提供更多数据保留选项。

要确认企业是否符合豁免条件,应联系 GitHub 的客户经理团队。GitHub Support 无法判断资格,也不能批准相应访问权限。

即使豁免已经获批,模型策略也不会自动启用。Copilot Business 或 Enterprise 管理员仍需单独启用 Claude Fable 5.2。

如果组织无法接受默认数据保留条件,也没有获得豁免批准,就应选择其他获准使用的模型。

对于需要经过安全审批的团队,建议将模型启用和数据保留审批视为两个独立检查项:先确认是否满足数据处理要求,再验证成员是否真正获得模型访问权限。

如何确认管理员策略已经生效?

管理员修改策略后,让受影响的用户重新打开 Copilot Chat。

如果客户端支持该模型,已启用的替代模型应出现在模型选择器中。让用户选择它,并完成一次正常的编程请求。

如果模型仍未出现,依次检查企业全局策略、组织权限委托、显式禁用规则、订阅资格和逐步发布状态。

仅看到管理员设置保存成功,还不足以证明迁移完成。最好同时确认模型可选,以及实际任务能够成功执行。

如果模型已经显示,但工具调用失败,应继续检查客户端能力和具体集成配置。模型出现在选择器里,只能说明当前界面允许选择它,不能单独证明所有编程功能都正常。

如何修改集成中硬编码的旧模型 ID?

在 Copilot Chat 中切换模型,并不会更新源代码、脚本、配置文件或集成里写死的旧型号。

需要同时搜索模型显示名称和接口风格的标识符。不同 GitHub 客户端和独立服务商使用的准确 ID 可能不同,因此不能把界面中的显示名称直接当成所有客户端都接受的调用参数。

在仓库根目录打开 Bash 终端,使用 ripgrep 查找可能的引用:

rg -n -i 'Claude Fable 5|Claude Haiku 4\.5|Gemini 3\.8 Flash|Gemini 4 Argon|Grok 4\.6|Kimi K3|claude-fable-5|claude-haiku-4-5|gemini-3\.8-flash|gemini-4-argon|grok-4\.6|kimi-k3' .

这是一条用于排查的搜索命令,不会自动修改配置。它可能漏掉其他别名、仓库外部的设置,以及被 .gitignore 排除的文件。

重点检查以下位置:

  • Copilot SDK 的初始化代码和会话配置。
  • 编程智能体配置与模型路由规则。
  • 调用 Copilot 的仓库自动化任务。
  • 选择模型的 CI 配置和环境变量。
  • 将模型标识符保存为固定字符串的内部工具。

找到旧 ID 后,应使用对应客户端文档中明确支持的新标识符。不要假设显示名称 Claude Fable 5.2 在所有接口中都是合法的 Model ID。

除非新模型的集成文档明确要求,否则无需同时修改请求地址或认证方式。这样可以缩小变更范围,避免把模型迁移问题与认证配置问题混在一起。

对于编程智能体集成,应验证完整操作:

  1. 使用替代模型启动新会话。
  2. 让智能体读取一个已知的仓库文件。
  3. 请求一次小规模、可回滚的代码修改或工具调用。
  4. 检查修改结果并运行相关测试。
  5. 查看使用记录,确认调用的模型,并排查意外错误。

只收到一段正常的文本回复,并不能证明文件编辑或工具调用功能已经恢复。

如果找不到替代模型,先检查访问权限和组织策略。如果集成拒绝模型 ID,应核对该客户端的受支持模型文档。

还要检查仓库外部的配置来源,例如部署环境中保存的模型选择变量。仓库搜索没有匹配结果,不代表运行环境一定没有旧模型引用。

务必在12月14日前完成排查。GitHub 自动移除旧模型,并不会替你重写代码和配置。

Kimi K3、Gemini 4 Argon 或 Fable 5 还能继续使用吗?

只要独立接口服务商仍然提供某款模型,且请求可以正常执行,就可以通过该服务商继续调用。

Copilot 下线公告只涉及 GitHub 托管的模型访问,并未宣布所有独立服务商都会同步停止提供这些模型。迁移到外部接口时,需要重新确认模型标识符、协议、认证方式和当前供应情况。

截至2026年11月16日,BetterToken 的结构化模型目录列出了以下标识符:

模型BetterToken API Model ID
Kimi K3kimi-k3
Gemini 4 Argongemini-4-argon
Claude Fable 5claude-fable-5
Claude Haiku 4.5claude-haiku-4-5-20251001

这些是 BetterToken API 使用的模型 ID,不是 GitHub Copilot 托管模型的标识符。

BetterToken 提供独立的按量付费接口访问。它既不是 GitHub Copilot 订阅,也不是模型厂商的官方订阅服务。通过外部接口发起请求,不会改变你在 GitHub 上的订阅权益或组织策略。

模型出现在目录中,不代表每次请求都能成功,也不保证它会永久提供。在生产环境继续使用旧模型前,请核对当前的模型供应情况和价格。

实际迁移时,建议先完成一次最小请求,再连接编程工具。这样可以先确认模型是否能响应,避免在客户端里同时排查模型供应、认证和配置问题。

方案一:通过 Cline 或 OpenCode 继续使用旧模型

如果需要可自行配置接口地址的编程助手,可以选择支持 OpenAI-compatible 服务商的 Cline。

按照BetterToken 的 Cline 接入文档操作:

  1. 在 VS Code 中安装 Cline,并在 BetterToken 控制台创建自己的 API Key。
  2. 打开 Cline,选择 Use your own API key。
  3. 将 API Provider 设置为 OpenAI Compatible。
  4. 将 Base URL 设置为 https://www.bettertoken.ai/v1。
  5. 在 Cline 的凭证输入框中填写自己的密钥,并在模型仍可用时将 Model 设为 kimi-k3。
  6. 保存配置。如有必要,重新加载 Cline。
  7. 使用 Verify 检查连接,然后发送一个简短的测试请求。

确认请求没有出现认证错误或模型错误,并且能够得到回复。随后让助手只读取一个已知的项目文件,进一步检查文件访问能力。

模型的上下文窗口和输出上限应采用已确认的数值。只有模型和接口都支持时,才启用工具调用、图像处理或 Computer Use。

如果模型能够回答问题,却无法读取项目文件,说明还需要检查编程工具的实际能力配置。不要仅根据文本响应成功就认定完整的编程工作流已经恢复。

OpenCode 也有文档化的接入方式。其 OpenAI-compatible 配置使用 @ai-sdk/openai-compatible、Base URL https://www.bettertoken.ai/v1,以及 bettertoken 等服务商标识符。

在 OpenCode 1 中,全局配置可以放在 ~/.config/opencode/opencode.json,项目配置则可以放在项目根目录的 opencode.json。使用 /connect 将凭证保存在本地,不要把真实 API Key 直接写进配置文件。

文档中的 Kimi K3 选择值是 bettertoken/kimi-k3。完整步骤见OpenCode 接入 Kimi K3 的配置指南。

Claude Code 使用不同的协议。BetterToken 的 Claude Code 接入文档指定 Anthropic-compatible Base URL 为 https://bettertoken.ai,末尾不带 /v1。

不要把 Cline 的 OpenAI-compatible Base URL 原样复制到 Claude Code 中。不同工具会按照自己的协议拼接请求路径,使用错误的地址可能导致请求无法到达正确的接口。

方案二:直接请求 API,确认模型能否使用

如果 Cline 或其他编程工具无法正常响应,先绕开工具,直接验证模型接口。这样更容易区分服务端问题和客户端配置问题。

BetterToken 文档提供了 OpenAI-compatible Chat Completions endpoint。下面的 Bash 示例向 kimi-k3 发送一个简短请求。

read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY

curl -sS -i 'https://www.bettertoken.ai/v1/chat/completions' \
  -H "Authorization: Bearer ${BETTERTOKEN_API_KEY}" \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "kimi-k3",
    "messages": [
      {
        "role": "user",
        "content": "Reply with OK."
      }
    ]
  }'

第一条命令等待输入时,粘贴你在 BetterToken 控制台创建的 API Key,然后按 Enter。密钥输入不会回显,也不会作为明文参数直接写入命令。

请求成功时,接口会返回 HTTP 200,模型输出位于 choices[0].message.content。

如果表格中的其他模型当前也支持 OpenAI-compatible Chat Completions,可以替换为其准确的 Model ID,使用同样的请求格式。

失败时先按结果排查:

返回结果优先检查
400请求正文的 JSON、模型参数和消息结构
401API Key 是否有效,以及 Bearer 认证头
402账户余额是否充足
404请求地址是否包含完整的 /v1/chat/completions 路径
429请求速率、并发限制或上游服务负载
Model not found是否使用当前目录中完整、准确的 Model ID

BetterToken Chat Completions API 参考文档区分了直接 HTTP 请求使用的完整地址和软件开发工具包使用的基础地址。

直接发送 HTTP 请求时,使用 https://www.bettertoken.ai/v1/chat/completions。如果 SDK 会自动拼接资源路径,则使用 Base URL https://www.bettertoken.ai/v1。

如果出现认证错误,先核实密钥是否属于当前服务商,以及请求头是否使用正确的认证格式。如果返回模型不存在,应先对照当前模型目录,而不是根据界面显示名称自行缩写标识符。

一次文本请求成功,只能证明基本连接可用。它不能证明流式输出、工具调用或完整上下文窗口都能正常工作。需要在目标编程客户端中继续测试这些能力。

GitHub Copilot 的 BYOK 支持自定义 API endpoint 吗?

支持,但取决于客户端。 GitHub 的Bring Your Own Key 文档介绍了用户自行配置模型的方式。支持的客户端可以使用用户提供的凭证,直接连接兼容的云端或本地模型服务商。

截至2026年11月17日,GitHub 的 BYOK 客户端列表包括 VS Code、JetBrains、Xcode、Copilot CLI、GitHub Copilot app 和 Copilot SDK。

这只是支持自带密钥功能的客户端范围,不代表每个客户端都能接受任意协议、任意模型或提供所有 Copilot 功能。各客户端的设置入口和实际能力需要分别核对。

用户自行添加的模型通常只对该用户可见,不会自动成为整个团队的默认模型。添加自定义模型,也不会让 GitHub 已下线的托管模型重新出现。

需要区分用户自行连接服务商和企业集中配置模型这两种方式。前者由客户端直接向服务商发送请求;后者使用企业配置,并通过 GitHub 的服务访问模型。

在 VS Code 中配置 Custom Endpoint

VS Code 的 Custom Endpoint 支持 Chat Completions、Responses 和 Anthropic Messages API。

使用 BetterToken 的 Chat Completions 时,应填写完整的请求地址,而不是假设所有服务商都使用相同的基础地址规则。

准备好兼容的 VS Code、准确的 Model ID,以及自己的 API Key 后,按照VS Code Custom Endpoint 配置文档操作:

  1. 在 Command Palette 中运行 Chat: Manage Language Models。
  2. 选择 Add Models,然后选择 Custom Endpoint。
  3. 输入分组名称,例如 BetterToken。
  4. 根据提示填写显示名称和 API Key。保留 VS Code 生成的密钥引用。
  5. 将接口类型选择为 Chat Completions。
  6. 打开自动生成的 chatLanguageModels.json,设置模型属性。
  7. 保存文件,然后在聊天模型选择器中选择新模型。

下面是 kimi-k3 的 chatLanguageModels.json 示例。apiKey 中的引用标识符仅用于展示格式。实际使用时,应保留 VS Code 为你的密钥生成的引用,不要照抄示例中的标识符。

[
  {
    "name": "BetterToken",
    "vendor": "customendpoint",
    "apiKey": "${input:chat.lm.secret.xxxxx}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "kimi-k3",
        "name": "Kimi K3",
        "url": "https://www.bettertoken.ai/v1/chat/completions",
        "toolCalling": false,
        "vision": false,
        "maxInputTokens": 8192,
        "maxOutputTokens": 2048
      }
    ]
  }
]

示例中的 8192 和 2048 是为初次短文本测试设置的较小客户端参数,不是 Kimi K3 官方公布的上下文窗口或最大输出限制。

正式使用前,应根据模型当前文档和实际工作负载调整数值。maxInputTokens 与 maxOutputTokens 之和不能超过模型实际的上下文窗口。

此示例暂时关闭了工具调用和图像输入。只有确认模型、接口和客户端都支持相关能力后,才启用 toolCalling 或 vision。智能体模式需要工具调用能力。

VS Code 的 vendor 必须是 customendpoint。其中,id 是发送给接口的模型标识符,name 则是选择器中显示的名称。

apiType 决定请求协议。这里的 url 是完整的 Chat Completions endpoint,不是 SDK Base URL。

如果提供的地址较短,VS Code 可能会自动拼接资源路径。Custom Endpoint URL 处理规则建议使用完整接口路径,以避免解析歧义。

VS Code 还支持通过 ${input:chat.lm.secret...} 形式的引用来使用 apiKey。配置流程会在本地保存输入的凭证,并在配置文件中生成引用。不要将这个引用替换成真实密钥。

这一机制的目的,是让配置文件引用已保存的密钥,而不是直接包含密钥明文。因此,即使你需要手动修改模型参数,也应保留原有的密钥引用格式。

保存后,如果新模型没有出现在列表中,可以重新加载 VS Code 窗口。随后选择 kimi-k3,发送一条简短的文本请求。

如果请求成功,再单独测试工具调用。通过后,才考虑让模型修改仓库文件。仅凭模型在选择器中可见,不能证明它已经具备完整的文件操作能力。

BYOK 无法恢复哪些 Copilot 功能?

VS Code 文档说明,BYOK 主要用于聊天和辅助任务。原生行内代码建议、语义搜索以及部分依赖 GitHub 服务的功能,仍然需要 GitHub 账户。

如果想在 Copilot harness 会话中使用受支持的 BYOK 模型,目前需要启用 VS Code 的实验性设置 chat.agentHost.byokModels.enabled。

即使启用了这个设置,也不能保证所有外部模型都支持完整的智能体功能。尤其需要确认模型和服务端是否支持工具调用,因为仅能生成文本的模型无法自动完成所有仓库操作。

此外,Copilot Business 和 Enterprise 管理员可以通过组织或企业策略限制用户自行配置 BYOK。

对于 Copilot CLI,GitHub 将自定义服务商配置放在 ~/.copilot/providers.json。其中,openai 类型支持 OpenAI-compatible 服务,anthropic 类型用于 Anthropic 风格的服务商。

这里需要特别注意密钥安全:GitHub 警告,该 JSON 文件中的凭证会以明文保存,而且环境变量字符串不会自动展开。使用前请阅读Copilot CLI 添加 LLM 模型的官方说明,不要将包含真实密钥的文件提交到仓库或分享给其他人。

使用外部模型接口不代表能够绕过原本需要 GitHub 账户的功能。应分别确认聊天模型连接是否可用,以及编辑器中的其他功能是否满足账户和组织权限要求。

Enterprise 集中管理的自定义模型

GitHub 还支持由 Enterprise 集中管理的自定义模型。截至2026年11月,该功能仍处于 public preview 阶段。

Enterprise 所有者可以在企业设置中添加模型服务商的 API Key。也可以通过 Enable custom models 策略,允许组织管理员配置自定义模型。

GitHub 列出的支持类别包括 OpenAI-compatible providers。符合条件的 Copilot Business 或 Enterprise 用户,可以在 Copilot Chat、Copilot CLI 和受支持的开发环境中使用这些模型。

与用户自己设置的 BYOK 不同,这类集中管理的模型通过 GitHub Copilot API 访问。用户需要 Copilot 许可证和互联网连接,但无需自行配置服务商密钥。

集中配置可以让企业统一控制服务商凭证和组织访问权限,但不能因此推断所有外部模型都适用于每一个开发客户端。模型的具体协议和功能仍需要逐项验证。

GitHub Enterprise 自定义模型管理文档介绍了如何添加服务商凭证,以及如何向组织开放访问权限。

由于功能仍在公开预览阶段,在把它作为整个组织的迁移方案前,应先验证具体模型、协议和目标 Copilot 客户端的兼容性。可以先让少量具备权限的成员完成真实任务,再决定是否扩大使用范围。

12月14日前应该完成哪些检查?

在模型下线前,最重要的是在开发者真正使用的客户端中验证替代模型,而不是只确认它出现在公告中。

个人用户需要确认新模型已出现在选择器里,并能完成日常编程任务。如果希望继续使用 Claude Haiku 4.5,还要确认自己持有符合例外条件的个人年度订阅。

Business 和 Enterprise 管理员应使用受影响的成员账户检查权限。对于 Claude Fable 5.2,尤其要确认管理员已手动启用模型,并完成数据保留要求的审查。

集成负责人需要替换硬编码的旧 Model ID,并测试真实的文件读取、代码修改和工具调用,而不只是发送一条文本消息。对于依赖自动化部署或持续集成的项目,还应检查这些任务使用的模型配置是否已同步更新。

如果仍需要 Kimi K3 或其他旧模型,应在截止日期前验证独立接口是否实际可用。外部接口的模型供应、用户自定义 BYOK 配置,以及 GitHub 托管的 Copilot 模型访问,是三种条件不同的使用方式。

完成迁移时,应同时满足三个可以观察到的结果:替代模型出现在正确的客户端中,实际编程任务能够完成,使用记录中没有意外的模型选择或调用错误。只有这样,才能确认迁移覆盖了开发者真正依赖的工作流程。

BetterToken · 企业采购
企业专属价
支持开发票对公转账 / 支付宝 / 微信支付全系列文本 / 编程、图像、视频模型
文本 / 编程
图像
视频
专属技术支持领取企业折扣价目表 →