Instalacja PandaNpc i PandaPaw

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 tylko klienta do czatu PandaNpc i lokalnego użytku na komputerze. Zainstaluj obie części, gdy chcesz uzyskać dostęp do agenta programistycznego działającego na innym komputerze.

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
Korzystanie z czatu PandaNpc w przeglądarce Otwórz aplikację webową Niewymagane
Sterowanie agentem na tym samym komputerze Aplikacja desktopowa Zależy od wybranego trybu lokalnego/zdalnego
Sterowanie maszyną deweloperską z telefonu lub przeglądarki Zainstaluj/otwórz klienta na urządzeniu wyświetlającym Wymagane na maszynie deweloperskiej
Uruchamianie agentów na serwerze bez graficznego pulpitu Web, desktop lub iOS gdzie indziej Wymagane 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.

Zaktualizuj PandaPaw i uruchom ponownie zarządzane usługi za pomocą:

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.