Γρήγορη εκκίνηση: Εκτελέστε το Claude Code ή το Codex απομακρυσμένα

Ενημερώθηκε

Αυτός ο οδηγός συνδέει έναν υπολογιστή ανάπτυξης με το PandaNpc και επαληθεύει ότι μπορείτε να εκτελέσετε το Claude Code, το Codex ή το PandaCode από μια άλλη συσκευή. Ο πράκτορας εξακολουθεί να εκτελείται στον υπολογιστή ανάπτυξής σας· το PandaNpc σας παρέχει μια συγχρονισμένη απομακρυσμένη διεπαφή για μηνύματα, εγκρίσεις, ερωτήσεις και ιστορικό συνεδριών.

Οι περισσότεροι χρήστες θα πρέπει να χρησιμοποιήσουν τη ροή Προσθήκη συσκευής, επειδή δημιουργεί μια εντολή εγκατάστασης μίας χρήσης ήδη συνδεδεμένη με τον λογαριασμό τους. Δώστε περίπου πέντε λεπτά, συν τυχόν σύνδεση με τον πάροχο μοντέλου που απαιτεί η μηχανή κωδικοποίησής σας.

Πριν ξεκινήσετε

Χρειάζεστε:

  • Ένας λογαριασμός PandaNpc ανοιγμένος στην εφαρμογή ιστού, στην εφαρμογή επιτραπέζιου υπολογιστή ή στην εφαρμογή iOS.
  • Ένας υπολογιστής-οικοδεσπότης που εκτελεί Windows x64, macOS ή Linux x86_64.
  • Πρόσβαση στο διαδίκτυο από τον υπολογιστή-οικοδεσπότη και άδεια εγκατάστασης μιας υπηρεσίας παρασκηνίου σε επίπεδο χρήστη.
  • Ένας φάκελος έργου που επιτρέπεται να τροποποιήσετε.
  • Ένας λογαριασμός Claude, ChatGPT/Codex ή προσαρμοσμένου μοντέλου, εάν η επιλεγμένη μηχανή δεν είναι ήδη πιστοποιημένη.

Εάν χρειάζεστε μόνο την ενσωματωμένη συνομιλία του PandaNpc και δεν θέλετε να ελέγχετε έναν πράκτορα σε άλλη μηχανή, το PandaPaw δεν είναι απαραίτητο. Δείτε Εγκατάσταση για τις επιλογές μόνο για τον πελάτη.

1. Δημιουργία της εντολής εγκατάστασης για τον υπολογιστή-οικοδεσπότη

Ενώ είστε συνδεδεμένοι, ανοίξτε τις Συνδεδεμένες συσκευές και επιλέξτε Προσθήκη συσκευής. Το PandaNpc δημιουργεί ένα κλειδί συσκευής μίας χρήσης και εμφανίζει την ακριβή εντολή για το λειτουργικό σας σύστημα.

Αντιγράψτε αυτήν την εντολή στη μηχανή όπου θα εκτελείται ο πράκτορας κωδικοποίησης. Μεταχειριστείτε την ως κωδικό πρόσβασης έως ότου χρησιμοποιηθεί: ένα κλειδί μίας χρήσης αντιστοιχίζεται σε μία μηχανή και δεν πρέπει να δημοσιεύεται σε συνομιλίες, στιγμιότυπα οθόνης, ζητήματα (issues) ή εξαγωγές ιστορικού κελύφους.

Εάν προτιμάτε εξουσιοδότηση μέσω προγράμματος περιήγησης αντί για προετοιμασμένο κλειδί, χρησιμοποιήστε τον απλό εγκαταστάτη στο επόμενο βήμα. Αυτός εκτελεί pandapaw login και ανοίγει τη σελίδα εξουσιοδότησης για εσάς.

2. Εγκατάσταση του PandaPaw στον υπολογιστή-οικοδεσπότη

macOS ή Linux

Εκτελέστε την προετοιμασμένη εντολή από τις Συνδεδεμένες συσκευές ή χρησιμοποιήστε τον απλό εγκαταστάτη:

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

Windows PowerShell

Εκτελέστε την προετοιμασμένη εντολή από τις Συνδεδεμένες συσκευές ή χρησιμοποιήστε:

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

Ο εγκαταστάτης προσθέτει το PandaPaw και τις υπηρεσίες παρασκηνίου του, εγκαθιστά τυχόν υποστηριζόμενες μηχανές κωδικοποίησης που λείπουν, όταν είναι δυνατόν, και παρέχει ένα ιδιωτικό περιβάλλον εκτέλεσης Node.js όταν ο υπολογιστής-οικοδεσπότης δεν διαθέτει κατάλληλο. Με ένα προετοιμασμένο κλειδί συσκευής, η αντιστοίχιση λογαριασμού πραγματοποιείται κατά την εγκατάσταση. Με την απλή εντολή, εγκρίνετε το αίτημα εξουσιοδότησης του προγράμματος περιήγησης όταν σας ζητηθεί.

Ο εγκαταστάτης μπορεί να ολοκληρωθεί ακόμη και αν η εξουσιοδότηση λογαριασμού αναβληθεί. Εάν αναφέρει ότι η εγκατάσταση ήταν επιτυχής αλλά η σύνδεση λογαριασμού είναι ελλιπής, εκτελέστε:

bash
pandapaw login

3. Επαλήθευση των υπηρεσιών του υπολογιστή-οικοδεσπότη

Στον υπολογιστή-οικοδεσπότη, εκτελέστε:

bash
pandapaw status

Η εντολή θα πρέπει να αναγνωρίζει τις εγκατεστημένες υπηρεσίες και να εμφανίζει τη μηχανή που είναι συνδεδεμένη με τον λογαριασμό. Εάν το κέλυφος (shell) δεν μπορεί να βρει το pandapaw, ανοίξτε πρώτα ένα νέο τερματικό ώστε να επαναφορτωθεί η ενημερωμένη PATH του χρήστη.

Για ένα έργο Git, μπορείτε επίσης να ελέγξετε αν το Κέντρο Πρακτόρων (Agent Center) αναγνωρίζει τη ρίζα του έργου:

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

Χρησιμοποιήστε μια πραγματική απόλυτη διαδρομή έργου. Η σύνδεση έργου του Κέντρου Πρακτόρων λειτουργεί καλύτερα όταν ο κατάλογος διαθέτει σταθερό remote.origin.url Git.

4. Έναρξη της πρώτης απομακρυσμένης συνεδρίας

  1. Ανοίξτε το PandaNpc Agent στο τηλέφωνο, το πρόγραμμα περιήγησης ή σε έναν άλλο επιτραπέζιο υπολογιστή.
  2. Βρείτε τη νεοσυνδεδεμένη μηχανή. Μια πράσινη ένδειξη κατάστασης σημαίνει ότι ο υπολογιστής-οικοδεσπότης είναι προσβάσιμος αυτή τη στιγμή.
  3. Επιλέξτε Claude Code, Codex ή PandaCode και επιλέξτε τον κατάλογο εργασίας του έργου.
  4. Ξεκινήστε μια συνεδρία. Εάν η μηχανή σας ζητήσει να συνδεθείτε, ολοκληρώστε την εξουσιοδότηση του παρόχου στον υπολογιστή-οικοδεσπότη ή μέσω της εμφανιζόμενης ροής σύνδεσης.
  5. Στείλτε ένα μη καταστροφικό δοκιμαστικό μήνυμα, όπως: Εμφάνισε τον τρέχοντα κατάλογο εργασίας και λίστα τα αρχεία ανώτατου επιπέδου. Μην επεξεργαστείς τίποτα.

Είστε πλήρως συνδεδεμένοι όταν η απάντηση αναφέρει τον αναμενόμενο κατάλογο έργου, η λίστα αρχείων ταιριάζει με τον υπολογιστή-οικοδεσπότη και τυχόν ερώτηση άδειας εμφανίζεται στον απομακρυσμένο πελάτη για έγκριση ή απόρριψη.

5. Επιβεβαίωση συμπεριφοράς επανασύνδεσης

Κλείστε τον πελάτη προβολής, περιμένετε μερικά δευτερόλεπτα και ανοίξτε ξανά την ίδια συνεδρία. Το υπάρχον ιστορικό θα πρέπει να επανέλθει και ο υπολογιστής-οικοδεσπότης θα πρέπει να παραμείνει συνδεδεμένος. Αυτό ελέγχει την πραγματική απομακρυσμένη διαδρομή αντί να αποδεικνύει απλώς ότι ο εγκαταστάτης έγινε λήψη με επιτυχία.

Μην θέσετε τον υπολογιστή-οικοδεσπότη σε κατάσταση αναστολής κατά τη διάρκεια αυτής της δοκιμής. Ένας υπολογιστής σε αναστολή ή απενεργοποιημένος δεν μπορεί να εκτελέσει τον πράκτορα, ακόμη και αν η αποθηκευμένη σύνδεση εξακολουθεί να εμφανίζεται στον λογαριασμό σας.

Αντιμετώπιση προβλημάτων

Η μηχανή δεν εμφανίζεται στον Πράκτορα

Εκτελέστε pandapaw status στον υπολογιστή-οικοδεσπότη. Εάν η εγκατάσταση ήταν επιτυχής αλλά δεν έχει επισυναφθεί λογαριασμός, εκτελέστε pandapaw login. Εάν χρησιμοποιήσατε ένα προετοιμασμένο κλειδί και αυτό έχει ήδη εξαργυρωθεί ή έχει λήξει, δημιουργήστε ένα νέο στις Συνδεδεμένες συσκευές και εκτελέστε ξανά την εμφανιζόμενη εντολή.

Το `pandapaw` δεν αναγνωρίζεται

Ανοίξτε ένα νέο τερματικό. Σε macOS/Linux, επιβεβαιώστε ότι το ~/.local/bin βρίσκεται στο PATH. Σε Windows, ο εγκαταστάτης προσθέτει το %LOCALAPPDATA%\Programs\pandapaw στο PATH του χρήστη· ένα τερματικό που άνοιξε πριν την εγκατάσταση δεν θα δει τη νέα τιμή.

Η μηχανή εμφανίζεται αλλά είναι εκτός σύνδεσης

Επιβεβαιώστε ότι ο υπολογιστής-οικοδεσπότης είναι ενεργοποιημένος, ξύπνιος και μπορεί να έχει πρόσβαση στο διαδίκτυο. Στη συνέχεια, ελέγξτε με pandapaw status. Τα εταιρικά τείχη προστασίας πρέπει να επιτρέπουν την εξερχόμενη κίνηση HTTPS/WebSocket· δεν θα πρέπει να δημιουργήσετε κανόνα εισερχόμενης προώθησης θυρών.

Η σύνδεση λειτουργεί αλλά η μηχανή ζητά πιστοποίηση

Η σύζευξη PandaPaw και η σύνδεση παρόχου μοντέλου είναι ξεχωριστές. Η σύζευξη αποδεικνύει ότι ο υπολογιστής-οικοδεσπότης ανήκει στον λογαριασμό σας στο PandaNpc· το Claude Code ή το Codex μπορεί να απαιτεί τη δική του σύνδεση συνδρομής ή διαμόρφωση API. Ολοκληρώστε την κανονική σύνδεση της μηχανής και, στη συνέχεια, δοκιμάστε ξανά τη συνεδρία.

Ο πράκτορας ανοίγει σε λάθος φάκελο

Τερματίστε αυτήν τη δοκιμαστική συνεδρία και δημιουργήστε μία με τον επιθυμητό κατάλογο εργασίας. Πριν εγκρίνετε τη χρήση εργαλείων, ζητήστε από τον πράκτορα να εκτυπώσει τον τρέχοντα κατάλογο. Μια απομακρυσμένη σύνδεση δεν προσθέτει από μόνη της περιβάλλον απομόνωσης (sandbox) του συστήματος αρχείων· οι άδειες εργαλείων της μηχανής και ο επιλεγμένος κατάλογος εργασίας παραμένουν σημαντικά.

Επόμενα βήματα