🚀 Instalando OpenCode + Interfaz

Ahora que ya sabes qué es OpenCode y para qué sirve, llega el momento de instalarlo y ejecutar tu primer proyecto.

La buena noticia es que el proceso es extremadamente sencillo y funciona en prácticamente cualquier sistema operativo.

📦 Instalando OpenCode

OpenCode ofrece varias formas de instalación dependiendo de tu sistema y tus preferencias.

En la documentación encontrarás opciones para gestores de paquetes como:

npm
Brew
Paru
Otros gestores específicos según tu sistema operativo

Sin embargo, existe una opción mucho más universal.

🌍 El instalador universal

La forma más sencilla de instalar OpenCode es utilizando el script oficial disponible en opencode.ai/install

Este instalador se encarga automáticamente de:

Descargar los archivos necesarios
Instalar OpenCode
Configurar el entorno correctamente

Simplemente ejecútalo y deja que haga su trabajo.

✅ Verificando la instalación

Una vez finalizada la instalación, conviene asegurarse de que todo funciona correctamente.

Para ello puedes ejecutar:

opencode --version

Si todo ha ido bien, verás la versión instalada de OpenCode.

Ese es el indicador más fiable de que la instalación ha sido exitosa.

⚠️ Si no funciona a la primera

Es bastante habitual que, justo después de instalar una herramienta de terminal, el comando todavía no esté disponible en la sesión actual.

Si eso ocurre:

Cierra la terminal.
Abre una nueva ventana o pestaña.
Vuelve a ejecutar el comando.

opencode --version

Muchas veces el problema simplemente está relacionado con la actualización de las variables del sistema o del PATH.

📁 Creando nuestro primer proyecto

Una vez instalado OpenCode, podemos crear una carpeta para empezar a trabajar.

Por ejemplo:

mkdir curso-opencode
cd curso-opencode

A partir de este momento ya podemos ejecutar OpenCode dentro del proyecto.

▶️ Iniciando OpenCode

Para arrancar OpenCode basta con ejecutar:

opencode

Sin argumentos adicionales.

Al hacerlo aparecerá una interfaz interactiva dentro de la propia terminal.

🖥️ ¿Qué estamos viendo exactamente?

La interfaz que aparece recibe el nombre de TUI.

TUI significa:

Terminal User Interface

Es decir, una interfaz de usuario que funciona completamente dentro de la terminal.

Aunque sigue siendo una terminal, la experiencia se parece más a una aplicación visual que a una simple línea de comandos.

🎨 Elementos de la interfaz

Dentro del TUI podemos encontrar diferentes elementos:

Un área de entrada para escribir instrucciones
Información del proyecto actual
La ruta donde estamos trabajando
La versión de OpenCode que estamos utilizando
Indicadores visuales y colores para mejorar la experiencia

Todo ello hace que trabajar con agentes desde la terminal resulte mucho más cómodo.

⚡ Integración con Warp

Durante la clase también se muestra una integración muy interesante con Warp.

Warp es capaz de detectar automáticamente que estamos utilizando OpenCode y ofrecer herramientas adicionales como:

Navegación por el sistema de archivos
Entradas de texto más inteligentes
Control remoto
Notificaciones

Estas funcionalidades pertenecen a Warp y no a OpenCode, pero pueden mejorar considerablemente la experiencia de uso.

🔔 Las notificaciones son especialmente útiles

Una de las funciones más prácticas es el sistema de notificaciones.

Cuando OpenCode termina de procesar una tarea o finaliza un razonamiento largo, Warp puede avisarte automáticamente.

Esto resulta especialmente útil cuando trabajas con tareas que tardan varios minutos en completarse.

📌 Ideas clave de esta clase

Quédate con estos conceptos:

OpenCode puede instalarse de múltiples formas
El instalador universal simplifica enormemente el proceso
Puedes comprobar la instalación usando opencode --version
Si el comando no aparece, suele bastar con reiniciar la terminal
OpenCode se ejecuta dentro de proyectos concretos
El comando principal es simplemente opencode
La interfaz que aparece es un TUI (Terminal User Interface)
Warp añade funcionalidades extra muy interesantes
Las notificaciones ayudan a seguir el trabajo del agente

🚀 Lo siguiente: empezar a conversar con OpenCode

Ya tienes OpenCode instalado y funcionando.

Ahora toca aprender a interactuar con él, entender cómo enviar instrucciones al agente y empezar a aprovechar todo su potencial para ayudarte a programar desde la terminal.

💡 Tip: Antes de continuar, asegúrate de que puedes ejecutar opencode --version correctamente. Si ese comando funciona, significa que ya tienes todo preparado para seguir avanzando.