PandaPaw : Hôte distant pour Claude Code, Codex et PandaCode

PandaPaw transforme une machine Windows, macOS ou Linux que vous contrôlez en hôte d'agent PandaNpc. Le moteur de codage, les fichiers du projet, le shell et les outils restent sur cet hôte ; les clients PandaNpc vous offrent une interface synchronisée depuis un téléphone, un navigateur ou un autre bureau.

Utilisez PandaPaw lorsque la machine qui exécute le travail est différente de l'appareil que vous tenez, lorsque vous souhaitez qu'un hôte survive aux déconnexions du client, ou lorsque plusieurs moteurs de codage doivent partager la même configuration basée sur le compte et la même configuration du Centre d'agents.

Ce que PandaPaw gère

• Connexions d'agents distantes pour Claude Code, OpenAI Codex et PandaCode.
• Services en arrière-plan et démarrage automatique pour que l'hôte puisse revenir après un redémarrage normal.
• Autorisation de machine basée sur le compte sans copier manuellement un identifiant de pont, un jeton ou une clé de signature à longue durée de vie.
• Assistance à l'installation du moteur lorsqu'un moteur de codage pris en charge est manquant.
• Projections du Centre d'agents qui rendent les conseils, compétences, mémoire et définitions d'agent de chaque moteur dans sa disposition native.
• Réseau privé d'appareils pour les machines jointes via le flux Appareils connectés.
• Gestion des mises à jour et des désinstallations afin que les outils qui existaient avant PandaPaw soient préservés.

PandaPaw ne fournit pas lui-même d'abonnement au modèle. Claude Code, Codex et PandaCode utilisent toujours les informations d'identification et les limites du fournisseur configurées pour leur moteur.

Comment fonctionne l'exécution à distance

Les deux côtés initient des connexions sortantes, donc une configuration domestique ou de bureau normale ne nécessite pas de règle de pare-feu entrante, d'adresse IP publique, de redirection de port du routeur ni de serveur SSH exposé publiquement. Le relais transporte les messages, l'état et les approbations ; l'exécution des outils se produit sur l'hôte.

Si l'hôte se met en veille, s'éteint ou perd son chemin réseau sortant, la connexion enregistrée reste dans votre compte mais ne peut pas exécuter de travail tant que l'hôte n'est pas revenu.

Plateformes hôtes prises en charge

Le client de visualisation PandaNpc a une matrice de plateformes plus large. Voir Installer PandaNpc et PandaPaw lors du choix des paquets client et hôte.

Installation recommandée

1. Connectez-vous à PandaNpc.
2. Ouvrez Appareils connectés.
3. Choisissez Ajouter un appareil. Une clé à usage unique est émise et la boîte de dialogue affiche une commande pour le système d'exploitation détecté.
4. Copiez cette commande sur l'hôte et exécutez-la là-bas.
5. Laissez la boîte de dialogue ouverte si vous souhaitez qu'elle détecte automatiquement la nouvelle machine.

La clé préparée est à usage unique. Copiez toute la commande, gardez-la privée, et générez-en une nouvelle si elle expire ou si elle a déjà été utilisée.

Installateur macOS/Linux simple

Utilisez ce formulaire lorsque vous souhaitez une autorisation par navigateur au lieu d'une clé préparée :

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

Installateur Windows PowerShell simple

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

L'installateur simple exécute pandapaw login. Approuvez la machine dans la page navigateur qui s'ouvre. Si l'autorisation est interrompue, le binaire et les services peuvent toujours être installés ; exécutez pandapaw login plus tard pour terminer la connexion du compte.

Vérifier l'hôte

Vérifiez d'abord l'hôte lui-même :

pandapaw status

Ensuite, ouvrez Agent PandaNpc et confirmez que la machine a un indicateur en ligne vert. Démarrez une session dans un répertoire de test jetable ou en lecture seule et demandez :

Invite de test : Affichez le répertoire de travail actuel et listez les fichiers de niveau supérieur. Ne modifiez rien.

Une réponse réussie prouve plus qu'un voyant de statut vert : elle vérifie l'appairage du compte, la connectivité du relais, le moteur sélectionné, l'authentification du fournisseur et le mappage du répertoire de travail.

Pour un projet Centre d'agents, exécutez :

pandapaw agent status --root /absolute/path/to/project

Cela montre si le projet est lié et si la configuration gérée est disponible localement. Un dépôt distant Git stable aide PandaPaw à identifier le même projet sur plusieurs machines.

Autorisation du compte et identité de connexion

pandapaw login utilise une session d'autorisation d'appareil par navigateur. Après votre approbation, l'hôte reçoit des identifiants limités à l'appareil et une clé de vérification du Centre d'agents via TLS, écrit sa configuration machine sous ~/.pandapaw/, enregistre les connexions de moteur prises en charge et lie les projets Git reconnaissables.

Exécutez pandapaw login --force uniquement lorsque vous changez intentionnellement de compte ou remplacez un identifiant hôte expiré. Réautoriser une machine saine sans raison peut créer des identités dupliquées ou remplacées déroutantes.

pandapaw qr crée toujours un lien de connexion manuel à courte durée de vie pour la compatibilité et les cas particuliers. Ce n'est pas le flux principal pour un nouvel hôte ; Appareils connectés est plus facile à auditer et ne nécessite pas que les utilisateurs comprennent les identifiants de pont.

Synchronisation du Centre d'agents

Le Centre d'agents est piloté par événements en régime permanent :

1. Les modifications locales des fichiers gérés sont détectées et publiées sur le projet lié.
2. Les versions signées arrivent via un flux d'événements.
3. Les manifestes et blobs de contenu inchangés sont réutilisés plutôt que téléchargés à nouveau.
4. Une vérification de récupération périodique détecte les événements manqués lors d'une déconnexion temporaire.

Claude Code, Codex et PandaCode reçoivent des projections séparées car ils s'attendent à des répertoires et des formats d'instructions différents. PandaCode prépare la dernière version vérifiée avant d'assembler une nouvelle invite de session, afin que la configuration récupérée au démarrage puisse affecter cette même session.

Si le Centre d'agents est temporairement indisponible, le moteur continue avec la dernière version locale vérifiée. Une panne réseau ne doit pas silencieusement remplacer la configuration signée par du contenu non vérifié.

Commandes utiles

pandapaw login
pandapaw status
pandapaw agent status --root /absolute/path/to/project
pandapaw update --restart
pandapaw uninstall

Consultez l'historique des versions de PandaPaw lorsqu'une commande ou une interface diffère d'une ancienne capture d'écran ou d'un tutoriel.

Limites de sécurité

• Un opérateur distant peut utiliser les outils et le répertoire de travail que la session d'agent sélectionnée autorise. L'accès distant n'est pas automatiquement en lecture seule.
• Gardez les commandes d'appareil à usage unique, les liens de connexion manuels, les clés de fournisseur et les jetons de compte hors des journaux et des captures d'écran.
• N'ouvrez pas de ports de routeur entrants uniquement pour rendre PandaPaw accessible.
• Supprimez des Appareils connectés les hôtes que vous ne possédez plus.
• Examinez les approbations d'outils et vérifiez le répertoire de travail avant d'autoriser des modifications ou des commandes shell.
• Lors du partage d'une connexion en direct, le destinataire consomme le quota de moteur du propriétaire de l'hôte et peut agir sur l'hôte. Lisez d'abord Partage de connexion.

Dépannage

`pandapaw` introuvable après l'installation

Ouvrez un nouveau terminal pour qu'il recharge le PATH utilisateur. Les emplacements normaux sont ~/.local/bin sur macOS/Linux et %LOCALAPPDATA%\Programs\pandapaw sur Windows. Confirmez que le fichier existe avant de réexécuter l'installateur.

L'installation a réussi, mais aucune machine n'apparaît

Exécutez pandapaw status. Si la machine n'a pas d'autorisation de compte, exécutez pandapaw login. Si une clé à usage unique préparée a été utilisée, créez une nouvelle clé plutôt que de réessayer une commande consommée.

La machine apparaît mais reste hors ligne

Confirmez que l'hôte est allumé et a accès à Internet. Vérifiez l'état de PandaPaw localement. Un proxy ou pare-feu d'entreprise doit autoriser le chemin HTTPS/WebSocket sortant ; un port entrant ne résout pas une connexion sortante bloquée.

L'hôte est en ligne, mais Claude Code ou Codex ne répond pas

L'appairage de l'hôte n'authentifie pas tous les fournisseurs de modèles. Ouvrez le moteur localement ou suivez l'invite de connexion affichée dans la session à distance. Confirmez également que le modèle sélectionné existe pour ce compte et que sa limite d'utilisation n'est pas épuisée.

La session s'ouvre dans le mauvais projet

Terminez le test, sélectionnez le répertoire de travail absolu souhaité, et demandez à l'agent de l'afficher avant d'approuver les outils. PandaPaw ne devine pas quel dépôt vous vouliez et n'ajoute pas de bac à sable système de fichiers au-delà du modèle d'autorisations du moteur.

Les modifications du Centre d'agents n'apparaissent pas

Exécutez pandapaw agent status --root /path/to/project depuis la racine Git correcte. Confirmez que le projet est lié, que l'hôte est connecté et que le fichier local fait partie d'une projection gérée. Conservez la dernière version vérifiée en place pendant l'enquête au lieu de supprimer les répertoires gérés.

Mise à jour et désinstallation

pandapaw update --restart télécharge le binaire actuel, vérifie sa somme de contrôle SHA-256, remplace la copie installée et redémarre les services gérés pour que la version devienne active. L'appairage de compte existant est préservé.

pandapaw uninstall utilise le manifeste d'installation pour supprimer les éléments créés par PandaPaw. Les installations compatibles Claude Code, Codex, PandaCode ou Node qui étaient déjà présentes sont intentionnellement préservées. Après la désinstallation, supprimez l'hôte des Appareils connectés s'il ne doit plus être approuvé.