如何使用 VS Code Agent Mode (2026)
掌握 Visual Studio Code 中的内置 AI Agent
Hypereal AI Team开始使用 Hypereal AI 构建
通过单个 API 访问 Kling、Flux、Sora、Veo 等模型。免费额度即可起步，可扩展至千万级。
无需信用卡 • 10 万+ 开发者 • 企业级服务
如何使用 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 个额度，无需信用卡。
相关文章
Download Hypereal Agent
Run a local AI media workspace for image generation, video prompts, model selection, credit tracking, and saved artifacts.
