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 在 VS Code 中打开 在 VS Code Insiders 中打开 设置来启用或禁用 Claude 代理会话支持。

启动 Claude 代理会话

要启动新的 Claude 代理会话:

  1. 打开“聊天”视图(⌃⌘I(Windows、Linux 为 Ctrl+Alt+I)并选择新建聊天 (+)。

  2. 选择本地或云端代理会话

    • 对于本地会话,从会话类型下拉菜单中选择 Claude

      Screenshot showing session type dropdown with Claude agent option selected.

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

      Screenshot showing cloud agent partner selection picker in chat input.

  3. 输入您的提示词,让代理执行任务

    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 代理在开始执行任务之前会概述其预期的方案。

Screenshot showing Claude agent permission mode options.

注意

github.copilot.chat.claudeAgent.allowDangerouslySkipPermissions 在 VS Code 中打开 在 VS Code Insiders 中打开 设置会绕过所有权限检查。仅在无互联网连接的隔离沙盒环境中启用此设置。

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 代理会话:

  1. 打开“聊天”视图(⌃⌘I(Windows、Linux 为 Ctrl+Alt+I)并选择新建聊天 (+)。

  2. 选择本地或云端代理会话

    • 对于本地会话,从会话类型下拉菜单中选择 Codex

      Screenshot showing session type dropdown with Codex agent option selected.

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

      Screenshot showing cloud agent partner selection picker in chat input.

  3. 在聊天编辑器输入框中输入您的提示词,让代理执行任务。

常见问题

我可以使用现有的 Copilot 订阅使用第三方代理吗?

是的,VS Code 中的第三方代理通过您现有的 GitHub Copilot 订阅进行身份验证和管理账单。对于基于云的第三方代理,请按照步骤启用代理即可。

对于基于云的第三方代理,可用性可能会根据您的 Copilot 订阅计划受到限制。查看 GitHub 文档中的 关于第三方代理以获取更多信息。

第三方代理与使用提供商的 VS Code 扩展有什么区别?

提供商的 VS Code 扩展和 VS Code 中的第三方代理集成都可以让您使用提供商的 AI 能力和代理工具包。区别在于计费:当您在 VS Code 中使用第三方代理时,GitHub 会通过您的 Copilot 订阅向您收费。当您使用提供商的扩展时,您是通过提供商的订阅付费。

为什么有两个 Claude/Codex 代理?

VS Code 允许您根据提供商的可用性,在本地和云端第三方代理之间进行选择。当您从会话类型下拉菜单中选择第三方代理时,会为该提供商创建一个本地代理会话。

要选择基于云的第三方代理,请先从会话类型下拉菜单中选择 Cloud 选项,然后从合作伙伴代理下拉菜单中选择提供商。

  • 代理概览:了解不同类型的代理以及如何在代理之间切换任务。
  • 关于第三方代理:在 GitHub 文档中了解更多关于第三方代理的信息。
© . This site is unofficial and not affiliated with Microsoft.