CodexBar : l’app indispensable pour surveiller votre usage de Claude Code

Quand on utilise Claude Code au quotidien, il y a une question qui revient sans cesse : combien de tokens me reste-t-il avant la prochaine fenêtre de reset ? CodexBar répond à cette question directement depuis la barre de menu de votre Mac. Voici mon retour après plusieurs semaines d’utilisation quotidienne.

Pour la petite histoire

CodexBar a été créé par Peter Steinberger, un développeur bien connu dans l’écosystème Apple. Le projet est open source, hébergé sur GitHub, et compte déjà plus de 7 400 étoiles et 81 contributeurs. À l’origine, l’application se concentrait sur le suivi de l’usage d’OpenAI Codex. Depuis, elle s’est élargie pour supporter une dizaine de fournisseurs d’IA dont Claude Code, Cursor, Gemini, Copilot et bien d’autres.

Qu’est-ce que CodexBar ?

CodexBar est une petite application macOS (14+ minimum) qui se loge dans votre barre de menu. Son rôle est simple : vous montrer en un coup d’œil où vous en êtes dans votre consommation de tokens pour les différents outils d’IA que vous utilisez. Plus besoin d’aller fouiller dans un dashboard web ou de se connecter à une interface de gestion.

Concrètement, vous avez une petite icône dans la barre de menu avec deux barres : l’une pour la session en cours (fenêtre de 5 heures) et l’autre pour l’usage hebdomadaire. De quoi savoir immédiatement si vous pouvez lancer une grosse session de code ou s’il vaut mieux attendre le prochain reset.

Les fonctionnalités

Suivi multi-fournisseurs

C’est le gros point fort de CodexBar. L’application supporte une longue liste de providers : Claude Code, OpenAI Codex, Cursor, Gemini, Copilot, Kiro, Augment, JetBrains AI, OpenRouter, et d’autres encore. Vous activez ceux que vous utilisez dans les réglages et le reste se fait tout seul. De mon côté, je l’utilise principalement pour Claude Code, mais c’est rassurant de savoir que le jour où je teste un autre outil, CodexBar sera déjà prêt.

Session et usage hebdomadaire

Pour chaque fournisseur, CodexBar affiche l’usage de la session en cours ainsi que l’usage hebdomadaire, avec un compte à rebours avant le prochain reset. C’est exactement l’information que je cherchais chaque jour sans jamais la trouver facilement.

Mode « Merge Icons »

Si vous utilisez plusieurs providers, vous pouvez fusionner toutes les icônes en une seule dans la barre de menu avec un sélecteur de provider. Pratique pour ne pas encombrer votre barre de menu si vous êtes du genre à avoir déjà 15 icônes là-haut.

CLI intégré

CodexBar embarque aussi un outil en ligne de commande (codexbar) qui permet de récupérer les mêmes informations depuis le terminal. De quoi intégrer le suivi de coûts dans vos scripts ou workflows CI si vous le souhaitez. Il fonctionne aussi sous Linux, ce qui est un plus.

Vie privée respectée

Point important : CodexBar ne scanne pas votre disque. L’application lit uniquement quelques emplacements connus (cookies de navigateur, logs locaux en JSONL) quand les fonctionnalités associées sont activées. Pas d’icône dans le Dock, pas de permissions excessives demandées. Le Full Disk Access n’est requis que si vous utilisez les cookies Safari.

Installation

L’installation est simple. Vous pouvez télécharger l’application directement depuis les releases GitHub, ou passer par Homebrew avec la commande :

brew install --cask steipete/tap/codexbar

Une fois lancée, il suffit d’aller dans les réglages, d’activer les providers que vous utilisez, et c’est parti. Pour Claude Code, l’application récupère les informations via l’OAuth API ou les cookies de navigateur.

Mon retour

De mon côté, j’utilise CodexBar depuis plusieurs semaines et c’est devenu un réflexe. Avant, je me retrouvais régulièrement à atteindre mes limites sans m’être rendu compte que j’étais proche du plafond ou alors à avoir une fenêtre Claude ouverte en permanence avec l’affichage de l’utilisation. Maintenant, un simple coup d’œil à la barre de menu me donne toutes les infos nécessaires.

Ce que j’apprécie particulièrement, c’est la légèreté de l’application. Elle ne consomme quasiment rien en ressources et se fait totalement oublier. La fréquence de rafraîchissement est réglable (de 1 minute à 15 minutes, voire en mode manuel), ce qui permet d’adapter le comportement à vos besoins.

La seule chose que je pourrais regretter, c’est l’absence d’une version native pour iOS. Ce serait pratique de pouvoir vérifier son usage depuis l’iPhone. A côté de cela, un widget macOS est disponible, ce qui compense en partie.

Mais à qui s’adresse CodexBar ?

Si vous utilisez Claude Code, Codex ou Cursor régulièrement et que vous voulez garder un œil sur votre consommation sans devoir ouvrir un navigateur, CodexBar est fait pour vous. C’est gratuit, open source, et ça fonctionne très bien.

Si vous ne codez qu’occasionnellement avec ces outils, l’intérêt est évidemment moindre. Mais pour ceux qui, comme moi, ont intégré Claude Code dans leur workflow quotidien, c’est un compagnon indispensable.

Quoi qu’il en soit, si vous êtes sur Mac et que le sujet vous parle, foncez ! Le projet est disponible sur GitHub ou via Homebrew.