Manutenção · o mecânico do agente

A Ponte: seu Claude vira o mecânico do seu agente

Seu agente tem um vigia que o religa sozinho quando ele cai. Mas vigia não é mecânico: agente nenhum se conserta sozinho. A Ponte resolve isso: o Claude no seu notebook ganha acesso ao seu servidor e vira o técnico de manutenção do seu agente. Quebrou, mudou de comportamento, quer ajustar a personalidade? Você pede em português, o Claude conserta.

Pré-requisitos: agente instalado e respondendo no Telegram · assinatura Claude (plano Pro ou acima; o grátis não destrava o Claude Code) · IP e senha de root do seu servidor.
Atenção Isto roda no NOTEBOOK, não no servidor. A instalação do agente foi toda dentro do servidor (linha root@srv). A Ponte é o contrário: tudo deste manual acontece no seu computador. Se a linha do seu terminal começa com root@srv, saia do servidor primeiro: digite exit e dê Enter, até a linha voltar a mostrar o nome do seu computador. Na analogia da sala: até agora usamos o telefone pra construir a casa; agora vamos dar um telefone ao seu Claude, pra ele ligar pra casa quando precisar.

O caminho fácil: pelo aplicativo (recomendado)

O Claude Code aplicativo (Mac e Windows) faz a ponte inteira sem precisar de terminal:

  1. Baixe o aplicativo

    Baixe em claude.com/download (endereço oficial; nada de loja de aplicativo nem anúncio) e instale.

  2. Entre na sua conta

    Abra o aplicativo e entre na sua conta Claude.

  3. Escolha a pasta de trabalho

    Ele vai pedir uma pasta de trabalho: crie ou escolha uma chamada agente-ponte.

  4. Cole a primeira mensagem

    Na conversa, cole esta mensagem (trocando SEU_IP pelo IP do seu servidor):

    Baixe https://kit.evotero.com.br/ponte-runbook.md e salve nesta pasta como CLAUDE.md. Ele é o manual da ponte de manutenção do meu agente. Depois de ler, monte o acesso ao meu servidor: o IP é SEU_IP e eu tenho a senha de root aqui comigo pra digitar quando precisar.

    Depois disso, pule direto pro Teste de fogo lá embaixo. Pronto: sem terminal nenhum.

O que NÃO serve O Claude de conversa comum (o chat do claude.ai ou o aplicativo de chat) não faz a ponte, porque não roda comandos no seu computador. A regra: se o Claude consegue mexer nos SEUS arquivos e rodar comandos na SUA máquina, ele faz a ponte.

Caminho alternativo: pelo terminal

Prefere o terminal, ou o aplicativo não instalou? O caminho clássico:

  1. Instalar o Claude Code (5 min)

    No terminal do notebook (Mac: app Terminal · Windows: PowerShell).

    Mac:

    curl -fsSL https://claude.ai/install.sh | bash

    Windows (PowerShell):

    irm https://claude.ai/install.ps1 | iex
    Cuidado O endereço certo é claude.ai. Não baixe "Claude" de loja de aplicativo nem de anúncio: existem imitações pagas que não servem. Quando terminar, feche o terminal e abra de novo (pra ele reconhecer o programa novo).

  2. Entrar na sua conta (2 min)

    No terminal novo, digite:

    claude

    Na primeira vez ele abre o navegador pra você entrar na sua conta Claude (a assinatura é sua; use o e-mail dela). Autorize e volte ao terminal. Quando aparecer a tela de conversa do Claude, está funcionando. Pode sair digitando /exit por enquanto.

  3. Criar a pasta da Ponte (2 min)

    Cole este bloco inteiro no terminal (do notebook, não do servidor):

    mkdir -p ~/agente-ponte && cd ~/agente-ponte && curl -fsSL https://kit.evotero.com.br/ponte-runbook.md -o CLAUDE.md && claude

    O que isso faz: cria uma pasta chamada agente-ponte, baixa pra dentro dela o manual do mecânico (um arquivo que ensina o seu Claude tudo sobre o seu agente: onde ele mora, como consertar, o que nunca fazer) e abre o Claude dentro dessa pasta. Sempre que quiser usar a Ponte no futuro, é só abrir o terminal e digitar:

    cd ~/agente-ponte && claude

  4. A primeira conversa (5 min)

    Com o Claude aberto na pasta, cole esta mensagem (trocando o IP pelo seu):

    Você é a ponte de manutenção do meu agente. Leia o CLAUDE.md desta pasta e monte o acesso ao meu servidor. O IP é SEU_IP e eu tenho a senha de root aqui comigo pra digitar quando precisar.

    O Claude vai montar a ponte sozinho: criar uma chave de acesso, instalar no servidor (vai pedir pra você digitar a senha de root uma única vez; ela fica invisível ao digitar, é normal) e testar a ligação. No final ele confirma que a ponte está de pé.

Teste de fogo (5 min, pros dois caminhos)

Ainda na conversa, peça na sequência, com suas palavras:

  1. Está no ar?

    "Meu agente está no ar? Me explica em linguagem simples."

  2. Reinicia e confirma

    "Reinicia o meu agente e confirma que voltou." Depois manda um oi no seu bot do Telegram: a primeira resposta demora ~25 segundos.

  3. O que o vigia fez?

    "O que o vigia andou fazendo esses dias?"

Se as três respostas vierem claras e o bot responder no Telegram, a Ponte está completa. Seu agente agora tem operador (você, pelo Telegram), vigia (religa sozinho) e mecânico (seu Claude, pela Ponte).

Quando usar a Ponte

O que a Ponte nunca vai fazer

Segurança O manual do mecânico trava regras de segurança: só acessa o SEU servidor, faz backup antes de mexer, nunca roda comando destrutivo, nunca mostra suas chaves e segredos, e pede seu OK antes de qualquer mudança grande. Se alguém te mandar um comando pra "colar no seu terminal", não cole: pergunta pra Ponte primeiro. Ela é o seu canal seguro.
← Voltar ao passo a passo