# OpenCode Esta guía cubre la autenticación, configuración y uso de OpenCode en un entorno de sandbox. Documentación oficial: [OpenCode](https://opencode.ai/docs) ## Inicio rápido Crea un sandbox y ejecuta OpenCode para un directorio de proyecto: ```console $ sbx run opencode ~/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 opencode ``` OpenCode inicia una interfaz de usuario de texto (TUI) donde puedes seleccionar tu proveedor de LLM preferido e interactuar con el agente. ## Autenticación OpenCode admite múltiples proveedores. Almacena las claves para los proveedores que deseas utilizar con [secretos guardados](/ai/sandboxes/security/credentials/#stored-secrets): ```console $ sbx secret set -g openai $ sbx secret set -g anthropic $ sbx secret set -g google $ sbx secret set -g xai $ sbx secret set -g groq $ sbx secret set -g aws ``` Solo necesitas configurar los proveedores que deseas utilizar. OpenCode detecta las credenciales disponibles y ofrece esos proveedores en la TUI. También puedes utilizar variables de entorno (`OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GOOGLE_API_KEY`, `XAI_API_KEY`, `GROQ_API_KEY`, `AWS_ACCESS_KEY_ID`). Consulta [Credenciales](/ai/sandboxes/security/credentials/) para obtener más detalles sobre ambos métodos. ## 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. OpenCode utiliza una interfaz TUI y no requiere archivos de configuración extensos. El agente te pide que selecciones un proveedor cuando se inicia, y puedes cambiar de proveedor durante la sesión. ### Pasar opciones en tiempo de ejecución Pasa opciones de la CLI de OpenCode después de `--`: ```console $ sbx run opencode --name -- ``` Por ejemplo, para reanudar una sesión existente en un sandbox con nombre: ```console $ sbx run -- -s ``` ### Modo TUI OpenCode se inicia en modo TUI de forma predeterminada. La interfaz muestra: - Proveedores de LLM disponibles (basados en las credenciales configuradas) - Historial de conversación actual - Operaciones de archivos y uso de herramientas - Respuestas del agente en tiempo real Utiliza atajos de teclado para navegar por la interfaz e interactuar con el agente. ## Imagen base Plantilla: `docker/sandbox-templates:opencode` OpenCode admite múltiples proveedores de LLM con inyección automática de credenciales a través del proxy del sandbox. Consulta [Personalización](/ai/sandboxes/customize) para preinstalar herramientas o personalizar este entorno.