PandaNpc ve PandaPaw Kurulumu

Güncellendi

Uzaktan kodlama aracısı kurulumu iki bağımsız bölümden oluşur:

  • PandaNpc istemcisi — oturumları okumak, komutlar göndermek ve araçları onaylamak için kullandığınız arayüz. Web, iOS, Windows, macOS ve Linux üzerinde çalışır.
  • PandaPaw ana bilgisayarı — Claude Code, Codex veya PandaCode'un gerçekten çalıştığı bilgisayardaki arka plan hizmetidir.

PandaNpc sohbeti ve yerel masaüstü kullanımı için yalnızca istemciyi kurun. Başka bir makinede çalışan bir kodlama aracısına erişmek istediğinizde her iki bölümü de kurun.

Windows/macOS/Linux uygulamasının aşağıdaki kurulum adımlarının ötesinde neler eklediğini ve sürüm geçmişini görmek için PandaNpc Desktop sayfasına bakın.

Ne kuracağınızı seçin

Senaryo İstemci PandaPaw ana bilgisayarı
PandaNpc sohbetini bir tarayıcıda kullanma Web uygulamasını açın Gerekli değil
Aynı masaüstünde bir aracıyı kontrol etme Masaüstü uygulaması Seçilen yerel/uzak moda bağlıdır
Bir telefon veya tarayıcıdan bir geliştirme makinesini kontrol etme İzleme cihazına bir istemci kurun/açın Geliştirme makinesinde gereklidir
Grafik masaüstü olmayan bir sunucuda aracılar çalıştırma Web, masaüstü veya iOS başka bir yerde Sunucuda gereklidir

En kısa uçtan uca yol için Hızlı Başlangıç Kılavuzu bölümünü kullanın.

PandaNpc istemcisi kurma

Güncel yükleyiciler için PandaNpc indirme sayfasını kaynak olarak kullanın. Üçüncü taraf indirme sitelerinden kaçının çünkü eski veya değiştirilmiş paketler sunabilirler.

Web

Güncel bir tarayıcıda pandanpc.com/agent adresini açın. Hiçbir şey kurulmaz. Tarayıcı depolaması yerel oturum açma durumunu tutar; bu nedenle gizli/özel pencereler yeniden oturum açmanızı gerektirebilir.

iOS

İndirme sayfasındaki App Store bağlantısını izleyin ve PandaNpc'yi kurun. iOS; ana bilgisayardan uzaktayken ilerlemeyi kontrol etmek, soruları yanıtlamak ve araçları onaylamak için kullanışlıdır. Kodlama süreci yine de bağlı ana bilgisayar makinesinde çalışır. Uygulamanın kapsamı ve sürüm geçmişi için PandaNpc for iOS bölümüne bakın.

Windows

  1. Güncel Windows yükleyicisini indirin.
  2. Çalıştırın ve yükleyici komutlarını izleyin.
  3. Başlat menüsünden PandaNpc'yi başlatın.
  4. Windows bir yayıncı veya itibar uyarısı gösterirse, devam etmeden önce dosyanın pandanpc.com adresinden geldiğini doğrulayın.

macOS

  1. macOS .dmg dosyasını indirin.
  2. PandaNpc'yi Applications klasörüne sürükleyin.
  3. Applications klasöründen başlatın ve macOS güvenlik istemini tamamlayın.

macOS sürümü evrenseldir, bu nedenle aynı paket Apple Silicon ve Intel Mac'leri destekler.

Linux

x86_64 AppImage dosyasını indirin, çalıştırılabilir yapın ve çalıştırın:

bash
chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImage

AppImage başlamazsa, bir kez terminalden çalıştırın ve tam hata çıktısını saklayın. Eski dağıtımlarda masaüstü kabuğunun gerektirdiği bir çalışma zamanı kitaplığı eksik olabilir.

PandaPaw'ı aracı ana bilgisayarına kurma

PandaPaw şu anda Windows x64, macOS evrensel ve Linux x86_64 için ana bilgisayar yükleyicileri sağlar. Komutu, proje dosyalarına sahip olan ve aracının araçlarını çalıştırması gereken bilgisayarda çalıştırın.

Önerilen yol Connected Devices sayfasıdır: Add a device seçeneğini seçin ve ardından oluşturulan tek kullanımlık komutu kopyalayın. Bu, kurulum sırasında ana bilgisayarı hesabınızla eşleştirir.

macOS veya Linux

Tarayıcı yetkilendirmeli düz yükleyici:

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

Hazır tek kullanımlık anahtar formu:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxx

Windows PowerShell

Düz yükleyici:

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

Hazır tek kullanımlık anahtar formu:

powershell
$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

PowerShell'in iwr | iex ardışık düzeni normal betik bağımsız değişkenlerini iletemez, bu nedenle Windows yükleyicisi tek kullanımlık anahtarı PANDANET_KEY ortam değişkeninden okur.

Ana bilgisayar yükleyicisinin değiştirdikleri

Yükleyici:

  1. PandaPaw'ı geçerli kullanıcının uygulama/bin dizinine ekler ve gerektiğinde kullanıcı PATH değerini günceller.
  2. Otomatik olarak başlatılacak uygun arka plan hizmetlerini kaydeder.
  3. Platform izin verdiğinde eksik olan desteklenen kodlama motorlarını kurar.
  4. Sistemde uygun bir sürüm yoksa özel bir Node.js çalışma zamanı sağlar.
  5. Hesap yetkilendirmesini başlatır veya hazırlanan cihaz anahtarını kullanır.
  6. Oluşturduğu dosyaları kaydeder; böylece kaldırma işlemi önceden mevcut uyumlu araçları koruyabilir.

Bir motorun kurulması, otomatik olarak bir model aboneliği satın almaz veya doğrulamaz. Claude Code ve Codex, ilk çalıştırmalarında kendi sağlayıcı oturum açma işlemlerini yine de isteyebilir.

Kurulumu doğrulama

Kurulumdan sonra yeni bir terminal açın ve şunu çalıştırın:

bash
pandapaw status

Ardından PandaNpc Agent sayfasını açın. Ana bilgisayar çevrimiçi görünmelidir. Bir test projesinde oturum başlatın ve dosyaları değiştirmeden geçerli çalışma dizinini bildirmesini isteyin. Bu; yalnızca indirme adımını değil, ikili dosyayı, arka plan hizmetini, hesap eşleştirmesini, aktarım bağlantısını, motoru ve seçilen dizini doğrular.

Güncelleme

Masaüstü istemcileri bir güncelleme mevcut olduğunda sizi bilgilendirir. iOS güncellemeleri App Store üzerinden yapılır.

PandaPaw'ı güncellemek ve yönetilen hizmetlerini yeniden başlatmak için:

bash
pandapaw update --restart

Güncelleyici, kurulu kopyayı değiştirmeden önce indirilen ikili dosyayı yayınlanan SHA-256 sağlama toplamına karşı doğrular. Hesap eşleştirmeniz ve mevcut bağlantı kimliğiniz korunur. Güncelleyicinin kendisi kullanılamadığında kurulum komutunu yeniden çalıştırmak da desteklenir.

Kaldırma

  • Windows istemcisi: Ayarlar → Uygulamalar → Yüklü uygulamalar → PandaNpc → Kaldır.
  • macOS istemcisi: PandaNpc'den çıkın, ardından Applications klasöründen Çöp Kutusu'na taşıyın.
  • Linux istemcisi: AppImage dosyasını ve onun için oluşturduğunuz başlatıcıları kaldırın.
  • PandaPaw ana bilgisayarı: Ana bilgisayarda pandapaw uninstall komutunu çalıştırın.

PandaPaw'ın kaldırma bildirimi, yükleyicinin oluşturduğu araçları önceden mevcut uyumlu araçlardan ayırır. Önceden mevcut bir Claude Code, Codex, PandaCode veya Node kurulumunu silmek yerine bilinçli olarak koruyucudur.

Kurulum sorunları

Komut bitti ancak ana bilgisayar bağlanmadı

pandapaw login komutunu çalıştırın. Ana bilgisayar kurulumu ve hesap yetkilendirmesi ayrı aşamalardır; tarayıcı yetkilendirmesi ertelenmiş veya kesintiye uğramış olsa bile yükleyici tamamlanabilir.

Kabuk `pandapaw` komutunu bulamıyor

Yeni bir terminal açın. macOS/Linux'ta ~/.local/bin dizinini; Windows'ta %LOCALAPPDATA%\Programs\pandapaw dizinini kontrol edin. Çalıştırılabilir dosyanın var olup olmadığını ve yalnızca PATH değerinin güncel olup olmadığını doğrulamadan önce tekrar tekrar kurulum yapmayın.

Bir kodlama motoru kurulamadı

Ana bilgisayar yükleyicisi, isteğe bağlı motor indirmelerini en iyi çaba olarak değerlendirir; böylece bir sağlayıcı kesintisi, çalışan bir PandaPaw kurulumunu kaldırmaz. Bu motoru resmi yükleyicisini kullanarak kurun veya onarın, normal şekilde doğrulayın ve ardından pandapaw status komutunu yeniden çalıştırın.

AppImage veya masaüstü uygulaması açılmıyor

Paketi doğru mimari için indirdiğinizi doğrulayın, ardından ilk hatayı yakalamak için terminalden başlatın. Destek ile iletişime geçerken bu hatayı ve işletim sistemi sürümünüzü ekleyin; kapalı bir pencerenin ekran görüntüleri genellikle eksik bir çalışma zamanı kitaplığını teşhis etmek için yeterli değildir.

Ana bilgisayara özel bağlantı kontrolleri için PandaPaw rehberi veya SSS bölümüne devam edin.