如何使用 VS Code Agent Mode (2026)

VS Code Agent Mode 将 GitHub Copilot 从一个行内自动补全工具转变为一个全自动的编程智能体（Agent）。比起一次只建议一行代码，Agent Mode 可以规划多步任务、编辑多个文件、运行终端命令、迭代修复错误，并通过 MCP 使用外部工具——这一切只需通过一条自然语言指令即可实现。

本指南涵盖了如何启用 Agent Mode、进行配置，以及如何高效地将其用于实际开发工作。

什么是 VS Code Agent Mode？

Agent Mode 是 VS Code 中 GitHub Copilot Chat 的一项功能，它赋予了 AI 助手自主能力。当你在 Copilot Chat 面板中从 "Ask"（问答）或 "Edit"（编辑）模式切换到 "Agent" 模式时，AI 便获得了以下能力：

规划并执行多步编程任务
在整个项目中创建、编辑和删除文件
运行终端命令并根据输出做出反应
自动修复 Lint 错误和编译错误
使用 MCP 工具与外部服务交互
自主迭代工作，直到任务完成

Agent Mode 与其他 Copilot 模式的对比

功能	Ask Mode	Edit Mode	Agent Mode
回答问题	是	否	是
编辑单个文件	否	是	是
编辑多个文件	否	是	是
运行终端命令	否	否	是
自动修复错误	否	否	是
使用 MCP 工具	否	否	是
自主迭代	否	否	是
创建/删除文件	否	有限	是

前提条件

要求	详情
VS Code	1.99 或更高版本（推荐使用 Insiders 版本以获取最新功能）
GitHub Copilot 订阅	Copilot Individual, Business, 或 Enterprise
GitHub Copilot 扩展	来自 VS Code 扩展市场的最新版本
GitHub Copilot Chat 扩展	最新版本（通常与 Copilot 捆绑）

第一步：启用 Agent Mode

Agent Mode 在 VS Code 1.99+ 版本中默认可用。使用方法如下：

按 Ctrl+Shift+I（macOS 为 Cmd+Shift+I）打开 Copilot Chat 面板，或点击活动栏中的 Copilot 图标。
在聊天面板顶部，你会看到一个模式选择下拉菜单。
将模式从 "Ask" 或 "Edit" 切换到 "Agent"。

如果你没有看到 Agent 选项，请确保你使用的是最新的 VS Code 版本：

# 检查你的 VS Code 版本
code --version

# 更新 VS Code (macOS 通过 Homebrew)
brew update && brew upgrade --cask visual-studio-code

第二步：选择模型

Agent Mode 支持多个 LLM（大语言模型）提供商。点击 Copilot Chat 面板中的模型选择器进行选择：

模型	最适合	速度	质量
GPT-4o	通用编程任务	快	高
Claude Sonnet 4	复杂推理、重构	快	极高
Claude Opus 4	最难的问题、架构设计	较慢	最高
Gemini 2.5 Pro	大型代码库、长上下文	快	高
o3-mini	快速编辑、简单任务	最快	良好

你可以根据任务的复杂程度在对话过程中切换模型。

第三步：你的第一个 Agent 任务

在 Agent Mode 聊天框中输入自然语言请求。从一些实用的任务开始：

创建一个用于用户注册的 REST API 接口。它应该：
- 接收发送到 /api/auth/register 的 POST 请求
- 验证邮箱格式和密码强度
- 使用 bcrypt 对密码进行哈希处理
- 将用户存储到数据库中
- 返回一个 JWT token
- 包含输入验证中间件
- 为重复的邮箱添加错误处理

Agent Mode 将会：

分析你现有的项目结构和技术栈。
创建或修改多个文件（route, controller, middleware, model）。
通过运行终端命令安装任何缺失的 npm 包。
检查 TypeScript 或 Lint 错误并自动修复。
展示所有更改供你审查。

你可以接受单个更改、拒绝更改，或让 Agent 进行修改。

第四步：使用 Participants 和 Context

Agent Mode 支持 @ 参与者（Participants）和 # 上下文引用（Context References），以提供更具针对性的协助：

Participants

参与者	描述
`@workspace`	访问完整的项目上下文
`@vscode`	获取 VS Code 设置和配置相关的帮助
`@terminal`	获取终端输出和命令历史记录

Context References

查看 #file:src/lib/database.ts 和 #file:src/types/user.ts
并创建一个处理 CRUD 操作的新用户服务（user service）。

使用 #file:、#selection 或 #terminalLastCommand 为 Agent 提供特定的上下文。

第五步：配置 MCP 服务器

Agent Mode 支持 MCP（Model Context Protocol）服务器，这可以通过外部工具扩展 Agent 的能力。你可以在 VS Code 设置或 .vscode/mcp.json 文件中进行配置：

// .vscode/mcp.json
{
  "servers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://user:pass@localhost:5432/mydb"
      }
    }
  }
}

连接 MCP 服务器后，Agent Mode 可以：

创建 GitHub issues 和 pull requests
直接查询数据库
浏览网页并截屏
与任何兼容 MCP 的服务交互

第六步：使用自定义指令

在仓库根目录创建一个 .github/copilot-instructions.md 文件，为 Agent Mode 提供持久化的指令：

# 编程标准
- 所有文件使用 TypeScript 严格模式
- 使用带有 hooks 的函数式 React 组件
- 使用 Tailwind CSS 工具类进行样式设计
- 为所有新函数使用 Vitest 编写单元测试
- 使用 Zod 进行运行时类型验证
- 遵循 src/ 中现有的项目结构

# 命名规范
- 组件：PascalCase (UserProfile.tsx)
- 工具函数：camelCase (formatDate.ts)
- 常量：UPPER_SNAKE_CASE
- 类型/接口：带 T 或 I 前缀的 PascalCase

# 错误处理
- 异步操作务必使用 try/catch
- API 接口返回结构化的错误响应
- 使用项目的 logger 工具记录错误

Agent Mode 会自动读取此文件，并在每个任务中遵循其中的指令。

实际工作流

缺陷修复工作流

我遇到了这个 TypeScript 错误：

Type 'string | undefined' is not assignable to type 'string'.

它发生在 src/components/UserCard.tsx 的第 42 行。
修复该错误，并在整个组件中添加适当的空值处理。

Agent 会读取文件、识别问题、应用修复、检查同文件中类似的问题，并验证修复后的代码能否通过编译。

测试生成

为 src/lib/validators.ts 生成全面的单元测试。
覆盖所有边界情况，包括：
- 空输入
- 无效格式
- 边界值
- 特殊字符
- Unicode 字符串

重构

重构身份验证模块：
1. 将所有 auth 逻辑从 src/pages/api/auth/ 移动到 src/services/auth/ 的服务层
2. 为 auth 服务创建一个清晰的接口
3. 更新整个项目中的所有引用
4. 确保所有现有测试仍然通过

Agent 会处理整个重构过程，包括更新甚至你未曾提及的文件中的导入语句。

文档编写

为 src/lib/ 中每个导出的函数添加 JSDoc 注释。
包含 @param, @returns 和 @example 标签。

获得最佳效果的建议

需求要明确。 不要只说“让代码更好”，而要说“重构 UserService 类以使用依赖注入，并为所有数据库调用添加错误处理”。
显式引用文件。 使用 #file:path/to/file 将 Agent 指向相关的代码代码。
让 Agent 迭代。 Agent Mode 可以自我修正。如果第一次尝试报错，它会自动检测并重新尝试。
使用检查点（Checkpoints）。 在进行一系列更改后，提交你的代码。如果 Agent 随后进行了你不想要的修改，你可以轻松回滚。
针对不同任务切换模型。 简单的编辑使用 GPT-4o 等快速模型，复杂的架构任务使用 Claude Opus。

Agent Mode 与其他 AI 编程工具对比

功能	VS Code Agent Mode	Cursor Composer	Cline	Claude Code
多文件编辑	是	是	是	是
终端命令	是	是	是	是
MCP 支持	是	是	是	是
编辑器内置	是	是 (独立编辑器)	扩展	CLI
模型选择	多种	多种	多种	仅限 Claude
免费层级	有限 (Copilot Free)	否	是 (自带 key)	否
自动错误修复	是	是	否	是

故障排除

看不到 Agent Mode 选项： 将 VS Code 更新至 1.99 或更高版本。同时将 GitHub Copilot 和 Copilot Chat 扩展更新至最新版本。

Agent 反应慢或无响应： 对于简单任务，切换到 GPT-4o 或 o3-mini 等更快的模型。Claude Opus 虽然强大但速度较慢。

Agent 进行了错误的更改： 通过引用特定文件提供更多上下文。添加包含编程标准的 .github/copilot-instructions.md 文件。

终端命令失败： 确保 Agent 想要运行的命令在你的 PATH 中可用。在执行前仔细审查并批准命令。

MCP 服务器未显示： 检查 .vscode/mcp.json 的语法。添加新的 MCP 服务器后重启 VS Code。检查输出面板中的 MCP 相关错误。

总结

VS Code Agent Mode 是 Copilot 体验中最重要的重大升级之一。它将代码补全工具转变为一个自主开发伙伴，能够处理横跨整个代码库的复杂多步任务。结合 MCP 支持和自定义指令，它可以适应任何项目和工作流。

如果你正在构建需要 AI 生成媒体（图像、视频、音频或数字人对口型）的应用，请查看 Hypereal AI，它提供统一的 API、按需付费的定价以及极快的生成速度。

免费试用 Hypereal AI —— 35 个额度，无需信用卡。