Claude Agent View: Tek Terminalden Paralel AI Kodlama Rehberi

⚡ TL;DR — Claude Code'a artık Agent View geldi: tüm background Claude oturumlarını tek terminal ekranından başlatıp izleyip yönetmeni sağlayan bir dashboard. Artık 18 terminal penceresi arasında jonglörlük yapmana gerek yok. claude agents komutunu çalıştır, elinde bir AI dev team dashboard'u olsun.

Claude Agent View Nedir?

Agent View, Claude Code içinde yeni çıkan bir research-preview özelliği. Birden fazla background kodlama oturumunu, terminal içinde tek ve gezilebilir bir dashboard'a dönüştürüyor.

Agent View'dan önce, birkaç Claude Code agent'ını paralel çalıştırmak istediğinde — biri bug fix yaparken, biri feature inşa ederken, biri PR review ederken — her biri için ayrı terminal penceresi açman gerekiyordu. İşler hızlıca dağılıyordu.

Artık şunları yapabilirsin:

• Tek terminalden background Claude oturumları başlatmak
• Çalışan, duraklatılmış veya bitmiş tüm oturumları tek ekrandan görmek
• Herhangi bir oturuma atlayıp input gönderip geri çıkmak
• Claude Code'u tek bir chat gibi değil, bir agent ekibi gibi kullanmak

Neden Önemli?

• Tek ekran, tam görünürlük — hangi agent'ın çalıştığını, beklediğini, bittiğini veya input beklediğini görürsün
• Gerçek paralel iş akışları — research, build, refactor ve review aynı anda, context kaybetmeden
• Daha az terminal karmaşası — hangi pencerede ne yapıldığını hatırlamaya çalışarak alt-tab maratonu yok
• Bir dev team hissi — Claude Code tek bir chat değil, bir control center gibi davranır

⚠️ Başlamadan Önce: Claude Code'u Güncelle

Agent View, Claude Code v2.1.139 veya üzeri ile geliyor. Versiyonun eskiyse claude agents komutu ve /bg slash komutu mevcut olmayacak.

Önce Claude Code'u güncelle:

npm update -g @anthropic-ai/claude-code

Sonra versiyonu doğrula:

claude --version

Versiyon 2.1.139 veya üzeri olmalı. Değilse yeniden kur:

npm install -g @anthropic-ai/claude-code@latest

🚨 Eğer claude agents "unknown command" hatası dönüyorsa, versiyon eski demek. Önce güncelle, terminali yeniden başlat, tekrar dene.

Claude Code'u Henüz Kurmadıysan

Claude Code'a yeni başlıyorsan:

1. nodejs.org üzerinden Node.js (v18+) kur

2. Claude Code'u global olarak kur:

   npm install -g @anthropic-ai/claude-code

3. Giriş yap:

   claude

   Anthropic hesabınla giriş yapmak için yönergeleri takip et.

Detaylı kurulum dokümanları: docs.claude.com/claude-code

Agent View Nasıl Kullanılır — Adım Adım

Adım 1: Dashboard'u Aç

Herhangi bir proje klasöründe şunu çalıştır:

claude agents

Bu komut Agent View dashboard'unu açar. Eğer henüz background oturumun yoksa, boş bir ekran görürsün — bu normal.

Adım 2: Background Agent Başlat

Background oturum başlatmanın iki yolu var:

Yöntem A — Terminal'den sıfırdan başlat:

claude --bg "Refactor the auth module to use JWT instead of sessions"

Bu tek komut, verdiğin prompt ile background'da çalışan yeni bir Claude Code oturumu başlatır.

Yöntem B — Mevcut oturumu background'a gönder:

Aktif bir Claude Code oturumunun içinden şunu yaz:

/bg

Oturum ayrılır ve çalışmaya devam eder. Artık claude agents üzerinden ona ulaşabilirsin.

Adım 3: Agent'ları Dashboard'dan Yönet

claude agents içinde şunları yapabilirsin:

• Durumu tek bakışta gör — running, idle, awaiting input, finished veya failed
• Bir oturuma gir — herhangi bir agent'a atlayıp çıktısını oku veya yeni talimat gönder
• Tekrar background'a al — /bg ile dashboard'a dön, agent çalışmaya devam etsin
• Oturumu öldür — kontrolden çıkmış bir agent'ı durdur

Adım 4: Gerçek Bir Paralel İş Akışı Çalıştır

Tek bir proje için pratik bir kurulum:

claude --bg "Audit the codebase for unused dependencies and write a removal PR"
claude --bg "Generate unit tests for everything in /src/lib that has 0% coverage"
claude --bg "Draft a README rewrite based on the current package.json scripts"

Sonra dashboard'u aç:

claude agents

Artık aynı anda çalışan üç Claude agent'ın var — auditor, test writer ve doc writer — hepsi tek bir pane'de görünür.

En İyi Şekilde Kullanmak İçin İpuçları

• Her agent'a sıkı ve tek amaçlı bir prompt ver. Background oturumları, muğlak "uygulamada çalış" talimatları yerine net bir çıktıya yönelik olduklarında en iyi sonucu verir.
• Ortak context için CLAUDE.md kullan. Proje seviyesinde bir CLAUDE.md dosyası, her background agent'ının aynı kuralları, konvansiyonları ve dikkat edilecek noktaları otomatik almasını sağlar.
• Kontrol et, başında bekleme. Agent View'ın asıl amacı async çalışma. Başlat, uzaklaş, geri dön, gözden geçir.
• /resume ile birlikte kullan. Terminali kapatırsan, background oturumları sıfırdan başlatmak yerine sonradan resume edebilirsin.
• Versiyonu güncel tut. Agent View hâlâ research-preview. Yeni flag'ler ve UI değişiklikleri hızlı geliyor — Claude Code'u haftada bir güncelle.

Sık Karşılaşılan Sorunlar

• claude agents bulunamadı → Claude Code'u güncelle (rehberin başına bak).
• Background oturum "failed" gösteriyor → Oturuma gir, son çıktıya bak. Genelde eksik bir permission, eksik env var veya onay alınmadan çağrılan bir tool olur.
• Agent "waiting for input" diyor → Bir onay prompt'una takılmış. Oturuma gir, cevap ver, devam eder.
• Terminali kapattıktan sonra oturumlar kayboldu → Background oturumlar proje bazında saklanır. Aynı proje klasöründen tekrar aç.

Hızlı Komut Cheat Sheet

Linkler

• Claude Code dokümanları: docs.claude.com/claude-code
• Claude Code changelog & releases: github.com/anthropics/claude-code/releases
• Node.js kurulumu: nodejs.org