OpenCode para Principiantes: Guía de Instalación y Primeros Pasos en la Terminal

OpenCode es un agente de codificación con IA que opera directamente desde la terminal. A diferencia de los asistentes tradicionales, OpenCode comprende la estructura completa de tu proyecto y puede realizar cambios reales en el código, no solo sugerencias.

En este tutorial aprenderás a instalarlo, configurar tu primer provider y ejecutar comandos básicos. Una vez domines estos fundamentos, podrás avanzar al flujo de trabajo Plan/Build para desarrollar features con OpenCode o explorar las configuraciones avanzadas para equipos profesionales.

¿Qué es OpenCode?

OpenCode combina tres capacidades clave:

Capacidad	Descripción
Análisis de contexto	Lee y comprende la estructura completa de tu proyecto
Ejecución de cambios	Modifica archivos, ejecuta comandos y gestiona dependencias
Interfaz TUI	Interacción conversacional en la terminal con modo Plan y Build

Instalación Multiplataforma

Opción 1: Script de instalación (Recomendado)

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

Opción 2: Gestores de paquetes

Node.js (npm, Bun, pnpm, Yarn):

bashCopiar
npm install -g opencode-ai
# o
bun install -g opencode-ai
# o
pnpm install -g opencode-ai
# o
yarn global add opencode-ai

Homebrew (macOS y Linux):

bashCopiar
brew install anomalyco/tap/opencode

Arch Linux:

bashCopiar
sudo pacman -S opencode        # Estable
paru -S opencode-bin         # Última versión AUR

Windows (Chocolatey o Scoop):

bashCopiar
choco install opencode
# o
scoop install opencode

Opción 3: Docker

bashCopiar
docker run -it --rm ghcr.io/anomalyco/opencode

Configuración del Provider

OpenCode funciona con múltiples providers de LLM. Te recomendamos comenzar con OpenCode Zen, el router curado por el equipo:

1. Ejecuta /connect en la TUI de OpenCode
2. Selecciona opencode y visita opencode.ai/auth
3. Regístrate, añade método de pago y copia tu API key
4. Pégala en la terminal cuando se solicite

Alternativamente, puedes configurar otros providers como OpenAI, Anthropic o incluso Ollama para uso local.

Inicialización de Proyectos

Navega a tu proyecto y lanza OpenCode:

bashCopiar
cd /path/to/tu-proyecto
opencode

Dentro de la TUI, ejecuta:

/init

Este comando analiza tu proyecto y crea un archivo AGENTS.md en la raíz. Este archivo es crucial: le dice a OpenCode qué tecnologías usas, convenciones de código y estructura del proyecto.

💡 Tip: Commit AGENTS.md a Git. Es la "caja de herramientas" de contexto para OpenCode.

Comandos Fundamentales

Navegación de archivos

Usa @ para búsqueda fuzzy de archivos:

@src/components

Esto muestra todos los archivos que coinciden con ese patrón.

Consultas al código

Pregunta sobre cualquier parte del proyecto:

¿Cómo funciona la autenticación en @src/api/auth.ts?

Modo Plan vs Modo Build

OpenCode tiene dos modos de operación:

Modo	Tecla	Función
Plan	Tab	Solo sugiere cambios, no ejecuta
Build	Tab (alternar)	Ejecuta los cambios directamente

El modo Plan es ideal para features complejos donde quieres revisar la estrategia antes de implementar.

Tu Primer Prompt Efectivo

Una vez inicializado, prueba este prompt de exploración:

Explícame la arquitectura de este proyecto: tecnologías principales, 
estructura de directorios y patrones de diseño que detectes.

OpenCode analizará el código y te dará un resumen estructurado.

Solución de Problemas Comunes

Problema	Solución
"API key inválida"	Revisa /connect y regenera la key en opencode.ai/auth
"No se detecta el proyecto"	Asegúrate de ejecutar /init en la raíz del proyecto
Errores de permisos en Windows	Usa WSL para mejor compatibilidad
Cambios no aplicados	Verifica que estás en modo Build, no Plan

Siguientes Pasos

Ya tienes OpenCode instalado y funcionando. Para sacarle el máximo provecho:

1. Aprende el flujo profesional: Descubre cómo usar el modo Plan/Build para desarrollar features complejos sin errores
2. Configura para tu equipo: Aprende a personalizar AGENTS.md y usar providers alternativos para flujos profesionales

En Binary Core usamos OpenCode diariamente para acelerar el desarrollo de sistemas financieros críticos. La clave es empezar con proyectos pequeños y aumentar la complejidad gradualmente.

¿Tienes dudas sobre la instalación? Los comandos /help y /status dentro de OpenCode son tus aliados.