---
title: "VS Codeのエージェントウィンドウの使い方｜開き方・ハーネス・Worktreeと1.120からの変化"
url: "https://www.issoh.co.jp/tech/details/12132/"
published: 2026-05-18
updated: 2026-11-02
categories: ["AIエージェント・MCP"]
publisher: "株式会社一創"
---

# VS Codeのエージェントウィンドウの使い方｜開き方・ハーネス・Worktreeと1.120からの変化

VS Codeのエージェントウィンドウ（英語表記はAgents window）は、AIエージェントのセッションを複数のプロジェクトにまたがって動かし、結果をレビューするための専用ウィンドウです。2026年5月13日公開のVS Code 1.120でStableにプレビューとして入り、その後もほぼ毎週機能が増えています。

この記事は、2026年10月28日公開の1.144に合わせて更新された[公式ドキュメント「Use the Agents window」](https://code.visualstudio.com/docs/agents/run/agents-window)をもとに、開き方・ハーネスの選び方・Worktree隔離の注意点を整理します。後半では、登場した1.120で一緒に入ったターミナル出力の圧縮とMarkdown差分プレビューも扱います。VS Code自体の現在の版と更新方法は、[VS Codeの最新バージョンと確認方法の解説](/tech/details/11318/)を参照してください。

## まとめ：エージェントウィンドウの要点

- 日本語表示のVS Codeでは、タイトルバーの **エージェントで開く** ボタンか、コマンドパレットの **エージェント ウィンドウを開く** で起動します。ターミナルなら `code --agents` です。
- 1.120（2026年5月13日）でStableにプレビュー提供され、1.140（2026年9月30日）の公開に合わせて公式ドキュメントから「Preview」の表記が外れました。リリースノートに正式提供の告知はありません。
- 新しいセッションの既定は、1.143からCopilotハーネスです。Claude・Codex・クラウド実行も選べますが、Localハーネスのセッションはメインウィンドウでしか動きません。
- New Worktreeを選ぶと変更は作業中のフォルダーから分かれますが、承認レベルはAllow allに固定され、コマンドやネットワークは制限されません。コマンドを確認しながら進めたい作業ではFolderを選びます。
- 単一リポジトリで1つのタスクを進めるだけなら、従来のChatビューで足ります。エージェントウィンドウが向くのは、複数のタスクやプロジェクトを並行して動かす作業です。

## エージェントウィンドウとChatビューの違い

VS Codeのエディター配置は「1つのタスクに1つのワークスペース」を前提に作られていました。1.120のリリースノートはこれを課題に挙げ、エージェントウィンドウをエディターの代わりではなく横に置く「companion（相棒）」と位置づけています。エージェントに任せた複数の作業を見比べ、やり直させ、レビューする場所です。

| 比較項目         | Chatビュー             | エージェントウィンドウ      |
| ------------ | ------------------- | ---------------- |
| 作業するフォルダー    | 開いているワークスペースのみ      | セッションごとに選ぶ       |
| Worktree隔離   | なし                  | New Worktreeを選べる |
| セッション一覧      | Sessionsビュー         | 全ワークスペースを横断      |
| Localハーネス    | 使える                 | 使えない             |
| 複数セッションの同時表示 | チャットのエディタータブを並べる    | グリッド表示           |
| ブラウザからの利用    | GitHub Codespacesなど | Insiders版のWeb    |

画面は、セッション一覧、カスタマイズ（エージェント・スキル・MCPサーバーなどの設定）、チャット領域、Changesパネル、Filesパネルの5つの領域でできています。Changesパネルの表示はアクティブなセッションに追従し、ブランチ全体の変更・未コミットの変更・直前のターンの変更を切り替えて確認できます。

2つの画面は行き来できます。エディターでデバッグしたくなったらセッションのタイトルバーの **Open in Editor** を選び、戻るときはタイトルバーのボタンからエージェントウィンドウを開いて同じセッションを選びます。

## エージェントウィンドウの開き方と必要なアカウント

### エージェントウィンドウを開く6つの方法

日本語の表記は、VS Codeの[日本語言語パックの翻訳ファイル](https://github.com/microsoft/vscode-loc)で確認したものです。

| 方法              | 英語表示                          | 日本語表示                   |
| --------------- | ----------------------------- | ----------------------- |
| タイトルバーのボタン      | Open in Agents                | エージェントで開く               |
| コマンドパレット        | Chat: Open Agents Window      | エージェント ウィンドウを開く         |
| ウェルカムページ        | Try out the new Agents Window | 新しいエージェント ウィンドウをお試しください |
| ターミナル           | code –agents                  | 同じ                      |
| Windowsのジャンプリスト | Agents Window                 | –                       |
| ブラウザ            | insiders.vscode.dev/agents    | –                       |

タイトルバーのボタンは、右クリックの **Hide ‘Open in Agents’** で隠せます。表示を制御する設定は `chat.titleBar.openInAgentsWindow.enabled` です。隠してもコマンドパレットとターミナルからは開けます。ボタンが見当たらないときは、まずVS Codeの版が1.120以降かを確認してください。

### 必要なアカウントとGitHub未サインインでの起動

既定では、エージェントウィンドウはGitHubの認証を求め、Copilotのサブスクリプションとセッションに紐づきます。VS CodeですでにGitHubにサインインしていれば、そのまま使えます。GitHubアカウントが無くても、デスクトップ版なら次のいずれかがあれば開けます（Experimental）。

- APIキーなどで設定したClaude（Anthropicのキーは環境変数 `ANTHROPIC_API_KEY` か `~/.claude/settings.json` の `env` に置く）
- ChatGPTにサインインしたCodex（`chat.agentHost.codexAgent.enabled` を有効にする）
- VS Codeに登録したBYOKモデル（`chat.agentHost.byokModels.enabled` を有効にする）

そのうえで、ウィンドウを開く前に `chat.agentHost.allowSignedOutWhenUsable` を有効にします。この設定は既定でオフです。ブラウザ版のエージェントウィンドウは、この方法に関係なく常にGitHubのサインインが必要です。

組織のCopilot管理設定が適用されている環境では、ClaudeとCodexのハーネスは個別の認証情報を持っていても無効になります。会社のPCでClaudeが選べないときは、まず管理者に設定を確認してください。

## エージェントのセッションを始める手順

1. サイドバー上部の **New** を選ぶ。特定のワークスペースで始めるなら、セッション一覧でワークスペースにカーソルを合わせて **+** を選ぶ。
2. **Folder** か **Repository** で、エージェントが作業するフォルダーを選ぶ。最初に選んだものが変更先になる。
3. 必要なら追加の文脈を付ける。別のフォルダーやリポジトリ、GitHubのIssueやプルリクエストを添付でき、IssueのURLをプロンプトに貼るだけでも添付される。
4. ハーネス、モデル、承認レベル、隔離方式を選ぶ。
5. プロンプトを入力してEnterで送信する。Alt+Enterで送ると、今のセッションを離れずに裏で新しいセッションを始められる。

### ハーネスと実行先の選び方（Copilot・Local・Claude・Codex・Cloud）

ハーネスは、エージェントを動かす実行基盤のことです。モデルの選択とは別物で、Copilotハーネスの中でClaudeのモデルを選んでもハーネスはCopilotのままです。[ハーネスの公式ドキュメント](https://code.visualstudio.com/docs/agents/run/agent-harnesses)では、Copilot・Local・Claude・Codexの4種類と、クラウド実行先のCloudを比較しています。Cloudは独立したハーネスではなく、Copilotハーネスの実行先です。

| ハーネス・実行先 | 実体                         | エージェントウィンドウ    |
| -------- | -------------------------- | -------------- |
| Copilot  | Copilot SDK・Agent Host     | 使える（1.143から既定） |
| Local    | VS Code組み込み                | 使えない           |
| Claude   | Claude Agent SDK           | 使える            |
| Codex    | Agent Host連携（Experimental） | 設定を有効にすると使える   |
| Cloud    | Copilotハーネスをクラウドで実行        | GitHubのリポジトリのみ |

Copilotハーネスのセッションは、エディターのウィンドウを閉じてもAgent Hostというプロセスの上で動き続けます。ただし、自分のPCで動かしている場合はVS Codeのアプリ自体を終了させないでください。ClaudeはCopilotのサブスクリプション経由でも、自分のAPIキーでも使え、どちらで課金されるかは選んだモデルで決まります。Codexは既定では一覧に出ず、`chat.agentHost.codexAgent.enabled` を有効にしたときに選べるようになります。OpenAIの拡張機能経由のCodexセッションはメインウィンドウでしか動きません。

迷ったらCopilotハーネスで始めて構いません。Claude Codeの設定（`CLAUDE.md` など）をそのまま使いたいときにClaudeを選びます。VS CodeでClaude Codeを使う方法は[Claude Code for VS Codeの使い方](/tech/details/10685/)で解説しています。

## セッションの隔離方式とWorktreeの注意点

セッションを始めるときは、変更を今のフォルダーに直接書くか、新しい[Git worktree](/tech/details/10306/)に書くかを選びます。この選択肢があるのはエージェントウィンドウだけで、Chatビューから始めたセッションは常に今のワークスペースで作業します。

| 隔離方式         | 向く作業      | 承認レベル       | 未コミットの変更 |
| ------------ | --------- | ----------- | -------- |
| New Worktree | 並行タスク     | Allow all固定 | 引き継がない   |
| Folder       | 小さな対話的タスク | 手動承認も選べる    | そのまま使う   |

判断を分けるのは承認レベルの列です。Worktreeのセッションは承認がAllow allに固定され、確認のプロンプトは出ません。公式ドキュメントも、worktreeは変更の置き場所を分けるだけで、コマンドの実行、ネットワークアクセス、worktree外のファイルへのアクセスは制限しないと書いています。1.144で正式提供になったAssisted permissions（LLMがツール呼び出しのリスクを判定し、低リスクだけ自動承認する方式）も、使えるのはFolderのときだけです。本番の認証情報がシェルに通っている端末では、Worktreeのセッションを放置しないでください。OSレベルでファイルやネットワークを制限したい場合は、エージェントのサンドボックス機能を別に設定します。

通常のNew Worktreeによる隔離には、少なくとも1つのコミットがあるGitリポジトリが必要です。新しいworktreeに入るのは、選択したベースブランチのコミット済みファイルです。未コミットの変更、未追跡ファイル、`.env` のようなGitの無視対象ファイル、インストール済みの依存関係は入りません。無視対象のファイルを持ち込むには `git.worktreeIncludeFiles` でコピー対象を指定し、`node_modules` のような大きなフォルダーは `git.worktreeSymlinkFolders`（Experimental）でシンボリックリンクにできます。リンク経由の変更は元のフォルダーにも及ぶ点に注意してください。

Dev Containerで動かすセッションはコンテナ内で直接作業するため、New Worktreeと組み合わせられません。不要になったworktreeは、1.141以降のクリーンアップ提案（`chat.agentSessions.sessionStorageCleanupSuggestion.enabled`）で片付けられます。

## 複数セッションの並行作業（グリッド・モデル比較・自動化）

### 複数セッションのグリッド配置

1.141から、セッションを縦横のグリッドに並べて同時に監視できます。Alt（macOSはOption）を押しながら **New** を選ぶと、今のセッションを残したまま新しいセッションを横に開けます。セッション一覧から表示領域へドラッグするか、右クリックの **Open to the Side** を使ってもかまいません。Files・Changes・Terminalの各パネルが対象にするのは、選択中の1つのセッションだけです。

セッションを分けても、ファイルまでは分かれません。同じフォルダーを使う2つのセッションは同じファイルを編集できてしまうので、同じリポジトリで並行して実装させるならNew Worktreeを選びます。

### 同一タスクでのモデル・ハーネス比較

1.143でプレビューとして入ったモデル比較は、同じプロンプトを複数のモデルやハーネスに並行して投げ、結果を見比べる機能です。Copilot・Claude・Codexのハーネスを混ぜ、推論レベルを変えて比べられます。リポジトリでの比較はそれぞれ別のworktreeで動き、Judgeに評価させて案を統合させることもできます。1.144からは、対象となる新しいセッションで既定で有効です（設定は `sessions.chat.compareAgents.enabled`）。

### Automationsによる定期実行とクラウド実行

サイドバーの **Automations** から、保存したプロンプトと設定でエージェントのタスクを定期実行できます。ローカルの自動化は自分のPCで動き、クラウドの自動化（1.144時点でPreview）はGitHub上で、スケジュールやIssue・プルリクエストのイベントをきっかけに動きます。PCの電源が切れていても実行されます。公式ドキュメントは、まず手動で1回実行してセッションを確認してから定期実行を有効にする手順を勧めています。

## エージェントウィンドウで拡張機能を使う設定

エージェントウィンドウでは、インストール済みの拡張機能がすべて動くわけではありません。テーマ、文法定義、言語定義、キーバインドのように静的な内容だけを提供する拡張機能は自動で有効になります。対応を宣言した拡張機能も既定で有効です。それ以外は、次の2つの方法で個別に有効にします。

- **管理画面から切り替える（1.144から・Experimental）**：`extensions.experimental.agentsWindowManagement` を有効にし、エージェントウィンドウのサイドバーで **Customizations** を開いて **Extensions** を選ぶ。拡張機能ごとにオン・オフでき、一覧は「AI Features」「Supported」「Other Extensions」に分かれる。
- **設定で拡張機能IDを指定する（1.120から）**：ユーザー設定の `settings.json` の最上位オブジェクト内に次の設定を追加する。`myextension.id` は対象の拡張機能IDに置き換え、既存の設定項目との間はカンマで区切る。

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

`true` にすると対応を宣言していない拡張機能も有効になり、`false` にすると対応済みの拡張機能でも無効になります。変更後はエージェントウィンドウの再読み込みが必要です。この設定はエディターのウィンドウには影響しません。

どちらの方法でも、拡張機能はVS Codeの**既定プロファイル**にインストールされている必要があります。作業用に別のプロファイルを分けている場合、そちらに入れた拡張機能は許可しても動きません。エディターのビューやデバッグに依存する拡張機能は、有効にしても期待どおりに動かないことがあると公式ドキュメントも注意しています。

## VS Code 1.120で入ったその他の変更

エージェントウィンドウが登場した1.120では、周辺にも次の変更が入りました（[1.120のリリースノート](https://code.visualstudio.com/updates/v1%5F120)より）。

| 領域       | 変更                        | 設定・操作                                |
| -------- | ------------------------- | ------------------------------------ |
| 言語モデル    | BYOKのトークン使用量表示            | Chatビューのコンテキスト表示                     |
| 言語モデル    | BYOK推論モデルのthinking effort | モデルピッカー                              |
| チャット     | ターミナル出力の圧縮                | chat.tools.compressOutput.enabled    |
| チャット     | コマンドのリスク評価                | chat.tools.riskAssessment.enabled    |
| チャット     | プランのインライン編集               | chat.planWidget.inlineEditor.enabled |
| Markdown | 差分のプレビュー表示                | workbench.diffEditorAssociations     |
| Markdown | プレビューの既定値変更               | 2設定がオフへ                              |

### ターミナル出力の圧縮（chat.tools.compressOutput.enabled）

`git diff`、`ls -l`、`npm install` のような長い出力は、モデルのコンテキストを大きく消費します。`chat.tools.compressOutput.enabled` を有効にすると、VS Codeが出力を短くしてからモデルに渡します。1.120ではプレビュー機能で、設定を有効にしたときだけ動きます。

| コマンド        | 圧縮の内容                  |
| ----------- | ---------------------- |
| git diff    | 変更のない大きな塊を折りたたむ        |
| git diff    | ロックファイルとスナップショットの差分を除く |
| ls -l       | エントリ名だけにする             |
| npm install | 進捗バー・非推奨警告・監査の要約を除く    |

圧縮した出力の先頭には短いバナーが付き、どのフィルターが働いたかと、生の出力が必要なときの無効化の方法がモデルに伝わります。翌週の1.121では対象が広がり、テストランナー、ビルドツール、リンター、Dockerコマンド、パッケージマネージャーの出力も圧縮されるようになりました。

依存関係を更新する作業では、この設定をオフにしてください。圧縮されたgit diffではロックファイルの差分がモデルに渡らず、依存関係の変更を見落とすおそれがあります。

### Markdown差分のプレビュー表示と既定値の変更

ソース管理ビューからMarkdownファイルの差分を開いたとき、生のソースではなくレンダリングしたプレビューで比べられるようになりました。差分エディターで **Reopen Editor With…** を選び、Markdownプレビューの差分表示に切り替えます。常にこの表示で開くなら、`settings.json` に次の関連付けを追加します。

```
"workbench.diffEditorAssociations": {
  "*.md": "vscode.markdown.preview.editor"
}
```

リリースノートは、エージェントやプルリクエストが書き換えたドキュメントのレビューを想定用途に挙げています。エージェントウィンドウ内で `.md` ファイルを開いたときにMarkdown EditorとMarkdown Previewのどちらを使うかは、`workbench.editor.markdownDefaultEditorInAgentsWindow` で切り替えられます。

同じ1.120で、組み込みMarkdownプレビューの `markdown.preview.doubleClickToSwitchToEditor`（ダブルクリックでソースの編集に戻る）と `markdown.preview.markEditorSelection`（エディターの選択行をプレビューに示す）が既定でオフになりました。「プレビューをダブルクリックしても編集に戻らない」と感じたら、この変更が原因です。設定をオンに戻せば以前の動作になります。Markdownの編集・プレビュー用の拡張機能は[Markdown Live Editorの使い方と注意点](/tech/details/11645/)で比較しています。

## 1.120以降のエージェントウィンドウの変化（1.121〜1.144）

1.120の情報だけで使い方を判断すると、今の仕様とずれます。主な変化を各版のリリースノートから拾いました。

| 版     | リリース日      | 主な変化                              |
| ----- | ---------- | --------------------------------- |
| 1.121 | 2026-05-20 | SSH・Dev Tunnels経由のリモート実行（Preview） |
| 1.123 | 2026-06-03 | 複数セッションの同時表示                      |
| 1.128 | 2026-07-08 | ワークスペースなしのチャット                    |
| 1.130 | 2026-07-22 | ClaudeとCodexもworktree隔離に対応        |
| 1.133 | 2026-08-12 | GitHub未サインインで開く（Experimental）     |
| 1.136 | 2026-09-02 | Agent Merge（Preview）              |
| 1.139 | 2026-09-23 | リモートホスト上のDev Containerで実行         |
| 1.140 | 2026-09-30 | 公式ドキュメントからPreview表記を削除            |
| 1.141 | 2026-10-07 | グリッド表示・ChatGPTアプリのCodex会話を継続      |
| 1.142 | 2026-10-14 | 会話を別フォルダーや新しいworktreeへ移す          |
| 1.143 | 2026-10-22 | Copilotハーネスが既定・モデル比較（Preview）     |
| 1.144 | 2026-10-28 | 拡張機能の管理画面・クラウド自動化（Preview）        |

Preview表記の削除は、[公式ドキュメントのリポジトリ](https://github.com/microsoft/vscode-docs/commit/8889b0542cb2144fb53f5f53bd19c1395e2d9fa1)で確認できます。2026年9月24日の版まであった見出しの「(Preview)」と「currently in preview」の注記が、1.140の公開に合わせた更新で消えています。ただし、Claude・Codexの未サインイン利用、拡張機能の管理画面、クラウド自動化など、ウィンドウ内の個別機能にはExperimentalやPreviewのものが残っています。1.120より前の版の変更は、[VS Code 1.118の新機能](/tech/details/12043/)で扱っています。

## エージェントウィンドウの採用を避ける条件

次の条件では、Chatビューへの切り替え、Folderでの手動承認、または実行環境の見直しが必要です。画面を切り替えるだけで、承認設定やクラウド実行先の制約が解消されるわけではありません。

- **コマンドを1つずつ承認したい作業**：Worktreeのセッションは承認がAllow all固定です。本番環境に触れるスクリプトや認証情報を扱うなら、Folderで手動承認にするか、Chatビューを使います。
- **Localハーネスで組んだ設定に依存する作業**：Localハーネスのセッションはエージェントウィンドウで動きません。Copilotハーネスでは、組み込みツールや拡張機能が提供するツールの一部が使えない点も公式ドキュメントに書かれています。
- **マルチルートのワークスペース**：エージェントウィンドウはマルチルートのセッションにまだ対応していません。
- **GitHub以外でホストするリポジトリのクラウド実行**：Copilot Cloudのセッションは、GitHubのリポジトリでしか使えません。
- **既定プロファイル以外の拡張機能に依存する作業**：エージェントウィンドウで有効にできるのは、既定プロファイルに入った拡張機能だけです。

単一リポジトリで1つのタスクを進めるだけなら、エージェントウィンドウに移る必要はありません。Chatビューでの使い方は[GitHub Copilotエージェントモードの使い方](/tech/details/6733/)で解説しています。エージェントを社内の業務フローに組み込む設計から相談したい場合は、[AIエージェント開発の支援](/service/ai/agent/)も行っています。

## よくある質問

### VS Codeのエージェントウィンドウはどこから開きますか？

タイトルバーの「エージェントで開く」（英語表示はOpen in Agents）ボタンか、コマンドパレットの「エージェント ウィンドウを開く」から開けます。ターミナルで `code --agents` を実行する方法もあります。ボタンが見当たらない場合は、VS Codeが1.120以降かと、`chat.titleBar.openInAgentsWindow.enabled` がオフになっていないかを確認してください。

### 「エージェントで開く」ボタンを押すと何が起きますか？

今のワークスペースを対象に、エディターとは別のエージェントウィンドウが開きます。エディターのウィンドウはそのまま残り、同じ設定とキーバインドを共有します。不要なら右クリックで「Hide ‘Open in Agents’」を選ぶと隠せます。

### エージェントウィンドウはまだプレビューですか？

ウィンドウ自体は、1.140（2026年9月30日）の公開に合わせて公式ドキュメントからPreviewの表記が外れました。リリースノートに正式提供の告知は無く、モデル比較やクラウド自動化などの個別機能にはPreviewやExperimentalのものが残っています。

### GitHubにサインインせずに使えますか？

デスクトップ版なら、Experimentalの機能として使えます。APIキーで設定したClaude、ChatGPTにサインインしたCodex、登録済みのBYOKモデルのいずれかを用意し、`chat.agentHost.allowSignedOutWhenUsable` を有効にしてから開きます。ブラウザ版は常にGitHubのサインインが必要です。

### chat.tools.compressOutput.enabledを有効にすると何が変わりますか？

エージェントが実行したターミナルコマンドの長い出力を、モデルに渡す前に短くします。`git diff` の変更のない塊の折りたたみ、ロックファイル差分の除外、`npm install` の進捗表示の削除などです。1.120ではプレビュー機能で、設定を有効にしたときだけ動きます。

## 関連記事

- [VS Codeの最新バージョンは1.142｜確認方法・アップデート手順と版の履歴【2026年10月】](/tech/details/11318/)
- [GitHub Copilotエージェントモードの使い方｜Ask・Plan・Agentの違いとクラウド統合・料金【2026年11月】](/tech/details/6733/)
- [Claude Code for VS Codeの使い方｜導入・設定とVisual Studio 2022・C#で使う方法](/tech/details/10685/)
- [Git worktreeの使い方｜Sourcetree・Fork・VS Code対応とwtp（worktree plus）・move・並行開発の手順](/tech/details/10306/)
- [VS Code 1.118の新機能｜codebase semantic indexが使えない原因・devcontainer-lock.json・Copilot設定の変更点](/tech/details/12043/)

---

出典: [VS Codeのエージェントウィンドウの使い方｜開き方・ハーネス・Worktreeと1.120からの変化](<https://www.issoh.co.jp/tech/details/12132/>)（株式会社一創）