Guide : installer Voxelwright AI, connecter Claude et construire

De quoi as-tu besoin pour utiliser Voxelwright AI ?

Pour utiliser Voxelwright AI, il te faut Minecraft : Java Edition 26.3, un chargeur de mods (Fabric, Forge ou NeoForge), Java 25 et un abonnement Claude Pro, Max, Team ou Enterprise avec Claude Code. Le même fichier Voxelwright AI marche avec les trois chargeurs, et Voxelwright AI lui-même est gratuit. Quel chargeur choisir.

• Minecraft : Java Edition 26.3. Minecraft est désormais numéroté par année : 26 veut dire 2026, et il n’existe pas de 1.26. Seules la 26.3 et ses correctifs (26.3.1 et suivants) conviennent, pas 1.21.x, 26.1 ni 26.2.
• Un chargeur de mods : Fabric, Forge ou NeoForge. Fabric : Loader 0.19.5 ou plus récent, et Fabric API (obligatoire). Forge : 66 ou plus récent. NeoForge : 26.3.0.52-beta ou plus récent (NeoForge pour la 26.3 est une bêta). Forge et NeoForge n’ont besoin de rien d’autre. Quilt charge les mods Fabric et devrait fonctionner (non testé). Bedrock Edition n’est pas pris en charge.
• Ce qui a été essayé. Voxelwright AI a été joué et testé par des personnes avec Fabric, Forge et NeoForge. Forge et NeoForge sont nouveaux dans cette version : ils ont aussi tourné dans des exécutions automatiques du vrai jeu sur un Mac (Apple Silicon), depuis un profil créé par l’installateur officiel de chaque chargeur, lancé par un script qui imite un lanceur. Ces exécutions n’ont pas utilisé de vrai lanceur, et la dictée avec un vrai micro n’a pas été essayée avec Forge ni NeoForge. Si quelque chose ne va pas, dis-le-nous : l’adresse de contact figure dans les mentions légales.
• Java 25, que le lanceur apporte en général.
• Un abonnement Claude : Pro, Max, Team ou Enterprise, avec Claude Code installé et connecté (étapes 1 et 3). L’offre gratuite n’inclut pas Claude Code.
• Windows, macOS ou Linux. Il a été joué et testé par des personnes sur les trois, dont macOS (Apple Silicon) avec Fabric. Les tests automatiques passent aussi sous Windows 10 et sous Linux (Intel/AMD et ARM).
• Rien à acheter, aucun compte à créer : Voxelwright AI est gratuit, sans compte et sans clé de licence.

Comment fonctionne Voxelwright AI ?

Voxelwright AI transforme ce que tu écris ou dis en blocs dans ton monde, en quatre étapes :

1. Tu écris ou tu dis ce que tu veux : appuie sur K, puis décris-le avec tes mots.
2. Le mod transmet ta demande à ton propre Claude Code, connecté avec ton abonnement. Rien ne passe par un serveur Voxelwright AI.
3. Claude prévoit la construction et place les blocs dans ton monde, grâce aux outils du mod.
4. Tu le regardes apparaître, et tu peux l’annuler avec le bouton Annuler ou avec /undo.

• Combien de temps ça prend : une cabane prend environ une minute, un château de nombreuses minutes. Dans Réglages, sous Niveau de détail, choisis Rapide, Détaillé ou Chef-d'œuvre : plus le niveau est haut, plus c’est long.
• Sois prudent : l’IA peut lancer n’importe quelle commande du jeu, alors sauvegarde tes mondes. Une construction s’annule ; ce qu’une commande change ne s’annule pas toujours.

1Installer Claude Code

Voxelwright AI parle à Claude par l’intermédiaire de Claude Code, le programme d’Anthropic. Installe-le une fois, sur l’ordinateur sur lequel tu joues. Les terminaux, c’est nouveau pour toi ? Le guide du terminal d’Anthropic (en anglais) montre comment en ouvrir un et y coller une commande.

macOS et Linux

curl -fsSL https://claude.ai/install.sh | bash

Windows, dans PowerShell

irm https://claude.ai/install.ps1 | iex

Windows, dans l’Invite de commandes (CMD)

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

• À la place, sur macOS, tu peux utiliser Homebrew : brew install --cask claude-code.
• À la place, sur Windows, tu peux utiliser WinGet : winget install Anthropic.ClaudeCode.

1. Colle la commande de ton système et appuie sur Entrée. Pas besoin de la lancer en administrateur.
2. Quand elle se termine, ouvre une nouvelle fenêtre de terminal, puis lance la commande ci-dessous. Un numéro de version veut dire que Claude Code est installé.

claude --version

2Installer le mod

Quatre choses à faire : préparer Minecraft 26.3 avec Fabric, Forge ou NeoForge (A), télécharger les fichiers (B), les mettre dans le dossier mods (C), lancer le jeu (D). Le même fichier Voxelwright AI marche avec les trois chargeurs. Forge et NeoForge sont nouveaux : Ce qu’il te faut dit ce qui a été essayé et ce qui ne l’a pas été.

A. Préparer Minecraft 26.3 avec Fabric : lanceur Minecraft officiel

1. Télécharge l’installateur sur la page de l’installateur Fabric : sous Windows le .exe (il n’a pas besoin de son propre Java), sous macOS et Linux le fichier Universal / .JAR. Sous macOS et Linux, Java doit déjà être installé pour le lancer.
2. Ferme Minecraft et son lanceur, puis ouvre l’installateur. Sous Linux, lance java -jar suivi du nom du fichier téléchargé dans un terminal. Sous macOS, si Apple dit ne pas pouvoir vérifier le fichier, ouvre Réglages Système, puis Confidentialité et sécurité, et clique sur Open Anyway (Ouvrir quand même).
3. Dans l’installateur, choisis la version 26.3 de Minecraft, garde la dernière version du Loader qu’il propose (Voxelwright AI demande la 0.19.5 ou plus récente), vérifie que Create Profile est coché, et clique sur Install.
4. Ouvre le lanceur Minecraft, choisis le nouveau profil Fabric (en bas à gauche de la liste) et clique sur Jouer, puis quitte : Fabric est installé.

A. Préparer Minecraft 26.3 avec Forge : lanceur Minecraft officiel

1. Lance d’abord le lanceur Minecraft officiel au moins une fois : l’installateur de Forge a besoin de sa liste de profils et, sans elle, dit « Please run the Minecraft launcher first » (lance d’abord le lanceur Minecraft).
2. Ouvre la page de téléchargement de Forge pour Minecraft 26.3 et télécharge l’Installer de la dernière version (nous avons essayé la 26.3-66.0.9 ; Voxelwright AI demande Forge 66 ou plus récent). C’est un fichier .jar : Java doit déjà être installé pour le lancer.
3. Ferme Minecraft et son lanceur, puis ouvre l’installateur : double-clique dessus, ou lance java -jar suivi du nom du fichier téléchargé dans un terminal. Choisis Install client (installer le client) et valide.
4. Ouvre le lanceur Minecraft, choisis le nouveau profil Forge et clique sur Jouer, puis quitte.

A. Préparer Minecraft 26.3 avec NeoForge : lanceur Minecraft officiel

1. Lance d’abord le lanceur Minecraft officiel au moins une fois : l’installateur de NeoForge a besoin de sa liste de profils et, sans elle, dit « Please run the Minecraft launcher first » (lance d’abord le lanceur Minecraft).
2. Ouvre neoforged.net : sa première section est le téléchargement de l’installateur. Choisis la version 26.3 de Minecraft et la version de NeoForge la plus récente qu’elle liste (nous avons essayé la 26.3.0.52-beta ; Voxelwright AI la demande ou une plus récente, et pour la 26.3 NeoForge est encore une bêta). C’est un fichier .jar : Java doit déjà être installé pour le lancer.
3. Ferme Minecraft et son lanceur, puis ouvre l’installateur : double-clique dessus, ou lance java -jar suivi du nom du fichier téléchargé dans un terminal. Choisis Install client (installer le client) et valide.
4. Ouvre le lanceur Minecraft, choisis le nouveau profil NeoForge et clique sur Jouer : NeoForge affiche sur l’écran-titre son propre avertissement rouge de bêta. Puis quitte.

A. Préparer Minecraft 26.3 avec ton chargeur : Prism Launcher, application Modrinth, CurseForge, Lunar Client

• Prism Launcher : clique sur Add Instance en haut (ou fais un clic droit dans une zone vide et choisis Create instance), puis choisis Minecraft 26.3 et ton chargeur de mods : Fabric, Forge ou NeoForge. Si Prism ne propose pas ton chargeur pour la 26.3, utilise le lanceur officiel et les installateurs ci-dessus. Pour Java 25, voir la page Installing Java de Prism.
• Application Modrinth : crée une instance avec Minecraft 26.3 et ton chargeur (Fabric, Forge ou NeoForge, si l’application le propose pour la 26.3) (l’aide de Modrinth).
• Application CurseForge : dans la section Minecraft, clique sur Create, donne un nom au profil, puis choisis Minecraft 26.3 et ton chargeur de mods (Fabric, Forge ou NeoForge, si l’application le propose pour la 26.3) (l’aide de CurseForge).
• Lunar Client : lance Minecraft 26.3 avec Fabric. Nous n’avons pas vérifié Lunar Client avec Forge ni NeoForge. Les menus de Lunar changent d’une version à l’autre : si tu ne trouves pas l’option, consulte l’aide de Lunar.

B. Télécharger les fichiers

1. Dans la section Installation, clique sur le bouton de téléchargement : le fichier s’appelle voxelwright- suivi du numéro de version et de .jar, le même pour Fabric, Forge et NeoForge.
2. Avec Fabric seulement : ouvre les versions de Fabric API sur Modrinth, déjà filtrées sur Minecraft 26.3 et Fabric, et télécharge le fichier le plus récent dont le nom se termine par +26.3 (par exemple fabric-api-0.163.0+26.3.jar), pas une autre version. Prism, l’application Modrinth et CurseForge peuvent aussi le télécharger depuis leur propre recherche de mods : choisis le même type de fichier. Avec Forge ou NeoForge, passe cette étape : ils n’ont besoin de rien d’autre.

C. Le mettre dans le dossier mods

Le .jar de Voxelwright AI va dans le dossier mods du profil ou de l’instance avec lequel tu joueras (avec Fabric, le .jar de Fabric API y va aussi). Ne garde que le voxelwright-*.jar le plus récent et supprime tout ancien fichier du mod (les versions précédentes se nommaient craftai-….jar). S’il n’y a pas encore de dossier mods, démarre le jeu une fois avec ce profil : Forge et NeoForge le créent à ce premier lancement, et l’installateur de Fabric le crée. S’il manque toujours, crée un dossier nommé mods dans le dossier du jeu.

D. Lancer le jeu, et vérifier que ça a marché

1. Démarre Minecraft 26.3 avec le profil ou l’instance Fabric, Forge ou NeoForge où tu as mis le fichier, pas un Minecraft simple.
2. Ouvre un monde : un monde solo, ou un serveur multijoueur où tu peux utiliser /fill et /setblock.
3. Appuie sur K. Le panneau Voxelwright AI s’ouvre par-dessus le jeu : c’est que ça a marché. 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. Si la page affiche un code au lieu de se terminer, colle le code dans le champ de message du panneau et 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.

Ce que le mod vérifie, et quand

• Avant chaque demande que tu envoies, et 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

4Ta première construction

Ta première construction tient en une phrase : appuie sur K, décris ce que tu veux, appuie sur Entrée et regarde-la apparaître. Pour écrire une demande plus précise, lis comment écrire une bonne demande.

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 ».
• 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.

5Aller 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, avec Fabric, Forge et NeoForge (essayé par des exécutions automatiques sur un Mac). La mise à jour remplace l’ancien fichier : le dossier mods garde exactement un fichier Voxelwright AI, et la version précédente va dans config/craftai-update/previous. Le jeu continue de tourner avec l’ancienne version jusqu’à ce que tu le relances. Tape /update pour vérifier.
• En savoir plus : comment construire dans Minecraft avec une IA, comment écrire une bonne demande, de vraies constructions avec leur demande et leur durée, construire à la voix, l’utiliser sur un serveur multijoueur et Fabric, Forge ou NeoForge pour Minecraft 26.3.

Dépannage