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 からバックグラウンドセッションを開始・管理する方法について説明します。

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 (ワークスペース) という2種類の分離モードをサポートしています。新しい Copilot CLI セッションを作成する際に、いずれかの分離モードを選択できます。

Copilot CLI エージェントからの変更を分離し、アクティブな作業への干渉を防ぐには、Worktree 分離を使用します。このモードでは、VS Code は Copilot CLI セッション用に別のフォルダー内に Git worktree を作成します。エージェントによって行われたすべての変更はこの worktree に適用され、レビューして適用する準備ができるまで、メインのワークスペースから分離された状態を保ちます。

Copilot CLI セッションからの変更を現在のワークスペースに直接適用したい場合は、Workspace 分離を選択できます。このモードでは、エージェントは現在のワークスペース内で直接動作し、変更はその場で適用されます。

権限と承認

Copilot CLI セッションは、ローカルエージェントと同じ権限レベルをサポートしています。利用可能な権限レベルは、選択した分離モードによって異なります。

• Worktree 分離: 権限レベルは自動的に Bypass Approvals (承認をバイパス) に設定され、変更できません。エージェントはコードベースの分離されたコピー (Git worktree) 上で動作するため、すべてのツール呼び出しは確認ダイアログなしで自動的に承認されます。
• Workspace 分離: ローカルエージェントセッションと同様に、3つの権限レベルすべて (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 を選択します。

   • 上部の New Chat (新しいチャット) アイコンを選択し、New Copilot CLI Session (新しい Copilot CLI セッション) を選択します。

   • コマンドパレット (⇧⌘P (Windows, Linux Ctrl+Shift+P)) から Chat: New Copilot CLI コマンドを実行します。

2. ワークスペースまたはワークツリーの分離モードから選択します。

   Worktree 分離を使用する場合、エージェントは各ターンの終了時に作業ツリーへの変更を自動的にコミットするため、セッション履歴はコミット履歴と一致した状態に保たれます。

   ヒント

   セッションリストでセッションを右クリックし、Open Worktree in New Window (作業ツリーを新しいウィンドウで開く) を選択することで、セッションの作業ツリーを開くことができます。また、ソース管理ビューのリポジトリエクスプローラー (scm.repositories.explorer) で作業ツリーを確認することもできます。

3. プロンプトを送信してエージェントを開始します。必要に応じて、追加のコンテキストを追加したり、特定の言語モデルやカスタムエージェントを選択したりできます。

4. チャットビューでセッションのステータスを追跡します。

ローカルセッションを Copilot CLI に引き継ぐ

複雑なタスクの場合、まず VS Code でローカルエージェントと対話して要件を明確にし、その後にタスクを Copilot CLI に引き継いでバックグラウンドで自律実行させるのが効果的です。Plan エージェントを使用して計画を作成し、その計画の実装を Copilot CLI に引き継ぐ場合に特に便利です。

ローカルエージェントの会話を Copilot CLI セッションに引き継ぐと、会話履歴とコンテキスト全体がバックグラウンドセッションに渡されます。

ローカルエージェントセッションを Copilot CLI に引き継ぐには

1. チャットビューを開く（⌃⌘I (Windows, Linux Ctrl+Alt+I)）

2. タスクを引き継ぐ準備ができるまで、ローカルエージェントと対話します。

3. Copilot CLI に引き継ぐには、以下のオプションがあります。

   • Session Target (セッションターゲット) ドロップダウンを開き、Copilot CLI を選択します。

     

   • Plan エージェントを使用している場合は、Start Implementation (実装を開始) ドロップダウンを選択し、Continue in Copilot CLI (Copilot CLI で続行) を選択して、Copilot CLI セッションで実装を実行します。

     

Copilot CLI セッションが自動的に開始され、会話履歴とコンテキスト全体が引き継がれます。

ターミナルから Copilot CLI を使用する

チャットビューから Copilot CLI セッションを開始することに加え、VS Code ターミナルから直接 Copilot CLI を使用することもできます。

Copilot CLI ターミナルを開く

VS Code は、専用の Copilot CLI ターミナルを開くために使用できる GitHub Copilot CLI ターミナルプロファイルを登録します。Copilot CLI ターミナルは以下の方法で開くことができます。

• ターミナルパネルの + ボタンの横にあるドロップダウンを選択し、GitHub Copilot CLI を選択します。

• コマンドパレットから Chat: New Copilot CLI Session コマンドを実行してパネル内に Copilot CLI ターミナルを開くか、Chat: New CLI Session to the Side を実行して現在のエディターの横にあるエディタータブに開きます。

• コマンドパレット (⇧⌘P (Windows, Linux Ctrl+Shift+P)) から Terminal: Create New Terminal (With Profile) コマンドを実行し、GitHub Copilot CLI を選択します。

• 任意の VS Code 統合ターミナルで copilot と入力すると、Copilot CLI を直接開始できます。

Copilot CLI ターミナルは、以下のシェルをサポートしています。

• macOS および Linux 上の bash および zsh
• Windows 上の PowerShell および Command Prompt (コマンドプロンプト)

ターミナルからセッションを開始および再開する

Copilot CLI ターミナルから新しいセッションを開始すると、VS Code は自動的にセッションを検出し、チャットビューのセッションリストに表示します。その後、ターミナルまたはチャットビューのいずれかから進捗の追跡、フォローアッププロンプトの送信、変更の確認を行うことができます。

ターミナルで既存の Copilot CLI セッションを再開するには、セッションリストでセッションを右クリックし、Resume in Terminal (ターミナルで再開) を選択します。

VS Code は Copilot CLI ターミナルの認証を自動的に処理するため、個別にサインインする必要はありません。

マルチリポジトリワークスペース

ワークスペースに複数の Git リポジトリが含まれている場合、Copilot CLI セッションを開始すると、VS Code のチャット入力欄にリポジトリピッカーが表示されます。このピッカーを使用して、作業ツリーを作成するリポジトリを選択してください。

セッション開始後、そのセッションのリポジトリピッカーは無効になります。作業ツリーは、ソース管理リポジトリビューの Worktrees ノードの下に表示されます。

Copilot CLI でカスタムエージェントを使用する (実験的)

カスタムエージェントを使用すると、VS Code のエージェントに対して独自のペルソナや役割を定義できます。例えば、コードレビューを行うためのカスタムエージェントを作成できます。カスタムエージェントは特定の指示や動作を定義できます。

Copilot CLI セッションを作成する際、タスクを処理するためにカスタムエージェントを選択できます。カスタムエージェントは定義された動作に従って動作します。

Copilot CLI でカスタムエージェントを使用するには

1. github.copilot.chat.cli.customAgents.enabled VS Code で開く VS Code Insiders で開く 設定で、Copilot CLI のカスタムエージェントを有効にします。

2. コマンドパレット (⇧⌘P (Windows, Linux Ctrl+Shift+P)) から Chat: New Custom Agent コマンドを使用して、ワークスペースにカスタムエージェントを作成します。

3. 新しい Copilot CLI セッションを作成し、エージェントのドロップダウンからカスタムエージェントを選択します。

   

4. プロンプトを入力し、タスクを処理するためにカスタムエージェントが使用されていることを確認します。

関連リソース

• エージェントの概要: さまざまなエージェントのタイプと、エージェント間でタスクを引き継ぐ方法を理解する。
• カスタムエージェント: カスタムエージェントの役割やペルソナを作成する。
• GitHub Copilot CLI ドキュメント