Démarrage rapide
Bienvenue dans la documentation officielle de Kalvyx. Ce guide te permettra d'être opérationnel en moins de 5 minutes.
Kalvyx est un bot Discord propulsé par Claude AI d'Anthropic. Il offre des conversations intelligentes, des outils créatifs et des utilitaires pratiques directement dans ton serveur.
Kalvyx utilise les slash commands Discord (/commande). Tape simplement / dans n'importe quel salon pour voir toutes les commandes disponibles.
Habitué à un préfixe ? Les commandes rapides répondent aussi à k? — par ex. k?help ou k?ping. Pour tout le reste, Kalvyx te renvoie vers la slash command équivalente.
Installation
L'installation de Kalvyx sur ton serveur Discord se fait en quelques clics. Aucune configuration technique requise.
Clique sur "Ajouter à Discord"
Rends-toi sur kalvyx.com et clique sur le bouton "Ajouter à Discord". Tu seras redirigé vers la page d'autorisation Discord officielle.
Sélectionne ton serveur
Dans la liste déroulante, choisis le serveur sur lequel tu veux ajouter Kalvyx. Tu dois avoir les permissions "Gérer le serveur" sur ce serveur.
Accorde les permissions
Valide les permissions demandées puis clique sur "Autoriser". Kalvyx a besoin de lire et envoyer des messages, utiliser les slash commands et accéder aux threads.
C'est prêt !
Kalvyx rejoint ton serveur et enregistre automatiquement toutes ses slash commands. Attends 1-2 minutes si les commandes n'apparaissent pas immédiatement (délai Discord).
Premières commandes
Voici les commandes essentielles pour commencer à utiliser Kalvyx sur ton serveur.
Demander quelque chose à l'IA
/ask [question] — Pose une question directe à Kalvyx
C'est la commande la plus utilisée. Tu peux poser n'importe quelle question : définitions, calculs, conseils, explications...

Démarrer une conversation
/ia conversation [message] — Démarre une conversation avec mémoire contextuelle
Contrairement à /ask, Kalvyx se souvient des derniers messages de votre conversation (de 5 à 200 selon ton abonnement) pour des réponses plus cohérentes.
Obtenir de l'aide
/help — Affiche la liste complète des commandes
Mentionner le bot
Tu peux aussi mentionner directement @Kalvyx dans un message pour lui parler sans slash command.
Catégories de commandes
En situation
Voir la liste complète sur la page Fonctionnalités.
Conversation IA
Kalvyx conserve en mémoire tes derniers messages (de 5 à 200 selon ton abonnement) pour des échanges cohérents et contextuels.
Limites de tokens
Chaque commande IA consomme des tokens Anthropic. Un système de facturation intégré limite l'utilisation pour préserver les ressources du serveur. Les limites sont généralement très largement suffisantes pour un usage normal.
Cache intelligent
Kalvyx dispose d'un système de cache qui mémorise les réponses aux questions fréquentes, réduisant le temps de réponse et la consommation de ressources.
Modèle utilisé : claude-haiku-4-5-20251001 (Anthropic)
Délai de réponse moyen : < 2 secondes
Historique de conversation : 5 à 200 messages (selon le plan)
Cache : actif
Commandes utilitaires
Kalvyx propose plusieurs commandes utilitaires pour gérer tes données et ton activité sur le serveur.
| Commande | Description |
|---|---|
| /note | Créer et gérer des notes personnelles |
| /reminder | Programmer un rappel avec délai personnalisé |
| /userinfo | Afficher les informations d'un utilisateur Discord |
| /stats | Consulter les statistiques d'utilisation du bot |
| /encode | Encoder ou décoder du texte (Base64, URL, etc.) |
Sécurité serveur
Kalvyx protège ton serveur contre les raids, les bots indésirables et les liens d'invitation non sollicités. Tout se configure par commande ou depuis le module Sécurité du tableau de bord — les deux pilotent exactement les mêmes réglages.
Centre de sécurité — /serveur securite
Une seule commande ouvre un panneau interactif qui regroupe l'Anti-Raid, l'Anti-Bot et le Lockdown. Tout se règle depuis l'embed (menu déroulant, boutons, formulaires) — inutile de retenir plusieurs commandes.
/serveur securite — Ouvre le centre de sécurité (Anti-Raid · Anti-Bot · Lockdown)
Commande réservée aux administrateurs. Les trois modules restent aussi pilotables individuellement :
/antiraid — Détection des vagues de connexions (joins massifs)
/antibot — Kick automatique des bots non whitelistés
/serveur lockdown — Verrouille les arrivées (kick des nouveaux membres)
Anti-lien Discord — /serveur anti-lien
Bloque les liens d'invitation Discord (discord.gg/…) postés sur ton serveur. Kalvyx crée et gère pour toi une règle AutoMod native de Discord : elle apparaît dans Paramètres du serveur → Modération AutoMod et le filtrage est assuré par Discord lui-même.
/serveur anti-lien etat — Voir la configuration
/serveur anti-lien activer — Activer (crée la règle AutoMod)
/serveur anti-lien desactiver — Désactiver (retire la règle)
/serveur anti-lien salon [salon] — Salon où les blocages sont notifiés
/serveur anti-lien message [texte] — Message affiché au membre bloqué
/serveur anti-lien exempter — Exempter un rôle / salon / catégorie
/serveur anti-lien ne-plus-exempter — Retirer une exemption
Pour que l'anti-lien fonctionne, Kalvyx doit disposer de la permission « Gérer le serveur ». Sans elle, la règle AutoMod ne peut pas être créée — la commande te le signale clairement.
Questions fréquentes
Kalvyx est gratuit à ajouter et à utiliser sans carte bancaire. Le palier Free donne accès à 20 appels IA / jour, mémoire courte (24h), modèle Haiku — largement suffisant pour découvrir le bot.
Pour aller plus loin, des abonnements Premium optionnels existent (à partir de 3,99 $US/mois) : plus d'appels IA, mémoire 7 jours, modèle Sonnet, /imagine, /ia research, journal premium, identité visuelle serveur, persona personnalisée… Voir tous les tarifs.
Vérifie que le bot est bien en ligne (pastille verte sur son profil). Assure-toi aussi qu'il a les permissions de lire et envoyer des messages dans le salon où tu écris. Si le problème persiste, attends quelques minutes — il y a peut-être une surcharge momentanée.
Les slash commands Discord peuvent mettre jusqu'à 1 heure à se propager après l'ajout du bot. Essaie de recharger Discord (Ctrl+R) ou de redémarrer l'application. Si le problème dure plus d'une heure, contacte le support.
Non. Kalvyx n'a accès qu'aux messages dans les salons où il a été invité et uniquement aux messages qui lui sont adressés (slash commands ou mentions). Il ne scanne pas les conversations générales de ton serveur.
L'historique est automatiquement limité aux derniers messages (de 5 à 200 selon ton abonnement) et se renouvelle à chaque nouvelle session. Pour repartir à zéro, démarre simplement une nouvelle conversation avec /ia conversation.
Oui ! Tu peux ajouter Kalvyx sur autant de serveurs que tu veux. Chaque serveur a ses propres paramètres et logs indépendants.
Free (0 $) — découverte, 20 appels IA/jour + tous les modules communautaires de base. Allié (3,99 $US/mo) — 80 appels IA/jour, /imagine 2/j, /ia analyse 5/j, mémoire long-terme cross-serveurs, profil perso. Compagnon (7,99 $US/mo) — 200 appels IA/jour, modèle Sonnet, /ia analyse (image) & /ia research. Côté serveur (par serveur) : Essentiel (4,99 $US/mo) — toutes les fonctions communautaires avancées (tickets illimités, image de bienvenue personnalisée, rôles par niveau XP, logs multi-salons, anti-raid avancé, flux sociaux, compteurs, etc.) ; IA (6,99 $US/mo) — salon Ask Kalvyx, boost membres ×1,2, branding + persona custom de l'IA ; Complet (9,99 $US/mo) — Essentiel + IA réunis. Détail complet sur la page tarifs.
Utilise /premium dans n'importe quel salon. Tu vois ton tier, tes avantages, tes quotas du jour avec barres de progression, et un bouton vers la page tarifs si tu veux upgrade.
Tout passe par Discord directement — pas de Stripe externe, pas de carte saisie sur le site. Discord facture ton moyen de paiement habituel et te redonne accès aux avantages instantanément. Tu peux annuler en un clic depuis tes paramètres Discord.
Discord ne supporte que l'USD comme devise pour les abonnements de bots. Discord convertit automatiquement dans ta devise locale lors du paiement.
Oui. Si tu as Compagnon (perso) sur un serveur IA (ou Complet), tu cumules : plus d'appels IA, modèle Sonnet sur tes commandes, et les outils serveur (salon Ask Kalvyx, plus identité visuelle et persona personnalisée avec IA/Complet).
Tu gardes l'accès jusqu'à la fin de ta période payée. Ensuite tu reviens au palier Free, et ton profil personnalisé reste sauvegardé pour si tu reprends plus tard. Aucune donnée perdue.
Oui, c'est non négociable. Aucun contenu de journal n'est jamais loggé en clair — les logs internes sont systématiquement nettoyés des champs sensibles. Les entrées sont stockées en MongoDB avec une expiration automatique de 180 jours, et tu peux supprimer une entrée à tout moment avec /journal supprimer.
Oui, avec l'abonnement Compagnon. Tu peux joindre une image (jpg, png, gif, webp jusqu'à 5 MB), un PDF (jusqu'à 10 MB) ou un fichier texte (jusqu'à 200 KB) aux commandes /ask, /ia code et /ia conversation message via l'option fichier.
Kalvyx est nativement intégré à Discord (slash commands, mentions, embeds), utilise Claude AI d'Anthropic (réputé pour ses réponses nuancées et sûres), et propose des fonctionnalités uniques comme /journal avec récap hebdo personnalisé, le centre de sécurité unifié /serveur securite, ou la persona serveur custom. Et il reste 100 % gratuit sur le palier Free.
Dépannage
"Une erreur s'est produite"
Ce message apparaît quand l'API Anthropic est temporairement indisponible ou surchargée. Attends 30 secondes et réessaie. Si ça persiste plus de 5 minutes, contacte le support.
"Cooldown actif"
Pour éviter les abus, chaque commande a un cooldown de 5 secondes par utilisateur. Attends quelques instants avant de relancer la commande.
"Accès refusé"
Tu es peut-être dans la blacklist du bot. Un utilisateur blacklisté ne peut plus utiliser aucune commande. Contacte le propriétaire du bot (signale via /report ou le serveur support) — il peut vérifier ton statut avec /serveur blacklist check et te retirer de la liste avec /serveur blacklist remove.
Obtenir de l'aide
Si tu rencontres un problème non couvert par cette documentation, plusieurs options s'offrent à toi.
/report/help ou les infos du bot avec /botinfo.