Claude Code é o agente de codificação baseado em terminal da Anthropic. Você digita o que quer em inglês simples, e ele lê seu codebase, escreve código, executa comandos, corrige erros e faz commits de mudanças — tudo do seu terminal. Sem plugins de IDE. Sem abas de navegador. Apenas você e a IA em uma janela de terminal.
Diferente do Cursor (que funciona dentro de um IDE) ou Codex (que funciona na nuvem), Claude Code roda localmente no seu ambiente de desenvolvimento real. Ele vê seus arquivos, seu histórico do git e a saída do terminal. Isso o torna mais rápido para muitos fluxos de trabalho porque não há troca de contexto entre a IA e seu código.
Este guia cobre instalação, seu primeiro projeto, os comandos principais e o fluxo de trabalho que faz o Claude Code funcionar perfeitamente.
| Ferramenta | Melhor para | Onde roda | Fluxo de trabalho |
|---|---|---|---|
| Claude Code | Codificação agentiva interativa | Terminal local | Você guia + ele executa passos ao vivo |
| Cursor | Codificação diária + edições inline | Dentro do IDE | Diffs visíveis + autocompletar |
| Codex | Tarefas delegadas assíncronas | Sandbox na nuvem | Enviar tarefa → revisar PR depois |
Como Instalar o Claude Code
Você precisa do Node.js 18+ e uma conta Claude (Pro ou API).
Etapa 1: Instale globalmente via npm:
npm install -g @anthropic-ai/claude-code
Etapa 2: Navegue até o diretório do seu projeto:
cd your-project
Etapa 3: Execute o Claude Code:
claude
Na primeira vez que você executá-lo, ele pedirá que você autentique com sua conta Anthropic. Se você estiver usando Claude Pro ($20/mês), você obtém uma generosa cota de tokens. Se estiver no API, você pagará por token (verifique as taxas atuais em nosso guia de limites de taxa).
Estimativa de custo (para você não se surpreender)
Se você estiver no faturamento por API, uma sessão típica de 30–60 minutos em um repositório médio custa frequentemente $2–$10, dependendo do modelo + contagem de iterações. Use /cost regularmente e verifique sessões longas com o Vibe Coding Cost Calculator.
Seus Primeiros 5 Minutos com Claude Code
Uma vez que o Claude Code esteja rodando, você está em uma sessão interativa. A IA tem acesso ao seu diretório de projeto inteiro. Comece simples:
Peça para ele explorar: Digite "O que é este projeto? Me dê uma visão geral de alto nível." O Claude lê seus arquivos principais (package.json, README, pontos de entrada principais) e resume o que encontra. Essa é uma boa maneira de verificar se ele entende a estrutura do seu projeto.
Peça para ele encontrar algo: "Onde está a lógica de autenticação?" O Claude pesquisa seu codebase e aponta os arquivos relevantes. Ele entende a estrutura do código, não apenas correspondência de texto.
Peça para ele alterar algo: "Adicione validação de entrada ao formulário de signup. Email deve ser um formato válido, senha mínima 8 caracteres." O Claude identifica o componente do formulário, escreve a lógica de validação e mostra o diff antes de aplicar.
A percepção principal: o Claude Code opera nos seus arquivos reais. Quando ele faz uma alteração, a mudança é real — seus arquivos são modificados no disco. Você pode ver as mudanças no seu editor, executar testes e commitá-los normalmente.
Comandos Essenciais
Claude Code possui vários comandos com barra que controlam seu comportamento:
| Comando | O que faz | Quando usar |
|---|---|---|
/init | Cria um arquivo CLAUDE.md na raiz do seu projeto | Antes da sua primeira tarefa séria em um repositório |
/compact | Comprime o histórico da conversa perto dos limites de contexto | Sessões longas; antes da qualidade cair |
/cost | Mostra tokens usados + custo estimado | Cobrança de API, rastreamento de orçamento |
/clear | Redefine a conversa mantendo o contexto | Alternando entre tarefas não relacionadas |
Está obtendo valor disso? Publicamos guias semanais sobre ferramentas e fluxos de trabalho de codificação com IA. Receba-os no seu inbox →
O Arquivo CLAUDE.md — O Contexto de IA do Seu Projeto
O arquivo CLAUDE.md é a coisa mais importante no seu fluxo de trabalho com Claude Code. É um arquivo markdown na raiz do seu projeto que o Claude lê no início de cada sessão. Pense nele como instruções personalizadas para o seu codebase.
Um bom CLAUDE.md inclui:
Visão geral do projeto: O que o projeto faz, a pilha tecnológica e a arquitetura em 3-5 frases.
Convenções de código: Suas preferências de formatação, convenções de nomenclatura e padrões a seguir. "Use componentes funcionais com hooks. Prefira exportações nomeadas. Use Tailwind para estilização."
Arquivos principais: Aponte o Claude para os arquivos mais importantes que ele deve entender. "Os principais modelos de dados estão em lib/models/. As rotas da API estão em app/api/."
Coisas a evitar: "Não modifique os arquivos de migração do banco de dados. Não altere nada em vendor/. Sempre execute testes após modificar arquivos api/."
Sem o CLAUDE.md, o Claude Code produz código genérico que pode não combinar com o estilo do seu projeto. Com ele, a saída parece código escrito por alguém que está na equipe há meses. Isso é engenharia de contexto na prática.
Fluxo de Trabalho Real: Construindo uma Funcionalidade
Aqui está como eu uso o Claude Code para uma sessão típica de desenvolvimento de funcionalidade:
1. Comece com o objetivo: "Adicione um limitador de taxa à API. Use Redis. Aplique ao endpoint /api/submit com limite de 10 requisições por minuto por IP."
2. Deixe o Claude planejar: Ele lê o código da API existente, verifica se o Redis já está configurado e propõe uma abordagem. Revise o plano antes de ele começar a codificar.
3. Assista ele trabalhar: O Claude cria o módulo de limitador de taxa, integra à rota da API, adiciona variáveis de ambiente para conexão Redis e escreve um teste.
4. Teste: O Claude executa os testes. Se algo falhar, ele lê o erro, ajusta o código e tenta novamente. Esse loop de iteração é onde os agentes brilham — ele lida com o ciclo de depuração que normalmente leva várias rodadas de trabalho manual.
5. Revise e commit: Verifique o diff. Faça ajustes. Commit. O Claude pode escrever a mensagem de commit também se você pedir.
Para uma funcionalidade como essa, o Claude Code tipicamente economiza 60-70% do tempo comparado a escrevê-la manualmente. A economia real está no boilerplate, no código de integração e na escrita de testes — as partes tediosas, mas não intelectualmente desafiadoras.
Gerenciando o Uso de Tokens
O Claude Code usa tokens para cada interação. Sessões longas em codebases grandes podem ficar caras no faturamento da API. Aqui estão os hábitos que mantêm os custos razoáveis:
Use /compact regularmente. Não espere até o contexto estar cheio. Compacte após completar cada tarefa distinta.
Seja específico. "Corrija o bug no formulário de login" é mais barato que "Olhe toda a aplicação e encontre bugs." Pedidos específicos significam menos leitura de código.
Use /clear entre tarefas não relacionadas. Se você estava trabalhando no frontend e muda para migrações de banco, limpe o contexto. O contexto antigo desperdiça tokens e pode confundir o modelo.
Verifique /cost frequentemente. Defina um orçamento mental para cada sessão e verifique contra ele. Uma sessão típica de 30 minutos para uma funcionalidade custa $2-8 no faturamento da API.
Para uma comparação detalhada de custos entre Claude Code e Cursor, veja nossa comparação real de custos após 30 dias.
Claude Code vs Cursor vs Codex
Guia rápido de decisão:
| Opção | Melhor quando... | Concessão |
|---|---|---|
| Claude Code | Você quer alterações interativas em todo o repositório localmente | Precisa de revisão cuidadosa (ele edita arquivos reais) |
| Cursor | Você quer IA dentro do seu IDE + ciclo de edição apertado | Menos autonomia hands-off que agentes de terminal |
| Codex | Você quer delegação assíncrona baseada em PR | Menos interativo; contexto pode divergir |
Claude Code: Melhor para desenvolvedores que querem contexto de projeto completo e fluxos de trabalho nativos de terminal. Interativo, em tempo real, funciona nos seus arquivos reais. Melhor para recursos complexos, refatoração e depuração.
Cursor: Melhor para desenvolvedores que querem IA dentro do seu IDE. Veja as mudanças em tempo real com diffs inline. Melhor para codificação dia a dia com sugestões de IA. Comparação completa aqui.
Codex: Melhor para equipes que querem tarefas de codificação assíncronas e em lote. Envie uma tarefa, revise o PR depois. Melhor para tarefas bem definidas que você quer delegar completamente. Comparação completa aqui.
Muitos desenvolvedores usam dois ou mais. Claude Code para recursos complexos, Cursor para edição diária, Codex para tarefas em lote.
Quer melhorar seus prompts para qualquer ferramenta de codificação com IA? The Prompt Optimizer ajuda você a estruturar solicitações para saídas mais claras e específicas.
Quer mais conteúdo assim? Publicamos semanalmente sobre ferramentas de codificação com IA e fluxos de trabalho de desenvolvedores. Inscreva-se grátis →
Perguntas Frequentes
O Claude Code funciona no Windows?
Sim, através do WSL (Windows Subsystem for Linux), PowerShell ou Prompt de Comando. O WSL proporciona a melhor experiência já que muitas ferramentas de desenvolvimento são nativas do Linux.
O Claude Code pode acessar a internet?
O Claude Code em si não navega na web, mas pode executar comandos que fazem isso — curl, npm install, git clone. Ele também pode usar servidores MCP para acessar serviços externos como GitHub, bancos de dados e APIs.
Como o Claude Code lida com codebases grandes?
A janela de contexto de 200K tokens do Claude significa que ele pode carregar e processar milhares de arquivos fonte simultaneamente. Para monorepos muito grandes, ele lê seletivamente arquivos relevantes em vez de carregar tudo. O arquivo CLAUDE.md ajuda a saber quais partes do codebase importam para cada tarefa.
Meu código é enviado para os servidores da Anthropic?
Sim, seu código é enviado para a API da Anthropic para processamento. A Anthropic não treina com entradas da API por padrão, mas verifique os termos atuais se estiver trabalhando com código sensível ou proprietário. Considere usar a API com retenção de dados desabilitada para máxima privacidade.
Divulgação: Alguns links neste artigo são links de afiliados. Recomendamos apenas ferramentas que testamos pessoalmente e usamos regularmente. Veja nossa política de divulgação completa.