Instale PandaNpc e PandaPaw

Atualizado

Uma configuração de agente de codificação remota tem duas partes independentes:

  • Cliente PandaNpc — a interface usada para ler sessões, enviar prompts e aprovar ferramentas. Ele roda na web, iOS, Windows, macOS e Linux.
  • Host PandaPaw — o serviço em segundo plano no computador onde Claude Code, Codex ou PandaCode realmente executam.

Instale apenas o cliente para o chat PandaNpc e uso local em desktop. Instale ambas as partes quando quiser acessar um agente de codificação em execução em outra máquina.

Consulte PandaNpc Desktop para saber o que o aplicativo Windows/macOS/Linux adiciona além das etapas de instalação abaixo, incluindo seu histórico de versões.

Escolha o que instalar

Cenário Cliente Host PandaPaw
Usar o chat PandaNpc no navegador Abra o aplicativo web Não é necessário
Controlar um agente neste mesmo desktop Aplicativo de desktop Depende do modo local/remoto selecionado
Controlar uma máquina de desenvolvimento a partir de um telefone ou navegador Instalar/abrir um cliente no dispositivo de visualização Necessário na máquina de desenvolvimento
Executar agentes em um servidor sem desktop gráfico Web, desktop ou iOS em outro lugar Necessário no servidor

Para o caminho mais curto de ponta a ponta, use o Guia de Início Rápido.

Instale um cliente PandaNpc

Use a página de download do PandaNpc como fonte de verdade para os instaladores atuais. Evite sites de download de terceiros porque eles podem fornecer pacotes antigos ou modificados.

Web

Abra pandanpc.com/agent em um navegador atual. Nada é instalado. O armazenamento do navegador mantém o estado de login local, então janelas privativas/anônimas podem exigir que você faça login novamente.

iOS

Siga o link da App Store na página de download e instale o PandaNpc. O iOS é útil para verificar o progresso, responder perguntas e aprovar ferramentas enquanto estiver longe do host. O processo de codificação ainda é executado na máquina host conectada. Veja PandaNpc para iOS para saber o que o aplicativo cobre, incluindo seu histórico de versões.

Windows

  1. Baixe o instalador atual do Windows.
  2. Execute-o e siga as instruções do instalador.
  3. Inicie o PandaNpc pelo menu Iniciar.
  4. Se o Windows exibir um aviso de editor ou reputação, verifique se o arquivo veio de pandanpc.com antes de continuar.

macOS

  1. Baixe o .dmg do macOS.
  2. Arraste o PandaNpc para Applications.
  3. Inicie-o a partir de Applications e conclua qualquer solicitação de segurança do macOS.

O build do macOS é universal, então o mesmo pacote suporta Apple Silicon e Macs Intel.

Linux

Baixe o AppImage x86_64, torne-o executável e execute-o:

bash
chmod +x PandaNpc_*.AppImage
./PandaNpc_*.AppImage

Se o AppImage não iniciar, execute-o uma vez a partir do terminal e guarde a saída de erro exata. Distribuições mais antigas podem estar sem uma biblioteca de runtime necessária para o shell do desktop.

Instale o PandaPaw no host do agente

O PandaPaw atualmente fornece instaladores de host para Windows x64, macOS universal e Linux x86_64. Execute o comando no computador que possui os arquivos do projeto e deve executar as ferramentas do agente.

A rota recomendada é Dispositivos Conectados: escolha Adicionar um dispositivo e copie o comando único gerado. Ele vincula o host à sua conta durante a instalação.

macOS ou Linux

Instalador simples com autorização do navegador:

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

Formato com chave única preparada:

bash
curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh -s -- --mesh pnkey-xxxx

Windows PowerShell

Instalador simples:

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

Formato com chave única preparada:

powershell
$env:PANDANET_KEY="pnkey-xxxx"; iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

O pipeline iwr | iex do PowerShell não pode passar argumentos normais de script, então o instalador do Windows lê a chave única de PANDANET_KEY.

O que o instalador do host altera

O instalador:

  1. Adiciona o PandaPaw ao diretório application/bin do usuário atual e atualiza o PATH do usuário quando necessário.
  2. Registra os serviços em segundo plano apropriados para iniciar automaticamente.
  3. Instala os mecanismos de codificação suportados que estiverem ausentes quando a plataforma permitir.
  4. Fornece um runtime Node.js privado quando o sistema não tiver uma versão adequada.
  5. Inicia a autorização da conta ou resgata a chave de dispositivo preparada.
  6. Registra quais arquivos criou para que a desinstalação possa preservar ferramentas compatíveis que já estavam presentes.

Instalar um mecanismo não compra nem autentica automaticamente uma assinatura de modelo. Claude Code e Codex ainda podem pedir seu próprio login de provedor na primeira vez em que forem executados.

Verifique a instalação

Abra um novo terminal após a instalação e execute:

bash
pandapaw status

Em seguida, abra PandaNpc Agent. O host deve aparecer online. Inicie uma sessão em um projeto de teste e peça para ele informar o diretório de trabalho atual sem alterar arquivos. Isso verifica o binário, o serviço em segundo plano, o pareamento de conta, a conexão de retransmissão, o mecanismo e o diretório selecionado — não apenas a etapa de download.

Atualização

Os clientes de desktop notificam você quando uma atualização está disponível. O iOS atualiza pela App Store.

Atualize o PandaPaw e reinicie seus serviços gerenciados com:

bash
pandapaw update --restart

O atualizador verifica o binário baixado em relação ao checksum SHA-256 publicado antes de substituir a cópia instalada. Seu pareamento de conta e a identidade de conexão existente são preservados. Executar novamente o comando de instalação também é suportado quando o próprio atualizador não estiver disponível.

Desinstalação

  • Cliente Windows: Configurações → Aplicativos → Aplicativos instalados → PandaNpc → Desinstalar.
  • Cliente macOS: saia do PandaNpc e mova-o de Applications para o Lixo.
  • Cliente Linux: remova o AppImage e qualquer inicializador que você tenha criado para ele.
  • Host PandaPaw: execute pandapaw uninstall no host.

O manifesto de desinstalação do PandaPaw distingue as ferramentas criadas pelo instalador das ferramentas compatíveis que já existiam. Ele é intencionalmente conservador em vez de excluir uma instalação pré-existente de Claude Code, Codex, PandaCode ou Node.

Problemas de instalação

O comando terminou, mas o host não está conectado

Execute pandapaw login. A instalação do host e a autorização da conta são estágios separados, e o instalador pode ser concluído mesmo se a autorização do navegador tiver sido adiada ou interrompida.

O shell não consegue encontrar `pandapaw`

Abra um novo terminal. No macOS/Linux, verifique ~/.local/bin; no Windows, verifique %LOCALAPPDATA%\Programs\pandapaw. Não reinstale repetidamente até confirmar se o executável existe e apenas o PATH está desatualizado.

Um mecanismo de codificação falhou ao instalar

O instalador do host trata os downloads opcionais de mecanismos melhor esforço, para que uma queda de um provedor não remova uma instalação funcional do PandaPaw. Instale ou repare esse mecanismo usando o instalador oficial, autentique-o normalmente e execute pandapaw status novamente.

O AppImage ou o aplicativo de desktop não abre

Confirme se você baixou o pacote para a arquitetura correta e inicie-o a partir de um terminal para capturar o primeiro erro. Inclua esse erro e a versão do seu sistema operacional ao entrar em contato com o suporte; capturas de tela de uma janela fechada geralmente não são suficientes para diagnosticar uma biblioteca de runtime ausente.

Para verificações de conexão específicas do host, continue com o guia do PandaPaw ou o FAQ.