Créer un bot Discord avec Claude Code : le guide complet 2026

Créer un bot Discord avec Claude Code : de l'idée au bot en ligne

Vous animez un serveur Discord — une communauté, une classe, une équipe, un projet open source — et vous rêvez d'un bot qui accueille les nouveaux membres, lance des commandes utiles, va chercher des données en direct ou modère automatiquement les salons. Écrire tout cela à la main demande de configurer discord.js, comprendre la passerelle temps réel, enregistrer chaque commande slash, gérer les événements… Bonne nouvelle : c'est exactement le type de travail que Claude Code abat en quelques prompts bien cadrés.

Dans ce guide 2026, on construit ensemble un bot Discord complet en Node.js, avec des commandes slash, une connexion à une API externe et un hébergement 24/7 — le tout en pilotant Claude Code plutôt qu'en tapant chaque ligne. Vous repartirez avec une méthode reproductible pour tous vos futurs bots.

Sommaire

Ce qu'est un bot Discord en 2 minutes {#bot-discord-concepts}

Avant de lancer l'agent, fixons le vocabulaire pour pouvoir relire ce que Claude Code produit — c'est la clé pour garder le contrôle.

Un bot Discord est un programme qui se connecte à Discord comme un utilisateur automatisé. Il maintient une connexion permanente à la passerelle (gateway) de Discord et réagit à des événements : un message posté, un membre qui rejoint le serveur, une réaction ajoutée, une commande lancée.

Les briques à connaître :

Notre stack pour ce guide : Node.js + discord.js (la bibliothèque de référence), des commandes slash pour l'interaction, et un hébergeur Node.js pour le faire tourner en continu. Claude Code connaît parfaitement ces conventions — à condition de le lui demander explicitement.

Créer l'application sur le portail Discord {#portail-discord}

Cette étape se fait dans le navigateur, Claude Code ne peut pas la faire à votre place — mais il peut vous guider si vous lui décrivez ce que vous voyez.

Notez au passage l'Application ID (onglet General Information) : Claude Code en aura besoin pour enregistrer les commandes slash.

Préparer le projet avec Claude Code {#preparer-projet}

Ouvrez un dossier vide et lancez Claude Code. La première règle d'or : poser le contexte avant de générer quoi que ce soit. Créez (ou demandez à Claude de créer) un fichier CLAUDE.md décrivant votre projet :

# Bot Discord — contexte projet

Stack : Node.js 24, discord.js v14, ES modules.
Style : async/await, pas de callbacks, un fichier par commande.
Structure : commandes dans src/commands, événements dans src/events,
un fichier deploy-commands.js pour enregistrer les slash commands.
Sécurité : token et clés d'API via .env (jamais en clair), .env dans .gitignore.

Ce fichier oriente toutes les générations suivantes. Si vous débutez avec l'outil, notre guide Claude Code pour débutants explique comment installer le CLI et lancer votre première session. Et pour formuler des demandes qui donnent du bon code du premier coup, lisez comment écrire un bon prompt pour Claude Code.

Étape 1 : générer le squelette discord.js {#etape-1-squelette}

Donnez à Claude Code un objectif clair et complet. Un bon prompt de démarrage :

« Initialise un projet Node.js pour un bot Discord avec discord.js v14. Crée le client avec les intents Guilds et GuildMessages, charge dynamiquement les commandes depuis src/commands, connecte le bot avec le token depuis .env, et ajoute une commande /ping qui répond "Pong !" avec la latence. Ajoute aussi un fichier deploy-commands.js pour enregistrer les commandes slash. »

Claude Code va créer l'arborescence, installer discord.js et dotenv, écrire le point d'entrée (index.js), le chargeur de commandes, la commande /ping et le script d'enregistrement. Il vous rappellera de créer le fichier .env :

DISCORD_TOKEN=votre_token_ici
CLIENT_ID=votre_application_id
GUILD_ID=id_de_votre_serveur_de_test

Lancez ensuite l'enregistrement des commandes puis le bot :

node deploy-commands.js
node index.js

Tapez /ping dans votre serveur : le bot répond. Vous venez de valider toute la chaîne — token, connexion, commande — en une seule session. Si une erreur apparaît (intent manquant, token invalide), collez le message d'erreur à Claude Code : il diagnostique et corrige immédiatement.

Étape 2 : créer les commandes slash {#etape-2-commandes}

Le cœur d'un bot utile, ce sont ses commandes. Avec le squelette en place, en ajouter une nouvelle est trivial. Demandez par exemple :

« Ajoute une commande /sondage qui prend une question et jusqu'à 4 options en paramètres, poste un embed avec la question et ajoute automatiquement les réactions correspondantes pour voter. »

Claude Code crée un nouveau fichier dans src/commands, définit les options de la commande (paramètres typés : chaîne, entier, utilisateur…), construit un embed (message enrichi avec titre, couleur, champs) et gère les réactions. Comme le chargeur est dynamique, il suffit de relancer deploy-commands.js pour que la commande apparaisse.

Quelques idées de commandes que Claude Code génère en un prompt chacune :

À chaque ajout, pensez à relire le code : Claude Code respecte-t-il bien votre structure ? Gère-t-il le cas où l'utilisateur ne fournit pas d'option ? Cette relecture est ce qui distingue un bot bricolé d'un bot maintenable.

Étape 3 : connecter le bot à une API externe {#etape-3-api}

Un bot devient vraiment intéressant quand il va chercher des données en direct. Météo, cours d'une crypto, statut d'un service, résultats sportifs, données métier… tout ce qui expose une API peut alimenter une commande.

Demandez à Claude Code :

« Ajoute une commande /meteo qui prend une ville en paramètre, appelle une API météo publique, et renvoie la température et les conditions dans un embed. Gère les erreurs (ville introuvable, API indisponible) proprement. »

Claude Code écrit l'appel HTTP (avec fetch natif de Node), parse la réponse JSON, formate l'embed et gère les cas d'erreur. Il place la clé d'API dans le .env plutôt que dans le code. Ce schéma — *commande → appel API → réponse formatée* — se réplique pour n'importe quelle source de données.

La logique est identique à celle d'un backend classique : si vous voulez comprendre comment Claude Code structure les appels réseau, la validation et la gestion d'erreurs côté serveur, notre article sur créer une API REST avec Claude Code détaille la même démarche pour le back-end. Et pour choisir une source de données bien conçue à consommer, une API documentée comme ImmoAPI — endpoints clairs, pagination, réponses JSON propres — donne un bon modèle de ce à quoi une API prête pour la production doit ressembler.

**Vous voulez déléguer toute la chaîne technique — du squelette du bot à sa mise en ligne — plutôt que de bloquer sur chaque erreur d'intent ou de déploiement ?** Découvrez [comment vous faire remplacer par l'IA](https://go.saas-ia.io/se-faire-remplacer-par-lia) sur la partie développement et infrastructure, et gardez votre énergie pour l'animation de votre communauté.

Étape 4 : gérer les événements et la modération {#etape-4-evenements}

Au-delà des commandes, un bot réagit à ce qui se passe sur le serveur. C'est le rôle des événements. Deux classiques :

Claude Code crée les gestionnaires d'événements correspondants (guildMemberAdd, messageCreate) dans src/events, en respectant la structure définie dans votre CLAUDE.md. Pour la modération, pensez à lui demander de journaliser les actions dans un salon dédié : vous gardez ainsi une trace des messages supprimés.

Un bot Discord bien pensé est une petite brique d'automatisation : il exécute des tâches répétitives à votre place, en continu. C'est la même philosophie que celle des agents autonomes — si le sujet des agents IA open-source et auto-hébergés vous intéresse, la ressource Formation OpenClaw explore comment orchestrer des agents pour l'entreprise, une logique complémentaire de celle d'un bot de communauté.

Étape 5 : héberger le bot 24/7 {#etape-5-hebergement}

Un bot ne sert à rien s'il s'éteint quand vous fermez votre ordinateur. Il doit tourner en permanence sur un serveur distant. Claude Code prépare le déploiement en un prompt :

« Prépare le déploiement de ce bot sur Railway. Crée un Dockerfile Node.js léger, un fichier .dockerignore, et documente les variables d'environnement à configurer. »

Claude Code génère un Dockerfile multi-étapes (image finale légère), la liste des variables à renseigner côté hébergeur (DISCORD_TOKEN, CLIENT_ID, clés d'API) et les commandes de démarrage. Les options courantes en 2026 :

Si vous voulez maîtriser la conteneurisation de bout en bout, notre guide conteneuriser une application avec Docker et Claude Code applique exactement cette démarche. Pensez à ne jamais committer votre .env : configurez les secrets directement dans le tableau de bord de l'hébergeur.

Bonnes pratiques et pièges à éviter {#bonnes-pratiques}

Quelques réflexes pour un bot fiable et sûr :

Le piège le plus fréquent chez les débutants : oublier de relancer deploy-commands.js après avoir ajouté une commande. Les commandes slash doivent être réenregistrées auprès de Discord pour apparaître. Si une commande ne s'affiche pas, c'est presque toujours ça.

Le bot en action (vidéo) {#video}

Rien ne vaut une démonstration pour voir l'enchaînement complet — du projet vide au programme qui tourne. Cette vidéo de la chaîne Sophiène IA montre comment piloter Claude Code pour construire et livrer un projet de bout en bout, une méthode directement transposable à la création d'un bot Discord décrite ici :

Conclusion : votre bot Discord en ligne aujourd'hui

Créer un bot Discord n'est plus réservé aux développeurs chevronnés. En pilotant Claude Code étape par étape — créer l'application sur le portail, générer le squelette discord.js, ajouter des commandes slash, brancher une API, gérer les événements, puis héberger le tout 24/7 — vous passez d'un dossier vide à un bot en production en une seule session.

Le vrai changement de posture : vous ne cherchez plus des bouts de code sur des forums pour les coller sans les comprendre. Vous décrivez, relisez et validez. La plomberie technique — intents, enregistrement des commandes, conteneurisation, secrets — devient une conversation. Ouvrez un dossier vide, lancez Claude Code, et donnez-lui son premier objectif : « crée un bot Discord avec une commande /ping ». Votre premier bot est à quelques prompts.

FAQ : créer un bot Discord avec Claude Code {#faq}