Claude Code vergibt ein Token-Budget von 5 Stunden in einem gleitenden Zeitfenster. Das Problem: Dieses Fenster startet exakt mit Ihrer ersten Nachricht des Tages. Wenn Sie z.B. um 8:30 Uhr eine kurze Frage stellen und Ihr Budget bis 11 Uhr verbrauchen, sind Sie bis 13 Uhr ausgesperrt – also zwei Stunden mitten im Arbeitstag ohne Zugriff.
Die Lösung: Das Projekt claude-warmup automatisiert einen einfachen „Ping“ an Claude Haiku zu einer festen Zeit, bevor Ihr Arbeitstag beginnt. Dadurch wird das 5-Stunden-Fenster an Ihre Wunschzeit gebunden – nicht an den zufälligen Zeitpunkt, zu dem Sie Claude zum ersten Mal öffnen.
Warum das funktioniert
Das Token-Fenster von Claude Code richtet sich nach der vollen Stunde Ihrer ersten Nachricht. Senden Sie um 6:15 Uhr eine Nachricht, startet das Zeitfenster um 6:00 Uhr und läuft bis 11:00 Uhr. Wenn Sie Ihr Budget vormittags aufbrauchen, beginnt das nächste Fenster direkt um 11:00 Uhr.
Ohne diese Automatisierung startet das Fenster oft erst mitten am Vormittag, was die Nutzung während Ihrer produktiven Stunden einschränkt.
Der Warmup-Ping ist minimal: Ein einfaches „Hallo“ an Claude Haiku verbraucht kaum Tokens.
Einrichtung in 6 Schritten
1. Repository forken
gh repo fork vdsmon/claude-warmup --clone
cd claude-warmup
2. OAuth-Token generieren
Führen Sie auf einem System mit installiertem Claude Code:
claude setup-token
Kopieren Sie den erzeugten sk-ant-oat01-... Token. Dieser ist etwa ein Jahr gültig.
3. Token als GitHub Secret speichern
gh secret set CLAUDE_OAUTH_TOKEN
Fügen Sie den Token ein, wenn Sie dazu aufgefordert werden. GitHub Actions nutzt ihn zur Authentifizierung.
4. Cron-Zeitplan anpassen
Standard ist werktags um 9:15 Uhr UTC. Passen Sie dies für Ihre Zeitzone und Arbeitszeiten an, z.B.:
gh variable set WARMUP_CRON --body "15 13 * * 1-5"
Beispielzeiten:
| Ihre Zeitzone | Warmup für Start um 9 Uhr | Cron-Ausdruck |
|---|---|---|
| UTC | 8:45 Uhr UTC | 45 8 * * 1-5 |
| US Eastern (EST) | 8:45 Uhr = 13:45 Uhr UTC | 45 13 * * 1-5 |
| US Pacific (PST) | 8:45 Uhr = 16:45 Uhr UTC | 45 16 * * 1-5 |
| MEZ (Mitteleuropa) | 8:45 Uhr = 7:45 Uhr UTC | 45 7 * * 1-5 |
5. Workflow testen
gh workflow run warmup.yml
Überprüfen Sie im Tab „Actions“ Ihres Forks, ob der Workflow erfolgreich läuft.
6. Funktion überprüfen
Öffnen Sie am nächsten Tag Claude Code und geben Sie ein:
/usage
Die Rücksetzzeit sollte zu Ihrer gewünschten Startstunde passen. Beispiel: Wenn das Warmup um 8:45 Uhr läuft, sollte das Fenster einen Reset um 8:00 Uhr anzeigen.
Alternative: Lokal ausführen
Möchten Sie GitHub Actions nicht verwenden, können Sie den Warmup-Befehl lokal per cron oder launchd ausführen:
claude -p "hi" --model haiku --no-session-persistence
Fügen Sie diesen Befehl Ihrer lokalen Crontab (crontab -e) hinzu. Die Logik bleibt gleich: Die Nachricht muss vor Arbeitsbeginn gesendet werden, der Ursprung (lokal oder GitHub) ist egal.
Tipps, um Ihr Budget optimal zu nutzen
- Erweitertes Denken gezielt einsetzen: Schritt-für-Schritt-Analysen verbrauchen viele Tokens. Nutzen Sie diese Funktion nur bei komplexen Aufgaben wie Architekturentscheidungen oder schwierigen Debugging-Prozessen. Für Standard-Codierung und Nachschlagen reicht eine direkte Antwort.
-
Kontext klein halten: Claude Code verarbeitet geöffnete Dateien und Terminalausgaben. Je mehr Kontext, desto höher der Tokenverbrauch. Schließen Sie unnötige Dateien und nutzen Sie
--no-session-persistencefür Einmalbefehle ohne Verlauf. - Anfragen bündeln: Mehrere kleine Fragen kosten mehr als eine präzise, zusammengefasste Anfrage. Formulieren Sie Ihre Fragen klar und umfassend, um Tokens zu sparen und bessere Antworten zu erhalten.
- Haiku für einfache Aufgaben: Für Routineaufgaben wie Variablen umbenennen oder Boilerplate-Code reicht das Modell „Haiku“. Verwenden Sie leistungsstärkere Modelle nur bei Bedarf.
APIs entwickeln parallel zu Claude Code
Viele Entwickler bauen und testen APIs zusammen mit Claude Code. Hier bietet Apidog eine ideale Ergänzung. Sie können API-Schemas entwerfen, Mock-Server generieren und automatisierte Tests zentral durchführen – ohne zwischen Postman, Swagger oder separaten Mock-Tools zu wechseln. Endpunkte, die Claude Code erstellt, lassen sich sofort in Apidog testen, ohne Copy-Paste zwischen Tools.
Der Einstieg ist kostenlos und es werden REST, GraphQL und gRPC direkt unterstützt.
Was Sie beachten sollten
- Das Fenster ist fix: Die erste Nachricht legt das 5-Stunden-Zeitfenster fest; es verschiebt sich nicht mehr im Tagesverlauf.
- Budget wird geteilt: claude.ai, Claude Code und Claude Desktop nutzen denselben Pool. Erweitertes Denken und Tool-Aufrufe verbrauchen mehr als einfacher Chat.
- Wöchentliche Grenze bleibt: Diese Methode steuert das tägliche Reset-Fenster, nicht die 7-Tage-Budgetgrenze.
- Rundung auf volle Stunde: Ein Warmup um 8:47 Uhr setzt das Fenster auf 8:00 Uhr. Planen Sie den Cron mindestens 15 Minuten vor der gewünschten Stunde.
Wenn Ihre Claude Code-Sitzungen regelmäßig zur falschen Zeit enden, können Sie dieses Setup in unter 10 Minuten einrichten – danach läuft alles automatisch. Das vollständige Repository finden Sie unter github.com/vdsmon/claude-warmup.
Top comments (0)