O que é Claude Code, como funciona e para quem vale a pena?

Fala aí, beleza? Um chat de IA te devolve um bloco de código pra você copiar, colar e rezar

Um agente abre o teu projeto, lê os arquivos, edita o que precisa ser editado, roda os comandos e te mostra o resultado

Parece uma diferença pequena na frase, mas é ENORME no dia a dia

Se você já ouviu falar do Claude Code umas mil vezes e nunca abriu o terminal com ele, esse post é pra ti: o que ele é de verdade, como o fluxo acontece na prática, quanto custa e o veredito honesto de quem ganha tempo com isso (e quem provavelmente nem precisa) 🙂

Claude Code não é autocomplete: a diferença entre sugerir e executar

O Claude Code é a ferramenta de codificação agêntica da Anthropic: ele lê a base de código, edita arquivos, roda comandos e se integra às ferramentas de desenvolvimento

E o que significa "agêntica" aqui? Que ele não fica só respondendo: ele é um agente de codificação que entende o projeto inteiro e trabalha em vários arquivos e ferramentas

Sacou a diferença? O autocomplete adivinha a tua próxima linha. O agente pega a tarefa e vai atrás dela pelo projeto todo

Se você conhece a diferença entre pedir uma dica pro colega do lado e passar a tarefa pra ele, é mais ou menos isso

E não para no código: ele integra com GitHub, GitLab e ferramentas de linha de comando, cobrindo o fluxo de ponta a ponta: ler issues, escrever código, rodar testes e enviar PRs

É por isso que o modelo mental de "chat que escreve função" não dá conta. O trabalho dele é o teu repositório, não a caixinha de texto

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 120 aulas
• 4 projetos
• 9h 45min

Conhecer formação

Onde o Claude Code roda: terminal, VS Code, JetBrains, desktop e web

Muita gente acha que Claude Code é sinônimo de terminal preto com letrinha piscando. Não é só isso

Ele roda em mais de uma superfície: terminal (CLI), VS Code e JetBrains, app desktop e web

Terminal (CLI):

A superfície principal e a mais direta: você entra na pasta do projeto, chama o claude e conversa ali mesmo, do lado dos teus comandos de sempre

É onde o agente fica mais perto do Git, dos testes e das ferramentas de linha de comando que você já usa

VS Code:

Se o teu dia é dentro do VS Code, a extensão é a forma recomendada de trabalhar por lá

Ela entrega interface gráfica nativa com revisão e edição de planos antes de você aceitar, auto-aceite de edições, @-mention de arquivos com intervalo de linhas, histórico de conversas e várias conversas em abas ou janelas

Poder editar o plano antes de aprovar é sutil e muda muito: você corrige o rumo ANTES do agente tocar em disco

JetBrains, desktop e web:

JetBrains e o app desktop também estão na lista de superfícies suportadas

A versão web tem endereço próprio e escopo limitado: você acessa em claude.ai/code ou pelo rótulo Code na barra lateral do app de chat, e ela é restrita a repositórios do GitHub

Então se o teu código está num GitLab ou só na tua máquina, web não é o teu caminho, beleza?

Como começar a usar o Claude Code passo a passo

Bora ver na prática? São cinco passos, e cada um tem um erro clássico que pega quem está começando

1. Instale o Claude Code na tua máquina. No macOS, Linux e WSL a instalação nativa é um comando só:

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

No Windows, pelo PowerShell:

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

Existem caminhos alternativos: Homebrew (casks claude-code e claude-code@latest), WinGet e o pacote npm oficial:

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

O erro comum deste passo: instalar por gerenciador de pacote e achar que está sempre na última versão. Homebrew, WinGet, apt, dnf e apk não atualizam sozinhos por padrão, enquanto a instalação nativa se atualiza em segundo plano

2. No Windows nativo, instale também o Git for Windows. Ele é recomendado pro agente poder usar a ferramenta Bash

O erro comum deste passo: pular ele e depois ficar tentando entender por que o agente não consegue rodar comando nenhum

3. Entre na pasta do projeto e rode o comando da CLI. O claude precisa ser executado no diretório do projeto:

cd caminho/do/seu/projeto
claude

Se quiser conferir o que instalou:

claude --version

O erro comum deste passo: chamar o claude de qualquer lugar e estranhar que ele não conhece o teu código. Contexto de projeto começa no diretório certo

4. Gere o CLAUDE.md com /init. Esse comando cria um CLAUDE.md inicial no projeto, e o /memory serve pra refinar o arquivo depois

O CLAUDE.md é um arquivo markdown na raiz do projeto, lido no começo de cada sessão. É a memória que sobrevive ao fechar o terminal

O erro comum deste passo: deixar o arquivo exatamente como o /init gerou e nunca voltar nele. O CLAUDE.md é documento vivo, não certidão de nascimento

5. Ajuste /permissions e, se o projeto pedir, /mcp. O /permissions define as regras de aprovação e o /mcp configura os servidores MCP do projeto

O erro comum deste passo: sair aprovando tudo no automático na primeira sessão. Regra de aprovação existe justamente pros rm -rf da vida não acontecerem no teu repo

Como funciona o fluxo de trabalho na prática

O ciclo real é mais tranquilo do que parece de fora

Você abre a sessão e o agente já lê o CLAUDE.md da raiz do projeto. Convenções, stack, jeito de rodar os testes: tudo isso entra antes da tua primeira frase

Aí, antes de deixar ele editar qualquer coisa, tu manda /plan

O plan mode é a melhor parte pra quem está começando: o Claude lê os arquivos e propõe um plano, sem nenhuma edição até você aprovar

Leu o plano, achou torto? Corrige o pedido e pede de novo. Nada foi escrito em disco ainda

Aprovado, ele executa: edita os arquivos, roda os comandos, volta com o resultado

Durante a sessão, dois comandos te salvam de encher a janela de contexto de coisa inútil: /context mostra o que está ocupando espaço e /compact resume pra liberar

E tem o ajuste fino: /model e /effort mudam o modelo e o nível de raciocínio conforme o tamanho do problema

Não adianta o fluxo estar redondo se o pedido for vago, viu? Metade do resultado vem do jeito que você escreve a tarefa, e sobre isso vale ver umas técnicas de prompt no Claude Code antes de sair mandando "arruma aí"

Fechando o ciclo: como ele integra com GitHub, GitLab e ferramentas de linha de comando, dá pra ir de ler a issue até escrever o código, rodar os testes e enviar o PR sem sair do fluxo

O que muda quando o agente trabalha sozinho até terminar

Tem um pulo de categoria que acontece quando você para de acompanhar cada passo e deixa o agente ir até o fim da tarefa

No vídeo abaixo eu mostro isso rodando dentro de um projeto que já estava em andamento

Antes de conseguir usar o recurso, precisei atualizar a instalação na minha máquina, e mostrei a atualização acontecendo ali no terminal

O funcionamento é de slash command: você descreve o que quer, define qual é o estado final e como o agente pode comprovar que chegou lá

Na minha experiência, as restrições (o que o agente NÃO pode fazer) são opcionais. O mínimo obrigatório pra coisa funcionar bem é o estado final e a forma de comprovação

E tem um conjunto de subcomandos pra gerenciar a execução: listar o que está rodando, pausar, retomar, cancelar e marcar como concluído

Quando testei, deixei duas tarefas rodando ao mesmo tempo na tela e elas avançavam em paralelo enquanto eu seguia mexendo no projeto

Tarefa simples termina numa única interação e o agente encerra sozinho, já gerando os arquivos finais

Onde isso brilha de verdade? Tarefa repetitiva com critério claro de parada. O exemplo mais óbvio: rodar e corrigir funções até passar em todos os testes

Onde exige supervisão? Quando o resultado bloqueia a continuidade do trabalho ou o "pronto" é subjetivo. Se você não consegue escrever como o agente comprova que terminou, ainda não é caso de delegar

Eu estudei o recurso pela documentação oficial e recomendo fazer o mesmo pra ver parâmetros, usos indicados e limitações antes de apostar nele

Ah, e nesse vídeo eu estava testando um setup de gravação remoto: se puder deixar feedback de áudio e imagem nos comentários, me ajuda demais =)

Personalização: CLAUDE.md, skills, hooks e plugins

Aqui é onde o uso casual vira uso sério

Ele lê configurações e extensões a partir de diretórios .claude: o .claude do projeto e o ~/.claude do teu diretório home

O que vive ali? CLAUDE.md, settings.json, hooks, skills, comandos, subagents, workflows, rules e memória automática. Skills de projeto ficam em .claude/skills/

A lógica é simples: projeto guarda o que é do projeto, home guarda o que é teu em qualquer projeto

Os hooks são o pedaço mais subestimado: eles rodam script, requisição HTTP, chamada de ferramenta MCP, prompt ou subagente quando o agente chega a um evento do ciclo de vida

Traduzindo: dá pra amarrar comportamento obrigatório em momentos específicos, em vez de pedir por favor no prompt e cruzar os dedos

E os plugins? São a camada de empacotamento: uma unidade instalável que agrupa skills, hooks, subagents e servidores MCP

Ou seja, aquele setup que você levou semanas ajustando pode virar um pacote e ser instalado pelo time todo

Quanto custa o Claude Code: Pro, Max, Team e API

Primeiro o aviso que economiza a tua tarde: o plano gratuito do Claude não dá acesso ao Claude Code

Ele exige assinatura paga, seja Pro ou Max pra pessoa física, seja Team ou Enterprise pra organização

Preço de app móvel pode variar em relação à assinatura web, então confere antes de assinar pelo celular

Pra ter uma referência em real: usando o dólar à vista de 14/09/2026, a R$ 5,16, os US$ 20 do Pro ficam em torno de R$ 103 por mês

E como funcionam os limites? Existe um limite por sessão que reseta a cada 5 horas, mais um limite semanal que vale pra todos os modelos, tanto no Pro quanto no Max

O limite semanal reseta num horário fixo atribuído à tua conta, não no domingo genérico da internet

Bateu o teto e travou tudo? Nem sempre: os créditos de uso permitem que assinantes Pro, Max 5x e Max 20x continuem em preço por consumo, a taxas padrão de API, em vez de ficarem bloqueados

E tem o caminho de API: com uma API key definida como variável de ambiente, o uso passa a ser cobrado por pay-as-you-go a taxas padrão de API, na conta de API ligada àquela chave

Tome cuidado com isso! Se você deixou uma chave exportada no teu shell e esqueceu, a conta não vai cair na assinatura, vai cair na API 😛

Sonnet, Opus ou Haiku: qual modelo usar em cada caso

Escolher modelo no Claude Code não é frescura: é a diferença entre o teu limite durar a semana ou acabar na terça

Pra trabalho agêntico complexo de código e cenário corporativo, o modelo recomendado hoje é o Claude Opus 5

Agora o custo relativo, que é o que ninguém olha antes de reclamar: o Opus custa várias vezes mais por turno que o Sonnet, e o Sonnet mais que o Haiku

Usar Opus em trabalho de rotina é a forma mais rápida de esgotar o teu limite. Já viu?

E a boa notícia: dá pra trocar de modelo no meio da sessão sem perder a conversa

Por isso um padrão comum é planejar com Opus e executar com Sonnet: cabeça grande pra decidir o caminho, cabeça econômica pra fazer o caminho 😀

Para quem o Claude Code vale a pena (e para quem não vale)

Veredito honesto, dos dois lados

Ganha tempo de verdade:

Quem trabalha em base de código existente, com vários arquivos, e passa mais tempo entendendo o projeto do que digitando

Quem vive no terminal e no Git, porque é ali que o agente está mais em casa

Quem repete o mesmo fluxo de issue até PR toda semana, já que o ciclo de ler issue, escrever código, rodar teste e enviar PR está coberto de ponta a ponta

Time que quer padronizar contexto e comportamento, usando CLAUDE.md, hooks e plugins pra todo mundo trabalhar do mesmo jeito

E quem tem tarefa longa, com objetivo claro e critério de parada, que pode rodar em paralelo sem supervisão enquanto você segue no projeto

Provavelmente não precisa (ainda):

Quem está começando a programar e precisa entender cada linha que escreve. Agente rápido demais atrapalha aprendizado, e dá pra ver esse debate com mais calma na discussão sobre Claude Code para não programadores

Quem escreve scripts curtos e isolados, onde o ganho de entender "o projeto inteiro" simplesmente não existe

Quem não tem projeto versionado, porque metade da graça é o agente mexer com rede de segurança embaixo

E quem não vai usar o suficiente pra justificar a assinatura, já que não existe plano gratuito com acesso. Aqui a conta é fria: se você abre o editor uma vez por mês, não vale

Conclusão

O Claude Code não é um chat que sugere código: é um agente que entende o projeto inteiro, edita arquivos, roda comandos e vai até o PR

Ele roda no terminal, no VS Code e JetBrains, no desktop e na web (essa última restrita a repositórios do GitHub), exige plano pago e recompensa muito mais quem trabalha em projeto existente e versionado do que quem mexe em script solto

Seu próximo passo é bem concreto: instala, entra na pasta de um projeto REAL que você já conhece bem, roda o claude, gera o CLAUDE.md com /init e começa tudo em /plan antes de deixar o agente editar qualquer coisa

Começar por um projeto que você conhece é o que te dá condição de julgar se o plano dele presta ou não, e isso é a habilidade mais importante nesse jogo

Vou seguir trazendo os testes e os comandos novos por aqui, então fica de olho nos próximos conteúdos do blog

até o próximo post! 🙂