# AgentVera nasıl kullanılır: ilk proje, ajanlar ve ızgara

Adres: https://agentvera.dev/blog/agentvera-nasil-kullanilir/ · Yayın: 2026-10-24

AgentVera adım adım: proje klasörü ekle, Claude Code ya da Codex ajanlarını başlat, ızgarayı düzenle, durumlarını izle ve yalnızca Pro için giriş yap.

**Kısaca:**

- İstediğin ajan CLI’larını kur, AgentVera’yı aç, bir proje klasörü ekle ve Yeni ajan ile ajan başlat; her biri kendi terminal panelinde gerçek CLI olarak çalışır.
- Ajanlar CLI’ların mevcut girişlerini kullanır. Ek Claude ve Codex hesapları Ayarlar → Hesaplar’a eklenir, Yeni ajan penceresinde her ajan için biri seçilir.
- Temel özellikler AgentVera hesabı olmadan çalışır. Akışlar, otomatik onay ve otomatik hesap geçişi gibi Pro ve Team özellikleri için giriş yaparsın.

**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](/indir/) 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](/blog/claude-code-nasil-kullanilir/) 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.

1. **Araç:** CLI’ı seç, ör. Claude Code ya da Codex. AgentVera’nın bu bilgisayarda bulamadığı araç **Kurulu değil** olarak işaretlenir.
2. **Ajan adı** ve **Renk:** “Backend” ya da “İnceleyici” gibi kısa bir ad ızgarayı okumayı kolaylaştırır.
3. **Çalışma yeri:** şimdilik **Bu bilgisayar** olarak bırak. Ajanı bir SSH sunucusunda da çalıştırabilirsin.
4. **Hesap:** ajanın kullanacağı giriş. Varsayılan, bu bilgisayarda zaten açık olan giriştir. Alanda **Oturum açık** ya da **Oturum kapalı** yazar.
5. **Çalışma alanı:** ana klasör ya da projenin Git worktree’lerinden biri.
6. **Rol ve talimatlar:** isteğe bağlı. Claude’da sistem prompt’una, Codex’te developer instructions olarak eklenir.
7. **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](/ozellikler/token-tasarrufu/), kapsayıcıda çalıştırmayı [Docker](/ozellikler/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](/blog/claude-code-hesap-degistirme/) 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](/blog/git-worktree-paralel-gelistirme/), işi bölmeyi [birden fazla Claude Code ajanı](/blog/birden-fazla-claude-code-ajani/) 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](/ozellikler/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](/ozellikler/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](/blog/claude-code-degisiklikleri-geri-alma/) 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](/fiyatlar/).

## İşe yarayan bir ilk oturum

İlk olarak ne deneyeceğinden emin değilsen, değeri hızlı gösteren basit bir kurulum:

1. İyi bildiğin bir depoyu ekle.
2. Yeni bir worktree’de bir Claude Code ajanı başlat ve ondan küçük, sınırları belli bir değişiklik iste.
3. Kendi worktree’sinde, alakasız bir iş için ikinci bir ajan başlat (Codex ya da bir Claude Code daha).
4. Izgarayı iki sütuna ayarla ve ikisini de görünür tut.
5. Onlar çalışırken diff’leri oku, onayları yanıtla ve sıradaki mesajını kuyruğa al.
6. 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](/blog/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.

## Sık sorulanlar

**Başlamak için AgentVera hesabı gerekir mi?** Hayır. Projeler, ajanlar, ızgara, Git, MCP, Docker, SSH, kod incelemesi ve token tasarrufu Ücretsiz planda ve hesap istemez. AgentVera hesabına yalnızca Pro ya da Team özelliklerini açmak için giriş yaparsın.

**AgentVera, Claude Code ya da Codex’in yerini mi alır?** Hayır. AgentVera gerçek CLI’ları çalıştırır. Her ajan kendi terminalinde çalışan bir Claude Code, Codex, Gemini CLI, Copilot CLI ya da başka bir CLI sürecidir ve o CLI’ın kendi girişini ve ayarlarını kullanır.

**Seçtiğim araç Kurulu değil diyorsa ne yapmalıyım?** AgentVera o CLI’ı bu bilgisayarda bulamadı demektir. Aracı üreticisinin anlattığı şekilde kur, komutun normal bir terminalde çalıştığından emin ol ve Yeni ajan penceresini yeniden aç.

**Bir projede kaç ajan çalıştırabilirim?** Ücretsiz planda ajan sınırı yok. Izgara proje başına 5 sütun × 4 satıra kadar panel gösterir ve her proje kendi düzenini hatırlar.

**AgentVera hangi sistemlerde çalışır?** macOS, Windows ve Linux. Kendini agentvera.dev üzerinden günceller; uygulamayı bir sonraki açışında ajanlar konuşmalarına geri döner.

---

**AgentVera hakkında.** AgentVera, Solviera Teknoloji tarafından geliştirilen macOS, Windows ve Linux masaüstü uygulamasıdır. 18 yapay zeka kodlama ajanını (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) proje bazında, gerçek terminallerde ve kullanıcının kendi CLI kurulum ve girişleriyle yan yana çalıştırır. Ücretsiz planda sınırsız ajan vardır. İndir: https://agentvera.dev/indir/ · Fiyatlar: https://agentvera.dev/fiyatlar/