2. Primeros minutos con OpenCode

Objetivo

Instalar OpenCode, abrirlo por primera vez, conocer la interfaz básica y crear tu primer documento usando los modos Plan y Build.

Duración estimada: 30 minutos


Una vez instalado, OpenCode funciona exactamente igual en todos los sistemas. La instalación en Windows requiere un paso adicional porque CMD y PowerShell carecen de las características necesarias para trabajar cómodamente. En macOS y Linux la terminal ya viene preparada.

Nota¿Te asustan lo siguientes pasos?

Existe una interfaz gráfica (GUI) de OpenCode que se instala sin requerimientos previos. Si te dan miedo los siguientes pasos o no sabes si te vale la pena hacerlos, puedes instalarla desde https://opencode.ai/downloads eligiendo la versión Desktop.

Sobre esta interfaz no hablaremos en el resto del curso, pero es equivalente a la propuesta a continuación.

Si te gusta OpenCode, ve por el buen camino y sigue la instalación como se muestra a continuación.

Instalación en Windows

El método para usar OpenCode en Windows es a través de WSL2 (Windows Subsystem for Linux). WSL2 te permite ejecutar un entorno Linux dentro de Windows de forma fluida.

1. Instalar WSL2

Abre PowerShell como administrador y ejecuta:

wsl --install

Esto instala WSL2 con una distribución Ubuntu por defecto. Una vez terminado, reinicia el equipo si se te pide.

NotaMás información

Si quieres más detalles, Microsoft tiene una guía oficial de instalación de WSL.

2. Abrir WSL y actualizar paquetes

Abre “Ubuntu” desde el menú de inicio. Se abrirá una terminal Linux. La primera vez te pedirá crear un usuario y contraseña.

Terminal WSL

Dentro de WSL, actualiza los paquetes:

sudo apt update && sudo apt upgrade -y

3. Instalar OpenCode

Ejecuta el instalador oficial:

curl -fsSL https://opencode.ai/install | bash

Al terminar, cierra y vuelve a abrir la terminal WSL, o ejecuta:

source ~/.bashrc

4. Verificar la instalación

opencode --version

Deberías ver un número de versión. Si es así, OpenCode está listo.


Otros sistemas

En macOS y Linux la terminal ya viene preparada, así que la instalación es directa:

Sistema Comando
macOS brew install anomalyco/tap/opencode
Linux curl -fsSL https://opencode.ai/install \| bash

Para más detalles, visita la documentación oficial de instalación.


Conocer la interfaz (TUI)

Una vez preparado el directorio del proyecto, tal como se ha descrito desde la terminal, navega hasta el directorio donde quieras trabajar y ejecuta:

Para abrir OpenCode desde la terminal
opencode

Fíjate que el sistema te indica que directorio está activo, ante la duda usa pwd.

En sesiones posteriores debes añadir -c para continuar la sesión.

opencode -c
ImportanteEl directorio es tu proyecto

OpenCode toma como proyecto el directorio desde donde lo ejecutas. Todo el historial de conversaciones, la configuración y los archivos que crees se organizan dentro de ese directorio. Por eso es clave navegar primero con cd antes de escribir opencode.

ConsejoTambién puedes usar opencode web

Si prefieres una interfaz gráfica en el navegador, ejecuta:

opencode web

Se abrirá OpenCode en tu navegador, apuntando al mismo proyecto. Pero en este curso usaremos la versión de terminal (opencode a secas): es la misma que usarás en entornos profesionales y te obliga a familiarizarte con la terminal, el explorador de archivos y los comandos básicos.

Consejo¿Qué modelo usa OpenCode?

OpenCode funciona con un modelo de inteligencia artificial. Piensa en el modelo como el “cerebro” que procesa tus instrucciones. Hay modelos gratuitos (como el que usa OpenCode por defecto) y modelos de pago con más capacidad.

En este curso usaremos el modelo gratuito incluido. Si necesitas más potencia en el futuro, puedes configurar otros modelos en la configuración de OpenCode.

Verás una pantalla dividida en dos áreas:

Interfaz TUI de OpenCode
  • Área superior: respuestas y acciones del asistente
  • Área inferior (chat): donde tú escribes los mensajes
  • Esquina inferior derecha: indicador del modo activo (Build o Plan)

Pulsa Tab para alternar entre los dos modos. Observa cómo cambia el indicador.

Escribe /help para ver los comandos disponibles.


Entrar, salir y continuar una sesión

  • Entrar: opencode desde la terminal, siempre dentro del directorio de tu proyecto. Si entras desde otra ubicación, OpenCode tratará ese directorio como un proyecto distinto y no verás el historial de conversaciones anteriores.
  • Salir: escribe /exit o pulsa Ctrl+C
  • Sesiones: OpenCode guarda el historial de cada conversación dentro de tu proyecto (en el directorio .opencode/). Por eso es importante abrirlo siempre desde el mismo directorio: así puedes retomar conversaciones anteriores y mantener toda la configuración del proyecto.
  • Ritual recomendado: cada vez que quieras trabajar, abre la terminal, navega a tu proyecto con cd y ejecuta opencode.

Para este curso trabajaremos siempre en el mismo directorio del proyecto.


Manos a la obra

Vas a crear tu primer documento usando los dos modos de OpenCode: primero Plan para diseñar el contenido, luego Build para generar el archivo.

Importante¿Ya estás en el directorio correcto?

Antes de empezar, confirma que abriste OpenCode desde el directorio curso-opencode que creaste en el paso anterior. Para comprobarlo, escribe en el chat:

!pwd

Debería mostrar algo como /home/tu-usuario/curso-opencode. Si no es así, sal con /exit, navega al directorio correcto y vuelve a ejecutar opencode.

AvisoAntes de empezar

Mira la esquina inferior derecha de la pantalla. Allí pone Build o Plan. Usa Tab para cambiar. Asegúrate de estar en el modo correcto antes de cada ejercicio.

Ejercicio 1 — Plan mode

Modo: Tab Plan — pulsa Tab para estar en modo Plan

Escribe en el chat de OpenCode:

Soy profesor de secundaria. Necesito crear un documento que explique los fundamentos de la teoría de la evolución de Darwin para estudiantes de 14-15 años. Hazme un plan con los apartados que debería incluir y qué contenido pondrías en cada uno.

OpenCode te responderá con una estructura de apartados. Puedes pedirle cambios si quieres, por ejemplo:

Añade un apartado sobre ejemplos cotidianos de la evolución.

Ejercicio 2 — Build mode

Modo: Tab Build — pulsa Tab para estar en modo Build

Escribe ahora en el chat:

Perfecto. Ahora genera el documento completo en un archivo llamado darwin-evolucion.md. Lenguaje sencillo, tono divulgativo, ejemplos claros. Quiero que esté listo para imprimirlo y dárselo a la clase.

OpenCode creará el archivo en tu directorio de trabajo. Puedes comprobarlo de dos formas:

Fuera de OpenCode — abre otra terminal y escribe:

cat darwin-evolucion.md

Sin salir de OpenCode — escribe en el chat:

!cat darwin-evolucion.md

El signo ! le dice a OpenCode que ejecute ese comando en la terminal sin cerrar la sesión. Útil para comprobaciones rápidas.

Ejercicio 3 — Añadir un cuestionario

Sin cerrar la sesión, escribe en el chat:

Ahora añade al final del archivo un cuestionario de 5 preguntas tipo test sobre el contenido. Cada pregunta con 4 opciones. Incluye las respuestas correctas al final del todo.

OpenCode editará el archivo existente para añadir el cuestionario, sin tener que empezar de cero.

Ejercicio 4 — Convertir a Word (opcional)

¿Tienes Word y quieres un .docx? Pídeselo a OpenCode:

Convierte darwin-evolucion.md a un archivo .docx usando python-docx.

OpenCode necesita la librería python-docx. La primera vez que la uses, la instalará automáticamente.


Consejo¿Por qué Markdown?

OpenCode trabaja de forma nativa con Markdown (.md): es texto plano, ligero, y herramientas como Quarto lo convierten a HTML, PDF o Word. Al usar .md evitas formatos binarios (.docx) que OpenCode puede leer y modificar pero cuesta tiempo y tokens, importante cuando uses modelos de pago.

Consejo¿Quieres saber más sobre Markdown?

Si quieres profundizar en Markdown, Pandoc y Quarto, consulta esta breve introducción: Markdown, Pandoc y Quarto (HTML | PDF).

ConsejoPara usuarios de Git

Si ya conoces Git, el Markdown se versiona de forma natural: al ser texto plano, los cambios entre versiones se ven limpios y es fácil colaborar con otras personas.

No olvides añadir los cambios y hacer commit después de salir de la sesión.

Nota¿HTML mejor que DOC?

Para visualizar el material generado, suele ser más rápido convertir el .md a HTML que a .docx. HTML se abre al instante en cualquier navegador, no requiere Word, y respeta fielmente el formato. Con Quarto es tan sencillo como quarto render archivo.md.


Resumen del paso

  • ✅ OpenCode instalado y funcionando
  • ✅ Conoces la interfaz: chat, modos, comandos básicos
  • ✅ Sabes entrar, salir y cambiar entre Plan y Build
  • ✅ Entiendes que OpenCode usa el directorio actual como proyecto y por qué es importante abrirlo siempre desde el mismo directorio
  • ✅ Has creado un documento completo con Plan + Build
  • ✅ Has ampliado el documento con un cuestionario
  • ✅ Entiendes por qué Markdown es el formato ideal con OpenCode

En el próximo paso profundizaremos en la interfaz y en cómo referenciar archivos con @.

Curso OpenCode 101 · Idea original de JA Palazón · Mayo 2026