# Kiro Esta guía cubre la autenticación, configuración y uso de Kiro en un entorno de sandbox. Documentación oficial: [Kiro CLI](https://kiro.dev/docs/cli/) ## Inicio rápido Crea un sandbox y ejecuta Kiro para un directorio de proyecto: ```console $ sbx run kiro ~/mi-proyecto ``` El parámetro del espacio de trabajo es opcional y toma como valor predeterminado el directorio actual: ```console $ cd ~/mi-proyecto $ sbx run kiro ``` En la primera ejecución, Kiro te pedirá que te autentiques utilizando el flujo de dispositivo. ## Autenticación Kiro utiliza la autenticación de flujo de dispositivo, la cual requiere un inicio de sesión interactivo a través de un navegador web. Este método proporciona una autenticación segura sin almacenar directamente claves de API. ### Inicio de sesión mediante flujo de dispositivo La primera vez que ejecutas Kiro, te pedirá que te autentiques: 1. Kiro muestra una URL y un código de verificación 2. Abre la URL en tu navegador web 3. Introduce el código de verificación 4. Completa el flujo de autenticación en tu navegador 5. Regresa a la terminal: Kiro procederá automáticamente La sesión de autenticación persiste en el sandbox y no requiere inicios de sesión repetidos a menos que destruyas y vuelvas a crear el sandbox. ### Inicio de sesión manual Puedes iniciar el flujo de inicio de sesión de forma manual: ```console $ sbx run kiro --name -- login --use-device-flow ``` Este comando inicia la autenticación de flujo de dispositivo sin comenzar una sesión de desarrollo. ### Persistencia de la autenticación Kiro almacena el estado de autenticación en `~/.local/share/kiro-cli/data.sqlite3` dentro del sandbox. Esta base de datos persiste mientras exista el sandbox. Si destruyes el sandbox, tendrás que autenticarte de nuevo cuando lo vuelvas a crear. ## Configuración Los sandboxes no heredan la configuración a nivel de usuario de tu host. Solo la configuración a nivel de proyecto en el directorio de trabajo está disponible dentro del sandbox. Consulta [¿Por qué el sandbox no utiliza la configuración de mi agente a nivel de usuario?](/ai/sandboxes/faq/#why-doesnt-the-sandbox-use-my-user-level-agent-configuration) para conocer las soluciones alternativas. Kiro requiere una configuración mínima. El agente se ejecuta en modo `trust-all-tools` (confiar en todas las herramientas) de forma predeterminada, lo que le permite ejecutar comandos sin avisos de aprobación repetidos. ### Pasar opciones en tiempo de ejecución Pasa opciones de la CLI de Kiro después de `--`: ```console $ sbx run kiro --name -- ``` ## Imagen base Plantilla: `docker/sandbox-templates:kiro` Preconfigurado para ejecutarse sin avisos de aprobación. El estado de autenticación persiste a lo largo de los reinicios del sandbox. Consulta [Personalización](/ai/sandboxes/customize) para preinstalar herramientas o personalizar este entorno.