Créer un Agent IA Personnel avec Claude Code : Leçons de 6 Mois chez Wiz

Un développeur a partagé son parcours de six mois pour créer Wiz, un agent IA personnel utilisant Claude Code à la fois comme environnement de développement et comme environnement d'exécution. Le projet a commencé avec une vision ambitieuse de "Jarvis d'Iron Man" mais a évolué vers un système pratique pour un usage quotidien.

Ce que fait réellement Wiz

Wiz est un agent IA personnel construit sur Claude Code qui fonctionne de manière autonome pour les tâches de routine. Le système gère les rapports matinaux, les résumés du soir, le tri des boîtes de réception et diverses expériences. Pour les travaux créatifs ou sensibles à la qualité, le développeur reste dans la boucle.

Implémentation technique

L'architecture est volontairement simple :

• Claude Code sert de cadre/framework
• CLAUDE.md contient le fichier d'instructions
• La mémoire réside dans des fichiers markdown
• Les outils sont implémentés sous forme de scripts dans des dossiers

Processus de développement avec Claude Code

Le développeur a utilisé Claude Code de manière extensive tout au long du projet :

• La commande /init a généré le premier fichier CLAUDE.md en une seule fois
• Lorsqu'un débogage était nécessaire, les erreurs étaient recollées dans Claude Code pour diagnostic
• Claude Code a écrit la plupart du code, le développeur révisant chaque fichier et corrigeant les problèmes

Erreurs clés et leçons

Le développeur a identifié 9 erreurs spécifiques qui ont causé des problèmes :

• Laisser Claude générer le premier CLAUDE.md sans révision attentive - a conduit à des heures de débogage à cause d'une seule mauvaise phrase
• Permettre à l'auto-amélioration de réécrire les instructions principales sans garde-fous - a fait dériver le système dans plusieurs directions
• Exécuter Opus sur chaque petite requête jusqu'à atteindre les limites d'utilisation avant le déjeuner - résolu en implémentant un routage des modèles (petit/local pour les tâches simples, Sonnet pour le travail général, Opus pour les appels complexes)
• Essayer de construire "Jarvis" dès le premier jour au lieu de procéder progressivement - a coûté environ trois mois de temps de développement
• Mettre un appel LLM à chaque étape de chaque pipeline alors que la plupart auraient dû être de simples scripts

Point de départ pratique

Le développeur recommande de commencer avec un agent petit mais fonctionnel plutôt qu'avec un système ambitieux. Il suggère de construire quelque chose qui lit les emails de la nuit et rédige un résumé matinal d'un paragraphe comme premier projet.

L'article complet comprend une marche à pas pour construire un premier agent et détaille les 9 erreurs. Le développeur note que Wiz reste un projet personnel, et non quelque chose qui sera publié publiquement.