🧰 Preparação: seu ambiente

Um chatbot devolve texto. Você pergunta, ele responde — e para por aí. Não abre arquivo nenhum, não roda comando nenhum.

Sem entender esse limite, você espera do chatbot algo que só um agente entrega — e sai frustrado sem saber por quê.

Entrada de texto → saída de texto. Nenhuma ação real no seu computador.

Um agente de código lê arquivos, escreve arquivos, roda comandos no terminal e devolve um resultado que já aconteceu — não só uma descrição do que "poderia" acontecer.

É essa capacidade de agir que transforma "conversa" em "automação real" — a base de todo o resto do curso.

Ferramentas (tools), execução real, resultado verificável.

Pensar no Claude Code como um funcionário novo: você dá a tarefa, ele decide o caminho, executa e volta pra te mostrar o resultado.

Essa analogia orienta como pedir, como supervisionar e quando confiar mais ou menos — assunto central da Trilha 0.6.

Delegação, supervisão, confiança crescente.

Um programa que roda no seu terminal, conectado a um modelo de IA da Anthropic, com permissão (que você concede) para ler e escrever arquivos e executar comandos.

Saber "o que é" tira o mistério e te deixa confortável pra instalar e usar sem medo — tema do módulo 0.2.

Programa de terminal, modelo de IA, permissão concedida por você.

Cada mensagem trocada consome "tokens" — a unidade de cobrança da IA — e uma sessão típica de automação simples fica na faixa de poucos centavos a alguns reais.

Sem essa noção, custo vira um medo abstrato que trava o aprendizado — melhor encarar o número real.

Token, custo por sessão, estimativa (não fatura fixa).

Instalar → entender a pasta do projeto → escrever o CLAUDE.md → aprender o modo plano → fixar as regras de segurança.

Ver o caminho completo ajuda a não se perder — cada módulo constrói em cima do anterior.

Progressão: instalar, organizar, orientar, revisar, proteger.

Uma janela de texto simples onde você digita ordens e o computador executa na hora — sem clicar em ícone nenhum.

É onde o Claude Code roda. Perder o medo do terminal é o primeiro degrau de todo o curso.

Prompt (o "cursor piscando" esperando comando), digitar + Enter.

O caminho recomendado no Windows é habilitar o WSL (um Linux dentro do Windows) e instalar por ali.

Evita 90% dos problemas de compatibilidade que aparecem tentando instalar direto no Windows puro.

WSL, terminal do Windows, reiniciar após habilitar.

Abrir o app Terminal (já vem pronto) e colar um único comando de instalação.

É o caminho mais direto — sem camada extra como o WSL.

Terminal nativo, script oficial de instalação.

cd muda de pasta; ls (Mac/Linux) ou dir (Windows) lista o que tem dentro dela.

São os únicos dois comandos que você usa o tempo todo antes de chamar o agente.

Pasta atual, navegação, listagem.

Rodar um comando de versão e ver um número aparecer — sinal de que a instalação deu certo.

Evita seguir em frente sobre uma instalação quebrada.

Comando de verificação, número de versão.

Digitar o comando que abre o Claude Code dentro de uma pasta e mandar a primeira mensagem.

É o "hello world" do curso — a partir daqui tudo é prática.

Sessão, prompt de entrada, resposta do agente.

Uma pasta comum no seu computador, dedicada a um projeto — nada de mágico, só organização.

O agente só enxerga o que está dentro da pasta aberta — misturar projetos confunde o contexto.

Um projeto = uma pasta = um contexto.

Uma pasta de projeto com um histórico de versões guardado (via git) — cada mudança fica registrada e pode ser desfeita.

É o que vai permitir "publicar" a automação na Trilha 4.

Repositório (repo), histórico de versões, git.

Pastas comuns: código-fonte, arquivos de configuração, o CLAUDE.md, e uma pasta `.claude/` com skills e preferências.

Reconhecer esses nomes evita confusão quando o agente citar algum deles.

Código-fonte, configuração, `.claude/`.

Os arquivos moram no seu computador; só o texto da conversa e trechos necessários viajam até o modelo de IA para gerar a resposta.

Tira a dúvida "meus arquivos ficam expostos?" — assunto retomado no módulo 0.6.

Local vs. nuvem, o que trafega em cada mensagem.

Criar uma pasta nova, entrar nela pelo terminal e abrir o Claude Code ali dentro.

É o ritual que você vai repetir em toda automação nova do curso.

mkdir, cd, abrir o agente na pasta certa.

Misturar vários projetos numa pasta só, ou abrir o agente na pasta errada (ex.: na raiz do usuário).

Evita que o agente "veja" e mexa em arquivos de outros projetos sem querer.

Um projeto por pasta, abrir sempre no lugar certo.

Um arquivo de texto simples, na raiz do projeto, que o agente lê automaticamente sempre que abre a pasta.

É o jeito de você "ensinar" regras fixas ao agente sem repeti-las em toda conversa.

Leitura automática, regras persistentes.

Cada nova sessão de conversa "esquece" a conversa anterior. O CLAUDE.md é o jeito de dar continuidade mínima ao agente.

Explica por que colocar informação chave ali, e não só falar de boca.

Sessão nova, memória zerada, contexto persistente via arquivo.

Um CLAUDE.md de 20 linhas bem escritas orienta melhor que um de 500 linhas genéricas — o agente lê tudo, e informação demais dilui o que importa.

É o erro mais comum de quem começa: "documentar tudo" no arquivo errado.

Sinal vs. ruído, regras essenciais primeiro.

Um modelo pronto de CLAUDE.md enxuto que você adapta ao seu projeto (completo no módulo 0.4).

Copiar um bom exemplo é mais rápido que aprender a estrutura do zero.

Seções: objetivo, regras, comandos, o que nunca fazer.

Se o projeto crescer, detalhe extra vai para arquivos separados que o CLAUDE.md aponta — não para dentro dele.

Prepara o terreno pro conceito de skills, aprofundado na Trilha 3.

Apontar em vez de inchar.

Pedir "resuma este projeto" logo depois de escrever o arquivo — se a resposta bater com o que você escreveu, funcionou.

É o exercício final da trilha, feito no módulo 0.6.

Verificação prática, feedback imediato.

Um modo em que o agente escreve o passo a passo do que pretende fazer e espera sua aprovação antes de executar qualquer coisa.

É a rede de segurança mais simples do curso — você vê antes de acontecer.

Plano, aprovação, execução condicionada.

Você pede algo → o agente escreve o plano → você lê, edita ou aprova → só então ele executa de verdade.

Fecha o entendimento visual desse ciclo (diagrama completo no módulo 0.5).

Pedido → plano → revisão → execução.

Tarefas grandes, que mexem em muitos arquivos, ou que envolvem apagar/publicar coisas: sempre em modo plano. Tarefas pequenas e reversíveis: opcional.

Usar sempre trava o ritmo; nunca usar é arriscado — o equilíbrio importa.

Risco da tarefa, reversibilidade.

Você pode pedir ajuste no plano ("faz sem o passo 3", "usa outro nome de pasta") antes de aprovar.

Corrigir o plano é muito mais barato que desfazer uma execução.

Feedback antes da ação, custo de correção.

Passos vagos ("ajustar arquivos necessários"), ou que citam apagar/sobrescrever algo que você não pediu.

Saber reconhecer isso é o que faz o modo plano valer a pena.

Especificidade, escopo do plano.

Pedir algo pequeno em modo plano e observar o plano gerado antes de aprovar.

Prática vale mais que teoria — ver um plano real fixa o conceito.

Repetição, familiaridade com o fluxo.

Comandos que apagam várias pastas/arquivos de uma vez merecem sempre modo plano e leitura atenta.

É a categoria de erro mais cara e mais difícil de desfazer.

Irreversibilidade, revisão obrigatória.

"Produção" é o ambiente ao vivo, usado por pessoas reais — diferente do ambiente de teste, isolado.

Aprofundado na Trilha 4, mas a regra de ouro nasce aqui: nunca publicar sem revisar.

Produção, ambiente de teste.

Deixar claro no CLAUDE.md que nada vai ao ar (site, post, e-mail) sem sua aprovação explícita.

Uma regra escrita no arquivo é lida sempre — evita publicação acidental.

Regra explícita, aprovação humana no laço.

Uma tabela com o que autorizar de cara e o que sempre revisar antes (completa no módulo 0.6).

Serve de referência rápida quando a dúvida bater no meio de uma tarefa.

Confiança gradual, lista de checagem.

Criar o projeto, escrever o CLAUDE.md e pedir ao agente para resumir o próprio projeto — fechando o ciclo da Trilha 0.

É a prova de que o ambiente está pronto pra Trilha 1.

Verificação final, "ambiente pronto".

Com terminal, projeto, CLAUDE.md, modo plano e regras de segurança prontos, a Trilha 1 apresenta o framework WAT.

Fecha a trilha com clareza do próximo passo.

Transição de trilha, ambiente pronto.