Instalar PandaNpc y PandaPaw

Actualizado

Un entorno de agente de codificación remoto tiene dos partes independientes:

  • Cliente de PandaNpc — la interfaz que usas para leer sesiones, enviar mensajes y aprobar herramientas. Se ejecuta en la web, iOS, Windows, macOS y Linux.
  • Host de PandaPaw — el servicio en segundo plano en el ordenador donde Claude Code, Codex o PandaCode se ejecutan realmente.

Instala solo el cliente para el chat de PandaNpc y el uso local en el escritorio. Instala ambas partes cuando quieras acceder a un agente de codificación que se ejecuta en otra máquina.

Consulta PandaNpc de escritorio para ver qué añade la aplicación de Windows/macOS/Linux más allá de los pasos del instalador a continuación, incluido su historial de versiones.

Elige qué instalar

Escenario Cliente Host de PandaPaw
Usar el chat de PandaNpc en un navegador Abrir la aplicación web No requerido
Controlar un agente en este mismo escritorio Aplicación de escritorio Depende del modo local/remoto seleccionado
Controlar una máquina de desarrollo desde un teléfono o navegador Instalar/abrir un cliente en el dispositivo de visualización Requerido en la máquina de desarrollo
Ejecutar agentes en un servidor sin escritorio gráfico Web, escritorio o iOS en otro lugar Requerido en el servidor

Para el camino más corto de extremo a extremo, usa la Guía de inicio rápido.

Instalar un cliente de PandaNpc

Usa la página de descarga de PandaNpc como fuente de verdad para los instaladores actuales. Evita sitios de descarga de terceros porque pueden servir paquetes antiguos o modificados.

Web

Abre pandanpc.com/agent en un navegador actual. No se instala nada. El almacenamiento del navegador conserva el estado de inicio de sesión local, por lo que las ventanas privadas/de incógnito pueden requerir que vuelvas a iniciar sesión.

iOS

Sigue el enlace de la App Store en la página de descarga e instala PandaNpc. iOS es útil para comprobar el progreso, responder preguntas y aprobar herramientas mientras estás fuera del host. El proceso de codificación sigue ejecutándose en la máquina host conectada. Consulta PandaNpc para iOS para ver qué cubre la aplicación, incluido su historial de versiones.

Windows

  1. Descarga el instalador actual de Windows.
  2. Ejecútalo y sigue las indicaciones del instalador.
  3. Inicia PandaNpc desde el menú Inicio.
  4. Si Windows muestra una advertencia de editor o reputación, verifica que el archivo provenga de pandanpc.com antes de continuar.

macOS

  1. Descarga el .dmg de macOS.
  2. Arrastra PandaNpc a Aplicaciones.
  3. Ábrelo desde Aplicaciones y completa cualquier aviso de seguridad de macOS.

La compilación de macOS es universal, por lo que el mismo paquete es compatible con Apple Silicon y los Macs con Intel.

Linux

Descarga el AppImage x86_64, hazlo ejecutable y ejecútalo:

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

Si el AppImage no se inicia, ejecútalo desde una terminal una vez y conserva el mensaje de error exacto. Las distribuciones antiguas pueden carecer de una biblioteca de ejecución necesaria para el shell del escritorio.

Instalar PandaPaw en el host del agente

PandaPaw actualmente ofrece instaladores de host para Windows x64, macOS universal y Linux x86_64. Ejecuta el comando en el ordenador que posee los archivos del proyecto y que debe ejecutar las herramientas del agente.

La ruta recomendada es Dispositivos conectados: elige Añadir un dispositivo, luego copia el comando de un solo uso generado. Esto vincula el host con tu cuenta durante la instalación.

macOS o Linux

Instalador simple con autorización del navegador:

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

Forma preparada con clave de un solo uso:

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

Windows PowerShell

Instalador simple:

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

Forma preparada con clave de un solo uso:

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

La canalización iwr | iex de PowerShell no puede pasar argumentos normales de script, por lo que el instalador de Windows lee la clave de un solo uso desde PANDANET_KEY.

Qué cambia el instalador del host

El instalador:

  1. Añade PandaPaw al directorio de aplicación/bin del usuario actual y actualiza el PATH del usuario cuando es necesario.
  2. Registra los servicios en segundo plano correspondientes para que se inicien automáticamente.
  3. Instala los motores de codificación compatibles que falten cuando la plataforma lo permita.
  4. Proporciona un entorno de ejecución privado de Node.js cuando el sistema no tiene una versión adecuada.
  5. Inicia la autorización de la cuenta o canjea la clave de dispositivo preparada.
  6. Registra qué archivos creó para que la desinstalación pueda conservar las herramientas compatibles que ya estaban presentes.

Instalar un motor no compra ni autentica automáticamente una suscripción de modelo. Claude Code y Codex aún pueden solicitar su propio inicio de sesión de proveedor la primera vez que se ejecutan.

Verificar la instalación

Abre una nueva terminal después de la instalación y ejecuta:

bash
pandapaw status

Luego abre Agente de PandaNpc. El host debería aparecer en línea. Inicia una sesión en un proyecto de prueba y pídele que informe el directorio de trabajo actual sin cambiar archivos. Esto verifica el binario, el servicio en segundo plano, el emparejamiento de cuenta, la conexión de retransmisión, el motor y el directorio seleccionado, no solo el paso de descarga.

Actualizar

Los clientes de escritorio te notifican cuando hay una actualización disponible. iOS se actualiza a través de la App Store.

Actualiza PandaPaw y reinicia sus servicios gestionados con:

bash
pandapaw update --restart

El actualizador verifica el binario descargado contra el checksum SHA-256 publicado antes de reemplazar la copia instalada. El emparejamiento de tu cuenta y la identidad de conexión existente se conservan. También se admite volver a ejecutar el comando de instalación si el actualizador no está disponible.

Desinstalar

  • Cliente de Windows: Configuración → Aplicaciones → Aplicaciones instaladas → PandaNpc → Desinstalar.
  • Cliente de macOS: cierra PandaNpc y luego muévelo desde Aplicaciones a la Papelera.
  • Cliente de Linux: elimina el AppImage y cualquier lanzador que hayas creado para él.
  • Host de PandaPaw: ejecuta pandapaw uninstall en el host.

El manifiesto de desinstalación de PandaPaw distingue las herramientas que creó el instalador de las herramientas compatibles que ya existían. Es intencionalmente conservador en lugar de eliminar una instalación preexistente de Claude Code, Codex, PandaCode o Node.

Problemas de instalación

El comando terminó pero el host no está conectado

Ejecuta pandapaw login. Una instalación del host y una autorización de cuenta son etapas separadas, y el instalador puede completarse incluso si la autorización del navegador se pospuso o se interrumpió.

El shell no encuentra `pandapaw`

Abre una nueva terminal. En macOS/Linux, comprueba ~/.local/bin; en Windows, comprueba %LOCALAPPDATA%\Programs\pandapaw. No repitas la instalación varias veces hasta que hayas confirmado si el ejecutable existe y solo el PATH está desactualizado.

Un motor de codificación no se instaló

El instalador del host trata las descargas opcionales de motores como un esfuerzo de mejor intención, de modo que una caída de un proveedor no elimine una instalación funcional de PandaPaw. Instala o repara ese motor con su instalador oficial, autentícalo normalmente y vuelve a ejecutar pandapaw status.

El AppImage o la aplicación de escritorio no se abren

Confirma que descargaste el paquete para la arquitectura correcta y luego ábrelo desde una terminal para capturar el primer error. Incluye ese error y la versión de tu sistema operativo al contactar con el soporte; las capturas de pantalla de una ventana cerrada normalmente no son suficientes para diagnosticar una biblioteca de ejecución faltante.

Para comprobaciones de conexión específicas del host, continúa con la guía de PandaPaw o las Preguntas frecuentes.