Installer PandaNpc et PandaPaw

Une configuration d'agent de codage à distance comporte deux parties indépendantes :

• Client PandaNpc — l'interface que vous utilisez pour lire les sessions, envoyer des invites et approuver les outils. Elle fonctionne sur le web, iOS, Windows, macOS et Linux.
• Hôte PandaPaw — le service en arrière-plan sur l'ordinateur où Claude Code, Codex, ou PandaCode s'exécute réellement.

Installez uniquement le client pour les discussions PandaNpc et l'utilisation locale sur ordinateur de bureau. Installez les deux parties lorsque vous souhaitez atteindre un agent de codage exécuté sur une autre machine.

Voir PandaNpc Bureau pour ce que l'application Windows/macOS/Linux ajoute au-delà des étapes d'installation ci-dessous, y compris son historique de versions.

Choisir quoi installer

Pour le chemin de bout en bout le plus court, utilisez le Guide de démarrage rapide.

Installer un client PandaNpc

Utilisez la page de téléchargement PandaNpc comme source de vérité pour les installateurs actuels. Évitez les sites de téléchargement tiers car ils peuvent servir des paquets anciens ou modifiés.

Web

Ouvrez pandanpc.com/agent dans un navigateur récent. Rien n'est installé. Le stockage du navigateur conserve l'état de connexion locale, donc les fenêtres privées/incognito peuvent nécessiter une nouvelle connexion.

iOS

Suivez le lien de l'App Store sur la page de téléchargement et installez PandaNpc. iOS est utile pour vérifier l'avancement, répondre aux questions et approuver les outils lorsque vous êtes loin de l'hôte. Le processus de codage s'exécute toujours sur la machine hôte connectée. Voir PandaNpc pour iOS pour ce que l'application couvre, y compris son historique de versions.

Windows

1. Téléchargez l'installateur Windows actuel.
2. Exécutez-le et suivez les invites de l'installateur.
3. Lancez PandaNpc depuis le menu Démarrer.
4. Si Windows affiche un avertissement d'éditeur ou de réputation, vérifiez que le fichier provient de pandanpc.com avant de continuer.

macOS

1. Téléchargez le .dmg macOS.
2. Glissez PandaNpc dans Applications.
3. Lancez-le depuis Applications et terminez toute invite de sécurité macOS.

La version macOS est universelle, donc le même paquet prend en charge les Mac Apple Silicon et Intel.

Linux

Téléchargez l'AppImage x86_64, rendez-la exécutable et lancez-la :

chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImage

Si l'AppImage ne démarre pas, exécutez-la une fois depuis un terminal et conservez la sortie d'erreur exacte. Les distributions plus anciennes peuvent manquer d'une bibliothèque d'exécution requise par le shell de bureau.

Installer PandaPaw sur l'hôte de l'agent

PandaPaw fournit actuellement des installateurs hôtes pour Windows x64, macOS universel et Linux x86_64. Exécutez la commande sur l'ordinateur qui possède les fichiers du projet et qui doit exécuter les outils de l'agent.

Le chemin recommandé est Appareils connectés : choisissez Ajouter un appareil, puis copiez la commande à usage unique générée. Elle associe l'hôte à votre compte pendant l'installation.

macOS ou Linux

Installateur simple avec autorisation du navigateur :

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

Formulaire de clé à usage unique préparé :

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxx

Windows PowerShell

Installateur simple :

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

Formulaire de clé à usage unique préparé :

$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

Le pipeline iwr | iex de PowerShell ne peut pas passer les arguments de script normaux, donc l'installateur Windows lit la clé à usage unique depuis PANDANET_KEY.

Ce que l'installateur hôte modifie

L'installateur :

1. Ajoute PandaPaw au répertoire application/bin de l'utilisateur actuel et met à jour le PATH de l'utilisateur si nécessaire.
2. Enregistre les services d'arrière-plan appropriés pour qu'ils démarrent automatiquement.
3. Installe les moteurs de codage pris en charge qui manquent lorsque la plateforme le permet.
4. Fournit un runtime Node.js privé lorsque le système ne dispose pas d'une version appropriée.
5. Démarre l'autorisation du compte ou échange la clé d'appareil préparée.
6. Enregistre les fichiers qu'il a créés afin que la désinstallation puisse préserver les outils compatibles déjà présents.

Installer un moteur n'achète ni n'authentifie automatiquement un abonnement de modèle. Claude Code et Codex peuvent toujours demander leur propre connexion au fournisseur la première fois qu'ils sont lancés.

Vérifier l'installation

Ouvrez un nouveau terminal après l'installation et exécutez :

pandapaw status

Ensuite, ouvrez PandaNpc Agent. L'hôte devrait apparaître en ligne. Démarrez une session dans un projet de test et demandez-lui de rapporter le répertoire de travail actuel sans modifier les fichiers. Cela vérifie le binaire, le service d'arrière-plan, l'association de compte, la connexion relais, le moteur et le répertoire sélectionné—pas seulement l'étape de téléchargement.

Mise à jour

Les clients de bureau vous notifient lorsqu'une mise à jour est disponible. iOS se met à jour via l'App Store.

Mettez à jour PandaPaw et redémarrez ses services gérés avec :

pandapaw update --restart

Le programme de mise à jour vérifie le binaire téléchargé par rapport à la somme de contrôle SHA-256 publiée avant de remplacer la copie installée. Votre association de compte et votre identité de connexion existante sont préservées. Relancer la commande d'installation est également pris en charge lorsque le programme de mise à jour lui-même est indisponible.

Désinstallation

• Client Windows : Paramètres → Applications → Applications installées → PandaNpc → Désinstaller.
• Client macOS : quittez PandaNpc, puis déplacez-le de Applications vers la Corbeille.
• Client Linux : supprimez l'AppImage et tout lanceur que vous avez créé pour elle.
• Hôte PandaPaw : exécutez pandapaw uninstall sur l'hôte.

Le manifeste de désinstallation de PandaPaw distingue les outils créés par l'installateur des outils compatibles qui existaient déjà. Il est intentionnellement prudent plutôt que de supprimer une installation préexistante de Claude Code, Codex, PandaCode ou Node.

Problèmes d'installation

La commande s'est terminée mais l'hôte n'est pas connecté

Exécutez pandapaw login. L'installation de l'hôte et l'autorisation du compte sont des étapes distinctes, et l'installateur peut se terminer même si l'autorisation du navigateur a été différée ou interrompue.

Le shell ne peut pas trouver `pandapaw`

Ouvrez un nouveau terminal. Sous macOS/Linux, vérifiez ~/.local/bin ; sous Windows, vérifiez %LOCALAPPDATA%\Programs\pandapaw. Ne réinstallez pas à plusieurs reprises avant d'avoir confirmé si l'exécutable existe et que seul PATH est obsolète.

Un moteur de codage n'a pas pu être installé

L'installateur hôte traite les téléchargements facultatifs de moteur comme un effort maximal afin qu'une panne de fournisseur ne supprime pas une installation PandaPaw fonctionnelle. Installez ou réparez ce moteur à l'aide de son installateur officiel, authentifiez-le normalement, puis exécutez à nouveau pandapaw status.

L'AppImage ou l'application de bureau ne s'ouvre pas

Confirmez que vous avez téléchargé le paquet pour la bonne architecture, puis lancez-le depuis un terminal pour capturer la première erreur. Incluez cette erreur et votre version d'OS lors de la prise de contact avec le support ; les captures d'écran d'une fenêtre fermée ne suffisent généralement pas à diagnostiquer une bibliothèque d'exécution manquante.

Pour les vérifications de connexion spécifiques à l'hôte, continuez avec le guide PandaPaw ou la FAQ.