OpenCode: Guía Completa del Agente de Código con Inteligencia Artificial

OpenCode es un agente de código con inteligencia artificial de código abierto que se ejecuta directamente en la terminal. A diferencia de alternativas comerciales como Claude Code, OpenCode ofrece modelos gratuitos, soporte comunitario masivo y una suscripción de excelente calidad-precio. En esta guía aprenderás todo lo que necesitas para dominarlo desde cero.

¿Qué es OpenCode?

OpenCode es una herramienta de codificación basada en agentes que funciona en la terminal. Su principal ventaja frente a Claude Code es que es completamente de código abierto, tiene modelos gratuitos disponibles desde el primer momento y permite conectarse a múltiples proveedores de IA que quizás ya estás pagando.

Requisitos e Instalación

 El único requisito fundamental es tener una terminal. Algunas opciones recomendadas son:

• Kitty: multiplataforma, código abierto, muy conocida
• Ghost: disponible en Linux y macOS, con aceleración GPU
• Warp: la más recomendada, ahora de código abierto, disponible en macOS, Linux y Windows, con integración nativa con OpenCode

O puedes emplear tu cmd o terminal.

Para instalar OpenCode ejecuta el siguiente comando en tu terminal:

$ curl -fsSL https://opencode.ai/install | sh

Una vez instalado, verifica la versión con:

$  --version

Si el comando no se reconoce, cierra y vuelve a abrir la terminal para recargar el PATH.

La Interfaz TUI de OpenCode

Al ejecutar opencode sin argumentos dentro de una carpeta de proyecto se abre la TUI (Terminal User Interface), una interfaz interactiva dentro de la terminal. Para iniciar tu primer proyecto:

$ mkdir mi-proyecto-opencode
cd mi-proyecto-opencode
opencode

La TUI muestra:

• Un campo de entrada para escribir prompts al agente
• El path actual y la versión en uso
• El hilo de pensamiento del modelo en tiempo real
• Las llamadas a herramientas que ejecuta el agente
• El modelo activo y el costo en tokens y dinero de cada respuesta
• El porcentaje de contexto utilizado

Modelos y Proveedores

OpenCode permite conectarse a múltiples proveedores. Para ver los disponibles usa:

/connect

Y para cambiar el modelo activo:

/models

Modelos Gratuitos

Sin registrarte en ningún servicio ya tienes acceso a modelos gratuitos a través de OpenCode Zen:

• MiniMax M2.5: el mejor de los gratuitos, muy recomendado
• Big Pickle (GLM 4.6): buena alternativa
• Hi3 Preview: modelo chino disponible
• Nemotron 3 SuperFree: modelo de Nvidia

Los modelos gratuitos tienen límite de peticiones y pueden ser más lentos en horas pico, pero no requieren tarjeta de crédito y funcionan sorprendentemente bien.

Suscripción OpenCode Go

La suscripción recomendada por calidad-precio. El primer mes cuesta $5 y luego $10/mes. Con ella accedes a modelos como:

• DeepSeek V4
• GLM 5.1
• Qwen 3.6 Plus (equivalente a Claude Sonnet en rendimiento)
• MiniMax 2.5 y 2.7
• Mimo (modelos de Xiaomi)

Lo más interesante es que por $10 obtienes un valor de uso equivalente a unos $60, gracias a los acuerdos que OpenCode tiene con los proveedores de modelos.

GitHub Copilot y OpenAI

Si ya tienes suscripción a GitHub Copilot o ChatGPT Plus, puedes conectarlos directamente:

/connect

Selecciona el proveedor, autentícate con el navegador y listo. Con OpenAI tendrás acceso a GPT-5.5 y sus variantes.

Comandos Esenciales en la TUI

OpenCode tiene tres modos principales de entrada:

1. La Barra (/) — Comandos Internos

Escribe / para acceder a comandos del sistema:

/models      # Cambiar el modelo de IA
/connect     # Conectar un proveedor
/clear       # Limpiar el historial actual
/new         # Nueva sesión
/compact     # Compactar el contexto para ahorrar tokens
/themes      # Cambiar el tema visual
/thinking    # Activar/desactivar el hilo de pensamiento
/sessions    # Ver y cambiar entre sesiones activas
/timeline    # Ver el historial de prompts enviados
/share       # Compartir el historial como URL pública
/undo        # Deshacer el último mensaje

2. La Exclamación (!) — Modo Shell

Escribe ! para ejecutar comandos de terminal sin gastar tokens:

!git status
!ls -la
!git log --oneline -10
!mkdir nueva-carpeta
!pnpm test

Este modo es clave para ahorrar tokens. Si necesitas ver el estado del repositorio, ejecuta el comando tú mismo en lugar de pedírselo al agente.

3. Tab — Cambiar el Agente Activo

Presiona Tab para alternar entre los agentes principales:

• Build: agente principal con permisos de escritura en disco. Puede modificar archivos.
• Plan: agente restringido solo para analizar y planificar, sin editar nada.

4. @ — Referenciar Archivos

Usa @ para incluir un archivo específico en el contexto sin que el agente tenga que buscarlo:

@robots.txt ¿Estoy bloqueando el bot de Google?

Esto es mucho más rápido y barato en tokens que dejar que el agente explore todo el proyecto para encontrar el archivo.

Buenas Prácticas para Ahorrar Tokens

• Sé específico: en lugar de "explora el proyecto", usa @archivo.ts y haz la pregunta concreta
• Usa ! para comandos de terminal que no necesitan IA
• Usa /compact cuando el contexto supere el 50%
• Usa el agente Plan para explorar sin gastar tokens en modificaciones
• Haz prompts en inglés: usa menos tokens y la IA responde mejor
• Añade restricciones concretas en tus prompts para evitar repetirlas

El Archivo AGENTS.md e inicializar proyectos

El archivo AGENTS.md (también compatible con Claude Code, Cursor, Copilot, etc.) es un markdown que actúa como "ritmo" para la IA. Describe el proyecto, sus restricciones de arquitectura y las decisiones técnicas tomadas para que el agente no las repita ni las contradiga.

Para generarlo automáticamente:

$ /init

OpenCode explorará el proyecto y creará un AGENTS.md con las convenciones detectadas. Ejemplo de contenido:

# Proyecto: Running Dashboard

## Stack
- Vanilla HTML, CSS y JavaScript
- Sin frameworks, sin dependencias externas
- Sin build step
- Sin npm install

## Comandos
- Levantar servidor: `bun server.js`
- Usar siempre bun, nunca node

## Arquitectura
- Todo el código en archivos planos en la raíz
- Datos mockeados en data.js

También puedes editarlo manualmente en cualquier momento:

modify AGENTS.md and indicate that we have to use always bun instead of node

Recuerda: aunque el AGENTS.md define las reglas, el usuario siempre tiene la última palabra. Si le dices algo que contradice el archivo, el agente te hará caso a ti.

Sube el AGENTS.md al repositorio para que todos los colaboradores trabajen con las mismas restricciones.

Agent Skills: Ampliar las Capacidades de la IA

Las Agent Skills son archivos Markdown que añaden conocimiento especializado al agente. Están basadas en el estándar creado por Anthropic para Claude.

Puedes buscar e instalar skills desde el repositorio oficial skills.sh. Por ejemplo, para instalar la skill de React:

$ opencode skills add react-best-practices

Auto Skills: Instalación Automática

Para detectar automáticamente qué skills necesita tu proyecto usa Auto Skills, una herramienta de la comunidad que analiza las dependencias del proyecto:

$ npx auto-skills list

Esto detecta el stack del proyecto y recomienda las skills apropiadas. Para instalarlas:

$ npx auto-skills install

Las skills se guardan en .agents/ dentro del proyecto e incluyen áreas como:

• Accesibilidad (a11y)
• Diseño de frontend
• SEO
• React, Vue, Angular
• Testing

Una vez instalada la skill de SEO, el agente la usa automáticamente cuando detecta que la necesitas:

Quiero mejorar el SEO de mi proyecto

El resultado incluye automáticamente title, meta description, robots, canonical, Open Graph, Twitter Cards y structured data.

Subagentes: Paralelismo en OpenCode

OpenCode incluye subagentes integrados como Explore y General, y permite crear los propios. Los subagentes ejecutan tareas en paralelo sin bloquear la sesión principal.

Crear un Subagente Propio

Crea el archivo en .opencode/agents/security.md:

---
description: Auditor de seguridad del proyecto
model: qwen-3.6-plus
temperature: 0.2
tools:
  - read
  - bash:
      allow:
        - git diff
        - git log
---

Eres un experto en seguridad de aplicaciones web.
Identifica vulnerabilidades como XSS, CSRF, inyección SQL,
exposición de credenciales y dependencias desactualizadas.
No puedes editar archivos, solo reportar hallazgos.

Y otro en .opencode/agents/reviewer.md:

---
description: Revisor de código sin hacer cambios
model: qwen-3.6-plus
tools:
  - read
  - bash:
      allow:
        - git status
        - git diff
        - git log
---

Eres un revisor de código pragmático.
Busca bugs, regresiones y problemas de rendimiento.
No comentes gustos de estilo salvo que afecten al mantenimiento.
No puedes editar archivos.

Para usar múltiples agentes en paralelo, describe la tarea indicando qué hace cada uno:

Divide la investigación en paralelo:
- Explore: encuentra el CSS que gestiona el color de fondo
- General: valora riesgos de rendimiento en el proyecto
- Security: revisa posibles vulnerabilidades en los formularios
- Reviewer: comprueba si los cambios pendientes están listos para commitear

El agente principal debe esperar los resultados y preparar un plan consolidado.

Para navegar entre los subagentes activos usa Ctrl+X y luego las flechas izquierda/derecha.

Comandos Personalizados

Puedes crear comandos reutilizables para tareas frecuentes. Crea el archivo .opencode/commands/supercommit.md:

---
description: Agrupa los cambios en commits semánticos y hace push
---

Inspecciona el repositorio con git status y git diff.
Agrupa los cambios por contexto y crea commits semánticos.
Usa el formato: tipo(scope): descripción

Si se pasan argumentos ($1), tenlos en cuenta antes de commitear.
Asegúrate de no incluir tokens, secrets ni variables de entorno.
Haz push al terminar.

Úsalo desde la TUI:

$ /supercommit
$ /supercommit haz los commits en español

Para que un comando esté disponible en todos los proyectos, cópialo a la carpeta global:

cp .opencode/commands/supercommit.md ~/.config/opencode/commands/

Los argumentos posicionales se referencian como $1, $2, etc. El texto completo pasado al comando está disponible como $arguments.

Gestión de Sesiones

OpenCode permite trabajar con múltiples sesiones en paralelo, como pestañas:

/sessions          # Ver y cambiar entre sesiones
Ctrl+X luego L     # Atajo de teclado para cambiar sesión

Si cierras OpenCode y quieres retomar donde lo dejaste, al cerrarlo se muestra el comando para continuar la sesión:

$ opencode --continue "nombre-de-sesion"

Para ver el historial de prompts de una sesión:

$ /timeline

Desde el timeline puedes buscar prompts anteriores, hacer revert a un punto concreto o forkear la sesión desde ese momento.

Automatización con OpenCode Run

OpenCode puede ejecutarse sin interfaz gráfica, ideal para scripts y CI/CD:

$ opencode run "explica este proyecto en 5 puntos"

Para enfocarlo en un archivo concreto:

$ opencode run --file README.md "mejora la descripción del proyecto"

Para especificar el agente y el modelo:

$ opencode run --agent plan --model qwen-3.6-plus "analiza los riesgos de este PR"

OpenCode Serve: Acceso Remoto

OpenCode puede exponerse como servidor HTTP:

$ opencode serve

Por defecto abre el puerto 4096. Para añadir autenticación:

$ opencode serve --password mi-password-secreto

Las credenciales por defecto son usuario opencode y la password que configures. Esto te permite acceder a tus sesiones y proyectos desde cualquier lugar del mundo.

OpenCode Web: Interfaz Gráfica

Si prefieres no usar la terminal, OpenCode incluye una interfaz web con las mismas funcionalidades:

$ opencode web

Incluye la vista de archivos, el diff de cambios por archivo, historial de sesiones y la terminal integrada.

Compartir Sesiones

Para compartir el historial completo de una sesión como URL pública:

$ /share

Genera un enlace donde cualquiera puede ver el modelo usado, el historial de prompts, las respuestas, los archivos modificados y los diffs.

El Archivo DESIGN.md

Google ha publicado una nueva especificación llamada design.md, complementaria al AGENTS.md. Mientras AGENTS.md describe restricciones técnicas, design.md describe el sistema visual: colores, tipografías, bordes, sombras, accesibilidad y guías de componentes. OpenCode lo detecta automáticamente y lo respeta en todas las tareas de frontend.

Comparativa de Suscripciones

La combinación más recomendada es OpenCode Go + OpenAI: usa GPT-5.5 para planificación y análisis, y los modelos de OpenCode Go (Qwen, Mimo) para ejecución.

Ten en cuenta que los modelos gratuitos sí se usan para entrenar los modelos de los proveedores. Si trabajas con código propietario o sensible, considera una suscripción de pago.

Recomendaciones de Modelos por Tarea

• Mejor para frontend y diseño: MiniMax M2.7
• Mejor para lógica y herramientas/MCPs: Qwen 3.6 Plus
• Mejor equilibrio velocidad/calidad gratis: MiniMax M2.5 Free
• Evitar actualmente: GLM 5.1, Kimika 2.5 (versiones antiguas que se notan)
• Para pensamiento profundo: GPT-5.5 X-High (más lento pero mejor resultado final)
• Para tareas rápidas: GPT-5.5 Non (sin hilo de pensamiento, resultados inmediatos)

Conclusión

OpenCode es una de las herramientas más completas y accesibles del ecosistema de agentes de código con IA. Su naturaleza open source, la posibilidad de usar modelos gratuitos desde el primer día, la integración con suscripciones existentes como ChatGPT y GitHub Copilot, y características avanzadas como subagentes paralelos, comandos personalizados, skills de conocimiento especializado y automatización via CLI lo convierten en la opción más versátil del mercado.

Si estás empezando, instala OpenCode, usa los modelos gratuitos con MiniMax, crea tu primer AGENTS.md con /init e instala las skills recomendadas con npx auto-skills list. Con eso ya tendrás un entorno de desarrollo asistido por IA de nivel profesional sin gastar un solo euro.