Capitulo 11: OpenCode Zen

< Volver al Indice del Tutorial

OpenCode Zen es una lista curada de modelos testeados y verificados por el equipo de OpenCode. Ofrece la forma mas sencilla de empezar a usar modelos de alta calidad sin configurar proveedores individuales.

Que es OpenCode Zen

En lugar de configurar API keys para cada proveedor (Anthropic, OpenAI, Google, etc.), Zen te da acceso a una seleccion de modelos probados a traves de una sola autenticacion. El equipo de OpenCode se encarga de:

• Verificar que los modelos funcionan correctamente con OpenCode
• Optimizar los parametros de cada modelo
• Mantener la compatibilidad con nuevas versiones

Conectar con Zen

Paso 1: Autenticarse

Dentro de una sesion de OpenCode, ejecuta:

/connect

Esto abrira tu navegador y te redirigira a opencode.ai/auth donde podras autenticarte con tu cuenta.

Paso 2: Verificar credenciales

Las credenciales se almacenan automaticamente en:

~/.local/share/opencode/auth.json

// Ejemplo de auth.json (no editar manualmente)
{
  "zen": {
    "token": "zen_...",
    "expires": "2026-04-02T00:00:00Z"
  }
}

Paso 3: Seleccionar modelo

/models

Este comando muestra la lista de modelos Zen disponibles. Selecciona el que prefieras y OpenCode lo configurara automaticamente.

Configurar Modelos Zen

Modelo principal

En opencode.json:

{
  "provider": "zen",
  "model": "claude-opus-4-6"
}

Small Model

OpenCode usa un small_model para tareas automaticas internas como:

• Generar titulos de conversacion
• Crear resumenes
• Compactar historial de mensajes largos
• Clasificar intenciones

{
  "provider": "zen",
  "model": "claude-opus-4-6",
  "small_model": "claude-haiku-4.5"
}

El small_model debe ser rapido y economico. No necesita ser potente porque solo procesa tareas simples.

Modelos Recomendados segun Caso de Uso

Desarrollo Complejo

Para tareas de arquitectura, refactorizacion grande, o problemas que requieren razonamiento profundo:

{
  "provider": "zen",
  "model": "claude-opus-4-6"
}

Claude Opus 4.6 es el modelo mas capaz. Ideal para:

• Disenar arquitecturas de software
• Refactorizacion de codebases grandes
• Debugging de problemas complejos
• Analisis de seguridad

Desarrollo General

Para el dia a dia de desarrollo: escribir features, corregir bugs, revisar PRs:

{
  "provider": "zen",
  "model": "claude-sonnet-4-6"
}

Alternativa:

{
  "provider": "zen",
  "model": "gpt-4o"
}

Claude Sonnet 4.6 y GPT-4o ofrecen un excelente balance entre capacidad y velocidad. Son la opcion recomendada para la mayoria de tareas.

Tareas Rapidas

Para tareas simples como generar boilerplate, escribir tests unitarios o formatear codigo:

{
  "provider": "zen",
  "model": "claude-haiku-4.5"
}

Alternativa:

{
  "provider": "zen",
  "model": "gpt-4o-mini"
}

Claude Haiku 4.5 y GPT-4o-mini responden muy rapido y son ideales cuando la velocidad importa mas que la profundidad.

Cambiar Modelo en Sesion

No necesitas reiniciar OpenCode para cambiar de modelo.

Con el comando /models

/models

Muestra una lista interactiva donde puedes seleccionar el modelo deseado.

Con el flag —model

opencode --model zen/claude-sonnet-4-6

Cambio temporal vs permanente

• /models cambia el modelo solo para la sesion actual
• Editar opencode.json cambia el modelo de forma permanente
• El flag --model aplica solo para esa ejecucion

Zen vs Proveedores Directos

Aspecto	Zen	Proveedor directo
Configuracion	Una sola autenticacion	API key por proveedor
Modelos	Curados y verificados	Todos los disponibles
Precio	Segun plan Zen	Segun proveedor
Soporte	Equipo OpenCode	Soporte del proveedor
Modelos custom	No	Si
Offline	No	Si (con modelos locales)

Consejos Practicos

• Usa Zen para empezar: es la forma mas rapida de tener OpenCode funcionando con modelos potentes
• Configura siempre un small_model: mejora la experiencia al mantener rapidas las tareas automaticas
• Alterna modelos segun la tarea: no uses Opus para todo, reservalo para tareas complejas
• Combina Zen con modelos locales: usa Zen para tareas que requieren potencia y Ollama para tareas simples o cuando necesitas privacidad

---

Siguiente: Capitulo 12: MCP Servers —>