Limite ZCode atteinte : vérifier les quotas GLM Coding Plan et les cartes de réinitialisation
Guide pratique pour distinguer App Usage des quotas distants du GLM Coding Plan, identifier le compteur bloquant, vérifier le compte connecté, utiliser une carte avant son expiration et choisir une reprise sûre.
Sommaire
Quand ZCode indique qu’une limite est atteinte, ne partez pas du graphique local des tokens. Ouvrez Usage Statistics → Coding Plan, consultez les compteurs de 5 heures et hebdomadaire, puis identifiez celui qui est réellement épuisé. Si un bouton Reset apparaît, ouvrez le panneau, vérifiez le quota concerné et la date d’expiration de la carte. S’il n’y a pas de carte, assurez-vous que ZCode est connecté au bon compte Z.ai ou BigModel et au Coding Plan de ce compte. Vous pourrez ensuite attendre le renouvellement, utiliser une carte éligible ou basculer volontairement vers un autre fournisseur doté de son propre quota et de sa propre facturation.
La distinction essentielle est la suivante : App Usage est un historique local, Coding Plan est un quota distant d’abonnement, et une API Key générale possède son propre accès et sa propre facturation. Aucun de ces indicateurs ne recharge ni ne prouve automatiquement l’état des autres.
Ce guide a été vérifié à partir de la documentation officielle ZCode et Z.ai le 3 octobre 2026. Les règles et l’éligibilité peuvent évoluer ; les compteurs et options visibles dans votre compte font foi.
Le diagnostic en 60 secondes
- Ouvrez Usage Statistics et choisissez Coding Plan, pas App Usage.
- Vérifiez les quotas de 5 heures, hebdomadaire et, si la tâche utilisait des outils, MCP.
- Confirmez que le bon Coding Plan Z.ai ou BigModel et le bon compte personnel ou d’équipe sont actifs.
- Si Reset est visible, lisez le type de quota et l’expiration avant de l’utiliser.
- Sans carte, attendez le renouvellement affiché par le compteur épuisé ou sélectionnez consciemment un autre fournisseur configuré.
- Avant de reprendre une tâche longue, envoyez une courte instruction de test.
Cette séquence évite de prendre des statistiques locales pour le solde de l’abonnement ou un solde API séparé pour une extension du plan.
Consultez le bon compteur
La documentation officielle Usage Stats sépare deux vues qui répondent à des questions différentes.
| Vue ou quota | Ce qu’il indique | Ce qu’il ne prouve pas |
|---|---|---|
| App Usage | Les sessions ZCode locales sur l’appareil actuel : tokens, messages, jours actifs et répartition des modèles | Que le quota distant du GLM Coding Plan est épuisé |
| Coding Plan: 5-hour | Le solde de la fenêtre courte active | Que le quota hebdomadaire est encore disponible |
| Coding Plan: weekly | Le solde du cycle hebdomadaire | Que la fenêtre de 5 heures est déjà revenue |
| MCP quota | Les appels restants pour les outils couverts | Que la génération normale du modèle est elle aussi épuisée |
| Fournisseur séparé par API Key | La disponibilité et le quota de ce fournisseur | Une recharge du Coding Plan Z.ai ou BigModel |
Une valeur élevée dans App Usage démontre seulement une forte activité locale. Une valeur faible ne garantit pas non plus un quota distant : le plan peut avoir été utilisé sur un autre appareil, dans un autre outil compatible ou via une connexion d’équipe.
Identifiez le quota qui bloque la requête
Le Coding Plan impose plusieurs limites. Examinez tous les compteurs visibles avant de choisir une solution.
Le quota de 5 heures est à zéro, mais le quota hebdomadaire ne l’est pas
La fenêtre courte bloque immédiatement. Utilisez une carte de 5 heures si ZCode en affiche une ; sinon, attendez le renouvellement indiqué par le compte. La documentation actuelle du plan individuel décrit ces crédits comme renouvelés dynamiquement après consommation, mais l’heure exacte doit provenir de l’interface.
Le quota hebdomadaire est à zéro
Un compteur de 5 heures positif ne contourne pas un quota hebdomadaire épuisé. Recherchez une carte hebdomadaire ; à défaut, attendez le prochain cycle affiché. Les plans actuels mentionnent un cycle de sept jours, tandis que les anciens plans et les plans d’équipe peuvent afficher leurs propres règles.
Seul le quota MCP est épuisé
MCP constitue une réserve séparée pour les outils. Une tâche nécessitant une recherche web, un lecteur de pages ou un autre outil couvert peut échouer alors que le quota du modèle reste disponible. Envoyez une petite requête qui n’utilise pas cet outil. Ce test n’ajoute aucun quota ; il indique seulement si le canal du modèle fonctionne encore.
Le panneau Coding Plan manque ou ne se charge pas
Commencez par examiner la connexion. Vérifiez le compte, le fournisseur, le plan sélectionné et l’accès réseau avant d’attendre un renouvellement qui ne concerne peut-être pas la connexion active.
Vérifiez le compte et le plan connectés
Ouvrez le sélecteur de modèles, cliquez sur Manage Models, puis allez dans Settings → Model Settings. Le guide officiel Connect Models & Plans précise qu’un compte Z.ai autorisé et doté d’un GLM Coding Plan actif utilise directement ce plan et son quota.
Contrôlez les éléments suivants dans cet ordre :
- Fournisseur : Z.ai ou BigModel est activé.
- Compte : il s’agit bien du compte propriétaire de l’abonnement.
- Mode : le Coding Plan voulu est sélectionné, et non une autre API Key.
- Périmètre : si des plans personnel et d’équipe existent, le bon est actif ; une équipe sans siège attribué ne fournit pas de quota.
- Canal courant : la conversation utilise réellement ce fournisseur et ce plan.
Cette connexion détermine également l’éligibilité aux cartes. La documentation indique qu’elles ne sont distribuées qu’aux utilisateurs connectés à ZCode et au Coding Plan de leur compte. Une API Key seule, ou un compte sans plan, ne remplit pas cette condition.
Si Connect reste sur Loading, la FAQ officielle recommande de vérifier l’accès réseau au service ainsi que le quota et les autorisations de modèle du compte ou de la clé.
Utilisez une carte uniquement si ZCode l’affiche
ZCode 3.8.1 et les versions ultérieures peuvent afficher des possibilités de réinitialisation de 5 heures ou hebdomadaires dans le panneau du fournisseur et dans Coding Plan. Lorsqu’une carte est disponible :
- Cliquez sur Reset.
- Dans Resettable quota, confirmez le quota concerné.
- Vérifiez l’expiration.
- Utilisez la carte dans le délai.
- Revenez dans Coding Plan et confirmez que le bon compteur atteint 100 % et que la carte est marquée comme utilisée.
Les cartes expirent. S’il y en a plusieurs, la documentation précise que la plus ancienne est consommée en premier.
Pourquoi aucune carte ne s’affiche parfois
L’absence du bouton ne prouve pas un dysfonctionnement. Les cartes automatiques de 5 heures sont conditionnelles : il faut se trouver dans la période creuse concernée, dépasser un seuil d’utilisation et ne pas avoir atteint la limite quotidienne de distribution. La fenêtre et le seuil sont dynamiques, et cette période creuse n’est pas celle des idle-time tasks.
Ne vous fiez donc pas à une heure ou à un pourcentage aperçu dans la capture d’un autre utilisateur. Une carte est utilisable uniquement lorsque votre propre application l’affiche. Sans carte, vérifiez une fois le compte puis organisez le travail selon le renouvellement normal.
Choisissez comment reprendre
Option 1 : attendre le renouvellement du quota bloquant
C’est le choix le plus prévisible si le travail peut être interrompu. Notez si le quota épuisé est celui de 5 heures ou le quota hebdomadaire et suivez l’heure affichée. Une fenêtre glissante ne se renouvelle pas forcément à minuit, et le retour du quota court ne neutralise pas un quota hebdomadaire encore vide.
Pendant l’attente, préparez le prochain prompt, retirez le contexte inutile, exécutez des tests locaux ou divisez la tâche en étapes vérifiables. Cela ne crée pas de quota, mais réduit les tentatives inutiles après le renouvellement.
Option 2 : utiliser une carte éligible
Utilisez-la avant expiration et seulement pour le quota indiqué. Une carte de 5 heures ne réinitialise pas nécessairement le quota hebdomadaire, et une carte hebdomadaire n’est pas un solde API général. Le signal de réussite est le retour du compteur ciblé à 100 %.
Option 3 : basculer volontairement vers un autre fournisseur
ZCode accepte des fournisseurs et connexions par API Key indépendants. Cela peut permettre de continuer, mais il s’agit d’une autre voie, pas d’un prolongement de l’abonnement épuisé.
Avant de basculer :
- vérifiez le quota, les tarifs et les modèles du fournisseur ;
- sélectionnez-le explicitement ;
- envoyez une courte instruction de test ;
- identifiez le compte qui sera facturé ;
- ne placez jamais une API Key secrète dans une conversation, une capture ou une issue publique.
Le guide officiel distingue le Coding Plan des packs de ressources ou soldes API généraux et avertit que le point d’accès de coding et le point d’accès général ne sont pas interchangeables. Un solde séparé peut donc entraîner des frais séparés et ne restaure pas les compteurs du plan.
Tableau de diagnostic rapide
| Ce que vous voyez | Interprétation probable | Action suivante | Signe de réussite |
|---|---|---|---|
| App Usage élevé, Coding Plan normal | L’historique local n’est pas la limite distante | Vérifiez le canal et l’erreur exacte | Une courte requête réussit sur le bon plan |
| 5-hour = 0 %, weekly disponible | La fenêtre courte bloque | Carte 5 heures ou attente | Le compteur court redevient disponible |
| weekly = 0 % | Le cycle hebdomadaire bloque | Carte hebdomadaire ou attente | Le compteur hebdomadaire revient |
| MCP = 0 avec quota modèle | Un outil peut être limité | Test sans cet outil puis attente MCP | Le modèle simple fonctionne ou MCP revient |
| Aucun Reset | Aucune carte éligible n’est visible | Vérifiez connexion et plan, sans considérer la carte comme due | Une carte apparaît ou le renouvellement normal arrive |
| Connect reste sur Loading | Réseau, accès ou autorisation possibles | Vérifiez la connexion et le compte/la clé | Le fournisseur charge et répond au test |
| Reset appliqué, erreur persistante | Mauvais quota, écran obsolète ou autre canal | Actualisez et confirmez le canal | Le bon compteur et la requête fonctionnent |
Si le quota semble restauré mais que la requête échoue encore
Effectuez une vérification contrôlée avant de répéter la tâche longue :
- Actualisez le fournisseur et Usage Statistics → Coding Plan.
- Confirmez que le quota restauré appartient au même plan personnel ou d’équipe que celui sélectionné.
- Ouvrez une courte conversation et envoyez une instruction minimale.
- Si elle réussit, reprenez la grande tâche depuis un point de contrôle.
- Si elle échoue, relevez l’erreur exacte, l’heure et le fuseau, la version de ZCode, le fournisseur, le type de plan et des captures des quotas. Masquez les clés et données sensibles.
Le guide officiel Feedback & Support recommande de fournir le contexte, les étapes de reproduction, les captures et les journaux pertinents. ZCode permet aussi d’envoyer un signalement depuis l’application ou la bannière d’erreur.
Vérification finale
Avant une longue session, confirmez que :
- vous avez consulté Coding Plan, pas seulement App Usage ;
- vous savez si 5-hour, weekly ou MCP bloque ;
- le bon compte et le bon plan personnel ou d’équipe sont connectés ;
- la carte correspond au bon quota et n’est pas expirée ;
- un fournisseur alternatif est traité comme un quota et une facturation séparés ;
- une courte requête fonctionne sur le canal choisi.
La méthode fiable consiste à diagnostiquer d’abord le compteur actif, à n’utiliser que l’opportunité réellement affichée par votre compte et à traiter tout fournisseur alternatif comme un service distinct.
