Inicio rápido de PandaNpc Work: conecta tu primer agente

Empieza a usar PandaNpc Work, el espacio de trabajo de IA multi-motor. Conecta una computadora con PandaPaw, elige un motor de agente y verifica una sesión remota.

Actualizado

Esta guía conecta un equipo a PandaNpc Work y verifica que puedes ejecutar Claude Code, Codex o PandaCode desde otro dispositivo. PandaNpc Work es el espacio de trabajo de IA multi-motor donde delegas trabajo y lo sigues entre dispositivos. El agente sigue ejecutándose en el equipo conectado; PandaPaw proporciona el puente y el entorno de ejecución local, mientras que PandaNpc Work te ofrece una interfaz sincronizada para mensajes, aprobaciones, preguntas e historial de sesiones.

Esta ruta es mejor para personas que ya están familiarizadas con Claude Code, Codex o un agente de programación similar. La mayoría de las personas debería usar el flujo Agregar un dispositivo porque genera un comando de instalación de un solo uso ya vinculado a su cuenta. Calcula unos cinco minutos, más cualquier inicio de sesión del proveedor de modelos que requiera tu motor de programación. Para explorar la interfaz de Agent antes de conectar un equipo, abre PandaNpc Agent en un navegador.

Antes de comenzar

Necesitas:

  • Una cuenta de PandaNpc abierta en la aplicación web, la aplicación de escritorio o la aplicación para iOS.
  • Un equipo conectado 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 modelo personalizado si tu motor elegido aún no está autenticado.

Si solo quieres ver un host ya conectado, instala o abre un cliente en tu dispositivo de visualización. PandaPaw va en el equipo que ejecuta el agente. Consulta Instalación para conocer los roles de cliente y host.

1. Genera el comando de instalación del host

Mientras tengas la sesión iniciada, abre Dispositivos conectados y elige Agregar 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 deba ejecutarse el agente de programación. Trátalo como una contraseña hasta que se haya usado: una clave de un solo uso vincula una máquina y no debe publicarse en chats, capturas de pantalla, incidencias ni exportaciones del historial del shell.

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

2. Instala 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 agrega PandaPaw y sus servicios en segundo plano, instala los motores de programación compatibles que falten cuando es posible y proporciona un entorno de ejecución 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 solicite.

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

bash
pandapaw login

3. Verifica 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 encuentra pandapaw, abre primero una nueva terminal para que recargue el PATH de usuario actualizado.

Para un proyecto de 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 de proyecto absoluta real. La vinculación de proyectos de Agent Center funciona mejor cuando el directorio tiene un remote.origin.url de Git estable.

4. Inicia la primera sesión remota

  1. Abre PandaNpc Agent en tu teléfono, navegador u otro equipo de escritorio.
  2. Busca la máquina recién conectada. Un indicador de estado verde significa que el host es accesible en este momento.
  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 mediante el flujo de inicio de sesión mostrado.
  5. Envía un prompt 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 nombra el directorio de proyecto esperado, la lista de archivos coincide con la del host y cualquier pregunta de permiso aparece en el cliente remoto para que la apruebes o la rechaces.

5. Confirma 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 volver y el host debería permanecer en línea. Esto comprueba la ruta remota real en lugar de solo demostrar que el instalador se descargó correctamente.

No pongas el host en suspensión durante esta prueba. Un host suspendido o apagado no puede ejecutar el agente aunque la conexión guardada siga apareciendo 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 se canjeó o expiró, genera una nueva en Dispositivos conectados y vuelve a ejecutar el comando mostrado.

No se reconoce `pandapaw`

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

La máquina aparece en la lista pero está sin conexión

Confirma que el host esté encendido, activo y pueda acceder a Internet. Luego comprueba pandapaw status. Los firewalls corporativos deben permitir el tráfico saliente HTTPS/WebSocket; 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 aún pueden requerir 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 vuelve a intentar la sesión.

El agente se abre en la carpeta incorrecta

Finaliza 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 agrega por sí sola un entorno aislado del sistema de archivos; los permisos de herramientas del motor y el directorio de trabajo seleccionado siguen siendo importantes.

Próximos pasos