AgentVera’yı kullanmak için istediğin kodlama ajanı CLI’larını kur, bir proje klasörü ekle, Yeni ajan ile bir ya da birkaç ajan başlat ve onlarla projenin ızgarasında yan yana çalış. Her ajan, Claude Code ya da Codex gibi gerçek bir CLI’dır; kendi terminal panelinde, kendi girişiyle çalışır. AgentVera bunun etrafını tamamlar: proje başına ızgara, kuyruklu mesaj kutusu, tek bakışta durum, her tur için checkpoint, kod incelemesi ve hesap yönetimi.
Bu rehber seni boş bir pencereden çalışan birkaç ajana götürüyor. Önce neyi kurman gerektiğini, Yeni ajan penceresinin nasıl çalıştığını, ızgaranın nasıl düzenlendiğini, CLI’lar ve AgentVera için girişin nasıl işlediğini ve paralel ajanları birbirinin yolundan uzak tutan alışkanlıkları anlatıyor.
Başlamadan önce neye ihtiyacın var
AgentVera; macOS, Windows ve Linux için bir masaüstü uygulaması. İndirme sayfasından alabilirsin. Kendi modeliyle gelmez; bilgisayarında zaten kurulu olan ajan CLI’larını çalıştırır.
| Gereken | Neden |
|---|---|
| En az bir ajan CLI’ı, ör. Claude Code ya da Codex | AgentVera her ajan için gerçek CLI’ı başlatır |
| O CLI için bir giriş | Ajanlar CLI’ın kendi girişini ve planını kullanır |
| Bir proje klasörü, tercihen Git deposu | Checkpoint, worktree ve kod incelemesi Git üzerine kurulu |
| AgentVera hesabı (isteğe bağlı) | Yalnızca Pro ve Team özellikleri için |
Claude Code’u hiç kullanmadıysan Claude Code nasıl kullanılır yazısı kurulumu ve girişi anlatıyor. AgentVera; Claude Code, Codex, Gemini CLI ve GitHub Copilot CLI dahil 18 ajan CLI’ını destekler, yani zaten parasını ödediğin araçla başlayabilirsin.
1. adım: ilk projeni ekle
AgentVera’yı aç ve üst çubuktaki Proje klasörü ekle’ye tıkla. Üzerinde çalıştığın bir deponun klasörünü seç. Proje Projeler ana sayfası’nda ve üst çubukta görünür. Projeler arasında oradan ya da komut paletiyle (⌘K, Windows ve Linux’ta Ctrl K) geçebilirsin.
Her projenin iki görünümü var:
- Çalışma alanı: ajan panellerinin ızgarası; vaktinin çoğu burada geçer.
- Detaylar: ajanların çevresindeki proje bilgileri.
Proje kurmadan önce hızlıca bir şey sormak istersen ana ekranda Hızlı sohbet var. Bu sohbetler uygulamanın kendi klasöründe çalışır ve projelerine dokunmaz.
2. adım: ilk ajanını başlat
Kenar çubuğundaki Yeni ajan’a tıkla ya da ⌘N’e bas. Pencere ne istediğini söylüyor: aracı seç, ajana bir ad ve gerekirse rol ver.
- Araç: CLI’ı seç, ör. Claude Code ya da Codex. AgentVera’nın bu bilgisayarda bulamadığı araç Kurulu değil olarak işaretlenir.
- Ajan adı ve Renk: “Backend” ya da “İnceleyici” gibi kısa bir ad ızgarayı okumayı kolaylaştırır.
- Çalışma yeri: şimdilik Bu bilgisayar olarak bırak. Ajanı bir SSH sunucusunda da çalıştırabilirsin.
- Hesap: ajanın kullanacağı giriş. Varsayılan, bu bilgisayarda zaten açık olan giriştir. Alanda Oturum açık ya da Oturum kapalı yazar.
- Çalışma alanı: ana klasör ya da projenin Git worktree’lerinden biri.
- Rol ve talimatlar: isteğe bağlı. Claude’da sistem prompt’una, Codex’te developer instructions olarak eklenir.
- Ajanı başlat’a tıkla.
Pencerede başka seçenekler de var: bağlam profili, tarayıcı, proje haritası, MCP sunucuları, Docker kapsayıcısı, token bütçesi ve sahip olunan alanlar. İlk deneme için hepsini varsayılanda bırakıp sonra dönebilirsin. Bağlam profillerini token tasarrufu, kapsayıcıda çalıştırmayı Docker sayfası anlatıyor.
Ajan bir panelde açılır. O panel CLI’ı çalıştıran gerçek bir terminaldir; CLI’ın normal terminalde yaptığı her şey, eğik çizgi komutları dahil, burada da çalışır. Altında prompt geçmişi, taslakları ve kuyruğu olan bir mesaj kutusu bulunur (ajan meşgulken ⌘Enter mesajı kuyruğa alır).
3. adım: ajanların girişini yap
Ajanlar AgentVera üzerinden giriş yapmaz; CLI’ların kendi girişlerini kullanır. Yani terminalinde claude ya da codex zaten çalışıyorsa varsayılan hesap hazırdır. AgentVera bu varsayılan hesabı bu bilgisayar etiketiyle gösterir.
Bir hesapta oturum kapalıysa Yeni ajan penceresi uyarır: “Bu hesapta oturum kapalı. Ayarlar → Hesaplar’dan oturum açın ya da ajan ilk açılışta girişi sorar.” İkisinden birini seçebilirsin.
Birden fazla Claude ya da Codex hesabı kullanmak için Ayarlar → Hesaplar’ı aç, Claude hesabı ekle ya da Codex hesabı ekle’ye tıkla, bir ad ver ve Ekle ve oturum aç’ı seç. Her ek hesap kendi yapılandırma klasörünü kullanır; ajan oluştururken hangi hesapla çalışacağını seçersin. Claude Code hesabı nasıl değiştirilir yazısı bunu ayrıntısıyla anlatıyor.
4. adım: ajan ekle ve ızgarayı düzenle
Tek ajan işe yarar; AgentVera asıl iki üç ajan paralel çalışınca değerini gösterir. İkinci ajanı aynı şekilde oluştur ve her birine net, ayrı bir iş ver.
Izgara Ekran bölücü’de (⌘⌥L). 1×1’den 5×4’e kadar sütun ve satır sayısını seç ya da “Üst 2 · Alt 1” gibi hazır bir düzen kullan. Panelleri yeniden boyutlandırmak için ayırıcıları sürükle, sıfırlamak için panel boyutlarını eşitle. Her proje kendi düzenini hatırlar.
| İşlem | Nasıl |
|---|---|
| İki paneli yer değiştir | Bir paneli diğerinin üstüne sürükle |
| Paneli büyüt | Başlığına çift tıkla ya da ⌘⇧Enter |
| Ajanlar arasında odak değiştir | ⌘⌥ + ok tuşları |
| Bir panele atla | ⌘1 – ⌘9 |
| Komut paletini aç | ⌘K |
| Ekran bölücüyü aç | ⌘⌥L |
Windows ve Linux’ta ⌘ yerine Ctrl, ⌥ yerine Alt kullan. Bütün kısayolları Ayarlar’dan değiştirebilirsin. Bir ajanı ikinci ekranda tutmak istersen paneli bir modalde ya da ayrı pencerede de açabilirsin.
Birkaç ajan aynı klasörü paylaşınca birbirinin dosyalarının üzerine yazabilir. Her ajanı Çalışma alanı alanında kendi Git worktree’sine yönlendirmek bunu önler. Kurulumu git worktree ile paralel geliştirme, işi bölmeyi birden fazla Claude Code ajanı yazısı anlatıyor.
5. adım: her ajanın ne yaptığını izle
Her ajanın bir durumu var: Çalışıyor, Yanıtını bekliyor, Onay bekliyor, Beklemede, Uyuyor, Durdu ya da Hata. Durum çubuğu bunları sayar, ör. “2 çalışıyor” ya da “3 ajan onay bekliyor”. Böylece her paneli açmadan neyin seni beklediğini görürsün. Onay bekleyen sıradaki ajana gitmek için ⇧⌘A’ya bas.
Bilgisayardan uzaklaştığında masaüstü bildirimleri bir ajan işini bitirince, hata verince ya da onay beklerken haber verir. Bunları telefonuna da gönderebilirsin. Bkz. bildirimler ve onaylar.
6. adım: işi kontrol et, kötü bir turu geri al
Paralel ajanların ürettiğine güvenmeni iki Ücretsiz özellik kolaylaştırır.
- Kod incelemesi: proje ayarlarında açtığında, seçtiğin Claude modeli her ajanın kodunu turu bitince inceler. Bulgular önem derecesi ve dosya:satır bağlantısıyla gelir, istersen ajana geri gider. Bkz. kod incelemesi.
- Checkpoint’ler: AgentVera her turun başında ajanın çalışma klasörünün anlık görüntüsünü alır. Panel başlığındaki Turlar düğmesi turları ve her turda değişen dosyaları listeler; Bu turu geri al klasörü geri döndürür. Claude Code değişiklikleri nasıl geri alınır yazısı bunu adım adım anlatıyor.
7. adım: AgentVera’ya yalnızca gerektiğinde giriş yap
Bu rehberdeki çoğu şey hesap gerektirmeyen Ücretsiz planda. Pro ve Team; akışlar, gece vardiyası, otomatik onay ve otomatik hesap geçişi gibi özellikler ekler. Bunları kullanmak için uygulamada AgentVera hesabına giriş’i seç. Tarayıcıda giriş yap ile (Google ile giriş ve iki adımlı doğrulamayı tarayıcı halleder) ya da e-posta ve parolayla giriş yapabilirsin. Hangi planda ne olduğu fiyatlar sayfasında.
İşe yarayan bir ilk oturum
İlk olarak ne deneyeceğinden emin değilsen, değeri hızlı gösteren basit bir kurulum:
- İyi bildiğin bir depoyu ekle.
- Yeni bir worktree’de bir Claude Code ajanı başlat ve ondan küçük, sınırları belli bir değişiklik iste.
- Kendi worktree’sinde, alakasız bir iş için ikinci bir ajan başlat (Codex ya da bir Claude Code daha).
- Izgarayı iki sütuna ayarla ve ikisini de görünür tut.
- Onlar çalışırken diff’leri oku, onayları yanıtla ve sıradaki mesajını kuyruğa al.
- Bir tur ters gidince ajanla tartışmak yerine Turlar’dan geri al.
İlk hafta için ipuçları
- Her ajana tek iş. Ajanlara işlerinin adını ver. Rol ve talimatlar’daki net bir rol aynı şeyi tekrar tekrar yazmaktan kurtarır.
- Her ajana bir worktree. Ajanların birbirinin üzerine yazmasını önlemenin en kolay yolu bu.
- Önce ızgarayı küçük tut. Gerçekten okuduğun iki üç ajan, göz gezdirdiğin sekiz ajandan iyidir.
- Paleti kullan. ⌘K neredeyse her işlemi kısayoluyla birlikte bulur.
- Limitleri izle. Durum çubuğu her hesabın 5 saatlik ve haftalık kullanımını gösterir. Limitleri uzatmak için Claude Code limit yazısına bak.
- İstersen dili değiştir. Arayüz Türkçe ve İngilizce; açık ve koyu tema var. Ayarlar → Görünüm’den seçersin.
Son söz
AgentVera’ya başlamak birkaç dakika sürüyor. Bir proje eklersin, zaten kullandığın CLI ile bir ajan başlatırsın, ikinci bir işin olunca ikinci ajanı eklersin. Worktree’ler, checkpoint’ler, inceleme, ek hesaplar ve telefon bildirimleri gibi her şey aynı ızgaranın üzerine kurulu; her birini ihtiyaç duyduğunda eklersin.