FAQ & Dépannage

Problèmes courants

"Rate limited" ou "API unavailable"

Votre token OAuth a atteint sa limite de requêtes.

Lancez claude /login dans votre terminal pour un nouveau token - TokenEater le détecte automatiquement.

L'erreur persiste pendant des heures

L'app attend ~6h après épuisement du token.

Cliquez sur Retry now dans le popover de la barre de menus après avoir lancé claude /login.

Popup trousseau toutes les quelques heures

macOS re-valide les signatures après les mises à jour.

Cliquez sur Toujours autoriser - si ça persiste, faites un nettoyage complet.

Widget bloqué / ne se met pas à jour

macOS met agressivement en cache les extensions widget.

Supprimez le widget, faites un nettoyage complet, re-ajoutez le widget.

App signalée comme malware dans la galerie de widgets

xattr -cr a été utilisé au lieu de l'approbation via Réglages système.

Faites un nettoyage complet, réinstallez, et approuvez via Réglages système → Confidentialité et sécurité → Ouvrir quand même.

Nettoyage complet

Si quelque chose est cassé et que vous voulez repartir de zéro, lancez ceci dans votre terminal. Cela tue tous les processus liés, supprime les caches, préférences et containers, puis retire l'app :

bash
# 1. Tuer les processus
killall TokenEater NotificationCenter chronod cfprefsd 2>/dev/null; sleep 1

# 2. Supprimer les préférences
defaults delete com.tokeneater.app 2>/dev/null
defaults delete com.claudeusagewidget.app 2>/dev/null
rm -f ~/Library/Preferences/com.tokeneater.app.plist
rm -f ~/Library/Preferences/com.claudeusagewidget.app.plist

# 3. Nettoyer les containers sandbox
for c in com.tokeneater.app com.tokeneater.app.widget com.claudeusagewidget.app com.claudeusagewidget.app.widget; do
    d="$HOME/Library/Containers/$c/Data"
    [ -d "$d" ] && rm -rf "$d/Library/Preferences/"* "$d/Library/Caches/"* "$d/Library/Application Support/"* "$d/tmp/"* 2>/dev/null
done

# 4. Supprimer les données partagées et caches
rm -rf ~/Library/Application\ Support/com.tokeneater.shared
rm -rf ~/Library/Application\ Support/com.claudeusagewidget.shared
rm -rf ~/Library/Caches/com.tokeneater.app
rm -rf ~/Library/Group\ Containers/group.com.claudeusagewidget.shared

# 5. Supprimer les caches WidgetKit (critique - macOS garde les anciens binaires widget ici)
TMPBASE=$(getconf DARWIN_USER_TEMP_DIR)
CACHEBASE=$(getconf DARWIN_USER_CACHE_DIR)
rm -rf "${TMPBASE}com.apple.chrono" "${CACHEBASE}com.apple.chrono" 2>/dev/null
rm -rf "${CACHEBASE}com.tokeneater.app" "${CACHEBASE}com.claudeusagewidget.app" 2>/dev/null

# 6. Désenregistrer les plugins widget
pluginkit -r -i com.tokeneater.app.widget 2>/dev/null
pluginkit -r -i com.claudeusagewidget.app.widget 2>/dev/null

# 7. Supprimer l'app
rm -rf /Applications/TokenEater.app
Certaines erreurs "Operation not permitted" sur les fichiers de métadonnées des containers sont normales - macOS les protège, mais les données sont bien nettoyées.

Après cela, réinstallez depuis la dernière version ou via Homebrew, puis supprimez les anciens widgets de votre bureau et ajoutez-en de nouveaux (clic droit → Modifier les widgets → TokenEater).

L'usage affiche 0% ou aucune donnée

Vérifiez les points suivants :

  • 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 d'identifiants existe : ~/.claude/.credentials.json
  • Votre connexion internet fonctionne (TokenEater appelle l'API Anthropic)

Le widget est vide

Cela arrive généralement après une mise à jour système ou de TokenEater :

  1. Supprimez le widget
  2. Redémarrez votre Mac (ou lancez killall NotificationCenter chronod)
  3. Re-ajoutez le widget

Si ça ne marche pas, lancez le nettoyage complet ci-dessus.

Quels terminaux sont supportés pour les Agent Watchers ?

Les Agent Watchers détectent les sessions Claude Code via les processus système, donc ça fonctionne avec pratiquement tous les terminaux et IDE. Support confirmé :

  • iTerm2, WezTerm, Terminal.app, Warp, Ghostty
  • VS Code, Cursor, Windsurf, Zed, et autres éditeurs basés sur VS Code
  • Sessions tmux et screen (dans n'importe quel terminal)

Si votre terminal fait tourner Claude Code, les Agent Watchers le trouveront.

À quelle fréquence les données d'usage sont-elles rafraîchies ?

TokenEater interroge l'API Anthropic toutes les 30 secondes par défaut. L'intervalle de rafraîchissement est visible dans le tableau de bord.

TokenEater envoie-t-il mes données quelque part ?

Non. TokenEater communique uniquement avec l'API Anthropic (api.anthropic.com) pour récupérer vos données d'usage. Pas d'analytics, pas de télémétrie, pas de services tiers. L'app est open source - vous pouvez vérifier par vous-même.

Usage CPU élevé

TokenEater inclut plusieurs fonctionnalités temps réel (Agent Watchers, tableau de bord animé, effets de particules) qui peuvent augmenter l'usage CPU. Si c'est une préoccupation :

  1. Ouvrez les réglages de TokenEater → section Performance
  2. Désactivez les Agent Watchers si vous n'avez pas besoin du suivi de session
  3. Réduisez l'intensité des animations ou désactivez les effets de particules
  4. Augmentez l'intervalle d'appel API

Ces options vous permettent d'équilibrer fonctionnalités et consommation de ressources selon votre configuration.