VS Code 的新“Agents window”让你可以使用本地AI模型，但仍需联网和GitHub Copilot订阅（因为好事总轮不到我们）

# VS Code 中的 AI 语言模型 来源：https://code.visualstudio.com/docs/copilot/customization/language-models Visual Studio Code 提供了多种针对不同任务优化的内置语言模型。你也可以使用自己的语言模型 API 密钥，来使用其他提供商的模型。 有关语言模型的工作原理及其关键特性的背景信息，请参阅[语言模型概念](https://code.visualstudio.com/docs/copilot/concepts/language-models)。 本文介绍如何为聊天或内联建议更改语言模型，以及如何使用你自己的 API 密钥。 ## 为任务选择合适的模型 默认情况下，聊天使用基础模型来为广泛的任务提供快速、有能力响应，例如编码、摘要、基于知识的问题、推理等。 但是，你不局限于只使用这个模型。你可以从[一系列语言模型](https://docs.github.com/en/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat#ai-models-for-copilot-chat-1)中进行选择，每个模型都有其特定的优势。一般原则是：快速编辑和简单问题使用快速模型；复杂重构、架构决策或多步骤任务使用推理模型。有关详细比较，请参阅 GitHub Copilot 文档中的[为你的任务选择合适的 AI 模型](https://docs.github.com/en/copilot/using-github-copilot/ai-models/choosing-the-right-ai-model-for-your-task)。 根据你使用的[代理](https://code.visualstudio.com/docs/copilot/customization/custom-agents)，可用模型列表可能会有不同。例如，在代理模式下，模型列表仅限于那些对工具调用支持良好的模型。 注意 如果你是 Copilot Business 或 Enterprise 用户，你的管理员需要在 GitHub.com 上的 [Copilot 策略设置](https://docs.github.com/en/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-policies-for-copilot-in-your-organization#enabling-copilot-features-in-your-organization)中选择加入 `Editor Preview Features`，以在组织中启用某些模型。 ## 更改聊天对话的模型 使用聊天输入字段中的语言模型选择器来更改用于聊天对话和代码编辑的模型。 显示聊天视图中模型选择器的屏幕截图。 提示 安装 AI Toolkit 扩展以添加更多语言模型来增强 GitHub Copilot 功能。 有关更多信息，请参阅[更改聊天模型](https://docs.github.com/en/copilot/how-tos/use-ai-models/change-the-chat-model#adding-more-models)。 你可以通过[使用自己的语言模型 API 密钥](https://code.visualstudio.com/docs/copilot/customization/language-models#_bring-your-own-language-model-key)进一步扩展可用模型列表。 如果你拥有付费的 Copilot 计划，模型选择器会显示高级模型的溢价请求倍数。在 GitHub Copilot 文档中了解更多关于[高级请求](https://docs.github.com/en/copilot/managing-copilot/monitoring-usage-and-entitlements/about-premium-requests#premium-requests)的信息。 ## 配置思考努力 某些模型支持可配置的思考努力。思考努力控制模型对每个请求应用多少推理。对于复杂任务（如架构决策或多步骤调试），使用更高的努力级别；对于简单的代码生成或简单问题，使用较低的级别。关于思考和推理如何工作的背景信息，请参阅[思考与推理](https://code.visualstudio.com/docs/copilot/concepts/language-models#_thinking-and-reasoning)。 VS Code 根据评估和在线性能数据设置推荐的默认努力级别，并启用自适应推理。自适应推理让模型根据每个请求的复杂性动态决定何时以及进行多少思考。在大多数使用场景下，默认设置效果良好，你无需更改。 你可以直接从模型选择器中配置思考努力： 1. 在聊天输入字段中打开模型选择器，选择一个推理模型。 2. 选择模型名称旁边出现的 **>** 箭头，打开**思考努力**子菜单。注意：非推理模型（如 GPT-4.1 和 GPT-4o）不显示思考努力子菜单。 3. 选择一个努力级别。屏幕截图显示模型选择器中的思考努力子菜单，包含不同努力级别，如无、低、中、高。 模型选择器标签会更新以显示所选努力级别，例如 "Claude Sonnet 4.6 · High"。该努力级别在同模型的对话中持续存在。 注意 `github.copilot.chat.anthropic.thinking.effort` 和 `github.copilot.chat.responsesApiReasoningEffort` 设置已弃用。你应该直接通过语言模型选择器配置思考努力。 ## 自动模型选择 注意 自动模型选择自 VS Code 1.104 版本起可用。 通过自动模型选择，VS Code 会自动选择模型，以确保你获得最佳性能，并减少因过度使用特定语言模型而导致的速率限制。它会检测模型性能下降，并在当前时间点使用最佳模型。我们持续改进此功能，以选择最适合你需求的模型。 要使用自动模型选择，请在聊天的模型选择器中选择**自动**。 目前，自动在 Claude Sonnet 4、GPT-5、GPT-5 mini 和其他模型之间进行选择。如果你的组织已[选择退出某些模型](https://docs.github.com/en/copilot/how-tos/use-ai-models/configure-access-to-ai-models)，自动将不会选择这些模型。如果这些模型都不可用，或者你用完了高级请求，自动将回退到 0 倍倍数的模型。 重要 **自 2026 年 4 月 20 日起**，Copilot Pro、Copilot Pro+ 和学生计划的新注册将暂时暂停。此外，我们正在收紧每周使用限制。如果你达到每周限制但仍有高级请求剩余，你可以继续使用自动模型选择使用 Copilot。请参阅 [GitHub Copilot 使用限制](https://docs.github.com/copilot/concepts/usage-limits)。 ### 倍数折扣 使用自动模型选择时，VS Code 会根据所选模型使用可变[模型倍数](https://docs.github.com/en/copilot/concepts/billing/copilot-requests#model-multipliers)。如果你是付费用户，自动将应用请求折扣。 你可以随时通过悬停在聊天响应上查看使用的模型和模型倍数。 显示聊天响应悬停时显示所选模型的屏幕截图。 ## 管理语言模型 你可以使用语言模型编辑器查看所有可用模型，选择在模型选择器中显示哪些模型，以及通过添加来自内置提供商或扩展提供的模型提供商的模型来添加更多模型。 要打开语言模型编辑器，请在聊天视图中打开模型选择器并选择**管理模型**，或从命令面板运行**聊天：管理语言模型**命令。语言模型编辑器默认在编辑器区域顶部的[模态叠加层](https://code.visualstudio.com/docs/getstarted/userinterface#_modal-editors)中打开。 显示语言模型编辑器的屏幕截图。 编辑器列出所有对你可用的模型，显示关键信息，如模型能力、上下文大小、计费细节和可见性状态。默认情况下，模型按提供商分组，但你也可以按可见性分组。 你可以使用以下选项搜索和过滤模型： - 使用搜索框进行文本搜索 - 提供商：`@provider:"OpenAI"` - 能力：`@capability:tools`、`@capability:vision`、`@capability:agent` - 可见性：`@visible:true/false` ### 自定义模型选择器 你可以通过更改语言模型编辑器中模型的可见性状态来自定义模型选择器中显示哪些模型。你可以显示或隐藏任何提供商的模型。 将鼠标悬停在列表中的模型上，然后选择眼睛图标以在模型选择器中显示或隐藏该模型。 显示语言模型编辑器中带有眼睛图标以显示或隐藏模型中模型选择器的屏幕截图。 ## 自带语言模型密钥 注意 如果你是 Copilot Business 或 Enterprise 用户，你的管理员可以在 GitHub.com 上的 [Copilot 策略设置](https://github.com/settings/copilot/features)中禁用**自带语言模型密钥**策略。 VS Code 中的 GitHub Copilot 附带多种针对不同任务优化的内置语言模型。如果你想使用不可作为内置模型的模型，你可以自带语言模型 API 密钥（BYOK）来使用其他提供商的模型。 在 VS Code 中使用你自己的语言模型 API 密钥有几个好处： - **模型选择**：访问来自不同提供商的数百个模型，超越内置模型的限制。 - **实验**：尝试内置模型中尚未提供的新模型或新功能。 - **本地计算**：使用你自己的计算资源来运行 GitHub Copilot 中已支持的模型之一，或运行尚不可用的模型。 - **更好控制**：使用你自己的密钥可以绕过对内置模型施加的标准速率限制和限制。 VS Code 提供不同的选项来添加更多模型： - 使用其中一个[内置模型提供商](https://code.visualstudio.com/docs/copilot/customization/language-models#_add-a-model-from-a-built-in-provider) - 从 Visual Studio Marketplace 安装[语言模型提供商扩展](https://marketplace.visualstudio.com/search?term=tag%3Alanguage-models&target=VSCode&category=All%20categories&sortBy=Relevance)，例如 [AI Toolkit for VS Code with Foundry Local](https://aka.ms/AIToolkit) ### 使用自带模型密钥时的注意事项 - 仅适用于聊天体验，不影响内联建议或 VS Code 中的其他 AI 功能。 - 能力取决于模型，可能与内置模型不同，例如对工具调用、视觉或思考的支持。 - Copilot 服务 API 仍用于某些任务，例如发送嵌入、仓库索引、查询细化、意图检测和辅助查询。 - 使用 BYOK 时，不保证对模型输出应用负责任 AI 过滤。 ### 从内置提供商添加模型 VS Code 支持多个内置模型提供商，你可以使用它们向聊天中的模型选择器添加更多模型。 要配置来自内置提供商的模型： 1. 从聊天视图中选择语言模型选择器中的**管理模型**，或从命令面板运行**聊天：管理语言模型**命令。 2. 在语言模型编辑器中，选择**添加模型**，然后从列表中选择一个模型提供商。屏幕截图显示模型提供商快速选择。 3. 输入提供商特定的详细信息，例如 API 密钥或端点 URL。 4. 根据提供商，输入模型详细信息或从列表中选择一个模型。以下屏幕截图显示了本地运行的 Ollama 的模型选择器，部署了 Phi-4 模型。屏幕截图显示本地运行的 Ollama 的模型选择器，允许从可用模型列表中选择模型。 5. 你现在可以在聊天中从模型选择器中选择该模型。要使模型在使用[代理](https://code.visualstudio.com/docs/copilot/agents/overview)时可用，它必须支持工具调用。如果模型不支持工具调用，它将不会在模型选择器中显示。 注意 配置自定义 OpenAI 兼容模型目前仅在 VS Code 1.104 版本的 [VS Code Insiders](https://code.visualstudio.com/insiders/) 中可用。你也可以手动在 `github.copilot.chat.customOAIModels` 设置中添加你的 OpenAI 兼容模型配置。 ## 更新模型提供商详细信息 要更新先前配置的模型提供商的详细信息： 1. 从聊天视图中选择语言模型选择器中的**管理模型**，或从命令面板运行**聊天：管理语言模型**命令。 2. 在语言模型编辑器中，选择要更新的模型提供商旁边的齿轮图标。屏幕截图显示模型提供商快速选择，提供商名称旁边有齿轮图标。 3. 更新提供商详细信息，例如 API 密钥或端点 URL。 ## 更改内联聊天的模型 你可以为编辑器内联聊天配置默认语言模型。这样你可以在内联聊天中使用与聊天对话不同的模型。 要配置内联聊天的默认模型，请使用 `inlineChat.defaultModel` 设置。该设置列出了模型选择器中所有可用的模型。 如果你在内联聊天会话期间更改模型，该选择将在会话的剩余时间内持续。重新加载 VS Code 后，模型将重置为 `inlineChat.defaultModel` 设置中指定的值。 ## 更改内联建议的模型 要更改用于在编辑器中生成内联建议的语言模型： 1. 从 VS Code 标题栏的**聊天**菜单中选择**配置内联建议...**。 2. 选择**更改补全模型...**，然后从列表中选择一个模型。 注意 内联建议可用的模型可能会随着我们为更多模型添加支持而随时间发展。 ## 常见问题 ### 如何为 Copilot Business 或 Copilot Enterprise 启用自带模型密钥？ 如果你是 Copilot Business 或 Enterprise 用户，你的组织管理员必须在 GitHub.com 上的 [Copilot 策略设置](https://github.com/settings/copilot/features)中启用**在 VS Code 中自带语言模型密钥**策略。策略启用后，你就可以像个人计划用户一样使用自己的 API 密钥添加模型。 ### 我可以在 VS Code 的 Copilot 中使用本地托管的模型吗？ 你可以通过[自带模型密钥](https://code.visualstudio.com/docs/copilot/customization/language-models#_bring-your-own-language-model-key)（BYOK）并使用支持连接本地模型的模型提供商来在聊天中使用本地托管的模型。你有不同的选项来连接到本地模型： - 使用支持本地模型的内置模型提供商 - 从 [Visual Studio Marketplace](https://marketplace.visualstudio.com/search?term=tag%3Alanguage-models&target=VSCode&category=All%20categories&sortBy=Relevance) 安装扩展，例如 [AI Toolkit for VS Code with Foundry Local](https://aka.ms/AIToolkit) 目前，你无法连接到本地模型以用于内联建议。VS Code 提供了扩展 API `InlineCompletionItemProvider`，允许扩展提供自定义补全提供商。你可以从我们的[内联补全示例](https://github.com/microsoft/vscode-extension-samples/blob/main/inline-completions)入手。 注意 目前，使用本地托管的模型仍然需要 Copilot 服务来执行某些任务。因此，你的 GitHub 账号需要有权访问 Copilot 计划（例如 Copilot Free），并且需要保持在线。此要求可能在未来的版本中改变。 ### 我可以在没有互联网连接的情况下使用本地模型吗？ 目前，使用本地模型需要访问 Copilot 服务，因此需要保持在线。此要求可能在未来的版本中改变。 ### 我可以在没有 Copilot 计划的情况下使用本地模型吗？ 不可以，目前你需要有权访问 Copilot 计划（例如 Copilot Free）才能使用本地模型。此要求可能在未来的版本中改变。 - [GitHub Copilot 中的可用语言模型](https://docs.github.com/en/copilot/using-github-copilot)