Como usar o Claude Code: guia prático para 2026

A resposta curta (julho de 2026): o Claude Code é a ferramenta de programação agêntica da Anthropic. Você instala com um comando, abre um terminal no seu projeto, digita claude e descreve o que quer em linguagem natural. Ele lê sua base de código, planeja uma abordagem, edita arquivos, roda comandos e testes, e pede sua permissão antes de mudar qualquer coisa. Você precisa de uma assinatura do Claude (o Pro, a $17/mês com cobrança anual, já inclui) ou de acesso à API com pagamento por uso. Transparência total sobre o nosso viés: o pipeline editorial desta publicação roda nele todos os dias, e é exatamente por isso que conseguimos dizer abaixo o que importa de verdade.

Última verificação: 10 de julho de 2026, com base na documentação oficial e nas páginas de preços da Anthropic.

O que é o Claude Code

A Anthropic descreve sem rodeios: "uma ferramenta de programação agêntica que lê sua base de código, edita arquivos, roda comandos e se integra às suas ferramentas de desenvolvimento". A palavra-chave é agêntica. Você dá uma tarefa como claude "write tests for the auth module, run them, and fix any failures" e ele trabalha em múltiplos arquivos, verificando os resultados pelo caminho, em vez de autocompletar uma linha por vez.

Ele roda em cinco lugares, todos com o mesmo motor, então suas configurações, a memória do projeto e as ferramentas conectadas funcionam em qualquer um deles:

• Terminal: a superfície completa. cd your-project && claude.
• Extensão para VS Code (instala no Cursor também): diffs inline, menções com @, revisão de planos.
• Plugin para JetBrains: IntelliJ, PyCharm, WebStorm; precisa da CLI instalada junto.
• App de desktop (macOS e Windows): revisão visual de diffs, sessões lado a lado, tarefas agendadas.
• Web em claude.ai/code: sessões na nuvem sem configuração local, que depois você puxa para o terminal com claude --teleport.

Instale (2 minutos)

macOS, Linux ou Windows WSL:

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

Windows PowerShell:

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

Homebrew (brew install --cask claude-code) e WinGet (winget install Anthropic.ClaudeCode) também funcionam, com uma ressalva da documentação: essas builds não se atualizam sozinhas, enquanto o instalador nativo sim. No Windows nativo, instale o Git para Windows para o Claude Code ter um Bash de verdade; sem isso, ele recorre ao PowerShell. Todas as opções estão na documentação oficial.

Quanto custa

Verificado em claude.com/pricing nesta semana:

Comece no Pro. Se você bater nos limites de uso com frequência, esse é o sinal para subir de plano, e o /usage dentro de uma sessão mostra exatamente onde você está em relação aos limites do seu plano.

Sua primeira sessão: o modelo de permissões

O que os novatos costumam ler errado é que o Claude Code é cauteloso por padrão, e isso é um recurso. De fábrica, ele tem "permissões estritas de somente leitura": pode ler arquivos e rodar comandos inofensivos como git status, e precisa pedir antes de editar qualquer arquivo ou rodar qualquer coisa que modifique o seu sistema. O acesso de escrita fica confinado à pasta de onde você o iniciou.

Uma boa primeira sessão em um projeto real:

1. Entre no projeto com cd e rode claude. A primeira execução em uma base de código abre um diálogo de confiança; isso é esperado.
2. Faça perguntas antes de pedir mudanças. "Como funciona a autenticação nesta base de código?" é o jeito mais rápido de ver como ele lê o seu código.
3. Pressione Shift+Tab para entrar no plan mode na primeira tarefa de verdade. O Claude explora e propõe uma abordagem sem tocar em nada; você aprova antes de ele editar.
4. Deixe que ele faça uma mudança pequena, revise o diff e use /rewind se quiser voltar atrás. Os checkpoints restauram tanto a conversa quanto o seu código.

Os oito recursos que importam

Depois do básico, estas são as capacidades que separam quem usa bem o Claude Code de quem só conversa com ele. Todas estão confirmadas na documentação atual.

1. CLAUDE.md, a memória do projeto. Um arquivo markdown na raiz do repositório que o Claude lê no início de cada sessão: comandos de build, convenções, coisas que ele nunca deve fazer. Mantenha abaixo de umas 200 linhas, conforme a própria orientação de custos da Anthropic. Esse único arquivo é o passo de configuração com maior retorno.
2. Plan mode. Tarefa complexa? Planeje primeiro, aprove, depois execute. A maioria dos maus resultados vem de pular essa etapa.
3. Fluxo de trabalho com Git. Ele prepara mudanças, escreve mensagens de commit, cria branches e abre PRs. Revisar um PR escrito por ele parece revisar o de um colega.
4. Slash commands e skills. Empacote um fluxo repetível uma vez, como /review-pr ou /deploy-staging, e o time inteiro pode compartilhar.
5. Servidores MCP. Conecte seu rastreador de issues, banco de dados ou ferramenta de design pelo Model Context Protocol, e o Claude passa a agir sobre eles. Escrevemos um passo a passo completo: como configurar servidores MCP.
6. Subagentes. Lance agentes em partes diferentes de uma tarefa, com um agente líder coordenando. Poderoso, e faminto: a Anthropic aponta que times de agentes consomem cerca de 7x os tokens de uma sessão normal.
7. Modo headless. claude -p "..." o transforma em uma ferramenta Unix encadeável: tail -200 app.log | claude -p "flag any anomalies" funciona em scripts e CI.
8. Tarefas agendadas. Rotinas rodam na infraestrutura da Anthropic de forma agendada, mesmo com a sua máquina desligada; o /schedule configura.

Mantendo a conta sob controle

Controlar custo é uma habilidade, e a documentação é refrescantemente direta sobre isso. Os hábitos que importam: rode /clear entre tarefas sem relação para o contexto não acumular, confira /context quando as sessões parecerem lentas, escolha o modelo conforme a tarefa em vez de sempre usar o maior, e defina um teto mensal com /usage-credits se estiver no Pro ou no Max. Note que o thinking não pode ser desativado ao rodar o Fable 5 no Claude Code; ele sempre usa raciocínio estendido, o que é parte do motivo de ele ser forte e parte do que você paga. Nosso guia do Claude Fable 5 cobre quando ele vale a pena.

Pegadinhas que valem conhecer antes que mordam

• Injeção de prompt é real. A documentação de segurança da Anthropic diz com todas as letras: "nenhum sistema é completamente imune". Revise os comandos sugeridos antes de aprovar e nunca despeje conteúdo não confiável da web direto numa sessão. curl e wget nunca são aprovados automaticamente por padrão exatamente por isso.
• Servidores MCP são decisões de confiança. Nas palavras da documentação: "Verifique se você confia em cada servidor antes de conectá-lo". A Anthropic revisa os conectores do diretório, mas não audita a segurança deles.
• Sessões ociosas continuam pingando tokens. A manutenção em segundo plano normalmente custa menos de $0.04 por sessão, mas não é zero. Feche as sessões que você já terminou.

FAQ

O Claude Code é só para desenvolvedores profissionais?
Não, e essa é a mudança silenciosa de 2026: o modelo de permissões, o plan mode e as tarefas em linguagem natural o tornam usável por não desenvolvedores com perfil técnico que automatizam trabalho de verdade. É a nossa escolha como porta de entrada para a IA agêntica em geral, e combina bem com nosso currículo gratuito de agentes de IA.

Claude Code vs Cursor vs Copilot?
Formatos diferentes: o Copilot autocompleta dentro do seu editor, o Cursor é um editor nascido para IA, o Claude Code é um agente que trabalha no repositório e na cadeia de ferramentas inteiros. Nossa comparação de assistentes de programação com IA vai mais fundo.

Qual modelo ele usa?
Você escolhe, por sessão ou por tarefa. A orientação da própria Anthropic: Sonnet para a maior parte do trabalho, os modelos maiores para os problemas difíceis. O Fable 5 está disponível no Claude Code desde a restauração de 1º de julho.

Funciona offline?
Não. Ele chama os modelos da Anthropic. A CLI e os seus arquivos são locais; a inteligência vem da nuvem.

O Claude Code lança recursos novos num ritmo que cobrimos quase toda semana; esta página é verificada de novo quando o produto muda. Para receber essas mudanças na hora, receba a AI Weekly de graça, 3 edições por semana, lidas por 40,000+ profissionais de IA. Mais contexto: nosso explicador do Claude e o feed de notícias da Anthropic ao vivo.