GLM 5.2 en OpenCode con Cloudflare Workers AI: guía paso a paso

Resumen

En esta guía explico cómo probar el modelo GLM 5.2 dentro de OpenCode conectándolo a Cloudflare Workers AI, aprovechando las cuotas gratuitas diarias que ofrece Cloudflare. Lo llamo "medianamente gratis" porque Cloudflare entrega una cuota de uso diaria que se reinicia cada día, pero depende del consumo disponible en tu cuenta.

La ventaja principal es que no necesitas pagar directamente una API de Z.ai para probar GLM 5.2. Cloudflare actúa como intermediario y te da créditos diarios suficientes para tareas puntuales: crear planes, hacer revisiones, ajustes pequeños o simplemente probar el modelo.

Qué es GLM 5.2

GLM 5.2 es un modelo de lenguaje desarrollado por Z.ai (Zhipu AI), una de las empresas chinas más activas en IA generativa. El modelo está disponible en Cloudflare Workers AI bajo el identificador @cf/zai-org/glm-5.2, lo que permite usarlo sin necesidad de contratar directamente la API de Z.ai.

Cloudflare documenta GLM 5.2 como parte de su catálogo de modelos en Workers AI, junto a otros modelos como Llama, Mistral y Phi. Esto significa que puedes integrarlo en aplicaciones, herramientas de desarrollo y asistentes de código como OpenCode.

Qué es OpenCode

OpenCode es un asistente de código open source que funciona desde la terminal. Permite conectar diferentes proveedores de modelos de IA (OpenAI, Anthropic, Cloudflare Workers AI, entre otros) para asistir en tareas de programación: generar código, revisar archivos, crear planes de desarrollo y responder preguntas técnicas.

La documentación oficial de OpenCode muestra que Cloudflare Workers AI se puede conectar con el comando /connect, ingresando el Cloudflare Account ID y la API key, y luego listando modelos disponibles con /models.

Pasos para conectar GLM 5.2 en OpenCode con Cloudflare Workers AI

Paso 1: Instalar OpenCode

Antes de empezar, necesitas tener instalado Node.js en tu sistema. Si no lo tienes, descárgalo desde nodejs.org.

Abre la terminal y ejecuta el comando de instalación de OpenCode:

npm install -g opencode

Una vez instalado, puedes verificar que funciona ejecutando:

opencode --version

Paso 2: Crear o iniciar sesión en Cloudflare

Si no tienes cuenta en Cloudflare, crea una gratuita en dash.cloudflare.com. Si ya tienes cuenta, inicia sesión.

Luego:

1. Ve al dashboard de Cloudflare.
2. Navega a la sección de AI / Workers AI.
3. Busca los modelos disponibles en el catálogo.
4. Ubica GLM 5.2 (identificado como @cf/zai-org/glm-5.2).

Paso 3: Probar GLM 5.2 en Cloudflare

Antes de conectarlo a OpenCode, es buena idea probar el modelo directamente en Cloudflare:

1. En Cloudflare, abre el playground del modelo.
2. Selecciona GLM 5.2.
3. Haz una prueba simple, como preguntarle "¿Qué modelo eres?".
4. El modelo debería responder que es GLM 5.2 de Z.ai.

Esto confirma que el modelo está activo y disponible en tu cuenta.

Paso 4: Revisar consumo y cuotas

En la sección de Workers AI de Cloudflare puedes ver el uso acumulado. El video menciona una cuota diaria de "neuronas" o créditos que se reinicia cada día.

Esto significa que:

• Cada día recibes una cantidad de créditos gratuitos.
• Si agotas los créditos, debes esperar al reinicio diario.
• El consumo depende del tamaño de los prompts y las respuestas.
• Para tareas puntuales (planes, revisiones, ajustes pequeños), los créditos suelen ser suficientes.

Paso 5: Conectar Cloudflare Workers AI en OpenCode

Abre OpenCode desde la terminal. Si vas a trabajar en un proyecto real, abre la terminal dentro de la carpeta del proyecto:

cd mi-proyecto
opencode

Dentro de OpenCode:

1. Presiona Ctrl + P para abrir el menú de comandos.
2. Busca providers.
3. Selecciona conectar provider.
4. Elige Cloudflare Workers AI (no Cloudflare AI Gateway).

Alternativamente, puedes usar el comando directo:

/connect

Paso 6: Ingresar credenciales

OpenCode te pedirá dos cosas:

Cloudflare Account ID

Para obtener tu Account ID:

1. Ve al dashboard de Cloudflare.
2. Navega a la sección de Workers.
3. Copia tu Account ID (aparece en el panel lateral derecho).

API Key / API Token

Para crear un token de API:

1. En Cloudflare, ve a My Profile → API Tokens.
2. Haz clic en Create Token.
3. Le pone un nombre descriptivo, por ejemplo "OpenCode Workers AI".
4. Asigna permisos para Workers AI.
5. Copia el token generado.
6. Pégalo en OpenCode cuando lo solicite.

Paso 7: Elegir el modelo

Después de conectar el provider, selecciona GLM 5.2 de la lista de modelos disponibles. Puedes listar los modelos con:

/models

Una vez seleccionado, envía un mensaje simple como "hola" para verificar la conexión. Luego pregunta "¿Qué modelo eres?". El modelo debería responder que es GLM 5.2 de Z.ai ejecutándose en Cloudflare Workers AI, confirmando que quedó conectado correctamente.

Uso recomendado

El youtuber que originalmente documentó este método lo usa para tareas puntuales:

• Crear planes de desarrollo o arquitectura.
• Hacer revisiones de código existente.
• Ajustes pequeños en archivos de configuración o funciones.
• Pruebas del modelo para evaluar su calidad.

Recomienda probarlo y ver hasta dónde alcanzan los créditos gratuitos de Cloudflare. Para uso intensivo (proyectos largos, generación masiva de código), lo ideal es combinarlo con otros proveedores o contratar un plan pago.

Ventajas de este enfoque

• Sin costo directo en Z.ai: Cloudflare actúa como intermediario.
• Cuota diaria gratuita: se reinicia cada día, ideal para pruebas.
• Modelo potente: GLM 5.2 es competitivo en razonamiento y código.
• Integración simple: OpenCode soporta Cloudflare Workers AI nativamente.
• Open source: OpenCode es gratuito y open source.

Limitaciones a considerar

• Los créditos gratuitos tienen un límite diario. Si lo agotas, debes esperar al reinicio.
• El modelo puede tener latencia adicional al pasar por Cloudflare.
• No todas las funciones avanzadas de Z.ai pueden estar disponibles en la versión de Cloudflare.
• Para proyectos profesionales con alto consumo, un plan pago de Cloudflare Workers AI o API directa de Z.ai puede ser necesario.

Conclusión

Conectar GLM 5.2 en OpenCode a través de Cloudflare Workers AI es una forma práctica y económica de probar este modelo sin pagar una API directamente. La configuración toma menos de 10 minutos y los créditos diarios gratuitos de Cloudflare son suficientes para tareas puntuales de desarrollo.

Si estás buscando alternativas gratuitas o de bajo costo para asistirte en programación con IA, esta combinación es una de las mejores opciones disponibles hoy.

Fuentes técnicas

• OpenCode Providers - Documentación oficial
• Cloudflare Workers AI - GLM 5.2