Kurulumu ajanın kendisine yaptırın

Birlikte çalışma sayfasında anlatılan adaptörlerin birkaç dosyanın doğru yerde olmasına ihtiyacı vardır: Claude Code için bir MCP sunucu kaydı, yaşam döngüsü hook’ları ya da Codex için bir join çağrısı. Bunları elle yazabilirsiniz. İşi, onları kullanacak olan ajana da devredebilirsiniz — ajanın projeye zaten dosya erişimi vardır ve yaptığı işi sonradan kendisi doğrulayabilir.

Aşağıdaki prompt’lar olduğu gibi yapıştırılmak üzere yazıldı.

Yapıştırmadan önce

Bu prompt’lar bilerek hiçbir yol, hostname, veritabanı veya credential içermez. Ajana, ihtiyacı olanı kendisinin keşfetmesi ve tahmin etmek yerine durup sorması söylenir. Prompt metninden daha önemli iki alışkanlık var:

Bir broker parolasını veya veritabanı URI’sini asla prompt’a yapıştırmayın. Bee, BEE_MQTT_USERNAME ve BEE_MQTT_PASSWORD değerlerini ortamdan ya da maskelenen mqtt.username / mqtt.password ayarlarından okur. Prompt’lar transcript’lere düşer; secret’lar düşmemeli.
Kabul etmeden önce diff’i okuyun. İki prompt da ajandan değişikliği yazmadan önce göstermesini ister. .mcp.json ve .claude/settings.json içinde başka araçlara ait kayıtlar bulunabilir ve birleştirmek, üzerine yazmakla aynı şey değildir.

Bee’nin ortak veritabanınıza ve broker’ınıza karşı önceden kurulmuş olması gerekir — İlk çalıştırma ve Birlikte çalışma sayfasının yapılandırma bölümüne bakın. İki prompt da veritabanını sizin için yapılandırmaz; çünkü doğru değerler ajanın tahmini değil, ekibinizin değerleridir.

Claude Code

Bu proje için Bee Collaborate channel'ını kur, sonra bu oturumun katıldığını doğrula.

Bee'nin dokümantasyonu https://bee.fusapp.com/collaborate/ adresinde — herhangi bir
şeyi değiştirmeden önce oku. Şu adımlarla ilerle ve tamamlayamadığın ilk adımda dur.

1. bee çalıştırılabilir dosyasını bul ve çözdüğün mutlak yolu yazdır.
   Gerçek binary olmalı. Windows'ta `.cmd` veya `.bat` shim'i MCP komutu olarak
   çalışmaz: MCP istemcileri çalıştırılabilir dosyayı doğrudan spawn eder ve spawn
   EINVAL ile başarısız olur. İçinde sürüm numarası geçen bir yol yerine, araç
   güncellemelerinden sonra da geçerli kalan kalıcı bir yolu tercih et.

2. Birlikte çalışma yapılandırmasını kontrol et ve bakım kontrolünü çalıştır:
       bee config show
       bee worker --once --json
   Bu komut yalnız bakım işlerini çalıştırır; alıcıyı başlatmaz veya kanıtlamaz.
   Uzun süre çalışan bee worker için işletim sistemi süreç ya da servis durumunu
   ayrıca incele ve çalışıp çalışmadığını raporla.
   Birlikte çalışma etkin değilse ya da yapılandırılmış bir broker yoksa, DUR ve
   neyin eksik olduğunu bana söyle. Bir broker host'u, bir space adı, bir veritabanı
   ya da herhangi bir credential uydurma.

3. `.mcp.json` dosyasında yapmayı düşündüğün değişikliği bana tam olarak göster,
   sonra uygula. `collaborate channel` argümanlarıyla bee çalıştırılabilir dosyasını
   çalıştıran bir `bee-collaborate` stdio sunucusu ekle. Mevcut içerikle BİRLEŞTİR;
   halihazırda orada olan kayıtları düşürme. BEE_HOME değerini yalnızca bu proje
   varsayılan olmayan bir bee profili kullanıyorsa ayarla.

4. Claude ayar dosyasında yapmayı düşündüğün değişikliği bana tam olarak göster,
   sonra uygula. Aynı çalıştırılabilir dosyayı `collaborate channel-hook --event
   SessionStart` ve `--event SessionEnd` ile çalıştıran SessionStart ve SessionEnd
   hook'ları ekle. Hook dizileri birleşir; zaten kayıtlı olan her hook'u koru. Bu
   makine, diğer makinelerin paylaşmadığı bir yol veya profil kullanıyorsa hook'ları
   ortak dosya yerine yerel ayar dosyasına koy.
   Windows'ta `VAR=value command` önekini kullanma — orada geçerli bir shell
   sözdizimi değildir; onun yerine varsayılan profile güven.

5. CLAUDE_CODE_SESSION_ID değerini asla kendin ayarlama. Canlı host sağlar ve
   channel, host'tan gelmeyip dışarıdan elle geçirilen bir kimliğe bağlanmayı
   reddeder.

6. Bu sunucu için Channels geliştirme iznini açarak Claude'u yeniden başlatmanın tam
   komutunu bana söyle ve ben bunu yapıp istemi kabul edene kadar channel'ın etkin
   olmayacağını açıkça belirt. Sadece MCP kaydı yeterli değildir.

7. Ben yeniden başlattıktan sonra bee_peers aracını çağır ve ham sonucu bana göster.
   Oturum bağlama hatası olmadan başarılı yanıt döndüğünü kontrol et. Boş peer
   listesi normaldir: çağıran oturum listeden çıkarılır. Bu, bağlama kontrolüdür;
   mesaj teslimi kanıtı değildir. Sunucu
   başlatılamazsa gerçek sebep stderr'e gider, stdout boş kalır; bu yüzden istemci
   kapanmış bağlantıdan başka bir şey göstermez — herhangi bir teşhis koymadan önce
   çalıştırılabilir dosyayı aynı argümanlarla kendin çalıştır ve stderr'i oku.

Ben istemedikçe bu dosyalardan hiçbirini commit etme.

Codex

Bu Codex oturumu için Bee Collaborate'i kur, sonra bu oturumun katıldığını doğrula.

Bee'nin dokümantasyonu https://bee.fusapp.com/collaborate/ adresinde — herhangi bir
şeyi değiştirmeden önce oku. Şu adımlarla ilerle ve tamamlayamadığın ilk adımda dur.

1. bee çalıştırılabilir dosyasını bul ve çözdüğün mutlak yolu yazdır.

2. Birlikte çalışma yapılandırmasını kontrol et ve bakım kontrolünü çalıştır:
       bee config show
       bee worker --once --json
   Bu komut yalnız bakım işlerini çalıştırır; alıcıyı başlatmaz veya kanıtlamaz.
   Uzun süre çalışan bee worker için işletim sistemi süreç ya da servis durumunu
   ayrıca incele ve çalışıp çalışmadığını raporla.
   Birlikte çalışma etkin değilse ya da yapılandırılmış bir broker yoksa, DUR ve
   neyin eksik olduğunu bana söyle. Bir broker host'u, bir space adı, bir veritabanı
   ya da herhangi bir credential uydurma.

3. Yeni bir konuşmaya değil, bu gerçek konuşmaya katıl. Harness olarak `codex`,
   burada ne üzerinde çalıştığını anlatan kısa bir ad ve ortamdaki gerçek yerel
   thread id'sini kullan. Tam JSON sonucunu yazdır:
       bee collaborate join --harness codex --name <short-name> --native-id "$CODEX_THREAD_ID" --json
   Thread id boşsa DUR: eski bir transcript canlı bir oturumun yerini tutamaz ve
   uydurulmuş bir id, kimsenin ulaşamayacağı bir peer kaydeder.

4. O sonuçtaki `session.id` değerini al ve sonraki her çağrıda
   BEE_COLLABORATE_SESSION_ID olarak açıkça geçir. Ayrı bir shell çağrısı export
   edilmiş bir değişkeni saklamaz; bu yüzden her komutta ayrı ayrı ayarla. Baştan
   sona aynı BEE_HOME profilini kullan.

5. Sana vereceğim topic filtresine abone ol ya da benden bir tane iste. Kendi
   seçtiğin bir filtreye abone olma:
       BEE_COLLABORATE_SESSION_ID='<session.id>' bee collaborate subscribe '<filter>' --json

6. Oturum kaydını doğrula. Şunun ham çıktısını yazdır:
       BEE_COLLABORATE_SESSION_ID='<session.id>' bee collaborate peers --json
   Join sonucundaki session.id ile bağlama hatası olmayan başarılı yanıtı kontrol
   et. Boş peer listesi normaldir: çağıran oturum listeden çıkarılır. Bu, mesaj
   teslimini kanıtlamaz. Teslim durumlarının ne anlama
   geldiğini unutma: transport_written, mesajın transport'a yazıldığını söyler;
   herhangi bir modelin onu okuduğunu değil. Transport'a yazılmış bir mesajı teslim
   edilmiş bir mesaj gibi anlatma.

7. Bu makinenin Windows olup olmadığını bana söyle. Codex adaptörünün sahiplik
   kontrolleri macOS ve Linux'ta lsof ve writer lock kullanır; boştaki bir Codex
   oturumunu uyandırma Windows'ta uygulanmadı — tam destek raporlamak yerine bunu
   açıkça söyle.

Ben istemedikçe hiçbir dosyayı commit etme.

Ajan başarı raporladıktan sonra

Özet değil, ham araç veya komut çıktısı isteyin. Yalnızca var olan bir yapılandırma dosyası hiçbir şeyi kanıtlamaz. Başarılı bir bee_peers çağrısı channel bağlamasını kontrol eder; çağıran oturum listeden çıkarıldığı için boş sonuç normaldir. Codex için başarılı join sonucundaki session.id değerini saklayın. Farklı teslim durumlarının gerçekte neyin kanıtı olduğu için Teslim durumu neyi kanıtlar bölümüne bakın.