Visual Studio Code 企业环境 AI 设置管理完全指南:三大管控方案与策略落地

原创2026-10-09 13:12:311,965 阅读
文章标签:文档教程

Visual Studio Code 企业环境 AI 设置管理完全指南:三大管控方案与策略落地

组织级治理是 AI 编程工具在企业环境中安全落地的关键前提。本文以 Visual Studio Code(VS Code)官方企业文档 manage-ai-settings.md 为骨架,系统讲解 GitHub Copilot 企业托管设置、VS Code 设备策略与 GitHub 组织/企业设置三条管控路径,并深入剖析其优先级规则、设备策略清单、诊断验证手段与安全注意事项,帮助你为团队设计一套可落地、可验证、可追溯的 AI 能力管控方案。

三种企业 AI 管控方案总览

在开始配置之前,首先需要明确:企业可以在 VS Code 中通过三条相互独立又彼此配合的路径治理 AI 功能:

管控方案 配置位置 控制范围
GitHub Copilot 企业托管设置(enterprise-managed settings) GitHub 支持的服务器托管、MDM 或文件下发 支持 Copilot 的各客户端(如 VS Code、Copilot CLI)
VS Code 设备策略(device policies) 操作系统或设备管理平台 受管的 VS Code 安装
GitHub 组织/企业设置 GitHub 组织或企业管理后台 登录账号与 GitHub 托管的服务

这三条路径控制的是 AI 体验的不同层级:Copilot 企业托管设置负责跨客户端的 Copilot 护栏,VS Code 设备策略负责编辑器专属功能的精细化管控,GitHub 组织/企业设置负责账号级与服务端行为。一个组织可以同时使用三者,但对于同一个重叠控制项,应只在一个系统中配置,避免冲突与混淆。

[!NOTE] 如果开发者遇到某个 Agent、模型或工具不可用,应首先查阅 AI 故障排查指南,其中提供了从基础检查(更新、账号、额度、策略)到日志分析的完整排查路径。若确认是组织管控导致,则需联系管理员确认哪些能力已被批准。

如何选择管控方案

这三种方案并不互斥,选择标准取决于你需要的管控范围。下表是官方文档给出的选型对照:

需求 管控方案 配置位置 作用范围
在支持的客户端间应用一致的 Copilot 护栏 Copilot 企业托管设置 GitHub 支持的服务器、MDM 或文件下发 受支持的 Copilot 客户端与配置键
在受管设备上控制 VS Code 专属编辑器功能 VS Code 设备策略 操作系统或设备管理平台 受管的 VS Code 安装
控制 Copilot 访问或 GitHub 托管的组织/企业行为 GitHub 组织或企业设置 GitHub 组织或企业管理后台 已登录账号与 GitHub 托管服务

部分控制项可通过多个方案实现。在组合使用前,务必先阅读下文"理解优先级"一节。此外,官方文档特别建议:在大范围推广前,应使用有代表性的项目、设备和账号测试拟定配置,确认开发者在既有限制不变的前提下仍能完成被批准的任务。

从仓库中 overview.md 的编排可以看出,AI 与 Copilot 策略(Agent 模式、MCP 服务器、工具审批)只是 VS Code 企业治理四支柱之一,其余还包括扩展管理、遥测与自动更新;AI 治理方案需要与这些相邻策略协同设计。

理解优先级(Precedence)

托管设置各下发方式之间的优先级

当同一个托管设置在多个来源同时存在时,VS Code 按下述顺序应用:

  1. MDM 托管设置(最高优先级)
  2. 服务器托管设置
  3. 基于文件的设置
  4. 用户设置(最低优先级)

对于大多数配置键,高优先级来源的值直接生效。但存在例外:permissions.deny、permissions.ask 和 permissions.allow 这类键会将多个来源的限制朝最严格方向合并,而非简单覆盖。完整且最新的规则以 GitHub 官方"部署方法优先级"文档为准。

与 VS Code 设备策略的优先级关系

部分企业托管设置与 VS Code 设备策略存在映射关系。当管理员同时配置两套系统时:

  • 若两套系统配置的是不同控制项,则两个控制项同时生效;
  • 若两套系统配置的是同一控制项,企业托管设置优先,值不会合并;
  • 若企业托管设置未提供该控制项,则 VS Code 设备策略继续生效。

官方建议:尽量让重叠控制项只通过一个方案配置,并通过 Developer: Policy Diagnostics 命令检查实际生效的值及其来源。

使用 GitHub Copilot 企业托管设置

企业托管设置用于需要跨受支持客户端(VS Code、Copilot CLI 等)统一生效的 Copilot 护栏。管理员通过 GitHub 支持的服务器托管、MDM 托管或基于文件三种方式之一定义这些设置。需要特别注意:即便使用 MDM 方案,企业托管设置仍然采用 Copilot 的配置格式与下发路径,而非 VS Code 设备策略命名空间。

服务器托管部署下,GitHub 还支持按企业团队覆盖部分设置:GitHub 会根据每个用户所属的企业团队成员身份匹配并应用对应值。

关键事实清单

  • 并非每个企业托管设置都适用于每个客户端。为 VS Code 配置某个设置前,务必核对官方企业托管设置参考中"Supported clients(支持的客户端)"一列,确认该键是否覆盖 VS Code;
  • 配置与排障遵循 GitHub 官方"企业托管设置入门指南"与"企业托管设置参考",后者列出了受支持的键、取值、组合行为与客户端覆盖范围;
  • 完整配置示例(如 copilot/managed-settings.json、团队映射与按团队覆盖文件)由 GitHub 服务端生成并下发,不在 VS Code 仓库内。

验证已生效的托管设置

运行 Developer: Policy Diagnostics(开发者:策略诊断)可检查当前生效的策略值与来源,其报告机制与 policies.md 中"验证策略执行" 一节一致,在 Windows、macOS、Linux 上行为相同。

当诊断结果显示服务器托管来源的值异常时,应检查以下文件与数据:

  • copilot/managed-settings.json(服务器托管的托管设置);
  • copilot/team-mappings.json(团队映射);
  • copilot/teams/ 下对应的映射文件;
  • 用户所属的企业团队成员关系。

原因在于:GitHub 在将服务器托管设置下发给 VS Code 之前,会先解析团队覆盖(team overrides)。若 GitHub 侧出现校验错误或下发故障,需按 GitHub 官方"验证服务器托管设置"指引排查。

最低版本要求

托管设置服务可能在 AI 功能可用前要求 VS Code 达到最低版本。当安装版本不满足要求时,VS Code 会有三类提示:

  • 聊天界面显示所需版本与已安装版本,并提供相应的更新操作;
  • 编辑器窗口在聊天关闭时仍显示横幅,其余编辑器功能保持可用;
  • Agents 窗口显示阻塞性提示,并提供 Open Editor Window(打开编辑器窗口)操作。

如果内置更新已被策略禁用,提示会引导开发者联系管理员;安装版本达到要求后 AI 功能即恢复可用。

托管遥测的应用

托管 OpenTelemetry 配置适用于 Copilot Chat 扩展与 Agent Host。配置变更后,扩展可能提供 Reload Window(重新加载窗口)选项;VS Code 解析完托管遥测变更后会自动重启 Agent Host。

需要重点审查的两个开关:

  • 身份采集(identity capture)默认关闭,且与内容采集相互独立——上线前必须分别审查两者;
  • 应移除受管设备上的冲突 OpenTelemetry 环境变量,避免与托管配置互相干扰。

telemetry 键的配置 schema 与受支持客户端以官方企业托管设置参考为准。

使用 VS Code 设备策略

设备策略通过平台管理工具(组策略 Group Policy、Microsoft Intune、macOS 配置描述文件等)下发,作用于受管设备并覆盖 VS Code 中对应的用户设置。部署方式与完整策略清单参见 企业策略参考,该文档详细给出了 Windows ADMX/ADML、macOS .mobileconfig 与 Linux /etc/vscode/policy.json 三类部署路径,以及每个策略的接受值与最低版本要求。

以下按功能域分组梳理 AI 相关设备策略。

控制访问与功能可用性

将 AI 功能限制在受批准的 GitHub 组织

ChatApprovedAccountOrganizations 策略要求开发者必须使用属于已批准组织的 GitHub 账号登录后,AI 功能才会激活。配置值为 GitHub 组织登录名的 JSON 数组,例如 ["contoso", "contoso-research"];使用 ["*"] 可放行任意已登录 GitHub 账号(也适用于组织列表无法透出的 GHE 部署)。

该策略默认关闭(fail-closed):在账号策略数据解析完成、且登录账号属于已批准组织之前,AI 功能保持禁用。可运行 Developer: Policy Diagnostics 检查 Account Policy Gate 状态。据 policies.md 所述,该状态可能为 inactive、satisfied 或 restricted,处于 restricted 时报告还会列出 noAccount、wrongProvider、orgNotApproved、policyNotResolved 等具体原因;若为 policyNotResolved,可先运行 Developer: Sync Account Policy 强制刷新账号侧策略数据再重新生成报告。

启用或禁用 Agent 模式

ChatAgentMode 设为 false 可禁用 Agents(代理),对应控制 setting(chat.agent.enabled)。禁用后,agents 下拉框中不再出现 Agent 选项,但开发者仍可使用 ask 或 edit 完成代码解释与文件编辑。

启用或禁用扩展语言工具

以下策略分别控制扩展、浏览器与插件类工具:

  • ChatAgentExtensionTools 设为 false 禁用扩展贡献的工具;
  • BrowserChatTools 设为 false 禁用浏览器工具;
  • ChatPluginsEnabled 设为 false 禁用 Agent 插件集成。

配置 Copilot 代码审查

  • CopilotReviewSelection 控制对选中代码的代码审查;
  • CopilotReviewAgent 控制对 Pull Request 与变更文件的代码审查 Agent 的访问。

配置下一编辑建议

CopilotNextEditSuggestions 设为 false 可禁用下一编辑建议(NES)。

启用或禁用 Claude Agent

Claude3PIntegration 设为 false 可禁用 VS Code 中的 Claude Agent 会话。

配置模型与数据处理

设置默认聊天模型

ChatDefaultModel 用于为新会话选择默认模型,对应控制 setting(chat.defaultModel),接受 auto、模型族名称(如 opus、gemini)或完整模型 ID。开发者仍可在单个会话内切换模型,重新打开的会话保留其保存的模型。

控制听写数据

以下策略控制 内置听写 的音频与转写文本是否离开开发者设备:

策略 对应设置 行为
DictationEnabled setting(dictation.enabled) 控制内置听写是否可用
DictationModel setting(dictation.model) 选择端侧模型或 mai 云端转录服务
DictationLLMCleanup setting(dictation.experimental.llmCleanup) 控制最终转写文本是否发送给语言模型做清洗

要让听写音频留在设备本地,将 DictationModel 设为 nemotron-3.5-asr-streaming-0.6b;在 VS Code for the Web 中由于不支持端侧转录,该策略会使听写功能不可用。要防止转写文本被发送给语言模型,将 DictationLLMCleanup 设为 false,详见听写隐私说明。

治理 Agent 与工具

启用或禁用 Hooks

ChatHooks 设为 false 可禁用 Local harness 中的 hooks,对应控制 setting(chat.useHooks),且不适用于使用 Agent Host 的 Copilot 会话。hooks 的具体实现会随会话所选 harness 变化,详见 hooks 配置文档。

为 Policy Hooks 使用 SDK harness

Copilot Policy Hooks 仅作用于 SDK harness 上的会话,而非仍停留在 Local 的会话。将 ChatEditorPreferCopilotHarness 设为 true 可让新的编辑器聊天会话优先使用 SDK harness,对应控制 setting(chat.editor.preferCopilotHarness)(实验性)。该偏好不会迁移既有会话,也不会改变显式选择或被记住的 Claude、Codex 选择;推广期间应通过 会话目标选择 检查会话归属。

限制 Hook 来源
  • ChatAllowManagedHooksOnly:仅允许来自企业托管来源及策略强制启用的插件的 hooks;
  • ChatStrictPluginOnlyCustomization:在需要同时屏蔽独立的用户/工作区 skills、agents、instructions 与 MCP 服务器时启用。

插件分发是另一项独立决策:如需跨受支持 Copilot 客户端强制启用插件或治理市场,应使用企业托管设置参考中的插件控制项。

管理 Agent 插件与市场

以下策略治理 VS Code 中的 agent 插件:

  • ChatEnabledPlugins:强制启用或禁用指定插件;
  • ChatExtraMarketplaces:添加插件市场;
  • ChatStrictMarketplaces:将插件安装限制在已批准的市场来源,空列表表示禁止从所有市场安装。

被策略阻止的插件在扩展视图中仍然可见,但显示为禁用状态;被策略管理的市场会在市场选择器中明确标识。需要跨客户端治理插件时,应改用 Copilot 企业托管设置而非 VS Code 独有策略。

配置 Agent 工具审批

禁用全局自动批准

ChatToolsAutoApprove 设为 false,可阻止开发者启用全局自动批准(即常说的 "YOLO 模式")。

[!CAUTION] 全局自动批准会绕过工具调用的安全提示。除非威胁模型明确支持,否则务必禁用。据 approvals.md 所述,即使容器化环境(如 Codespaces、Dev Containers)中也可能转发用户密钥,被攻陷后风险极高。

对特定工具要求手动审批

ChatToolsEligibleForAutoApproval 用于对特定工具强制手动审批:对应工具设为 false 后始终弹确认框,且不再提供自动批准选项。

配置终端自动批准

ChatToolsTerminalEnableAutoApprove 设为 false 可要求终端命令必须人工审批。工具审批机制的完整说明见 工具审批文档。

配置安全与可观测性

配置 Agent 沙箱

VS Code 沙箱设备策略已弃用,仅适用于 Local 会话,不会对使用 Agent Host 的 Copilot 会话强制沙箱。当前企业托管设置参考中并未将共享的 sandbox 键列为 VS Code 受支持项;对 Agent Host 会话应改用会话沙箱控制并核验生效的沙箱策略。

以下弃用策略用于保留 Local 会话行为:

策略 Local 会话行为
ChatAgentSandboxEnabled 要求或禁用受支持终端命令的沙箱
ChatAgentSandboxAllowNetwork 控制沙箱终端命令的出站网络访问
ChatAgentSandboxAllowUnsandboxedCommands 控制命令是否可在用户确认后于沙箱外运行
ChatAgentSandboxAllowAutoApprove 控制沙箱终端命令的自动批准

配置 Agent 网络过滤

  • ChatAgentNetworkFilter 设为 true:按允许/拒绝域名策略限制网络访问;
  • ChatAgentAllowedNetworkDomains:允许的域名模式;
  • ChatAgentDeniedNetworkDomains:阻止的域名模式,拒绝规则优先于允许规则。

网络过滤作用于 fetch 工具与 Integrated Browser;终端覆盖范围取决于会话目标、平台与沙箱配置,详见配置沙箱网络访问。修改网络过滤设置后需重启 VS Code,新 Integrated Browser 会话才会使用更新后的策略。

使用 OpenTelemetry 配置遥测导出

CopilotOtel* 系列策略控制 VS Code 中 Copilot 的 OpenTelemetry 导出,覆盖:导出启停、收集器端点与协议、内容与身份采集、服务名、资源属性、导出器请求头等维度。完整策略列表及对应设置见企业策略参考。

使用 GitHub 组织与企业设置

GitHub 托管的控制项通过已登录账号与 GitHub 服务生效,它们不是 VS Code 设备策略。适用于管理:Copilot 访问权限、可用模型与功能、内容排除以及其他服务端策略。

配置组织级自定义指令

组织管理员在 GitHub 上创建自定义指令。当 setting(github.copilot.chat.organizationInstructions.enabled) 为 true 时,VS Code 中受支持的 Copilot 会话会纳入已登录账号可访问的组织指令。

配置组织级自定义 Agent

组织管理员在 GitHub 上创建自定义 Agent。当 setting(github.copilot.chat.organizationCustomAgents.enabled) 为 true 时,已登录账号可访问的组织与企业 Agent 会出现在 agents 下拉框中。

安全注意事项

AI 开发功能可能以用户级权限执行操作。在启用 Agent 或自动批准之前,务必通读 AI 安全考量。Copilot 的安全性、隐私、合规与透明度信息以官方 Copilot Trust Center 为准。

相关资源

登录后查看全文
vscode-docs