Qué es OpenCode y cómo empezar a usarlo

Qué es OpenCode

OpenCode es un asistente de inteligencia artificial que trabaja directamente desde tu terminal. A diferencia de las típicas interfaces web, OpenCode se ejecuta en tu línea de comandos, entiende tu proyecto y puede leer, escribir y modificar archivos de forma autónoma.

Está construido sobre modelos de lenguaje avanzados y está diseñado específicamente para tareas de ingeniería de software: desde escribir código hasta refactorizar proyectos enteros, pasando por depuración, testing, documentación y despliegue.

Por defecto, OpenCode te proporciona modales interactivos en la terminal para aprobar cambios, revisar diffs, seleccionar archivos y confirmar acciones antes de ejecutarlas. No es un chat ciego: cada modificación pasa por tu aprobación.

Para qué sirve

OpenCode está diseñado para acelerar tu flujo de trabajo como desarrollador. No es un chat genérico: es un ingeniero de software artificial que trabaja dentro de tu proyecto.

Instalación

Instalar OpenCode es rápido y solo requiere Node.js 18+ en tu sistema. Elige el método que prefieras:

Requisitos previos

Asegúrate de tener Node.js instalado. Si no lo tienes:

# Verificar si ya tienes Node.js
node --version    # Debe mostrar v18.0.0 o superior

# Si no lo tienes, instálalo desde:
# https://nodejs.org/  (recomendado: LTS)

# O con nvm (gestor de versiones):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install --lts

Opción 1: Instalación global con npm (recomendada)

La forma más sencilla y la que te recomendamos para empezar:

npm install -g @opencode/cli

Esto instala OpenCode globalmente y añade el comando opencode a tu PATH. Una vez instalado, verifica que funciona:

opencode --version

Opción 2: Usar npx (sin instalación)

Si prefieres no instalarlo globalmente, puedes ejecutarlo directamente con npx. La primera vez tardará unos segundos en descargarse:

npx @opencode/cli

Opción 3: Clonar desde GitHub

Si quieres explorar el código fuente o contribuir al proyecto:

git clone https://github.com/anomalyco/opencode.git
cd opencode
npm install
npm run build
npm link

Configuración inicial

La primera vez que ejecutes OpenCode, te guiará por una configuración asistida vía modales en la propia terminal. Te pedirá tu clave de API del proveedor que elijas:

# La configuración se hace mediante modales interactivos
# Abre opencode y sigue los pasos que aparecerán en pantalla:

opencode

# Te preguntará por:
# 1. Proveedor de modelo (por defecto el que trae integrado)
# 2. Tu API key (si aplica)
# 3. Preferencias de la sesión

# También puedes configurar variables de entorno si lo prefieres:
export OPENCODE_API_KEY="tu-api-key-aqui"

Primer uso

Una vez instalado y configurado, iniciar OpenCode es tan sencillo como ejecutar un comando desde la raíz de tu proyecto.

Iniciar OpenCode

# Dentro de la carpeta de tu proyecto
cd mi-proyecto

# Iniciar sesión interactiva
opencode

Al ejecutar opencode sin argumentos, se abre una sesión interactiva en tu terminal con modales para guiarte. Verás algo como:

✦ OpenCode
  Contexto: carpeta actual con ~1,200 archivos
  Modelo: deepseek-v4-flash-free (configurable)

  > _

El cursor > _ indica que OpenCode está listo para recibir instrucciones. Puedes empezar a escribir lo que necesites.

Tu primer flujo de trabajo

Aquí tienes un ejemplo de principio a fin. Abre tu terminal y prueba este flujo:

mkdir mi-primer-proyecto
cd mi-primer-proyecto
echo '{"name":"mi-primer-proyecto","type":"module"}' > package.json

opencode

> Crea un archivo index.js que sea un servidor HTTP básico.
  Debe responder con "Hola desde OpenCode" en la ruta /
  y escuchar en el puerto 3000.

> Añade una ruta /api/health que devuelva JSON con
  { status: "ok", timestamp: Date.now() }

> /exit

Flujo rápido (una línea)

Si solo necesitas una respuesta puntual sin abrir una sesión interactiva, usa el flag -p:

opencode -p "Explica qué hace este proyecto basándote en su estructura de carpetas"

Esto ejecuta OpenCode, procesa tu petición y devuelve el resultado directamente en la terminal, sin entrar en modo interactivo.

Comandos principales

OpenCode ofrece varios comandos y flags para adaptarse a diferentes formas de trabajar. Estos son los esenciales:

Modos de ejecución

Comandos dentro de la sesión interactiva

Una vez dentro de una sesión con opencode, puedes usar estos comandos internos:

Ejemplos de uso frecuente

# 1. Pedir una explicación del proyecto
opencode -p "Explica la arquitectura de este proyecto en 3 párrafos"

# 2. Generar tests
opencode -p "Genera tests unitarios con Jest para src/services/auth.ts"

# 3. Refactorizar un archivo
opencode -p "Refactoriza utils/helpers.js para usar funciones puras
  y dividirlo en módulos más pequeños"

# 4. Depurar un error
opencode -p "Ejecuta npm test, captura el error y proponme una solución"

# 5. Revisar seguridad
opencode -p "Analiza este proyecto en busca de vulnerabilidades
  de seguridad comunes (inyección SQL, XSS, secrets expuestos)"

# 6. Migrar a TypeScript
opencode -p "Migra src/utils/ de JavaScript a TypeScript
  añadiendo tipos e interfaces donde corresponda"

Consejos y buenas prácticas

Para sacar el máximo partido a OpenCode, aquí tienes una serie de consejos basados en la experiencia de uso diario:

Cómo escribir buenos prompts

Buenas prácticas generales

• Sé específico: Incluye nombres de archivos, frameworks, versiones y el resultado esperado.
• Divide tareas grandes: En lugar de pedir "crea un e-commerce", hazlo por partes: "crea el modelo de productos", luego "crea las rutas CRUD", etc.
• Proporciona contexto: Si hay un error, pega el stack trace. Si quieres una refactorización, explica por qué.
• Usa el modo interactivo para tareas largas: Para cambios que requieren múltiples iteraciones, abre una sesión con opencode sin flags.
• Usa -p para tareas puntuales: Para preguntas rápidas, explicaciones o cambios pequeños, el flag -p es más eficiente.
• Revisa siempre los cambios: OpenCode es poderoso, pero tú eres el responsable del código. Revisa los cambios antes de hacer commit.
• Aprovecha el control de versiones: Trabaja en una rama separada cuando uses OpenCode para cambios grandes. Así puedes revisar el diff completo antes de mergear.

Lo que OpenCode NO debe hacer

Integración en tu flujo de trabajo

Aquí tienes un ejemplo de cómo integrar OpenCode en tu día a día como desarrollador: