探索 Agent 式開發 -

Visual Studio Code 中的 Copilot CLI 工作階段

Visual Studio Code 支援使用 GitHub Copilot CLI 在背景執行代理程式工作階段。您可以從 VS Code 中整合的聊天檢視啟動、監控及管理您的 Copilot CLI 工作階段，而代理程式則在您的本機電腦上自主執行，同時您可以在編輯器中繼續其他工作。平行執行多個 Copilot CLI 工作階段，以同時處理獨立的任務。

若要啟動 Copilot CLI 工作階段，您可以建立新的工作階段，或將本機代理程式工作階段交接給 Copilot CLI，以傳遞現有的內容。

本文涵蓋 Copilot CLI 代理程式的主要功能，以及如何從 Copilot CLI 啟動和管理背景工作階段。

Screenshot of Copilot CLI session as a chat editor in VS Code.

提示

像 OpenAI Codex 這樣的第三方提供者也提供背景功能。深入瞭解第三方代理程式。

什麼是 Copilot CLI 工作階段？

Copilot CLI 工作階段在您的本機電腦上獨立於背景執行，並使用 Copilot CLI 代理程式框架。VS Code 使用 Copilot SDK 與這些代理程式整合，以啟動、停止和監控背景工作階段的進度。VS Code 會自動為您安裝和設定 Copilot CLI。

Copilot SDK 工作階段在 VS Code 之外執行，即使您關閉 VS Code 視窗，也會繼續在背景執行。此行為與使用編輯器內 VS Code 代理程式框架的本機代理程式不同，本機代理程式會在 VS Code 停止時停止執行。

您可以從整合的聊天檢視與 Copilot CLI 工作階段互動。當背景工作階段需要您的輸入或需要權限來執行動作時，您可以在聊天中完成。代理程式狀態指示器也會在工作階段需要輸入時提供提示。

由於 Copilot CLI 工作階段在背景執行，它們非常適合範圍明確、具備所有必要內容且不需要頻繁使用者互動的任務。例如，從計劃中實作功能、建立概念驗證的多個變體，或實作明確定義的修復或功能。

Copilot CLI 支援聊天中的斜線指令，包括可重複使用的提示、代理程式技能、掛鉤、/compact 以管理冗長對話，以及 /yolo 或 /autoApprove 以切換工具的自動核准。在 Copilot CLI 工作階段的聊天輸入中輸入 /，即可查看可用的指令。

隔離模式

Copilot CLI 支援兩種隔離模式，以管理代理程式的變更如何應用於您的程式碼庫：工作樹 (Worktree) 和工作區 (Workspace) 隔離。您可以在建立新的 Copilot CLI 工作階段時選擇隔離模式。

若要隔離來自 Copilot CLI 代理程式的變更並防止干擾您的活動工作，請使用工作樹 (Worktree) 隔離。在此模式下，VS Code 會為 Copilot CLI 工作階段在獨立資料夾中建立一個Git 工作樹。代理程式所做的所有變更都會應用於工作樹，使其與您的主工作區保持分離，直到您準備好審閱並應用這些變更為止。

如果您希望 Copilot CLI 工作階段的變更直接應用於您目前的工作區，您可以選擇工作區 (Workspace) 隔離。在此模式下，代理程式會直接在您目前的工作區中操作，並且變更會就地應用。

注意

若要使用 Git 工作樹和工作樹隔離，您的工作區需要是一個 Git 存放庫。

權限與核准

Copilot CLI 工作階段支援與本機代理程式相同的權限等級。可用的權限等級取決於您選擇的隔離模式

  • 工作樹隔離：權限等級會自動設定為繞過核准 (Bypass Approvals) 且無法變更。由於代理程式對您的程式碼庫的隔離副本 (Git 工作樹) 進行操作，所有工具呼叫都會自動核准，無需確認對話方塊。
  • 工作區隔離：所有三個權限等級都可用 (預設核准 (Default Approvals)、繞過核准 (Bypass Approvals) 和自動駕駛 (Autopilot))，就像本機代理程式工作階段一樣。從聊天輸入區的權限選取器中選擇一個等級。

Copilot CLI 工作階段的限制

  • Copilot CLI 工作階段無法存取所有 VS Code 內建工具。您可以在聊天輸入中明確新增內容。

  • 無法存取擴充功能提供的工具，且僅限於透過 CLI 工具可用的模型。

  • 目前僅能存取不需要驗證的本機 MCP 伺服器。

建立 Copilot CLI 工作階段

在 VS Code 中建立新的 Copilot CLI 工作階段

  1. 使用以下任一選項建立新的工作階段

    • 開啟「聊天」檢視 (⌃⌘I (Windows、Linux Ctrl+Alt+I))，然後從「工作階段目標」下拉式清單中選取 Copilot CLI

    • 選取頂部的「新增聊天」圖示，然後選取「新增 Copilot CLI 工作階段」

    • 從命令選擇區 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 執行「聊天：新增 Copilot CLI」命令

  2. 選擇工作區或工作樹隔離模式

    如果您使用工作樹隔離，代理程式會在每次迴合結束時自動將變更提交到工作樹，因此工作階段歷史記錄會與提交歷史記錄保持一致。

    提示

    您可以右鍵點擊工作階段清單中的工作樹，然後選取「在新視窗中開啟工作樹」來開啟工作樹。您也可以在原始碼控制檢視的存放庫總管 (scm.repositories.explorer) 中檢視工作樹。

  3. 提交您的提示以啟動代理程式。您可以選擇性地新增額外內容，或選擇特定的語言模型和自訂代理程式。

  4. 在「聊天」檢視中追蹤工作階段狀態。

提示

您可以建立多個 Copilot CLI 工作階段，以平行處理不同的任務。

將本機工作階段交接給 Copilot CLI

對於複雜任務，最好先在 VS Code 中與本機代理程式互動以澄清需求，然後將任務交接給 Copilot CLI 在背景中自主執行。當使用計劃代理程式建立計劃，然後將該計劃的實作交接給 Copilot CLI 時，這會很有用。

當您將本機代理程式對話交接給 Copilot CLI 工作階段時，完整的對話歷史記錄和內容會傳遞給背景工作階段。

將本機代理程式工作階段交接給 Copilot CLI

  1. 開啟「聊天」檢視 (⌃⌘I (Windows、Linux Ctrl+Alt+I))

  2. 與本機代理程式互動，直到您準備好交接任務為止

  3. 若要交接給 Copilot CLI，您有以下選項

    • 開啟「工作階段目標」下拉式清單，然後選取 Copilot CLI

      Screenshot showing the Session Target dropdown in VS Code chat interface.

    • 如果您使用計劃代理程式，請選取「開始實作」下拉式清單，然後選取「在 Copilot CLI 中繼續」以在 Copilot CLI 工作階段中執行實作

      Screenshot showing the "Start Implementation" button in VS Code chat interface.

Copilot CLI 工作階段會自動啟動，並攜帶完整的對話歷史記錄和內容。

從終端機使用 Copilot CLI

除了從「聊天」檢視啟動 Copilot CLI 工作階段之外，您還可以直接從 VS Code 終端機使用 Copilot CLI。

Screenshot showing the Copilot CLI session inside VS Code.

開啟 Copilot CLI 終端機

VS Code 會註冊一個 GitHub Copilot CLI 終端機設定檔，您可以用它來開啟專用的 Copilot CLI 終端機。您可以透過多種方式開啟 Copilot CLI 終端機

  • 選取「終端機」面板中 + 按鈕旁邊的下拉式清單，然後選取 GitHub Copilot CLI

  • 從命令選擇區執行「聊天：新增 Copilot CLI 工作階段」命令以在面板中開啟 Copilot CLI 終端機，或執行「聊天：新增 CLI 工作階段到側邊」以在您目前編輯器旁的編輯器索引標籤中開啟它

  • 從命令選擇區 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 執行「終端機：建立新終端機 (含設定檔)」命令，然後選取 GitHub Copilot CLI

  • 在任何 VS Code 整合式終端機中輸入 copilot 以直接啟動 Copilot CLI

Copilot CLI 終端機支援以下 Shell

  • macOS 和 Linux 上的 bash 和 zsh
  • Windows 上的 PowerShell 和命令提示字元 (Command Prompt)

從終端機啟動和恢復工作階段

當您從 Copilot CLI 終端機啟動新的工作階段時，VS Code 會自動偵測到該工作階段並將其顯示在「聊天」檢視的工作階段清單中。然後，您可以從終端機或「聊天」檢視追蹤進度、傳送後續提示或審閱變更。

若要在終端機中恢復現有的 Copilot CLI 工作階段，請在工作階段清單中右鍵點擊該工作階段，然後選取「在終端機中恢復」。

VS Code 會自動處理 Copilot CLI 終端機的驗證，因此您無需單獨登入。

多存放庫工作區

如果您的工作區包含多個 Git 存放庫，當您啟動 Copilot CLI 工作階段時，VS Code 會在聊天輸入中顯示一個存放庫選取器。使用此選取器來選擇應該在哪個存放庫中建立工作樹。

工作階段啟動後，該工作階段的存放庫選取器會停用。工作樹會顯示在原始碼控制存放庫檢視中「工作樹」節點下所選的存放庫中。

提示

若要檢視工作區中的所有存放庫，請啟用 scm.repositories.explorer Open in VS Code Open in VS Code Insiders 設定並開啟「原始碼控制」檢視。

將自訂代理程式與 Copilot CLI 搭配使用 (實驗性功能)

自訂代理程式可讓您在 VS Code 中定義代理程式的自訂人物形象和角色。例如，您可能會建立一個用於執行程式碼審閱的自訂代理程式。自訂代理程式可以定義特定的指示和行為。

當您建立 Copilot CLI 工作階段時，您可以選取一個自訂代理程式來處理任務。自訂代理程式會根據定義的行為運作。

將自訂代理程式與 Copilot CLI 搭配使用

  1. 透過 github.copilot.chat.cli.customAgents.enabled Open in VS Code Open in VS Code Insiders 設定啟用 Copilot CLI 的自訂代理程式

  2. 從命令選擇區 (⇧⌘P (Windows、Linux Ctrl+Shift+P)) 使用「聊天：新增自訂代理程式」命令在您的工作區中建立自訂代理程式

  3. 建立新的 Copilot CLI 工作階段，然後從「代理程式」下拉式清單中選取自訂代理程式

    Screenshot showing custom agent selection in VS Code chat interface.

  4. 輸入提示，並注意自訂代理程式用於處理任務

注意

目前，只有在工作區中定義的自訂代理程式可用於 Copilot CLI 工作階段。深入瞭解建立自訂代理程式。

相關資源

4/8/2026
English 한국어 中文(简体) 中文(繁體)
© . This site is unofficial and not affiliated with Microsoft.