O que é o Claude Code
Claude Code é um agente de programação da Anthropic que entende o contexto completo do seu projeto — não só um arquivo isolado — e consegue ler, propor e aplicar mudanças reais de código, executar comandos e usar ferramentas como Git, sempre com sua aprovação no caminho.
A diferença central em relação a colar código numa conversa comum é a ação direta: em vez de receber uma sugestão para você copiar e aplicar manualmente, o Claude Code edita os arquivos do seu disco, dentro dos limites que você autorizar.
Os formatos disponíveis — qual escolher
Você pode combinar formatos livremente — começar uma sessão no terminal e continuar no app Desktop, ou o caminho inverso, sem perder o contexto.
Como instalar, passo a passo
Confirme seu plano
Você precisa de uma conta paga do Claude (Pro, Max, Team ou Enterprise) ou de uma conta de Console com créditos. O plano gratuito não dá acesso ao Claude Code.
Use o instalador nativo
O método recomendado atualmente é o instalador nativo do seu sistema — mais rápido e com atualização automática. O método antigo via npm foi descontinuado pela Anthropic.
Abra um novo terminal
Feche e reabra a janela do terminal para garantir que o sistema reconheça o novo caminho de instalação.
Inicie o Claude Code
Navegue até a pasta do seu projeto e digite o comando para iniciar uma sessão.
Autentique sua conta
Na primeira vez, uma janela do navegador abre automaticamente para login. Depois disso, a sessão fica salva.
Importante: sempre inicie o Claude Code a partir da pasta raiz do seu projeto. É assim que ele entende a estrutura completa do código — sem isso, as respostas tendem a ficar genéricas.
Sua primeira sessão
Comece com um projeto que você já conhece bem, e peça algo fácil de verificar — "o que essa função retorna?" ou "onde essa variável é usada?". Isso ajuda a calibrar a confiança antes de pedir mudanças mais importantes.
A interação é uma conversa, não um pedido único: o Claude lê os arquivos relevantes, propõe uma mudança, e você aprova, ajusta ou recusa antes de qualquer coisa ser escrita no disco.
Pedidos vagos como "melhore esse módulo" tendem a gerar mudanças amplas demais. Pedidos específicos como "troque o nome da função X para Y e atualize quem chama ela" reduzem efeitos colaterais indesejados.
Quer aprender a pedir exatamente o que precisa?
O guia completo ensina a estruturar pedidos que entregam resultado de primeira — em qualquer parte do Claude que você usar.
Como funciona o controle sobre as mudanças
Por padrão, o Claude Code pede aprovação antes de cada escrita de arquivo ou execução de comando — nada muda sem sua confirmação explícita. Esse comportamento pode ser ajustado conforme você ganha confiança, liberando algumas ações específicas sem precisar aprovar uma por uma.
Mesmo com mudanças já aplicadas, ferramentas de controle de versão como o Git permitem ver exatamente o que foi alterado e revertam arquivos individuais sem perder o restante do trabalho — uma rede de segurança adicional além da aprovação prévia.
O arquivo CLAUDE.md — contexto do projeto
Um arquivo chamado CLAUDE.md, colocado na raiz do projeto, funciona como uma "ficha de instruções" que o Claude Code lê automaticamente em cada sessão — convenções de código, preferências de estilo, contexto sobre a arquitetura, o que evitar.
Isso evita repetir as mesmas instruções em toda conversa nova. Se o Claude parecer estar ignorando algo que está nesse arquivo, geralmente é porque ele já tinha lido a versão anterior antes da sua edição — nesse caso, reiniciar a sessão resolve.
Terminal vs app Desktop
| Aspecto | Terminal (CLI) | App Desktop |
|---|---|---|
| Capacidade | Completa | Completa — mesma base |
| Sessões em paralelo | Manual, uma por janela | Visual, várias ao mesmo tempo |
| Comparação de mudanças | Via comandos de Git | Visual, embutida |
| Disponibilidade | Mac, Windows, Linux | Mac e Windows apenas |
| Melhor para | Quem já vive no terminal | Quem quer visão geral de várias tarefas |
Erros comuns de quem está começando
Domine o Claude além do básico
O guia completo ensina a tirar o máximo de cada parte do Claude — no Chat, no Desktop, na extensão ou no Code.
Quero o guia completoPerguntas frequentes
É um agente de programação que roda no terminal (ou em formatos visuais como o app Desktop e extensões de editor), capaz de ler, entender e editar arquivos de código real do seu projeto, executar comandos e propor mudanças que você aprova antes de aplicar.
Não. Exige uma conta paga — Pro, Max, Team, Enterprise — ou uma conta de Console com créditos pré-pagos. O plano gratuito do Claude.ai não inclui acesso ao Claude Code.
O Claude Code é voltado para quem trabalha com código, e algum conhecimento técnico básico ajuda a aproveitar melhor — principalmente entender o que está sendo editado e revisar as mudanças propostas. Para quem não programa, o Claude Chat comum atende melhor a maioria das necessidades.
Por padrão, o Claude Code pede aprovação antes de cada escrita de arquivo ou execução de comando — nada muda no disco sem confirmação explícita. Além disso, ferramentas de controle de versão como o Git permitem ver exatamente o que mudou e revertam qualquer alteração indesejada.
A capacidade é a mesma. O terminal é mais direto para quem já tem esse hábito de trabalho. O app Desktop oferece uma interface visual com sessões em paralelo, terminal integrado e comparação visual de mudanças — útil para quem prefere uma visão geral de várias tarefas ao mesmo tempo.
Todos com acesso imediato e garantia incondicional de 7 dias.
Artigos relacionados: