Kodlama ajanları en çok uzun işlerde işe yarar; uzun işler de başında oturup izlemek istemeyeceğin işlerdir. Sorun şu ki ajanlar arada durup bir şey sorar. Claude Code bir komutu çalıştırmak için izin ister, turunu bitirip sıradaki talimatı bekler ya da bir hataya takılır. Toplantıdaysan ya da yemeğe çıktıysan ajan sen masana dönene kadar boşta bekler.
Claude Code’u Telegram üzerinden yönetmek bu boşluğu kapatır. Bu yazıda bunu Telegram ve AgentVera ile nasıl yaptığımı anlatıyorum: Ne olduğunu söyleyen bildirimler, tek dokunuşla onay, sohbetten yeni ajan başlatmak ve daha büyük işleri /team ile /night komutlarıyla devretmek.
Telefondan neler yapabilirsin?
Kurmadan önce ne bekleyeceğini bil diye Telegram bağlantısının kapsadıkları:
| Telefondan | Nasıl |
|---|---|
| Ajan bitirince ya da hata verince haber almak | Yanıtından kısa bir bölümle gelen bildirim |
| İzin isteğini onaylamak ya da reddetmek | Mesajdaki ✅ Onayla ve ✖️ Reddet düğmeleri |
| Çalışan bir ajana yazmak | Ajanın konusuna yazmak ya da bildirimini yanıtlamak |
| Neyin değiştiğini görmek | 🧾 Değişiklikler, farkı dosya olarak gönderir |
| Yeni ajan başlatmak | Proje ve görevle /new |
| Paralel ekip çalıştırmak | /team, ardından planı onaylamak |
| Gece için iş sıraya koymak | /night, ardından ➕ Görev ekle |
Ajanlar yine bilgisayarındaki masaüstü uygulamasında çalışır. Telefon bir kumanda gibidir: Talimat gönderir ve güncellemeleri alır. Bu yüzden uygulamanın açık, bilgisayarın da uyanık kalması gerekir.
Botu bağlamak
Kurulum bir dakika sürer:
- Masaüstü uygulamasında AgentVera hesabına giriş yap (Ayarlar → Hesap). Ücretsiz hesap yeterli.
- Ayarlar → Bildirimler → Telefona bildirim bölümüne git ve AgentVera botuyla bağlan seçeneğini seç.
- Telegram’a bağlan düğmesine tıkla. Uygulama bir t.me bağlantısı ve QR kod gösterir.
- Bağlantıyı aç ya da kodu telefonla okut, Telegram’da Başlat’a dokun.
- Mesajın geldiğinden emin olmak için Test gönder’i kullan.
Bağlantı 10 dakika geçerlidir ve bir kez kullanılır. Gizlilik tarafında bilmen gerekenler:
- Yolda hiçbir şey saklanmaz. Mesajlar AgentVera sunucusundan geçer ve masaüstü uygulaması alana kadar yalnızca bellekte bekler.
- Sadece özel sohbet. Bot yalnızca seninle özel sohbette çalışır, gruplara katılmaz.
- Kontrol sadece sende. Hem sohbet hem de gönderen kontrol edilir; ajanlarını yalnızca eşleştirilmiş hesap yönetebilir.
Kendi botunu kullanmayı tercih edersen Kendi botumu kullanmak istiyorum seçeneğini seçip tokenı yapıştır. Token sistem anahtar zincirinde şifreli saklanır ve mesajlar doğrudan Telegram’a gider.
Bir not: Bot, masaüstü uygulaması hangi dildeyse o dilde yazar; uygulama Türkçeyse mesajlar ve düğmeler de Türkçedir. Komutların Türkçe karşılıkları da çalışır: /ajanlar, /yeni, /ekip, /gece, /durum, /yardim ve /iptal.
Gerçekten işine yarayan bildirimler
Bildirim, ancak harekete geçmen gerekip gerekmediğini söylüyorsa işe yarar. Bildirimler ayarlarında hangi olayların telefonuna geleceğini seçersin. Şunların hepsi varsayılan olarak açıktır:
- Ajan turunu bitirdi
- Ajan hata verdi
- Onay bekleyen istekler
- Kod incelemesinde önemli bulgu
- Paralel ekip güncellemeleri
- Hesap ve limit uyarıları
- Zamanlanmış görev başarısız
Gürültüyü iki ayar belirler:
- En kısa tur süresi. Varsayılan olarak yalnızca en az 60 saniye süren turlar “bitti” mesajı gönderir. Kısa gidip gelen turlar sessiz kalır.
- Ajanın yanıtından kısa bir bölüm ekle. Varsayılan olarak açık. Kapatırsan telefonun yalnızca turun bittiğini öğrenir; kod ya da proje içeriği gitmez.
Her ajana ayrı konu açıkken (varsayılan) her ajanın bot sohbetinde kendi konusu olur. Böylece birkaç ajanla geçen uzun bir gün tek bir bitmeyen yazışmaya dönüşmez.
İzin isteklerini tek dokunuşla onaylamak
Bir ajan izin istediğinde mesaj ✅ Onayla ve ✖️ Reddet düğmeleriyle gelir. Masaüstü uygulamasında otomatik onay açıksa ayrıca her zaman izin veren bir düğme görürsün: Bir komut için ♾️ Hep izin ver: … ya da ♾️ Proje içi düzenlemelere hep izin ver. Telefon otomatik onayı kendi başına açmaz; bu karar masaüstünde kalır.
Bir isteği kaçırırsan AgentVera sana hatırlatır. Hatırlatmalar 5 dakika sonra başlar, en fazla üç kez olmak üzere 15 dakikada bir tekrarlanır ve aynı düğmelerle Telegram’a da gelir. Akışlardaki onaylar da aynı şekilde gelir.
Sohbetten ajanlarla konuşmak
Çalışan ajanlarını listelemek için /agents (ya da /ajanlar) yaz. Her ajan düğmeli bir kart olarak gelir:
- 📄 Son yanıt ajanın son söylediğini gösterir.
- 🧾 Değişiklikler mevcut değişiklikleri
changes.diffdosyası olarak gönderir. - ⏸ Durdur o anki turu keser, ▶️ Devam et devam etmesini söyler.
- ↩️ Son turu geri al onay aldıktan sonra son turdaki dosya değişikliklerini geri alır.
- ✍️ Yaz ajana mesaj gönderir.
- ⏹ Ajanı kapat ajanı kapatır.
Bir ajana yazmak için onun konusuna yaz ya da bildirimlerinden birini yanıtla. Ajan meşgulse mesajı turu bitince alır. 20 MB’a kadar fotoğraf ve belge de gönderebilirsin; örneğin bir hatanın ekran görüntüsü. Sesli mesaj ve video desteklenmiyor.
Ters yönde de çalışır: Ajanlar telefona gönderebilsin açıkken ajanlar phone_send aracıyla telefonuna dosya gönderebilir. Yalnızca kendi klasörlerindeki dosyaları gönderebilirler; .env dosyaları ve anahtarlar gibi gizli dosyalar engellenir.
Yeni iş başlatmak: /new, /team ve /night
/new: tek ajan, tek görev
/new (ya da /yeni) önce son projelerinden birini seçmeni, sonra görevi yazmanı ister. Görevin adını taşıyan bir Claude Code ajanı başlatır; telefondan geldiği belli olsun diye adın başında 📱 olur. Proje adını biliyorsan /new Proje: görev ile tek mesajda halledersin.
/team: telefondan paralel ekip
Daha büyük işler için /team (ya da /ekip) bir paralel ekip başlatır. Projeyi seç ve isteği ayrıntılı anlat. Bot planı hazırladığını söyler; plan hazır olunca parçaları, aynı anda kaçının çalışacağını ve son kontrol komutunu gösteren bir 🧩 Plan hazır mesajı gelir. Sen 🚀 Ekibi başlat düğmesine dokunmadan hiçbir şey çalışmaz.
Ekip çalışırken önemli anlardan haberdar olursun:
- Yardım gereken bir parça 🔁 Tekrar dene, ⏭ Atla ve 📥 Teslim al düğmeleriyle gelir.
- Ekip bitince kaç parçanın birleştiğini, dalın adını ve henüz pull request yoksa bir 🔀 PR aç düğmesini görürsün.
- Ekip durursa bunu da haber verir.
Paralel bir çalışmanın içinde neler olduğunu merak ediyorsan Paralel kodlama ajanları ve Git worktree ile paralel geliştirme yazıları fikri anlatıyor.
/night: gece vardiyasına iş bırakmak
/night (ya da /gece) gece vardiyasının durumunu gösterir: Açık mı, saatleri ne, kuyrukta hangi görevler var. ➕ Görev ekle proje ve görev sorar, ▶️ Şimdi başlat da vardiya zaten çalışmıyorsa kuyruğu hemen başlatır.
Gece boyunca ajanlar işlerini commit’ler ama push etmez; onay istekleri de senin yerine onaylanmaz. Sabah hem masaüstü bildirimi hem de Telegram’da sayıların yer aldığı kısa bir özet alırsın. Gece vardiyası Pro planında var.
/status, /help ve /cancel
/status (/durum) çalışan ajanları kısaca listeler, /help (/yardim) botun neler yapabildiğini anlatır, /cancel (/iptal) de botun beklediği bir soruyu iptal eder.
Telegram mı, AgentVera mobil uygulaması mı?
AgentVera’nın iOS ve Android için bir mobil uygulaması da var. İkisi de bilgisayarındaki ajanlara AgentVera sunucusu üzerinden ulaşır ve ikisini birlikte kullanabilirsin.
- Telegram hızlı işler içindir: bir bildirim, tek dokunuşla onay, kısa bir yanıt, /new ile yeni bir görev.
- Mobil uygulama tam bir kumandadır: her ajan için sohbet, terminal ve fark görünümü, dosya, fotoğraf ve sesli mesaj, Git ve Docker, geri alma, görevler ve gece vardiyası. Masaüstü uygulamasının ayarlarında Telefondan kontrol’ü açman ve uygulamaya aynı hesapla giriş yapman yeterli.
Kurulumu ve her ekranın ne işe yaradığını AgentVera mobil uygulaması rehberinde anlatıyoruz.
Sık yapılan hatalar
- Bilgisayarı uykuya bırakmak. Ajanlar senin makinende çalışır. Bilgisayar uyursa sen uyandırana kadar hiçbir şey olmaz.
- Her bildirimi açıp sonra sohbeti sessize almak. En kısa tur süresini koru, hiç harekete geçmediğin olayları kapat; gelen mesajlar açmaya değsin.
- Telefondan belirsiz görev vermek. Telefonda yazmak insanı kısa cümlelere iter. “Girişi düzelt” /new ya da /team için yeterli değil; dosyayı, hatayı ve nasıl kontrol edileceğini yaz.
- Körlemesine onaylamak. Tanımadığın bir komutta Onayla’ya basmadan önce 📄 Son yanıt ya da 🧾 Değişiklikler ile ajanın ne yaptığına bak.
- Telegram’ın masaüstünün yerini tutmasını beklemek. Büyük bir farkı incelemek ya da bir çakışmayı çözmek masa başında, en azından mobil uygulamanın fark görünümünde yapılacak iştir. Telegram, sen gelene kadar ajanların durmamasını sağlar.
Kontrol listesi
- Masaüstü uygulamasında AgentVera hesabına giriş yapıldı mı?
- Bot bağlandı ve Test gönder mesajı geldi mi?
- Bildirim olayları seçildi, en kısa tur süresi ayarlandı mı?
- Yanıttan bölüm ekleme ayarı, göndermeye razı olduğun içeriğe göre açık ya da kapalı mı?
- Her ajana ayrı konu açık mı?
- Ajanlar çalışırken bilgisayarın uykuya geçmemesi ayarlandı mı?
Sonuç
Claude Code’u Telegram’dan yönetmek, küçük ekranda kod yazmaktan çok ajanları bekletmemekle ilgili. Bildirimler seni ne zaman gerektiğini söyler, onaylar tek dokunuş sürer; /new, /team ve /night ile de sen uzaktayken sıradaki işi devredersin. Üstelik bu sadece Claude Code ile sınırlı değil: /agents, AgentVera’da çalıştırdığın Codex ve diğer ajanları da aynı kartlarla listeler. Telegram’ı kumanda olarak kullanmak yerine üzerinde bir şey geliştirmek istiyorsan Yapay zeka ile Telegram botu yazısına göz at.
AgentVera’ya ücretsiz başlayabilir, gece vardiyasına ya da paralel ekiplere ihtiyaç duyduğunda planlara göz atabilirsin.