Mapa da trilha
📦 Instalação e Primeiro Comando
Do npm install ao primeiro prompt
⌨️ Navegando o CLI como um Pro
Atalhos, slash commands e pipes
🧠 CLAUDE.md — O Cerebro do Projeto
A hierarquia de instruções
⚙️ Configuração Avançada
settings.json, permissões e providers
💾 Memory e Contexto Persistente
Context window, compaction e checkpoints
🛠️ Seu Workflow Pessoal
Aliases, tmux, VS Code e dotfiles
Conteudo detalhado
📦 Instalação e Primeiro Comando
Do npm install ao primeiro prompt funcional. Tudo que você precisa pra começar a usar o Claude Code hoje.
As três formas de instalar o Claude Code: npm, Homebrew e winget.
Sem instalação correta, nada mais funciona.
Node.js 18+; npm global install; autenticação com API key.
Rodar o comando claude pela primeira vez e entender o que aparece.
O primeiro passo real. Sem ele, o resto é teoria.
Interface interativa; prompt do Claude; resposta inline.
claude (interativo) vs claude -p "pergunta" (one-shot, sem sessão).
Saber quando usar cada modo economiza tempo e contexto.
Modo interativo = conversa; flag -p = one-shot; pipes com -p.
As flags que voce vai usar todo dia: --help, --version, -p, --model, --verbose.
Saber as flags evita ficar perdido no Google.
--help como referência rápida; flags mais usadas.
Como atualizar o Claude Code e verificar a versão instalada.
Versões novas trazem features e fixes importantes.
npm update -g; changelog; breaking changes.
Os erros mais comuns na instalação e como resolver cada um.
Saber resolver erros impede que você trave logo no começo.
EACCES permission; Node version mismatch; auth errors.
⌨️ Navegando o CLI como um Pro
Atalhos de teclado, slash commands, sessões e pipes que multiplicam sua velocidade.
Os atalhos de teclado do Claude Code: Escape, Tab, Ctrl+C e mais.
Atalhos economizam cliques e mantêm o foco no terminal.
Escape para cancelar; Tab para aceitar; Ctrl+C para interromper.
Comandos com barra dentro da sessão interativa do Claude Code.
São o painel de controle dentro da conversa.
/help; /clear; /model; /memory; /resume; /compact.
Qual modelo roda por trás do Claude Code e como o contexto funciona.
Entender o modelo ajuda a calibrar expectativas e custos.
Opus/Sonnet; context window; token budget.
Sessões persistem entre execuções. /resume retoma a conversa anterior.
Não perder o contexto de trabalho ao fechar o terminal.
Session ID; /resume; --resume flag; session picker.
Claude Code lê imagens do filesystem e analisa screenshots.
Debug visual, reproduzir designs, ler diagramas.
Drag-and-drop; colar screenshot; referência por path.
Usar claude -p com pipes Unix: | jq, | grep, > arquivo.
Integração nativa com o ecossistema Unix multiplica o poder.
Stdout; --output-format json; piping com jq; scripts wrapper.
🧠 CLAUDE.md — O Cerebro do Projeto
O arquivo que transforma o Claude Code de genérico em especialista no seu projeto.
Um arquivo Markdown que o Claude Code lê automaticamente a cada sessão.
É o único jeito de dar contexto persistente ao agente sobre seu projeto.
System prompt; instruções persistentes; contexto de projeto.
~/.claude/CLAUDE.md (global) > ./CLAUDE.md (projeto) > subdir/CLAUDE.md (pasta).
Cada nível resolve um problema diferente de escopo.
Cascata de instruções; herança; override por nível.
Como escrever CLAUDE.md que o modelo realmente segue.
Um CLAUDE.md mal escrito é ignorado; um bom muda tudo.
Headings claros; listas; exemplos; tom imperativo.
Quais tipos de instrução realmente mudam o comportamento do agente.
Menos instruções certas > muitas instruções vagas.
Stack; convenções; proibições; padrões do projeto.
Exemplos comentados de CLAUDE.md de projetos reais.
Ver exemplos reais encurta a curva de aprendizado.
Patterns comuns; anti-patterns; tamanho ideal.
CLAUDE.md deve evoluir junto com o projeto, e ir no git.
Um CLAUDE.md desatualizado é pior que nenhum.
Commitar no repo; revisar mensalmente; /memory como complemento.
⚙️ Configuração Avançada
settings.json, .claudeignore, permissões e variáveis de ambiente para afinar o Claude Code.
O arquivo JSON que controla comportamento global e por projeto.
Sem settings.json voce fica com os defaults genéricos.
~/.claude/settings.json; .claude/settings.json; merge de configs.
Arquivo que diz ao Claude Code quais arquivos/pastas ignorar.
Protege secrets, reduz contexto desnecessário e acelera o agente.
Sintaxe glob; .env; node_modules; build artifacts.
Definir quais ferramentas o Claude Code pode usar sem pedir permissão.
Balancear segurança com produtividade.
allowedTools; deniedTools; permission prompts; trust levels.
Variáveis de ambiente que o Claude Code reconhece: ANTHROPIC_API_KEY, CLAUDE_MODEL, etc.
Configuração por ambiente sem tocar em arquivos.
ANTHROPIC_API_KEY; CLAUDE_MODEL; .env local.
Diferentes configs para diferentes projetos/contextos.
Um projeto pessoal e um corporativo têm necessidades diferentes.
Settings local vs global; herança de configs.
Como usar --model, /model e providers alternativos (Bedrock, Vertex).
Flexibilidade para usar o modelo certo para cada tarefa.
--model flag; CLAUDE_MODEL; Bedrock; Vertex AI.
💾 Memory e Contexto Persistente
Como a memória funciona, o que é context window, compaction e estratégias para não perder contexto.
O Claude Code não tem memória mágica. Tudo vive no context window da sessão.
Entender o modelo mental evita frustrações com "ele esqueceu".
Context window = memória de trabalho; CLAUDE.md = memória persistente.
/memory salva notas persistentes que o Claude Code lê em toda sessão futura.
É o jeito rápido de ensinar preferências sem editar CLAUDE.md.
/memory; CLAUDE.md gerado; ~/.claude/CLAUDE.md.
O context window tem limite fixo (200k tokens). Tudo compete por espaço.
Quando o contexto enche, a qualidade das respostas cai.
Tokens; limite de contexto; degradação gradual.
O Claude Code resume automaticamente a conversa quando o contexto enche.
Compaction perde detalhes. Saber quando vai acontecer ajuda a se preparar.
/compact manual; auto-compaction; o que se perde.
Estratégias para transferir contexto de uma sessão para outra.
Sessões longas degradam. Saber dividir mantém a qualidade alta.
/resume; summary manual; CLAUDE.md como handoff.
Técnicas para salvar o estado do trabalho antes que o contexto encha.
Checkpoints previnem perda de progresso em tarefas longas.
Git commits como checkpoint; notas em CLAUDE.md; TODO files.
🛠️ Seu Workflow Pessoal
Aliases, scripts wrapper, tmux, VS Code e o setup definitivo para usar o Claude Code todo dia.
Aliases de shell que encurtam comandos frequentes do Claude Code.
Cada segundo economizado se multiplica por centenas de usos.
alias cc='claude'; alias ccr='claude --resume'; .bashrc/.zshrc.
Shell scripts que combinam claude -p com outras ferramentas.
Scripts wrapper automatizam tarefas repetitivas com IA.
Wrapper scripts; input via pipe; output parsing.
Usar Claude Code dentro do terminal do VS Code e com a extensão oficial.
VS Code é o editor mais usado. Integrar bem maximiza produtividade.
Terminal integrado; extensão Claude Code; side-by-side.
Usar tmux ou screen para rodar Claude Code em sessões persistentes.
Sessões sobrevivem a desconexão e permitem múltiplos agentes.
tmux new-session; panes lado a lado; detach/attach.
Manter configs do Claude Code em dotfiles versionados.
Setup reproduzível em qualquer máquina nova.
Dotfiles repo; symlinks; bootstrap script.
O setup completo que combina tudo: aliases + tmux + VS Code + dotfiles.
Uma referência concreta de como tudo se encaixa.
Workflow integrado; ritmo diário; evolução incremental.