Compartir comentarios
Las respuestas se generan en base a la documentación.

OpenCode

Tabla de contenidos
Disponibilidad: Acceso anticipado

Esta guía cubre la autenticación, configuración y uso de OpenCode en un entorno de sandbox.

Documentación oficial: OpenCode

Inicio rápido

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

$ sbx run opencode ~/mi-proyecto

El parámetro del espacio de trabajo es opcional y toma como valor predeterminado el directorio actual:

$ 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:

$ 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 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? 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 --:

$ sbx run opencode --name <nombre-sandbox> -- <opciones-de-opencode>

Por ejemplo, para reanudar una sesión existente en un sandbox con nombre:

$ sbx run <nombre-sandbox> -- -s <id-sesion>

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 para preinstalar herramientas o personalizar este entorno.