Pobieranie PandaNpc i instalacja PandaPaw

Pobieranie PandaNpc i instalacja PandaPaw obejmują oddzielne role: wybierz klienta do podglądu, zainstaluj hosta na komputerze do kodowania i zweryfikuj połączenie.

Zaktualizowano

Zdalna konfiguracja agenta programistycznego składa się z dwóch niezależnych części:

  • Klient PandaNpc — interfejs, którego używasz do przeglądania sesji, wysyłania poleceń i zatwierdzania narzędzi. Działa w przeglądarce, na iOS, Windows, macOS i Linux.
  • Host PandaPaw — usługa w tle na komputerze, na którym faktycznie wykonują się Claude Code, Codex lub PandaCode.

Zainstaluj klienta na urządzeniu podglądowym. Do zdalnego kodowania upewnij się, że komputer uruchamiający agenta ma podłączonego hosta; nie potrzebujesz dodatkowej instalacji hosta na urządzeniu używanym wyłącznie do podglądu.

Zobacz PandaNpc Desktop, aby dowiedzieć się, co aplikacja Windows/macOS/Linux dodaje poza poniższymi krokami instalacji, w tym historię wydań.

Wybierz, co zainstalować

Scenariusz Klient Host PandaPaw
Podgląd już połączonego agenta w przeglądarce Otwórz aplikację webową Już zainstalowany na zdalnym komputerze
Sterowanie agentem na tym samym pulpicie Aplikacja desktopowa Zależy od wybranego trybu lokalnego/zdalnego
Sterowanie maszyną deweloperską z telefonu lub przeglądarki Zainstaluj/otwórz klienta na urządzeniu podglądowym Wymagany na maszynie deweloperskiej
Uruchamianie agentów na serwerze bez graficznego pulpitu Web, desktop lub iOS gdzie indziej Wymagany na serwerze

Aby przejść najkrótszą ścieżką od początku do końca, skorzystaj z Przewodnika szybkiego startu.

Instalacja klienta PandaNpc

Korzystaj ze strony pobierania PandaNpc jako źródła aktualnych instalatorów. Unikaj witryn pobierania od innych producentów, ponieważ mogą oferować stare lub zmodyfikowane pakiety.

Web

Otwórz pandanpc.com/agent w aktualnej przeglądarce. Nic nie jest instalowane. Pamięć przeglądarki przechowuje lokalny stan logowania, więc okna prywatne/incognito mogą wymagać ponownego zalogowania.

iOS

Postępuj zgodnie z linkiem do App Store na stronie pobierania i zainstaluj PandaNpc. iOS jest przydatny do sprawdzania postępów, odpowiadania na pytania i zatwierdzania narzędzi, gdy jesteś z dala od hosta. Proces kodowania nadal działa na połączonym komputerze-hoście. Zobacz PandaNpc dla iOS, aby dowiedzieć się, co obejmuje aplikacja, w tym historię wydań.

Windows

  1. Pobierz aktualny instalator Windows.
  2. Uruchom go i postępuj zgodnie z instrukcjami instalatora.
  3. Uruchom PandaNpc z menu Start.
  4. Jeśli Windows wyświetli ostrzeżenie o wydawcy lub reputacji, przed kontynuowaniem sprawdź, czy plik pochodzi z pandanpc.com.

macOS

  1. Pobierz macOS .dmg.
  2. Przeciągnij PandaNpc do Applications.
  3. Uruchom go z Applications i ukończ ewentualny monit zabezpieczeń macOS.

Wersja macOS jest uniwersalna, więc ten sam pakiet obsługuje Apple Silicon i komputery Mac z procesorami Intel.

Linux

Pobierz AppImage x86_64, nadaj mu uprawnienia do wykonywania i uruchom go:

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

Jeśli AppImage nie uruchamia się, uruchom go raz z terminala i zachowaj dokładne wyjście błędu. Starsze dystrybucje mogą nie mieć biblioteki uruchomieniowej wymaganej przez powłokę pulpitu.

Instalacja PandaPaw na hoście agenta

PandaPaw udostępnia obecnie instalatory hosta dla Windows x64, macOS universal i Linux x86_64. Uruchom polecenie na komputerze, który posiada pliki projektu i na którym mają być wykonywane narzędzia agenta.

Zalecana ścieżka to Połączone urządzenia: wybierz Dodaj urządzenie, a następnie skopiuj wygenerowane jednorazowe polecenie. Podczas instalacji łączy ono hosta z Twoim kontem.

macOS lub Linux

Zwykły instalator z autoryzacją w przeglądarce:

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

Formularz z przygotowanym jednorazowym kluczem:

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

Windows PowerShell

Zwykły instalator:

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

Formularz z przygotowanym jednorazowym kluczem:

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

Potok PowerShell iwr | iex nie może przekazywać zwykłych argumentów skryptu, dlatego instalator Windows odczytuje jednorazowy klucz z PANDANET_KEY.

Co zmienia instalator hosta

Instalator:

  1. Dodaje PandaPaw do katalogu aplikacji/bin bieżącego użytkownika i w razie potrzeby aktualizuje PATH użytkownika.
  2. Rejestruje odpowiednie usługi w tle, aby uruchamiały się automatycznie.
  3. Instaluje brakujące obsługiwane silniki kodowania, jeśli pozwala na to platforma.
  4. Dostarcza prywatne środowisko uruchomieniowe Node.js, gdy system nie ma odpowiedniej wersji.
  5. Rozpoczyna autoryzację konta lub realizuje przygotowany klucz urządzenia.
  6. Zapisuje, które pliki utworzył, aby dezinstalacja mogła zachować zgodne narzędzia, które już istniały.

Instalacja silnika nie powoduje automatycznego zakupu ani uwierzytelnienia subskrypcji modelu. Claude Code i Codex mogą przy pierwszym uruchomieniu poprosić o własne logowanie do dostawcy.

Weryfikacja instalacji

Po instalacji otwórz nowy terminal i uruchom:

bash
pandapaw status

Następnie otwórz PandaNpc Agent. Host powinien być widoczny jako online. Rozpocznij sesję w projekcie testowym i poproś o podanie bieżącego katalogu roboczego bez zmiany plików. To weryfikuje plik binarny, usługę w tle, parowanie konta, połączenie przekaźnikowe, silnik i wybrany katalog — nie tylko etap pobierania.

Aktualizacja

Klienci desktopowi powiadamiają Cię o dostępnej aktualizacji. iOS aktualizuje się przez App Store.

Zakończ aktywną pracę przed aktualizacją z ponownym uruchomieniem: restartowanie zarządzanych usług może przerwać działające sesje agenta. Następnie uruchom:

bash
pandapaw update --restart

Aktualizator weryfikuje pobrany plik binarny względem opublikowanej sumy kontrolnej SHA-256 przed zastąpieniem zainstalowanej kopii. Parowanie konta i istniejąca tożsamość połączenia są zachowane. Ponowne uruchomienie polecenia instalacji jest również obsługiwane, gdy sam aktualizator jest niedostępny.

Dezinstalacja

  • Klient Windows: Ustawienia → Aplikacje → Zainstalowane aplikacje → PandaNpc → Odinstaluj.
  • Klient macOS: zamknij PandaNpc, a następnie przenieś go z Applications do Kosza.
  • Klient Linux: usuń AppImage oraz wszelkie utworzone przez Ciebie programy uruchamiające.
  • Host PandaPaw: uruchom pandapaw uninstall na hoście.

Manifest dezinstalacji PandaPaw rozróżnia narzędzia utworzone przez instalatora od zgodnych narzędzi, które już istniały. Jest celowo zachowawczy i nie usuwa istniejącej instalacji Claude Code, Codex, PandaCode lub Node.

Problemy z instalacją

Polecenie zakończyło się, ale host nie jest połączony

Uruchom pandapaw login. Instalacja hosta i autoryzacja konta to osobne etapy, a instalator może zostać ukończony nawet wtedy, gdy autoryzacja w przeglądarce została odroczona lub przerwana.

Powłoka nie może znaleźć `pandapaw`

Otwórz nowy terminal. W systemach macOS/Linux sprawdź ~/.local/bin; w systemie Windows sprawdź %LOCALAPPDATA%\Programs\pandapaw. Nie instaluj wielokrotnie od nowa, dopóki nie potwierdzisz, czy plik wykonywalny istnieje, a jedynie PATH jest nieaktualny.

Silnik kodowania nie zainstalował się

Instalator hosta traktuje opcjonalne pobieranie silników jako najlepszy wysiłek, aby awaria jednego dostawcy nie usunęła działającej instalacji PandaPaw. Zainstaluj lub napraw ten silnik za pomocą jego oficjalnego instalatora, uwierzytelnij go normalnie, a następnie uruchom ponownie pandapaw status.

AppImage lub aplikacja desktopowa nie chce się otworzyć

Potwierdź, że pobrałeś pakiet dla właściwej architektury, a następnie uruchom go z terminala, aby przechwycić pierwszy błąd. Podaj ten błąd i wersję systemu operacyjnego podczas kontaktu z pomocą; zrzuty ekranu zamkniętego okna zwykle nie wystarczą do zdiagnozowania brakującej biblioteki uruchomieniowej.

W celu sprawdzenia połączeń specyficznych dla hosta przejdź do przewodnika PandaPaw lub FAQ.