Premiers pas

Prérequis

  • macOS 14 (Sonoma) ou ultérieur
  • Un abonnement Claude Pro, Max ou Team (le suivi d'usage nécessite un abonnement actif)
  • Claude Code installé (TokenEater lit vos identifiants Claude automatiquement)
TokenEater lit votre token OAuth Claude Code depuis ~/.claude/.credentials.json. Aucune configuration manuelle n'est nécessaire.

Installation

Télécharger le DMG (recommandé)

Télécharger TokenEater.dmg

Ouvrez le DMG, glissez TokenEater dans Applications, puis :

  1. Double-cliquez sur TokenEater dans Applications - macOS va le bloquer
  2. Ouvrez Réglages système → Confidentialité et sécurité - descendez pour trouver le message concernant TokenEater
  3. Cliquez sur Ouvrir quand même et confirmez
N'utilisez pas xattr -cr pour contourner Gatekeeper - cela empêche macOS d'approuver l'extension widget, qui sera alors signalée comme malware dans la galerie de widgets. Utilisez toujours Réglages système → Ouvrir quand même.

Homebrew

bash
brew tap AThevon/tokeneater
brew install --cask tokeneater

Mise à jour

TokenEater vérifie les mises à jour automatiquement. Quand une nouvelle version est disponible, une modale vous permet de la télécharger et l'installer directement depuis l'app - macOS demandera votre mot de passe admin.

Si installé via Homebrew : brew upgrade --cask tokeneater

Réinstallation propre

Si quelque chose ne fonctionne pas, lancez un nettoyage complet (voir la page FAQ & Dépannage pour le script complet), puis réinstallez depuis le dernier DMG.

Désinstallation

bash
rm -rf /Applications/TokenEater.app
rm -rf ~/Library/Application\ Support/com.tokeneater.shared

Si installé via Homebrew : brew uninstall --cask tokeneater

Premier lancement

  1. Ouvrez TokenEater depuis votre dossier Applications
  2. Accordez l'accès au trousseau quand demandé - cela permet à TokenEater de lire vos identifiants Claude Code
  3. L'app vit dans votre barre de menus - cherchez le pourcentage d'usage
  4. Pour ajouter un widget : clic droit sur le bureau → Modifier les widgets → cherchez "TokenEater"
Après installation ou mise à jour, vous devrez peut-être supprimer et re-ajouter votre widget pour que les changements prennent effet. macOS met agressivement en cache les données des widgets.

Vérifier que ça marche

Une fois lancé, vous devriez voir votre pourcentage d'usage de session dans la barre de menus. Cliquez dessus pour ouvrir le tableau de bord détaillé avec les jauges circulaires et les informations de pacing.

Si vous voyez "0%" ou aucune donnée, vérifiez que :

  • Vous avez un abonnement Claude Pro, Max ou Team actif
  • Claude Code est installé et vous êtes connecté (claude /login dans votre terminal)
  • Le fichier ~/.claude/.credentials.json existe