Hızlı Başlangıç: Claude Code veya Codex'i Uzaktan Çalıştırın

Güncellendi

Bu kılavuz, bir geliştirme makinesini PandaNpc'ye bağlar ve Claude Code, Codex veya PandaCode'u başka bir cihazdan çalıştırabildiğinizi doğrular. Aracı hâlâ geliştirme makinenizde çalışır; PandaNpc size mesajlar, onaylar, sorular ve oturum geçmişi için senkronize bir uzak arayüz sağlar.

Çoğu kişi Cihaz ekle akışını kullanmalıdır çünkü bu akış, hesabınıza önceden bağlanmış tek kullanımlık bir kurulum komutu üretir. Yaklaşık beş dakika ve kodlama motorunuzun gerektirdiği model sağlayıcı oturum açma süresini hesaba katın.

Başlamadan önce

İhtiyacınız olanlar:

  • Web uygulamasında, masaüstü uygulamasında veya iOS uygulamasında açılmış bir PandaNpc hesabı.
  • Windows x64, macOS veya Linux x86_64 çalıştıran bir ana makine.
  • Ana makineden internet erişimi ve kullanıcı düzeyinde bir arka plan hizmeti kurma izni.
  • Değiştirmenize izin verilen bir proje klasörü.
  • Seçtiğiniz motor zaten doğrulanmadıysa bir Claude, ChatGPT/Codex veya özel model hesabı.

Yalnızca PandaNpc'nin yerleşik sohbet özelliğine ihtiyacınız varsa ve başka bir makinedeki aracıyı kontrol etmek istemiyorsanız, PandaPaw gerekli değildir. Yalnızca istemci seçenekleri için Kurulum bölümüne bakın.

1. Ana makine kurulum komutunu oluşturun

Oturum açmışken, Bağlı Cihazlar sayfasını açın ve Cihaz ekle seçeneğini belirleyin. PandaNpc tek kullanımlık bir cihaz anahtarı oluşturur ve işletim sisteminiz için tam komutu gösterir.

Bu komutu, kodlama aracısının çalışması gereken makineye kopyalayın. Kullanılıncaya kadar ona bir parola gibi davranın: tek kullanımlık bir anahtar yalnızca bir makineyi eşleştirir ve sohbet, ekran görüntüsü, sorun kayıtları veya kabuk geçmişi dışa aktarımlarında paylaşılmamalıdır.

Hazır bir anahtar yerine tarayıcı yetkilendirmesini tercih ederseniz, sonraki adımdaki düz yükleyiciyi kullanın. Bu yükleyici pandapaw login komutunu çalıştırır ve sizin için yetkilendirme sayfasını açar.

2. Ana makineye PandaPaw kurun

macOS veya Linux

Bağlı Cihazlar'dan hazırlanan komutu çalıştırın veya düz yükleyiciyi kullanın:

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

Windows PowerShell

Bağlı Cihazlar'dan hazırlanan komutu çalıştırın veya şunu kullanın:

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

Yükleyici, PandaPaw'ı ve arka plan hizmetlerini ekler, eksik olan desteklenen kodlama motorlarını mümkün olduğunda kurar ve ana makinede uygun bir Node.js yoksa özel bir Node.js çalışma zamanı sağlar. Hazır bir cihaz anahtarıyla hesap eşleştirme kurulum sırasında gerçekleşir. Düz komutla, istendiğinde tarayıcı yetkilendirme isteğini onaylayın.

Hesap yetkilendirmesi ertelense bile yükleyici tamamlanabilir. Kurulumun başarılı olduğunu ancak hesap bağlantısının eksik olduğunu söylerse şunu çalıştırın:

bash
pandapaw login

3. Ana makine hizmetlerini doğrulayın

Ana makinede şunu çalıştırın:

bash
pandapaw status

Komut, kurulu hizmetleri tanımalı ve hesaba bağlı makineyi göstermelidir. Kabuk pandapaw komutunu bulamazsa, güncellenmiş kullanıcı PATH değerini yeniden yüklemek için önce yeni bir terminal açın.

Bir Git projesi için, Agent Center'ın proje kökünü tanıyıp tanımadığını da kontrol edebilirsiniz:

bash
pandapaw agent status --root /path/to/your/project

Gerçek bir mutlak proje yolu kullanın. Agent Center proje bağlama, dizinin kararlı bir Git remote.origin.url değerine sahip olduğunda en iyi şekilde çalışır.

4. İlk uzak oturumu başlatın

  1. PandaNpc Agent sayfasını telefonunuzda, tarayıcınızda veya başka bir masaüstünde açın.
  2. Yeni bağlanan makineyi bulun. Yeşil durum göstergesi, ana makinenin şu anda erişilebilir olduğu anlamına gelir.
  3. Claude Code, Codex veya PandaCode seçin ve proje çalışma dizinini belirleyin.
  4. Bir oturum başlatın. Motor oturum açmanızı isterse, sağlayıcının yetkilendirmesini ana makinede veya görüntülenen oturum açma akışı aracılığıyla tamamlayın.
  5. Show the current working directory and list the top-level files. Do not edit anything. gibi yıkıcı olmayan bir test komutu gönderin.

Yanıt beklenen proje dizinini adlandırdığında, dosya listesi ana makineyle eşleştiğinde ve herhangi bir izin sorusu onaylamanız veya reddetmeniz için uzak istemcide göründüğünde tam olarak bağlanmışsınız demektir.

5. Yeniden bağlanma davranışını doğrulayın

Görüntüleme istemcisini kapatın, birkaç saniye bekleyin ve aynı oturumu yeniden açın. Mevcut geçmiş geri gelmeli ve ana makine çevrimiçi kalmalıdır. Bu, yalnızca yükleyicinin başarıyla indirildiğini kanıtlamak yerine gerçek uzak yolu kontrol eder.

Bu test sırasında ana makineyi uyku moduna almayın. Uyuyan veya kapatılmış bir ana makine, kayıtlı bağlantı hesabınızda hâlâ görünse bile aracıyı çalıştıramaz.

Sorun Giderme

Makine Agent'ta görünmüyor

Ana makinede pandapaw status komutunu çalıştırın. Kurulum başarılı olduysa ancak hesap iliştirilmemişse, pandapaw login komutunu çalıştırın. Hazır bir anahtar kullandıysanız ve bu anahtar daha önce kullanıldıysa veya süresi dolduysa, Bağlı Cihazlar'da yeni bir tane oluşturun ve görüntülenen komutu yeniden çalıştırın.

`pandapaw` tanınmıyor

Yeni bir terminal açın. macOS/Linux'ta ~/.local/bin dizininin PATH içinde olduğunu doğrulayın. Windows'ta yükleyici, %LOCALAPPDATA%\Programs\pandapaw dizinini kullanıcı PATH değerine ekler; kurulumdan önce açılmış bir terminal yeni değeri görmez.

Makine listeleniyor ancak çevrimdışı

Ana makinenin açık olduğunu, uyanık olduğunu ve internete erişebildiğini doğrulayın. Ardından pandapaw status komutunu kontrol edin. Kurumsal güvenlik duvarları giden HTTPS/WebSocket trafiğine izin vermelidir; gelen bağlantı noktası yönlendirme kuralı oluşturmamalısınız.

Bağlantı çalışıyor ancak motor kimlik doğrulaması istiyor

PandaPaw eşleştirmesi ile model sağlayıcı oturum açma işlemi ayrıdır. Eşleştirme, ana makinenin PandaNpc hesabınıza ait olduğunu kanıtlar; Claude Code veya Codex yine de kendi abonelik oturum açma veya API yapılandırmasını gerektirebilir. Motorun normal oturum açma işlemini tamamlayın ve oturumu yeniden deneyin.

Aracı yanlış klasörde açılıyor

Bu test oturumunu sonlandırın ve amaçlanan çalışma diziniyle yeni bir oturum oluşturun. Araç kullanımını onaylamadan önce aracıya geçerli dizini yazdırmasını isteyin. Uzak bağlantı kendi başına bir dosya sistemi kum havuzu eklemez; motorun araç izinleri ve seçili çalışma dizini önemli olmaya devam eder.

Sonraki adımlar