Claude Code na prática: como configurar e usar em 2026

Claude Code é a ferramenta de linha de comando da Anthropic que roda no seu terminal, lê o repositório inteiro e executa tarefas de código sozinha. Instalar leva dois comandos, e o que separa quem aproveita de quem desiste em vinte minutos vem depois: o arquivo CLAUDE.md, o jeito de pedir e a leitura do diff. Este guia é o passo a passo de configuração que eu uso, com Windows, VS Code e a primeira tarefa rodando.

A maioria dos tutoriais em português foi escrita quando o produto era outro, e por isso a instalação da tela não bate com a do vídeo. A ferramenta evolui toda semana, então eu escrevi este post para envelhecer devagar. Pouco comando decorado, muito critério para você saber o que conferir na fonte oficial quando algo mudar. A visão completa, com preço, limite e a comparação com Codex e Cursor, está no guia completo de Claude Code em português. Aqui fica só a parte de configurar e usar.

O que é o Claude Code e em que ele é diferente de um chat de IA?

Claude Code é um agente, não um chat. No chat do navegador você cola o trecho de código, explica a estrutura do projeto e descreve as dependências, e o modelo responde com um texto que você precisa aplicar na mão. No terminal, o agente abre os arquivos que precisa, entende o contexto sozinho, roda o comando de teste e lê a saída. Ele edita o que tem que editar, e você só descreve o problema e lê o resultado.

Ele funciona com qualquer editor, tem extensão para VS Code e JetBrains para quem prefere abrir de dentro da IDE, e o fluxo principal continua sendo o terminal. O mesmo login serve para o terminal, para a extensão, para a versão web e para a de desktop, porque tudo sai da mesma assinatura. Não é plugin de autocompletar. Ele recebe uma tarefa inteira e vai executando passo a passo, chamando ferramenta atrás de ferramenta, até considerar que terminou.

Como instalar o Claude Code no Windows, no Mac e no Linux?

O requisito é ter o Node.js na versão 18 ou mais nova, e a pegadinha número um no Windows é Node velho instalado por algum projeto antigo. Confere com node -v antes de qualquer coisa. Com o Node em dia, a instalação é um comando só, npm install -g @anthropic-ai/claude-code, e depois você entra na pasta do projeto e digita claude. No Windows eu uso pelo PowerShell e pelo Git Bash, os dois funcionam, e o WSL é opção para quem já vive nele.

No primeiro claude, a ferramenta pede login e abre o navegador. Escolhe "Log in with Claude" se você tem assinatura Pro ou Max, que é o caminho de quase todo mundo, porque o Claude Code não existe no plano gratuito. Chave de API é a outra porta, paga por token, pensada para automação e para empresa com acesso restrito. Para quem está aprendendo, ela vira fatura imprevisível. A partir do login você conversa com a ferramenta em português, sem configurar idioma.

Como funciona o fluxo de trabalho no dia a dia?

Você abre o terminal dentro do diretório do projeto, inicia o Claude Code e entra num modo interativo onde descreve em linguagem natural o que precisa. No meu uso, o ganho de tempo é mais real em cinco situações. Entrar num repositório desconhecido e entender a arquitetura sem ler arquivo por arquivo. Escrever teste para código que já existe. Refatoração mecânica em vários arquivos. Criar o esqueleto de um módulo novo. E revisar um trecho procurando falha de segurança ou desvio do padrão do projeto.

Para tarefa que mexe em mais de três arquivos, eu uso o modo de planejamento antes de executar: ele explora o código, propõe o caminho e só faz depois que eu aprovo. Isso evita o retrabalho de descobrir no fim que a direção estava errada. E quando o agente precisa enxergar além dos arquivos, o que resolve é o MCP no Claude Code. Ele conecta banco, API e serviço externo como ferramenta, para o agente consultar o dado real em vez de supor.

Por que o CLAUDE.md é o detalhe que muda tudo?

O CLAUDE.md na raiz do projeto é o briefing permanente do agente, carregado em toda sessão. Nele você escreve a stack, como rodar o projeto, como rodar o teste, as convenções de nome e o que ele nunca pode tocar. Sem esse arquivo o Claude Code faz suposições razoáveis e genéricas, e diferentes a cada sessão. Você passa o dia corrigindo a mesma inconsistência. Com um CLAUDE.md curto e certo, cada sessão começa com o contexto correto.

O investimento é de quinze minutos e o retorno é diário. A documentação de memória da Anthropic recomenda manter o arquivo abaixo de duzentas linhas. Instrução específica de um tipo de trabalho vai para skills, que só carregam quando a tarefa pede. Eu sigo isso à risca: o meu CLAUDE.md tem o essencial e o resto vive em skills, e é por isso que o resultado sai parecido entre projetos diferentes.

Onde o Claude Code ainda tropeça?

Em projeto muito grande, com muita dependência interna cruzada, a qualidade cai. Quanto mais contexto o projeto exige, mais chance de ele propor algo que funciona isolado e quebra ao integrar. Não é raro, e a resposta é ler o diff com cuidado antes de aceitar. Nas primeiras semanas isso é ainda mais importante, porque é quando você aprende o tipo de erro que o agente comete no seu código.

Para debug de erro muito específico de ambiente, ele chega na resposta mais devagar do que um sênior que já viu o mesmo problema. Comportamento que depende de versão de biblioteca, ou que só aparece em produção, é onde isso mais acontece. A vantagem da ferramenta está em velocidade de execução de tarefa clara, não em diagnóstico de problema obscuro. E em decisão de arquitetura de alto nível a sugestão tende a ser genérica: use o agente para executar uma direção que você definiu, não para definir a direção.

Qual plano faz sentido para cada perfil?

Para desenvolvedor individual que usa o agente ao longo do dia, a assinatura Pro resolve na maior parte dos casos. O degrau Max só passa a fazer sentido quando você encosta no limite toda semana. O uso do Claude Code e do chat sai da mesma cota, que renova numa janela de cinco horas e tem um teto semanal. O comando /usage vira parte da rotina. Para equipe ou para automação que roda sozinha, a API por token costuma ser mais previsível. Você mede custo por execução.

Os valores mudam várias vezes por ano, e é por isso que eu não coloco preço neste post. A tabela de preço e limite, com a data em que cada número foi conferido, fica no guia completo. Eu atualizo quando algo muda. A conta que vale fazer é comparar o custo da assinatura com o tempo que você gasta em trabalho mecânico que o agente faria. Para quem usa ativamente, o retorno aparece nas primeiras semanas.

Como não ficar preso em tutorial desatualizado?

A ferramenta evolui rápido. O que estava documentado seis meses atrás pode não refletir a instalação de hoje, os comandos que existem ou como a cobrança está organizada. Três fontes ficam atualizadas. A documentação oficial da Anthropic, que anda junto com o produto. A própria CLI, que tem ajuda integrada. E o repositório no GitHub, onde as notas de versão mostram o que mudou. Para configuração, autenticação ou comportamento que não bate com o tutorial, a fonte certa é sempre a oficial.

Qualquer artigo, este incluído, pode ficar velho em algum detalhe técnico. Por isso eu prefiro te ensinar a conferir do que te dar comando decorado. O critério que eu uso é simples: se um passo depende de tela, menu ou preço, vai na documentação antes de seguir o vídeo. Se depende de método, o CLAUDE.md, o modo de planejamento, a leitura do diff, isso não muda com versão. É o que este post tenta fixar.

Quais são as dúvidas mais comuns de quem está começando?

O Claude Code não funciona sem internet, porque o processamento acontece nos servidores da Anthropic. O CLAUDE.md e os arquivos ficam locais, mas cada pedido ao modelo exige conexão. Sobre o código que você compartilha, quem define o tratamento é a política de privacidade da Anthropic. Para projeto com código proprietário sensível, vale ler as configurações de privacidade antes de usar. O post sobre LGPD em agentes de IA cobre o lado do dado pessoal.

Comparado ao Cursor e ao Copilot, depende do fluxo. O Cursor é editor completo com IA, e o Copilot é sugestão em tempo real enquanto você digita. O Claude Code é agente de terminal, com acesso amplo ao repositório e capacidade de executar tarefa longa. Eu aprofundo essa comparação em Cursor vs Claude Code. E sobre saber programar: para começar não precisa. Para sustentar o que você criou, precisa aprender a ler o código que o agente escreve, uma mudança de cada vez.

Por onde começar hoje?

Instala, abre num projeto que você já conhece bem e testa as tarefas mecânicas que você normalmente adia: escrever teste, renomear em vários arquivos, documentar um módulo. Em um ou dois dias de uso real você sabe se faz sentido para o seu fluxo. Quase sempre faz. O caminho depois disso é transformar o uso em processo, com especificação que o agente executa e dois agentes se revisando. É o que eu mostro em como construir um SaaS com Claude Code e Codex.

Se você quer o mapa inteiro antes de instalar, o guia completo que eu linkei no começo deste post junta tudo numa página só. O que ele é, o que dá para fazer de graça, quanto custa hoje e como se compara ao Codex e ao Cursor, com data em cada número. Este post continua sendo o lugar do passo a passo de configuração. É para cá que o guia manda quem chegou na hora de instalar.