💬 O chatbot só responde
Novo aqui? Um chatbot é um programa que conversa: você digita uma pergunta, ele devolve uma resposta em texto. É só isso. Pense num guichê de informações — o atendente te explica onde fica a sala, mas não vai lá abrir a porta pra você.
Ferramentas como ChatGPT no modo padrão funcionam assim: ótimas para explicar, resumir, traduzir — mas o resultado fica na tela. Se você quer que algo aconteça de verdade no seu computador (um arquivo criado, um e-mail enviado, um site publicado), o chatbot puro não chega lá sozinho.
💡 Conceito Principal
Chatbot = entrada de texto, saída de texto. Nada muda fora da janela de conversa.
- •Você pergunta "como faço um resumo de vendas?" e ele te explica os passos.
- •Você ainda precisa abrir a planilha, copiar, colar e calcular na mão.
🔎 Ver por dentro
Quando você conversa com um chatbot puro, nada muda no seu computador: o texto que ele gera vive só dentro da janela de conversa, num servidor distante. Nenhum arquivo é criado na sua pasta, nenhum comando é rodado, nenhum e-mail sai. É por isso que, depois de uma boa resposta, você ainda precisa fazer o trabalho manual de copiar, colar e aplicar aquilo em algum lugar real — o chatbot te deu o mapa, mas não andou o caminho.
🛠️ O agente pega a ferramenta e faz o trabalho
Um agente de código é diferente: ele tem acesso a ferramentas — coisas que ele mesmo executa, tipo abrir um arquivo, rodar um comando no terminal (a caixa de texto que dá ordens direto ao computador — mais sobre isso no módulo 0.2) ou buscar uma informação na internet. Ele decide qual ferramenta usar, usa, olha o resultado, e ajusta se algo deu errado.
Legenda: o pedido entra à esquerda, o agente escolhe a ferramenta certa na "gaveta", executa e devolve algo já feito — não só uma explicação.
🔍 Por dentro
- Ferramenta (tool): uma ação concreta que o agente pode disparar sozinho — ler, escrever, rodar, buscar.
- Ciclo: pensar → escolher ferramenta → usar → checar resultado → repetir até terminar.
⚠️ Erro comum de iniciante
Na primeira vez que o agente pede permissão para rodar um comando ou mexer num arquivo, muita gente se assusta e cancela tudo, achando que algo quebrou. Não quebrou — essa pausa é o próprio agente checando com você antes de agir, exatamente o comportamento que queremos (ver módulo 0.6). O tropeço real é o oposto: aprovar tudo no "modo automático" sem entender o que está sendo pedido. Leia a linha do pedido antes de aprovar — é rápido e evita retrabalho.
🏢 A analogia do funcionário
Pense no Claude Code como um funcionário novo, muito capaz e muito rápido, mas que ainda não conhece as manias da casa. Você dá a tarefa ("organize esses relatórios"), ele decide o caminho (abre a pasta, lê os arquivos, cria a planilha), executa, e volta pra te mostrar o que fez. No começo você supervisiona de perto; com o tempo, confia mais — exatamente como com um funcionário de verdade.
✓ Funcionário bem orientado
- ✓Recebe instrução clara e o contexto que precisa (o CLAUDE.md do módulo 0.4)
- ✓Mostra o plano antes de agir em tarefas grandes
- ✓Avisa quando algo deu diferente do esperado
✗ Funcionário sem supervisão
- ✗Recebe uma ordem vaga ("resolve isso aí") e adivinha o resto
- ✗Executa mudanças grandes sem te avisar antes
- ✗Ninguém revisa o resultado antes de publicar
💡 Dica Prática
Trate as primeiras semanas como período de experiência: peça tarefas pequenas, leia o que ele faz, e só depois confie tarefas maiores. É exatamente esse assunto que fecha a trilha, no módulo 0.6.
A curva de confiança, em três fases
-
1
Semana 1 — perto: tarefas pequenas e isoladas (renomear arquivos, resumir um texto), você lê tudo antes de aceitar.
-
2
Semanas 2-4 — supervisão leve: tarefas com mais passos (organizar uma pasta inteira), você confere o plano mas não cada linha.
-
3
Depois — delegação real: rotinas que rodam sozinhas em horários fixos (trilha 6), com permissões já calibradas.
🖥️ O que é o Claude Code, concretamente
Novo aqui? Um modelo de IA é o "cérebro" — o programa treinado pra entender linguagem e decidir o que fazer (é o mesmo tipo de tecnologia por trás do ChatGPT). O Claude Code é um programa que roda no seu terminal e conecta esse cérebro a ferramentas reais no seu computador: ele lê e escreve arquivos, executa comandos, e só faz isso dentro da permissão que você concede — você decide o quanto ele pode agir sozinho.
Você abre o terminal numa pasta
O programa passa a "enxergar" só o que está dentro dessa pasta — o projeto (módulo 0.3).
Você escreve o que quer em português
Sem sintaxe especial — frase normal, como pediria a um colega.
Ele age e mostra o resultado
Dentro dos limites de permissão que você definiu (aprofundado no módulo 0.6).
Legenda: a pasta que você abre é a fronteira do agente. Buscar na web só acontece se uma ferramenta específica de busca for usada — e ainda assim, dentro do que você permitir.
🔎 Ver por dentro: o que vai para a internet e o que fica no seu PC
Os seus arquivos ficam no seu computador — abrir, ler e escrever dentro da pasta do projeto não envia nada pra fora. O que viaja até os servidores do provedor do modelo é o texto da conversa: sua instrução e os trechos de arquivo que o agente precisa "olhar" para responder. É assim que o cérebro (o modelo de IA) processa o pedido e decide o que fazer — o processamento pesado não acontece no seu notebook.
💰 O custo de uma sessão, na prática
Novo aqui? Token é a unidade que mede "quanto texto" foi processado — mais ou menos um pedaço de palavra. Cada mensagem sua e cada resposta do agente consome tokens, e é isso que define o custo.
📊 Estimativa didática (não é fatura fixa)
- Tarefa pequena (renomear arquivos, escrever um texto curto): poucos centavos.
- Sessão de automação típica (como as dos Builds deste curso): na faixa de R$ 0,50 a R$ 3,00.
- Sessão longa e complexa (muitas idas e vindas, muito código): pode passar de R$ 10.
Números aproximados — variam por plano e modelo. A ideia aqui não é decorar preço, é perder o medo do "vou gastar uma fortuna sem saber".
⚠️ Atenção
Sessões que ficam "conversando em círculo" (o agente tentando e errando repetidas vezes) consomem mais tokens que o normal. Se perceber isso, pare, revise o pedido e comece uma sessão nova — mais barato que insistir.
✓ Uso consciente
- ✓Pede uma coisa por vez e confere o resultado antes de seguir
- ✓Fecha a sessão quando a tarefa termina, em vez de deixar aberta "por via das dúvidas"
✗ Uso desperdiçado
- ✗Pede a mesma coisa de formas diferentes torcendo pra "pegar" de algum jeito
- ✗Cola arquivos gigantes inteiros quando só precisava de um trecho pequeno
⚠️ Confusão comum: plano fixo × cobrança por uso
Muita gente mistura duas coisas diferentes: existem planos de assinatura (valor fixo mensal, com um limite de uso incluído) e existe cobrança por consumo de tokens (você paga só pelo que usa, sem mensalidade). O número que aparece acima é o consumo em tokens — quanto disso vira custo real depende de qual dos dois modelos você escolheu. Não existe resposta única; o que importa aqui é entender a unidade, não decorar um preço.
🗺️ O mapa da Trilha 0
Com o modelo mental fixado, o resto da trilha é 100% prático: instalar sem medo (0.2), entender a pasta do projeto (0.3), escrever seu primeiro CLAUDE.md (0.4), aprender o modo plano (0.5) e fechar com as regras de segurança que valem para o curso inteiro (0.6).
🎯 Conceito Principal
- •0.2 instala → 0.3 organiza → 0.4 orienta → 0.5 revisa → 0.6 protege.
- •Cada módulo constrói sobre o anterior — não pule.
💡 Dica Prática
Se você só guardar uma frase deste módulo, guarde esta: agente de código é um funcionário que faz, não um chatbot que explica. Toda decisão de design do resto do curso — permissões, CLAUDE.md, modo plano — existe para tornar esse "fazer" seguro e previsível. Quando um conceito novo aparecer confuso mais à frente, volte aqui e pergunte: isso ajuda o agente a agir melhor, ou a agir com mais segurança? Quase sempre é uma das duas.
Checagem rápida (opcional): qual é a diferença central entre chatbot e agente de código?