Claude · Agents

Brancher Claude sur WhatsApp en 30 minutes, sans coder

Un agent WhatsApp qui répond à tes clients 24/7. Le repo fait le boulot, tu suis les 7 étapes depuis ton terminal.

QQuentin Megevand
24 mai 2026 · 4 min de lecture

Un agent WhatsApp custom, sans dev, sans no-code payant

whatsapp-agentkit, c'est un repo open source (par Hainrixz) qui te livre toute la plomberie d'un agent IA WhatsApp clé en main : serveur FastAPI, mémoire SQLite par numéro de téléphone, intégration Twilio ou Meta Cloud API, et Claude (sonnet-4-6) comme cerveau. Tu poses tes API keys, tu décris ton business, et l'agent répond à tes clients à ta place.

Deux chemins selon ton setup : Claude Code qui scaffold tout en autonomie sur ta machine, ou Cowork (l'app Claude) qui te sert de copilote pour copier-coller les commandes dans ton terminal. Même résultat, même repo, juste deux niveaux d'autonomie.

Claude AI Lab

Le Claude AI Lab, c'est ma communauté Skool où je partage mes systèmes Claude et les modules plus avancés. L'entrée est gratuite.

Rejoindre le Lab →
30 min
du clone au premier message
0
ligne de code à écrire
24/7
agent dispo une fois déployé

L'agent gère la mémoire conversationnelle par client (chaque numéro a son historique), charge tes fichiers business (menu PDF, FAQ, tarifs) dans son contexte, et tu peux lui donner une personnalité custom via un YAML. Déploiement final sur Railway pour passer en prod, avec un sandbox Twilio gratuit pour tester sans carte bancaire.

Le truc à comprendre

Le repo est conçu pour être piloté par Claude. Que tu utilises Claude Code ou Cowork, Claude lit le projet, te pose 10 questions sur ton business, et configure tout en suivant tes réponses. Tu n'as qu'à valider et copier-coller.

A

Voie A · Claude Code — le setup autonome

🔗 github.com/Hainrixz/whatsapp-agentkit
⚙️7 étapes en autopilote depuis ton terminal
1
Installe Python 3.11+ et Node.js. Vérifie avec python3 --version et node --version. Sur Mac, brew install python node fait l'affaire.
2
Installe Claude Code en global. Une commande, suivie d'un login Anthropic au lancement : npm install -g @anthropic-ai/claude-code
3
Clone le repo et lance start.sh. Le script vérifie ton environnement et te dit si quelque chose manque : git clone https://github.com/Hainrixz/whatsapp-agentkit.git puis cd whatsapp-agentkit && bash start.sh
4
Lance Claude Code dans le dossier. Tape claude dans le terminal. Claude lit le repo, te pose 10 questions sur ton business (nom, secteur, ton, horaires, objectif de l'agent, fichiers à ingérer).
5
Donne tes 3 API keys quand il les demande. Anthropic (sk-ant-...) depuis platform.anthropic.com. Twilio (Account SID + Auth Token + Phone, sandbox gratuit) ou Meta Cloud API (Access Token + Phone Number ID + Verify Token).
6
Test local en terminal (avant WhatsApp). Simule une conversation sans toucher à WhatsApp, pour valider la personnalité et les réponses : python tests/test_local.py
7
Deploy sur Railway et branche le webhook. Claude Code te génère les commandes pour push sur GitHub, te guide pour lier le repo à railway.app, et te dicte l'URL webhook à coller dans Twilio ou Meta. Tu reçois ton premier vrai message.
B

Voie B · Cowork — le setup copilote

💡Sans Claude Code, fais de Cowork ton assistant terminal

Pas de Claude Code sur ta machine ? L'app Cowork (Claude.ai web ou desktop) peut te dicter exactement les mêmes étapes. Tu colles dans ton terminal, tu lui renvoies la sortie, il te débloque. C'est plus manuel, mais ça marche.

⚙️6 étapes en copilote
1
Ouvre un nouveau chat dans Cowork. Sur claude.ai ou l'app desktop. Bascule sur le modèle Sonnet 4.6 ou Opus 4.7 pour la qualité d'exécution.
2
Donne-lui le contexte du repo. Colle l'URL github.com/Hainrixz/whatsapp-agentkit et écris : « Pilote-moi étape par étape pour cloner ce repo, installer les dépendances, configurer mon business et déployer l'agent. Je n'ai pas Claude Code, je vais copier-coller chaque commande dans mon terminal. »
3
Réponds à son interview business. Cowork va te poser les mêmes 10 questions : nom du business, secteur, persona de l'agent, ton (pro / friendly / vendeur), horaires, fichiers à charger dans knowledge/. Il prépare le contenu de config/business.yaml et config/prompts.yaml à coller.
4
Configure ton .env sous sa dictée. Il t'envoie le template .env avec les variables (ANTHROPIC_API_KEY, TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_PHONE, ou META_ACCESS_TOKEN, META_PHONE_NUMBER_ID, META_VERIFY_TOKEN). Tu remplis avec tes vraies keys, tu sauves.
5
Lance le test local et debug avec lui. Tape python tests/test_local.py et colle la sortie dans Cowork. Si ça crashe, il lit l'erreur et te donne le fix. Si l'agent répond bizarre, il ajuste le YAML prompts.yaml avec toi.
6
Deploy Railway + webhook avec son checklist. Demande-lui : « Donne-moi la checklist exacte pour pousser sur GitHub, brancher Railway, configurer les env vars en prod, et coller mon webhook dans Twilio. » Tu suis ligne par ligne.
Mon retour d'expérience

Cowork ajoute 10 à 15 minutes vs Claude Code (allers-retours copier-coller), mais reste largement sous l'heure. Si tu ne fais ça qu'une fois, Cowork suffit. Si tu en bâtis plusieurs, installe Claude Code.

Tu veux aller plus loin ?

Et au quotidien, je partage un reel par jour sur Instagram : @quentin_iamarketing