Claude Counter App-Symbol

Einrichtungsanleitung

Erste Schritte

Willkommen bei Claude Counter! Diese Anleitung hilft dir, die App einzurichten und deine Claude Code Sitzungen in wenigen Minuten zu verfolgen.

Schritt 1: Herunterladen & Installieren

  1. Öffne den App Store auf deinem iPhone oder iPad
  2. Suche nach „Claude Counter“
  3. Tippe auf Laden, um die App herunterzuladen und zu installieren
  4. Öffne die App, sobald die Installation abgeschlossen ist
Laden im App Store

Schritt 2: Wähle deine Sprache

Wenn du Claude Counter zum ersten Mal öffnest, wirst du gebeten, deine bevorzugte Sprache auszuwählen.

Verfügbare Sprachen:

  • Englisch (UK)
  • Englisch (US)
  • Afrikaans
  • Griechisch (Ελληνικά)
  • Französisch (Français)
  • Spanisch (Español)
  • Deutsch (Deutsch)
  • Niederländisch (Nederlands)
  • Chinesisch, vereinfacht (中文 简体)
  • Chinesisch, traditionell (中文 繁體)
  • Japanisch (日本語)

Tippe auf deine bevorzugte Sprache, um fortzufahren. Du kannst dies später in den Optionen ändern.

Schritt 3: Verbinde deine echte Claude-Nutzung (Mac)

Dieser einmalige Schritt ermöglicht die wertvollsten Funktionen von Claude Counter. Claude Code führt auf deinem Mac ein privates Protokoll deiner echten Nutzung — verbinde es einmal, und die App zeigt dir dein aktuelles 5-Stunden-Sitzungsfenster, echte Token-Zahlen, geschätzte Kosten und kann deine Timer auf den Zeitpunkt synchronisieren, an dem Claude tatsächlich zurückgesetzt wird.

Auf deinem Mac (einmalig)

Bevor du beginnst: Du brauchst einen Mac mit Apple Silicon, auf dem du Claude Code verwendest — dort befindet sich das Nutzungsprotokoll — mit aktiviertem iCloud Drive (Systemeinstellungen > dein Name > iCloud).

  1. Öffne den Mac App Store, suche nach Claude Counter und klicke oben in den Ergebnissen auf den Tab iPhone- und iPad-Apps — es handelt sich um eine iPad-App, die auf deinem Mac läuft, daher wird sie nicht unter Mac-Apps aufgeführt. Installiere sie
  2. Öffne die App und gehe zu Tab 2 (Nutzung)
  3. Tippe auf Zugriff gewähren
  4. Drücke im sich öffnenden Ordnerfenster Command+Shift+G, gib ~/.claude ein, drücke Return und klicke dann auf Öffnen
  5. Du weißt, dass es funktioniert hat, wenn der Tab „Nutzung“ sich mit deinen Token-Zahlen füllt, plus einem Live-Countdown von 5 Stunden, falls du in den letzten 5 Stunden eine Nachricht an Claude Code gesendet hast. Wenn dort „Dieser Ordner enthält keine Claude Code-Protokolle“ steht, tippe unten im Tab auf Ordner ändern und wähle erneut ~/.claude aus

Auf deinem iPhone oder iPad

  • Melde dich mit dem gleichen iCloud-Konto wie auf deinem Mac an, mit aktiviertem iCloud Drive (Einstellungen > dein Name > iCloud)
  • Öffne Tab 2 (Nutzung) und gib ihm beim ersten Mal bis zu fünf Minuten Zeit — dein Mac teilt deine Nutzung privat über dein eigenes iCloud, und dein iPhone übernimmt sie von selbst. Ziehe den Tab „Nutzung“ nach unten, um früher nachzusehen
  • Du weißt, dass es funktioniert hat, wenn unten im Tab „Nutzung“ Von gefolgt vom Namen deines Mac und dem Zeitpunkt seiner letzten Aktualisierung steht
  • Tipp: Lass Claude Counter auf deinem Mac laufen, während du arbeitest — nur die Mac-App liest die Protokolle, daher ist dein iPhone immer nur so aktuell wie die letzte Aktualisierung der Mac-App. Wenn du die Mac-App beendest, behält dein iPhone die letzte Aktualisierung, bis du sie wieder öffnest

Freihändiger Hintergrundbetrieb (Optional)

Die Mac-App muss ihr Fenster nicht geöffnet haben — sie liest weiterhin deine Protokolle und aktualisiert deine anderen Geräte, während sie ausgeblendet ist. Zwei einfache Wege, sie vollständig freihändig zu machen:

  • Anmeldeobjekte: Systemeinstellungen > Allgemein > Anmeldeobjekte & Erweiterungen > Claude Counter hinzufügen — sie öffnet sich beim Anmelden, und du kannst das Fenster ausblenden und vergessen
  • Lass Claude es für dich einrichten: Wenn du Claude Code verwendest, füge diesen Prompt in eine Sitzung auf deinem Mac ein, und Claude hilft dir bei der Einrichtung:
Bitte hilf mir, die Claude Counter-App so einzurichten, dass sie freihändig im Hintergrund auf diesem Mac läuft, damit sie meine Nutzungsdaten aktuell hält, während sie ausgeblendet ist. Füge einen SessionStart-Hook zu meiner ~/.claude/settings.json hinzu, der den Befehl ausführt: open -gja "Claude Counter" damit die App ausgeblendet startet, wann immer ich eine Claude Code-Sitzung beginne. Behalte meine bestehenden Einstellungen bei, erkläre die Änderung, bevor du sie vornimmst, und validiere anschließend das JSON.

Was dies freischaltet

  • Live-Countdown des Sitzungsfensters auf Tab 1 und 2 — sieh genau, wann Claude zurückgesetzt wird
  • Erfassen & synchronisieren — läuft bereits ein Claude-Fenster, erfasst ein Tipp die Sitzung und setzt deine Timer auf den tatsächlichen Reset-Zeitpunkt
  • Letzte Fenster & Import — Sitzungen, die du zu erfassen vergessen hast, kannst du mit einem Tipp zu deinem Verlauf hinzufügen
  • Geschätzte Kosten & Abo-Wert — was deine Nutzung zu API-Pay-per-Token-Preisen kosten würde, im Vergleich zu den Kosten deines Plans
  • Modell-Verfolgung — kennzeichne Sitzungen mit den Claude-Modellen, die du tatsächlich nutzt

Datenschutz & Nutzung ohne Mac

Deine Protokolle verlassen deine Geräte nur über dein eigenes privates iCloud — nichts wird an uns oder Dritte gesendet. Kein Mac? Kein Problem: Die manuelle Sitzungsverfolgung funktioniert auch ohne diesen Schritt vollständig, und du kannst jederzeit später einen Mac verbinden.

Schritt 4: Verstehe deine Sitzungslimits

Free-Nutzer

  • 5 Sitzungen kostenlos inklusive
  • 1 Kulanzsitzung als Puffer vor dem Upgrade
  • Die Sitzungszahl von Claude Counter setzt sich an dem Tag jeden Monats zurück, an dem sich dein Claude-Abo verlängert (vom Nutzer einstellbar)

Pro-Nutzer

  • Mehr Sitzungen pro Monat
  • Benutzerdefinierte Timer
  • Sperrbildschirm-Widgets
  • 2 Wochen kostenlose Testphase bei allen Plänen

Schritt 5: Konfiguriere deine Timer

Gehe zu Optionen (Tab 5) > Timer-Einstellungen, um Folgendes anzupassen:

Sitzungsdauer-Timer

  • Standard: 5 Stunden (300 Minuten)
  • Zweck: Verfolgt, wie lange deine Claude Code Sitzung läuft
  • Empfehlung: Stelle dies passend zum Sitzungs-Timeout von Claude Code ein

Speicherfortschritt-Timer

  • Standard: 4:45 Stunden (285 Minuten)
  • Zweck: Erinnert dich daran, deinen Fortschritt mit Claude zu speichern
  • Empfehlung: Stelle eine Zeit ein, die kürzer ist als deine Sitzungsdauer, passend zu deinem Workflow für Fortschritts-Updates

Schritt 6: Lege deinen Rücksetztag fest

Deine Sitzungszahl setzt sich monatlich zurück. Das geschieht an dem Tag des Monats, den du in den Timer-Einstellungen als Verlängerungstag deines Claude-Abos festgelegt hast.

So änderst du deinen Rücksetztag:

  1. Gehe zu Optionen (Tab 5)
  2. Tippe auf Timer-Einstellungen
  3. Suche Sitzungsrücksetztag
  4. Wähle einen beliebigen Tag von 1-31

Schritt 7: Wähle dein Thema

Claude Counter bietet über 15 wunderschöne Farbthemen.

  1. Gehe zu Optionen (Tab 5)
  2. Tippe auf Thema & Erscheinungsbild
  3. Wähle dein bevorzugtes Thema:
    • System (folgt iOS)
    • Blau, Lila, Grün, Pink, Gold
    • Kobalt, Indigo, Dodger-Blau
    • Orange, Rot, Gelb
    • Grau, Schwarz, Braun
  4. Wähle den Modus Hell, Dunkel oder System
  5. Es gibt viele Kombinationen, also nimm dir etwas Zeit, um das Thema zu finden, das dir gefällt

Schritt 8: Sperrbildschirm-Widgets einrichten (Pro)

Mit Sperrbildschirm-Widgets siehst du Sitzungsinfos, ohne die App zu öffnen.

Widgets hinzufügen

  1. Halte auf deinem Sperrbildschirm gedrückt
  2. Tippe auf Anpassen
  3. Tippe auf den Sperrbildschirm, um ihn zu bearbeiten
  4. Tippe auf den Widget-Bereich (über oder unter der Uhrzeit)
  5. Suche nach Claude Counter
  6. Wähle aus den verfügbaren Widgets:
    • Sitzungs-Timer - Verbleibende Sitzungszeit
    • Speicherfortschritt - Zeit bis zur Speichererinnerung
    • Verbleibende Sitzungen - Anzahl verfügbarer Sitzungen
    • Verbleibende Tage - Verfügbare Tage bis zur Verlängerung deines Claude-Abos

Widget-Aktualisierung

Widgets aktualisieren sich automatisch, während Timer laufen.

Schritt 9: Starte deine erste Sitzung

Du bist startklar! So beginnst du mit der Verfolgung:

Eine Sitzung starten

  1. Öffne Claude Counter auf Tab 1 (Sitzung)
  2. (Optional) Füge eine Sitzungsbeschreibung hinzu. Ergänze Projekt- oder Kunden-Tags, um die Stichwortfilterung beim Datenexport zu ermöglichen
  3. (Optional) Wähle das Claude-Modell, das du verwenden wirst — es wird mit der Sitzung gespeichert
  4. Tippe auf die große Schaltfläche Sitzung Starten
  5. Bestätige, dass du eine neue Sitzung starten möchtest

Ist dein Mac verbunden (Schritt 3): Läuft beim Öffnen der App bereits ein Claude-Fenster, bietet sie stattdessen Erfassen & synchronisieren an — bestätige, füge eine Beschreibung hinzu, und deine Timer werden auf den tatsächlichen Reset-Zeitpunkt von Claude gesetzt. Das Fenster zählt bereits als eine deiner Sitzungen, daher hält das Erfassen einfach nur deine Zählung korrekt.

Was als Nächstes passiert

  • Der Sitzungs-Timer beginnt herunterzuzählen
  • Der Speicherfortschritt-Timer startet seinen Countdown
  • Die Sitzungszahl erhöht sich
  • Der kreisförmige Fortschrittsbalken zeigt genutzte Sitzungen

Während deiner Sitzung

  • Lass Claude Counter geöffnet oder nutze Widgets, um die Zeit im Blick zu behalten
  • Du erhältst eine Speichererinnerung, wenn dein Speicher-Timer-Ziel erreicht ist
  • Du erhältst eine Erinnerung, wenn dein Sitzungs-Timer-Ziel erreicht ist
  • Denk daran: Jede Anweisung oder Antwort, die nach Ablauf einer Claude-Sitzung an Claude AI gesendet wird, startet automatisch eine neue Sitzung

Deine Sitzung beenden

  • Wenn du die Arbeit mit Claude vor dem Ende der Sitzung beenden möchtest, tippe erneut auf die Schaltfläche, um die Sitzung zu beenden
  • Bestätige, um alle Timer zu stoppen
  • Die Sitzungszeit wird in deinem Verlauf gespeichert

Schritt 10: Überprüfe deine Statistiken

Nach ein paar Sitzungen kannst du deine Statistiken erkunden:

  1. Gehe zu Tab 4 (Statistiken)
  2. Sieh dir dein Schnellstatistiken-Dashboard an
  3. Scrolle, um Diagramme zu sehen:
    • Nutzung in 7-Tage-Zeiträumen
    • Sitzungsdauer nach Datum
    • Nutzung nach Wochentag
    • Sitzungen nach Uhrzeit
  4. Nutze den Periodenfilter, um anzuzeigen:
    • Nur aktuelle Periode
    • Alle Daten aller Zeiten
    • Bestimmte Zeiträume

Schritt 11: Exportiere deine Daten

Musst du deine Nutzung melden oder einen Kunden abrechnen?

Schnellexport

  1. Gehe zu Tab 3 (Verlauf) oder Tab 4 (Statistiken)
  2. Tippe auf die Schaltfläche Exportieren
  3. Wähle:
    • In Zwischenablage kopieren - Formatierter Text
    • Als CSV teilen - Für Tabellenkalkulationen

Was enthalten ist

  • Die vom Nutzer festgelegte Entwickler-ID
  • Sitzungsdaten und -uhrzeiten
  • Dauer jeder Sitzung
  • Sitzungsbeschreibungen
  • Verwendetes Claude-Modell (falls festgelegt)
  • Zusammenfassende Statistiken
  • Perioden-Informationen

Profi-Tipp: Versehentliche Sitzungen vermeiden

Die Bestätigungsdialoge von Claude Counter helfen, verschwendete Sitzungen zu vermeiden:

  1. Bestätigung beim Sitzungsstart - „Möchtest du wirklich eine neue Sitzung starten?“
  2. Bestätigung beim Sitzungsende - „Dies stoppt alle Timer. Fortfahren?“
  3. Sitzungs-Cooldown - Kurze Wartezeit zwischen Sitzungen

Diese Sicherheitsmaßnahmen sorgen dafür, dass du Sitzungen nur startest, wenn du es wirklich möchtest.

Upgrade auf Pro

Wenn du bereit für mehr Funktionen bist:

  1. Gehe zu Optionen (Tab 5)
  2. Tippe auf Abonnement
  3. Wähle Monatlich ($0.99) oder Jährlich ($9.99)
  4. Schließe den Kauf ab

Freigeschaltete Pro-Funktionen

  • Mehr Sitzungen pro Monat
  • Benutzerdefinierte Timer
  • Sperrbildschirm-Widgets
  • Alle zukünftigen Pro-Funktionen

Problembehandlung

Sitzungen werden nicht gezählt

Stelle sicher, dass du auf „Sitzung Starten“ tippst und bestätigst

Widgets aktualisieren sich nicht

  • Widgets aktualisieren sich in regelmäßigen Abständen, gesteuert von iOS
  • Versuche, das Widget zu entfernen und erneut hinzuzufügen
  • Stelle sicher, dass die App kürzlich geöffnet wurde

Timer-Töne werden nicht abgespielt

  • Prüfe, ob dein iPhone nicht auf lautlos gestellt ist
  • Überprüfe die Benachrichtigungsberechtigungen in den iOS-Einstellungen

Tab „Nutzung“ wartet auf deinen Mac

  • Öffne Claude Counter auf deinem Mac und gewähre Ordnerzugriff (Schritt 3) — der eigene Tab „Nutzung“ des Mac muss zuerst Zahlen anzeigen, bevor das iPhone es kann
  • Stelle sicher, dass beide Geräte mit demselben iCloud-Konto angemeldet sind und iCloud Drive aktiviert ist
  • Gib der ersten Synchronisierung bis zu fünf Minuten Zeit und ziehe dann den Tab „Nutzung“ nach unten, um zu aktualisieren. Dein iPhone erhält nur Updates, während die Mac-App läuft

„Der Zugriff auf den Ordner ging verloren“ oder „Dieser Ordner enthält keine Claude Code-Protokolle“

  • Der Zugriff kann nach einer Neuinstallation oder Aktualisierung der Mac-App verloren gehen — tippe unten im Tab „Nutzung“ auf Ordner ändern und wähle erneut ~/.claude aus
  • „Keine Claude Code-Protokolle“ bedeutet, dass ein anderer Ordner ausgewählt wurde — es muss der versteckte Ordner ~/.claude in deinem Home-Verzeichnis sein. Drücke Command+Shift+G im Ordnerfenster und gib ihn ein

Anzeige „Kein aktives Fenster“

  • Ein Fenster erscheint erst, sobald du Claude Code eine Nachricht gesendet hast — deine nächste Nachricht startet ein neues 5-Stunden-Fenster
  • Die Tabs „Sitzung“ und „Nutzung“ prüfen alle 30 Sekunden erneut, solange sie geöffnet sind; die Schaltfläche Aktualisieren im Tab „Nutzung“ prüft sofort
  • Auf dem iPhone ist der Countdown nur so aktuell wie die letzte Aktualisierung deines Mac — öffne die Mac-App, um ihn auf den neuesten Stand zu bringen

Brauchst du weitere Hilfe?

Besuche: Benutzerhandbuch

Nächste Schritte

Jetzt, wo du eingerichtet bist:

  1. Beginne mit der Verfolgung deiner Claude Code Sitzungen
  2. Erstelle benutzerdefinierte Timer für deinen Workflow (Pro)
  3. Überprüfe deine Statistiken wöchentlich, um deine Muster zu verstehen
  4. Exportiere Berichte nach Bedarf für Abrechnung oder Management

Viel Spaß beim Coden!

Brauchst du Hilfe?

Wir sind für dich da, wenn du Fragen hast oder auf Probleme stößt.

Vollständiges Benutzerhandbuch Produktseite Support kontaktieren