PandaPaw: Claude Code, Codex ve PandaCode için Uzak Ana Bilgisayar

PandaPaw, kontrol ettiğiniz Windows, macOS veya Linux makinesini bir PandaNpc aracı ana bilgisayarına dönüştürür. Kodlama motoru, proje dosyaları, kabuk ve araçlar o ana bilgisayarda kalır; PandaNpc istemcileri size telefon, tarayıcı veya başka bir masaüstünden senkronize bir arayüz sunar.

PandaPaw'ı, işi yapan makine elinizdeki cihazdan farklı olduğunda, ana bilgisayarın istemci bağlantıları kesilse bile ayakta kalmasını istediğinizde veya birden fazla kodlama motorunun aynı hesap tabanlı kurulumu ve Agent Center yapılandırmasını paylaşması gerektiğinde kullanın.

PandaPaw'ın yönettiği şeyler

• Claude Code, OpenAI Codex ve PandaCode için uzak aracı bağlantıları.
• Arka plan hizmetleri ve otomatik başlatma; böylece ana bilgisayar normal bir yeniden başlatmanın ardından geri dönebilir.
• Hesap tabanlı makine yetkilendirmesi; uzun ömürlü Bridge ID, belirteç veya imzalama anahtarını elle kopyalamadan.
• Desteklenen bir kodlama motoru eksik olduğunda motor kurulum yardımı.
• Her motorun rehberliğini, becerilerini, hafızasını ve aracı tanımlarını kendi yerel düzeninde görüntüleyen Agent Center projeksiyonları.
• Bağlı Cihazlar akışıyla katılan makineler için özel cihaz ağı.
• Güncelleme ve kaldırma kayıtları; böylece PandaPaw'dan önce var olan araçlar korunur.

PandaPaw tek başına bir model aboneliği sağlamaz. Claude Code, Codex ve PandaCode, kendi motorları için yapılandırılmış sağlayıcı kimlik bilgilerini ve limitlerini kullanmaya devam eder.

Uzaktan yürütme nasıl çalışır

Her iki taraf da dışa dönük bağlantılar başlatır; bu nedenle normal bir ev veya ofis kurulumu için gelen güvenlik duvarı kuralı, genel IP adresi, yönlendirici bağlantı noktası yönlendirmesi veya herkese açık bir SSH sunucusu gerekmez. Aktarma sunucusu (relay) mesajları, durum bilgilerini ve onayları taşır; araç yürütme ana bilgisayarda gerçekleşir.

Ana bilgisayar uyku moduna geçerse, kapanırsa veya dışa dönük ağ yolunu kaybederse, kaydedilen bağlantı hesabınızda kalır ancak ana bilgisayar geri dönene kadar iş yürütemez.

Desteklenen ana bilgisayar platformları

PandaNpc görüntüleme istemcisi daha geniş bir platform matrisine sahiptir. İstemci ve ana bilgisayar paketlerini seçerken PandaNpc ve PandaPaw'ı Yükleme bölümüne bakın.

Önerilen kurulum

1. PandaNpc'de oturum açın.
2. Bağlı Cihazlar bölümünü açın.
3. Cihaz Ekle seçeneğini belirleyin. Tek kullanımlık bir anahtar verilir ve iletişim kutusu algılanan işletim sistemi için bir komut gösterir.
4. Bu komutu ana bilgisayara kopyalayın ve orada çalıştırın.
5. Yeni makineyi otomatik olarak algılamasını istiyorsanız iletişim kutusunu açık bırakın.

Hazırlanan anahtar tek kullanımlıktır. Komutun tamamını kopyalayın, gizli tutun ve anahtarın süresi dolarsa veya zaten kullanılmışsa yeni bir tane oluşturun.

Düz macOS/Linux yükleyici

Bu biçimi hazırlanmış anahtar yerine tarayıcı yetkilendirmesi istediğinizde kullanın:

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

Düz Windows PowerShell yükleyici

iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

Düz yükleyici pandapaw login komutunu çalıştırır. Açtığı tarayıcı sayfasında makineyi onaylayın. Yetkilendirme kesintiye uğrarsa, ikili dosya ve hizmetler yine de kurulabilir; hesap bağlantısını bitirmek için daha sonra pandapaw login komutunu çalıştırın.

Ana bilgisayarı doğrulayın

Önce ana bilgisayarın kendisini kontrol edin:

pandapaw status

Ardından PandaNpc Agent bölümünü açın ve makinenin yeşil çevrimiçi göstergesine sahip olduğunu doğrulayın. Geçici veya salt okunur bir test dizininde bir oturum başlatın ve şunu sorun:

Test istemi: Geçerli çalışma dizinini yazdırın ve üst düzey dosyaları listeleyin. Hiçbir şeyi değiştirmeyin.

Başarılı bir yanıt, yalnızca yeşil bir durum ışığından daha fazlasını kanıtlar: hesap eşleştirmeyi, aktarma sunucusu bağlantısını, seçili motoru, sağlayıcı kimlik doğrulamasını ve çalışma dizini eşlemesini doğrular.

Bir Agent Center projesi için şunu çalıştırın:

pandapaw agent status --root /absolute/path/to/project

Bu, projenin bağlı olup olmadığını ve yönetilen yapılandırmanın yerel olarak kullanılabilir olup olmadığını gösterir. Kararlı bir Git uzak deposu, PandaPaw'ın aynı projeyi makineler arasında tanımlamasına yardımcı olur.

Hesap yetkilendirmesi ve bağlantı kimliği

pandapaw login bir tarayıcı cihaz yetkilendirme oturumu kullanır. Onayladıktan sonra ana bilgisayar TLS üzerinden cihaz kapsamındaki kimlik bilgilerini ve bir Agent Center doğrulama anahtarını alır, makine yapılandırmasını ~/.pandapaw/ altına yazar, desteklenen motor bağlantılarını kaydeder ve tanınabilir Git projelerini bağlar.

pandapaw login --force komutunu yalnızca kasıtlı olarak hesap değiştirirken veya süresi dolmuş bir ana bilgisayar kimlik bilgisini değiştirirken çalıştırın. Sağlıklı bir makineyi bir neden olmadan yeniden yetkilendirmek, kafa karıştırıcı yinelenen veya değiştirilmiş kimlikler oluşturabilir.

pandapaw qr uyumluluk ve özel durumlar için hâlâ kısa ömürlü bir manuel bağlantı bağlantısı oluşturur. Yeni bir ana bilgisayar için birincil akış bu değildir; Bağlı Cihazlar denetlenmesi daha kolaydır ve kullanıcıların Bridge ID'leri anlamasını gerektirmez.

Agent Center senkronizasyonu

Agent Center kararlı durumda olay güdümlüdür:

1. Yerel yönetilen dosya değişiklikleri algılanır ve bağlı projeye yayınlanır.
2. İmzalı sürümler bir olay akışı aracılığıyla gelir.
3. Değişmeyen bildirimler ve içerik blobları yeniden indirilmek yerine yeniden kullanılır.
4. Geçici bir bağlantı kesintisi sırasında kaçırılan olaylar, periyodik bir kurtarma kontrolüyle yakalanır.

Claude Code, Codex ve PandaCode farklı dizinler ve talimat biçimleri bekledikleri için ayrı projeksiyonlar alır. PandaCode, yeni bir oturum istemi oluşturmadan önce en son doğrulanmış sürümü hazırlar; böylece başlangıçta çekilen yapılandırma aynı oturumu etkileyebilir.

Agent Center geçici olarak kullanılamıyorsa, motor en son doğrulanmış yerel sürümle devam eder. Bir ağ hatası, imzalı yapılandırmayı sessizce doğrulanmamış içerikle değiştirmemelidir.

Yararlı komutlar

pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall

Bir komut veya arayüz eski bir ekran görüntüsünden veya öğreticiden farklıysa PandaPaw sürüm geçmişine bakın.

Güvenlik sınırları

• Uzaktan bir operatör, seçili aracı oturumunun izin verdiği araçları ve çalışma dizinini kullanabilir. Uzaktan erişim otomatik olarak salt okunur değildir.
• Tek kullanımlık cihaz komutlarını, manuel bağlantı bağlantılarını, sağlayıcı anahtarlarını ve hesap belirteçlerini günlüklerden ve ekran görüntülerinden uzak tutun.
• PandaPaw'a erişilebilir kılmak için gelen yönlendirici bağlantı noktalarını açmayın.
• Artık sahibi olmadığınız ana bilgisayarları Bağlı Cihazlar'dan kaldırın.
• Araç onaylarını gözden geçirin ve düzenlemelere veya kabuk komutlarına izin vermeden önce çalışma dizinini doğrulayın.
• Canlı bir bağlantıyı paylaşırken, alıcı ana bilgisayar sahibinin motor kotasını kullanır ve ana bilgisayarda işlem yapabilir. Önce Bağlantı Paylaşımı bölümünü okuyun.

Sorun giderme

Kurulumdan sonra `pandapaw` bulunamıyor

Kullanıcı PATH değerini yeniden yüklemesi için yeni bir terminal açın. Normal konumlar macOS/Linux'ta ~/.local/bin ve Windows'ta %LOCALAPPDATA%\Programs\pandapaw şeklindedir. Yükleyiciyi yeniden çalıştırmadan önce dosyanın var olduğunu doğrulayın.

Kurulum başarılı ancak hiçbir makine görünmüyor

pandapaw status komutunu çalıştırın. Makinenin hesap yetkilendirmesi yoksa pandapaw login komutunu çalıştırın. Hazırlanmış tek kullanımlık bir anahtar kullanıldıysa, tüketilmiş bir komutu yeniden denemek yerine yeni bir anahtar oluşturun.

Makine görünüyor ancak çevrimdışı kalıyor

Ana bilgisayarın açık olduğunu ve internet erişimine sahip olduğunu doğrulayın. PandaPaw durumunu yerel olarak kontrol edin. Bir kurumsal proxy veya güvenlik duvarı, dışa dönük HTTPS/WebSocket yoluna izin vermelidir; gelen bir bağlantı noktası, engellenen bir dışa dönük bağlantıyı çözmez.

Ana bilgisayar çevrimiçi ancak Claude Code veya Codex yanıt vermiyor

Ana bilgisayarı eşleştirmek her model sağlayıcısının kimliğini doğrulamaz. Motoru yerel olarak açın veya uzak oturumda gösterilen oturum açma istemini izleyin. Ayrıca seçili modelin o hesap için var olduğunu ve kullanım limitinin tükenmediğini doğrulayın.

Oturum yanlış projede açılıyor

Testi sonlandırın, amaçlanan mutlak çalışma dizinini seçin ve araçları onaylamadan önce aracıdan bunu yazdırmasını isteyin. PandaPaw hangi depoyu kastettiğinizi tahmin etmez ve motorun kendi izin modelinin ötesinde bir dosya sistemi kum havuzu eklemez.

Agent Center değişiklikleri görünmüyor

pandapaw agent status --root /path/to/project komutunu doğru Git kökünden çalıştırın. Projenin bağlı olduğunu, ana bilgisayarın oturum açtığını ve yerel dosyanın yönetilen bir projeksiyonun parçası olduğunu doğrulayın. Araştırırken yönetilen dizinleri silmek yerine son doğrulanmış sürümü yerinde tutun.

Güncelleme ve kaldırma

pandapaw update --restart geçerli ikili dosyayı indirir, SHA-256 sağlama toplamını doğrular, kurulu kopyayı değiştirir ve yönetilen hizmetleri yeniden başlatarak sürümün etkin olmasını sağlar. Mevcut hesap eşleştirmesi korunur.

pandapaw uninstall, PandaPaw'ın oluşturduğu öğeleri kaldırmak için kurulum bildirimini kullanır. Önceden mevcut olan uyumlu Claude Code, Codex, PandaCode veya Node kurulumları kasıtlı olarak korunur. Kaldırma işleminden sonra, ana bilgisayara artık güvenilmemeliyse onu Bağlı Cihazlar'dan kaldırın.