Szybki start: Uruchamianie Claude Code lub Codex zdalnie

Zaktualizowano

Ten przewodnik łączy jedną maszynę deweloperską z PandaNpc i weryfikuje, że możesz uruchomić Claude Code, Codex lub PandaCode z innego urządzenia. Agent nadal wykonuje się na Twojej maszynie deweloperskiej; PandaNpc zapewnia zsynchronizowany zdalny interfejs dla wiadomości, zatwierdzeń, pytań i historii sesji.

Większość osób powinna skorzystać z przepływu Dodaj urządzenie, ponieważ generuje on jednorazowe polecenie instalacji już powiązane z ich kontem. Zarezerwuj około pięć minut, plus ewentualne logowanie do dostawcy modelu wymagane przez Twój silnik kodowania.

Zanim zaczniesz

Będziesz potrzebować:

  • Konto PandaNpc otwarte w aplikacji webowej, aplikacji desktopowej lub aplikacji iOS.
  • Host z systemem Windows x64, macOS lub Linux x86_64.
  • Dostęp do internetu z hosta oraz uprawnienie 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 niestandardowego modelu, jeśli wybrany silnik nie jest jeszcze uwierzytelniony.

Jeśli potrzebujesz tylko wbudowanego czatu PandaNpc i nie chcesz kontrolować agenta na innej maszynie, PandaPaw nie jest wymagany. Zobacz Instalacja, aby poznać opcje tylko dla klienta.

1. Wygeneruj polecenie instalacji hosta

Będąc zalogowanym, 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 kodowania. Traktuj je jak hasło, dopóki nie zostanie użyte: jednorazowy klucz paruje jedną maszynę i nie powinien być umieszczany na czacie, zrzutach ekranu, w zgłoszeniach ani eksportach historii powłoki.

Jeśli wolisz autoryzację przeglądarkową zamiast przygotowanego klucza, użyj zwykłego instalatora w następnym kroku. Uruchomi on pandapaw login i otworzy stronę autoryzacji.

2. Zainstaluj PandaPaw na hoście

macOS lub Linux

Uruchom przygotowane polecenie z Połączonych urządzeń lub 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ń lub 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, instaluje brakujące obsługiwane silniki kodowania, jeśli to możliwe, i zapewnia prywatne środowisko uruchomieniowe Node.js, gdy host nie ma odpowiedniego. Z przygotowanym kluczem urządzenia parowanie konta następuje podczas instalacji. W przypadku zwykłego polecenia zatwierdź żądanie autoryzacji przeglądarki, gdy zostanie wyświetlone.

Instalator może zakończyć działanie nawet wtedy, gdy autoryzacja konta zostanie odroczona. Jeśli komunikat mówi, że instalacja się powiodła, ale połączenie konta 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 przeładował zaktualizowany PATH użytkownika.

W przypadku projektu Git możesz również sprawdzić, czy Centrum agentów 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 Centrum agentów działa najlepiej, gdy katalog ma stabilny remote.origin.url Git.

4. Rozpocznij pierwszą sesję zdalną

  1. Otwórz PandaNpc Agent na telefonie, przeglądarce lub innym komputerze.
  2. Znajdź nowo połączoną maszynę. Zielony wskaźnik statusu 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 Cię o zalogowanie, ukończ autoryzację dostawcy na hoście lub przez wyświetlony proces logowania.
  5. Wyślij niedestrukcyjny testowy prompt, na przykład: Show the current working directory and list the top-level files. Do not edit anything.

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

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

Zamknij klienta podglądu, odczekaj kilka sekund i otwórz ponownie tę samą sesję. Istniejąca historia powinna wrócić, a host powinien pozostać online. To sprawdza rzeczywistą ścieżkę zdalną, a nie tylko dowodzi, że instalator pobrał się poprawnie.

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

Rozwiązywanie problemów

Maszyna nie pojawia się w Agencie

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

`pandapaw` nie jest rozpoznawany

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

Maszyna jest na liście, ale offline

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

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

Parowanie PandaPaw i logowanie do 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 lub konfiguracji API. Ukończ normalne logowanie silnika, a następnie ponów próbę sesji.

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 wypisanie bieżącego katalogu. Zdalne połączenie samo w sobie nie dodaje piaskownicy systemu plików; uprawnienia narzędzi silnika i wybrany katalog roboczy pozostają ważne.

Następne kroki