PandaNpc Work – szybki start: połącz pierwszego agenta

Zacznij korzystać z PandaNpc Work, wielosilnikowej przestrzeni roboczej AI. Połącz komputer z PandaPaw, wybierz silnik agenta i zweryfikuj sesję zdalną.

Zaktualizowano

Ten przewodnik pokazuje, jak połączyć jeden komputer z PandaNpc Work i sprawdzić, czy możesz uruchamiać Claude Code, Codex lub PandaCode z innego urządzenia. PandaNpc Work to wielosilnikowa przestrzeń robocza AI, w której delegujesz pracę i śledzisz ją na różnych urządzeniach. Agent nadal działa na połączonym komputerze; PandaPaw zapewnia most i lokalne środowisko uruchomieniowe, a PandaNpc Work daje zsynchronizowany interfejs do wiadomości, zatwierdzeń, pytań i historii sesji.

Ta ścieżka jest najlepsza dla osób, które znają już Claude Code, Codex lub podobnego agenta kodującego. Większość osób powinna użyć przepływu Dodaj urządzenie, ponieważ generuje on jednorazowe polecenie instalacji już powiązane z ich kontem. Zarezerwuj około pięciu minut, a także czas na logowanie u dostawcy modelu, jeśli wymaga go Twój silnik kodujący. Aby zapoznać się z interfejsem Agent przed połączeniem komputera, otwórz PandaNpc Agent w przeglądarce.

Zanim zaczniesz

Potrzebujesz:

  • Konto PandaNpc otwarte w aplikacji webowej, aplikacji desktopowej lub aplikacji na iOS.
  • Połączony komputer z systemem Windows x64, macOS lub Linux x86_64.
  • Dostęp do internetu z hosta i uprawnienia do zainstalowania usługi działającej w tle na poziomie użytkownika.
  • Folder projektu, który możesz modyfikować.
  • Konto Claude, ChatGPT/Codex lub modelu niestandardowego, jeśli wybrany silnik nie jest jeszcze uwierzytelniony.

Jeśli chcesz tylko wyświetlić już połączony host, zainstaluj lub otwórz klienta na urządzeniu podglądu. PandaPaw należy zainstalować na komputerze uruchamiającym agenta. Zobacz Instalacja, aby poznać role klienta i hosta.

1. Wygeneruj polecenie instalacji hosta

Po zalogowaniu otwórz Połączone urządzenia i wybierz Dodaj urządzenie. PandaNpc tworzy jednorazowy klucz urządzenia i pokazuje dokładne polecenie dla Twojego systemu operacyjnego.

Skopiuj to polecenie na maszynę, na której ma działać agent kodujący. Traktuj je jak hasło, dopóki nie zostanie użyte: jednorazowy klucz paruje jedną maszynę i nie powinien być publikowany na czacie, zrzutach ekranu, w zgłoszeniach ani eksportach historii powłoki.

Jeśli wolisz autoryzację przez przeglądarkę zamiast przygotowanego klucza, użyj zwykłego instalatora w następnym kroku. Uruchamia on pandapaw login i otwiera dla Ciebie stronę autoryzacji.

2. Zainstaluj PandaPaw na hoście

macOS lub Linux

Uruchom przygotowane polecenie z Połączonych urządzeń albo użyj zwykłego instalatora:

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

Windows PowerShell

Uruchom przygotowane polecenie z Połączonych urządzeń albo użyj:

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

Instalator dodaje PandaPaw i jego usługi działające w tle, w miarę możliwości instaluje brakujące obsługiwane silniki kodujące oraz zapewnia prywatne środowisko uruchomieniowe Node.js, gdy host nie ma odpowiedniego. W przypadku przygotowanego klucza urządzenia parowanie konta następuje podczas instalacji. W przypadku zwykłego polecenia zatwierdź żądanie autoryzacji w przeglądarce, gdy pojawi się monit.

Instalator może zakończyć działanie, nawet jeśli autoryzacja konta została odroczona. Jeśli zgłasza, że instalacja się powiodła, ale połączenie z kontem jest niekompletne, uruchom:

bash
pandapaw login

3. Zweryfikuj usługi hosta

Na hoście uruchom:

bash
pandapaw status

Polecenie powinno rozpoznać zainstalowane usługi i pokazać maszynę połączoną z kontem. Jeśli powłoka nie może znaleźć pandapaw, najpierw otwórz nowy terminal, aby ponownie wczytała zaktualizowaną zmienną PATH użytkownika.

W przypadku projektu Git możesz też sprawdzić, czy Agent Center rozpoznaje katalog główny projektu:

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

Użyj rzeczywistej bezwzględnej ścieżki projektu. Powiązanie projektu w Agent Center działa najlepiej, gdy katalog ma stabilny Git remote.origin.url.

4. Rozpocznij pierwszą sesję zdalną

  1. Otwórz PandaNpc Agent na telefonie, w przeglądarce lub na innym komputerze.
  2. Znajdź nowo połączoną maszynę. Zielony wskaźnik stanu oznacza, że host jest obecnie osiągalny.
  3. Wybierz Claude Code, Codex lub PandaCode i wskaż katalog roboczy projektu.
  4. Rozpocznij sesję. Jeśli silnik poprosi o zalogowanie, dokończ autoryzację tego dostawcy na hoście lub przez wyświetlony proces logowania.
  5. Wyślij niedestrukcyjne polecenie testowe, na przykład: Show the current working directory and list the top-level files. Do not edit anything.

Połączenie jest w pełni gotowe, gdy odpowiedź poda oczekiwany katalog projektu, lista plików zgadza się z hostem, a każde pytanie o uprawnienia pojawia się w kliencie zdalnym, abyś mógł je zatwierdzić lub odrzucić.

5. Potwierdź działanie ponownego połączenia

Zamknij klienta podglądu, odczekaj kilka sekund i ponownie otwórz tę samą sesję. Istniejąca historia powinna wrócić, a host powinien pozostać online. To sprawdza rzeczywistą ścieżkę zdalną, zamiast jedynie potwierdzać, że instalator został pobrany pomyślnie.

Nie usypiaj hosta podczas tego testu. Uśpiony lub wyłączony host nie może uruchamiać agenta, nawet jeśli zapisane połączenie nadal pojawia się na Twoim koncie.

Rozwiązywanie problemów

Maszyna nie pojawia się w interfejsie Agent

Uruchom pandapaw status na hoście. Jeśli instalacja się powiodła, ale nie dołączono konta, uruchom pandapaw login. Jeśli użyto przygotowanego klucza i został już wykorzystany lub wygasł, wygeneruj nowy w Połączonych urządzeniach i ponownie uruchom wyświetlone polecenie.

`pandapaw` nie jest rozpoznawane

Otwórz nowy terminal. W systemie macOS/Linux potwierdź, że ~/.local/bin znajduje się w PATH. W systemie Windows instalator dodaje %LOCALAPPDATA%\Programs\pandapaw do zmiennej PATH użytkownika; terminal otwarty przed instalacją nie zobaczy nowej wartości.

Maszyna jest na liście, ale jest offline

Potwierdź, że host jest włączony, wybudzony i ma dostęp do internetu. Następnie sprawdź pandapaw status. Firmowe zapory muszą zezwalać na wychodzący ruch HTTPS/WebSocket; nie należy tworzyć przychodzącej reguły przekierowania portów.

Połączenie działa, ale silnik prosi o uwierzytelnienie

Parowanie PandaPaw i logowanie u dostawcy modelu to osobne sprawy. Parowanie potwierdza, że host należy do Twojego konta PandaNpc; Claude Code lub Codex może nadal wymagać własnego logowania do subskrypcji albo konfiguracji API. Dokończ zwykłe logowanie silnika, a następnie ponów sesję.

Agent otwiera się w niewłaściwym folderze

Zakończ tę sesję testową i utwórz nową z zamierzonym katalogiem roboczym. Przed zatwierdzeniem użycia narzędzi poproś agenta o wyświetlenie bieżącego katalogu. Połączenie zdalne samo w sobie nie dodaje piaskownicy systemu plików; uprawnienia narzędzi silnika i wybrany katalog roboczy nadal mają znaczenie.

Następne kroki