Visual Studio Code 中的第三方代理

Visual Studio Code 中的第三方代理是由外部服务商开发的 AI 代理,如 Anthropic 和 OpenAI。第三方代理使你能够利用这些AI提供商的独特功能,同时还能享受VS Code中的统一代理会话管理以及丰富的编辑器体验,用于编码、调试、测试等。此外,您还可以与现有的 GitHub Copilot 订阅一起使用这些服务。

VS Code 使用提供商的 SDK 和代理工具来访问代理的独特能力。你可以在VS Code中使用本地和云端第三方代理。通过您的GitHub Copilot计划,可以启用与基于云的第三方代理的集成。

注释

云端的第三方编码代理目前处于预览阶段。

为什么要使用第三方代理?

在VS Code中使用第三方代理的好处包括:

  • 利用独特功能:每个第三方代理都有其优势和专业化功能。VS Code 利用提供商的 SDK 和代理工具来访问这些功能,让你为编码任务选择最合适的代理。
  • 统一体验:管理所有代理会话,包括第三方代理,都基于相同的VS Code代理体验。
  • 丰富的编辑器集成:结合VS Code的丰富调试和测试功能,结合代理功能。
  • 计费:通过您现有的 GitHub Copilot 订阅认证和管理账单,无需额外设置。

启用第三方云代理

你需要在Copilot账户设置中启用云端第三方代理的支持,才能在VS Code中使用他们。请按照GitHub文档中的“启用或禁用仓库中的第三方编码代理”步骤作。

你不需要安装供应商的VS Code扩展就能在VS Code中使用他们的云代理。

Claude Agent(预览版)

Claude 代理会话提供由 Anthropic 的 Claude Agent SDK 直接在 VS Code 中驱动的代理编码功能。Claude 代理在您的工作区上自主运行,利用其专属工具和功能规划、执行和迭代编码任务。

启用或禁用对 Claude 代理会话的支持

github.copilot.chat.claudeAgent.enabled
  • 在VS代码中打开
  • 在VS Code Insiders中开放
环境。

启动一个Claude代理会话

启动新的 Claude 代理会话:

  1. 打开聊天视图(⌃⌘I(Windows,Linux Ctrl+Alt+I),选择新聊天()。+

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

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

      截图显示会话类型下拉菜单,选中了Claude代理选项。

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

      显示云客服在聊天输入中选择合作伙伴的截图。

  3. 输入你的提示词,让代理完成任务

    Claude代理会自动决定使用哪些工具,并对你的工作区进行调整。

Claude agent slash 命令

Claude 代理为高级工作流程提供了专用的斜杠命令。在聊天输入框中输入,查看可用的指令。/

斜击命令 描述
/代理人 创建和管理专门的Claude代理以执行特定任务。通过向导定义自定义代理行为。了解更多关于Claude子代理的信息。
/钩子 配置生命周期钩子,在 Claude 代理会话的关键点执行,如工具执行前后。了解更多关于Claude钩子的信息。
/记忆 打开并编辑CLAUDE.md内存文件,为Claude代理在会话间提供持久上下文。
/init 初始化一个新的CLAUDE.md你的项目内存文件。
/公关评论 通过拉取请求获取评论。
/影评 在拉取请求中审查代码变更。
/security-review 对当前分支的待处理代码变更进行安全审查。

权限模式

Claude 代理在执行某些作前会请求权限。默认情况下,工作区内的文件编辑是自动批准的,而其他作如运行终端命令可能需要确认。

你可以选择代理如何将更改应用到你的工作区:

  • 自动编辑:Claude 代理会在任务运行时自动更改你的工作区。
  • 请求批准:Claude 代理在更改工作区前要求您先审核。
  • 计划:Claude代理在开始任务前概述其预期方法。

显示Claude代理权限模式选项的截图。

注意

github.copilot.chat.claudeAgent.allowDangerouslySkipPermissions
  • 在VS代码中打开
  • 在VS Code Insiders中开放
设置可以绕过所有权限检查。只在没有互联网连接的孤立沙盒环境中启用。

OpenAI 手本

OpenAI Codex 代理使用 OpenAI 的 Codex 自主执行编码任务。Codex 运行可以在 VS Code 中交互运行,也可以在后台无人值守。

要禁用OpenAI Codex代理,请在VS Code中禁用或卸载OpenAI Codex扩展。

前提条件

  • Copilot Pro+ 订阅用于认证
  • 本地会话的话,可以使用 OpenAI Codex 扩展

OpenAI Codex in VS Code 允许你使用你的 Copilot Pro+ 订阅来认证并访问 Codex,无需额外设置。在GitHub文档中获取更多关于GitHub Copilot计费和高级请求的信息。

开始一个Codex会话

要开始新的 OpenAI Codex 代理会话:

  1. 打开聊天视图(⌃⌘I(Windows,Linux Ctrl+Alt+I),选择新聊天()。+

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

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

      显示会话类型下拉菜单的截图,选中了Codex特工选项。

    • 对于云会话,请从会话类型下拉菜单中选择。然后,从合作伙伴特工下拉菜单中选择法典

      显示云客服在聊天输入中选择合作伙伴的截图。

  3. 在聊天编辑器输入中输入你的提示,让代理负责任务

常见问题解答

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

是的,VS Code 中的第三方代理通过你现有的 GitHub Copilot 订阅认证和管理账单。对于基于云的第三方代理,请按照启用该代理的步骤作。

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

第三方代理和使用服务商的VS Code扩展有什么不同?

供应商的VS Code扩展和VS Code中的第三方代理集成都允许你使用供应商的AI能力和代理工具。区别在于计费方式:当你在VS Code中使用第三方代理时,GitHub会通过你的Copilot订阅向你收费。使用供应商的分机时,你会通过供应商的订阅付费。

为什么有两个克劳德/Codex特工?

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

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

  • 代理概述:了解不同代理类型以及如何在代理之间交接任务
  • 关于第三方代理:在GitHub文档中了解更多关于第三方代理的信息