Z.ai Coding Plan: base URL, API key y configuración
Publicado el:
Tiempo de lectura: 5 min
Tema: Tecnologia
Autor: Leandro Valencia
Los endpoints exactos del GLM Coding Plan: base URL para Claude Code y para Cline, qué key usar y por qué el endpoint equivocado no descuenta tu cuota.
Tabla de Contenidos
- Los endpoints, sin rodeos
- El atajo oficial
- Claude Code, paso a paso
- Cline, Roo y clientes compatibles con OpenAI
- El error que nadie diagnostica: "funciona pero no me descuenta"
- Qué key crear, exactamente
- Lite, Pro y Max: qué cambia de verdad
- Checklist de configuración
- Sigue leyendo
Los endpoints, sin rodeos
| Herramienta | Base URL |
|---|---|
| Claude Code (endpoint compatible con Anthropic) | https://api.z.ai/api/anthropic |
| Cline, Roo, Kilo, VS Code (compatible con OpenAI) | https://api.z.ai/api/coding/paas/v4 |
| Configuración asistida | npx @z_ai/coding-helper |
En los dos casos el token es tu API key del GLM Coding Plan.
Y aquí está el detalle que cuesta dinero: no son intercambiables. El endpoint /api/anthropic es el que entiende Claude Code. El /api/coding/paas/v4 es el compatible con OpenAI. Si pegas uno donde va el otro, o funciona pero no descuenta tu cuota, o no funciona y el mensaje de error no te dice por qué.
El atajo oficial
Antes de configurar nada a mano:
npx @z_ai/coding-helper
El helper de Z.ai te guía para instalar y configurar la herramienta y el plan. Si tienes dudas sobre qué endpoint te toca, esta vía te ahorra el problema entero: la configuración la escribe él.
La configuración manual tiene sentido cuando ya sabes qué quieres, cuando automatizas el setup en varias máquinas, o cuando el helper no cubre tu cliente.
Claude Code, paso a paso
La idea es apuntar Claude Code a Z.ai en vez de a Anthropic:
- Base URL:
https://api.z.ai/api/anthropic - Token: tu API key del Coding Plan
El detalle vigente está en la documentación de Claude Code de Z.ai. Insisto en lo de "vigente": si copias un tutorial de 2024 con otra URL, vas a gastar cuota en el lugar equivocado o no vas a gastar nada.
Cline, Roo y clientes compatibles con OpenAI
En VS Code con Cline:
- API Provider →
OpenAI Compatible(o el proveedor "Z AI" si te aparece en la lista). - Base URL →
https://api.z.ai/api/coding/paas/v4 - API Key → tu key del Coding Plan.
- Modelo → el GLM que esté vigente en tu plan.
La documentación de Cline de Z.ai manda sobre cualquier captura de pantalla vieja que encuentres en un foro.
OpenCode, Roo y el resto siguen el mismo patrón: endpoint de coding + key del plan.
El error que nadie diagnostica: "funciona pero no me descuenta"
Este es el fallo más caro y el más silencioso, así que merece su propia sección.
Hay dos formas de equivocarse, y las dos producen el mismo síntoma:
1. Endpoint equivocado. Si pegas el endpoint de chat genérico en vez del de coding, la petición puede funcionar, pero no sale de la cuota de tu suscripción. Z.ai lo avisa explícitamente en su documentación.
2. Key equivocada. Si pagaste la suscripción pero creaste una key de pay-as-you-go en vez de una key del Coding Plan, tu consumo se factura aparte. Pagas dos veces: la suscripción que no usas y el consumo que sí.
Cómo detectarlo: manda un prompt real —no un "hola"— y mira el consumo en el panel. Si el número no se mueve, tienes uno de los dos problemas.
Qué key crear, exactamente
Cuando el pago pasa, entra al panel (la pestaña se llama algo como API Keys o Billing; el nombre exacto cambia con cada rediseño, el concepto no):
- Crea una key del Coding Plan. No una key suelta de pay-as-you-go.
- Cópiala una vez. Trátala como una contraseña.
- No la subas a un repo, no la pegues en un Discord, no la dejes en un screenshot.
Si más adelante rotas la key, actualizas la herramienta; no hace falta volver a pagar el plan.
Lite, Pro y Max: qué cambia de verdad
Los tres tiers usan los mismos modelos. Lo único que cambia es cuánta cuota tienes.
Eso hace que la decisión sea más simple de lo que parece: arranca en Lite mensual y escala cuando de verdad te quedes corto. Dos avisos concretos:
- Las suscripciones de Z.ai no son reembolsables una vez compradas.
- No te cases con Max anual el primer día. El número grande se siente "ahorro"; es un compromiso.
Si estás comparando este plan contra la suscripción de OpenCode, eso lo desglosamos en Z.ai GLM vs OpenCode Go.
Checklist de configuración
- Key del Coding Plan creada (no pay-as-you-go).
- Endpoint correcto para tu herramienta:
/api/anthropicpara Claude Code,/api/coding/paas/v4para clientes OpenAI. - Un prompt real enviado.
- Consumo verificado en el panel: si no baja, algo está mal.
- Una sola herramienta configurada antes de añadir la segunda.
Sigue leyendo
- El onboarding completo: Cómo usar Z.ai (GLM) paso a paso
- Comparativa de precio: Z.ai GLM vs OpenCode Go
- Si el cliente es OpenCode: errores de instalación de OpenCode
Guía paso a paso
Crea la key del Coding Plan
En el panel de Z.ai, crea una key del plan, no una de pay-as-you-go. La equivocada no descuenta tu cuota.
Elige el endpoint de tu herramienta
Claude Code usa `/api/anthropic`. Cline, Roo y clientes OpenAI usan `/api/coding/paas/v4`.
Pega la base URL y el token
El token es tu API key del Coding Plan. En Claude Code va como token del endpoint compatible con Anthropic.
Verifica que la cuota baja
Manda un prompt real y revisa el consumo en el panel. Si no baja, el endpoint o la key están mal.
Deja el resto para después
Una herramienta, un endpoint, un prompt. Configurar tres clientes el mismo día es la forma más rápida de no saber qué falló.
Preguntas frecuentes
¿Cuál es la base URL del Z.ai Coding Plan?
Depende de la herramienta. Para Claude Code, el endpoint compatible con Anthropic: `https://api.z.ai/api/anthropic`. Para Cline, Roo, Kilo y cualquier cliente compatible con OpenAI: `https://api.z.ai/api/coding/paas/v4`. No son intercambiables.
¿Qué hace npx @z_ai/coding-helper?
Es el atajo oficial de Z.ai: un asistente en terminal que te guía para instalar y configurar la herramienta y el plan sin que tengas que pegar los endpoints a mano. Si dudas de la configuración manual, empieza por ahí.
¿Por qué mi cuota del plan no baja aunque funcione?
Porque estás pegando en un endpoint de chat genérico en vez del endpoint de coding, o usando una key de pay-as-you-go en vez de la key del Coding Plan. Z.ai avisa de esto: el endpoint incorrecto no descuenta la cuota del plan. El síntoma típico es funciona pero no me descuenta el Lite.
¿Qué key uso, la del plan o una suelta?
La key del Coding Plan. Si pagaste la suscripción y creas una key de pay-as-you-go, el consumo se factura aparte en vez de salir de tu cuota. En el panel de Z.ai se crean en sitios distintos aunque la pantalla cambie de nombre entre rediseños.
¿Los planes Lite, Pro y Max usan modelos distintos?
No. Los tres tiers usan los mismos modelos GLM. Lo único que cambia es cuánta cuota tienes. Por eso conviene arrancar en Lite mensual y escalar solo cuando de verdad te quedes corto.
¿Puedo pedir un reembolso del GLM Coding Plan?
No. Las suscripciones de Z.ai no son reembolsables una vez compradas. Ese es el argumento más fuerte para empezar en Lite mensual y no comprometerte con Max anual el primer día.
Posts Relacionados
Continúa explorando contenido similar que te puede interesar
Cómo usar Z.ai (GLM): registro, plan y primer prompt
Guía para registrarte en Z.ai, activar el GLM Coding Plan, crear tu API key y conectar Claude Code, Cline u OpenCode. Onboarding, no una reseña de precios.
Z.ai y sus modelos GLM: cuál es cuál y cuándo usar cada uno
Catálogo práctico de los modelos de Z.ai —GLM-5.3, Flash, 4.6V, OCR, GLM-Image, CogVideoX y el Coding Plan—: qué hace cada uno, cuánto cuesta y cómo elegir el correcto para cada tarea.
IDEs y agentes de código que valen la pena en 2026
Guía completa de los mejores IDEs y agentes de código en 2026: opencode, Claude Code, Cursor, Cline, Kilo Code, Crush, Droid y más. Análisis comparativo, precios y recomendaciones por perfil de desarrollador.
Alianzas
Herramientas que uso a diario y con las que la comunidad consigue mejores condiciones.