Agents ウィンドウの使用 (プレビュー)

Agents ウィンドウは、エージェント主導のワークフローのために構築された、VS Code 内の専用ウィンドウです。これは VS Code エディターウィンドウを補完する自然な存在です。エディターウィンドウは単一のワークスペースでのコード中心の作業に最適化されていますが、Agents ウィンドウは、チャットとセッションリストを主要なインターフェースとして、プロジェクト全体にわたる高レベルなタスクを調整するために最適化されています。

Agents ウィンドウを使用すると、すべてのワークスペースに一箇所からアクセスでき、各ワークスペースを個別のウィンドウで開くことなく、複数のプロジェクトで複数のセッションを並行して実行および追跡できます。メインの VS Code ウィンドウと同じエージェントセッション、設定、キーバインドを共有しているため、コンテキストを失うことなく、いつでもエディター中心のワークフローとエージェント中心のワークフローを自由に行き来できます。

この記事では、Agents ウィンドウについて、またプロジェクト全体でエージェントセッションを開始および管理する方法を学びます。

前提条件

• Visual Studio Code がインストールされていること。VS Code をダウンロードしてください。
• GitHub Copilot へのアクセス権。サインインしてサブスクリプションを有効にするには、「VS Code での GitHub Copilot のセットアップ」の手順に従ってください。

Agents ウィンドウを開く

Agents ウィンドウは、メインのエディターウィンドウと並んで、専用の VS Code ウィンドウとして開きます。Agents ウィンドウを開くには、以下のいずれかの方法を使用します。

• VS Code のタイトルバーにある Open in Agents ボタンを選択するか、コマンドパレットから Chat: Open Agents Window を実行します (⇧⌘P (Windows, Linux Ctrl+Shift+P))。

  VS Code のウェルカムページから直接 Agents ウィンドウを開くこともできます。

  

• コマンドラインから code --agents を実行します。

• https://insiders.vscode.dev/agents をブラウザで開き、あらゆるデバイスから Agents ウィンドウを使用します。セットアップ手順については「ブラウザで Agents ウィンドウを使用する」を参照してください。

Agents ウィンドウで Copilot サブスクリプションとセッションにアクセスするには、GitHub 認証が必要です。VS Code ですでに GitHub にサインインしている場合は、Agents ウィンドウを開いたときにも自動的にサインインされた状態になります。

常にエディターウィンドウに留まりたい場合は、タイトルバーの Open in Agents ボタンを右クリックし、Hide 'Open in Agents' を選択して非表示にできます。コマンドパレットやコマンドラインからは、いつでも Agents ウィンドウを開くことができます。

インターフェースの概要

Agents ウィンドウは、ワークスペース全体にわたる既存の Copilot CLI、Cloud、および Claude エージェントセッションを取得します。各ワークスペースを別のウィンドウで開く必要なく、異なるワークスペースのエージェントセッションを切り替えることができます。

Agents ウィンドウには以下の主要なエリアがあります。

1. セッションリスト: サイドバーにあり、ワークスペース全体のすべてのセッションを表示・管理できます。デフォルトでは、セッションはワークスペースごとにグループ化されています。セッションを右クリックすると、名前の変更、完了マーク、ピン留めなどのコマンドが表示されます。

2. カスタマイズパネル: セッションリストの下にあり、ワークフローや好みに合わせてエージェントの動作を調整するためのエージェントカスタマイズ機能にアクセスできます。

3. チャットエリア: 中央にあり、チャットの会話履歴を表示したり、プロンプトを通じてエージェントと対話したりできます。

4. 変更パネル: 右側にあり、セッション中にエージェントによって生成されたファイルの変更やその他の成果物をレビューしたり、ワークスペースのファイルエクスプローラーを表示したりできます。

エージェントセッションを開始する

Agents ウィンドウとメインの VS Code ウィンドウは、基礎となる同じエージェントセッション (Copilot CLI、Copilot Cloud、Claude エージェント) を共有しています。つまり、Agents ウィンドウで開始したセッションは、メインの VS Code ウィンドウでも即座に使用可能です。

Agents ウィンドウで新しいエージェントセッションを開始するには

1. サイドバーの上部にある New を選択するか、⌘N (Windows, Linux Ctrl+N) を押します。

   

2. ワークスペースのドロップダウンを使用して、チャットセッション用のローカルフォルダーまたは GitHub リポジトリを選択します。

   特定のワークスペースを対象としたセッションを開始するには、セッションリスト内のワークスペースにマウスを合わせ、+ (New Session) を選択します。

   選択したフォルダーまたはリポジトリがまだ信頼されていない場合は、セッションを開始する前に信頼するよう求められます。

   ヒント

   SSH または開発トンネル経由でリモートマシン上で実行されるセッションを追跡および作成できます。詳細については「リモートマシンでセッションを開く」を参照してください。

3. ワークスペースを選択した後、ドロップダウンからセッションのエージェントを選択します。

   

   利用可能なエージェントの種類は、選択したワークスペースの種類によって決まります。

   • フォルダー: Copilot CLI または Claude エージェントを選択して新しいセッションを開始します。セッション中にいつでも Continue In を選択して、Copilot Cloud エージェントにセッションを引き継ぐことができます。
   • リポジトリ: GitHub リポジトリで開始されたセッションでは、Copilot Cloud エージェントが使用されます。

4. Copilot CLI セッションの場合は、セッションの分離モードとしてフォルダーまたはワークツリーのいずれかを選択します。

   • ワークツリー分離: エージェントは Git ワークツリー にバックアップされた別のフォルダーで動作します。これにより、マージの準備が整うまで、メインワークスペースから変更を分離した状態に保つことができます。
   • フォルダー分離: エージェントはメインワークスペースで動作し、変更はファイルに直接適用されます。これは Git 以外のプロジェクトのデフォルトの動作です。

   オプションで、セッションの基点となるソース管理ブランチを選択します。

   

5. オプションで、セッション用のカスタムエージェントと言語モデルを選択します。これらはセッション中いつでも変更できます。

6. 達成したい内容を説明するプロンプトを入力し、Enter キーを押します。

   エージェントはタスクをステップに分割し、コードを記述し、コマンドを実行し、問題が発生した場合は自己修正を行います。会話を続けて結果を洗練させるか、指示を変更してください。

ファイル変更の管理とレビュー

Agents ウィンドウの変更パネルは、セッション中に行われたファイルやエージェントの編集に関する詳細情報を提供する専用ビューを提供します。変更パネルは主に2つのタブに分かれています。

• Files タブ: ワークスペース内のすべてのファイルのファイルエクスプローラービュー。
• Changes タブ: エージェントによって変更、追加、削除されたファイルのリスト。Branch Changes ドロップダウンを選択して、表示する変更を選択します。

エージェントによって行われた変更をレビューするには、Changes タブでファイルを選択して diff ビューを開き、ワークスペースの現在の状態と比較してエージェントが行った編集を確認します。

Agents ウィンドウ内のチャットビューと並べて diff ビューを開くか、モーダルウィンドウで開いて変更に集中できます。diff ビューのツールバーにあるレイアウトコントロールを使用して、表示モードを切り替えます。

diff ビューで変更をレビュー中に、編集箇所をクリックし、Add Feedback を選択してフィードバックコメントをファイルに直接入力し、エージェントに調整を促すことができます。

変更をレビューした後、変更パネルはエージェントによって行われた編集に対して以下のオプションを提供します。

• Commit: フォルダー分離を使用している場合、エージェントによって行われた変更をワークスペースに直接コミットします。
• Merge: ワークツリー分離を使用している場合、マージ（および必要に応じてアップストリームと同期）を行い、プルリクエストを作成します。
• Checkout: Copilot Cloud セッションの場合、セッションのプルリクエストに関連付けられたブランチをローカルにチェックアウトして、レビューやさらなる編集の依頼を行います。
• Discard: 編集を保持したくない場合は、変更パネルから1つまたは複数の編集を直接破棄します。

新しいセッションを作成する際、Files パネルには、エージェントが作業を開始する前にベースブランチからアップストリームの変更を取り込むことができる同期ボタンが含まれています。これにより、エージェントはブランチの最新の状態から開始でき、変更を戻す際の競合の可能性を減らすことができます。

エージェントによる変更をローカルで検証する

変更パネルで変更をレビューするだけでなく、コミットやマージを行う前に、エージェントによって行われた編集をローカルで検証することもできます。Agents ウィンドウは、現在のセッションのコンテキストでタスクやコマンドを実行することをサポートしています。たとえば、ビルドやテストを実行してエージェントによる変更がプロジェクトを壊していないか確認したり、開発サーバーを起動して編集が実行環境で期待通りに動作するか検証したりできます。

Agents ウィンドウでタスクを構成するには

1. セッションを開始または開きます。

2. タイトルバーの Tasks ドロップダウンを選択し、Add Task を選択します。

   

3. タスクの詳細を入力します。

   • Name: タスクの分かりやすい名前。
   • Command: タスク実行時に実行するコマンド（例: npm run build や pytest）。
   • Run Options: セッションワークツリーが作成されたときにタスクを自動的に実行します。
   • Save In: タスク設定をワークスペースに保存するか、プロジェクト間で再利用できるようにユーザープロファイルに保存するかを選択します。

4. Add Task を選択してタスク設定を保存します。

タスクが構成されると Tasks ドロップダウンに表示され、現在のセッションのコンテキストで実行してエージェントによる変更を検証できます。

アプリケーションにブラウザベースの動作が含まれる場合は、Agents ウィンドウの 統合ブラウザ を使用できます。チャットセッションから localhost リンクを選択して、Agents ウィンドウ内の統合ブラウザで開きます。ブラウザタブはセッション切り替え後も保持されるため、別のセッションを開いても、以前開いていたのと同じページが開き、そのページの状態が保持されます。

または、統合ターミナルから localhost リンクを選択するか、コマンドパレットから Open Integrated Browser コマンドを実行して統合ブラウザを開くこともできます (⇧⌘P (Windows, Linux Ctrl+Shift+P))。統合ブラウザのレイアウトコントロールを使用して、モーダルウィンドウとして表示したり、他のビューと並べて Agents ウィンドウのレイアウトに埋め込んだりできます。

現在のセッションのコンテキストでターミナルコマンドを実行したい場合は、タイトルバーの Open Terminal アイコンを選択して、カレントワーキングディレクトリがセッションのフォルダーまたはワークツリーに設定された統合ターミナルを開きます。

リモートマシンでセッションを開く

リモートマシンに接続してそこでセッションを開始したり、そのマシンで実行中の既存セッションの進捗を追跡したりできます。これは、メインの開発マシンから離れているときにエージェントの作業を確認したい場合や、特殊なハードウェアや特定の環境構成など、リモートマシンのリソースを活用したい場合に便利です。

Agents ウィンドウは、SSH または開発トンネル経由で Agent Host Protocol (AHP) を使用してリモートマシンに接続します。接続すると、Agents ウィンドウはリモートマシンに VS Code CLI を自動的にインストールして起動します。つまり、リモートマシンは電源が入っており、ネットワーク経由でアクセス可能である必要があります。

SSH 経由で接続する

前提条件: リモートマシンは SSH 経由でアクセス可能であること。リモートマシン側に追加のエージェントインストールは不要です。

SSH 経由でリモートマシン上でセッションを開始するには

1. New を選択するか、⌘N (Windows, Linux Ctrl+N) を押して新しいエージェントセッションを開始します。

2. ワークスペースのドロップダウンで Remote タブを選択し、SSH を選択します。すでに SSH 接続を設定している場合は、ドロップダウンにオプションとして表示されます。

   

3. リモートマシンの SSH 接続文字列を入力します（例: user@hostname）。

4. セッションに使用するリモートマシンのフォルダーを選択します。

5. プロンプトを入力し、Enter キーを押してセッションを開始します。

開発トンネル経由で接続する

前提条件: リモートマシン上で開発トンネルがすでに実行されていること。セットアップ手順については「Remote Tunnels での開発」を参照してください。

開発トンネル経由でリモートマシン上でセッションを開始するには

1. New を選択するか、⌘N (Windows, Linux Ctrl+N) を押して新しいエージェントセッションを開始します。

2. ワークスペースのドロップダウンで Remote タブを選択し、Tunnels を選択してアカウントタイプを選びます。

   

3. リストからアクティブな開発トンネルを選択します。

4. セッションに使用するリモートマシンのフォルダーを選択します。

5. プロンプトを入力し、Enter キーを押してセッションを開始します。

ブラウザで Agents ウィンドウを使用する

Agents ウィンドウは https://insiders.vscode.dev/agents の Web クライアントとしても利用できるため、ブラウザを備えたあらゆるデバイスからエージェントセッションを管理できます。これは、メインの開発マシンから離れているとき、モバイルデバイスから作業しているとき、あるいは Visual Studio Code をローカルにインストールせずにリモートホストで実行中のセッションを確認したい場合に便利です。

ブラウザベースの Agents ウィンドウは、開発トンネルを通じて開発マシンに接続します。エージェントセッションはリモートホスト上で実行され、ブラウザはチャット、変更のレビュー、セッション管理のための軽量なクライアントとして機能します。

開発トンネルをセットアップする

ブラウザで Agents ウィンドウを使用するには、まず接続先のマシンで開発トンネルを起動します。

1. リモートホスト上で、次のコマンドを実行して開発トンネルを開始します。

   code-insiders tunnel
   

   安定版（Stable）を使用している場合は、代わりに code tunnel を実行してください。

   このコマンドを初めて実行すると、GitHub または Microsoft アカウントでの認証が求められます。トンネルはセキュリティ上の理由からデフォルトで認証を必須としています。

2. トンネルが起動したら、あらゆるデバイスのブラウザで https://insiders.vscode.dev/agents を開きます。

3. プロンプトが表示されたら Continue with GitHub でサインインします。すでに認証されている場合は、Agents ウィンドウが直接読み込まれます。

4. ウィンドウ上部のホストバーにトンネルホストが表示されます。選択して接続してください。

5. リモートマシン上でフォルダーを選択し、エージェントを選択してセッションを開始します。

ホスト管理

ブラウザベースの Agents ウィンドウのホストバーには、利用可能なトンネルホストが表示されます。各ホストには接続状態が表示されます。

• Online: ホストに到達可能で、セッションを開始または継続できます。
• Offline: ホスト上のトンネルが実行されていません。ホスト上でトンネルを起動してオンラインに戻してください。

ホストバーから直接ホストへの接続と切断が可能です。アクティブなセッションがある状態でホストがオフラインになると、セッションは切断状態になります。ホストがオンラインに戻ると、セッションは自動的に再接続されます。

サブセッションを作成する

アクティブなセッションがある場合、サブセッションを開始して、同じワークスペース内で並行する別のタスクをエージェントに与えることができます。サブセッションは親セッションと同じワークスペースとワークツリーを共有しますが、空のチャットから始まります。サブセッションは親の会話履歴を引き継ぎません。

これは、進行中のセッションを中断したり、最初から完全に新しいセッションを開始したりすることなく、同じプロジェクトで独立したタスクに取り組みたい場合に便利です。

サブセッションを作成するには

1. アクティブなセッション内で、ウィンドウタイトルバーの New Sub-Session (+) を選択します。

   チャットエリアに、親セッションのタブと並んでサブセッション用の新しいタブが表示されます。サブセッションはセッションリスト内の独立した項目としては表示されません。

   

2. プロンプトを入力し、Enter を押してサブセッションを開始します。

セッションを管理する

サイドバーのセッションリストには、ワークスペース全体のアクティブなセッションがすべて表示されます。関連する作業を追跡するために、プロジェクトごと、あるいは期間ごとにセッションをグループ化できます。各セッション項目には、セッション名、ワークスペース、エージェントタイプ、ファイル変更統計などの重要な情報が表示されます。

フィルターと検索オプションを使用してリストを絞り込み、作業したいセッションを見つけます。

任意のセッションを選択してチャットの会話履歴を表示し、中断したところから再開します。変更パネルにはエージェントによる最新のファイル更新とワークスペースのファイルエクスプローラービューが表示されます。

リスト内の任意のセッションを右クリックすると、名前の変更や削除などの追加管理オプションが表示されます。アーカイブ、フォーク、チェックポイント、エクスポートなどの高度なセッション管理については、チャットドキュメントの「チャットセッションの管理」を参照してください。

プロジェクトとワークフローに合わせてエージェントをカスタマイズする

Customizations パネルから、すべての AI カスタマイズオプションに直接アクセスできます。

エージェントカスタマイズパネルを使用すると、すべてのカスタマイズを一箇所で簡単に管理できます。

• プロジェクト（ワークスペース）の既存のカスタマイズ、またはすべてのプロジェクト（ユーザー）全体にわたるカスタマイズを表示および編集します。
• 組み込みエディターを使用するか、プロンプトから生成して、新しいカスタマイズを追加します。
• マーケットプレイスからプラグインや MCP サーバーをインストールします。
• カスタマイズを削除せずに有効または無効にします。

エージェントカスタマイズパネルの左上にあるドロップダウンを使用して、カスタマイズを適用するエージェントを選択します。

フォルダーを信頼する

Agents ウィンドウで新しいフォルダーやリポジトリを初めて開くとき、そのフォルダーとサブフォルダーを信頼するかどうか尋ねられます。フォルダーの信頼は、信頼できないフォルダーでエージェントが実行されるのを防ぎ、悪意のあるコードがマシン上で実行されるリスクを抑えるセキュリティ対策です。

フォルダーを信頼しないことを選択した場合、Agents ウィンドウでそのフォルダーのエージェントセッションを開始または継続することはできません。

Agents ウィンドウは、メインの VS Code ウィンドウとワークスペースの信頼状態を共有します。VS Code でフォルダーを信頼すれば、Agents ウィンドウでも信頼され、その逆も同様です。ワークスペースの信頼に関する詳細は「ワークスペースの信頼ドキュメント」を参照してください。

別の GitHub アカウントに切り替える

Agents ウィンドウで別の GitHub アカウントを使用するには、ウィンドウ右上のアカウントアイコンを選択し、Sign out を選択します。サインアウト後、Sign in を選択して別のアカウントで認証してください。

Agents ウィンドウの設定を構成する

Agents ウィンドウはすべての VS Code 設定を共有するため、すでに行った構成は自動的に引き継がれます。エディターウィンドウとは異なる動作を Agents ウィンドウで求めている場合は、メインの VS Code セットアップに影響を与えることなく、Agents ウィンドウ専用に特定の設定を上書きできます。

Agents ウィンドウ専用の設定を上書きするには、設定ファイルを開き、Agents ウィンドウセクションの下に値を記述します。設定エディター（⌘, (Windows, Linux Ctrl+,)）を Agents ウィンドウから開き、どのスコープに設定が適用されているかを確認してください。

Agents ウィンドウで VS Code 拡張機能を使用する

Agents ウィンドウは VS Code 拡張機能を実行できるため、エージェント優先のワークフローに使い慣れたツールを取り入れることができます。

テーマ、文法、言語、キーバインドなど、静的なコンテンツのみを提供する拡張機能は、Agents ウィンドウで自動的にアクティブになります。また、マーケットプレイスのトップ100の拡張機能をテスト済みであり、デフォルトの VS Code プロファイルにインストールされていれば、その一部もアクティブになります。

その他の拡張機能については、 extensions.supportAgentsWindow Open in VS Code Open in VS Code Insiders 設定を使用して、ID ごとにオプトインできます。

"extensions.supportAgentsWindow": {
    "myextension.id": true
}

拡張機能を有効にする際は以下の点に留意してください。

• この方法で有効にする拡張機能はすべて、デフォルトの VS Code プロファイルにインストールされている必要があります。
• 拡張機能のサポートは現在も進化中です。Agents ウィンドウで拡張機能が期待通りに動作しない場合は、イシューを投稿してご相談ください。

拡張機能の開発者の方は、Agents ウィンドウでの拡張機能有効化が何を実現するかについてぜひ協力させてください。プロジェクト全体にわたるエージェント実行を活用した新しいシナリオを検討したい場合や、既存の拡張機能が Agents ウィンドウでどのように動作するかフィードバックを共有したい場合は、GitHub イシューを通じて意見やアイデアをお寄せください。

制限事項

• 現在、エージェントが直接統合ブラウザを開くことはできません。コマンドパレット（Browser: Open Integrated Browser）から統合ブラウザを起動するか、Agents ウィンドウ内の localhost リンクを選択してください。

• Agents ウィンドウが現在サポートしているエージェントタイプは、Copilot CLI、Copilot Cloud、Claude エージェントのみです。ローカルまたはサードパーティのエージェントを使用する場合は、メインの VS Code ウィンドウからセッションを管理してください。

• Copilot Cloud セッションは GitHub にバックアップされたリポジトリでのみサポートされています。GitHub 以外のプロジェクトでは、引き続き Agents ウィンドウで Copilot CLI を使用できます。

• エージェントドロップダウンには現在プランエージェントはありません。Copilot CLI または Claude エージェントセッションで /plan コマンドを使用することは可能です。Copilot CLI セッションでは、プロンプト内でプラン作成を要求すると、プランエージェントも自動的に呼び出されます。

• サブセッションは現在、Claude エージェントセッションではサポートされていません。

• マルチルートセッションは、現時点では Agents ウィンドウでサポートされていません。単一のセッション内で複数のプロジェクトにわたって作業するようにエージェントに依頼することは可能です。

よくある質問

次のステップ

• チャットセッションの管理 - チェックポイント、フォーク、アーカイブ、およびセッションのエクスポート。
• エージェントの使用 - エージェントの種類、委任、自律レベル。
• AI のカスタマイズ - 完全なカスタマイズリファレンス。
• ベストプラクティス - 効果的なプロンプトのためのヒント。