Claude Code vous alloue un budget de jetons de 5 heures sur une fenêtre glissante. Le problème : cette fenêtre commence dès que vous envoyez votre premier message de la journée. Si vous posez une question rapide à 8h30 et que vous épuisez votre budget à 11h, vous êtes bloqué jusqu'à 13h, soit deux heures perdues en plein milieu de votre journée de travail.
Un développeur a créé une solution astucieuse pour cela. Elle s'appelle claude-warmup et utilise une action GitHub planifiée pour envoyer un simple "salut" jetable à Claude Haiku avant le début de votre journée de travail. Ce message unique ancre votre fenêtre de 5 heures à une heure que vous choisissez, et non au moment où vous ouvrez Claude par hasard.
Pourquoi cela fonctionne
La fenêtre budgétaire de Claude Code est ancrée à l'heure pile de votre premier message. Un message envoyé à 6h15 ancre la fenêtre à 6h00, de sorte que votre bloc de 5 heures s'étend de 6h à 11h. Au moment où vous épuisez votre budget en milieu de matinée, votre prochaine fenêtre commence immédiatement à 11h.
Sans cela, la fenêtre commence dès votre premier message à Claude, souvent en milieu de matinée, et la réinitialisation tombe au milieu de vos heures les plus productives.
Le "ping" de préchauffage ne coûte presque rien. Un simple "salut" à Claude Haiku sans outils ni contexte utilise un nombre négligeable de jetons.
Configuration (6 étapes)
1. Dupliquez le dépôt (Fork the repo)
gh repo fork vdsmon/claude-warmup --clone
cd claude-warmup
2. Générez un jeton OAuth
Sur une machine où Claude Code est installé, exécutez :
claude setup-token
Ceci affiche un jeton sk-ant-oat01-.... Copiez-le. Il reste valide pendant environ un an.
3. Stockez le jeton en tant que secret GitHub
gh secret set CLAUDE_OAUTH_TOKEN
Collez le jeton lorsque vous y êtes invité. Les actions GitHub l'utiliseront pour l'authentification.
4. Définissez votre planification cron
La valeur par défaut est les jours de semaine à 9h15 UTC. Modifiez-la pour qu'elle corresponde à votre fuseau horaire et à votre horaire de travail :
gh variable set WARMUP_CRON --body "15 13 * * 1-5"
Quelques heures de référence :
| Votre fuseau horaire | Préchauffage pour un début à 9h | Expression Cron |
|---|---|---|
| UTC | 8h45 UTC | 45 8 * * 1-5 |
| US Eastern (EST) | 8h45 = 13h45 UTC | 45 13 * * 1-5 |
| US Pacific (PST) | 8h45 = 16h45 UTC | 45 16 * * 1-5 |
| CET (Europe Centrale) | 8h45 = 7h45 UTC | 45 7 * * 1-5 |
5. Testez le workflow
gh workflow run warmup.yml
Surveillez l'onglet Actions de votre duplication (fork) pour confirmer qu'il s'exécute avec succès.
6. Vérifiez que cela fonctionne
Le lendemain matin, ouvrez Claude Code et exécutez :
/usage
L'heure de réinitialisation de la session doit correspondre à votre heure d'ancrage. Si vous avez configuré le préchauffage pour qu'il se déclenche à 8h45, votre fenêtre devrait afficher une réinitialisation à 8h00.
Alternative : Exécuter localement
Si vous préférez ne pas utiliser les actions GitHub, exécutez la commande de préchauffage directement depuis votre terminal via cron ou macOS launchd :
claude -p "hi" --model haiku --no-session-persistence
Ajoutez ceci à votre crontab locale (crontab -e) en utilisant la même logique de synchronisation. Cela fonctionne de la même manière, l'essentiel est que le message soit envoyé avant le début de votre journée, et non qu'il provienne des serveurs de GitHub.
Conseils pour prolonger votre budget
Contrôler la fenêtre de réinitialisation est utile, mais il est bon de savoir ce qui consomme votre budget le plus rapidement afin de pouvoir vous organiser en conséquence.
La pensée approfondie (Extended Thinking) consomme rapidement les jetons. Lorsque Claude raisonne étape par étape sur un problème complexe, il utilise beaucoup plus de jetons qu'une réponse directe. Réservez la pensée approfondie aux tâches qui en ont réellement besoin, telles que les décisions d'architecture, le débogage de logiques complexes, et désactivez-la pour les recherches rapides ou la génération de code dont vous connaissez déjà la structure.
Gardez un contexte léger. Claude Code lit vos fichiers ouverts et la sortie récente de votre terminal dans le cadre de chaque message. Plus ce contexte est large, plus chaque échange coûte de jetons. Fermez les fichiers sur lesquels vous ne travaillez pas activement et utilisez --no-session-persistence lorsque vous exécutez des commandes ponctuelles qui n'ont pas besoin d'historique.
Regroupez vos requêtes. Dix petites questions coûtent plus cher qu'une seule question bien formulée qui les couvre toutes. Avant de demander quelque chose, prenez 30 secondes pour écrire une invite claire et complète. Vous obtiendrez une meilleure réponse et dépenserez moins de jetons pour y parvenir.
Utilisez Haiku pour les tâches simples. Lorsque vous demandez à Claude de renommer une variable, de générer une fonction type ou de reformater un fichier de configuration, vous n'avez pas besoin d'Opus ou de Sonnet. Spécifiez --model haiku pour les tâches légères et réservez les modèles plus lourds aux travaux qui nécessitent un véritable raisonnement.
Si vous construisez des API en parallèle de Claude Code
Beaucoup de développeurs utilisent Claude Code pour construire ou tester des API. Si c'est votre workflow, Apidog s'intègre naturellement. Vous pouvez concevoir votre schéma d'API, générer des serveurs mock et exécuter des tests automatisés, le tout à partir d'un seul endroit, sans passer de Postman à Swagger ou à des outils de mock séparés. Lorsque Claude Code écrit un endpoint, vous pouvez le tester immédiatement dans Apidog sans rien copier entre les outils.
C'est gratuit pour commencer et il gère les API REST, GraphQL et gRPC dès la sortie de la boîte.
Ce qu'il faut garder à l'esprit
- La fenêtre est fixe une fois définie. Une fois que le premier message est envoyé, le bloc de 5 heures est verrouillé. Il ne se déplacera pas en milieu de journée.
- Le budget est partagé. claude.ai, Claude Code et Claude Desktop puisent tous dans le même pool. La pensée approfondie (Extended Thinking) et les appels d'outils l'épuisent plus rapidement que le chat simple.
- Il y a aussi un plafond de 7 jours. Cette technique contrôle la fenêtre de réinitialisation quotidienne, pas le plafond budgétaire hebdomadaire.
- Le jeton se réinitialise à l'heure pile. Un préchauffage à 8h47 ancre à 8h00, et non à 8h47. Planifiez votre cron 15 minutes avant l'heure souhaitée.
Si vos sessions Claude Code continuent de s'épuiser au mauvais moment, cette solution prend moins de 10 minutes à configurer et s'exécute seule chaque jour. Le dépôt complet se trouve à l'adresse github.com/vdsmon/claude-warmup.