Se você quer ser seu próprio chefe, reserve 30 minutos para si mesmo.
Porque hoje, vou explicar como construir um agente de IA verdadeiramente funcional em uma única tarde, sem nenhum conhecimento de programação.
Não confunda o que vou te contar com um Chatbot. Um chatbot espera por uma pergunta e dá uma resposta. Um agente funciona de forma diferente: você dá a ele um objetivo, e ele define as etapas sozinho, lê arquivos, executa comandos e continua por conta própria até o trabalho ser concluído. Você não gerencia cada movimento; você apenas traça a rota.
Essa diferença é importante porque você não estará mais escrevendo prompts um por um. Enquanto você cuida de outras tarefas, o trabalho progride sozinho.
O QUE É NECESSÁRIO?
Tudo o que você precisa antes da instalação está aqui:
- Um plano pago do Claude (Pro, $20/mês, inclui Claude Code)
- Mac (macOS), Windows ou Linux
- Internet
- 30-45 minutos de tempo livre
Nenhum conhecimento de programação é necessário. Cada comando está escrito por completo; você só vai copiar, colar e pressionar Enter.
Não há custos extras. Você não gasta um centavo além da assinatura.
INSTALAÇÃO: APLICATIVO DE DESKTOP, SEM TERMINAL
A maneira mais fácil para um iniciante é o aplicativo de desktop. Ele coloca todo o poder do Claude Code em suas mãos sem precisar aprender o terminal.
Baixe o aplicativo de desktop adequado para seu sistema operacional através do claude.ai. No Mac, abra o arquivo .dmg e arraste o Claude para a pasta de Aplicativos; no Windows, execute o instalador. Abra o aplicativo, faça login com sua conta e clique na aba Code no centro superior.
Se a aba Code pedir uma atualização de plano, significa que seu plano atual não cobre o Claude Code. Se pedir um login online, complete o login e reinicie o aplicativo. Em ambos os casos, você eventualmente chegará a um espaço de trabalho vazio.
Sucesso aqui significa: uma caixa de prompt vazia, uma aba Code ativa e nenhuma mensagem de erro. Tudo o que você construir a partir de agora viverá nesta área.
O QUE VAMOS CONSTRUIR?
Vamos construir um agente único e claro; vamos prosseguir com o mesmo agente até o final do artigo.
A tarefa dele é esta: ele vai ler os arquivos de texto em uma pasta, encontrar aqueles com títulos ausentes e escrever um relatório chamado missing-titles.txt listando os arquivos que precisam ser corrigidos para você.
Uma tarefa pequena, mas real. Ela inclui as três coisas básicas que um agente deve fazer: ler arquivos, tomar decisões e escrever a saída. E é simples o suficiente para que você possa verificar com seus próprios olhos se funciona ou não.
PASSO 1: CONFIGURANDO A PASTA DE TRABALHO
Crie uma pasta chamada my-agent na sua área de trabalho. O agente trabalhará aqui; ele só poderá ver e tocar o interior desta pasta, então tudo fica seguro.
Dentro de my-agent, crie uma segunda pasta chamada articles. O agente procurará os arquivos que verificará aqui.
Crie quatro arquivos de texto simples dentro de articles: post-one.txt, post-two.txt, post-three.txt, post-four.txt. Abra dois deles e escreva isto no topo:
Title: My Article
Deixe os outros dois completamente vazios. O trabalho do agente é exatamente encontrar estes vazios.
Sua estrutura de pastas deve ser my-agent/articles/, contendo quatro arquivos .txt, dois com títulos e dois sem.
PASSO 2: ESCREVA O ARQUIVO DE INSTRUÇÕES CLAUDE.md
CLAUDE.md é um arquivo de texto simples que o Claude Code lê no início de cada sessão. Pense nele como as instruções fixas do seu agente, uma descrição de trabalho que ele nunca esquece.
Dentro da pasta my-agent (não dentro de articles), crie um novo arquivo chamado CLAUDE.md. Abra-o em qualquer editor de texto — Bloco de Notas no Windows, TextEdit no Mac — e cole exatamente isto:
# Meu Agente de Verificação de Arquivos ## Sua Tarefa Verifique cada arquivo .txt na pasta /articles.
## O que procurar Um arquivo válido começa com esta linha: Title: Se a primeira linha não começar com "Title:", o título do arquivo está faltando.
## O que fazer 1. Leia cada arquivo .txt dentro de /articles um por um. 2. Anote quais arquivos têm títulos ausentes. 3. Crie um arquivo chamado missing-titles.txt na pasta principal. 4. Escreva cada nome de arquivo que falhou na verificação neste arquivo, um por linha. 5. Se todos os arquivos forem válidos, escreva "All files have titles." em missing-titles.txt.
## O que não fazer Não edite nenhum arquivo de artigo. Apenas leia. Apenas escreva no arquivo missing-titles.txt.
Salve-o. Este é o cérebro inteiro do seu agente. O Claude Code lerá isso antes de qualquer outra coisa.
O arquivo my-agent/CLAUDE.md está criado e contém as instruções acima, só isso.
PASSO 3: DIRECIONE O CLAUDE CODE PARA A PASTA
Abra o aplicativo de desktop Claude Code, clique no ícone da pasta ou na opção "Abrir pasta" e vá até a pasta my-agent. Selecione e confirme.
O Claude Code lerá automaticamente seu arquivo CLAUDE.md. Você não verá nenhuma mensagem de confirmação; isso acontece silenciosamente em segundo plano toda vez que você abre uma pasta.
Se você estiver usando um terminal, abra o terminal e execute isto:
cd ~/Desktop/my-agent claude
O comando cd significa "change directory" (mudar diretório); ele move você para dentro da pasta my-agent. Digitar claude inicia a sessão a partir dessa pasta.
PASSO 4: EXECUTE O AGENTE
Digite exatamente isto na caixa de prompt na parte inferior da interface do Claude Code:
Leia cada arquivo .txt na pasta articles. Encontre qualquer arquivo que esteja faltando uma linha Title no topo. Escreva os resultados em missing-titles.txt conforme instruído no CLAUDE.md.
Pressione Enter. E observe.
O Claude Code mostrará tudo o que faz enquanto trabalha: qual arquivo lê, o que encontra em cada um e o que escreve. Essa transparência é intencional. Você pode ver cada ação antes que ela aconteça e pará-la se algo parecer estranho.
O Claude lê os quatro arquivos, detecta os dois sem títulos e cria o arquivo missing-titles.txt na sua pasta my-agent. Quando você abri-lo, deve ver os dois nomes de arquivo escritos um abaixo do outro.
ERRO MAIS COMUM: O AGENTE DIZ "PRONTO" MAS O ARQUIVO ESTÁ VAZIO
Isso geralmente acontece quando o agente cria o arquivo missing-titles.txt mas não escreve nada dentro. A razão é quase sempre que a instrução no CLAUDE.md é muito vaga.
Solução: Abra CLAUDE.md e torne as instruções de saída mais concretas. Em vez de "Liste os arquivos", escreva "escreva cada nome de arquivo em sua própria linha, por exemplo: post-two.txt." Colocar um exemplo concreto na instrução torna a saída concreta toda vez.
Se o agente escrever o nome de arquivo errado ou pular um, certifique-se de que seus arquivos de artigo realmente tenham a extensão .txt, e não .txt.txt. Isso geralmente acontece no Windows quando as extensões de arquivo estão ocultas. Abra "mostrar extensões de arquivo" nas configurações do Explorador de Arquivos e verifique.
PASSO 5: VERIFIQUE E EXPANDA
Abra o arquivo missing-titles.txt e verifique se aqueles dois arquivos que você deixou em branco estão listados. Se estiver correto, significa que seu agente funcionou corretamente do início ao fim.
Agora você tem um agente funcional. Ele mora em my-agent, recebe instruções do CLAUDE.md, e você pode executá-lo novamente com o mesmo prompt quando colocar novos arquivos na pasta articles.
O próximo passo claro: atualize CLAUDE.md e faça com que ele também verifique se cada arquivo tem mais de cinco linhas. Adicione isto sob o título "O que procurar":
**Um arquivo válido também contém conteúdo com mais de 5 linhas. Se um arquivo tiver 5 linhas ou menos, marque-o também como "muito curto" ao lado da verificação do título.**
Execute o agente novamente com o mesmo prompt. Agora ele verificará duas coisas em vez de uma; você não fez alterações no seu prompt, apenas o arquivo de instruções mudou.
O QUE VOCÊ FEZ E POR QUE ISSO É IMPORTANTE?
Você construiu um agente que lê arquivos, toma decisões, escreve saídas e faz isso sem você supervisionar cada etapa. Este é o padrão básico para todo agente mais avançado que você construirá a partir de agora.
A parte que escala é o CLAUDE.md. Cada nova regra, nova verificação e novo formato de saída que você adiciona lá muda o que o agente faz sem que você mude como o executa. O prompt permanece o mesmo, a instrução evolui.
Passos naturais a partir daqui: verificar mais tipos de arquivo, escrever o relatório em um formato diferente como CSV, ou fazer a verificação se repetir automaticamente em certos intervalos.
Parabéns, você deu o primeiro passo; o resto está em suas mãos, proporcional à sua imaginação.
Aja antes que a lacuna se amplie.
Não se esqueça de salvar e compartilhar, e apoie comentando.
