VS Code 中的 AI 语言模型
Visual Studio Code 提供了针对不同任务优化的各种内置语言模型。您也可以使用自己的语言模型 API 密钥来使用其他提供商的模型。本文介绍了如何更改用于聊天或代码补全的语言模型,以及如何使用您自己的 API 密钥。
为您的任务选择合适的模型
默认情况下,聊天功能使用一个基础模型,为编码、总结、知识问答、推理等广泛任务提供快速、强大的响应。
然而,您不限于仅使用此模型。您可以从一系列语言模型中进行选择,每个模型都有其独特的优势。有关 AI 模型的详细比较,请参阅 GitHub Copilot 文档中的为您的任务选择合适的 AI 模型。
根据您使用的聊天模式,可用模型的列表可能会有所不同。例如,在代理模式下,模型列表仅限于那些对工具调用有良好支持的模型。
如果您是 Copilot Business 或 Enterprise 用户,您的管理员需要在 GitHub.com 的Copilot 策略设置中选择加入 Editor Preview Features
,以便为您的组织启用某些模型。
更改聊天对话的模型
使用聊天输入字段中的语言模型选择器来更改用于聊天对话和代码编辑的模型。
您可以通过使用自己的语言模型 API 密钥来进一步扩展可用模型的列表。
如果您拥有付费的 Copilot 计划,模型选择器会显示高级模型的高级请求乘数。在 GitHub Copilot 文档中了解更多关于高级请求的信息。
自动模型选择(预览版)
自动模型选择功能自 VS Code 1.104 版本起可用,目前处于预览阶段。我们将在未来几周内向 VS Code 中的所有 GitHub Copilot 用户推出自动选择功能,首先从个人版 GitHub Copilot 计划开始。
通过自动模型选择,VS Code 会根据可用容量自动为您的任务选择最佳模型。它会检测到模型性能下降,并使用当时性能最佳的模型。这可以确保您获得最佳性能,并有助于避免因过度使用特定语言模型而导致的速率限制。我们将持续改进此功能,以便为您的需求选择最合适的模型。
要使用自动模型选择,请在聊天的模型选择器中选择 Auto。
目前,VS Code 会在 Claude Sonnet 4、GPT-5 mini 和 Gemini Pro 2.5 之间进行选择,除非您的组织已禁用对这些模型的访问。如果这些模型都不可用,自动模型选择将回退到 GPT-4.1(乘数为 0x)。如果您使用的是付费计划且高级请求已用尽,则会回退到 GPT-5 mini(乘数为 0x)。
使用自动模型选择时,VS Code 会根据所选模型使用一个可变的模型乘数。
您可以随时将鼠标悬停在聊天响应上,查看正在使用的模型和模型乘数。
自定义模型选择器
您可以自定义希望在模型选择器中显示哪些模型。
-
打开模型选择器,然后选择 Manage Models。
或者,从命令面板运行 Chat: Manage Language Models 命令。
-
在提供商列表中,选择 Copilot。
-
选择您想在模型选择器中显示的模型。
更改代码补全的模型
要更改用于在编辑器中生成代码补全的语言模型:
-
从 VS Code 标题栏的“聊天”菜单中选择 Configure Code Completions...。
-
选择 Change Completions Model...,然后从列表中选择一个模型。
使用您自己的语言模型密钥
此功能目前不适用于 Copilot Business 或 Copilot Enterprise 用户。
如果您已经拥有语言模型提供商的 API 密钥,除了 Copilot 提供的内置模型外,您还可以在 VS Code 的聊天中使用他们的模型。您可以使用以下提供商的模型:Anthropic、Azure、Google Gemini、Groq、Ollama、OpenAI、OpenRouter 和 xAI。
在 VS Code 中使用您自己的语言模型 API 密钥有几个优势:
- 模型选择:除了内置模型外,还可以访问来自不同提供商的数百种模型。
- 实验:尝试内置模型中尚未提供的新模型或功能。
- 本地计算:使用您自己的计算资源来运行 GitHub Copilot 已支持的模型,或运行尚未提供的模型。
- 更强的控制力:通过使用您自己的密钥,您可以绕过对内置模型的标准速率限制和约束。
要管理可用于聊天的模型:
-
从聊天视图中的语言模型选择器中选择 Manage Models。
或者,从命令面板运行 Chat: Manage Language Models 命令。
-
从列表中选择一个模型提供商。
-
输入提供商特定的详细信息,例如 API 密钥或端点 URL。
-
输入模型详细信息或从列表中选择一个模型(如果该提供商提供)。
以下截图显示了本地运行的 Ollama 的模型选择器,其中部署了 Phi-4 模型。
-
现在,您可以从聊天视图的模型选择器中选择该模型,并将其用于聊天对话。
更新提供商详细信息
要更新提供商详细信息,例如 API 密钥或端点 URL:
-
从聊天视图中的语言模型选择器中选择 Manage Models。
或者,从命令面板运行 Chat: Manage Language Models 命令。
-
将鼠标悬停在列表中的模型提供商上,然后选择齿轮图标以编辑提供商详细信息。
-
更新提供商详细信息,例如 API 密钥或端点 URL。
使用与 OpenAI 兼容的模型
Custom OpenAI 提供商使您能够使用任何与 OpenAI 兼容的 API 端点,并配置模型以用于聊天。
要配置自定义 OpenAI 端点和模型:
-
从命令面板运行 Chat: Manage Language Models 命令。
-
选择 OpenAI Compatible 提供商旁边的齿轮图标。
-
如果需要,选择 Manage API Key 为您的自定义端点设置 API 密钥。
-
选择 Configure Models > Add New Model,并按照提示添加您的模型详细信息:
- 模型的唯一标识符
- 模型在语言模型选择器中的显示名称
- 完整的 API 端点 URL
- 选择模型功能,例如工具调用、视觉、思考,以及端点是否需要 API 密钥。
- 最大输入和输出令牌限制。
或者,您可以在 github.copilot.chat.customOAIModels 设置中手动添加您的自定义模型配置。
注意事项
在 VS Code 中使用您自己的语言模型 API 密钥时,有许多需要考虑的事项:
- 自带模型仅适用于聊天体验,不影响代码补全或 VS Code 中的其他 AI 功能,例如提交信息生成。
- 每个模型的功能可能与内置模型不同,并可能影响聊天体验。例如,某些模型可能不支持视觉或工具调用。
- Copilot API 仍用于某些任务,例如发送嵌入、存储库索引、查询优化、意图检测和辅助查询。
- 当使用您自己的模型时,不保证对模型的输出应用负责任的 AI 过滤。
常见问题
为什么 Copilot Business 或 Copilot Enterprise 不支持自带模型密钥?
Copilot Business 或 Copilot Enterprise 不支持自带模型密钥,因为该功能主要旨在让用户在最新模型发布且尚未作为 Copilot 内置模型提供时,能够立即进行实验。
随着我们更好地了解组织大规模使用此功能的需求,自带模型密钥功能将于今年晚些时候向 Copilot Business 和 Enterprise 计划推出。Copilot Business 和 Enterprise 用户仍然可以使用内置的、受管理模型。