Claude Code'un Token Bütçesini Otomatik Sıfırlayın: GitHub Actions ile claude-warmup Kurulumu
Claude Code, kayan bir pencerede 5 saatlik bir token bütçesi sunar. Ancak bu pencere, ilk mesajınızı gönderdiğiniz anda başlar. Mesela sabah 8:30'da hızlıca soru sorup bütçeyi 11:00'e kadar tüketirseniz, öğlen 13:00'e kadar kilitlenirsiniz; iş gününüzün ortasında iki ölü saat kaybedersiniz. Bunun için pratik bir çözüm var: claude-warmup. Bu araç, iş gününüz başlamadan önce Claude Haiku'ya zamanlanmış bir "merhaba" mesajı göndererek, 5 saatlik pencerenizi tam istediğiniz saatte başlatıyor.
Neden İşe Yarıyor?
Claude Code'un bütçe penceresi, ilk mesajınızın gönderildiği saatle sabitlenir. Yani, sabah 6:15'te gönderdiğiniz mesaj, pencereyi 6:00'ya sabitler ve 5 saatlik blok 6:00-11:00 arası olur. Bu nedenle, pencerenizin günün başında başlatılması için otomatik bir ısınma mesajı göndermek avantajlıdır. Gönderilen "merhaba" mesajı neredeyse hiç token harcamaz.
Kurulum: 6 Adımda Otomasyon
-
Depoyu Forklayın
gh repo fork vdsmon/claude-warmup --clone cd claude-warmup -
OAuth Tokeni Oluşturun
Claude Code'un kurulu olduğu makinede:
claude setup-tokensk-ant-oat01-...formatında bir token alacaksınız. Bunu kopyalayın; yaklaşık bir yıl geçerlidir. -
Token'i GitHub Sırrı Olarak Ekleyin
gh secret set CLAUDE_OAUTH_TOKENTokeni yapıştırın; GitHub Actions bu kimlik doğrulama ile çalışır.
-
Cron Zamanlamasını Ayarlayın
Varsayılan zaman hafta içi UTC 9:15. Kendi saat diliminize göre değiştirin:
gh variable set WARMUP_CRON --body "15 13 * * 1-5"Sık kullanılan saatler:
Saat dilimi 9:00'da başlamak için Cron ifadesi UTC 8:45 45 8 * * 1-5ABD Doğu (EST) 8:45 (13:45 UTC) 45 13 * * 1-5ABD Pasifik (PST) 8:45 (16:45 UTC) 45 16 * * 1-5CET (Orta Avrupa) 8:45 (7:45 UTC) 45 7 * * 1-5 -
İş Akışını Test Edin
gh workflow run warmup.ymlFork'unuzun "Actions" sekmesinden başarılı çalışıp çalışmadığını doğrulayın.
-
Doğrulama
Ertesi sabah Claude Code'u açıp:
/usagekomutunu çalıştırın. Oturum sıfırlama zamanı, ayarladığınız sabitleme saatine uygun olmalıdır. Örneğin, 8:45'te ısınmayı tetiklediyseniz, pencereniz 8:00'de sıfırlanmalı.
Alternatif: Yerelde Çalıştırmak
GitHub Actions yerine doğrudan cron veya macOS launchd ile çalıştırmak için:
claude -p "hi" --model haiku --no-session-persistence
Bunu yerel crontab -e dosyanıza ekleyin. Önemli olan, mesajın iş gününüz başlamadan önce gönderilmesi; sunucunun nerede olduğu değil.
Bütçeyi Daha Verimli Kullanmak İçin İpuçları
- Genişletilmiş Düşünmeyi (Chain-of-Thought) Dikkatli Kullanın: Adım adım açıklamalar token'i hızlı tüketir. Sadece karmaşık mühendislik ve hata ayıklama için açın.
-
Bağlamı Sade Tutun: Claude Code, açık dosyalarınızı ve terminal çıktısını okur. Gereksiz dosyaları kapatın, tek seferlik komutlar için
--no-session-persistencekullanın. - Soruları Gruplayın: On küçük soru yerine tek, kapsamlı ve net bir prompt yazın. Daha az token harcarsınız.
-
Basit İşler için Haiku Modelini Kullanın: Küçük kod düzenlemeleri, yeniden adlandırmalar gibi işler için
--model haikuseçeneğini kullanın.
API Geliştirenler için: Apidog ile Entegre Kullanın
Birçok geliştirici, Claude Code ile API geliştirirken Apidog kullanıyor. API şemanızı tasarlayın, sahte sunucular oluşturun, otomatik testleri ve uç nokta denemelerini tek yerden yönetin. Claude Code ile ürettiğiniz uç noktaları, kopyala-yapıştır gerektirmeden doğrudan Apidog'da test edebilirsiniz. Başlamak ücretsizdir ve REST, GraphQL, gRPC'yi kutudan çıktığı gibi destekler.
Dikkat Edilecekler
- Pencere Sabitlenir: İlk mesaj gönderildiğinde, 5 saatlik blok kilitlenir. Gün ortasında değişmez.
- Bütçe Paylaşılır: claude.ai, Claude Code ve Claude Desktop aynı havuzu kullanır. Genişletilmiş Düşünme ve araç çağrıları daha hızlı tüketir.
- 7 Günlük Sınır Var: Bu yöntem günlük sıfırlama penceresini optimize eder, haftalık sınırı değiştirmez.
- Token Saatin Başına Sabitlenir: Örneğin, 8:47'de yapılan ısınma 8:00'e sabitlenir. Cron zamanlamasını istediğiniz saatten 15 dakika önce ayarlayın.
Claude Code oturumlarınız yanlış zamanda sıfırlanıyorsa, bu düzeltmeyi kurmak 10 dakikadan az sürer ve her gün otomatik çalışır.
Tam repo için: github.com/vdsmon/claude-warmup
Top comments (0)