O Claude Code é a ferramenta de programação com IA da Anthropic. Segundo a documentação oficial, é um agente que lê o código de um projeto, edita arquivos, roda comandos e se integra às ferramentas de desenvolvimento. Ele funciona no terminal, em extensões para VS Code e JetBrains, em um aplicativo para computador e no navegador. Para quem empreende, o que o diferencia de um chat com IA é que ele faz o trabalho dentro do projeto: abre os arquivos, roda os testes, vê o resultado e corrige.

Este é o segundo de quatro textos da seção Testado sobre vibe coding. O primeiro explica o que é vibe coding e onde está o risco, e o último compara com a Lovable no qual escolher.

O que ele faz

A página oficial lista usos como escrever e rodar testes, corrigir erros de formatação em um projeto inteiro, resolver conflitos de versão, criar funcionalidades descritas em português, investigar bugs a partir de uma mensagem de erro e trabalhar direto com o git: preparar alterações, escrever mensagens de commit, criar branches e abrir pull requests. Também se conecta a outras ferramentas por meio do MCP, um padrão aberto para ligar IA a serviços como Google Drive, Jira ou Slack.

Há quatro recursos que importam para quem está começando:

  • CLAUDE.md: um arquivo na raiz do projeto que o Claude Code lê no início de toda sessão, com regras como padrões de código, comandos e cuidados do projeto. O guia oficial recomenda manter o arquivo curto, porque um arquivo longo demais faz o agente ignorar parte das regras.
  • Modo de planejamento: o agente lê e propõe um plano sem alterar nada, e só depois você aprova a execução.
  • Hooks: comandos que rodam sempre antes ou depois de uma ação, como formatar código a cada edição. Ao contrário do CLAUDE.md, que é um conselho, o hook é determinístico.
  • Subagentes: assistentes com contexto próprio, úteis para revisar o que foi feito por outro e evitar que a mesma sessão corrija o próprio trabalho.

Como instalar

Pela documentação oficial, no macOS, Linux e WSL o comando de instalação é curl -fsSL https://claude.ai/install.sh | bash. No Windows há comandos para PowerShell e CMD, e também há opções por Homebrew (brew install --cask claude-code) e WinGet. Depois, entra-se na pasta do projeto e roda-se claude. Na primeira vez, a ferramenta pede o login. A documentação traz um guia de terminal para quem nunca usou essa tela.

Quem não quer usar o terminal pode usar o aplicativo para computador (aba Code), que exige assinatura paga, ou o navegador, em claude.ai/code.

Quanto custa

Pela página de preços da Anthropic, o plano gratuito do Claude não inclui o Claude Code. Ele vem nos planos pagos:

PlanoPreço de tabelaClaude Code
ProUS$ 20 por mês (US$ 17 por mês no plano anual)Incluído
Maxa partir de US$ 100 por mês, em faixas de 5x e 20x o uso do ProIncluído

O uso do Claude Code sai do mesmo limite do chat do Claude, e a Anthropic não publica quantidades fixas de mensagens por plano, então quem usa muito pode bater no limite. Nos planos pagos, depois de atingir o limite, é possível ativar créditos de uso a preços de API. Também é possível usar uma chave de API em uma conta de desenvolvedor, caso em que o consumo é cobrado por token. Os valores são em dólar e podem mudar.

Regras que evitam erro

O guia oficial de boas práticas gira em torno de uma ideia: o contexto da conversa enche rápido, e o desempenho cai quando ele enche. A partir disso, as regras mais úteis para quem está começando:

  1. Dê ao agente uma forma de verificar o trabalho. Testes, build ou captura de tela. Sem isso, "parece pronto" é o único sinal.
  2. Explore, planeje e só então programe. Para mudanças que mexem em vários arquivos, use o modo de planejamento.
  3. Seja específico. Cite arquivos, restrições e exemplos do projeto.
  4. Limpe o contexto entre tarefas diferentes. Depois de duas correções sem sucesso, comece de novo com um pedido melhor.
  5. Revise antes de aprovar. A documentação de segurança diz que a responsabilidade de revisar o que o agente propõe é do usuário. Por padrão, em modo manual, ele começa só com permissão de leitura e pergunta antes de editar arquivos ou rodar comandos. Há ainda um isolamento (sandbox) opcional que restringe o acesso a arquivos e rede.

O que aprendemos construindo a PushTech

A Redação usou o Claude Code para construir e operar o site da PushTech, hospedado e publicado pela Lovable. Os registros do repositório mostram o que foi feito: 34 commits com a marca de coautoria do Claude, entre 21 e 24 de outubro, dezenas de matérias em arquivos Markdown, SEO (mapa do site, RSS, dados estruturados, versão em Markdown de cada matéria), login com Google e Apple, uma função de salvar matérias e 46 testes automáticos. Um dos ganhos mais concretos foi de velocidade: depois de o agente colocar em cache o carregamento do conteúdo, o tempo até a primeira resposta das páginas caiu de 1,4 a 1,9 segundo para 0,4 a 0,6 segundo.

O que funcionou:

  • Um arquivo de regras do projeto. O repositório tem um CLAUDE.md e um AGENTS.md que dizem como trabalhar com a Lovable: nunca reescrever o histórico do git, rodar verificação antes de cada envio e não editar arquivos gerados.
  • Verificação obrigatória. Antes de cada envio, rodam a checagem de tipos, o build e os testes. Foi essa rotina que fez o agente achar sozinho erros que de outro modo só apareceriam com o site no ar.
  • Pesquisa com fontes. Para cada matéria, o agente buscou fontes oficiais, descartou números que não conseguiu confirmar e registrou as correções em um campo de checagem.

O que deu errado:

  • Um envio com erro de tipos. Em 23 de outubro, os comandos de verificação foram encadeados de um jeito que não interrompia o envio quando um deles falhava, e o código foi para o repositório com erro de tipos. O problema foi notado em minutos e corrigido no commit seguinte. A regra passou a ser encadear só com "e" (&&), de modo que o envio acontece apenas se tudo passar. É a lacuna "confiar e verificar" que a própria documentação descreve.
  • Arquivos gerados que a outra ferramenta reescreve. O arquivo de tipos do banco é regenerado pela Lovable e apagou um trecho que o agente tinha acrescentado à mão. A solução foi não depender desse arquivo.
  • Fontes que bloqueiam leitura. Várias páginas oficiais barraram a leitura automática, e o agente teve de se basear em resumos de busca para alguns trechos, o que ficou declarado nos campos de checagem.

Isso é uma observação de uso, não um teste de produtividade: não comparamos o resultado com o de programadores nem medimos horas poupadas.

Para quem faz sentido

  • Quem quer controle do código: o Claude Code trabalha em um repositório seu, com testes, git e histórico.
  • Quem já tem um projeto e quer automatizar tarefas repetitivas, como testes, revisão e atualização de dependências.
  • Quem nunca abriu um terminal: a ferramenta tem versão para o aplicativo e o navegador, mas ainda exige noções de projeto, de git e de segurança. Se esse é o seu caso, vale ler o comparativo com a Lovable.

Como testamos

A Redação PushTech usou o Claude Code em uso real, na construção deste site. As observações vêm do histórico do projeto e de medições feitas pela Redação, e não de um teste padronizado. Este texto foi escrito com ajuda do próprio Claude Code, da Anthropic, e o site é publicado pela Lovable, o que o leitor deve levar em conta. Não declaramos relação comercial com a Anthropic.

Perguntas frequentes

O que é o Claude Code?

É um agente de programação da Anthropic que lê o código de um projeto, edita arquivos, roda comandos e trabalha com git. Funciona no terminal, no VS Code, no JetBrains, em aplicativo e no navegador.

Quanto custa o Claude Code?

Não há plano gratuito. Está incluído no Claude Pro (US$ 20 por mês, US$ 17 no anual) e no Max (a partir de US$ 100 por mês), pelos preços de tabela da Anthropic, em dólar.

Preciso saber programar para usar?

Não para começar, mas o agente muda arquivos do seu projeto. A documentação diz que revisar o que ele propõe é responsabilidade do usuário, e o uso fica mais seguro com testes e noções de git.

O que é o arquivo CLAUDE.md?

É um arquivo na raiz do projeto, lido no início de toda sessão, com regras como padrões de código e comandos. O guia oficial recomenda mantê-lo curto.

O Claude Code substitui um programador?

Esta matéria não mede isso. Ela relata o uso real em um projeto pequeno, em que a verificação e a revisão por uma pessoa continuaram necessárias.

Fontes