Claude Code guia prático — como instalar, configurar e usar

Existe uma diferença fundamental entre usar Claude no navegador e usar Claude Code no terminal.

No navegador, você tem uma conversa. Pede código, recebe código, copia, cola, testa, volta para perguntar de novo. É útil. Mas você está no meio do processo: carregando contexto, adaptando respostas, gerenciando o ciclo manualmente.

O Claude Code funciona diferente. Ele roda dentro do seu projeto. Lê os arquivos, entende a estrutura, edita diretamente, roda comandos no terminal, vê os erros, corrige. Você descreve o que quer — ele age.

Esse artigo é um guia direto: como instalar, o que configuar e como usar de forma que realmente funciona.

Como instalar

Pré-requisito: Node.js 18 ou superior instalado na sua máquina. Se ainda não tem, baixe em nodejs.org — a instalação é direta.

Com o Node instalado, abra o terminal e rode:

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

Isso instala o Claude Code globalmente. Para verificar se funcionou:

claude --version

Para iniciar uma sessão:

claude

Na primeira vez, ele vai pedir autenticação. Você pode usar sua conta Claude (Pro ou Max) ou configurar uma chave de API da Anthropic diretamente. A conta Pro (US$20/mês) é suficiente para uso moderado. Para uso intenso, a API direta dá mais controle sobre o custo.

Navegue até a pasta do seu projeto antes de abrir o Claude — ele vai ler tudo que estiver no diretório atual.

O que o Claude Code consegue fazer

A lista completa das capacidades importa porque define o tipo de tarefa que faz sentido delegar:

Ler o projeto inteiro — arquivos, estrutura de pastas, configurações, dependências. O contexto é real, não superficial.
Editar arquivos diretamente — não só sugerir código. Ele abre, modifica e salva os arquivos no seu sistema.
Rodar comandos no terminal — instala dependências, roda builds, executa testes, faz commits, faz deploy.
Ver e interpretar erros — quando algo quebra, ele lê a mensagem de erro e propõe a correção.
Pesquisar na web — com MCP de busca ou Fetch configurado, ele consulta documentação e fontes externas sem sair da sessão.
Iterar em loop — se a primeira tentativa não funcionou, ele ajusta e tenta de novo sem você precisar repetir o contexto.
Manter memória entre sessões — com o arquivo CLAUDE.md no projeto, o contexto persiste entre conversas diferentes.

Os comandos mais importantes

Dentro de uma sessão ativa, esses são os comandos que você vai usar:

| Comando | O que faz | |---|---| | /help | Lista todos os comandos disponíveis | | /compact | Comprime o histórico da sessão para liberar contexto | | /clear | Limpa o histórico e começa uma sessão limpa | | /review | Pede uma revisão do código ou das mudanças feitas | | /memory | Abre o arquivo CLAUDE.md para editar o contexto persistente | | /cost | Mostra quanto você gastou na sessão atual | | /mcp | Lista os servidores MCP conectados e seu status | | # + texto | Adiciona um comentário à sessão sem acionar resposta | | ! + comando | Roda um comando shell direto sem sair da sessão |

O /compact é mais útil do que parece. Em sessões longas, o contexto acumula e a qualidade das respostas cai. Compactar mantém o essencial e descarta o que não é mais relevante.

O /cost é fundamental para quem usa API direta — monitora o gasto em tempo real e evita surpresas na fatura.

Fluxo de trabalho típico

O padrão que funciona no dia a dia:

Abra o terminal na pasta do projeto — cd /caminho/do/projeto, depois claude
Descreva a tarefa com clareza — não "melhora o código", mas "o componente Header está quebrando no mobile porque o menu não fecha ao clicar fora. Investiga e corrige."
Revise o que ele vai fazer — antes de executar mudanças grandes, o Claude Code apresenta um plano. Leia. Se algo não parece certo, corrija antes de aprovar.
Aprove ou ajuste — você decide se as mudanças propostas fazem sentido. A IA executa, você mantém o controle.
Itere até o resultado estar certo — se o primeiro resultado não é o que você queria, diga exatamente o que está diferente. Não recomece do zero.

O ciclo inteiro costuma ser mais rápido do que você imagina. Para tarefas bem descritas, o Claude Code chega no resultado certo em uma ou duas iterações.

Dicas para resultados melhores

Seja específico no problema, não na solução. "Cria um componente de modal" gera resultado genérico. "Preciso de um modal que abre ao clicar no botão CTA, tem overlay escuro, fecha no clique fora e no botão X, e usa os tokens de cor do tema" gera resultado certo na primeira vez.

Divida tarefas grandes. Pedir "recria o sistema de autenticação inteiro" em uma instrução tende a dar resultado incompleto. Divida em: estrutura, formulário de login, lógica de sessão, proteção de rotas. Cada parte bem feita.

Use /memory para contexto persistente. O arquivo CLAUDE.md é lido no início de cada sessão. Coloque lá: stack do projeto, padrões de código adotados, decisões de arquitetura, coisas que o Claude não deve fazer. Isso elimina a necessidade de reexplicar tudo toda vez.

Revise os diffs antes de aceitar. O Claude Code mostra o que vai mudar antes de salvar. Leia. Em raros casos, a solução está tecnicamente correta mas não é o que você queria — porque a descrição do problema deixou margem para interpretação.

Use modo plan antes de agir em tarefas grandes. Diga "não execute ainda, me mostre um plano de como você faria isso." Revisar o plano é mais barato do que desfazer mudanças já feitas.

Custo e planos

Existem duas formas de usar o Claude Code:

Claude Pro (US$20/mês): inclui uso moderado do Claude Code. Bom para quem trabalha em projetos menores ou usa a ferramenta algumas horas por semana. A sessão tem limites de uso por hora, mas para a maioria dos casos de uso, é suficiente.

API direta (pay-per-use): você configura uma chave de API da Anthropic e paga pelo uso. Mais caro em uso intenso, mas sem limitação de sessão e com controle total sobre o gasto. Faz sentido para quem usa Claude Code como ferramenta principal de trabalho.

Para monitorar o gasto na sessão atual, use /cost. Para ver o histórico de uso, acesse o painel da Anthropic em console.anthropic.com.

A regra prática: comece com o plano Pro. Se você está batendo nos limites com frequência, mude para API direta.

Quando Claude Code supera o ChatGPT e alternativas

A diferença fica clara em dois cenários:

Projetos com múltiplos arquivos. O ChatGPT e outros chats não têm acesso ao seu código — você cola fragmentos e recebe fragmentos de volta. O Claude Code lê o projeto inteiro, entende as dependências entre arquivos e faz mudanças coerentes em vários pontos ao mesmo tempo. Em projetos com mais de 10 arquivos, essa diferença é decisiva.

Diagnóstico de problemas reais. Quando algo quebra em produção, o ChatGPT precisa que você descreva o problema, cole o erro, explique o contexto. O Claude Code investiga: acessa os logs, lê o código onde o erro ocorre, rastreia a causa raiz, propõe a correção e testa. O processo que levaria 30 minutos de pesquisa leva 5 minutos de conversa.

Execução de tarefas encadeadas. "Cria o componente, adiciona no arquivo de rotas, atualiza o menu de navegação e faz o commit com mensagem descritiva" — o Claude Code executa tudo em sequência, verificando se cada passo funcionou antes de passar para o próximo. Em um chat, você faria isso em quatro conversas separadas.

A diferença não é de inteligência do modelo. É de acesso ao contexto e capacidade de agir. Um chat conversa. O Claude Code trabalha.