Configura OpenCode Zen en minutos

Seguro que te ha pasado: intentas probar un nuevo agente de código y terminas perdiendo media hora configurando tres proveedores distintos, gestionando saldos en varias webs y peleándote con variables de entorno que no cargan. Es frustrante cuando solo quieres ver a tu agente escribir código.

Para evitar este caos, te recomiendo usar OpenCode Zen. Es la opción más directa si quieres una lista curada de modelos optimizados sin tener que saltar de un Dashboard a otro. Es práctico, rápido y te quita de encima el mantenimiento de múltiples llaves.

Requisitos previos

• Una cuenta activa en OpenCode con detalles de facturación.
• Node.js instalado para ejecutar el CLI.

Inicio rápido

Configurar el acceso te tomará menos de cinco minutos. OpenCode Zen funciona mediante el provider opencode y utiliza una sola API key para todos los modelos disponibles.

Primero, utiliza el CLI para vincular tu cuenta:

openclaw onboard --auth-choice opencode-zen
# O si prefieres el modo no interactivo
openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"

Después, añade este snippet a tu archivo de configuración para definir el modelo por defecto:

{
  env: { OPENCODE_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}

Solución de problemas

• Error de API key: Verifica que has copiado el token correctamente desde tu Dashboard. Recuerda que el sistema acepta tanto OPENCODE_API_KEY como OPENCODE_ZEN_API_KEY.
• Fallos en las peticiones: Zen factura por cada request. Si recibes errores inesperados, comprueba que tus datos de facturación estén actualizados en la plataforma.

Si te quedas atascado en algún paso, pregunta a nuestro AI Setup Assistant.

Próximos pasos

• Guía de modelos disponibles
• Optimización de costes en agentes