CodexBar : surveiller sa conso Claude Code sur Mac

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 quinzaine de fournisseurs d’IA dont Claude Code, Cursor, Gemini, Copilot, OpenRouter, JetBrains AI, Perplexity, Vertex AI, Amp et bien d’autres.

Le rythme de développement est soutenu : la version 0.18 sortie en mars 2026 a ajouté plusieurs providers (Kilo, Ollama, OpenRouter), un onglet Overview en mode merge, et une commande codexbar cost pour le suivi des coûts depuis le terminal.

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.

Pourquoi pas le dashboard Claude natif ?

Question légitime. Claude Code affiche déjà votre utilisation quelque part. Le souci, c’est qu’il faut garder une fenêtre ouverte ou aller vérifier manuellement. CodexBar rend cette info permanente dans votre barre de menu, visible d’un coup d’œil sans interrompre votre travail.

L’autre avantage, c’est le multi-providers. Si vous jonglez entre Claude Code, Cursor et Codex (ce qui arrive vite quand on teste des outils), tout est centralisé au même endroit. Le widget macOS et la CLI complètent le tableau pour ceux qui veulent intégrer le suivi dans leurs scripts.

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, Perplexity, Vertex AI, Amp, 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.

Depuis la v0.18, un mode « percent » optionnel affiche directement le pourcentage d’utilisation à côté de l’icône du provider dans la barre de menu. Encore plus lisible.

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.

La nouveauté récente : un onglet Overview qui affiche jusqu’à trois providers côte à côte. De quoi comparer votre consommation sans cliquer partout.

CLI intégré et suivi des coûts

CodexBar embarque aussi un outil en ligne de commande (codexbar) qui permet de récupérer les mêmes informations depuis le terminal. La commande codexbar cost affiche le suivi des coûts en texte ou JSON pour Codex et Claude. 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 et troubleshooting

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.

Authentification Claude Code

Pour Claude Code, CodexBar propose plusieurs modes d’authentification. Le mode « Auto » est le plus pratique : il utilise l’OAuth API en priorité, avec un cache dans le Keychain macOS pour éviter les prompts répétitifs. Si l’OAuth échoue, il bascule automatiquement vers la CLI.

Si vous voyez des prompts d’authentification revenir sans cesse, vérifiez que vos credentials OAuth ne sont pas expirés. Un simple claude login dans le terminal suffit généralement à régler le problème.

Cookies Safari et Full Disk Access

Si vous utilisez les fonctionnalités basées sur les cookies Safari (pour les providers web comme Codex ou Cursor), macOS vous demandera d’accorder le Full Disk Access à CodexBar. C’est une exigence Apple pour accéder aux cookies de Safari, pas un caprice de l’application. Si vous utilisez Chrome ou Firefox pour ces services, cette permission n’est pas nécessaire.

Données qui ne se rafraîchissent pas ?

Vérifiez d’abord la fréquence de rafraîchissement dans les réglages (réglable de 1 à 15 minutes). Si le problème persiste, CodexBar cherche la CLI Claude dans plusieurs emplacements (~/.claude/local/claude, ~/.claude/bin/claude). Si vous avez une installation atypique, un lien symbolique vers l’un de ces chemins peut résoudre le souci.

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. À côté de cela, un widget macOS est disponible, ce qui compense en partie. Si vous êtes dans l’écosystème Apple et que vous avez intégré Claude Code dans votre workflow comme je l’ai fait pour gérer tout mon blog, c’est un compagnon qui se rend vite indispensable.

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 qui change vraiment la donne.

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.