Visual Studio Code 中的第三方代理
Visual Studio Code 中的第三方代理是由 Anthropic 和 OpenAI 等外部提供商开发的 AI 代理。第三方代理使您能够利用这些 AI 提供商的独特功能,同时受益于 VS Code 中统一的代理会话管理,以及用于编码、调试、测试等方面的丰富编辑器体验。此外,您可以将这些提供商与您现有的 GitHub Copilot 订阅结合使用。
VS Code 使用提供商的 SDK 和代理工具包来访问代理的独特功能。您可以在 VS Code 中使用本地和基于云的第三方代理。与基于云的第三方代理的集成是通过您的 GitHub Copilot 计划启用的。
云端第三方编码代理目前处于预览阶段。
为什么要使用第三方代理?
在 VS Code 中使用第三方代理的优势包括:
- 使用独特功能:每个第三方代理都有其自身的优势和专业功能。VS Code 使用提供商的 SDK 和代理工具包来访问这些功能,让您可以为编码任务选择最合适的代理。
- 统一体验:通过相同的 VS Code 代理体验来管理您所有的代理会话,包括第三方代理。
- 丰富的编辑器集成:结合使用 VS Code 的编码功能(如强大的调试和测试)与代理的能力。
- 计费:通过您现有的 GitHub Copilot 订阅进行身份验证和管理账单,无需额外设置。
启用第三方云端代理
在 VS Code 中使用第三方代理之前,您需要在 Copilot 账户设置中启用对云端第三方代理的支持。请按照 GitHub 文档中在仓库中启用或禁用第三方编码代理的步骤操作。
您无需安装提供商的 VS Code 扩展即可在 VS Code 中使用其云端代理。
Claude 代理(预览版)
Claude 代理会话直接在 VS Code 中提供由 Anthropic 的 Claude 代理 SDK 支持的智能编码功能。Claude 代理会在您的工作区中自主运行,利用其自身的一套工具和功能来规划、执行和迭代编码任务。
使用 github.copilot.chat.claudeAgent.enabled 设置来启用或禁用 Claude 代理会话支持。
启动 Claude 代理会话
要启动新的 Claude 代理会话:
-
打开“聊天”视图(⌃⌘I(Windows、Linux 为 Ctrl+Alt+I))并选择新建聊天 (
+)。 -
选择本地或云端代理会话
-
对于本地会话,从会话类型下拉菜单中选择 Claude。

-
对于云端会话,从会话类型下拉菜单中选择 Cloud。然后,从合作伙伴代理下拉菜单中选择 Claude。

-
-
输入您的提示词,让代理执行任务
Claude 代理会自主决定使用哪些工具,并对您的工作区进行更改。
Claude 代理斜杠命令
Claude 代理提供专门的斜杠命令以实现高级工作流。在聊天输入框中输入 / 即可查看可用命令。
| 斜杠命令 | 描述 |
|---|---|
/agents |
为特定任务创建和管理专门的 Claude 代理。通过向导定义自定义代理行为。了解更多关于 Claude 子代理的信息。 |
/hooks |
配置在 Claude 代理会话的关键节点(例如工具执行前后)运行的生命周期钩子。了解更多关于 Claude 钩子的信息。 |
/memory |
打开并编辑 CLAUDE.md 记忆文件,为 Claude 代理提供跨会话的持久化上下文。 |
/init |
为您的项目初始化一个新的 CLAUDE.md 记忆文件。 |
/pr-comments |
从拉取请求 (Pull Request) 获取评论。 |
/review |
审查拉取请求中的代码更改。 |
/security-review |
对当前分支上待处理的代码更改进行安全审查。 |
权限模式
Claude 代理在执行某些操作之前会请求权限。默认情况下,工作区内的文件编辑会自动批准,而运行终端命令等其他操作可能需要确认。
您可以选择代理如何对您的工作区应用更改:
- 自动编辑:Claude 代理在处理任务时会自主对您的工作区进行更改。
- 请求批准:Claude 代理在对工作区进行更改之前会请求您的审查。
- 计划:Claude 代理在开始执行任务之前会概述其预期的方案。

github.copilot.chat.claudeAgent.allowDangerouslySkipPermissions 设置会绕过所有权限检查。仅在无互联网连接的隔离沙盒环境中启用此设置。
OpenAI Codex
OpenAI Codex 代理使用 OpenAI 的 Codex 自主执行编码任务。Codex 运行可以在 VS Code 中交互式进行,也可以在后台无人值守运行。
要禁用 OpenAI Codex 代理,请在 VS Code 中禁用或卸载 OpenAI Codex 扩展。
先决条件
- 用于身份验证的 Copilot Pro+ 订阅
- 对于本地会话,请使用 OpenAI Codex 扩展。
VS Code 中的 OpenAI Codex 使您能够使用 Copilot Pro+ 订阅进行身份验证并访问 Codex,无需额外设置。在 GitHub 文档中获取更多关于 GitHub Copilot 计费和高级请求的信息。
启动 Codex 会话
要启动新的 OpenAI Codex 代理会话:
-
打开“聊天”视图(⌃⌘I(Windows、Linux 为 Ctrl+Alt+I))并选择新建聊天 (
+)。 -
选择本地或云端代理会话
-
对于本地会话,从会话类型下拉菜单中选择 Codex。

-
对于云端会话,从会话类型下拉菜单中选择 Cloud。然后,从合作伙伴代理下拉菜单中选择 Codex。

-
-
在聊天编辑器输入框中输入您的提示词,让代理执行任务。
常见问题
我可以使用现有的 Copilot 订阅使用第三方代理吗?
是的,VS Code 中的第三方代理通过您现有的 GitHub Copilot 订阅进行身份验证和管理账单。对于基于云的第三方代理,请按照步骤启用代理即可。
对于基于云的第三方代理,可用性可能会根据您的 Copilot 订阅计划受到限制。查看 GitHub 文档中的 关于第三方代理以获取更多信息。
第三方代理与使用提供商的 VS Code 扩展有什么区别?
提供商的 VS Code 扩展和 VS Code 中的第三方代理集成都可以让您使用提供商的 AI 能力和代理工具包。区别在于计费:当您在 VS Code 中使用第三方代理时,GitHub 会通过您的 Copilot 订阅向您收费。当您使用提供商的扩展时,您是通过提供商的订阅付费。
为什么有两个 Claude/Codex 代理?
VS Code 允许您根据提供商的可用性,在本地和云端第三方代理之间进行选择。当您从会话类型下拉菜单中选择第三方代理时,会为该提供商创建一个本地代理会话。
要选择基于云的第三方代理,请先从会话类型下拉菜单中选择 Cloud 选项,然后从合作伙伴代理下拉菜单中选择提供商。