Apresentação de Claude Code
Claude Code é o agente de programação de linha de comando da Anthropic. Executado dentro da pasta de um projeto, ele lê o código, sugere alterações, roda comandos (testes, build, git) e pede a sua autorização antes de qualquer ação sensível. É voltado a desenvolvedores e pequenas equipes que querem uma estação de trabalho remota, sempre ligada, acessível por SSH a partir de qualquer máquina.
Na entrega, o binário claude fica instalado para todos os usuários em /usr/bin/claude, a partir do repositório APT oficial (canal stable). A chave de assinatura é conferida pela impressão digital antes de ser aceita, e nenhum script remoto é executado às cegas. Os pacotes git e tmux são adicionados como complemento.
Nada vem autenticado na entrega, e isso é intencional: nenhuma chave de API é colocada na configuração do servidor. Você mesmo faz o login, com a sua conta Anthropic ou com a sua chave, depois de entrar na máquina. A instalação registra o seu andamento em /var/log/claude-code-install.log.
O que pode fazer com Claude Code
Instalação no sistema via APT assinado
O pacote
claude-codevem do repositório oficial da Anthropic, canal stable, e é instalado em/usr/bin/claude. Fica disponível para todas as contas do servidor, sem depender de uma pasta pessoal.Chave GPG conferida por impressão digital
A chave de assinatura é baixada e comparada com a impressão digital esperada antes de ser gravada em
/etc/apt/keyrings/claude-code.asc. Se a impressão digital for diferente, a instalação é interrompida.Agente de programação no terminal
O Claude Code explora o seu repositório, edita arquivos e executa comandos a partir do shell. Você mantém o controle graças aos pedidos de autorização.
git e tmux já instalados
As duas ferramentas vêm junto com o agente. Com o tmux, a sessão de trabalho continua ativa mesmo que a conexão SSH caia.
Atualizações controladas pelo APT
O repositório está declarado em
/etc/apt/sources.list.d/claude-code.list. A atualização é feita comsudo apt update && sudo apt upgrade claude-code, na hora que você escolher.Autenticação por sua conta
Nenhum segredo fica nos dados de provisionamento. Você usa o login pelo navegador do
claudeou a variávelANTHROPIC_API_KEY.
Começar com Claude Code
Da encomenda à produção em poucos minutos.
- 1
Peça o VPS com Claude Code
Escolha um VPS Linux (Paris ou Frankfurt) com Debian 12, Debian 13, Ubuntu 20.04, 22.04 ou 24.04 e marque Claude Code na aba Applications. Reserve 4 GB de RAM: a instalação emite um aviso abaixo de 3,5 GB.
- 2
Conecte-se e verifique a instalação
Com o servidor entregue, abra uma sessão SSH. O arquivo marcador confirma que a instalação terminou, e o log detalha cada etapa em caso de dúvida.
Bashssh USER@SERVER_IP ls /var/lib/claude-code-install.done claude --version tail -n 20 /var/log/claude-code-install.log - 3
Autentique-se e abra um projeto
Vá até a pasta do seu projeto e execute
claude. Siga o login pelo navegador que ele propõe ou, se preferir usar a API, exporte a chave na sessão.Bashmkdir -p ~/projet && cd ~/projet && git init claude - 4
Proteja o servidor antes do uso real
Trabalhe com um usuário que não seja root, acesse por chave SSH e limite as portas abertas. O Claude Code não expõe nenhum serviço web, então não há domínio nem HTTPS para configurar. Mantenha os repositórios enviados a um remote git, que serve de backup do código.
Bashadduser dev && usermod -aG sudo dev apt install -y ufw ufw allow OpenSSH && ufw enable
Casos de uso de Claude Code
Estação de desenvolvimento remota sempre ativa
Você acessa por SSH a partir de um notebook leve ou de um tablet e reencontra o mesmo ambiente, com seus repositórios e as sessões tmux em andamento.
Refatoração e revisão de código
Peça ao agente que analise um repositório, renomeie uma API interna em vários arquivos ou corrija testes que falham, e revise o diff antes de confirmar.
Scripts e tarefas de administração
Em um servidor que você controla, o agente ajuda a escrever scripts shell, arquivos de configuração ou playbooks, testando os comandos no mesmo terminal.
Sessões longas que sobrevivem à desconexão
Execute
claudedentro do tmux para uma tarefa demorada, desanexe a sessão, feche o notebook e retome depois comtmux attach.
Perguntas frequentes sobre Claude Code
Sim. A instalação entrega apenas o programa, sem autenticação. Depois de entrar por SSH, execute claude para fazer login com a sua conta ou exporte a chave em ANTHROPIC_API_KEY. O acesso ao Claude é responsabilidade da Anthropic, não da Infrawire.
Mais sobre Claude Code
Verificar o que a instalação fez
Três pontos permitem conferir o estado do servidor: o log /var/log/claude-code-install.log, o marcador /var/lib/claude-code-install.done (criado somente se tudo deu certo) e o comando claude --version. Se o marcador não existir, leia o final do log: ele indica a linha e a causa da falha, por exemplo um repositório de terceiros quebrado ou uma rede inacessível.
Autenticar sem expor segredos
Nunca copie uma chave de API para os dados de provisionamento de um servidor: eles continuam legíveis pelo serviço de metadados. Prefira entrar depois da entrega com claude ou exportar a chave na sessão:
Bashexport ANTHROPIC_API_KEY="VOTRE_CLE"
Para torná-la persistente, guarde-a em um gerenciador de segredos ou em um arquivo legível apenas pelo seu usuário (chmod 600), e não em um arquivo compartilhado.
Atualizar o Claude Code
O repositório APT aponta para o canal stable. As atualizações seguem o fluxo de qualquer pacote, o que evita surpresas no meio de uma sessão de trabalho:
Bashsudo apt update && sudo apt upgrade claude-code
Trabalhar com tmux
Inicie uma sessão nomeada antes de abrir o agente, por exemplo tmux new -s code, e depois claude. Desanexe com Ctrl+b e depois d, e retome com tmux attach -t code. Para tarefas mais pesadas, considere um VPS mais robusto entre os nossos VPS Linux.
