VS Code Copilot智能体与User profile配置及默认智能体查看指南

本文汇总VS Code中GitHub Copilot自定义智能体与User profile（用户配置文件）的关联配置、操作步骤，以及Copilot默认智能体的查看方法，覆盖Windows/macOS/Linux三系统，兼顾基础操作与进阶技巧，适配日常开发中的智能体管理需求。

一、核心关联：Copilot智能体与User profile的绑定逻辑

Copilot自定义智能体的生效范围可通过创建位置选择，其中「User profile」选项是实现智能体跨工作区全局复用的关键，其核心逻辑与VS Code Profiles（用户配置文件）深度绑定，区别于仅针对单个项目生效的「Workspace」选项，具体关联规则如下：

创建位置	生效范围	核心特点	存储关联
User profile	所有工作区、所有VS Code Profiles全局生效	跨项目复用，无需重复创建	存储在Copilot专属User profile路径，与VS Code Profiles逻辑一致
Workspace	仅当前工作区生效	项目隔离性强，不影响其他工作区	存储在当前工作区的.github/agents文件夹
Workspace (Claude format)	仅当前工作区生效	兼容Claude Code及相关工具	存储在当前工作区的.claude/agents文件夹

二、User profile中Copilot自定义智能体的配置操作步骤

配置全程在VS Code内可视化完成，无需手动创建文件夹，系统会自动在对应路径生成配置文件，步骤如下（适用于所有系统）：

1. 打开自定义智能体创建入口（二选一）

• 界面操作：点击Copilot聊天面板顶部的「智能体下拉菜单」→ 选择「配置自定义智能体」→ 点击「创建新的自定义智能体」；

• 命令面板：按下Ctrl+Shift+P（Mac系统为Cmd+Shift+P），输入并运行「Chat: New Custom Agent」命令。

2. 选择User profile创建位置

在弹出的位置选择窗口中，点击「User profile」选项，确认后该智能体将自动具备全局生效特性，可在所有工作区使用。

3. 生成并编辑智能体配置文件

• 输入智能体文件名（将作为下拉菜单中的显示名称），回车后VS Code自动生成「.agent.md」格式的配置文件，并自动打开；

• 配置文件编辑：顶部YAML前置区配置智能体名称、描述、可用工具、默认模型等核心参数；正文区编写智能体的执行逻辑（如代码生成、调试规则等）；

• 保存文件后，智能体自动同步到Copilot智能体下拉菜单，无需重启VS Code即可生效。

4. 已创建智能体的编辑与更新

无需手动查找路径，直接在VS Code内操作：打开Copilot智能体下拉菜单→「配置自定义智能体」→ 在列表中找到目标智能体（标注全局生效）→ 点击打开即可编辑，修改后保存实时生效，所有工作区同步更新。

三、不同系统下User profile的Copilot智能体存储路径

选择User profile后，Copilot自定义智能体文件（.agent.md）会自动存储在以下专属路径，无需手动创建目录，可直接复制路径在文件管理器中打开：

1. Windows系统

%APPDATA%\GitHub Copilot\agents\

2. macOS系统

~/Library/Application Support/GitHub Copilot/agents/

3. Linux系统

~/.config/github-copilot/agents/

快速打开技巧：在VS Code中按下Ctrl+P（Mac为Cmd+P），粘贴对应路径，回车即可直接定位到该文件夹。

四、Copilot默认智能体的查看方法（4种方式）

Copilot默认智能体分为「内置原生智能体」和「全局配置项」，查看方式各有侧重，按需选择即可：

方式1：界面查看内置默认智能体（最常用）

• 打开Copilot聊天面板（快捷键Ctrl+Shift+I，Mac为Cmd+Shift+I）；

• 点击面板顶部的智能体下拉菜单（默认显示当前使用的智能体，如Code Editing）；

• 下拉列表中未标注「自定义」的选项，即为Copilot内置默认智能体，核心包括：

  • Code Editing：默认代码编辑智能体，用于代码补全、调试、编写；

  • Plan：项目规划智能体，用于任务拆分、开发方案生成；

  • Review：代码审查智能体，用于检查Bug、规范、性能问题；

  • Explore：知识探索智能体，用于技术调研、文档查询、概念解释。

• 查看详细逻辑：选择某一内置智能体后，在聊天框输入「/help」，即可获取其核心能力、支持命令及使用场景。

方式2：查看智能体全局配置项（控制默认行为）

该方式用于查看/修改默认智能体的模型、工具、请求限制等核心参数，入口有两种：

• 界面入口：文件 → 首选项 → 设置 → 搜索「@ext:GitHub.copilot-chat agent」；

• 命令面板入口：Ctrl+Shift+P（Mac为Cmd+Shift+P）→ 输入「Preferences: Open Settings (JSON)」→ 编辑settings.json文件。

核心默认配置项（必看）：

配置项	默认值	核心作用
github.copilot.chat.implementAgent.model	GPT-5 (copilot)	控制所有默认智能体的使用模型，可切换为Claude Sonnet 4.5等
github.copilot.chat.agent.autoFix	true	默认智能体是否自动修复生成代码中的问题
github.copilot.chat.agent.maxRequests	25	默认智能体单次任务的最大请求数限制
github.copilot.chat.agentFilesLocations	{“~/.config/github-copilot/agents”: true}	指定User profile级智能体的存储路径

示例：修改默认智能体模型为Claude Sonnet 4.5，在settings.json中添加以下代码：

{
  "github.copilot.chat.implementAgent.model": "Claude Sonnet 4.5 (copilot)",
  "inlineChat.defaultModel": "Claude Sonnet 4.5 (copilot)"
}

方式3：查看内置默认智能体的底层文件（进阶参考）

Copilot内置智能体的定义文件为VS Code扩展内置资源，不可直接编辑，仅用于学习参考，路径如下：

• 第一步：找到Copilot Chat扩展安装目录 注：*为扩展版本号，如0.17.0，可根据实际安装版本调整。

  • Windows：%USERPROFILE%.vscode\extensions\github.copilot-chat-*

  • macOS：~/.vscode/extensions/github.copilot-chat-*

  • Linux：~/.vscode/extensions/github.copilot-chat-*

• 第二步：进入扩展目录后，内置智能体配置文件路径为：assets/prompts/agents/，包含code-editing.agent.md（代码编辑智能体）、plan.agent.md（规划智能体）等。

⚠️ 注意：修改该路径下的文件会被VS Code扩展更新覆盖，且可能导致功能异常，不建议操作。

方式4：查看User profile关联的默认智能体路径

即本文第三部分所述的Copilot智能体存储路径，可快速定位User profile下所有全局生效的自定义智能体文件，操作同第三部分的快速打开方法。

五、关键注意事项（避坑核心）

• 区分两个核心路径：VS Code Profiles根路径（如Windows %APPDATA%\Code\User\profiles）是VS Code自身配置路径，与Copilot智能体的User profile路径（GitHub Copilot/agents）不同，二者仅生效逻辑一致，路径相互独立；

• User profile级智能体的全局生效特性：该路径下的智能体对当前VS Code的所有Profiles、所有工作区均生效，切换VS Code Profiles不影响其可用性；

• 配置文件格式要求：必须为.agent.md格式（markdown文件），手动创建时需严格遵守，否则VS Code无法识别；旧版的.chat-mode.md文件可通过VS Code快速修复功能自动转换；

• 内置智能体覆盖方法：若需修改内置智能体行为，无需修改底层文件，可创建与内置智能体同名的自定义智能体（如code-editing.agent.md），Copilot会优先使用自定义版本；

• 智能体迁移：将Workspace级智能体（.github/agents下的文件）复制到User profile路径，重启VS Code即可升级为全局生效，原工作区文件可保留，不冲突。

六、补充：Workspace级智能体迁移至User profile（全局生效）

若已创建仅工作区生效的Copilot智能体，需升级为全局生效，仅需3步：

1. 找到工作区中的智能体文件：工作区根目录/.github/agents/xxx.agent.md；

2. 将该文件复制到对应系统的User profile智能体路径（本文第三部分所述）；

3. 重启VS Code，该智能体自动变为全局生效，可在所有工作区使用。