在 VS Code 中使用第三方代理程式
第三方代理程式允許您在 VS Code 中使用特定提供者專屬的代理程式體驗。在本指南中，您將在本機和雲端工作階段之間做出選擇、啟動 Claude 或 Codex 工作階段，並挑選符合任務的權限模式。
先決條件
開始之前，請安裝 VS Code、啟用 AI 功能，並登入 GitHub Copilot。對於雲端合作夥伴代理程式，請遵循 GitHub 文件為您的帳戶啟用第三方程式碼編寫代理程式。對於雲端合作夥伴代理程式，您不需要該提供者的 VS Code 擴充功能。對於本機 Codex 工作階段，請安裝 OpenAI Codex 擴充功能。
選擇工作階段類型
第三方代理程式來自 Anthropic 和 OpenAI 等提供者。VS Code 會使用提供者的 SDK 與代理程式執行環境，同時將工作階段保留在 VS Code 聊天體驗中。
基於雲端的第三方代理程式目前處於預覽狀態。
開始之前，請決定哪種工作階段最適合該任務。
| 工作階段類型 | 適用時機 | 範例 |
|---|---|---|
| 本機第三方代理程式 | 您希望提供者代理程式直接在您的本機工作區中運作。 | 要求 Claude 重構小型模組並執行本機測試。 |
| 雲端合作夥伴代理程式 | 您希望提供者代理程式透過您的 Copilot 設定在雲端工作階段中運作。 | 交出可在編輯器外部執行的較長程式碼撰寫任務。 |
| 內建的 VS Code 代理程式 | 您希望使用搭配目前工具選取項目與自訂設定的標準 VS Code 代理程式。 | 使用選定的工具和核准進行專注的編輯。 |
當您明確想要提供者的代理程式行為或 SDK 時，請使用第三方代理程式。當任務主要依賴 VS Code 工具、自訂代理程式、工具集或您已設定的核准模型時，請使用內建的 VS Code 代理程式。
啟動 Claude 工作階段
先嘗試讓 Claude 執行一個受控的任務，例如要求它檢查小型功能並提出計畫。
-
開啟對話檢視。
-
選取 新增聊天。
-
對於本機工作階段，請從 工作階段類型 下拉式選單中選擇 Claude。
-
對於雲端工作階段，請從 工作階段類型 下拉式選單中選擇 雲端，然後從 合作夥伴代理程式 下拉式選單中選擇 Claude。
-
傳送定義所需範圍的提示詞。
Inspect the current branch and propose a plan for one small refactor. Do not edit files yet.
從規劃提示詞開始，提供了一種低風險的方式，讓您在代理程式變更檔案之前，了解它如何處理儲存庫。
啟動 Codex 工作階段
當您想要針對程式碼撰寫任務使用 OpenAI Codex 代理程式行為時，請使用 Codex。雲端 Codex 工作階段會使用雲端合作夥伴流程。本機 Codex 工作階段需要 OpenAI Codex 擴充功能以及用於驗證的 Copilot Pro+ 訂閱。
-
開啟對話檢視。
-
選取 新增聊天。
-
對於本機工作階段，請從 工作階段類型 下拉式選單中選擇 Codex。
-
對於雲端工作階段，請從 工作階段類型 下拉式選單中選擇 雲端，然後從 合作夥伴代理程式 下拉式選單中選擇 Codex。
-
傳送一項專注的程式碼撰寫任務。
Find one failing or missing test around the current change, add the smallest useful test, and explain how to validate it.
Claude 代理程式斜線指令
在 Claude 工作階段中，於聊天輸入框中輸入 / 以查看可用的指令。
| 斜線指令 | 說明 |
|---|---|
/agents |
用於建立和管理 Claude 子代理程式的精靈。 |
/hooks |
設定在工作階段期間於關鍵時間點執行的生命週期攔截。 |
/memory |
開啟並編輯跨工作階段使用的 CLAUDE.md 記憶檔案。 |
/init |
為專案初始化新的 CLAUDE.md 記憶檔案。 |
/pr-comments |
從提取要求取得註解。 |
/review |
檢閱提取要求中的程式碼變更。 |
/security-review |
對待處理的變更執行安全性檢閱。 |
在啟動 Claude 工作階段後嘗試執行一個指令。例如，當您想要 Claude 檢查待處理的變更時使用 /review，或當您想要它為未來的 Claude 工作階段建立專案記憶時使用 /init。
啟用雲端合作夥伴代理程式
在您可以使用雲端合作夥伴代理程式之前，請遵循 GitHub 文件為您的 GitHub Copilot 帳戶啟用第三方程式碼編寫代理程式。
為您的帳戶啟用第三方程式碼編寫代理程式後，請返回 VS Code，並從聊天代理程式選擇器中啟動與 Claude 或 Codex 的工作階段。
選擇正確的權限模式
Claude 代理程式會在三個權限模式中的其中一個下執行，您可以從聊天輸入中進行挑選
- 自動編輯：Claude 在運作時會自主進行工作區變更。
- 要求核准：Claude 在進行變更之前會先徵求您的檢閱。
- 計畫：Claude 在開始工作之前會先概述其預期的作法。
挑選符合任務的模式
- 當您正在探索不熟悉的區域或想要先檢閱作法時，請使用 計畫。
- 當代理程式可以編輯檔案，但您希望在變更套用之前進行核准時，請使用 要求核准。
- 對於您可以安心在代理程式迭代後檢閱最終差異的受控工作，請使用 自動編輯。
對於敏感的工作，請將核准納入流程中，並在可能的情況下將代理程式與沙箱環境結合。
The github.copilot.chat.claudeAgent.allowDangerouslySkipPermissions 設定會繞過所有權限檢查。請僅在沒有網際網路存取的隔離沙箱環境中啟用它。
比較結果
在兩個地方執行相同的小型規劃提示詞
-
從內建的 VS Code 代理程式開始。
-
在 Claude 或 Codex 中執行相同的提示詞。
-
比較工作階段期間的計畫、工具使用方式以及您擁有的控制程度。
這項比較有助於您決定何時使用提供者專屬代理程式能帶來額外價值，以及何時內建代理程式就已足夠。
為什麼這很重要
第三方代理程式讓您能在一個地方維持程式碼撰寫工作流程，同時使用提供者專屬的功能。實際的選擇不是「哪個代理程式最好」，而是哪種工作階段類型最符合您的工作、風險以及您想要的檢閱量。
接下來要做什麼
您現在已經涵蓋了這四個課程主題。請檢閱工具選擇、MCP 伺服器設定、外掛程式封裝以及第三方代理程式工作階段類型，然後套用最適合您下一個實際任務的最小設定。