Skip to main content

Uso del espacio aislado local

Habilite el espacio aislado local para que Copilot CLI ejecute los comandos y las herramientas que invoca en su nombre dentro de un espacio aislado del sistema operativo.

Nota:

Los espacios aislados locales para GitHub Copilot están en versión preliminar pública y están sujetos a cambios.

Importante

El espacio aislado local en Windows requiere una compilación de Windows Insiders.

Acerca del espacio aislado local

El espacio aislado es actualmente una característica experimental. Para usarlo, comience Copilot CLI con la opción de ‑‑experimental línea de comandos o escriba /experimental on durante una sesión.

Al habilitar el espacio aislado local, Copilot CLI ejecuta la mayoría de los comandos y herramientas que invoca en su nombre dentro de un espacio aislado del sistema operativo. Después de habilitar el espacio aislado local, se usa para todas las Copilot CLI sesiones hasta que se deshabilita o se desactiva para una sesión específica. Si la configuración administrada de empresa requiere espacio aislado, no puede deshabilitarla.

De forma predeterminada, los comandos y herramientas de espacio aislado pueden escribir en el directorio de trabajo actual y en las carpetas temporales. El directorio de perfil de usuario (inicio), junto con las ubicaciones del sistema y de las herramientas, son de solo lectura. Se bloquean otras ubicaciones de disco. En un repositorio de Git, el resto del repositorio situado encima del directorio de trabajo actual es legible, pero no se puede escribir. Se permite el acceso a la red local y privada, al igual que el acceso saliente a Internet.

De forma predeterminada, las operaciones autenticadas de Git y GitHub CLI (gh) siguen funcionando dentro del espacio aislado, ya Copilot CLI que las GitHub credenciales están disponibles para los comandos de espacio aislado. Esto permite que las acciones como git push y gh pr create se realicen correctamente. Puede desactivarlo en la configuración del espacio aislado.

Para obtener información general conceptual sobre el espacio aislado en Copilot CLI, consulte Acerca de los espacios aislados locales y en la nube para GitHub Copilot.

Comandos de espacio aislado

Puede administrar el espacio aislado local desde dentro de una Copilot CLI sesión mediante el /sandbox comando de barra diagonal. Tiene los siguientes subcomandos.

ComandoDescripción
/sandbox statusMostrar si el espacio aislado se está usando actualmente para la sesión. Consulte Comprobación de si se usa el espacio aislado.
/sandbox policyMostrar la directiva eficaz del sistema de archivos para el directorio actual: las rutas de acceso legibles, grabables o bloqueadas, y el acceso a la red en vigor. Para obtener más información, vea Descripción de las directivas del sistema de archivos para el espacio aislado local en GitHub Copilot CLI.
/sandbox configAbra la interfaz de configuración interactiva. Entrar /sandbox por sí mismo hace lo mismo. Para obtener más información, vea Configurar la configuración del entorno aislado local.
/sandbox enableActive el espacio aislado local. Consulte Habilitación del espacio aislado local.
/sandbox disableDesactive el espacio aislado local. Si la configuración administrada de empresa requiere espacio aislado, se rechaza. Consulte Deshabilitación del espacio aislado local.

Habilitación del espacio aislado local

Para habilitar el espacio aislado local, escriba el siguiente comando en una sesión interactiva Copilot CLI :

Shell
/sandbox enable

El espacio aislado comienza a usarse inmediatamente para la sesión actual.

Después de habilitar el espacio aislado local, se sigue usando para las sesiones interactivas actuales y futuras y para las sesiones mediante programación.

Nota:

Si tiene otras sesiones abiertas al escribir /sandbox enable, el espacio aislado no se usa inmediatamente en esas sesiones. Para usar el espacio aislado en una sesión ya abierta, realice una de las acciones siguientes en esa sesión:

  • Cierre la sesión y reiníciela, por ejemplo mediante la ejecución copilot --continuede .
  • Escribe /sandbox enable.

Deshabilitación del espacio aislado local

Si la configuración administrada de empresa requiere espacio aislado, no se puede deshabilitar y /sandbox disable se rechaza.

Para dejar de usar el espacio aislado local, escriba el siguiente comando en una sesión interactiva Copilot CLI :

Shell
/sandbox disable

El espacio aislado ya no se usa en la sesión actual o en sesiones nuevas y reiniciadas.

La elección de si usar el espacio aislado local se guarda como configuración en el sandbox.enabled archivo de configuración personal de la CLI (~/.copilot/settings.json de forma predeterminada).

Uso del espacio aislado para una sola sesión

Puede usar la opción de línea de comandos para usar el --sandbox espacio aislado para una sola sesión, sin habilitar el espacio aislado para otras sesiones. Si el espacio aislado ya está habilitado, puede deshabilitarlo para una sola sesión mediante la --no-sandbox opción . La --no-sandbox opción no puede invalidar la configuración administrada de empresa que requiera espacio aislado.

Puede combinar estas opciones con la opción de línea de comandos para controlar el -p espacio aislado para el uso mediante programación de la CLI. Por ejemplo:

Shell
copilot --sandbox -p "PROMPT"

Ejecución de un único comando fuera del espacio aislado

Cuando un comando necesita un acceso más amplio que el espacio aislado, Copilot puede solicitar que ejecute ese único comando fuera del espacio aislado. Se muestra un mensaje de confirmación que describe el comando y se ejecuta fuera del espacio aislado solo si lo aprueba; de lo contrario, permanece en espacio aislado. El resto de la sesión permanece en un espacio aislado de cualquier manera.

Este comportamiento está habilitado de forma predeterminada y se puede desactivar en la configuración del espacio aislado.

Comprobación de si se usa el espacio aislado

Para comprobar si se usa el espacio aislado local para la sesión actual, escriba:

Shell
/sandbox status

Copilot CLI informa de si el espacio aislado está habilitado para la sesión. Si la configuración administrada de la organización requiere espacio aislado, el estado también indica esto. Dado que el estado refleja lo que realmente aplica la sesión, es la manera confiable de confirmar si los comandos Copilot se ejecutan en espacio aislado.

Para ver no solo si el espacio aislado está activado, pero exactamente qué rutas de acceso son legibles, grabables o bloqueadas, escriba /sandbox policy. Para obtener más información, vea Descripción de las directivas del sistema de archivos para el espacio aislado local en GitHub Copilot CLI.

También puede ver el estado del espacio aislado de un vistazo en la línea de estado, que contiene sandbox enabled cuando se usa el espacio aislado. La visualización de la información del espacio aislado en la línea de estado está activada de forma predeterminada. Si se ha desactivado, puede volver a activarlo:

  1. Escribe /statusline.
  2. Mueva la selección hacia abajo la lista de opciones al espacio aislado.
  3. Presione Entrar para alternar la configuración para que muestre una marca de verificación.

Lectura adicional