Capitulo 11: OpenCode Zen
Capitulo 11: OpenCode Zen
< Volver al Indice del Tutorial
OpenCode Zen es un gateway con una lista curada de modelos probados y verificados por el equipo de OpenCode. En lugar de configurar API keys para cada proveedor (Anthropic, OpenAI, Google, etc.), Zen te da acceso a una selección de modelos a través de una sola autenticación. Es la forma más sencilla de empezar a usar OpenCode con modelos potentes sin preocuparte por la configuración de proveedores.
Qué es OpenCode Zen
El equipo de OpenCode mantiene y verifica continuamente una lista de modelos que funcionan correctamente con todas las funcionalidades del agente: herramientas, llamadas de función, streaming, contexto largo. Esto es importante porque no todos los modelos de todos los proveedores funcionan bien con agentes AI. Algunos tienen problemas con tool calling, otros truncan respuestas largas, y otros no manejan correctamente el formato de herramientas.
Zen resuelve estos problemas actuando como intermediario:
flowchart LR
A[OpenCode] -->|Petición| B[Zen Gateway]
B -->|Ruta optimizada| C[Proveedor real]
C -->|Respuesta| B
B -->|Streaming| A
style B fill:#fff3e0El equipo de OpenCode se encarga de:
- Verificar que cada modelo funcione correctamente con tool calling y el protocolo de herramientas.
- Optimizar los parámetros de cada modelo para obtener el mejor rendimiento en tareas de desarrollo.
- Mantener la compatibilidad con nuevas versiones del agente.
- Negociar precios con los proveedores para ofrecer tarifas competitivas.
Conectar con Zen
Paso 1: Autenticarse
Dentro de una sesión de OpenCode, ejecuta:
/connectEsto abrirá tu navegador y te redirigirá a opencode.ai/auth donde podrás autenticarte con tu cuenta. Si no tienes cuenta, puedes crear una directamente desde ahí.
Paso 2: Verificar credenciales
Las credenciales se almacenan automáticamente en:
~/.local/share/opencode/auth.jsonPuedes verificar que la autenticación fue exitosa con:
opencode auth listDeberías ver zen en la lista de proveedores configurados con estado activo.
Paso 3: Seleccionar modelo
/modelsEste comando muestra la lista completa de modelos Zen disponibles. Selecciona el que prefieras y OpenCode lo configurará automáticamente para la sesión.
Modelos Disponibles (v1.3.15)
Zen ofrece una amplia variedad de modelos, desde los más potentes hasta opciones gratuitas. La lista se actualiza frecuentemente conforme se añaden y verifican nuevos modelos.
Modelos de Frontera
Estos son los modelos más capaces, ideales para tareas complejas de desarrollo:
| Modelo | Proveedor | Mejor para |
|---|---|---|
| Claude Opus 4.6 | Anthropic | Arquitectura, refactorización profunda |
| Claude Sonnet 4.6 | Anthropic | Desarrollo general diario |
| Claude Haiku (varias versiones) | Anthropic | Tareas rápidas y económicas |
| GPT 5.4 | OpenAI | Razonamiento y código complejo |
| GPT 5.3 Codex | OpenAI | Optimizado para generación de código |
| GPT 5.1 | OpenAI | Balance entre capacidad y velocidad |
| Gemini 3 Pro | Contexto muy largo, análisis de proyectos | |
| Gemini 3 Flash | Velocidad con buen rendimiento |
Modelos Especializados
Modelos optimizados para nichos específicos:
| Modelo | Especialidad |
|---|---|
| MiniMax | Generación multimodal |
| GLM | Chino/inglés bilingüe |
| Kimi | Contexto ultra largo |
| Qwen | Código y razonamiento |
Modelos Gratuitos
Zen ofrece modelos completamente gratuitos (por tiempo limitado). Son una excelente forma de probar OpenCode sin gastar un centavo:
| Modelo | Nota |
|---|---|
| Big Pickle | Modelo experimental gratuito |
| Qwen3.6 Plus Free | Versión gratuita del modelo Qwen |
| Nemotron 3 Super Free | NVIDIA Nemotron gratuito |
| MiniMax M2.5 Free | Versión gratuita de MiniMax |
Los modelos gratuitos tienen limitaciones: pueden tener restricciones de velocidad, la disponibilidad no está garantizada, y los proveedores pueden retirarlos en cualquier momento. Pero son perfectos para empezar y para tareas que no sean críticas.
Pricing
Zen opera con un modelo de pago por uso. Los precios son por millón de tokens:
Modelos destacados
| Modelo | Entrada (por 1M tokens) | Salida (por 1M tokens) |
|---|---|---|
| Modelos gratuitos | $0 | $0 |
| Gemini 3 Flash | $0.50 | $3.00 |
| GPT 5.4 | $2.50 | $15.00 |
| Claude Sonnet 4.6 | $3.00 | $15.00 |
| Claude Opus 4.6 | $5.00 | $25.00 |
Métodos de pago
- Tarjeta de crédito: 4.4% + $0.30 por transacción
- Los cargos se procesan mensualmente
- Puedes establecer límites de gasto para evitar sorpresas
Para la mayoría de desarrolladores individuales, el gasto mensual típico con un uso moderado (2-4 horas diarias de coding asistido) ronda los $20-50 usando Claude Sonnet como modelo principal.
Configurar Modelos Zen
Modelo principal
En opencode.json:
{
"provider": "zen",
"model": "claude-opus-4-6"
}Small Model
OpenCode usa un small_model para tareas automáticas internas como:
- Generar títulos de conversación
- Crear resúmenes del historial
- Compactar historial de mensajes largos
- Clasificar intenciones del usuario
{
"provider": "zen",
"model": "claude-opus-4-6",
"small_model": "claude-haiku-4.5"
}El small_model debe ser rápido y económico. No necesita ser potente porque solo procesa tareas simples e internas. Usar un modelo caro como small_model es un desperdicio de dinero — las tareas que procesa no requieren capacidad de razonamiento.
Configuración combinada con modelo local
Una estrategia eficiente es usar Zen para el modelo principal y Ollama para el small_model:
{
"provider": "zen",
"model": "claude-sonnet-4-6",
"small_model": "ollama/phi4:latest"
}Así obtienes la potencia de un modelo cloud para las tareas importantes y cero costo en tokens para las tareas automáticas internas.
Modelos Recomendados según Caso de Uso
Desarrollo Complejo
Para tareas de arquitectura, refactorización grande, o problemas que requieren razonamiento profundo:
{
"provider": "zen",
"model": "claude-opus-4-6"
}Claude Opus 4.6 es el modelo más capaz disponible en Zen. Ideal para:
- Diseñar arquitecturas de software desde cero
- Refactorización de codebases grandes con múltiples dependencias
- Debugging de problemas complejos que involucran múltiples sistemas
- Análisis de seguridad y revisión de código crítico
- Migración entre frameworks o versiones mayores
Desarrollo General
Para el día a día de desarrollo: escribir features, corregir bugs, revisar PRs:
{
"provider": "zen",
"model": "claude-sonnet-4-6"
}Claude Sonnet 4.6 ofrece un excelente balance entre capacidad y velocidad. Es la opción recomendada para la mayoría de tareas cotidianas. Responde más rápido que Opus y es significativamente más económico, sin sacrificar mucha calidad.
Alternativas equivalentes:
{
"provider": "zen",
"model": "gpt-5.1"
}Tareas Rápidas
Para tareas simples como generar boilerplate, escribir tests unitarios o formatear código:
{
"provider": "zen",
"model": "claude-haiku-4.5"
}Claude Haiku 4.5 y Gemini 3 Flash responden muy rápido y son ideales cuando la velocidad importa más que la profundidad. Perfectos para:
- Generar tests unitarios a partir de una función existente
- Escribir boilerplate (componentes, endpoints, modelos)
- Formatear y limpiar código
- Traducciones rápidas de comentarios o documentación
Features para Teams
Zen incluye funcionalidades específicas para equipos de desarrollo:
Roles
- Admin: gestión completa del equipo, incluyendo control de modelos permitidos, límites de gasto y administración de miembros.
- Member: acceso a los modelos permitidos por el admin y gestión de sus propias claves API.
Control de modelos
El administrador puede restringir qué modelos están disponibles para el equipo. Esto es útil para:
- Limitar el uso a modelos con políticas de privacidad específicas
- Controlar costos evitando modelos caros
- Estandarizar el modelo que usa todo el equipo
Límites de gasto
Se pueden establecer límites de gasto mensuales por usuario. Cuando un miembro alcanza su límite, Zen bloquea las peticiones hasta el próximo ciclo de facturación. El admin recibe notificaciones cuando un miembro se acerca al límite.
Uso de claves propias (BYOK)
Los miembros pueden configurar sus propias claves de OpenAI o Anthropic. En ese caso, las peticiones se facturan directamente al proveedor y no consumen el presupuesto del equipo en Zen. Esto es útil para miembros que ya tienen suscripciones personales.
Privacidad y Seguridad
Ubicación de los datos
Los modelos de Zen están alojados en servidores en Estados Unidos. Las peticiones y respuestas transitan por la infraestructura de Zen antes de llegar al proveedor final.
Política de retención
| Tipo de modelo | Retención de datos |
|---|---|
| Modelos de pago (Anthropic, Google, etc.) | Cero retención |
| OpenAI (modelos de pago) | 30 días (política de OpenAI) |
| Modelos gratuitos | Retención variable (depende del proveedor) |
La cero retención significa que ni Zen ni el proveedor almacenan tus conversaciones después de procesarlas. La excepción son los modelos de OpenAI, que por sus propias políticas retienen los datos durante 30 días para monitoreo de abuso.
Si la privacidad es crítica para tu proyecto, las mejores opciones en orden de privacidad son:
- Modelos locales (Ollama, llama.cpp): tus datos nunca salen de tu máquina
- Zen con modelos Anthropic/Google: cero retención
- Zen con modelos OpenAI: 30 días de retención
Cambiar Modelo en Sesión
No necesitas reiniciar OpenCode para cambiar de modelo.
Con el comando /models
/modelsMuestra una lista interactiva donde puedes seleccionar el modelo deseado. El cambio es inmediato.
Con el flag —model
opencode --model zen/claude-sonnet-4-6Cambio temporal vs permanente
/modelscambia el modelo solo para la sesión actual- Editar
opencode.jsoncambia el modelo de forma permanente - El flag
--modelaplica solo para esa ejecución
Una estrategia común es tener un modelo económico como default en opencode.json y cambiar a uno más potente con /models cuando la tarea lo requiere.
Zen vs Proveedores Directos
flowchart TD
A{Qué necesito?} --> B[Simplicidad]
A --> C[Control total]
A --> D[Privacidad máxima]
B --> E[Zen]
C --> F[Proveedores directos]
D --> G[Modelos locales]
style E fill:#e8f5e9
style F fill:#e1f5fe
style G fill:#fff3e0| Aspecto | Zen | Proveedor directo |
|---|---|---|
| Configuración | Una sola autenticación | API key por proveedor |
| Modelos | Curados y verificados | Todos los disponibles |
| Precio | Según pricing Zen | Según proveedor (puede ser más barato) |
| Soporte | Equipo OpenCode | Soporte del proveedor |
| Modelos custom | No | Sí |
| Offline | No | Sí (con modelos locales) |
| Teams | Sí (roles, límites) | No (gestión manual) |
| Facturación | Unificada | Por proveedor |
Para desarrolladores individuales, la diferencia de precio entre Zen y el proveedor directo suele ser mínima. Para equipos, Zen ofrece ventajas claras de gestión y control.
Consejos Prácticos
- Usa Zen para empezar: es la forma más rápida de tener OpenCode funcionando con modelos potentes. Cero configuración de proveedores.
- Configura siempre un small_model: mejora la experiencia al mantener rápidas las tareas automáticas internas y ahorra dinero.
- Alterna modelos según la tarea: no uses Opus para todo, resérvalo para tareas que realmente requieren su capacidad. Para el 80% de las tareas diarias, Sonnet es suficiente.
- Combina Zen con modelos locales: usa Zen para tareas que requieren potencia y Ollama para tareas simples o cuando necesitas privacidad total.
- Prueba los modelos gratuitos: antes de gastar dinero, prueba qué tal funcionan los modelos gratuitos para tus tareas habituales. Puedes sorprenderte.
- Establece límites de gasto: si usas tarjeta de crédito, configura un límite mensual para evitar facturas inesperadas. Es fácil gastar más de lo planeado cuando estás en una sesión de coding intensa.
Siguiente: Capitulo 12: MCP Servers —>