# Cursor Esta guía cubre la autenticación, configuración y uso de Cursor en un entorno de sandbox. Documentación oficial: [Cursor CLI](https://cursor.com/cli) ## Inicio rápido Crea un sandbox y ejecuta Cursor para un directorio de proyecto: ```console $ sbx run cursor ~/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 cursor ``` ## Autenticación Cursor admite dos métodos de autenticación: una clave de API o OAuth. **Clave de API**: Almacena tu clave de API de Cursor utilizando [secretos guardados](/ai/sandboxes/security/credentials/#stored-secrets): ```console $ sbx secret set -g cursor ``` Alternativamente, exporta la variable de entorno `CURSOR_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, Cursor te pedirá que inicies sesión de forma interactiva en la primera ejecución. El proxy intercepta el intercambio de tokens con `api2.cursor.sh/auth/poll`, por lo que las credenciales son gestionadas por el host y no se almacenan dentro del sandbox. ## Configuración Los sandboxes no heredan la configuración a nivel de usuario de tu host, como `~/.cursor`. 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. Cursor lee `AGENTS.md` del espacio de trabajo para obtener instrucciones específicas del agente. El sandbox ejecuta Cursor en modo YOLO por defecto, el cual ejecuta comandos sin avisos de aprobación. Pasa opciones adicionales de la CLI de `cursor-agent` después de `--`: ```console $ sbx run cursor --name -- ``` ## Imagen base Plantilla: `docker/sandbox-templates:cursor-agent-docker` Preconfigurado para ejecutarse en modo YOLO con HTTP/1.1 y eventos enviados por el servidor (server-sent events) para el tráfico del agente, de modo que las solicitudes fluyan a través del proxy del host. 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.