Estas respostas cobrem a configuração atual baseada em conta do PandaPaw. Para uma primeira instalação, siga o Guia de Início Rápido; ele inclui os comandos e uma verificação real de sucesso.
Geral
O que é o PandaNpc?
O PandaNpc é uma interface remota e camada de orquestração para agentes de codificação. Claude Code, Codex ou PandaCode executa em uma máquina que você controla, enquanto você lê a saída, envia instruções, aprova ferramentas e retoma sessões a partir do cliente web, desktop, iOS ou Chrome. O PandaNpc também inclui chat multimodelo, notas, tarefas agendadas, Central de Agentes e ferramentas MCP.
O PandaNpc substitui o Claude Code ou o Codex?
Não. O PandaNpc controla esses mecanismos e adiciona fluxos de trabalho entre dispositivos ao redor deles. O mecanismo em si ainda precisa ser instalado e autenticado no host. O PandaCode é a alternativa incluída quando você mesmo deseja escolher um backend de modelo compatível com OpenAI ou Anthropic.
Quais plataformas são suportadas?
O cliente PandaNpc está disponível na web, iOS, Windows, macOS e Linux. Os instaladores de host do PandaPaw atualmente suportam Windows x64, macOS universal e Linux x86_64. Consulte Instalação para detalhes do pacote e etapas de verificação.
Preciso de uma conta PandaNpc?
Sim, para pareamento de host baseado em conta, configuração compartilhada da Central de Agentes e acesso às máquinas conectadas entre dispositivos. Login com código de e-mail, Google e GitHub são suportados. O provedor de modelos usado pelo Claude Code ou Codex permanece uma conta separada.
Claude Code, Codex e PandaCode Remotos
Como conecto uma nova máquina agora?
Entre, abra Dispositivos Conectados e escolha Adicionar um dispositivo. Execute o comando único gerado no host. A máquina é pareada durante a instalação e então aparece automaticamente no PandaNpc Agent.
Os instaladores padrão continuam disponíveis e executam pandapaw login para autorização no navegador. pandapaw qr é um caminho de compatibilidade para adicionar manualmente conexões antigas ou especiais, não a configuração principal para um novo host. Normalmente, você não deve copiar um Bridge ID e token manualmente.
A máquina host precisa permanecer ligada?
Sim. O mecanismo de codificação e suas ferramentas executam nesse host. O PandaPaw pode iniciar automaticamente após uma reinicialização, mas não pode manter uma sessão ativa enquanto o computador estiver desligado ou em suspensão. Configure o comportamento de suspensão adequadamente para um servidor dedicado ou tarefa de longa duração.
Preciso abrir uma porta ou ter um IP público?
Normalmente não. O host e o cliente de visualização iniciam conexões de saída. Não exponha SSH, uma porta de retransmissão ou um endpoint de modelo local à internet pública apenas para fazer o PandaNpc funcionar. Uma rede corporativa restritiva ainda pode precisar permitir tráfego HTTPS e WebSocket de saída.
Posso controlar o mesmo host a partir de um telefone, navegador e desktop?
Sim. Entre com a mesma conta PandaNpc e abra a conexão salva. Os clientes exibem o mesmo host remoto e estado da sessão. A execução de ferramentas permanece no host, independentemente de qual dispositivo de visualização envia a instrução.
O que acontece quando meu dispositivo de visualização desconecta?
O PandaPaw e o cliente tentam reconectar, e a sessão salva pode ser reaberta com seu histórico. Se o agente continua gerando durante a lacuna depende do mecanismo e do ponto em que a rede falhou. Após reconectar, verifique a última chamada de ferramenta concluída antes de repetir uma operação que possa ter efeitos colaterais.
Por que a máquina está listada, mas offline?
Verifique, nesta ordem:
- O host está ligado e ativo.
pandapaw statusreconhece os serviços e a conta.- O host consegue acessar a internet.
- Um firewall não está bloqueando tráfego WebSocket/HTTPS de saída.
- A chave do dispositivo ou o login foi concluído para a mesma conta PandaNpc que você está visualizando.
Se a instalação foi concluída sem autorização, execute pandapaw login. Não crie uma regra de encaminhamento de porta de entrada como primeiro passo de solução de problemas.
O PandaNpc pode usar uma instalação existente do Claude Code ou Codex?
Sim. O instalador detecta mecanismos compatíveis e os reutiliza. Seu manifesto de desinstalação é conservador: ferramentas que existiam antes do PandaPaw não devem ser removidas pelo pandapaw uninstall.
Modelos, assinaturas e custos
Qual conta paga por uma sessão de codificação remota?
A conta configurada para o mecanismo no host. O Claude Code remoto usa essa assinatura ou backend Claude; o Codex remoto usa seu login ou provedor ChatGPT/Codex; o PandaCode usa o provedor que você selecionou. Os planos de serviço do PandaNpc e as cobranças do provedor de modelos são separados. Veja Contas, planos e cobrança de IA.
Posso usar DeepSeek, Qwen, Kimi ou um endpoint privado?
Sim, por meio da configuração de provedor personalizado do PandaCode ou PandaNpc, quando o endpoint fala um protocolo compatível com OpenAI ou Anthropic. A compatibilidade é mais do que aceitar uma URL: o identificador do modelo, o cabeçalho de autenticação, a resposta em streaming, a chamada de ferramentas, o limite de contexto e o limite de saída devem estar de acordo com o serviço upstream.
O PandaNpc inclui modelos de IA sem uma API Key?
O chat integrado do PandaNpc expõe um conjunto variável de modelos fornecidos. O seletor ao vivo é a referência para disponibilidade atual e elegibilidade da conta. Isso é separado de um processo remoto do Claude Code ou Codex, que normalmente usa as próprias credenciais do mecanismo. Veja Modelos de IA Suportados.
Por que meu provedor personalizado funciona no desktop, mas falha no navegador?
Os clientes desktop podem fazer requisições HTTP nativas, enquanto um navegador deve obedecer às regras de CORS e de conteúdo misto. O provedor deve permitir a origem pandanpc.com e HTTPS quando usado na web. Lembre-se também de que localhost significa o dispositivo que executa o navegador, não o seu host remoto PandaPaw.
Segurança e compartilhamento
Onde os comandos e edições de arquivos são executados?
Na máquina host selecionada. O cliente remoto envia instruções e aprovações; ele não copia todo o projeto para o dispositivo de visualização. Prompts e conteúdo referenciado ainda podem ser enviados ao provedor de modelos escolhido, e os dados da sessão devem passar pelo retransmissor (relay) para serem exibidos remotamente. Leia a Política de Privacidade para a descrição autoritativa dos dados.
Um compartilhamento de conexão é somente leitura?
Não. Um compartilhamento de conexão permite que o destinatário conduza essa conexão de agente, incluindo as ferramentas e o diretório de trabalho disponíveis para a sessão. Para acesso somente visual, compartilhe uma transcrição da sessão. Leia Compartilhamento de Conexão antes de conceder acesso.
Posso revogar um dispositivo ou uma conexão compartilhada?
Sim. Remova um host não reconhecido de Dispositivos Conectados e revogue um compartilhamento de conexão ativo na tela de gerenciamento. A revogação bloqueia o uso futuro dessa credencial; ela não desfaz comandos ou alterações de arquivos já executados no host.
Quais informações devo enviar ao suporte?
Inclua o sistema operacional do host, a versão do PandaPaw, o comando que falhou, o texto exato do erro e se o problema ocorre na web, no desktop ou no iOS. Remova códigos de verificação de e-mail, tokens de conta, chaves de dispositivo, API Keys, endereços IP internos, URLs de repositórios privados e código-fonte que não sejam necessários para reproduzir o problema.
Para comportamento específico de versões, consulte o histórico de versões do PandaPaw. Para ajuda não respondida aqui, envie um e-mail para support@pandanpc.com.