¿Límite de ZCode alcanzado? Cómo revisar cuotas y tarjetas de reinicio
Guía práctica para distinguir App Usage de las cuotas remotas de GLM Coding Plan, localizar el contador que bloquea el trabajo, comprobar la conexión de la cuenta, usar una tarjeta antes de que caduque y elegir una forma segura de continuar.
Índice
Cuando ZCode indique que alcanzaste un límite, no empieces por el gráfico local de tokens. Abre Usage Statistics → Coding Plan, revisa los contadores de 5 horas y semanal, e identifica cuál está realmente agotado. Si aparece Reset, abre el panel, comprueba a qué cuota corresponde y cuándo caduca la tarjeta. Si no aparece, verifica que ZCode haya iniciado sesión con la cuenta correcta de Z.ai o BigModel y que esté conectado al Coding Plan de esa cuenta. Después podrás esperar la renovación, utilizar una tarjeta válida o cambiar de forma deliberada a otro proveedor con cuota y facturación independientes.
La diferencia esencial es esta: App Usage es un historial local, Coding Plan es una cuota remota de suscripción y una API Key general tiene su propio acceso y cobro. Ninguno de esos medidores rellena ni demuestra automáticamente el estado de los demás.
Esta guía se comprobó con la documentación oficial de ZCode y Z.ai el 3 de octubre de 2026. Las reglas y la elegibilidad pueden cambiar; los contadores y opciones de tu cuenta son la referencia definitiva.
Ruta de decisión en 60 segundos
- Entra en Usage Statistics y selecciona Coding Plan, no App Usage.
- Revisa las cuotas de 5 horas, semanal y, si la tarea usó herramientas, MCP.
- Confirma que está activo el Coding Plan correcto de Z.ai o BigModel y la cuenta personal o de equipo prevista.
- Si aparece Reset, consulta el tipo de cuota y la caducidad antes de usarlo.
- Si no hay tarjeta, espera la renovación que muestra el contador agotado o elige conscientemente otro proveedor configurado.
- Antes de volver a una tarea larga, envía una instrucción breve de prueba.
Así evitas confundir el uso local con el saldo de la suscripción o interpretar un saldo API separado como una extensión del plan.
Consulta el medidor correcto
La documentación oficial de Usage Stats separa dos vistas con funciones diferentes.
| Vista o cuota | Qué indica | Qué no demuestra |
|---|---|---|
| App Usage | Sesiones locales de ZCode en el dispositivo actual, con tokens, mensajes, días activos y distribución por modelo | Que la cuota remota de GLM Coding Plan se haya agotado |
| Coding Plan: 5-hour | Cuota restante en la ventana corta activa | Que la cuota semanal siga disponible |
| Coding Plan: weekly | Cuota restante en el ciclo semanal | Que la ventana de 5 horas ya se haya recuperado |
| MCP quota | Uso restante para llamadas de herramientas cubiertas | Que la generación normal del modelo también esté agotada |
| Proveedor separado por API Key | Disponibilidad y saldo de ese proveedor | Una recarga del Coding Plan de Z.ai o BigModel |
Un valor alto en App Usage solo demuestra mucha actividad local. Un valor bajo tampoco garantiza cuota remota: el mismo plan puede haberse usado desde otro dispositivo, otra herramienta compatible o una conexión de equipo.
Identifica la cuota que bloquea la solicitud
Coding Plan aplica más de un límite. Revisa todos los contadores visibles antes de decidir.
La cuota de 5 horas está a cero, pero la semanal no
La ventana corta es el bloqueo inmediato. Utiliza una tarjeta de 5 horas si ZCode la muestra; de lo contrario, espera la renovación que indique la cuenta. La documentación actual del plan individual describe esos créditos como dinámicos tras el consumo, pero el momento exacto debe tomarse de la interfaz.
La cuota semanal está a cero
Un contador de 5 horas con saldo no evita un límite semanal agotado. Busca una tarjeta semanal; si no existe, espera el siguiente ciclo mostrado en la cuenta. Los planes actuales describen un ciclo de siete días, aunque planes antiguos o de equipo pueden mostrar sus propias condiciones.
Solo se agotó MCP
MCP es un fondo separado para herramientas. Una tarea que necesite búsqueda web, lectura de páginas u otra herramienta cubierta puede fallar mientras la cuota del modelo continúa disponible. Prueba una solicitud pequeña que no necesite esa herramienta. No crea cuota; solo comprueba si la ruta del modelo sigue funcionando.
Falta el panel Coding Plan o no carga
Primero investiga la conexión, no esperes una renovación a ciegas. Confirma la cuenta, el proveedor, el plan seleccionado y el acceso de red.
Verifica la conexión de cuenta y plan
Abre el selector de modelos, pulsa Manage Models y entra en Settings → Model Settings. La guía oficial Connect Models & Plans indica que, al autorizar una cuenta Z.ai con un GLM Coding Plan activo, ZCode usa directamente el plan y su cuota.
Comprueba en este orden:
- Proveedor: Z.ai o BigModel está habilitado.
- Cuenta: es la que posee la suscripción.
- Modo: está seleccionado el Coding Plan previsto, no una API Key distinta.
- Ámbito: si existen planes personal y de equipo, está activo el correcto; una entrada de equipo sin asiento asignado no aporta cuota.
- Canal actual: el chat utiliza realmente ese proveedor y plan.
La conexión también determina las tarjetas. La documentación afirma que solo se entregan cuando el usuario ha iniciado sesión en ZCode y está conectado al Coding Plan de su cuenta. Usar únicamente una API Key, o iniciar sesión con una cuenta sin plan, no cumple esa condición.
Si Connect permanece en Loading, el FAQ oficial aconseja revisar tanto el acceso de red al servicio como la cuota y los permisos de modelo de la cuenta o clave.
Usa una tarjeta solo si ZCode la muestra
ZCode 3.8.1 y versiones posteriores pueden mostrar oportunidades de reinicio de 5 horas o semanales en el panel del proveedor y en Coding Plan. Cuando exista una:
- Pulsa Reset.
- En Resettable quota, confirma qué cuota se reiniciará.
- Comprueba la caducidad.
- Úsala dentro del plazo.
- Vuelve a Coding Plan y confirma que el contador correcto llega al 100 % y la tarjeta queda marcada como utilizada.
Las tarjetas caducan. Si hay varias, la documentación indica que se consume primero la recibida antes.
Por qué puede no aparecer una tarjeta
La ausencia del botón no demuestra un fallo. Las tarjetas automáticas de 5 horas son condicionales: debe ser el periodo valle correspondiente, el uso debe superar un umbral y no debe haberse alcanzado el límite diario de entrega. Tanto la franja como el umbral son parámetros dinámicos, y la franja de tarjetas no coincide con la de idle-time tasks.
No dependas de una hora o porcentaje visto en la captura de otra persona. Solo existe una oportunidad usable cuando tu propia aplicación la muestra. Si no aparece, comprueba una vez la cuenta y organiza el trabajo según la renovación normal.
Elige cómo continuar
Opción 1: esperar la renovación de la cuota bloqueante
Es la alternativa más previsible cuando el trabajo puede pausarse. Anota si falta la cuota de 5 horas o la semanal y sigue el horario de la interfaz. Una ventana móvil no tiene por qué reiniciarse a medianoche, y recuperar la de 5 horas no anula una semanal todavía agotada.
Mientras esperas, prepara el siguiente prompt, elimina contexto innecesario, ejecuta pruebas locales o divide el trabajo en hitos verificables. No aumenta la cuota, pero reduce reintentos costosos.
Opción 2: usar una tarjeta válida
Aplícala antes de que caduque y solo a la cuota indicada. Una tarjeta de 5 horas no implica reiniciar la semanal, y una semanal no es saldo API general. La señal de éxito es que el contador objetivo vuelve al 100 %.
Opción 3: cambiar deliberadamente a otro proveedor
ZCode admite proveedores y conexiones por API Key independientes. Esto puede mantener el trabajo en marcha, pero es una ruta distinta, no cuota adicional del plan agotado.
Antes de cambiar:
- revisa la cuota, los precios y modelos del proveedor;
- selecciónalo explícitamente;
- envía una instrucción corta de prueba;
- confirma qué cuenta se cobrará;
- nunca publiques una API Key en chats, capturas o incidencias.
La guía oficial distingue Coding Plan de los paquetes de recursos o saldos API generales y advierte que la ruta de coding y la ruta general no son intercambiables. Un saldo separado puede generar cargos aparte y no restaura los contadores del plan.
Tabla rápida de diagnóstico
| Lo que ves | Interpretación probable | Siguiente paso | Señal de éxito |
|---|---|---|---|
| App Usage alto y Coding Plan sano | El historial local no es el límite remoto | Revisa el canal y el error exacto | Una petición breve funciona en el plan correcto |
| 5-hour = 0 %, weekly disponible | Bloquea la ventana corta | Tarjeta de 5 horas o espera | El contador corto vuelve a estar disponible |
| weekly = 0 % | Bloquea el ciclo semanal | Tarjeta semanal o espera | El contador semanal se recupera |
| MCP = 0 con cuota de modelo | Puede estar limitada una herramienta | Prueba sin esa herramienta y espera MCP | Funciona el modelo normal o vuelve MCP |
| No aparece Reset | No hay tarjeta elegible visible ahora | Verifica sesión y plan; no la des por garantizada | Aparece después o se produce la renovación normal |
| Connect sigue en Loading | Posible red, acceso o permiso | Revisa conectividad y cuenta/clave | El proveedor carga y responde al test |
| Se aplicó Reset y el error continúa | Cuota equivocada, vista desactualizada o canal distinto | Actualiza y confirma el canal | El contador correcto y la petición funcionan |
Si la cuota parece restaurada pero sigue fallando
Haz una comprobación controlada antes de repetir la tarea larga:
- Actualiza el proveedor y Usage Statistics → Coding Plan.
- Confirma que la cuota restaurada pertenece al mismo plan personal o de equipo seleccionado.
- Abre una conversación corta y envía una instrucción mínima.
- Si funciona, retoma la tarea desde un punto de control.
- Si falla, guarda el error exacto, hora y zona horaria, versión de ZCode, proveedor, tipo de plan y capturas de las cuotas. Oculta claves y datos sensibles.
La guía oficial de Feedback & Support recomienda incluir contexto, pasos de reproducción, capturas y registros relevantes. ZCode también ofrece feedback dentro de la aplicación y desde el banner de error.
Lista final
Antes de iniciar una sesión larga, confirma que:
- consultaste Coding Plan, no solo App Usage;
- sabes si bloquean 5-hour, weekly o MCP;
- está conectado el plan personal o de equipo correcto;
- la tarjeta corresponde a la cuota correcta y no ha caducado;
- el proveedor alternativo se trata como cuota y facturación separadas;
- una petición corta funciona en el canal elegido.
La forma fiable de resolver un límite de ZCode es diagnosticar primero el contador activo, usar únicamente la oportunidad que muestra tu cuenta y tratar cualquier proveedor alternativo como un servicio separado.
