Başlarken

Kovan, sizin ve ekip arkadaşlarınızın her birinin bir yapay zekâ ajanıyla çalıştığı ve herkesin her ajanın işini canlı gördüğü bir kod editörüdür. Bu sayfa sizi kurulumdan bir ekip arkadaşınızla ilk oturumunuza kadar götürür. Kovan erken erişim döneminde ücretsizdir: yalnızca ajanlarınızın kullandığı yapay zekâ için ödersiniz.

Kurulum

Kovan'ı indirme sayfasından indirin. macOS (Apple silicon), Windows x64 ve ARM64, ayrıca AppImage olarak Linux x64 sürümleri var. Windows'ta ilk açılışta "Windows protected your PC" (Windows bilgisayarınızı korudu) uyarısı çıkabilir: More info (Ek bilgi), ardından Run anyway (Yine de çalıştır) seçin. Intel işlemcili bir Mac'te terminal ajanını kullanın.

Bir ekibe katılmak

Biri sizi davet mi etti? E-postasında bir link var: açın, sayfa size bunun kimin çalışma alanı olduğunu ve neye ihtiyacınız olduğunu söyler. Kod üzerinde onlarla birlikte çalışabilmeniz için şunlar gerekir:

  1. Bilgisayarınızda Kovan. Yalnızca takip etmek için Kovan telefon uygulaması yeterli.
  2. Depoya erişim, GitHub'da (ya da depo nerede duruyorsa orada). Kovan depoyu sizin kendi Git erişiminizle açar; açamıyorsanız sizi davet eden kişiden sizi oraya da eklemesini isteyin.
  3. Modelleri çalıştırmanın bir yolu, kendi ajanınızı kullanmak istediğinizde: OpenRouter anahtarınız, Claude Code veya Codex hesabınız ya da Kovan üzerinden ödeme. Kovan buna ilk ihtiyaç duyduğunuzda sorar.

Giriş yapın

Kovan'ı açın ve Giriş yap ya da hesap oluştur (Sign in or create an account) seçin. Uygulama tarayıcınızda bir giriş sayfası açar; orada GitHub, Google ya da e-posta linkiyle giriş yapabilirsiniz. E-posta linki her cihazda, telefonunuzda da açılır: sayfası, uygulamanın beklerken gösterdiği kodu ister; böylece linki başkası kullanamaz.

Hesapsız devam et (Continue without an account) seçip Kovan'ı kendi anahtarlarınızla tek başınıza da kullanabilirsiniz. Çalışma alanlarını başkalarıyla paylaşmanızı ve telefon uygulamasını kullanmanızı sağlayan şey giriş yapmaktır.

Kontrol listesi

İlk seferde bir Başlarken (Getting started) rehberi kendiliğinden açılır; sonra sol çubuğun altındaki Başla (Start) onu yeniden açar. Adımları:

AdımNe işe yarar
Bir proje klasörü açınProjenizin dosyaları, bir terminal ve değişiklikleriniz; ajanınız burada çalışır.
Bir yapay zekâ ajanı hazırlayınBir ajanın yanıt verebildiğini kontrol eder; veremiyorsa neyin eksik olduğunu ve nerede düzelteceğinizi söyler.
E-postanızı doğrulayınDavetler ve oturum uyarıları bu adrese gelir.
GitHub'ı bağlayınEkip arkadaşlarınızın sizi GitHub kullanıcı adınızla davet etmesini ve Kovan'ın sizin adınıza pull request açmasını sağlar.
Bildirimleri açınPencere arka plandayken bir ajan işini bitirdiğinde ya da onay istediğinde Kovan size haber verir.
İlk oturumunuzu başlatınOturum, ortak bir iştir.
Bir ekip arkadaşı davet edinÇalışma alanınıza bir rolle birini ekleyin.

Bir depo açın

Klasör aç (Open folder) seçeneğini kullanın. Bir Git deposunun içindeki bir klasörü açarsanız çalışma alanının kökü deponun kökü olur. (Terminal ajanı onu başlattığınız klasörde çalışır: oraya cd ile geçip kovan çalıştırın.)

Artık çalışan bir editörünüz, bir terminaliniz, bir Git paneliniz ve bir ajan paneliniz (⌘L; Windows ve Linux'ta Ctrl+L) var. Komut paleti için ⌘K (Ctrl+K), bir dosyaya gitmek için ⌘P (Ctrl+P) tuşlarına basın.

Ajanınıza bir model verin

Bir ajanın düşünmek için bir yapay zekâ modeline ihtiyacı vardır. Bunlardan herhangi biri olur:

  • Zaten kullandığınız Claude Code veya Codex. Ayarlar → Ajanlar → Hesaplar (Settings → Agents → Accounts) bölümünde Bu bilgisayarın Claude Code'unu kullan (Use this computer's Claude Code) seçin (ya da Codex'i): kendi girişiniz ve ayarlarınızla çalışır, fazladan bir şey ödemezsiniz.
  • Kendi anahtarınız. Ayarlar → Model anahtarları ve harcama (Settings → Model keys & spend) bölümüne bir OpenRouter anahtarı yapıştırın (yüzlerce modele ulaşan tek bir hesap; kullandıkça ödersiniz). Anahtar sisteminizin anahtar zincirinde saklanır.
  • Kovan üzerinden. Kovan üzerinden ödemeyi kurun: kendi anahtarınız gerekmez, modelin maliyetinin %5 fazlasını, belirlediğiniz aylık sınıra kadar ödersiniz.

Biri hazır olana kadar sohbet kutusu, siz bir şey göndermeden önce neyin eksik olduğunu söyler. Bkz. Ajanlar.

Çalışma alanını paylaşın

Sol çubuktan Çalışma alanları (Workspaces) bölümünü açın ve depoyu ekibinizle paylaşmak için + (ya da daha önce açılmış bir klasörün yanındaki Paylaş (Share)) seçin; ardından Kişiler (People) sayfasından insanları GitHub kullanıcı adı veya e-postayla davet edin. Herkes aynı deponun kendi kopyasında (clone) çalışır; Kovan bunların aynı proje olduğunu deponun remote adresinden (push edildiği yer, örneğin GitHub) anlar.

Bir oturum başlatın

Oturumlar (Sessions) panosunda Yeni (New) seçin, işi anlatın ve yeni bir dal ya da var olan bir dalı seçin. Ekip arkadaşlarınız oturumu kendi panolarında görür, katılabilir ya da izleyebilir. Buradan sonrası için Bir oturumda birlikte çalışmak sayfasını okuyun.

Klavye temelleri

Tuşlarİşlem
⌘K / Ctrl KKomut paleti
Enterİsteği gönderir
Shift EnterYeni satır
EscAçık olanı kapatır ya da çalışan ajanı durdurur
Shift Tabİzin modları arasında geçer

Kısayolları Ayarlar → Klavye (Settings → Keyboard) bölümünden değiştirebilirsiniz.