Önerilen kurulum: LaunchRepo’dan en iyi sonucu almak için Claude ya da Codex masaüstü uygulaması yerine her zaman bir terminalde Claude Code CLI veya Codex CLI kullanmanı önemle tavsiye ediyoruz. Bu, önerdiğimiz çalışma biçimidir; farklı izinlerin ya da kesintisiz çalışmanın garantisi değildir.
Araç setinin kendi başlangıç sayfası tek ekrana sığar: klonla, bir prompt yapıştır, bir bağlantı aç. Bu rehber aynı üç adımı, her birinin arkasında neler olduğuna dair biraz daha bağlamla anlatıyor; böylece ajanının ne yaptığını ve iş bittiğinde neyi kontrol etmen gerektiğini bilirsin. Önce büyük resmi görmek istersen nasıl çalışır sayfası, bu adımların ürün → ajan → dizinler → takip aracı akışının tamamındaki yerini gösteriyor.
Başlamadan önce neye ihtiyacın var
İlk kurulum için:
- Depoyu klonlamak için Git.
- Windows, macOS ya da Linux üzerinde Python 3.10 veya daha yenisi. Çalışma alanı betikleri, takip aracı ve yerel panel yalnızca standart kütüphaneyi kullanan Python kodudur;
pip installile kurulacak bir şey ve build adımı yoktur. - Dosya okuyup komut çalıştırabilen bir kodlama ajanı: Claude Code, Codex, Cursor ya da benzeri bir araç. Her birinin bu sitede kendi kurulum sayfası var, örneğin Claude Code, Codex ve Cursor. Tarayıcı kontrolü daha sonra gelir ve ilk üç adım için gerekmez.
Depo, ödeme sırasında belirttiğin hesaba gönderilen bir GitHub daveti olarak gelir. Aşağıdaki her şey bu daveti kabul ettiğini varsayar.
1. adım: klonla ve aç
Windows’ta aşağıdaki komutlarda python3 yerine py -3 kullan (Python 3.10+ komutun buysa python). Çalışma alanını OneDrive ya da başka senkronizasyon klasörlerinin dışında, özel bir yerel klasörde tut.
git clone <your LaunchRepo invite URL> LaunchRepo
cd LaunchRepo
Bu klasörü ajanında, herhangi bir projeyi açtığın gibi aç. Henüz hiçbir şey çalışmaz. Az önce oluşturduğun kopya teslimat deposudur: playbook’lar, şablonlar, betikler ve belgeler. Ürünlerin, giriş bilgilerin ve gönderim kayıtların burada durmayacak; 2. adımın amacı da tam olarak bu.
2. adım: başlangıç promptunu yapıştır
Bunu ajana olduğu gibi yapıştır:
Read AGENTS.md, then follow “Start the dashboard for the owner”. Create my private workspace if I do not have one yet, start the dashboard, and give me the link.
AGENTS.md, her AI kodlama ajanının ilk okuduğu dosyadır; başlangıç prosedürünün tamamını ve ajanın yapması gereken kontrolleri içerir. Ajan bu dosyayı izleyerek:
scripts/init-workspace.pyile teslimat kopyasının yanında özel bir çalışma alanı (varsayılan olarak yan yana duran ayrı bir klasör) oluşturur; böylece ürün verilerin asla ortak teslimat deposunda durmaz;- yerel paneli bu çalışma alanının içinden başlatır;
- bir
127.0.0.1bağlantısıyla yanıt verir.
Ajan bir bağlantıyla yanıt verirse 2. adım başarılı olmuştur. Bunun yerine ne yapacağını anlatan bir yanıt verirse, prosedürü gerçekten çalıştırmasını iste. Araç setinin kuralı şudur: bir kontrol, talimatların var olmasıyla değil, sonucun gözlemlenmesiyle tamamlanmış sayılır.
3. adım: bağlantıyı aç
İlk oturumun geri kalanı panel sekmesinde geçer. Oradan ilk ürününü ekler, onboarding promptunu ajanına geri verir, hangi listelemelerin yayında, beklemede, planlanmış ya da seni bekliyor olduğunu görür ve sonraki çalıştırmalar için promptları kopyalarsın. Panel yalnızca 127.0.0.1 adresine bağlanır ve hiçbir dizinle iletişim kurmaz; her ekranı yerel panel rehberi anlatıyor.
İşin bittiğinde ajanın terminalinde Ctrl+C tuşlarına bas ya da ajandan sunucuyu durdurmasını iste. Çalışma alanı ve içine kaydedilen her şey diskte kalır.
Elle yapmak
Kurulumun kendisi için ajana ihtiyacın yok. Promptun tetiklediği üç komut şunlardır:
python3 scripts/init-workspace.py --destination ../my-launch-workspace
cd ../my-launch-workspace
python3 scripts/dashboard.py
Bir çalışma alanı oluşturmadan önce etrafa bakmak mı istiyorsun? python3 scripts/dashboard.py --demo, kurgusal bir ürün içeren geçici bir örnek çalışma alanı açar; böylece kendi verilerine dokunmadan genel bakışı, bir ürün sayfasını ve kataloğu tıklayarak gezebilirsin.
Sırada ne var
Asıl ilk oturumu (ürün özeti, tarayıcı bağlantısı, izinler ve kaydedilmiş bir çalıştırma hedefi) ajan yönetir; ayrıntılar ilk oturum onboarding rehberinde. Ajan bir formu doldurabilmeden önce onu Chrome’una bağlaman da gerekir. Önce bir anlatı okumayı tercih edersen Claude Code ile adım adım anlatım bir lansmanı baştan sona izliyor. Onboarding bittiğinde baştan sona bir lansman çalıştırması, izin kontrolünden kalan platformlarla devam etmeye kadar sonraki her çalıştırmanın nasıl göründüğünü gösteriyor.