🤖 O que é um agente de IA
Um agente de IA é um programa que percebe o ambiente ao redor, raciocina sobre o que precisa ser feito e executa ações para alcançar um objetivo — repetindo esse ciclo até concluir. Isso é radicalmente diferente de um chatbot que apenas responde a uma pergunta e para.
✓ Agente faz
- ✓Lê 20 arquivos para entender o projeto
- ✓Executa testes e corrige o que quebrou
- ✓Itera até a tarefa estar concluída
- ✓Cria, edita e deleta arquivos reais
✗ Chatbot faz
- ✗Responde uma vez e espera nova pergunta
- ✗Gera código mas não o executa
- ✗Não sabe se o código funciona
- ✗Não tem acesso ao sistema de arquivos
💻 Por que o terminal?
O terminal não é só uma janela preta intimidadora. É o ponto de acesso direto ao sistema operacional — arquivos, processos, rede, compiladores, servidores. Um agente que vive no terminal tem poder real para transformar código em resultado.
💡 Por que não uma interface gráfica?
Interfaces gráficas são lentas de automatizar, dependem de resolução de tela e mudam com atualizações. O terminal é estável, scriptável e universal — funciona em qualquer servidor remoto, CI/CD ou container Docker.
- •Velocidade: criar 50 arquivos em 1 comando vs. clicar 50 vezes
- •Composição: pipe de comandos cria fluxos impossíveis na GUI
- •Acesso remoto: SSH conecta o agente a qualquer servidor
Evolução da automação de código
Scripts shell
Automação manual linha por linha. Eficaz mas frágil — quebra com qualquer variação.
Geração de código por LLM (chatbot)
IA gera código, humano copia e cola, testa manualmente. Mais rápido, mas ainda manual.
Agente no terminal (Claude Code)
IA lê, escreve, executa e itera autonomamente. Humano revisa o resultado, não cada passo.
💡 Dica Prática
Se você nunca usou o terminal, não precisa aprender tudo antes de começar. O Módulo 1.4 cobre exatamente o suficiente. Por ora: saber que o terminal existe e por que o agente vive lá já é o bastante.
📁 O que ele lê, escreve e executa
O Claude Code não é um modelo flutuando na nuvem. Ele tem ferramentas concretas que interagem com o sistema real: lê arquivos, edita código, roda comandos, busca padrões. Cada ação é visível no terminal.
🛠️ Ferramentas nativas do Claude Code
**/*.ts, src/**
✓ Pode fazer
- ✓Criar e modificar qualquer arquivo de texto
- ✓Rodar npm install, pytest, cargo build
- ✓Fazer commits git
- ✓Ler logs e interpretar erros
✗ Não pode (sem plugins)
- ✗Navegar em browsers ou apps gráficos
- ✗Ver imagens ou PDFs (apenas texto)
- ✗Acessar a internet diretamente
- ✗Lembrar sessões anteriores (sem CLAUDE.md)
🎯 Casos de uso reais
O Claude Code não é um brinquedo de demonstração. Ele é usado em projetos reais de produção para tarefas que levariam horas por dia de trabalho manual.
📊 Onde o Claude Code brilha
- →Refatoração em escala: renomear uma função em 80 arquivos, atualizar imports, garantir consistência
- →Migração de API: atualizar chamadas depreciadas de uma biblioteca para a nova versão
- →Geração de testes: cobrir funções existentes com testes unitários e de integração
- →Debugging: ler stack trace, localizar o bug, propor e aplicar a correção
- →Boilerplate: criar estrutura de projeto, configurar tooling, escrever README
💡 Dica: O frame mental certo
Pense no Claude Code como um desenvolvedor júnior muito rápido que nunca cansa. Ele executa bem tarefas bem definidas, mas precisa de contexto claro. Quanto melhor você descrever o que quer, melhor o resultado.
⚡ Chatbot vs. agente — a diferença prática
A diferença não é filosófica — é pragmática. Mudar o modo de usar a ferramenta muda o resultado radicalmente. Aqui está o contraste no dia a dia:
Modo chatbot (ineficiente)
"Me escreva uma função para validar email" → copia o código → cola no editor → descobre que não funciona → volta ao chat → pede correção → repete 5x.
Modo agente (eficiente)
"Adicione validação de email ao formulário em src/auth.ts e escreva testes para ela" → agente lê o arquivo, escreve o código, roda os testes, ajusta até passarem. Você revisa o resultado.
⚠️ Armadilha comum
Pessoas que vêm do ChatGPT tendem a fazer perguntas ao Claude Code em vez de delegar tarefas. Resultado: respostas medianas. Reformule de "como faço X?" para "faça X no arquivo Y".
🚀 Primeiro contato
A melhor forma de entender um agente é vê-lo funcionando. Aqui está o fluxo do primeiro contato — do terminal em branco até a primeira tarefa concluída.
💻 Sessão inicial típica
💡 O que observar na primeira sessão
Quando o agente trabalha, você verá linhas como ● Read src/index.ts e ● Bash: npm test. Isso é o log de ferramentas em tempo real — cada linha é uma ação concreta no seu sistema.
Preste atenção nesse log nas primeiras sessões. Ele é o "raciocínio visível" do agente.
claude -p "tarefa" sem prompt✅ Resumo do Módulo 1.1
Próximo Módulo:
1.2 — Como o agente pensa: o loop interno, ferramentas e como o Claude Code decide o que fazer em cada momento.