Check Usage (Vérifier la consommation)

Check Usage (Vérifier la consommation) répond à une seule question : combien reste-t-il sur le forfait de chaque fournisseur, et quand se recharge-t-il ? Elle a un onglet par fournisseur, avec des jauges pour les limites, leurs heures de réinitialisation et des détails repliés en dessous. Utilisez-la avant de lancer une longue tâche, ou pour comprendre pourquoi un turn a été refusé. Ce n’est pas la même chose que le bouton 🧠, qui montre à quel point la fenêtre de contexte d’une conversation est remplie. Voir La fenêtre de contexte.

L’ouvrir #

Ouvrez le menu ⋯ de l’en-tête de la conversation et choisissez 📊 Check Usage. L’entrée est là, qu’une conversation soit ouverte ou non. Elle n’est pas dans une vue partagée en lecture seule. La boîte de dialogue a pour titre Plan usage (Consommation du forfait). Son sous-titre compte les fournisseurs qui transmettent des jauges et la prochaine réinitialisation, par exemple 3 providers reporting · next reset in 2 h 10 min.

Les onglets, dans cet ordre :

La boîte de dialogue s’ouvre sur l’onglet de la conversation où vous êtes. Un chat Claude Cloud s’ouvre sur Claude Cloud, un chat Claude API sur Claude API. Elle s’ouvre sur le premier onglet, Copilot, quand aucune conversation n’est ouverte, ou quand le fournisseur de la conversation n’a pas d’onglet : un chat OpenAI avec votre propre clé, un chat d’images, ou un chat Claude Cloud alors que Claude Cloud est désactivé. Voir OpenAI.

Lire une carte #

Chaque carte a un titre, des badges, des jauges et des sections repliées avec les détails. Une jauge est une barre avec un pourcentage, une ligne comme 120 of 1500 used · 1380 left, et un compte à rebours jusqu’à la réinitialisation (resets in 3 d 4 h, ou une date quand elle est à plus de 14 jours). Un crédit qui prend fin définitivement affiche expires au lieu de resets. La barre est verte sous 50 %, change de couleur à 50 et à 75 %, et devient rouge à 90. Une jauge qui est une estimation porte un petit indicateur estimated (Estimé). Une limite proche porte le mot d’avertissement propre au fournisseur. La carte se termine par une ligne Updated <date> <time> UTC et des liens vers la page de consommation ou de facturation du fournisseur.

Les badges disent ce qu’est la carte :

L’heure Updated (Mis à jour) est celle de la lecture dont viennent les jauges, avec deux exceptions : sur Cursor, c’est le dernier turn qu’OAR a comptabilisé, et sur Grok le dernier turn qu’il a enregistré, même quand des barres en direct sont affichées. Une carte sans rien à signaler n’a pas d’heure.

Actualisation et fraîcheur des chiffres #

La boîte de dialogue n’attend pas tous les fournisseurs. Elle affiche aussitôt la lecture qu’elle avait montrée la dernière fois (votre navigateur la garde jusqu’à ce que vous fermiez l’onglet du navigateur) et ne lit en direct que le fournisseur de l’onglet ouvert. La carte affiche updating… à côté de son titre jusqu’à l’arrivée de la réponse. Un fournisseur pour lequel le relais n’a aucune réponse antérieure est lu une fois lui aussi.

• Refresh (Actualiser), en haut, lit l’onglet ouvert en direct. Il n’actualise rien d’autre.
• Passer à un autre onglet lit ce fournisseur en direct si sa lecture date de plus d’une minute.
• Les onglets que vous n’avez pas ouverts affichent la dernière réponse en direct du relais pour ce fournisseur ; une carte n’est donc pas vide du seul fait que vous ne l’avez pas encore regardée.

Quand une lecture en direct échoue, la carte se rabat sur ce qu’elle a, s’il y a quelque chose :

• Claude : la lecture du dernier turn Claude, avec Live account usage could not be read, so this is the reading of the last Claude turn. et la raison. La lecture abandonne au bout de 3 secondes.
• Copilot sans détail de facturation : Detailed billing data unavailable et la raison, les jauges étant conservées. Si le quota lui-même ne peut pas être lu, la carte affiche une Error avec la raison, et aucun quota antérieur.
• Claude Cloud, Cursor, Grok : les dépenses qu’OAR a comptées lui-même.
• DeepSeek : le dernier solde lu, avec son heure, et les dépenses qu’OAR a comptées lui-même.

Une carte sans rien à montrer dit pourquoi dans la ligne sous son titre et reçoit un badge Error, Unavailable ou Not configured.

Par fournisseur #

GitHub Copilot #

La carte lit le quota de votre compte Copilot sur les deux moteurs. Elle utilise GH_TOKEN ou GITHUB_TOKEN de l’environnement du relais quand l’un d’eux est défini, et sinon la connexion de gh sur la machine du relais. Ses badges sont le nom du forfait tel que GitHub le signale et Live. Elle est lue en direct à chaque actualisation de l’onglet, et ne porte donc jamais Cached.

Chaque jauge montre le consommé, l’allocation, ce qui reste et la date de réinitialisation. GitHub signale un jour calendaire, et OAR le compte à partir de minuit UTC.

Les sections repliées ajoutent :

• Billed usage this period (Consommation facturée sur la période), By model (Par modèle) et By product (Par produit) : ce qu’a coûté la période, en dollars. Elles n’apparaissent que si votre token GitHub peut lire la facturation personnelle ; un simple token gh ne le peut souvent pas, et les jauges sont complètes sans elles.
• Last SDK worker turn (Dernier turn du worker SDK), sur le moteur SDK : les crédits d’IA qu’a dépensés ce turn, ses tokens d’entrée, de sortie et de contexte, les appels au modèle et le dépassement, avec le modèle et depuis combien de temps il a été capturé. Ce sont les chiffres d’un seul turn, pas un total cumulé, et ils disparaissent au bout de sept jours.

La ligne sous chaque réponse Copilot (+N crédits, month N% left) appartient à ce seul turn ; la carte est l’état actuel du compte. Voir GitHub Copilot.

Claude #

La carte Claude montre les limites de votre abonnement Claude sous forme de jauges :

Chaque fenêtre montre son taux d’utilisation et le moment de sa réinitialisation. Sous son titre, la carte nomme le compte Claude connecté (voir ce que la boîte de dialogue montre de vous). Les sections repliées montrent Latest session totals (Totaux de la dernière session), avec le coût, le temps d’API et le temps réel et les lignes modifiées, By model (session) (Par modèle, session) avec les tokens, et What is driving usage (Ce qui fait la consommation) pour les dernières 24 heures et les 7 derniers jours. Cette dernière est approximative : elle est calculée uniquement à partir des fils de conversation présents sur la machine du relais.

Il y a deux sources, et le badge indique laquelle vous voyez :

• Dernier turn. Sans Claude Cloud, les chiffres sont lus depuis la session active à la fin d’un turn Claude. Le relais ne lance jamais de turn caché pour les actualiser ; la lecture a donc l’âge de votre dernier turn Claude, et le badge affiche Cached. Avant le premier turn, la carte indique qu’aucune consommation n’a encore été capturée. Une session qui se connecte avec une clé d’API ou un fournisseur tiers n’a pas de limites de forfait, et ne montre que le coût de sa session.
• Live Ajouté en 0.9.7. Avec Claude Cloud activé, les limites sont lues depuis le compte quand la boîte de dialogue lit l’onglet Claude ou Claude Cloud (conservées une minute), sans aucun turn. La carte reçoit un badge Live, le mot d’avertissement du fournisseur sur une limite qui approche, This week by product (Cette semaine par produit), qui montre Claude Code, les chats et les autres produits en parts de la semaine, et les Prepaid credits (Crédits prépayés) de l’organisation quand il y en a. Les réinitialisations de limites (complète et 5 heures) ne sont affichées que sur claude.ai ; la carte y renvoie.

Un turn qui atteint une limite est mis en pause et reprend après la réinitialisation. Voir Quand une limite d’utilisation est atteinte.

Claude Cloud #

L’onglet Claude Cloud n’apparaît que si l’interrupteur Enable Claude Cloud for New Chat (Activer Claude Cloud dans Nouveau chat) est activé sous Settings → Providers → Claude Cloud (Réglages → Fournisseurs → Claude Cloud). C’est aussi cet interrupteur qui permet au relais de lire les chiffres du compte avec la connexion de la CLI Claude. Voir Claude Cloud.

La carte comporte :

• une jauge par crédit en dollars que détient le compte : consommé, restant, et date d’expiration ;
• Cloud spend (OAR sessions) (Dépenses cloud, sessions OAR) : le coût qu’Anthropic signale par session cloud, additionné sur les conversations cloud que ce relais possède encore. Quand vous ouvrez la boîte de dialogue depuis un chat cloud, la section repliée montre aussi le coût propre de ce chat ;
• Latest cloud session report (Dernier rapport de session cloud) : son coût et ses durées signalés, et By model (latest cloud session report) (Par modèle, dernier rapport de session cloud) avec les tokens.

Ce sont les coûts signalés par Anthropic, pas un relevé de facturation, et les sessions démarrées ailleurs ne sont pas comptées. Un crédit offert mais pas encore réclamé est mentionné avec un lien vers claude.ai. Les turns cloud dépensent d’abord le crédit cloud ; sans crédit, ils comptent sur les limites Claude de l’onglet Claude. Si le compte ne peut pas être lu, la carte affiche The account usage could not be read, so a cloud credit is not shown. et garde les dépenses qu’elle connaît.

Claude API Ajouté en 0.9.18 #

L’onglet Claude API est là tant qu’une clé est enregistrée dans Settings → Providers → Claude API (Réglages → Fournisseurs → Claude API), même avec Claude API désactivé, pour que les dépenses du mois restent visibles. Sa carte parle d’argent : ce que les turns de ce relais sur la clé ont coûté, selon l’estimation, aujourd’hui et ce mois-ci, par modèle, avec leurs tokens, et une barre Monthly cap (Plafond mensuel) quand un plafond est défini. Les chiffres sont l’estimation propre de Claude Code d’après sa table de prix ; la page de facturation de la Console, accessible depuis la carte par Console billing (Facturation Console), a les vrais chiffres et le solde. Un modèle dont Claude Code ne connaît pas le prix affiche no price known, jamais 0 $. Le badge affiche From last turn.

Tout ce que montre la carte est expliqué sur Claude API, avec le plafond mensuel.

Cursor #

Cursor n’indique pas à OAR ce que comprend votre forfait ; la carte a donc deux sources et dit laquelle elle a utilisée. Les réglages, les enveloppes et le token sont décrits sur Cursor. Tant que Cursor est désactivé, la carte affiche Cursor is not enabled in provider settings.

• Dépenses depuis OAR, une estimation. Après chaque turn, OAR impute les dépenses facturées de l’agent au cycle de facturation en cours, dans l’enveloppe Cursor Models (Modèles Cursor) ou Other Models (Autres modèles) selon le modèle qui l’a exécuté. Une troisième, Unclassified (Non classé), n’apparaît que s’il y a des dépenses qu’OAR ne peut pas attribuer. Par rapport à l’allocation mensuelle que vous avez saisie pour une enveloppe, la jauge montre le consommé et le restant ; sans allocation, elle ne montre que les dépenses. Les jauges mesurent le coût brut du modèle ; les sections repliées listent ce que Cursor a réellement facturé, souvent 0,00 $ pour une utilisation incluse dans le forfait. Les badges affichent Manual allowance et Estimated, et la carte renvoie au tableau de bord Spending de Cursor, qui fait foi.
• Barres du forfait en direct, depuis le tableau de bord. Avec un token de session du tableau de bord, la carte ajoute les barres Plan usage (total) (Consommation du forfait, total), Auto + Composer et API lues en direct depuis Cursor, un badge avec le nom du forfait, une section Plan (live) (Forfait, en direct) avec les dépenses incluses et à la demande, et les vraies dates du cycle. Le badge devient Live et les jauges des enveloppes passent au second plan. Si Cursor refuse le token, ou si aucun n’est trouvé, la carte le dit et se rabat sur les estimations.

Grok #

L’onglet Grok n’apparaît que si Grok est activé. Les réglages sont sur Grok.

• Weekly plan usage (Consommation hebdomadaire du forfait) est un pourcentage en direct avec l’heure de réinitialisation, lu avec la connexion de la CLI Grok sur la machine du relais, avec la part de chaque produit quand le compte la signale. Un forfait sur une autre période affiche Plan usage et la période. Sans connexion CLI, ou quand le compte ne signale pas ce chiffre, la barre est absente.
• Estimated monthly spend (Dépenses mensuelles estimées) apparaît quand vous saisissez une Monthly allowance (USD) (Allocation mensuelle, USD) sous Settings → Providers → Grok (Réglages → Fournisseurs → Grok). Elle compare le décompte qu’OAR fait lui-même des turns Grok avec votre budget, et elle est signalée comme estimation. Grok ne signale aucun solde en dollars. Le badge affiche Estimated quand aucun chiffre en direct n’est affiché.
• Latest turn (Dernier turn) et By model (last turn) (Par modèle, dernier turn) viennent du rapport de l’agent sur son dernier turn : coût (une estimation), modèle, tokens et temps d’API. Current cycle (local) (Cycle en cours, local) additionne les turns Grok de ce relais depuis la réinitialisation de la facturation.

Sans chiffre en direct ni turn, la carte indique qu’aucune consommation Grok n’a été capturée.

DeepSeek #

Ajouté en 0.9.17 L’onglet DeepSeek n’apparaît que si DeepSeek est activé. Sa carte parle d’argent, pas de limites. Elle montre le solde du compte, lu avec la clé enregistrée, et ce qu’ont coûté les turns DeepSeek de ce relais, qu’OAR estime d’après les prix publiés par DeepSeek. Les turns faits ailleurs avec la même clé ne sont pas comptés. La carte trace une barre de solde, les dépenses quotidiennes des 30 derniers jours, où va l’argent par modèle, et une barre de budget mensuel quand vous définissez un budget. Elle renvoie à la page de consommation de DeepSeek et à sa page de recharge. Pour les jours couverts par un export de consommation que vous importez sur l’onglet des réglages DeepSeek, elle montre les chiffres propres de DeepSeek au lieu de l’estimation ; voir Importer un export de consommation.

Tout ce que montre la carte est expliqué sur DeepSeek, avec le budget mensuel, le solde initial, et la façon dont l’estimation est faite et ce qu’elle laisse de côté.

OpenAI avec votre propre clé #

OpenAI avec votre propre clé n’a pas d’onglet : OAR ne le mesure pas, et le tableau de bord du fournisseur montre vos dépenses. Depuis un chat OpenAI, Check Usage s’ouvre sur le premier onglet, Copilot, et vous pouvez passer à n’importe quel autre. Les turns OpenAI n’ont pas non plus de ligne de consommation sous la réponse. Voir OpenAI.

Récapitulatif #

Ce que la boîte de dialogue montre de vous #

La boîte de dialogue peut être à l’écran pendant que vous partagez votre écran ; voici donc la liste complète de ce qu’elle montre de vous.

• Noms de forfait. Le badge de chaque carte montre le forfait que signale le fournisseur, comme le forfait GitHub Copilot, Claude ou Cursor.
• Dépenses et consommation. Montants en dollars, crédits, pourcentages, noms de modèles, nombres de tokens, sur Claude Cloud le coût de ce chat, et sur DeepSeek le solde du compte. La carte Claude API ne montre aucun solde. Les crédits prépayés de Claude sont ceux de l’organisation.
• Rien d’autre. Aucune carte ne montre une clé d’API, un token de connexion ou un token de session, et aucune carte ne montre un nom de compte GitHub ou xAI. Le token du tableau de bord Cursor et la connexion de la CLI Claude restent sur le relais.

Chaque chiffre concerne le compte qu’utilise le relais. Les estimations ne comptent que les turns exécutés sur ce relais ; les barres en direct sont celles du compte.

Ce que voient les agents #

Un agent peut lire les mêmes chiffres avec l’action usage de relay_tool, sur son propre relais ou sur un relais associé : par fournisseur, son statut, le nom du forfait, les jauges (consommé, allocation, restant, taux d’utilisation, heure de réinitialisation), le message et les notes de la carte, les lignes des sections repliées, et si une limite d’utilisation Claude a mis des turns en pause là-bas. Il interroge chaque fournisseur en direct, ce qui peut prendre quelques secondes.

L’agent reçoit moins que vous. Il ne voit aucun nom de compte, aucune adresse e-mail et aucun lien ; la ligne du compte Claude ne lui parvient donc jamais, et dans un texte qui contient une adresse ou une longue chaîne ressemblant à un token, celle-ci est remplacée par [address] ou [hidden]. Les fournisseurs non configurés reviennent avec ce statut. Chaque texte est coupé à 300 caractères, et la réponse contient au plus 12 fournisseurs, 12 jauges par fournisseur et 8 sections de détail.