Início Rápido: Execute Claude Code ou Codex Remotamente

Atualizado

Este guia conecta uma máquina de desenvolvimento ao PandaNpc e verifica se você pode executar Claude Code, Codex ou PandaCode de outro dispositivo. O agente continua sendo executado na sua máquina de desenvolvimento; o PandaNpc fornece uma interface remota sincronizada para mensagens, aprovações, perguntas e histórico de sessão.

A maioria das pessoas deve usar o fluxo Adicionar um dispositivo, pois ele gera um comando de instalação de uso único já vinculado à sua conta. Reserve cerca de cinco minutos, mais qualquer login no provedor de modelo que seu mecanismo de codificação exigir.

Antes de começar

Você precisa de:

  • Uma conta PandaNpc aberta no aplicativo web, aplicativo de desktop ou aplicativo iOS.
  • Um host executando Windows x64, macOS ou Linux x86_64.
  • Acesso à internet a partir do host e permissão para instalar um serviço de segundo plano em nível de usuário.
  • Uma pasta de projeto que você tem permissão para modificar.
  • Uma conta Claude, ChatGPT/Codex ou modelo personalizado, se o mecanismo escolhido ainda não estiver autenticado.

Se você só precisa do chat integrado do PandaNpc e não deseja controlar um agente em outra máquina, o PandaPaw não é necessário. Consulte Instalação para as opções somente cliente.

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

Enquanto estiver conectado, 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 operacional.

Copie esse comando para a máquina onde o agente de codificação deve ser executado. Trate-o como uma senha até que seja usado: uma chave de uso único pareia uma única máquina e não deve ser postada em chat, capturas de tela, issues ou exportações de histórico do shell.

Se você preferir autorização pelo navegador em vez de uma chave preparada, use o instalador simples na próxima etapa. Ele executa pandapaw login e abre a página de autorização para você.

2. Instalar 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 seus serviços de segundo plano, instala mecanismos de codificação suportados que estejam ausentes quando possível e fornece um runtime Node.js privado quando o host não possui um adequado. Com uma chave de dispositivo preparada, o pareamento da conta ocorre durante a instalação. Com o comando simples, aprove a solicitação de autorização do navegador quando solicitado.

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

bash
pandapaw login

3. Verificar 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 o shell não encontrar pandapaw, abra um novo terminal primeiro para que ele recarregue o PATH do usuário atualizado.

Para um projeto Git, você 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 absoluto real do projeto. A vinculação de projetos do Agent Center funciona melhor quando o diretório tem um remote.origin.url estável do Git.

4. Iniciar a primeira sessão remota

  1. Abra o PandaNpc Agent no seu telefone, navegador ou outro desktop.
  2. Encontre a máquina recém-conectada. Um indicador de status verde significa que o host está atualmente acessível.
  3. Escolha Claude Code, Codex ou PandaCode e selecione o diretório de trabalho do projeto.
  4. Inicie uma sessão. Se o mecanismo pedir para você fazer login, conclua a autorização desse provedor no host ou pelo fluxo de login exibido.
  5. Envie uma instrução de teste não destrutiva, como: Mostre o diretório de trabalho atual e liste os arquivos de nível superior. Não edite nada.

Você está totalmente conectado quando a resposta informa o diretório do projeto esperado, a lista de arquivos corresponde ao host e qualquer pergunta de permissão aparece no cliente remoto para você aprovar ou negar.

5. Confirmar 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 voltar e o host deve permanecer online. Isso verifica o caminho remoto real, em vez de apenas provar que o instalador foi baixado com sucesso.

Não coloque o host em suspensão durante este teste. Um host em suspensão ou desligado não pode executar o agente, mesmo que a conexão salva 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 nenhuma conta está vinculada, execute pandapaw login. Se você usou uma chave preparada e ela já foi resgatada ou expirou, gere uma nova em Dispositivos Conectados e execute novamente o comando exibido.

`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 usuário; um terminal aberto antes da instalação não verá o novo valor.

A máquina aparece listada, mas offline

Confirme que o host está ligado, ativo e capaz de acessar a internet. Em seguida, verifique pandapaw status. Firewalls corporativos devem permitir tráfego HTTPS/WebSocket de saída; você não deve criar uma regra de redirecionamento de porta de entrada.

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

O pareamento do PandaPaw e o login no provedor de modelo são separados. O pareamento prova que o host pertence à sua conta PandaNpc; o Claude Code ou o Codex ainda pode exigir seu próprio login de assinatura ou configuração de API. Conclua o login normal do mecanismo e tente a sessão novamente.

O agente abre na pasta errada

Encerre essa sessão de teste e crie uma com o diretório de trabalho desejado. Antes de aprovar o uso de ferramentas, peça ao agente para imprimir o diretório atual. Uma conexão remota não adiciona uma sandbox de sistema de arquivos por si só; as permissões de ferramenta do mecanismo e o diretório de trabalho selecionado continuam importantes.

Próximos passos

  • Leia o guia completo do host PandaPaw para atualizações, verificações de serviço e arquitetura de conexão.
  • Revise Conta e cobrança para entender qual assinatura ou provedor paga por cada sessão.
  • Adicione provedores de IA personalizados quando quiser um endpoint compatível com OpenAI, um modelo auto-hospedado ou uma chave de API separada.