PandaNpc Work - Démarrage rapide : connecter votre premier agent

Commencez à utiliser PandaNpc Work, l’espace de travail IA multi-moteur. Connectez un ordinateur avec PandaPaw, choisissez un moteur d’agent et vérifiez une session distante.

Mis à jour

Ce guide connecte un ordinateur à PandaNpc Work et vérifie que vous pouvez exécuter Claude Code, Codex ou PandaCode depuis un autre appareil. PandaNpc Work est l’espace de travail IA multi-moteurs où vous déléguez le travail et le suivez sur plusieurs appareils. L’agent s’exécute toujours sur l’ordinateur connecté ; PandaPaw fournit le pont et le runtime local, tandis que PandaNpc Work vous offre une interface synchronisée pour les messages, les approbations, les questions et l’historique des sessions.

Ce parcours est idéal pour les personnes déjà à l’aise avec Claude Code, Codex ou un agent de codage similaire. La plupart des personnes devraient utiliser le flux Ajouter un appareil, car il génère une commande d’installation à usage unique déjà liée à leur compte. Prévoyez environ cinq minutes, plus toute connexion au fournisseur de modèle requise par votre moteur de codage. Pour explorer l’interface Agent avant de connecter un ordinateur, ouvrez PandaNpc Agent dans un navigateur.

Avant de commencer

Vous avez besoin de :

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

Si vous souhaitez uniquement consulter un hôte déjà connecté, installez ou ouvrez un client sur votre appareil de consultation. PandaPaw doit être installé sur l’ordinateur qui exécute l’agent. Consultez Installation pour les rôles de client et d’hôte.

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 un chat, des captures d’écran, des tickets ou des exports d’historique de shell.

Si vous préférez l’autorisation via navigateur à 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 en arrière-plan, installe les moteurs de codage pris en charge manquants lorsque c’est possible, et fournit un runtime Node.js privé lorsque l’hôte n’en possède pas d’adapté. Avec une clé d’appareil préparée, l’association du compte se fait pendant l’installation. Avec la commande simple, approuvez la demande d’autorisation dans le navigateur lorsqu’elle vous est proposée.

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 doit 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 aussi vérifier si Agent Center reconnaît la racine du projet :

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

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

4. Démarrer la première session distante

  1. Ouvrez PandaNpc Agent sur votre téléphone, votre navigateur ou un autre ordinateur de bureau.
  2. Recherchez la machine nouvellement connectée. Un indicateur d’état vert signifie que l’hôte est actuellement joignable.
  3. Choisissez Claude Code, Codex ou PandaCode, puis sélectionnez le répertoire de travail du projet.
  4. Démarrez une session. Si le moteur vous demande de vous connecter, terminez l’autorisation de ce fournisseur sur l’hôte ou via le flux de connexion affiché.
  5. Envoyez une invite de test non destructive, par exemple : Show the current working directory and list the top-level files. Do not edit anything.

Vous êtes pleinement connecté lorsque la réponse nomme le répertoire de projet attendu, que la liste des fichiers correspond à celle de l’hôte et qu’une éventuelle question d’autorisation apparaît sur le client distant pour que vous puissiez l’approuver ou la refuser.

5. Confirmer le comportement de reconnexion

Fermez le client de consultation, attendez quelques secondes, puis rouvrez la même session. L’historique existant doit réapparaître et l’hôte doit rester en ligne. Cela vérifie le véritable chemin distant au lieu de simplement prouver que l’installateur a bien été téléchargé.

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, vérifiez que ~/.local/bin figure dans 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

Vérifiez que l’hôte est allumé, éveillé et capable d’accéder à 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’association PandaPaw et la connexion au fournisseur de modèle sont distinctes. L’association prouve que l’hôte appartient à votre compte PandaNpc ; Claude Code ou Codex peut toujours nécessiter sa propre connexion à un abonnement ou sa propre configuration d’API. Terminez la connexion normale du moteur, puis réessayez la session.

L’agent s’ouvre dans le mauvais dossier

Mettez fin à cette session de test et créez-en une avec le répertoire de travail souhaité. Avant d’approuver l’utilisation d’un outil, demandez à l’agent d’afficher le répertoire courant. Une connexion distante n’ajoute pas de bac à sable de système de fichiers à elle seule ; les autorisations d’outils du moteur et le répertoire de travail sélectionné restent importants.

Étapes suivantes