🎯 Fundamentos

Claude Code e a interface de linha de comando oficial da Anthropic para interagir com modelos Claude em tarefas de desenvolvimento de software.

E a forma mais poderosa de usar Claude para codificacao, oferecendo acesso direto ao modelo sem intermediarios e controle total sobre o ambiente.

CLI agentica, execucao local, acesso a arquivos, terminal interativo, modelo Opus 4.5.

Comparacao entre Claude Code e ferramentas como GitHub Copilot, Cursor, ChatGPT e outras assistentes de codigo.

Entender as diferencas ajuda a escolher a ferramenta certa para cada situacao e aproveitar os pontos fortes de cada uma.

Execucao local vs cloud, acesso a sistema de arquivos, autonomia do agente, custo por token.

Processo de instalacao via npm/homebrew, configuracao da API key e setup inicial do ambiente.

Uma instalacao correta evita problemas futuros e garante que todas as funcionalidades estarao disponiveis.

npm install, ANTHROPIC_API_KEY, .claude/, settings.json, primeiro comando.

Os tres modos de permissao que controlam quanto controle Claude tem sobre seu sistema.

Escolher o modo certo equilibra produtividade e seguranca, evitando tanto interrupcoes excessivas quanto riscos desnecessarios.

Ask before edits, bypass permissions, YOLO mode, whitelist, blacklist.

Guia pratico para escrever seu primeiro prompt efetivo e ver Claude Code em acao.

Um primeiro sucesso rapido constroi confianca e ajuda a entender o fluxo basico de trabalho.

Prompt claro, contexto suficiente, expectativa de resultado, feedback loop.

Conjunto de habitos e praticas recomendadas para comecar com o pe direito.

Bons habitos desde o inicio evitam problemas comuns e aceleram o aprendizado.

Sessoes curtas, prompts especificos, verificacao de resultados, uso do /context.

A CLI e onde voce digita comandos e ve respostas. Processa seus prompts e os envia para o modelo.

Entender a CLI ajuda a usar comandos slash, interpretar outputs e configurar preferencias.

Parser de entrada, renderer de saida, historico de sessao, interface de confirmacao.

Controla o ciclo de vida das conversas, inicio, manutencao e encerramento das sessoes.

Gerenciar sessoes corretamente impacta diretamente o uso de contexto e persistencia de dados.

~/.claude/, sessions/, settings.json, memory/, snapshots.

O braco do Claude Code que realmente executa acoes no seu sistema: ler, escrever, editar arquivos e rodar comandos.

Conhecer as ferramentas disponiveis permite tirar maximo proveito do Claude Code.

Read, Write, Edit, Glob, Grep, Bash - as 6 ferramentas principais.

O guardiao do sistema que verifica permissoes antes de cada acao potencialmente perigosa.

Configurar permissoes corretamente equilibra produtividade e seguranca.

Allow, Ask, Block - tres estados de permissao para cada acao.

Onde a magia acontece - o modelo Claude processa requisicoes, decide ferramentas e coordena o fluxo.

Entender a orquestracao ajuda a escrever prompts que aproveitam o raciocinio do modelo.

API Anthropic, tokens de entrada/saida, planejamento de tarefas, iteracao.

Visao de como os 5 componentes trabalham juntos em um fluxo real de execucao.

Ver o sistema completo ajuda a diagnosticar problemas e otimizar uso.

Fluxo de requisicao, ciclo de execucao, feedback loop, verificacao.

O ciclo fundamental de tres etapas que explica 90% do comportamento do Claude Code.

Entender o ciclo permite prever comportamentos, identificar problemas e escrever prompts melhores.

Gather (coletar), Act (agir), Verify (verificar) - ciclo que se repete.

Fase onde Claude coleta informacoes, le arquivos, explora o projeto e faz perguntas.

Um bom Gather evita erros e economiza contexto lendo apenas o necessario.

CLAUDE.md, Glob, Read, Grep, AskUserQuestion.

Fase onde Claude faz mudancas reais no sistema: edita arquivos, cria novos, roda comandos.

Entender a fase Act ajuda a configurar permissoes e evitar acoes indesejadas.

Edit, Write, Bash, Task, snapshots automaticos.

Fase onde Claude confirma que a acao funcionou: roda testes, re-le arquivos, compila codigo.

Incentivar a verificacao reduz erros e garante qualidade do codigo.

Testes automaticos, builds, re-leitura, correcao de erros.

Quando a verificacao falha, Claude volta ao inicio do ciclo com novo contexto.

Reconhecer loops infinitos evita desperdicio de contexto e tempo.

Loop infinito, sinais de alerta, quando interromper, nova sessao.

Demonstracao do ciclo completo em acao com o prompt "Corrija o bug de login".

Ver na pratica consolida o entendimento do modelo mental.

Gather: CLAUDE.md, Glob, Grep, Read. Act: Edit. Verify: npm test.

O contexto e como um balde com capacidade fixa de 200K tokens que enche conforme voce interage.

Gerenciar o balde evita que Claude perca qualidade ou esqueca instrucoes importantes.

200K tokens, ~150K palavras, 1 token ≈ 4 caracteres, portugues usa ~20% mais.

Diferentes itens consomem contexto em proporcoes diferentes - arquivos lidos sao os maiores vilaoes.

Conhecer os vilaoes permite evita-los e manter o contexto saudavel.

PDFs (vilao #1!), arquivos grandes, historico longo, CLAUDE.md extenso.

Apos 40-50% de uso, a qualidade das respostas comeca a degradar visivelmente.

Saber o limite ajuda a tomar acoes preventivas antes da qualidade cair.

0-40% livre, 40-60% monitore, 60-80% compacte, 80%+ degradado.

Comando que mostra exatamente quanto do balde esta cheio e o que esta ocupando espaco.

Monitorar o contexto permite agir antes de problemas surgirem.

/context, breakdown por tipo, acoes baseadas em percentual.

Conjunto de tecnicas para economizar contexto e manter qualidade por mais tempo.

Economizar contexto significa sessoes mais longas e produtivas.

Search Before Read, subagentes, CLAUDE.md enxuto, sessoes curtas.

Checklist pratico para gerenciar contexto como um profissional.

Um checklist simples garante que voce nao esqueca passos importantes.

/context regular, Glob antes de Read, evitar PDFs, compactar antes de 70%.

Processo de comprimir a conversa quando o contexto fica cheio, resumindo o historico.

Usar compaction corretamente permite sessoes mais longas sem perda de qualidade.

Resumo, descarte de detalhes, preservacao de decisoes, 5 arquivos recentes.

Auto-compact acontece automaticamente em ~85-90%. Manual (/compact) voce controla quando.

Manual te da mais controle sobre o que e preservado na compactacao.

/compact, auto-compact em ~85-90%, controle vs conveniencia.

70% e o momento ideal para compactar - deixa buffer de 30% (60K tokens) para qualidade.

Compactar no momento certo evita tanto perda de qualidade quanto compactacao prematura.

Buffer de 30%, espaco para raciocinio, qualidade de resposta.

/compact aceita instrucoes sobre o que preservar: decisoes, patterns, nomes de arquivos.

Personalizar garante que informacoes criticas nao sejam perdidas.

/compact com instrucoes, "preserve X", resumo pre-compactacao.

Compactacao perde informacao - detalhes, nuances, feedback loops antigos.

Conhecer os riscos ajuda a mitigar perdas com CLAUDE.md e playbooks.

Perda de detalhes, sinais de problema, gravar em CLAUDE.md.

Pedir um resumo do que deve sobreviver ANTES de compactar - tecnica mais poderosa.

Garante que Claude inclua as informacoes criticas no resumo pos-compactacao.

Resumo em 5-7 bullets, revisar, /compact, atualizar CLAUDE.md.

Sessoes sao stateless - quando fecha o terminal, o contexto da conversa se perde.

Entender o que persiste e o que se perde ajuda a planejar sessoes eficientes.

Perde: contexto, arquivos em memoria. Persiste: arquivos criados, Git, CLAUDE.md.

Antes de editar, Claude salva automaticamente uma copia do arquivo original.

Saber que snapshots existem da confianca para deixar Claude editar arquivos.

Snapshot automatico, rollback sob demanda, "reverta a ultima edicao".

Todas as conversas sao salvas em ~/.claude/ - voce pode recuperar historico antigo.

Conhecer a estrutura permite recuperar sessoes e diagnosticar problemas.

sessions/, settings.json, memory/, skills/.

Usar terminais separados para tarefas diferentes - cada um tem seu proprio contexto.

Isolar contextos permite trabalho paralelo e melhor gerenciamento.

Um terminal = uma missao, planejamento, execucao, testes.

E possivel recuperar historico de sessoes antigas navegando ate ~/.claude/sessions/.

Recuperar decisoes anteriores pode economizar tempo e evitar erros.

Pedir para Claude ler sessoes, extrair decisoes, resumir conversas.

Usar GitHub Issues como lista de tarefas que sobrevive entre sessoes.

Issues persistem na nuvem e Claude pode le-las no inicio de cada sessao.

Issues como to-do, nao polui CLAUDE.md, historico de progresso.

Cada acao pode ter um de tres estados: Allow (permite automatico), Ask (pergunta) ou Block (bloqueia).

Configurar permissoes corretamente equilibra velocidade e seguranca.

Allow = rapido, Ask = equilibrado, Block = seguro.

Dois arquivos de configuracao: global (~/.claude/) e por projeto (.claude/).

Usar configuracoes por projeto evita surpresas entre projetos diferentes.

settings.json global, settings.local.json por projeto, sobrescrita.

Listas de comandos sempre permitidos (whitelist) ou sempre bloqueados (blacklist).

Whitelist permite automacao segura; blacklist protege contra comandos perigosos.

allowedBashPatterns, blockedBashPatterns, patterns com wildcards.

Em ambientes corporativos, voce pode compartilhar configuracoes via repositorio.

Padronizar configuracoes facilita onboarding e garante seguranca.

.claude/settings.json no repo, auditoria centralizada.

Tabela com permissoes recomendadas para Dev Solo, Equipe e Producao.

Seguir recomendacoes evita tanto burocracia excessiva quanto riscos de seguranca.

Read/Glob: Allow. Edit: Ask. npm install: Block em prod.

Lista de acoes que NUNCA devem ser Allow em producao: rm -rf, sudo, git push --force.

Evitar comandos destrutivos protege seus dados e sistemas.

rm -rf, sudo, git push --force, DROP DATABASE, npm publish.

Comandos slash sao atalhos que executam acoes especificas: /help, /context, /compact, /clear.

Memorizar comandos acelera drasticamente seu fluxo de trabalho.

/help, /context, /compact, /clear, /init, /install.

Comandos para configurar o sistema: /config, /permissions, /mcp, /model.

Ajustar configuracoes permite personalizar Claude Code para suas necessidades.

/config, /permissions, /mcp para MCP servers, /model para Opus/Sonnet.

Atalhos de teclado para navegacao rapida: Ctrl+C, Shift+Enter, setas.

Atalhos evitam interrupcoes e mantem o fluxo de pensamento.

Ctrl+C cancela, Shift+Enter nova linha, seta cima historico.

Claude Code funciona integrado com VS Code, Cursor e Zed.

Integracao com editores permite usar Claude sem sair do ambiente de desenvolvimento.

VS Code extensao oficial, Cursor nativo, Zed via extensao.

Opcoes de customizacao visual: tema do terminal, syntax highlighting, verbosidade.

Personalizar o visual torna o uso mais confortavel e produtivo.

Tema segue terminal, syntax auto, verbosidade ajustavel.

Resumo de tudo que voce aprendeu e introducao a Trilha 2.

Consolidar o aprendizado prepara voce para os proximos modulos.

8 modulos concluidos, ~4h de conteudo, pronto para Trilha 2.