Início Rápido do PandaNpc Work: Conecte Seu Primeiro Agente

Comece a usar o PandaNpc Work, o espaço de trabalho de IA multi-motor. Conecte um computador com PandaPaw, escolha um motor de agente e verifique uma sessão remota.

Atualizado

Este guia liga um computador ao PandaNpc Work e verifica que consegue executar Claude Code, Codex ou PandaCode a partir de outro dispositivo. O PandaNpc Work é o espaço de trabalho de IA com vários motores onde delega trabalho e o acompanha entre dispositivos. O agente continua a ser executado no computador conectado; o PandaPaw fornece a ponte e o runtime local, enquanto o PandaNpc Work lhe dá uma interface sincronizada para mensagens, aprovações, perguntas e histórico de sessões.

Este caminho é melhor para pessoas que já estão à vontade com Claude Code, Codex ou um agente de programação semelhante. A maioria das pessoas deve usar o fluxo Adicionar um dispositivo, porque gera um comando de instalação de uso único já associado à sua conta. Reserve cerca de cinco minutos, além de qualquer início de sessão no fornecedor de modelo exigido pelo seu motor de programação. Para explorar a interface do Agent antes de conectar um computador, abra PandaNpc Agent num navegador.

Antes de começar

Precisa de:

  • Uma conta PandaNpc aberta na aplicação web, na aplicação de desktop ou na aplicação iOS.
  • Um computador conectado a executar Windows x64, macOS ou Linux x86_64.
  • Acesso à internet a partir do host e permissão para instalar um serviço em segundo plano ao nível do utilizador.
  • Uma pasta de projeto que tem permissão para modificar.
  • Uma conta Claude, ChatGPT/Codex ou de modelo personalizado, se o motor escolhido ainda não estiver autenticado.

Se só pretende ver um host já conectado, instale ou abra um cliente no seu dispositivo de visualização. O PandaPaw pertence ao computador que executa o agente. Consulte Instalação para as funções de cliente e host.

1. Gere o comando de instalação do host

Com a sessão iniciada, abra Dispositivos conectados e escolha Adicionar um dispositivo. O PandaNpc cria uma chave de dispositivo de uso único e mostra o comando exato para o seu sistema operativo.

Copie esse comando para a máquina onde o agente de programação deve ser executado. Trate-o como uma palavra-passe até ser usado: uma chave de uso único emparelha uma máquina e não deve ser publicada em chat, capturas de ecrã, issues ou exportações do histórico da shell.

Se preferir autorização pelo navegador em vez de uma chave preparada, use o instalador simples no passo seguinte. Ele executa pandapaw login e abre a página de autorização para si.

2. Instale o PandaPaw no host

macOS ou Linux

Execute o comando preparado em Dispositivos conectados ou use o instalador simples:

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

Windows PowerShell

Execute o comando preparado em Dispositivos conectados ou use:

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

O instalador adiciona o PandaPaw e os seus serviços em segundo plano, instala motores de programação compatíveis em falta quando possível e fornece um runtime Node.js privado quando o host não tem um adequado. Com uma chave de dispositivo preparada, o emparelhamento da conta acontece durante a instalação. Com o comando simples, aprove o pedido de autorização do navegador quando lhe for solicitado.

O instalador pode terminar mesmo quando a autorização da conta é adiada. Se indicar que a instalação foi bem-sucedida, mas a conexão da conta estiver incompleta, execute:

bash
pandapaw login

3. Verifique os serviços do host

No host, execute:

bash
pandapaw status

O comando deve reconhecer os serviços instalados e mostrar a máquina conectada à conta. Se a shell não encontrar pandapaw, abra primeiro um novo terminal para que recarregue o PATH atualizado do utilizador.

Para um projeto Git, também pode verificar se o Agent Center reconhece a raiz do projeto:

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

Use um caminho de projeto absoluto real. A vinculação de projeto do Agent Center funciona melhor quando o diretório tem um remote.origin.url Git estável.

4. Inicie a primeira sessão remota

  1. Abra o PandaNpc Agent no seu telefone, navegador ou noutro desktop.
  2. Encontre a máquina recém-conectada. Um indicador de estado verde significa que o host está acessível neste momento.
  3. Escolha Claude Code, Codex ou PandaCode e selecione o diretório de trabalho do projeto.
  4. Inicie uma sessão. Se o motor lhe pedir para iniciar sessão, conclua a autorização desse fornecedor no host ou através do fluxo de início de sessão apresentado.
  5. Envie um prompt de teste não destrutivo, como: Show the current working directory and list the top-level files. Do not edit anything.

Está totalmente conectado quando a resposta indicar o diretório de projeto esperado, a lista de ficheiros corresponder ao host e qualquer pergunta de permissão aparecer no cliente remoto para aprovar ou negar.

5. Confirme o comportamento de reconexão

Feche o cliente de visualização, aguarde alguns segundos e reabra a mesma sessão. O histórico existente deve regressar e o host deve permanecer online. Isto verifica o caminho remoto real em vez de apenas provar que o instalador foi descarregado com sucesso.

Não coloque o host em suspensão durante este teste. Um host suspenso ou desligado não pode executar o agente, mesmo que a conexão guardada ainda apareça na sua conta.

Solução de problemas

A máquina não aparece no Agent

Execute pandapaw status no host. Se a instalação foi bem-sucedida, mas não estiver associada nenhuma conta, execute pandapaw login. Se usou uma chave preparada e esta já tiver sido resgatada ou expirada, gere uma nova em Dispositivos conectados e execute novamente o comando apresentado.

`pandapaw` não é reconhecido

Abra um novo terminal. No macOS/Linux, confirme que ~/.local/bin está no PATH. No Windows, o instalador adiciona %LOCALAPPDATA%\Programs\pandapaw ao PATH do utilizador; um terminal aberto antes da instalação não verá o novo valor.

A máquina está listada, mas offline

Confirme que o host está ligado, desperto e capaz de aceder à internet. Depois, verifique pandapaw status. As firewalls corporativas devem permitir tráfego HTTPS/WebSocket de saída; não deve criar uma regra de encaminhamento de porta de entrada.

A conexão funciona, mas o motor pede autenticação

O emparelhamento do PandaPaw e o início de sessão no fornecedor de modelo são separados. O emparelhamento prova que o host pertence à sua conta PandaNpc; Claude Code ou Codex podem continuar a exigir o seu próprio início de sessão de subscrição ou configuração de API. Conclua o início de sessão normal do motor e tente novamente a sessão.

O agente abre na pasta errada

Termine essa sessão de teste e crie uma com o diretório de trabalho pretendido. Antes de aprovar a utilização de ferramentas, peça ao agente para imprimir o diretório atual. Uma conexão remota não adiciona, por si só, um sandbox de sistema de ficheiros; as permissões de ferramentas do motor e o diretório de trabalho selecionado continuam a ser importantes.

Próximos passos