{"meta":{"title":"ローカル サンドボックスの利用","intro":"ローカル サンドボックスを有効にして、 Copilot CLI がオペレーティング システム サンドボックス内でユーザーの代わりに呼び出すコマンドとツールを実行できるようにします。","product":"GitHub Copilot","breadcrumbs":[{"href":"/ja/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/ja/enterprise-cloud@latest/copilot/how-tos","title":"方法"},{"href":"/ja/enterprise-cloud@latest/copilot/how-tos/cloud-and-local-sandboxes","title":"サンドボックス Copilot"},{"href":"/ja/enterprise-cloud@latest/copilot/how-tos/cloud-and-local-sandboxes/using-local-sandboxing","title":"ローカル サンドボックスを使用する"}],"documentType":"article"},"body":"# ローカル サンドボックスの利用\n\nローカル サンドボックスを有効にして、 Copilot CLI がオペレーティング システム サンドボックス内でユーザーの代わりに呼び出すコマンドとツールを実行できるようにします。\n\n> \\[!NOTE]\n> GitHub Copilotのローカル サンドボックスはパブリック プレビューにあり、変更される可能性があります。\n\n> \\[!IMPORTANT]\n> Windowsでのローカル サンドボックスには、Windows Insider ビルドが必要です。\n\n## ローカル サンドボックスについて\n\nサンドボックスは現在、試験段階の機能です。 これを使用するには、Copilot CLI コマンド ライン オプションで`‑‑experimental`を開始するか、セッション中に`/experimental on`を入力します。\n\nローカル サンドボックスを有効にすると、 Copilot CLI は、オペレーティング システムサンドボックス内でユーザーに代わって呼び出されるほとんどのコマンドとツールを実行します。 ローカル サンドボックスを有効にすると、無効にするか、特定のセッションでオフにするまで、すべての Copilot CLI セッションに適用されます。 エンタープライズ管理設定でサンドボックス、通常の構成、 `--no-sandbox` コマンド ライン オプションが必要な場合、 `/sandbox disable` コマンドでは無効にできません。 ただし、有効なポリシーでサンドボックス バイパスが許可されている場合は、アクティブなバイパスアクセス許可プロンプトから、現在のセッションの残りの部分のサンドボックスを明示的に無効にすることができます。\n\n既定では、サンドボックス化されたコマンドとツールは、現在の作業ディレクトリと一時フォルダー内に書き込むことができます。 ユーザー プロファイル (ホーム) ディレクトリと、システムとツールの場所は読み取り専用です。 その他のディスクの場所はブロックされます。 Git リポジトリでは、現在の作業ディレクトリの上にある残りのリポジトリは読み取り可能ですが、書き込み可能ではありません。 送信インターネット アクセスと同様に、ローカルおよびプライベート ネットワークへのアクセスが許可されます。\n\n既定では、認証された Git と GitHub CLI (`gh`) の操作はサンドボックス内で引き続き機能します。これは、 Copilot CLI によって GitHub 資格情報がサンドボックス コマンドで使用できるようになるためです。 これにより、 `git push` や `gh pr create` などのアクションを成功させることができます。 サンドボックスの設定でこれをオフにすることができます。\n\nCopilot CLIのサンドボックスの概念の概要については、[クラウドサンドボックスとローカルサンドボックスについて GitHub Copilot](/ja/enterprise-cloud@latest/copilot/concepts/about-cloud-and-local-sandboxes) を参照してください。\n\n## サンドボックス コマンド\n\n`/sandbox`スラッシュ コマンドを使用して、Copilot CLI セッション内からローカル サンドボックスを管理します。 これには次のサブコマンドがあります。\n\n| 命令                                                                                                                                                                              | Description                                                                                                                                                                                                                                                   |\n| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `/sandbox status`                                                                                                                                                               | サンドボックスがセッションで現在使用されているかどうかを示します。                                                                                                                                                                                                                             |\n| [サンドボックスが使用されているかどうかを確認するを](#checking-whether-sandboxing-is-being-used)参照してください。                                                                                                |                                                                                                                                                                                                                                                               |\n| `/sandbox policy`                                                                                                                                                               | 現在のディレクトリの有効なファイルシステム ポリシー (読み取り可能、書き込み可能、またはブロックされているパス、ネットワーク アクセスの強制) を表示します。 詳細については、「[GitHub Copilot CLI のローカル サンドボックスに関するファイルシステム ポリシーを理解する](/ja/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/understanding-local-sandboxing)」を参照してください。 |\n| `/sandbox config`                                                                                                                                                               | 対話型設定インターフェイスを開きます。                                                                                                                                                                                                                                           |\n| `/sandbox`を単独で入力しても同じことが行います。 詳細については、「[ローカル サンドボックス設定の構成](/ja/enterprise-cloud@latest/copilot/how-tos/cloud-and-local-sandboxes/configuring-local-sandbox-settings)」を参照してください。 |                                                                                                                                                                                                                                                               |\n| `/sandbox enable`                                                                                                                                                               | ローカル サンドボックスを有効にします。                                                                                                                                                                                                                                          |\n| [「ローカル サンドボックスの有効化」を](#enabling-local-sandboxing)参照してください。                                                                                                                      |                                                                                                                                                                                                                                                               |\n| `/sandbox disable`                                                                                                                                                              | ローカル サンドボックスをオフにします。 エンタープライズ管理設定でサンドボックスが必要な場合、これは拒否されます。                                                                                                                                                                                                    |\n| [「ローカル サンドボックスの無効化」を](#disabling-local-sandboxing)参照してください。                                                                                                                     |                                                                                                                                                                                                                                                               |\n\n## ローカル サンドボックスの有効化\n\nローカル サンドボックスを有効にするには、対話型の Copilot CLI セッションで次のコマンドを入力します。\n\n```shell copy\n/sandbox enable\n```\n\nサンドボックスは、現在のセッションですぐに使用を開始します。\n\nローカル サンドボックスを有効にした後も、現在および将来の対話型セッションとプログラム セッションで引き続き使用されます。\n\n> \\[!NOTE]\n> `/sandbox enable`を入力したときに他のセッションを開いている場合、それらのセッションではサンドボックスはすぐには使用されません。 既に開いているセッションでサンドボックスを使用するには、そのセッションで次のいずれかの操作を行います。\n>\n> * たとえば、 `copilot --continue`を実行して、セッションを閉じて再起動します。\n> * 「`/sandbox enable`」と入力します。\n\n## ローカル サンドボックスの無効化\n\nエンタープライズ管理設定でサンドボックスが必要な場合、 `/sandbox disable` は拒否されます。 有効なポリシーでサンドボックスバイパスが許可されている場合は、代わりにアクティブなバイパスアクセス許可プロンプトから現在のセッションの残りの部分のサンドボックスを明示的に無効にすることができます。\n\nローカル サンドボックスの使用を停止するには、対話型の Copilot CLI セッションで次のコマンドを入力します。\n\n```shell copy\n/sandbox disable\n```\n\nサンドボックスは、現在のセッション、または新規および再起動されたセッションでは使用されなくなりました。\n\nローカル サンドボックスを使用するかどうかの選択は、CLI の個人用設定ファイルに `sandbox.enabled` 設定として保存されます (既定では`~/.copilot/settings.json` )。\n\n## 1 つのセッションにサンドボックスを使用する\n\n`--sandbox`コマンド ライン オプションを使用すると、他のセッションでサンドボックスを有効にすることなく、1 つのセッションにサンドボックスを使用できます。 サンドボックスが既に有効になっている場合は、 `--no-sandbox` オプションを使用して、1 つのセッションで無効にすることができます。\n`--no-sandbox` オプションは、サンドボックスを必要とするエンタープライズ管理設定をオーバーライドできません。\n\nこれらのオプションを `-p` コマンド ライン オプションと組み合わせて、CLI をプログラムで使用するためのサンドボックスを制御できます。 例えば次が挙げられます。\n\n```shell copy\ncopilot --sandbox -p \"PROMPT\"\n```\n\n## サンドボックスの外部で 1 つのコマンドを実行する\n\nコマンドがサンドボックスで許可されているよりも広範なアクセスを必要とする場合、 Copilot はサンドボックスの外部でその 1 つのコマンドの実行を要求できます。 コマンドを説明する確認プロンプトが表示されます。 その 1 つのコマンドを承認したり、サンドボックス内に保持したり、現在のセッションの残りの部分でサンドボックスを無効にしたりできます。 セッションのオプトアウトは、有効なポリシーでサンドボックス バイパスが許可されている場合にのみ、アクティブなバイパス プロンプトに応答している間にのみ使用できます。\n\nこの動作は既定で有効になっており、サンドボックス設定でオフにすることができます。\n\n## サンドボックスが使用されているかどうかを確認する\n\nローカル サンドボックスが現在のセッションで使用されているかどうかを確認するには、次のように入力します。\n\n```shell copy\n/sandbox status\n```\n\nCopilot CLI は、セッションに対してサンドボックスが有効になっているかどうかを報告します。 組織の管理設定でサンドボックス化が必要な場合は、ステータスにもその旨が記載されます。 状態はセッションが実際に適用する内容を反映しているため、実行 Copilot コマンドがサンドボックス化されているかどうかを確認する信頼性の高い方法です。\n\nサンドボックスがオンになっているかどうかだけでなく、読み取り可能、書き込み可能、ブロックされているパスを正確に確認するには、「 `/sandbox policy`」と入力します。 詳細については、「[GitHub Copilot CLI のローカル サンドボックスに関するファイルシステム ポリシーを理解する](/ja/enterprise-cloud@latest/copilot/concepts/agents/copilot-cli/understanding-local-sandboxing)」を参照してください。\n\nサンドボックスの状態は、サンドボックスが使用されている場合の `sandbox enabled` を含む状態行で一目で確認することもできます。 状態行でのサンドボックス情報の表示は、既定でオンになっています。 オフになっている場合は、オンに戻すことができます。\n\n1. 「`/statusline`」と入力します。\n2. オプションの一覧で選択を下に移動して **sandbox** にします。\n3. チェック マークが表示されるように設定を切り替えるには、 <kbd>Enter キー</kbd> を押します。\n\n## 詳細については、次を参照してください。\n\n* [クラウドサンドボックスとローカルサンドボックスについて GitHub Copilot](/ja/enterprise-cloud@latest/copilot/concepts/about-cloud-and-local-sandboxes)\n* [ローカル サンドボックス設定の構成](/ja/enterprise-cloud@latest/copilot/how-tos/cloud-and-local-sandboxes/configuring-local-sandbox-settings)"}