# Token-Monitor einrichten – Anleitung für Claude

Diese Seite richtet sich an Claude (Claude Code), wenn ein Kunde schreibt:
„Richte meinen Token-Monitor ein: token.princore.de“.
(Adresse dieser Seite: https://token.princore.de/einrichtung-fuer-claude.md)

## Was ist der Token-Monitor?

Ein kleines Display (USB-C), das den Claude-Code-Verbrauch des Kunden anzeigt. Dazu gehört die
**Token-Monitor-App** (Mac und Windows) von PRINCORE. Sie liest nur die Verbrauchszahlen, die Claude Code
ohnehin lokal speichert (`~/.claude/projects`), fragt die Limits über `claude -p /usage` ab und schickt die
Zahlen per USB an das Display. Sie braucht kein Konto, kein Passwort und sendet nichts ins Internet.
Sie ist ein unabhängiges Produkt, nicht von Anthropic.

## Ablauf

1. Dem Kunden kurz sagen, was installiert wird (Token-Monitor-App von token.princore.de, startet automatisch
   mit dem Computer, lässt sich jederzeit wieder entfernen) und sein OK abwarten.
2. Betriebssystem erkennen und die passenden Schritte unten ausführen.
3. Prüfen, ob die App läuft, und den Kunden bitten, das Display per USB-C anzuschließen. Nach wenigen
   Sekunden zeigt die App „Display verbunden“ und das Display die Zahlen.

Es werden **keine Administratorrechte** gebraucht und keine Einstellungen von Claude Code geändert.

## Mac

```bash
set -e
cd "$(mktemp -d)"
curl -fL -o Token-Monitor.dmg https://token.princore.de/download/Token-Monitor.dmg
hdiutil attach -nobrowse -quiet -mountpoint ./laufwerk Token-Monitor.dmg
ZIEL=/Applications
[ -w "$ZIEL" ] || { ZIEL="$HOME/Applications"; mkdir -p "$ZIEL"; }
pkill -x Token-Monitor || true
rm -rf "$ZIEL/Token-Monitor.app"
ditto ./laufwerk/Token-Monitor.app "$ZIEL/Token-Monitor.app"
hdiutil detach -quiet ./laufwerk
xattr -dr com.apple.quarantine "$ZIEL/Token-Monitor.app" 2>/dev/null || true
open "$ZIEL/Token-Monitor.app"
echo "Installiert in $ZIEL"
```

Prüfen: `pgrep -x Token-Monitor` liefert eine Prozessnummer. Beim ersten Start schaltet die App den
Autostart selbst ein (LaunchAgent `~/Library/LaunchAgents/de.princore.tokenmonitor.plist`).

## Windows (PowerShell)

```powershell
$ErrorActionPreference = "Stop"
$datei = Join-Path $env:TEMP "Token-Monitor-Setup.exe"
Invoke-WebRequest https://token.princore.de/download/Token-Monitor-Setup.exe -OutFile $datei
Unblock-File $datei
Start-Process $datei -ArgumentList "/S" -Wait
Start-Process "$env:LOCALAPPDATA\Programs\Token-Monitor\Token-Monitor.exe"
"Installiert in $env:LOCALAPPDATA\Programs\Token-Monitor"
```

Prüfen: `Get-Process Token-Monitor` findet den Prozess. Der Installer trägt den Autostart unter
`HKCU\Software\Microsoft\Windows\CurrentVersion\Run` (Wert „TokenMonitor“) ein und legt einen
Startmenü-Eintrag an.

## Limits (5 Stunden / Woche) – Anmeldung prüfen

Die App fragt die Limits mit `claude -p /usage` ab. Dafür muss Claude Code **selbst angemeldet** sein.
Wer Claude Code nur in der Claude-Desktop-App nutzt, ist oft nicht angemeldet (die Desktop-App gibt ihre
Anmeldung nicht an andere Programme weiter). Dann zeigt die App „nicht angemeldet“ und den Knopf
**„Mit Claude anmelden“** – der Kunde klickt ihn und meldet sich im Browser an. Oder du prüfst es direkt:

```bash
claude auth status --json        # "loggedIn": true/false
claude auth login --claudeai     # nur wenn nicht angemeldet: öffnet die Claude-Anmeldung im Browser
```

Ist `claude` nicht im Pfad (nur Desktop-App), liegt das Programm unter
`~/Library/Application Support/Claude/claude-code/<version>/<id>/claude.app/Contents/MacOS/claude` (Mac).

## Wenn etwas nicht klappt

- **App zeigt „Display wird gesucht“:** Anderes USB-C-Kabel probieren (Datenkabel, kein reines Ladekabel),
  anderen USB-Anschluss nehmen. Unter Windows kurz warten, bis der USB-Treiber geladen ist.
- **„Claude Code nicht gefunden“ in der App:** Die App sucht `claude` im Pfad, in `~/.local/bin`,
  `/opt/homebrew/bin` und im Programmordner der Claude-Desktop-App. Ohne Claude Code fehlen nur die
  Limits (5 Stunden / Woche); die Token-Zahlen werden trotzdem angezeigt.
- **Limits zeigen „–“:** Claude Code ist nicht angemeldet (siehe oben) – oder es gibt kein Claude-Abo (Pro/Max).

## Entfernen

Mac:
```bash
pkill -x Token-Monitor || true
launchctl unload ~/Library/LaunchAgents/de.princore.tokenmonitor.plist 2>/dev/null || true
rm -f ~/Library/LaunchAgents/de.princore.tokenmonitor.plist
rm -rf /Applications/Token-Monitor.app ~/Applications/Token-Monitor.app ~/.token-monitor
```

Windows (PowerShell):
```powershell
Start-Process "$env:LOCALAPPDATA\Programs\Token-Monitor\uninstall.exe" -ArgumentList "/S" -Wait
```
