Claude Code: Tutorial Completo de Instalação, Melhores Práticas e Configuração do CLAUDE.md

## 1. O que é o Claude Code e por que ele é diferente? {#o-que-e-o-claude-code} O **Claude Code** é a ferramenta oficial de codificação "agêntica" desenvolvida pela Anthropic que opera diretamente a partir do seu terminal de linha de comando. Diferente de copilotos de código tradicionais focados apenas em autocompletar pequenas linhas no editor, o Claude Code atua como um **engenheiro de software autônomo**: - Ele mapeia e compreende a arquitetura completa do seu repositório. - Edita múltiplos arquivos de forma coerente e coordenada. - Executa comandos no terminal (como testes, linters e builds) e auto-corrige falhas com base nas saídas de erro. - Executa chamadas a servidores **Model Context Protocol (MCP)** para consultar bancos de dados e ferramentas externas. --- ## 2. Instalação Passo a Passo no Windows e macOS {#instalacao-passo-a-passo} A instalação do Claude Code é rápida e pode ser realizada em poucos minutos através dos scripts oficiais da Anthropic ou via gerenciador de pacotes npm. ### Instalação no Windows (PowerShell) Abra o PowerShell como Administrador e execute: ```powershell # Instalação rápida oficial no Windows irm https://claude.ai/install.ps1 | iex # Ou instalação global via npm: npm install -g @anthropic-ai/claude-code ``` ### Instalação no macOS / Linux No terminal macOS ou Linux (com suporte ao Homebrew ou cURL): ```bash # Instalação oficial via cURL curl -fsSL https://claude.ai/install.sh | bash # Iniciar a primeira sessão autenticada: claude ``` --- ## 3. Configurando o Arquivo CLAUDE.md Canônico {#configurando-o-arquivo-claude-md} O arquivo `CLAUDE.md` localizado na raiz do seu projeto é a bússola operacional do assistente. Sempre que você inicia uma sessão, o Claude Code lê este documento para absorver os padrões de arquitetura, preferências de bibliotecas e regras de segurança da sua equipe. ### Exemplo de template profissional: ```markdown # REGRAS DO PROJETO & DIRETRIZES DE ENGENHARIA ## 1. Stack Tecnológica - Next.js 15 (App Router com TypeScript estrito) - Tailwind CSS para estilização e Lucide React para ícones - Cloudflare Pages / Static Export como target de build ## 2. Padrões de Código - Todo componente deve suportar tema Light e Dark. - Não introduza dependências pesadas sem aprovação. - Antes de marcar uma tarefa como concluída, execute `npm run build` para validação empírica. ``` --- ## 4. Melhores Práticas e Economia de Tokens {#melhores-praticas-de-contexto} Para obter a máxima velocidade e evitar desperdício de tokens na API da Anthropic, siga estas 3 regras de ouro: 1. **Use o comando `/clear` ou `/compact` com frequência:** Ao trocar de assunto ou terminar uma funcionalidade, limpe a janela de contexto para evitar poluição residual. 2. **Utilize o Ripgrep (`rg`) para buscas:** Deixe o agente usar buscas pontuais em vez de ler centenas de arquivos na íntegra. 3. **Mantenha os prompts específicos:** Diga o que precisa ser feito, quais arquivos devem ser tocados e qual a evidência de sucesso esperada.

# Iniciar sessão no diretório atual
claude

# Compactar histórico para economizar tokens
/compact

# Limpar contexto para nova tarefa
/clear

# Verificar custos e uso da sessão
/cost