Inicio rápido: ejecuta Claude Code o Codex de forma remota

Actualizado

Esta guía conecta una máquina de desarrollo a PandaNpc y verifica que puedes ejecutar Claude Code, Codex o PandaCode desde otro dispositivo. El agente sigue ejecutándose en tu máquina de desarrollo; PandaNpc te proporciona una interfaz remota sincronizada para mensajes, aprobaciones, preguntas e historial de sesión.

La mayoría de las personas deberían usar el flujo Añadir un dispositivo, porque genera un comando de instalación de un solo uso ya vinculado a su cuenta. Dedica unos cinco minutos, más el inicio de sesión del proveedor de modelos que requiera tu motor de codificación.

Antes de comenzar

Necesitas:

  • Una cuenta de PandaNpc abierta en la aplicación web, la aplicación de escritorio o la aplicación iOS.
  • Un host que ejecute Windows x64, macOS o Linux x86_64.
  • Acceso a Internet desde el host y permiso para instalar un servicio en segundo plano a nivel de usuario.
  • Una carpeta de proyecto que tengas permitido modificar.
  • Una cuenta de Claude, ChatGPT/Codex o de modelo personalizado si tu motor elegido no está ya autenticado.

Si solo necesitas el chat integrado de PandaNpc y no quieres controlar un agente en otra máquina, PandaPaw no es necesario. Consulta Instalación para las opciones solo de cliente.

1. Generar el comando de instalación del host

Mientras tengas la sesión iniciada, abre Dispositivos conectados y elige Añadir un dispositivo. PandaNpc crea una clave de dispositivo de un solo uso y muestra el comando exacto para tu sistema operativo.

Copia ese comando en la máquina donde debe ejecutarse el agente de codificación. Trátalo como una contraseña hasta que se haya utilizado: una clave de un solo uso vincula una única máquina y no debe publicarse en chats, capturas de pantalla, issues ni exportaciones del historial de shell.

Si prefieres la autorización mediante navegador en lugar de una clave preparada, usa el instalador simple del siguiente paso. Ejecuta pandapaw login y abre la página de autorización por ti.

2. Instalar PandaPaw en el host

macOS o Linux

Ejecuta el comando preparado desde Dispositivos conectados, o usa el instalador simple:

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

Windows PowerShell

Ejecuta el comando preparado desde Dispositivos conectados, o usa:

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

El instalador añade PandaPaw y sus servicios en segundo plano, instala los motores de codificación compatibles que falten cuando sea posible y proporciona un runtime privado de Node.js cuando el host no tiene uno adecuado. Con una clave de dispositivo preparada, el emparejamiento de la cuenta ocurre durante la instalación. Con el comando simple, aprueba la solicitud de autorización del navegador cuando se te pida.

El instalador puede finalizar incluso si la autorización de la cuenta se pospone. Si dice que la instalación se realizó correctamente pero la conexión de la cuenta está incompleta, ejecuta:

bash
pandapaw login

3. Verificar los servicios del host

En el host, ejecuta:

bash
pandapaw status

El comando debería reconocer los servicios instalados y mostrar la máquina conectada a la cuenta. Si el shell no puede encontrar pandapaw, abre una nueva terminal primero para que recargue el PATH de usuario actualizado.

Para un proyecto Git, también puedes comprobar si Agent Center reconoce la raíz del proyecto:

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

Usa una ruta absoluta real del proyecto. El enlace de proyectos de Agent Center funciona mejor cuando el directorio tiene un remote.origin.url de Git estable.

4. Iniciar la primera sesión remota

  1. Abre PandaNpc Agent en tu teléfono, navegador u otro escritorio.
  2. Encuentra la máquina recién conectada. Un indicador de estado verde significa que el host está actualmente accesible.
  3. Elige Claude Code, Codex o PandaCode y selecciona el directorio de trabajo del proyecto.
  4. Inicia una sesión. Si el motor te pide iniciar sesión, completa la autorización de ese proveedor en el host o a través del flujo de inicio de sesión mostrado.
  5. Envía un mensaje de prueba no destructivo como: Show the current working directory and list the top-level files. Do not edit anything.

Estás totalmente conectado cuando la respuesta menciona el directorio del proyecto esperado, la lista de archivos coincide con el host y cualquier pregunta de permiso aparece en el cliente remoto para que la apruebes o la deniegues.

5. Confirmar el comportamiento de reconexión

Cierra el cliente de visualización, espera unos segundos y vuelve a abrir la misma sesión. El historial existente debería regresar y el host debería permanecer en línea. Esto verifica la ruta remota real, en lugar de solo demostrar que el instalador se descargó correctamente.

No pongas el host en reposo durante esta prueba. Un host en reposo o apagado no puede ejecutar el agente, aunque la conexión guardada aún aparezca en tu cuenta.

Solución de problemas

La máquina no aparece en Agent

Ejecuta pandapaw status en el host. Si la instalación se realizó correctamente pero no hay ninguna cuenta vinculada, ejecuta pandapaw login. Si usaste una clave preparada y ya fue canjeada o expiró, genera una nueva en Dispositivos conectados y vuelve a ejecutar el comando mostrado.

`pandapaw` no se reconoce

Abre una nueva terminal. En macOS/Linux, confirma que ~/.local/bin esté en PATH. En Windows, el instalador añade %LOCALAPPDATA%\Programs\pandapaw al PATH de usuario; una terminal abierta antes de la instalación no verá el nuevo valor.

La máquina aparece pero está fuera de línea

Confirma que el host esté encendido, despierto y pueda acceder a Internet. Luego verifica pandapaw status. Los cortafuegos corporativos deben permitir el tráfico HTTPS/WebSocket saliente; no debes crear una regla de reenvío de puertos entrante.

La conexión funciona pero el motor solicita autenticación

El emparejamiento de PandaPaw y el inicio de sesión del proveedor de modelos son independientes. El emparejamiento demuestra que el host pertenece a tu cuenta de PandaNpc; Claude Code o Codex pueden requerir aún su propio inicio de sesión de suscripción o configuración de API. Completa el inicio de sesión normal del motor y luego reintenta la sesión.

El agente se abre en la carpeta incorrecta

Termina esa sesión de prueba y crea una con el directorio de trabajo previsto. Antes de aprobar el uso de herramientas, pide al agente que imprima el directorio actual. Una conexión remota no añade un sandbox del sistema de archivos por sí misma; los permisos de herramientas del motor y el directorio de trabajo seleccionado siguen siendo importantes.

Siguientes pasos