
Visual Studio Code エージェントウィンドウ入門
Visual Studio Code(VSCode)は、開発者向けのコードエディタとしてもっとも親しまれているエディタの1つです。現在では、GitHub Copilot(Copilot)というAIエージェントが同梱され、AI駆動開発も可能になっています。

そして今、VSCodeは単なるエディタの枠を越え、複数のエージェントを統括する「エージェントウィンドウ」が搭載され、よりAI駆動開発向けの開発ソフトとして進化しています。この記事では、そんなVSCodeのエージェントウィンドウの使い方について紹介していきましょう。
セットアップしよう
VSCodeのセットアップがまだの方は、次のサイトからセットアップしておきましょう。
また、GitHubにアカウントを作成し、画面上部の「Sign In」ボタンからログインしておきましょう。

GoogleやAppleアカウントでもログインはできますが、GitHubでログインしておくとなにかと便利です。
また、本記事を実際に試すには「Node.js」の環境が必要なので、インストールしていない方は次のサイトからインストールしておきましょう。念のため、インストール後はVSCodeを再起動しておきましょう。

エージェントウィンドウに切り替えよう
VSCodeを起動すると、最初に従来通りのエディタが起動します。現在はこれを「エディター」と呼びます。画面上部の切り替えボタンをクリックすると「エージェント」に切り替えることができます。

エージェントウィンドウには、エディタの切り替えがあり、こうして互いに行き来することができます。
エージェントウィンドウは、画面の分割は同じ3分割ですが、各パネルの役割が違っていて、一番左が「エージェント管理パネル」、真ん中が「チャットエリア」、右側がその他のパネル群という配置になっています。

左側のエージェント管理パネルで、エージェントを切り替えながら、真ん中のチャットエリアで指示を出し、右側で確認などを行うという流れで作業を行います。ここでは、早速簡単なものを作成しながら、確認をしていきましょう。
チャットをしよう
エージェントウィンドウでは、AIの各モデルとチャットをすることができます。左側のパネルで「チャット」の右側の「+」ボタンをクリックしましょう。

標準では、Copilotとチャットをすることができます。Proバージョン以降の有償バージョンでは、Claudeなどともチャットをすることができます。

新しいセッションを開始しよう
それでは、エージェントをウィンドウで実際に開発作業を始めていきましょう。画面左上の「新規」ボタンをクリックし、新しい「セッション」を開始します。

先と同じようなチャット欄が表示されますが、その上に、「プロジェクトフォルダ」の設定欄が表示されます。

ここで、作業をするフォルダを指定します。クリックして「選択」メニューをクリックしましょう。

フォルダ選択画面が表示されるので、デスクトップなどの分かりやすい場所に、新しいフォルダを作成して「hello-app」などとして保存しましょう。このフォルダを開きます。

これで準備完了です。
最初のファイルを作成しよう
それでは、エージェントに作業を依頼してみましょう。ここでは、次のようなプロンプトを入力します。
Helloと表示するindex.htmlを作ってください

右下のマイクボタンで、音声入力もできます。入力できたら送信しましょう。
すると、画面左側にエージェントが一覧され、真ん中のチャットエリアで作業の様子を確認できます。

完成したファイルを確認しよう
それでは、作業結果を確認してみましょう。右側のパネルを表示します。表示されていない場合は、右上のボタンで切り替えましょう。

画面上部に「ファイル」というタブが表示されていたら、これをクリックします。

表示されていない場合は、「+」ボタンで表示しましょう。すると、フォルダの中のファイル群を確認できます。ここでは、「index.html」というファイルができあがっていることが確認できます。

ファイル名をクリックすると、Webブラウザに切り替わって内容が表示されます。

画面の上部にタブが増えているので、ここで改めてファイルに切り替えて、今度はファイル名を右クリックして「ファイルを開くアプリケーションを選択→テキストエディター」をクリックしましょう。

左側にエディターが開いて内容を確認できます。

このように、エージェントウィンドウは1つのウィンドウの中で、さまざまな機能を組み合わせて開発を進めることができます。
内蔵ブラウザを利用しよう
先の通り、VSCodeには簡易的なWebブラウザが搭載されています。このブラウザ、単に表示を確認するだけではなく、AIに指示を出すために利用する事ができます。
上部の「チャットに追加」ボタンのドロップダウンをクリックし、「Comment on Elements」をクリックしましょう。

この状態で、ブラウザ上でカーソルを動かすと、重なっている箇所のHTMLの要素が表示されます。

そのままクリックすると、コメント欄が表示されるので変更したい内容などを場所を指定して入力できます。

確定すると、チャット欄に内容と要素の場所が渡されます。これを「コンテキスト」といい、AIはここで渡された要素を参照しながら、どこを書き換えるべきかを判断できるという訳です。

エディタで要素を指定しよう
ブラウザと同様に、エディタでも要素を指定することができます。
各行の左端に、コメントを追加するボタンが表示されます。

また、文字列を選択してもコメント欄が表示されます。こうして、ピンポイントにフィードバックを追加することができます。

エディタでのコメントは、まとめて送信することができるので、コメントをすべて追加したら、右上の「フィードバックの送信」ボタンをクリックします。

チャットを連続して投げよう
チャットで依頼をすると、しばらく作業に時間がかかりますが、次の依頼をしたいときは、終わるまで待っておく必要はありません。作業中に、次の依頼を入力すると、順番待ち「キュー」に蓄積され、順次作業行われます。

チェックポイントと復元
依頼を投げると、その都度「チェックポイント」が設けられます。もし、間違えて依頼をしてしまったときや、作業の結果が思ったもではなかった場合、チャックポイントまで作業内容を戻すことができます。

また、送信済みのチャットメッセージをクリックすると、内容を変更して再送信することもできます。

間違えて依頼してしまった場合などは、一度チェックポイントを復元して、改めて依頼すると良いでしょう。
Next.jsでタスク管理ツールを作成しよう
続いて、別のプロジェクトを作成してみましょう。左上の「新規」ボタンをクリックしてセッションを開始したら、フォルダを「選択」して、新しいフォルダを選択します。
ここでは、デスクトップなどに「todo-app」といったフォルダを作成しましょう。

計画モードを利用しよう
大きなプログラムを作成する場合、いきなり開発し始めると、AIが勘違いをして全然違うプログラムが生成されてしまう場合があります。そこで、「計画モード」を使って、先にAIがやろうとしている作業を確認してから始めると良いでしょう。
チャット欄下の「対話型」または「オートパイロット」などと書かれている初箇所をクリックし、「計画」に切り替えます。

これによって、VSCodeは作業をする前に「計画」を立てて、それを確認してから作業を開始することができます。
チャット欄に次のように入力しましょう。
Next.jsでタスク管理ツールを作成してください

なおこの時、できるだけ賢いAIに考えてもらった方が、より良い計画を作ってくれます。チャット欄下の「Auto」の部分をクリックしましょう。Pro以上の場合は、ここでAIモデルを切り替えることができます。

また、その隣の「Balance(バランス型)」をクリックすると、他に「Efficiency(効率重視)」と「Intelligence(知能重視)」から選ぶことができます。しっかり考えて欲しい場合は「Intelligence」に切り替えると良いですが、使い過ぎるとすぐに利用可能量を超えてしまうので、バランスを考えて利用しましょう。

ここではどちらも標準のままで良いでしょう。
計画がスタートすると、何か質問をされることがあります。選択肢をクリックできるので、希望のものをクリックするか、チャット欄に番号を入力しましょう。迷った場合は、最初の選択肢が「推奨(Recommended)」となっているので、これを選んでおけば良いでしょう。

計画が終わると、「plan.md」というファイルが生成されます。右上の「Open Full Paln」をクリックしましょう。右パネルで内容が確認できます。

ここで内容を確認し、問題がないかをあらかじめ確認しておきましょう。問題がある場合は、フィードバック欄が表示されるので、気になる点を指摘して、計画を訂正してもらいます。例えばここでは、次のように入力しましょう。
タイトルをMy Tasksにしてください
計画が書き換わることが確認できます。

なお、右上のボタンで編集モードに切り替えることもできます。

計画に問題がなくなったら「計画を実装」ボタンをクリックしましょう。

途中、さまざまな許可の確認が表示されますが、問題なければ許可をしていきましょう。
作業が終わると、自動的に開発サーバーを起動したり、ブラウザを起動したりします。
開発サーバーを起動しよう
フレームワークなどを使って開発した場合、簡単には表示を確認できません。開発用のサーバーを起動して確認します。
画面右上のボタンで下パネルを表示しましょう。

画面下に「ターミナル」が起動します。次のようなコマンドを入力します。
npm run devすると、開発サーバーが起動してアドレスが発行されます。このアドレスにマウスカーソルを重ねると、「リンクにアクセス」が表示されるので、これをクリックするとブラウザが起動します。

動作や表示を確認し、気になる点があれば指示を出して修正しましょう。

Runボタンを機能させよう
ターミナルを起動して、毎回コマンドを入力するのが面倒な場合、画面上部に「Run」ボタンがあるので、これをクリックすることで、起動できるようにすると便利でしょう。

ドロップダウンを表示し、「新しいタスクの生成」をクリックします。すると、Copilotが現在のプロジェクトに最適な起動コマンドを自動的に生成してくれます。
現在のプロジェクトの場合は、Next.jsなので「npm run dev」が起動コマンドとなります。これをAIが確認し、設定ファイル(tasks.json)を生成します。

作業が終わったらRunボタンをクリックしましょう。

開発サーバーが起動します。もしこの時、正しく起動しない場合は、ドロップダウンを表示して、起動用のコマンドを探してクリックしましょう。
開発サーバーを終了しよう
ここで起動した開発サーバーは、ターミナル上で新しいセッションとして開始されています。右側の一覧を確認しましょう。終了する場合は、ゴミ箱のアイコンをクリックして、ターミナルごと終了させます。

バグを発生させよう
AIの作成したプログラムを動作確認していると、正しく動作しなかったり、エラーメッセージが表示されることがあります。そんな時は、デバッグ作業を依頼しましょう。
ここでは、正常に動作している場合もバグを再現するために、あえてソースコードを壊してみましょう。右パネルの、画面上部のタブで「ファイル」を選んで「app/page.tsx」ファイルなどを開きます。先頭の数文字を削除してみましょう。

ここでは、3行目の「import」の先頭を削除して「port」としました。ブラウザに切り替えると、図のように画面が正常に表示されなくなります。

このような場合、エージェントにエラーの内容を伝えて調査をしてもらいましょう。やり方はいくつかありますが、例えばNext.jsの場合、エラーメッセージの右上にコピーボタンが表示されます。これをクリックして、チャット欄に貼り付けるとエラーの内容を伝えることができます。

また、ターミナル上にも同様のエラーメッセージが表示されます。これを選択して右クリックすると「チャットに追加」といったメニューが表示されるので、これをクリックすることでもエラーメッセージを送信することができます。

もし、エラーメッセージなどが表示されていない場合は、ブラウザの表示内容をAIと共有することができます。上部の、「エージェントと共有」ボタンをクリックしましょう。

このまま、「画面にエラーが表示されています」など送信することでも、状況を伝えることができます。
チャットを切り替えよう
なおこの時、ずっと同じチャット欄でチャットを続けていると、会話の内容が混ざってしまって、正しく指示が伝わらなくなることがあります。そのため、同じプロジェクトであっても、別の依頼をするときはチャットを切り替えると良いでしょう。左側のパネルで、プロジェクト名にマウスカーソルを重ねると、右側に「+」のボタンが表示されるので、これをクリックしましょう。

新しいチャットを起動することができます。こうして、エラーを修正してもらいましょう。

セッションの整理
こうして、エージェントウィンドウで開発を進めていくと、左側の履歴にどんどん追加されていきます。これを切り替えながら、作業を進めていくことになります。
セッションのピン留め
各セッションには「ピン留め」のアイコンが表示されます。

これをクリックすると、左側のバーの一番先頭に表示されます。これはプロジェクトを横断してまとめておけるので、今作業をしているセッションなどはここに集めることができます。

また、作業が完了したセッションは「完了」にすることができます。各セッション右端のアイコンをクリックしましょう。
