Hızlı başlangıç

Bu, hiçbir şeyden yola çıkıp kendi kodunuz üzerinde çalışan bir ajana ulaşmanın en kısa eksiksiz yoludur. Adımları sırayla izleyin; her adım kendinden öncekine dayanır.

Git’e, bir GitHub hesabına ve ayrıca ya bir model sağlayıcısı hesabına (Anthropic, OpenAI, Codex, Cursor, Kimi Code veya API anahtarı olan herhangi bir sağlayıcı) ya da kurulu bir Claude Code CLI’ye ihtiyacınız var. Geri kalan her şey yol boyunca kurulur.

1. Adım: Kurun ve başlatın

Control Center’ı Kurulum sayfasında anlatıldığı gibi kurun, ardından açın.

İlk açılışta masaüstü uygulaması “Control Center nasıl çalışsın?” diye sorar. Bu uygulamada çalıştır seçeneğini seçin. Control Center bu makinede, verilerinize sahip olan ve tüm işi yapan headless bir cc_server başlatır. Onu hiç görmezsiniz; yerine ilk kurulum ekranı açılır.

Hiçbir şey kurmak istemiyor musunuz?

Aynı uygulama, aynı özelliklerle tarayıcıda app.usectrl.dev adresinde çalışır. Ancak bir tarayıcı sekmesi sunucuyu barındıramaz, bu yüzden sunucuyu siz sağlarsınız — cc_server’ı yerel olarak çalıştırıp ws://localhost:9030 adresine bağlanın ya da onu başka bir makinedeki bir sunucuya yönlendirin. Bu hızlı başlangıç, sunucu kurulumu gerektirmediği için masaüstü yolunu izler; tarayıcı yolu için Kurulum sayfasına bakın.

2. Adım: İlk kurulumu tamamlayın

İlk kurulumun beş adımı vardır ve bunlar sırayla çalışır — ileri atlamak yoktur.

1. Bağlan: GitHub ile oturum açın ya da repo ve read:org kapsamlı bir kişisel erişim belirteci yapıştırın. Kimlik bilgisi sunucuda saklanır ve hesabınıza bağlanır.
2. Çalışma alanı: ilk çalışma alanınızı adlandırın ve isterseniz bir logo seçin. Oluşturmak, beş ajanı — bir CEO ile qa, architect, engineer ve librarian — ve yerleşik pipeline şablonlarını tohumlar.
3. Sandbox: bir sandbox tercihini kaydeder. Her iki seçenek de devam etmenizi sağlar.
4. Adaptör: ajanların varsayılan olarak kullanacağı adaptörü ve modeli seçin. Control Center (built-in) seçeneğini seçin, ardından görünen sağlayıcı seçiciyi kullanarak bir model sağlayıcısına oturum açın — bir sağlayıcı bağlanana kadar model listesi boş kalır. Bu adımı bitirmek, adaptörü ve modeli çalışma alanının CEO ajanına da işler.
5. Ses (isteğe bağlı): dikte için cihaz üzerinde çalışan bir konuşma modeli kurun ya da atlayın.

Control Center ardından çalışma alanınızın gelen kutusunu açar.

Bir ajan çalıştırmasını ne sınırlar

Bir tane varsa ajan komutları ana makinenin işletim sistemine özgü sandbox’ına sarılır — macOS’ta Seatbelt, Linux’ta bubblewrap. Windows’ta arka uç yoktur, bu yüzden oradaki çalıştırmalar yalnızca diğer katmanlarla sınırlanır: konuşmanın kendi worktree’si (Windows’ta git worktree; rift’in geldiği yerde copy-on-write), başlatma başına aracılık edilen ve kapatmada geri alınan kimlik bilgileri ve eylem korumaları. Bkz. Sandbox ve güvenlik.

3. Adım: Bir depo ekleyin

Ayarlar → Çalışma alanı → Depolar bölümüne gidin ve Depo ekle’ye tıklayın.

İletişim kutusu, klasörlere istemcinizde değil sunucuyu çalıştıran makinede göz atar ve sunucunun açığa çıkarmak üzere yapılandırıldığı köklerin içinde kalır (varsayılan olarak kendi kullanıcısının ev dizini). Yalnızca git checkout’ları bir onay kutusu alır. Kendinizinkini işaretleyin ve kaydedin.

Bir checkout yalnızca bir git çalışma ağacının içindeyse, bir origin uzak deposu varsa ve bu uzak depo desteklenen bir kod barındırıcısına — github.com, gitlab.com veya bitbucket.org — işaret ediyorsa kabul edilir. Bunun dışındaki her şey, nedeniyle birlikte reddedilir.

Depolar çalışma alanı kapsamlıdır: burada bir checkout kaydetmek onu bu çalışma alanına koyar. Ayrı bir bağlama adımı yoktur.

4. Adım: Bir ajana adaptör ve model tanımlayın

Ayarlar → Çalışma alanı → Ajanlar bölümüne gidin. Kadrodan engineer ajanını seçin.

Ayarlar sekmesinde şunları belirleyin:

• Adaptör: Control Center (built-in)
• Model: ilk kurulumda bağladığınız sağlayıcıdan birini seçin

Değişiklikleri kaydet’e basın.

Bu adım pratikte isteğe bağlı değildir. İlk kurulum sırasında seçilen adaptörü yalnızca CEO ajanı devralır; dört uzman adaptörsüz oluşturulur. Anthropic’in varsayılan modeliyle birlikte Control Center (built-in) seçeneğine geri düşerler; bu yüzden yalnızca bir Anthropic hesabı bağladıysanız çalışırlar — ve bağladıysanız da seçmediğiniz bir model üzerinde çalışırlar.

5. Adım: Ajana bir görev gönderin

1. Kenar çubuğunda Alanlar bölümünü bulun ve + düğmesine tıklayın.
2. Alana bir ad verin, Ajan ekle altında engineer ajanını ekleyin ve oluşturun.
3. Kaydettiğiniz depoya yönelik somut, küçük bir görev yazın ve Enter’a basın.

Control Center bu konuşma için çalışma alanının depolarından copy-on-write bir worktree sağlar, ajanın rolünden, personasından, becerilerinden ve alanın bağlamından bir istem oluşturur ve çalıştırmayı gönderir. Kaynak checkout’unuza asla dokunulmaz.

6. Adım: Çalışmasını izleyin

Sırayla şunları görmelisiniz:

• Bu konuşmada bir ajan çalıştığı için Composer’ın gönderme düğmesinin bir durdurma düğmesine dönüşmesi
• Ajanın akıl yürütmesinin, araç çağrılarının ve metninin döküme akması
• Çalıştırma bittiğinde gönderme düğmesinin geri gelmesi

Ardından Ayarlar → Çalışma alanı → Ajanlar bölümünü açın, ajanı seçin ve Loglar sekmesine bakın: durumu, süresi, başlangıç ve bitiş zamanları ile üzerinde çalıştığı adaptörle birlikte tek bir çalıştırma satırı.

Döngü budur. Control Center’daki diğer her şey — pull request incelemesi, pipeline’lar, biletler, toplantılar, Slack — buna bağlıdır.

Sonraki adımlar

• İlk çalışma alanınız: aynı konu, daha yavaş, yalıtım modeli açıklanmış olarak
• İlk pull request’inizi inceleyin: bir ajanın dalını incelemeden ve birleştirmeden geçirin
• Ajan modeli: bir ajan nelerden oluşur
• Ajan oluşturma ve yapılandırma: ajan formunun geri kalanı
• Bir orkestrasyon çalıştırma: tek hedef, tek onay, üretilmiş bir pipeline
• Bir cihaz eşleştirme: filoyu her yerden takip edin
• Dağıtım ve istemciler: masaüstü, web ve telefon istemcilerinin sunucuyla ilişkisi