Preguntas Frecuentes de PandaNpc

Actualizado

Estas respuestas cubren la configuración actual de PandaPaw basada en cuenta. Para una primera instalación, siga la Guía de Inicio Rápido; incluye los comandos y una verificación de éxito real.

General

¿Qué es PandaNpc?

PandaNpc es una interfaz remota y capa de orquestación para agentes de codificación. Claude Code, Codex o PandaCode se ejecutan en una máquina que usted controla, mientras usted lee la salida, envía instrucciones, aprueba herramientas y reanuda sesiones desde el cliente web, de escritorio, iOS o Chrome. PandaNpc también incluye chat multimodelo, notas, tareas programadas, Centro de Agentes y herramientas MCP.

¿Es PandaNpc un reemplazo para Claude Code o Codex?

No. PandaNpc controla esos motores y añade flujos de trabajo entre dispositivos alrededor de ellos. El motor real aún debe instalarse y autenticarse en el host. PandaCode es la alternativa incluida cuando usted desea elegir un backend de modelo compatible con OpenAI o Anthropic por su cuenta.

¿Qué plataformas son compatibles?

El cliente de PandaNpc está disponible en web, iOS, Windows, macOS y Linux. Los instaladores de host de PandaPaw actualmente son compatibles con Windows x64, macOS universal y Linux x86_64. Consulte Instalación para obtener detalles de paquetes y pasos de verificación.

¿Necesito una cuenta de PandaNpc?

Sí, para el emparejamiento de host basado en cuenta, la configuración compartida del Centro de Agentes y el acceso a máquinas conectadas desde diferentes dispositivos. Se admiten el código de correo electrónico, Google y el inicio de sesión de GitHub. El proveedor de modelos utilizado por Claude Code o Codex sigue siendo una cuenta separada.

Claude Code, Codex y PandaCode remotos

¿Cómo conecto una nueva máquina ahora?

Inicie sesión, abra Dispositivos Conectados y elija Añadir un dispositivo. Ejecute el comando único generado en el host. La máquina se empareja durante la instalación y luego aparece automáticamente en el Agente PandaNpc.

Los instaladores simples siguen disponibles y ejecutan pandapaw login para la autorización del navegador. pandapaw qr es una ruta de compatibilidad para agregar manualmente conexiones antiguas o especiales, no la configuración principal para un host nuevo. Normalmente no debe copiar un ID de Bridge y un token a mano.

¿La máquina host debe permanecer encendida?

Sí. El motor de codificación y sus herramientas se ejecutan en ese host. PandaPaw puede iniciarse automáticamente después de un reinicio, pero no puede mantener una sesión activa mientras la computadora está apagada o en suspensión. Configure el comportamiento de suspensión adecuadamente para un servidor dedicado o una tarea de larga duración.

¿Necesito abrir un puerto o tener una IP pública?

Normalmente no. El host y el cliente de visualización inician conexiones salientes. No exponga SSH, un puerto de retransmisión ni un endpoint de modelo local a Internet público solo para hacer funcionar PandaNpc. Una red corporativa restrictiva aún puede necesitar permitir tráfico HTTPS y WebSocket saliente.

¿Puedo controlar el mismo host desde un teléfono, navegador y escritorio?

Sí. Inicie sesión con la misma cuenta de PandaNpc y abra la conexión guardada. Los clientes muestran el mismo host remoto y el mismo estado de sesión. La ejecución de herramientas permanece en el host sin importar qué dispositivo de visualización envíe la instrucción.

¿Qué sucede cuando mi dispositivo de visualización se desconecta?

PandaPaw y el cliente intentan reconectarse, y la sesión guardada se puede reabrir con su historial. Si el agente continúa generando durante la interrupción depende del motor y del punto en el que falló la red. Después de reconectarse, verifique la última llamada a herramienta completada antes de repetir una operación que podría tener efectos secundarios.

¿Por qué la máquina aparece en la lista pero está fuera de línea?

Compruebe, en orden:

  1. El host está encendido y despierto.
  2. pandapaw status reconoce los servicios y la cuenta.
  3. El host puede acceder a Internet.
  4. Un firewall no está bloqueando el tráfico WebSocket/HTTPS saliente.
  5. La clave del dispositivo o el inicio de sesión se completaron para la misma cuenta de PandaNpc que usted está viendo.

Si la instalación se realizó sin autorización, ejecute pandapaw login. No cree una regla de reenvío de puertos entrante como primer paso de solución de problemas.

¿Puede PandaNpc usar una instalación existente de Claude Code o Codex?

Sí. El instalador detecta motores compatibles y los reutiliza. Su manifiesto de desinstalación es conservador: las herramientas que existían antes de PandaPaw no deben eliminarse con pandapaw uninstall.

Modelos, suscripciones y costos

¿Qué cuenta paga por una sesión de codificación remota?

La cuenta configurada para el motor en el host. Claude Code remoto usa esa suscripción o backend de Claude; Codex remoto usa su inicio de sesión de ChatGPT/Codex o proveedor; PandaCode usa el proveedor que usted seleccionó. Los planes de servicio de PandaNpc y los cargos del proveedor de modelos son separados. Consulte Cuentas, planes y facturación de IA.

¿Puedo usar DeepSeek, Qwen, Kimi o un endpoint privado?

Sí, a través de PandaCode o de la configuración de proveedor personalizado de PandaNpc cuando el endpoint habla un protocolo compatible con OpenAI o Anthropic. La compatibilidad es más que aceptar una URL: el identificador del modelo, el encabezado de autenticación, la respuesta en streaming, la llamada a herramientas, el límite de contexto y el límite de salida deben coincidir con el servicio ascendente.

¿PandaNpc incluye modelos de IA sin una clave de API?

El chat integrado de PandaNpc expone un conjunto cambiante de modelos proporcionados. El selector en vivo es la autoridad para la disponibilidad actual y la elegibilidad de la cuenta. Esto es independiente de un proceso remoto de Claude Code o Codex, que normalmente usa las propias credenciales del motor. Consulte Modelos de IA compatibles.

¿Por qué mi proveedor personalizado funciona en el escritorio pero falla en el navegador?

Los clientes de escritorio pueden realizar solicitudes HTTP nativas, mientras que un navegador debe cumplir las reglas de CORS y contenido mixto. El proveedor debe permitir el origen pandanpc.com y HTTPS cuando se usa desde la web. Recuerde también que localhost significa el dispositivo que ejecuta el navegador, no su host remoto de PandaPaw.

Seguridad y uso compartido

¿Dónde se ejecutan los comandos y las ediciones de archivos?

En la máquina host seleccionada. El cliente remoto envía instrucciones y aprobaciones; no copia todo el proyecto al dispositivo de visualización. Los mensajes y el contenido referenciado aún pueden enviarse al proveedor de modelos elegido, y los datos de la sesión deben atravesar el relé para mostrarse de forma remota. Lea la Política de Privacidad para obtener la descripción autoritativa de los datos.

¿Un uso compartido de conexión es de solo lectura?

No. Un uso compartido de conexión permite al destinatario manejar esa conexión de agente, incluidas las herramientas y el directorio de trabajo disponibles para la sesión. Para acceso de solo vista, comparta una transcripción de la sesión en su lugar. Lea Uso compartido de conexiones antes de otorgar acceso.

¿Puedo revocar un dispositivo o una conexión compartida?

Sí. Elimine un host no reconocido de Dispositivos Conectados y revoque un uso compartido de conexión activo desde su pantalla de administración. La revocación bloquea el uso futuro de esa credencial; no deshace comandos ni cambios de archivos ya ejecutados en el host.

¿Qué información debo enviar al soporte?

Incluya el sistema operativo del host, la versión de PandaPaw, el comando que falló, el texto de error exacto y si el problema ocurre en web, escritorio o iOS. Elimine los códigos de verificación por correo electrónico, tokens de cuenta, claves de dispositivo, claves de API, direcciones IP internas, URL de repositorios privados y código fuente que no sea necesario para reproducir el problema.

Para comportamientos específicos de una versión, consulte el historial de versiones de PandaPaw. Para obtener ayuda que no se responda aquí, envíe un correo a support@pandanpc.com.