# Droid





Esta guía cubre la autenticación, configuración y uso de Droid, un agente de codificación de IA desarrollado por Factory, en un entorno de sandbox.

Documentación oficial: [Droid](https://docs.factory.ai/)

## Inicio rápido

Crea un sandbox y ejecuta Droid para un directorio de proyecto:

```console
$ sbx run droid ~/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 droid
```

## Autenticación

Droid requiere una [cuenta de Factory](https://factory.ai). Ambos métodos de autenticación te autentican directamente en el servicio de Factory; a diferencia de otros agentes en los que proporcionas una clave del proveedor de modelos, Factory gestiona el acceso al modelo a través de tu cuenta de Factory.

**Clave de API**: Almacena tu clave de API de Factory utilizando [secretos guardados](/ai/sandboxes/security/credentials/#stored-secrets):

```console
$ sbx secret set -g droid
```

Alternativamente, exporta la variable de entorno `FACTORY_API_KEY` en tu shell antes de ejecutar el sandbox. Consulta [Credenciales](/ai/sandboxes/security/credentials/) para obtener más detalles sobre ambos métodos.

**OAuth**: Si no se configura ninguna clave de API, Droid te pedirá que te autentiques de forma interactiva en la primera ejecución. El proxy gestiona el flujo de OAuth, por lo que las credenciales no se almacenan dentro del sandbox.

## 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.

El sandbox ejecuta Droid sin avisos de aprobación por defecto. Pasa opciones adicionales de la CLI de `droid` después de `--`:

```console
$ sbx run droid --name <nombre-sandbox> -- <opciones-de-droid>
```

## Imagen base

Plantilla: `docker/sandbox-templates:droid-docker`

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.

