Visual Studio Code 中的第三方代理 (Third-party agents)
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 訂閱進行驗證並管理計費，無需額外設定。
啟用第三方雲端代理
您必須先在 Copilot 帳戶設定中啟用對雲端第三方代理的支援，然後才能在 VS Code 中使用它們。請按照 GitHub 文件中 在您的儲存庫中啟用或停用第三方編碼代理 的步驟操作。
您不需要安裝提供商的 VS Code 延伸模組即可在 VS Code 中使用其雲端代理。
Claude 代理 (預覽)
Claude 代理工作階段直接在 VS Code 中提供由 Anthropic 的 Claude Agent SDK 支援的代理式編碼能力。Claude 代理在您的工作區中自主運作，利用其自身的一套工具和功能來規劃、執行和迭代編碼任務。
使用 github.copilot.chat.claudeAgent.enabled 設定來啟用或停用對 Claude 代理工作階段的支援。
開始 Claude 代理工作階段
若要開始新的 Claude 代理工作階段：
-
開啟聊天檢視 (⌃⌘I (Windows, Linux 為 Ctrl+Alt+I)) 並選取 新增聊天 (
+)。 -
在「本機」或「雲端」代理工作階段之間進行選擇
-
對於本機工作階段，請從 工作階段類型 (Session Type) 下拉選單中選取 Claude
-
對於雲端工作階段，請從 工作階段類型 (Session Type) 下拉選單中選取 Cloud。然後，從 合作夥伴代理 (Partner Agent) 下拉選單中選取 Claude。
-
-
輸入您的提示並讓代理處理任務
Claude 代理會自主決定要使用哪些工具並對您的工作區進行更改。
Claude 代理斜線指令
Claude 代理為進階工作流程提供專門的斜線指令。在聊天輸入框中輸入 / 即可查看可用指令。
| 斜線指令 | 說明 |
|---|---|
/agents |
針對特定任務建立並管理專門的 Claude 代理。透過精靈定義自訂代理行為。進一步了解 Claude 子代理。 |
/hooks |
設定在 Claude 代理工作階段關鍵點執行的生命週期掛勾 (lifecycle hooks)，例如在工具執行之前或之後。進一步了解 Claude 掛勾。 |
/memory |
開啟並編輯 CLAUDE.md 記憶檔案，為跨工作階段的 Claude 代理提供持續性的內容資訊。 |
/init |
為您的專案初始化一個新的 CLAUDE.md 記憶檔案。 |
/pr-comments |
從提取要求 (Pull Request) 中取得評論。 |
/review |
審核提取要求中的程式碼變更。 |
/security-review |
對目前分支上待處理的程式碼變更進行安全性審查。 |
權限模式
Claude 代理在執行某些作業前會請求許可。預設情況下，工作區內的檔案編輯是自動核准的，而執行終端機指令等其他作業則可能需要確認。
您可以選擇代理套用變更至工作區的方式
- 自動編輯 (Edit automatically)：Claude 代理在處理任務時會自主對您的工作區進行更改。
- 請求核准 (Request approval)：Claude 代理在更改您的工作區之前會請求您的審查。
- 規劃 (Plan)：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)) 並選取 新增聊天 (
+)。 -
在「本機」或「雲端」代理工作階段之間進行選擇
-
對於本機工作階段，請從 工作階段類型 (Session Type) 下拉選單中選取 Codex
-
對於雲端工作階段，請從 工作階段類型 (Session Type) 下拉選單中選取 Cloud。然後，從 合作夥伴代理 (Partner Agent) 下拉選單中選取 Codex。
-
-
在聊天編輯器輸入框中輸入您的提示，並讓代理處理任務
常見問題
我可以使用現有的 Copilot 訂閱來使用第三方代理嗎？
是的，VS Code 中的第三方代理透過您現有的 GitHub Copilot 訂閱進行驗證並管理計費。對於雲端型第三方代理，請按照步驟啟用該代理。
對於雲端型第三方代理，可用性可能會根據您的 Copilot 訂閱方案而受限。請查看 GitHub 文件中的 關於第三方代理 以獲取更多資訊。
第三方代理與使用提供商的 VS Code 延伸模組有何不同？
提供商的 VS Code 延伸模組和 VS Code 中的第三方代理整合都可讓您使用提供商的 AI 功能和代理控管機制。區別在於計費方式：當您在 VS Code 中使用第三方代理時，GitHub 會透過您的 Copilot 訂閱向您計費。當您使用提供商的延伸模組時，則會透過提供商的訂閱向您計費。
為什麼有兩個 Claude/Codex 代理？
VS Code 可讓您根據提供商的可用性，在「本機」和「雲端型」第三方代理之間進行選擇。當您從 工作階段類型 (Session Type) 下拉選單中選取第三方代理時，系統會為該提供商建立本機代理工作階段。
若要選擇雲端型第三方代理，請先從 工作階段類型 (Session Type) 下拉選單中選取 Cloud 選項，然後從 合作夥伴代理 (Partner Agent) 下拉選單中選取該提供商。