PandaPaw: Host remoto para Claude Code, Codex y PandaCode

PandaPaw convierte una máquina Windows, macOS o Linux que controlas en un host de agentes PandaNpc. El motor de codificación, los archivos del proyecto, el shell y las herramientas permanecen en ese host; los clientes de PandaNpc te ofrecen una interfaz sincronizada desde un teléfono, un navegador u otro escritorio.

Usa PandaPaw cuando la máquina que realiza el trabajo sea diferente del dispositivo que sostienes, cuando quieras que un host sobreviva a las desconexiones del cliente, o cuando varios motores de codificación deban compartir la misma configuración basada en cuenta y la configuración del Centro de agentes.

Qué gestiona PandaPaw

• Conexiones remotas de agentes para Claude Code, OpenAI Codex y PandaCode.
• Servicios en segundo plano y arranque automático para que el host pueda volver después de un reinicio normal.
• Autorización de máquinas basada en cuenta sin copiar manualmente un Bridge ID, token o clave de firma de larga duración.
• Asistencia para la instalación de motores cuando falta un motor de codificación compatible.
• Proyecciones del Centro de agentes que representan las guías, habilidades, memoria y definiciones de agente de cada motor en su diseño nativo.
• Red privada de dispositivos para máquinas incorporadas mediante el flujo de Dispositivos conectados.
• Registro de actualizaciones y desinstalaciones para que se conserven las herramientas que existían antes de PandaPaw.

PandaPaw no proporciona una suscripción de modelo por sí mismo. Claude Code, Codex y PandaCode siguen utilizando las credenciales y los límites del proveedor configurados para su motor.

Cómo funciona la ejecución remota

Ambos lados inician conexiones salientes, por lo que una configuración doméstica u oficina normal no requiere una regla de firewall de entrada, una dirección IP pública, redireccionamiento de puertos en el enrutador ni un servidor SSH expuesto públicamente. El retransmisor transporta mensajes, estado y aprobaciones; la ejecución de herramientas ocurre en el host.

Si el host se suspende, se apaga o pierde su ruta de red saliente, la conexión guardada permanece en tu cuenta pero no puede ejecutar trabajo hasta que el host vuelva.

Plataformas de host compatibles

El cliente de visualización PandaNpc tiene una matriz de plataformas más amplia. Consulta Instalar PandaNpc y PandaPaw al elegir los paquetes de cliente y host.

Instalación recomendada

1. Inicia sesión en PandaNpc.
2. Abre Dispositivos conectados.
3. Elige Añadir un dispositivo. Se emite una clave de un solo uso y el diálogo muestra un comando para el sistema operativo detectado.
4. Copia ese comando al host y ejecútalo allí.
5. Deja el diálogo abierto si quieres que detecte la nueva máquina automáticamente.

La clave preparada es de un solo uso. Copia todo el comando, mantenlo privado y genera uno nuevo si caduca o ya fue canjeada.

Instalador básico para macOS/Linux

Usa este método cuando quieras autorización mediante navegador en lugar de una clave preparada:

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

Instalador básico para Windows PowerShell

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

El instalador básico ejecuta pandapaw login. Aprueba la máquina en la página del navegador que abre. Si la autorización se interrumpe, el binario y los servicios aún pueden instalarse; ejecuta pandapaw login más tarde para completar la conexión de la cuenta.

Verificar el host

Primero comprueba el propio host:

pandapaw status

Luego abre PandaNpc Agent y confirma que la máquina tiene un indicador en línea verde. Inicia una sesión en un directorio de prueba desechable o de solo lectura y pregunta:

Prompt de prueba: Imprime el directorio de trabajo actual y lista los archivos de nivel superior. No modifiques nada.

Una respuesta exitosa demuestra más que una luz de estado verde: verifica la vinculación de la cuenta, la conectividad del retransmisor, el motor seleccionado, la autenticación del proveedor y la asignación del directorio de trabajo.

Para un proyecto del Centro de agentes, ejecuta:

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

Esto muestra si el proyecto está vinculado y si la configuración gestionada está disponible localmente. Un remoto Git estable ayuda a PandaPaw a identificar el mismo proyecto en distintas máquinas.

Autorización de cuenta e identidad de conexión

pandapaw login utiliza una sesión de autorización de dispositivo mediante navegador. Después de que la apruebes, el host recibe credenciales limitadas al dispositivo y una clave de verificación del Centro de agentes a través de TLS, escribe su configuración de máquina en ~/.pandapaw/, registra las conexiones de motor compatibles y vincula proyectos Git reconocibles.

Ejecuta pandapaw login --force solo cuando cambies de cuenta intencionalmente o reemplaces una credencial de host caducada. Reautorizar una máquina sana sin motivo puede crear identidades duplicadas o reemplazadas confusas.

pandapaw qr sigue creando un enlace de conexión manual de corta duración para compatibilidad y casos especiales. No es el flujo principal para un host nuevo; Dispositivos conectados es más fácil de auditar y no requiere que los usuarios entiendan los Bridge IDs.

Sincronización del Centro de agentes

El Centro de agentes está orientado a eventos en estado estable:

1. Los cambios locales en archivos gestionados se detectan y se publican en el proyecto vinculado.
2. Las versiones firmadas llegan a través de un flujo de eventos.
3. Los manifiestos y blobs de contenido sin cambios se reutilizan en lugar de descargarse de nuevo.
4. Una comprobación periódica de recuperación detecta eventos perdidos durante una desconexión temporal.

Claude Code, Codex y PandaCode reciben proyecciones separadas porque esperan directorios y formatos de instrucción diferentes. PandaCode prepara la última versión verificada antes de ensamblar un nuevo prompt de sesión, por lo que la configuración obtenida al inicio puede afectar a esa misma sesión.

Si el Centro de agentes no está disponible temporalmente, el motor continúa con la última versión local verificada. Un fallo de red no debe reemplazar silenciosamente la configuración firmada con contenido no verificado.

Comandos útiles

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

Consulta el historial de versiones de PandaPaw cuando un comando o la interfaz difiera de una captura de pantalla o tutorial antiguo.

Límites de seguridad

• Un operador remoto puede ejercer cualquier herramienta y directorio de trabajo que permita la sesión del agente seleccionado. El acceso remoto no es automáticamente de solo lectura.
• Mantén los comandos de dispositivo de un solo uso, los enlaces de conexión manual, las claves de proveedor y los tokens de cuenta fuera de registros y capturas de pantalla.
• No abras puertos de entrada en el enrutador solo para hacer que PandaPaw sea accesible.
• Elimina de Dispositivos conectados los hosts que ya no poseas.
• Revisa las aprobaciones de herramientas y verifica el directorio de trabajo antes de permitir ediciones o comandos de shell.
• Al compartir una conexión en vivo, el destinatario consume la cuota del motor del propietario del host y puede actuar en el host. Lee primero Compartir conexión.

Solución de problemas

`pandapaw` no se encuentra después de la instalación

Abre una nueva terminal para que recargue el PATH del usuario. Las ubicaciones normales son ~/.local/bin en macOS/Linux y %LOCALAPPDATA%\Programs\pandapaw en Windows. Confirma que el archivo existe antes de volver a ejecutar el instalador.

La instalación se realizó correctamente, pero no aparece ninguna máquina

Ejecuta pandapaw status. Si la máquina no tiene autorización de cuenta, ejecuta pandapaw login. Si se usó una clave preparada de un solo uso, crea una nueva clave en lugar de reintentar un comando ya consumido.

La máquina aparece pero permanece sin conexión

Confirma que el host está activo y tiene acceso a internet. Comprueba el estado de PandaPaw localmente. Un proxy corporativo o firewall debe permitir la ruta saliente HTTPS/WebSocket; un puerto de entrada no resuelve una conexión saliente bloqueada.

El host está en línea, pero Claude Code o Codex no responden

Vincular el host no autentica a todos los proveedores de modelos. Abre el motor localmente o sigue el prompt de inicio de sesión que se muestra en la sesión remota. También confirma que el modelo seleccionado existe para esa cuenta y que su límite de uso no está agotado.

La sesión se abre en el proyecto equivocado

Termina la prueba, selecciona el directorio de trabajo absoluto previsto y pide al agente que lo imprima antes de aprobar herramientas. PandaPaw no adivina qué repositorio querías decir y no añade una sandbox de sistema de archivos más allá del modelo de permisos del propio motor.

Los cambios del Centro de agentes no aparecen

Ejecuta pandapaw agent status --root /path/to/project desde la raíz de Git correcta. Confirma que el proyecto está vinculado, que el host tiene la sesión iniciada y que el archivo local forma parte de una proyección gestionada. Mantén la última versión verificada en su lugar mientras investigas, en lugar de eliminar directorios gestionados.

Actualización y desinstalación

pandapaw update --restart descarga el binario actual, verifica su suma de comprobación SHA-256, reemplaza la copia instalada y reinicia los servicios gestionados para que la versión se active. Se conserva la vinculación de cuenta existente.

pandapaw uninstall utiliza el manifiesto de instalación para eliminar los elementos que PandaPaw creó. Las instalaciones compatibles de Claude Code, Codex, PandaCode o Node que ya existían se conservan intencionalmente. Después de desinstalar, elimina el host de Dispositivos conectados si ya no debe ser confiable.