Démarrage rapide : Exécuter Claude Code ou Codex à distance

Mis à jour

Ce guide connecte une machine de développement à PandaNpc et vérifie que vous pouvez exécuter Claude Code, Codex ou PandaCode depuis un autre appareil. L'agent s'exécute toujours sur votre machine de développement ; PandaNpc vous offre une interface distante synchronisée pour les messages, les approbations, les questions et l'historique des sessions.

La plupart des utilisateurs devraient utiliser le flux Add a device car il génère une commande d'installation à usage unique déjà liée à leur compte. Prévoyez environ cinq minutes, plus la connexion au fournisseur de modèle requise par votre moteur de codage.

Avant de commencer

Vous avez besoin de :

  • Un compte PandaNpc ouvert dans l'application web, l'application de bureau ou l'application iOS.
  • Un hôte exécutant Windows x64, macOS ou Linux x86_64.
  • Un accès Internet depuis l'hôte et l'autorisation d'installer un service d'arrière-plan au niveau utilisateur.
  • Un dossier de projet que vous êtes autorisé à modifier.
  • Un compte Claude, ChatGPT/Codex ou un compte de modèle personnalisé si votre moteur choisi n'est pas déjà authentifié.

Si vous n'avez besoin que du chat intégré de PandaNpc et ne souhaitez pas contrôler un agent sur une autre machine, PandaPaw n'est pas requis. Voir Installation pour les options client uniquement.

1. Générer la commande d'installation de l'hôte

Une fois connecté, ouvrez Appareils connectés et choisissez Ajouter un appareil. PandaNpc crée une clé d'appareil à usage unique et affiche la commande exacte pour votre système d'exploitation.

Copiez cette commande sur la machine où l'agent de codage doit s'exécuter. Traitez-la comme un mot de passe jusqu'à son utilisation : une clé à usage unique associe une seule machine et ne doit pas être publiée dans des discussions, captures d'écran, issues ou exports d'historique shell.

Si vous préférez l'autorisation par navigateur plutôt qu'une clé préparée, utilisez l'installateur simple à l'étape suivante. Il exécute pandapaw login et ouvre la page d'autorisation pour vous.

2. Installer PandaPaw sur l'hôte

macOS ou Linux

Exécutez la commande préparée depuis Appareils connectés, ou utilisez l'installateur simple :

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

Windows PowerShell

Exécutez la commande préparée depuis Appareils connectés, ou utilisez :

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

L'installateur ajoute PandaPaw et ses services d'arrière-plan, installe les moteurs de codage pris en charge manquants lorsque c'est possible, et fournit un environnement d'exécution Node.js privé lorsque l'hôte n'en possède pas un adapté. Avec une clé d'appareil préparée, l'appairage du compte se produit pendant l'installation. Avec la commande simple, approuvez la demande d'autorisation du navigateur lorsque vous y êtes invité.

L'installateur peut se terminer même si l'autorisation du compte est reportée. S'il indique que l'installation a réussi mais que la connexion au compte est incomplète, exécutez :

bash
pandapaw login

3. Vérifier les services de l'hôte

Sur l'hôte, exécutez :

bash
pandapaw status

La commande devrait reconnaître les services installés et afficher la machine connectée au compte. Si le shell ne trouve pas pandapaw, ouvrez d'abord un nouveau terminal pour qu'il recharge le PATH utilisateur mis à jour.

Pour un projet Git, vous pouvez également vérifier si Agent Center reconnaît la racine du projet :

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

Utilisez un chemin de projet absolu réel. La liaison de projet Agent Center fonctionne mieux lorsque le répertoire possède un remote.origin.url Git stable.

4. Démarrer la première session à distance

  1. Ouvrez PandaNpc Agent sur votre téléphone, navigateur ou un autre ordinateur de bureau.
  2. Trouvez la machine nouvellement connectée. Un indicateur de statut vert signifie que l'hôte est actuellement joignable.
  3. Choisissez Claude Code, Codex ou PandaCode et sélectionnez le répertoire de travail du projet.
  4. Démarrez une session. Si le moteur vous demande de vous connecter, effectuez l'autorisation du fournisseur sur l'hôte ou via le flux de connexion affiché.
  5. Envoyez une invite de test non destructive comme : Affichez le répertoire de travail actuel et listez les fichiers de premier niveau. Ne modifiez rien.

Vous êtes entièrement connecté lorsque la réponse nomme le répertoire de projet attendu, la liste des fichiers correspond à celle de l'hôte, et toute question d'autorisation apparaît sur le client distant pour que vous l'approuviez ou la refusiez.

5. Confirmer le comportement de reconnexion

Fermez le client de visualisation, attendez quelques secondes, puis rouvrez la même session. L'historique existant devrait revenir et l'hôte devrait rester en ligne. Cela vérifie le chemin distant réel au lieu de seulement prouver que l'installateur a été téléchargé avec succès.

Ne mettez pas l'hôte en veille pendant ce test. Un hôte en veille ou éteint ne peut pas exécuter l'agent, même si la connexion enregistrée apparaît toujours dans votre compte.

Dépannage

La machine n'apparaît pas dans Agent

Exécutez pandapaw status sur l'hôte. Si l'installation a réussi mais qu'aucun compte n'est associé, exécutez pandapaw login. Si vous avez utilisé une clé préparée et qu'elle a déjà été utilisée ou a expiré, générez-en une nouvelle dans Appareils connectés et réexécutez la commande affichée.

`pandapaw` n'est pas reconnu

Ouvrez un nouveau terminal. Sur macOS/Linux, confirmez que ~/.local/bin est dans le PATH. Sur Windows, l'installateur ajoute %LOCALAPPDATA%\Programs\pandapaw au PATH utilisateur ; un terminal ouvert avant l'installation ne verra pas la nouvelle valeur.

La machine est listée mais hors ligne

Confirmez que l'hôte est allumé, éveillé et capable d'atteindre Internet. Ensuite, vérifiez pandapaw status. Les pare-feu d'entreprise doivent autoriser le trafic HTTPS/WebSocket sortant ; vous ne devez pas créer de règle de redirection de port entrante.

La connexion fonctionne mais le moteur demande une authentification

L'appairage PandaPaw et la connexion au fournisseur de modèle sont séparés. L'appairage prouve que l'hôte appartient à votre compte PandaNpc ; Claude Code ou Codex peut encore requérir sa propre connexion d'abonnement ou configuration API. Effectuez la connexion normale du moteur, puis réessayez la session.

L'agent s'ouvre dans le mauvais dossier

Terminez cette session de test et créez-en une avec le répertoire de travail souhaité. Avant d'approuver l'utilisation d'outils, demandez à l'agent d'afficher le répertoire actuel. Une connexion distante n'ajoute pas de bac à sable pour le système de fichiers en soi ; les autorisations d'outils du moteur et le répertoire de travail sélectionné restent importants.

Prochaines étapes

  • Lisez le guide complet de l'hôte PandaPaw pour les mises à jour, les vérifications de service et l'architecture de connexion.
  • Consultez Compte et facturation pour comprendre quel abonnement ou fournisseur paie pour chaque session.
  • Ajoutez des fournisseurs d'IA personnalisés lorsque vous souhaitez un point de terminaison compatible OpenAI, un modèle auto-hébergé ou une clé API distincte.