Construindo um Agente de IA Pessoal com Claude Code: Lições de 6 Meses de Wiz

Um desenvolvedor compartilhou sua jornada de seis meses construindo Wiz, um agente de IA pessoal usando Claude Code tanto como ambiente de desenvolvimento quanto como runtime. O projeto começou com uma visão ambiciosa de "Jarvis do Homem de Ferro", mas evoluiu para um sistema prático de uso diário.

O que o Wiz Realmente Faz

Wiz é um agente de IA pessoal construído no Claude Code que funciona de forma autônoma para tarefas de rotina. O sistema lida com relatórios matinais, resumos noturnos, triagem de caixa de entrada e vários experimentos. Para trabalhos criativos ou sensíveis à qualidade, o desenvolvedor permanece no circuito.

Implementação Técnica

A arquitetura é intencionalmente simples:

• Claude Code serve como estrutura/plataforma
• CLAUDE.md contém o arquivo de instruções
• A memória reside em arquivos markdown
• As ferramentas são implementadas como scripts em pastas

Processo de Desenvolvimento com Claude Code

O desenvolvedor usou Claude Code extensivamente durante todo o projeto:

• O comando /init gerou o primeiro arquivo CLAUDE.md de uma só vez
• Quando era necessário depuração, os erros eram colados de volta no Claude Code para diagnóstico
• Claude Code escreveu a maior parte do código, com o desenvolvedor revisando cada arquivo e corrigindo problemas

Principais Erros e Lições

O desenvolvedor identificou 9 erros específicos que causaram problemas:

• Deixar o Claude gerar o primeiro CLAUDE.md sem revisão cuidadosa - levou a horas de depuração devido a uma única frase ruim
• Permitir que a auto-melhoria reescrevesse instruções principais sem salvaguardas - fez o sistema derivar em múltiplas direções
• Executar Opus em cada pequena consulta até atingir os limites de uso antes do almoço - corrigido implementando roteamento de modelos (pequeno/local para tarefas simples, Sonnet para trabalho geral, Opus para chamadas complexas)
• Tentar construir "Jarvis" no primeiro dia em vez de incrementalmente - custou aproximadamente três meses de tempo de desenvolvimento
• Colocar uma chamada de LLM em cada etapa de cada pipeline quando a maioria deveria ter sido scripts simples

Ponto de Partida Prático

O desenvolvedor recomenda começar com um agente pequeno e funcional em vez de um sistema ambicioso. Eles sugerem construir algo que leia e-mails noturnos e escreva um resumo matinal de um parágrafo como primeiro projeto.

O post completo inclui um passo a passo detalhado da construção de um primeiro agente e detalha todos os 9 erros. O desenvolvedor observa que Wiz permanece um projeto pessoal, não algo sendo lançado publicamente.