O que é o Claude Code e para que ele serve no dia a dia de quem programa?

Pedir código pra um chat e ter um agente que abre o teu projeto e mexe nos arquivos são duas coisas MUITO diferentes

No primeiro caso tu copia, cola, adapta e reza pra funcionar

No segundo, a ferramenta lê o que já existe, edita o arquivo certo e roda o comando pra conferir

O Claude Code é uma ferramenta de codificação agêntica da Anthropic: ele lê o codebase, edita arquivos, executa comandos e integra com as ferramentas de desenvolvimento que tu já usa

O repositório oficial é o anthropics/claude-code, e ele não vive só no terminal: roda também em extensões de IDE, em app de desktop e no navegador

Neste post eu explico o que ele faz de diferente, em que tipo de tarefa ele entra, o que tu precisa antes de instalar e fecho com um veredito honesto de pra quem isso vale e pra quem não vale

Bora? 😀

Claude Code x chat de IA: o que muda na prática

A comparação mais útil não é "qual modelo é mais inteligente", é quem executa a mudança no fim

Pré-inscrição Formação Claude Code

Domine o Claude Code do básico ao avançado

Você vai aprender a criar sistemas completos com Claude Code, sem precisar ser programador. Inscreva-se para ter acesso a um desconto de lançamento e bônus especiais!

Quero minha vaga

Repara na linha de permissão, porque ela é o coração da coisa

Por padrão ele pausa e pergunta antes de tocar em arquivo, rodar shell ou sair pra rede

Então não é "IA solta no teu projeto", é IA com pedágio em cada ação que importa

Para que serve o Claude Code no dia a dia de quem programa

Entender um codebase que você não escreveu:

Esse é o uso mais subestimado

Em vez de você abrir 20 arquivos pra mapear como uma parte do sistema funciona, o agente lê o codebase e te devolve o caminho

Se você conhece aquela sensação de entrar em projeto legado na segunda-feira, já sabe o valor disso 😛

Alterar arquivos em série:

Renomear um conceito que aparece em vários lugares, ajustar um padrão repetido, propagar uma mudança

É tarefa chata, mecânica, e é exatamente onde um agente que edita arquivos ganha do copia e cola

Rodar comando e conferir o resultado:

Como ele executa comandos, o ciclo fecha: mexeu, rodou, viu o retorno, ajustou

Um detalhe importante: um conjunto embutido de comandos Bash é tratado como somente leitura e roda sem prompt de permissão em qualquer modo

Ou seja, ele não te interrompe pra cada olhadinha, só pras ações que mudam alguma coisa

Planejar antes de mexer:

Esse é o modo que eu recomendo pra quem tá começando

O modo plano pesquisa e propõe sem alterar o código

Pra entrar nele, tu pressiona Shift+Tab ou prefixa um único prompt com /plan

Assim tu lê a proposta, discorda, corrige, e só depois libera a execução

E como boa parte do resultado depende de COMO tu pede, vale estudar técnicas de prompt no Claude Code antes de culpar a ferramenta

Automatizar rotina:

Hooks são comandos, endpoints HTTP ou prompts definidos por você que disparam em eventos do ciclo de vida da sessão, tipo edição de arquivo, chamada de ferramenta ou início de sessão

Dá pra pendurar teu lint, teu formatador, teu aviso, o que fizer sentido no teu fluxo

E como o agente ganha contexto?

Aqui entram os mecanismos de extensão, cada um com um papel bem separado:

• CLAUDE.md: contexto sempre ativo. Os arquivos do diretório atual e dos superiores carregam na abertura da sessão, e os de subpastas carregam conforme o trabalho avança
• Skills: conhecimento e fluxos sob demanda
• MCP: conexões externas
• Subagents: isolamento, definidos como arquivos markdown em .claude/agents/
• Hooks: automação

Tem também os slash commands, aqueles comandos iniciados com / que controlam a sessão

E tu pode criar os teus: comando customizado é definido como arquivo markdown

Sacou o padrão? Quase tudo aqui é arquivo de texto no teu repo, versionado igual código

O que você precisa antes de usar o Claude Code

Sistema:

macOS, Linux e Windows

Acesso:

O uso exige assinatura Claude ou conta do Console da Anthropic na maioria das superfícies

Custo:

A ferramenta está incluída nos planos Pro e Max, então dá pra usar pela assinatura, sem pagar API por token

O plano Pro custa US$ 20 por mês (preço dos EUA, varia por região e moeda local)

Os planos Max começam em US$ 100 por mês, em duas faixas: 5x e 20x o uso do Pro por sessão de 5 horas

Versão da ferramenta:

Esse ponto pega muita gente desprevenida

Pra usar os modelos mais recentes tem piso de versão: Opus 5 exige a v2.1.219 ou superior, e Sonnet 5 exige a v2.1.197 ou superior

Ele também roda em VS Code e JetBrains, no Slack e em CI/CD com GitHub Actions e GitLab, então a mesma ferramenta te acompanha do editor até o pipeline

Como instalar o Claude Code

1. Instalação nativa em macOS, Linux ou WSL

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

O erro comum aqui: tentar rodar esse comando no PowerShell do Windows. Não é o script certo pra esse terminal

2. Instalação no Windows, pelo PowerShell

irm https://claude.ai/install.ps1 | iex

O erro comum aqui é o inverso do anterior: colar essa linha no CMD ou no Git Bash e não entender por que nada acontece. Esse é do PowerShell

3. Alternativa via npm

npm install -g @anthropic-ai/claude-code

O pacote é o @anthropic-ai/claude-code, sob o escopo oficial da Anthropic. Se tu instalar por aqui, lembra que a atualização automática em background é característica das instalações NATIVAS

4. Deixa a atualização rolar

Instalações nativas se atualizam sozinhas em segundo plano

O erro comum deste passo: ficar preso numa versão antiga esperando modelo novo funcionar. Se o Opus 5 ou o Sonnet 5 não aparece pra ti, olha as versões mínimas que citei ali em cima antes de achar que é bug

5. Escolhe o modelo (ou não escolhe)

Sonnet é o modelo padrão e é indicado pra maior parte do trabalho de código, então tu pode simplesmente não mexer nisso

Se tu quiser planejamento mais forte, existe um modo que usa Opus na fase de planejamento e Sonnet na execução:

/model opusplan

Next, next e finish, basicamente 😀

O que aprendi usando o agente com documentação atualizada

Agora a parte que eu vi na prática

No vídeo abaixo eu uso ele como ferramenta principal da demonstração, e deixo claro que o mesmo caminho vale pra outras ferramentas de programação com IA que eu cito ali, não é exclusividade dele

O que eu fiz foi conectar um servidor MCP pela linha de comando, reiniciar a ferramenta e conferir a conexão por um comando dentro dela mesma, vendo o status sair de conectando pra conectado

Lembra do mecanismo de MCP que citei lá em cima? É isso: conexões externas

O teste que me convenceu foi de auditoria:

Peguei um projeto que já estava pronto e pedi pro agente verificar se as rotas protegidas estavam configuradas corretamente

A resposta veio rota por rota

Ele disse que estavam funcionando e ainda apontou dois pontos específicos: rotas de API fora do match do middleware e uma rota sem as subrotas cobertas na proteção

E não parou no problema, que é onde muita ferramenta te larga

Ele deu um parecer de risco, sugeriu uma verificação extra no middleware como camada defensiva e classificou o risco atual como baixo, porque as rotas de API já validavam autenticação individualmente

Na minha leitura, essa qualidade de resposta apareceu porque o agente estava consultando documentação atualizada

Com informação velha eu não acredito que ele chegasse nessa sugestão

Esse tipo de revisão em projeto já pronto virou hábito aqui: é jeito rápido de conferir se a configuração está correta

Documentação ao vivo ou arquivo local?

Depois eu instalei um arquivo de skill dentro do projeto

A partir dali o agente passa a ler esse arquivo local em vez de fazer a ida e volta a um servidor externo a cada prompt

E eu prefiro ser explícito no prompt, citando o nome da skill que quero usar, em vez de esperar que o agente decida sozinho carregar aquilo

Por que eu prefiro o arquivo local? Token é custo real do dia a dia

Consultar servidor externo a cada prompt gasta mais que ler um arquivo que já está no projeto, e se esse ponto te interessa vale ver como economizar tokens no Claude Code sem perder qualidade

Tome cuidado com a contrapartida, que é honesta: o arquivo local fica congelado no que foi gerado e só muda se tu pedir pra atualizar

É troca, não mágica

E o pano de fundo de tudo isso é aquele problema que todo mundo que cria projeto com IA conhece: biblioteca que muda muito, erro em sequência, retrabalho e mais consumo de token

No fim eu fecho o vídeo pedindo uma feature completa em linguagem natural, descrevendo página de contato, campos do formulário, processamento do envio, gravação no banco e estilização, e deixo o agente executar seguindo os padrões que defini antes

Revisão humana continua obrigatória, beleza? O agente propõe, aponta risco e executa, mas quem assina o merge é você

No vídeo tu vê a conexão do MCP passo a passo, a auditoria das rotas com a resposta completa do agente e a criação da feature nova seguindo o padrão que ficou salvo no projeto

Para quem o Claude Code faz sentido (e para quem não faz)

Veredito sem enrolação

Faz sentido se:

• Tu já vive no terminal: o CLI é uma das superfícies dele, e o fluxo casa com quem trabalha assim
• Tu mexe em projeto grande: ler o codebase e alterar arquivo em série é justamente onde o ganho aparece
• Tu quer execução, não só sugestão: se o que te trava é aplicar a mudança, um agente que edita e roda comando resolve outro problema que o chat não resolve
• Tu quer controle: as pausas de aprovação e os modos (manual, acceptEdits, plan e auto) deixam tu escolher o quanto de autonomia dar. Dá pra começar no modo plano, que nem altera código, e ir soltando a corda

Não faz sentido se:

• Tu só quer tirar dúvida pontual: pra "como faz um debounce em JS" um chat resolve, não precisa instalar agente nenhum
• Tu não pode dar acesso ao código: se a política da tua empresa não permite que a ferramenta leia o repositório, o principal diferencial dele morre na porta
• Tu não vai usar o suficiente pra justificar a assinatura: o acesso exige assinatura Claude ou conta do Console, e US$ 20 por mês no Pro só se paga se tu abrir a ferramenta com frequência

Se tu tá em cima do muro, o teste honesto é esse: pega uma tarefa chata e real que tu adiaria, e vê se ele te economiza tempo de verdade

Se economizou duas vezes na semana, tu já sabe a resposta 😉

Conclusão

O Claude Code é uma ferramenta de codificação agêntica da Anthropic que lê o codebase, edita arquivos, roda comandos e integra com as ferramentas de desenvolvimento, rodando no terminal, em extensões de IDE, no desktop e na web, em macOS, Linux e Windows

A diferença pro chat é essa: ele age no projeto, com aprovação pedida antes de editar arquivo, rodar shell ou fazer requisição de rede

O próximo passo concreto é simples: instala, abre num projeto pequeno e começa no modo plano (Shift+Tab ou /plan) antes de deixar o agente editar qualquer coisa

Quando tu confiar no que ele propõe, aí sim tu solta mais rédea…

Até o próximo post! 🙂