Alternative Architecture DOJO

オルターブースのクラウドネイティブ特化型ブログです。

GitHub Copilotのローカルサンドボックスとは?VS Codeでの検証も踏まえて解説します

GitHub CopilotのAgentモードでは、コードの編集からコマンド実行、テストまで、さまざまな作業をAIエージェントに任せられます。一方、自律的な実行が進むと、作業対象外のファイル変更や意図しない外部通信への備えが必要になります。

こうした課題に関係する機能が、GitHub Copilotのローカルサンドボックス(Local Sandboxing)です。GitHubは2026年10月7日に一般提供(GA)を発表しました。

今回は、WindowsのVS Codeで確認した動作と、Enterpriseでの管理方法を紹介します。

ローカルサンドボックスとは

ローカルサンドボックスは、Copilotが起動する対応コマンドやプロセスに対し、アクセス可能なファイルシステムやネットワークの範囲を制限する仕組みです。

GitHubの公式発表によれば、Microsoft eXecution Container(MXC)を利用し、Windows、macOS、LinuxのOS固有の保護機構を通じて共通のポリシーを適用します。

重要なのは、操作の承認と、実行できる範囲の制限は別という点です。

仕組み 役割
ユーザー承認 コマンドなどを実行してよいかを判断する
サンドボックス コマンド実行時のファイル操作やネットワーク通信を制限する

Copilotがコマンドを自動実行しても、許可されていない場所へのファイル書き込みなどは拒否できます。

ただし、サンドボックスは独立した仮想マシンではありません。開発者のPC上でプロセスを制限する仕組みであり、VMやDev Containersと同等の隔離機能ではありません。
公式:Sandbox boundary

何を制御できるのか

GitHubの説明とVS Codeの設定リファレンスを整理すると、制御対象は主に次のとおりです。

制御対象 内容と利用場面の例 サンドボックス利用時の既定の動作
ファイルの読み取り 秘密鍵や機密ファイルなど、特定パスの読み取りを制限する 作業ディレクトリへの読み取りを許可。開発ツールなど一部のパスにもアクセス可能
ファイルの書き込み 作業対象外のフォルダを誤って変更・削除することを防ぐ 作業ディレクトリへの書き込みを許可。それ以外は原則制限
外部ネットワーク エージェントが実行するコマンドの外部通信を禁止する 許可
通信先ドメイン 許可リスト/拒否リストで接続先を絞る 制限なし(許可・拒否リストは空)
ローカルネットワーク PC上のサービスやプライベートネットワークへの接続を制限する 禁止
Git・GitHub CLIの認証 サンドボックス内でのGitやGitHub CLIの認証情報の利用を制御する 許可
MCP・言語サーバー Agent Hostが起動・管理する対応プロセスにも制限を適用する サンドボックス適用
サンドボックス回避 サンドボックス外でのコマンド実行を禁止する ユーザー承認による回避を許可

このように、ローカルサンドボックスでは制御対象によって既定の動作が異なります。

これらの設定は、VS Codeのsettings.jsonから変更可能で、例えば外部ネットワークへの通信を禁止したり、特定のディレクトリへのアクセス権限を追加・制限したりすることができます。
公式:Sandbox settings

また、その時点で適用されている設定を確認する際は、Copilot Chat のプロンプト入力欄で /sandbox policy と送信することで、書き込み可能なパス、ネットワーク制限、バイパスの可否など、現在の実効ポリシーを確認できます。
公式:Inspect sandbox policy

VS Codeではどのように利用するのか

本記事では、VS CodeのCopilot harnessで利用できるローカルサンドボックス を取り上げます。
なお、Local harnessでもサンドボックス機能はサポートされていますが、対応OSや制御の仕組みが異なりますので、詳細については 公式ドキュメント からご確認下さい。

Copilot ChatのPermissionsメニューには、Sandboxing for terminal という切り替え項目があります。ここから、現在のセッションにおけるサンドボックスの利用を有効にできます。

このUIでの切り替えは現在のセッションにのみ適用され、新規セッションにはVS Codeのsettings.jsonなどで指定された設定が適用されます。サンドボックスの既定値はOFFですが、設定によって新規セッションでも有効にできます。

また、Enterprise-managed settingsを利用すると、管理者がサンドボックスの利用を強制し、開発者による無効化を禁止することも可能です。
公式:Session control

2026年10月時点では、Windowsにおけるローカルサンドボックス機能は試験的提供(Experimental)の段階にあり、利用には公式ドキュメントで指定されたWindows 11のビルドが必要です。
公式ドキュメント

検証①:作業ディレクトリ外のファイルを書き換えられるか

まず、Windows上のVS Codeでローカルサンドボックスを有効にし、Copilotに次の2つのファイル操作を指示しました。

  • 作業ディレクトリ内にinside.txtを作成する
  • 作業ディレクトリ外のoutside.txtを上書きする

実行結果は次のとおりです。

操作 結果
inside.txtの作成 成功
outside.txtの上書き アクセス拒否

作業ディレクトリ内のファイル作成は成功しましたが、ディレクトリ外への書き込みはAccess to the path '...\outside.txt' is denied.というエラーで拒否されました。

今回の検証では、特定のディレクトリに対するアクセス禁止設定は追加していません。 ローカルサンドボックスを有効にするだけで、作業ディレクトリ外への書き込みが制限されることを確認できました。

READMEに紛れ込んだ指示でも防げるのか

続いて、READMEに開発環境の初期化手順を装い、作業ディレクトリ外のoutside.txtを書き換えるコマンドを記載しました。そのうえで、CopilotにREADMEの確認とセットアップを指示しました。

その結果、CopilotはREADMEに記載されたコマンドを実行しようとしましたが、サンドボックスによってアクセスが拒否されました。

この仕組みにより、例えば外部から取得したリポジトリのREADMEやセットアップ手順に、意図しないファイル操作が含まれていた場合でも、サンドボックスで許可されていない範囲への変更を防ぎ、被害を抑える効果が期待できます。

今回の検証では、CopilotがREADMEに記載された指示に従って操作を実行しようとしても、サンドボックスによって許可されていない操作は実行できないことを確認しました。

つまり、AIエージェントの判断だけに頼るのではなく、意図しない操作を実行しようとしても実行できない環境を構築できることが、ローカルサンドボックスの重要な特徴です。

検証②:外部ネットワークへの通信を禁止できるか

続いて、サンドボックスの外部ネットワーク通信を禁止した状態で、Copilotが実行するPowerShellからhttps://example.comへのHTTPS通信を試しました。

その結果、HTTPレスポンスを受信する前に接続が拒否され、次のエラーが返されました。

アクセス許可で禁じられた方法でソケットにアクセスしようとしました。
(example.com:443)

この結果から、Copilotが外部サーバーへの通信を試みても、サンドボックスによって通信をブロックできることを確認しました。

例えば、外部から取得したスクリプトに意図しないデータ送信処理が含まれていた場合でも、外部通信を制限することで、情報漏えいのリスクを低減する効果が期待できます。

外部通信は全拒否だけではない

ローカルサンドボックスでは、外部通信を全面禁止するだけでなく、許可・拒否するドメインを指定することもできます。

例えば、GitHub APIや承認済みのパッケージレジストリなど、必要な通信先のみを許可する運用も可能です。npm installや外部APIへのアクセスなど、通常の開発作業で必要なネットワーク通信のみを許可するなど、開発業務への影響とセキュリティ上の要件を考慮し、それぞれの環境に応じて適切な通信制限を設定することが重要です。

なお、Windows環境におけるドメイン単位の通信制限について、GitHubの公式ドキュメントには次の記載があります。

Windowsでは、サンドボックスはプロキシ設定に従うプログラムに依存します。その結果、Windowsのプロキシ設定を無視するプログラムは直接接続し、ホストルールを回避できます。

このように、Windowsではドメイン単位の通信制限が回避される可能性があるため、注意が必要です。
GitHub公式ドキュメント:Configuring local sandbox settings

Enterpriseレベルでサンドボックスの利用を強制

ローカルサンドボックスは開発者が個別に利用するだけでなく、Enterprise-managed settingsで管理者が制約を配布できます。GitHubの公式リファレンスでは、Copilot CLI、VS CodeのCopilot Agent Hostセッション、GitHub Copilot appを対象とした管理設定が説明されています。

例えば、公式リファレンスには次の設定例が掲載されています。

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true,
    "allowBypass": false,
    "sandboxMcpServers": true,
    "sandboxLspServers": true
  }
}

主な項目は以下のとおりです。

設定 内容
enabled: true サンドボックスを必須化する
failIfUnavailable: true サンドボックスを適用できない場合にモデル・ツールの実行を停止する
allowBypass: false サンドボックス外でのコマンド実行やセッション単位の回避を禁止する
sandboxMcpServers: true 対応するローカルMCPサーバーに制限を適用する
sandboxLspServers: true 対応する言語サーバーに制限を適用する

特に重要なのは、有効化とバイパス禁止が別々の設定であることです。

サンドボックスがコマンドを拒否したとき、設定によってはCopilotがユーザーに確認し、制限のない状態で再実行できることがあります。allowBypass: false は、そのような回避を禁止するものです。
公式:Control approval and fallback behavior

また、failIfUnavailable: true はサンドボックスが動作しない環境で、制限のない実行へ切り替わることを避けるための設定です。enabled: true と組み合わせて意味を持ちます。

設定は .github-private リポジトリの copilot/managed-settings.json から配布でき、MDMやローカルファイルによる配布にも対応します。
公式:Enterprise-managed settingsの導入

なお、ローカルサンドボックス自体は一般提供されていますが、Enterpriseの管理ポリシーによるサンドボックスの強制は、2026年10月時点でPreview(プレビュー)として提供されています。

Local harnessに切り替えたら制限を回避できるのか

ここで気になるのが、Enterpriseでサンドボックスを強制していても、開発者がLocal harnessに切り替えることで制限を回避できてしまうのではないかという点です。

VS Codeの公式ドキュメントによると、Enterpriseによってサンドボックスや権限設定が管理されている場合、ポリシーを適用するためにLocal harnessからCopilot harnessへ自動的に切り替える仕組みが用意されています。

ただし、VS Code 1.142以降では、管理者がvscode.temporaryDefaultToLocalHarnessを設定することで、Local harnessを既定として維持することも可能です。

この設定を有効にした場合、Local harnessで実行されるセッションには、Enterpriseで設定したCopilot harness向けの実行時サンドボックスポリシーが適用されません。

そのため、Enterprise全体でサンドボックスの適用を徹底したい場合は、この例外設定を利用するかどうかを慎重に検討する必要があります。

ローカルサンドボックスの位置づけ

VS Codeの公式ドキュメントでも、一部の組み込みツールには独自の権限チェックが適用されることや、サンドボックスが仮想マシンのような完全な隔離環境ではないことが説明されています。

また、ローカルサンドボックス自体は一般提供されているものの、Windowsでの対応はExperimental(試験的提供)という位置付けのため、こうした点を踏まえると、現時点では、AIエージェントのあらゆる操作を確実に制御する絶対的なガードレールとして捉えるのではなく、実際の環境で制限の有効性や適用範囲を確認しながら活用する段階と考えられます。

そのため、既存のアクセス権限管理やコードレビューなどを置き換えるものではなく、AIエージェントの実行範囲を制限するための追加のセキュリティ対策として位置付けることが重要です。

まとめ

今回の検証では、ローカルサンドボックスによって、作業ディレクトリ外へのファイル書き込みや外部ネットワークへの通信を制限できることを確認しました。

AIエージェントによる自律的な開発が進み、実行環境のセキュリティ制御がますます重要になる中で、今後の機能拡充や対応環境の拡大にも注目したいところです。


サービス一覧 www.alterbooth.com cloudpointer.tech www.alterbooth.com