Visual Studio Code 中的第三方代理
Visual Studio Code 中的第三方代理是由外部提供商（如 Anthropic 和 OpenAI）开发的 AI 代理。第三方代理使您能够利用这些 AI 提供商的独特功能，同时仍能受益于 VS Code 中统一的代理会话管理，以及用于编码、调试、测试等方面的丰富编辑器体验。此外，您可以将这些提供商与您现有的 GitHub Copilot 订阅配合使用。
VS Code 使用提供商的 SDK 和代理控制框架（agent harness）来访问代理的独特功能。您可以在 VS Code 中同时使用本地和基于云的第三方代理。基于云的第三方代理集成是通过您的 GitHub Copilot 计划启用的。
云端的第三方编码代理目前处于预览阶段。
为什么要使用第三方代理？
在 VS Code 中使用第三方代理的优势包括：
- 使用独特功能：每个第三方代理都有其自身的优势和专业化功能。VS Code 使用提供商的 SDK 和代理控制框架来访问这些功能，让您可以为编码任务选择最合适的代理。
- 统一体验：在同一个 VS Code 代理体验中管理您所有的代理会话，包括第三方代理。
- 丰富的编辑器集成：结合代理的功能，使用 VS Code 的编码特性（例如丰富的调试和测试）。
- 计费：通过您现有的 GitHub Copilot 订阅进行身份验证和管理账单，无需额外设置。
启用第三方云端代理
在使用 VS Code 中的第三方云端代理之前，您需要在 Copilot 账户设置中启用对其的支持。请按照 GitHub 文档中 在仓库中启用或禁用第三方编码代理 的步骤进行操作。
您无需安装提供商的 VS Code 扩展即可在 VS Code 中使用其云端代理。
Claude Agent (预览版)
Claude 代理会话直接在 VS Code 中提供由 Anthropic 的 Claude Agent 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 |
获取拉取请求 (PR) 中的评论。 |
/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 选项，然后从 合作伙伴代理 下拉菜单中选择提供商。