Guide : connecter Claude et construire

Ce qu’il te faut

• Minecraft : Java Edition 26.3 avec Fabric (Fabric Loader 0.19.5 ou plus récent, et Fabric API). CRAFT AI ne marche pas avec Forge ni NeoForge.
• Java 25, que le lanceur apporte en général.
• Un abonnement Claude : Pro, Max, Team ou Enterprise. L’offre gratuite n’inclut pas Claude Code.
• Une licence CRAFT AI : 15 €, payés une seule fois, pour un seul ordinateur.

1Installer Claude Code

CRAFT AI parle à Claude par l’intermédiaire de Claude Code. Installe-le une fois, sur l’ordinateur où tu joues.

1. Ouvre la page de Claude Code et suis l’installateur de ton système. Sous Windows, utilise l’installateur natif.
2. Vérifie que ça a marché : ouvre un terminal et lance la commande ci-dessous. Un numéro de version veut dire que Claude Code est installé.

claude --version

2Installer le mod

1. Dans la section Installer, télécharge le fichier CRAFT AI et Fabric API, et installe Fabric Loader pour Minecraft 26.3 si ce n’est pas déjà fait.
2. Mets les deux fichiers .jar dans le dossier mods de ton profil Fabric, et retire tout ancien craftai-*.jar. Le dossier habituel est %appdata%\.minecraft\mods sous Windows, ~/Library/Application Support/minecraft/mods sous macOS et ~/.minecraft/mods sous Linux. Avec un autre lanceur (Lunar, Prism, Modrinth, CurseForge), utilise le dossier mods de ton profil.
3. Lance Minecraft 26.3 avec Fabric et ouvre un monde. Appuie sur K pour ouvrir le panneau CRAFT AI (tu peux changer la touche dans Options → Contrôles).

3Connecter ton compte Claude

Le mod vérifie ton compte Claude pour toi et, s’il n’est pas connecté, te laisse le connecter sans quitter le jeu.

Depuis le jeu (le plus simple)

1. Ouvre un monde et appuie sur K. L’écran d’accueil nomme ton compte Claude. S’il affiche Claude : pas connecté, clique sur Se connecter à Claude.
2. Ton navigateur s’ouvre sur la page de connexion de Claude. Connecte-toi avec le compte qui a ton abonnement et valide. Si la page ne s’est pas ouverte, clique sur Rouvrir la page.
3. Reviens dans le jeu. Il s’en rend compte tout seul et écrit que tu es connecté. Si la page affiche un code au lieu de se terminer, copie le code et colle-le dans le champ de message du panneau, puis appuie sur Entrée : il va directement à Claude Code, jamais à l’IA.
4. Vérifie : l’écran d’accueil affiche maintenant Claude détecté · abonnement Max (ou Pro, Team, Enterprise).

Depuis un terminal

1. Ouvre un terminal et lance claude.
2. Tape /login et choisis ton compte Claude (celui qui a l’abonnement).
3. Connecte-toi dans le navigateur, puis reviens dans le jeu. Il regarde de nouveau dès que tu retournes dans sa fenêtre.

Ce que le mod vérifie, et quand

• Avant chaque demande que tu envoies, pour que le panneau ne soit jamais en retard.
• Quand tu reviens dans la fenêtre du jeu, par exemple après t’être connecté dans le navigateur ou un terminal.
• Toutes les 10 secondes tant que le panneau montre un problème, et toutes les 3 minutes sinon.
• Si ton compte se déconnecte pendant que tu joues, la conversation te le dit une fois.

Ce que dit le panneau, et quoi faire

4Activer ta licence

1. Sur la page Compte, connecte-toi ou crée un compte, puis achète ta licence (15 €, une seule fois). Ta clé de licence apparaît sur ta page Compte.
2. Dans le jeu, appuie sur K, colle la clé dans le champ du haut (il affiche « Colle ici ta clé de licence… ») et appuie sur Entrée. La licence est rattachée à cet ordinateur.
3. Pour la vérifier à tout moment, tape /license. Pour utiliser CRAFT AI sur un autre ordinateur, tape /license release sur le premier.

5Ta première construction

1. Appuie sur K. Dans le champ du haut (« Décris ce que tu veux construire… »), décris ce que tu veux, dans la langue de ton choix : « une tour de mage en pierre avec un toit pointu ».
2. Appuie sur Entrée. La capsule en haut de l’écran montre l’avancement. Tu peux fermer le panneau et continuer à jouer.
3. La construction apparaît bloc par bloc. Une courte animation se joue quand elle est terminée.
4. Ce n’est pas ce que tu voulais ? Tape /undo, ou ouvre l’onglet Historique. Décris ce qu’il faut changer et recommence.

Des conseils pour de meilleures constructions

• Regarde l’endroit où tu veux construire et dis « ici » ou « là-bas ». L’IA voit ce que tu regardes et une carte de tes environs.
• Sois précis sur le style et les matériaux : « une pagode japonaise en bois sombre et plâtre blanc sur la colline ».
• Choisis le niveau de détail dans Réglages, sous Niveau de détail. Plus de détails prend plus de temps.
• Pour construire dans une zone exacte, sélectionne une zone avec /zone wand. Sur un serveur multijoueur, regarde deux coins et utilise /zone 1 et /zone 2.

6Aller plus loin

• La voix : maintiens V, dis ce que tu veux, relâche. Tes mots deviennent la demande. Elle tourne sur ton ordinateur : ta voix n’en sort jamais.
• Annuler et rétablir : /undo, /redo, ou l’onglet Historique. Tape / dans le champ pour voir toutes les commandes.
• Le modèle : choisis le modèle de Claude dans Réglages, ou avec /model.
• Le multijoueur : ça marche sur les serveurs où tu as le droit d’utiliser /fill et /setblock. Rien n’est installé sur le serveur : le mod construit depuis ton ordinateur, avec tes droits. Un joueur qui n’est pas opérateur construit à environ une commande par seconde.
• Les mises à jour : le mod te dit quand une nouvelle version est sortie, et un clic l’installe. Tape /update pour vérifier.

Dépannage