Guía: instalar Voxelwright AI, conectar Claude y construir

¿Qué necesitas para usar Voxelwright AI?

Para usar Voxelwright AI necesitas Minecraft: Java Edition 26.3, un cargador de mods (Fabric, Forge o NeoForge), Java 25 y una suscripción de Claude Pro, Max, Team o Enterprise con Claude Code. El mismo archivo de Voxelwright AI funciona con los tres cargadores, y Voxelwright AI en sí es gratis. Qué cargador elegir.

• Minecraft: Java Edition 26.3. Minecraft ahora se numera por año: 26 significa 2026, y no existe la 1.26. Solo sirven la 26.3 y sus correcciones (26.3.1 y siguientes), no la 1.21.x, la 26.1 ni la 26.2.
• Un cargador de mods: Fabric, Forge o NeoForge. Fabric: Loader 0.19.5 o posterior, y Fabric API (obligatoria). Forge: 66 o posterior. NeoForge: 26.3.0.52-beta o posterior (NeoForge para la 26.3 es una beta). Forge y NeoForge no necesitan nada más. Quilt carga mods de Fabric y debería funcionar (sin probar). Bedrock Edition no es compatible.
• Qué se ha probado. Personas han jugado y probado Voxelwright AI con Fabric, Forge y NeoForge. Forge y NeoForge son nuevos en esta versión: el juego real también ha corrido con ellos en ejecuciones automáticas en un Mac (Apple Silicon), desde un perfil creado por el instalador oficial de cada cargador, iniciado por un script que imita a un lanzador. En esas ejecuciones no se usó ningún lanzador real, y el dictado con un micrófono real no se ha probado con Forge ni NeoForge. Si algo falla, cuéntanoslo: la dirección de contacto está en el aviso legal.
• Java 25, que el lanzador suele traer.
• Una suscripción de Claude: Pro, Max, Team o Enterprise, con Claude Code instalado y con la sesión iniciada (pasos 1 y 3). El plan gratuito no incluye Claude Code.
• Windows, macOS o Linux. Lo han jugado y probado personas en los tres, incluido macOS (Apple Silicon) con Fabric. Las pruebas automáticas también pasan en Windows 10 y en Linux (Intel/AMD y ARM).
• Nada que comprar y nada en lo que registrarse: Voxelwright AI es gratis, sin cuenta y sin clave de licencia.

¿Cómo funciona Voxelwright AI?

Voxelwright AI convierte lo que escribes o dices en bloques en tu mundo, en cuatro pasos:

1. Escribes o dices lo que quieres: pulsa K y descríbelo con tus palabras.
2. El mod pasa tu petición a tu propio Claude Code, con tu suscripción iniciada. Nada pasa por un servidor de Voxelwright AI.
3. Claude planea la construcción y coloca los bloques en tu mundo con las herramientas del mod.
4. Lo ves aparecer, y puedes deshacerlo con el botón Deshacer o con /undo.

• Cuánto tarda: una cabaña tarda alrededor de un minuto; un castillo, muchos minutos. En Ajustes, en Nivel de detalle, elige Rápido, Detallado u Obra maestra: cuanto más alto el nivel, más tarda.
• Con prudencia: la IA puede ejecutar cualquier comando del juego, así que haz copia de seguridad de tus mundos. Una construcción se puede deshacer; lo que cambia un comando no siempre.

1Instalar Claude Code

Voxelwright AI habla con Claude a través de Claude Code, el programa de Anthropic. Instálalo una vez, en el ordenador en el que juegas. ¿Nunca has usado una terminal? La guía de la terminal de Anthropic (en inglés) muestra cómo abrir una y pegar un comando.

macOS y Linux

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

Windows, en PowerShell

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

Windows, en el Símbolo del sistema (CMD)

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

• En su lugar, en macOS puedes usar Homebrew: brew install --cask claude-code.
• En su lugar, en Windows puedes usar WinGet: winget install Anthropic.ClaudeCode.

1. Pega el comando de tu sistema y pulsa Intro. No hace falta ejecutarlo como administrador.
2. Cuando termine, abre una ventana de terminal nueva y ejecuta el comando de abajo. Un número de versión significa que Claude Code está instalado.

claude --version

2Instalar el mod

Cuatro cosas por hacer: preparar Minecraft 26.3 con Fabric, Forge o NeoForge (A), descargar los archivos (B), ponerlos en la carpeta mods (C) y arrancar el juego (D). El mismo archivo de Voxelwright AI funciona con los tres cargadores. Forge y NeoForge son nuevos: Lo que necesitas dice qué se ha probado y qué no.

A. Preparar Minecraft 26.3 con Fabric: lanzador oficial de Minecraft

1. Descarga el instalador en la página del instalador de Fabric: en Windows el .exe (no necesita su propio Java), en macOS y Linux el archivo Universal / .JAR. En macOS y Linux, Java debe estar ya instalado para ejecutarlo.
2. Cierra Minecraft y su lanzador, y abre el instalador. En Linux, ejecuta en una terminal java -jar seguido del nombre del archivo descargado. En macOS, si Apple dice que no puede verificar el archivo, abre Ajustes del Sistema, luego Privacidad y seguridad, y haz clic en Open Anyway (Abrir de todos modos).
3. En el instalador, elige la versión 26.3 de Minecraft, deja la última versión del Loader que propone (Voxelwright AI necesita la 0.19.5 o posterior), comprueba que Create Profile está marcado y haz clic en Install.
4. Abre el lanzador de Minecraft, elige el nuevo perfil de Fabric (abajo a la izquierda de la lista) y pulsa Jugar; después sal: Fabric está instalado.

A. Preparar Minecraft 26.3 con Forge: lanzador oficial de Minecraft

1. Ejecuta primero el lanzador oficial de Minecraft al menos una vez: el instalador de Forge necesita su lista de perfiles y, sin ella, dice «Please run the Minecraft launcher first» (ejecuta primero el lanzador de Minecraft).
2. Abre la página de descargas de Forge para Minecraft 26.3 y descarga el Installer de la última versión (nosotros probamos la 26.3-66.0.9; Voxelwright AI necesita Forge 66 o posterior). Es un archivo .jar, así que Java debe estar ya instalado para ejecutarlo.
3. Cierra Minecraft y su lanzador, y abre el instalador: haz doble clic, o ejecuta en una terminal java -jar seguido del nombre del archivo descargado. Elige Install client (instalar el cliente) y confirma.
4. Abre el lanzador de Minecraft, elige el nuevo perfil de Forge y pulsa Jugar; después sal.

A. Preparar Minecraft 26.3 con NeoForge: lanzador oficial de Minecraft

1. Ejecuta primero el lanzador oficial de Minecraft al menos una vez: el instalador de NeoForge necesita su lista de perfiles y, sin ella, dice «Please run the Minecraft launcher first» (ejecuta primero el lanzador de Minecraft).
2. Abre neoforged.net: su primera sección es la descarga del instalador. Elige la versión 26.3 de Minecraft y la versión de NeoForge más reciente que muestre (nosotros probamos la 26.3.0.52-beta; Voxelwright AI la necesita o una posterior, y para la 26.3 NeoForge sigue siendo una beta). Es un archivo .jar: Java debe estar ya instalado para ejecutarlo.
3. Cierra Minecraft y su lanzador, y abre el instalador: haz doble clic, o ejecuta en una terminal java -jar seguido del nombre del archivo descargado. Elige Install client (instalar el cliente) y confirma.
4. Abre el lanzador de Minecraft, elige el nuevo perfil de NeoForge y pulsa Jugar: NeoForge muestra en la pantalla de título su propia advertencia roja de beta. Después sal.

A. Preparar Minecraft 26.3 con tu cargador: Prism Launcher, aplicación de Modrinth, CurseForge, Lunar Client

• Prism Launcher: haz clic en Add Instance arriba (o clic derecho en una zona vacía y elige Create instance), y elige Minecraft 26.3 y tu cargador de mods: Fabric, Forge o NeoForge. Si Prism no ofrece tu cargador para la 26.3, usa el lanzador oficial y los instaladores de arriba. Para Java 25, mira la página Installing Java de Prism.
• Aplicación de Modrinth: crea una instancia con Minecraft 26.3 y tu cargador (Fabric, Forge o NeoForge, si la aplicación lo ofrece para la 26.3) (la ayuda de Modrinth).
• Aplicación de CurseForge: en la sección de Minecraft, haz clic en Create, pon nombre al perfil y elige Minecraft 26.3 y tu cargador de mods (Fabric, Forge o NeoForge, si la aplicación lo ofrece para la 26.3) (la ayuda de CurseForge).
• Lunar Client: inicia Minecraft 26.3 con Fabric. No hemos comprobado Lunar Client con Forge ni NeoForge. Los menús de Lunar cambian de una versión a otra: si no encuentras la opción, consulta la ayuda de Lunar.

B. Descargar los archivos

1. En la sección de instalación, haz clic en el botón de descarga: el archivo se llama voxelwright- seguido del número de versión y de .jar, el mismo para Fabric, Forge y NeoForge.
2. Solo con Fabric: abre las versiones de Fabric API en Modrinth, ya filtradas por Minecraft 26.3 y Fabric, y descarga el archivo más reciente cuyo nombre termine en +26.3 (por ejemplo fabric-api-0.163.0+26.3.jar), no otra versión. Prism, la aplicación de Modrinth y CurseForge también pueden descargarlo desde su propia búsqueda de mods: elige el mismo tipo de archivo. Con Forge o NeoForge, sáltate este paso: no necesitan nada más.

C. Ponerlo en la carpeta mods

El .jar de Voxelwright AI va en la carpeta mods del perfil o de la instancia con la que vas a jugar (con Fabric, el .jar de Fabric API va también ahí). Deja solo el voxelwright-*.jar más reciente y elimina cualquier archivo anterior del mod (las versiones anteriores se llamaban craftai-….jar). Si aún no hay carpeta mods, inicia el juego una vez con ese perfil: Forge y NeoForge la crean en ese primer arranque, y el instalador de Fabric la crea. Si sigue sin estar, crea una carpeta llamada mods en la carpeta del juego.

D. Arrancar el juego y comprobar que funcionó

1. Inicia Minecraft 26.3 con el perfil o la instancia de Fabric, Forge o NeoForge donde has puesto el archivo, no con un Minecraft sin mods.
2. Abre un mundo: un mundo de un jugador, o un servidor multijugador donde puedas usar /fill y /setblock.
3. Pulsa K. El panel de Voxelwright AI se abre sobre el juego: ha funcionado. Puedes cambiar la tecla en Opciones → Controles.

3Conecta tu cuenta de Claude

El mod comprueba tu cuenta de Claude por ti y, si no está conectada, te permite conectarla sin salir del juego.

Desde el juego (la forma fácil)

1. Abre un mundo y pulsa K. La pantalla de bienvenida indica tu cuenta de Claude. Si dice Claude: sin sesión, pulsa Iniciar sesión en Claude.
2. Tu navegador se abre en la página de inicio de sesión de Claude. Inicia sesión con la cuenta que tiene tu suscripción y aprueba. Si la página no se ha abierto, pulsa Abrir la página de nuevo.
3. Vuelve al juego: se da cuenta solo. Si la página muestra un código en lugar de terminar, pégalo en el campo de mensaje del panel y pulsa Intro: va directo a Claude Code, nunca a la IA.
4. Compruébalo: la pantalla de bienvenida ahora dice Claude detectado · suscripción Max (o Pro, Team o Enterprise).

Desde una terminal

1. Abre una terminal y ejecuta claude.
2. Escribe /login y elige tu cuenta de Claude (la que tiene la suscripción).
3. Inicia sesión en el navegador y vuelve al juego.

Qué comprueba el mod, y cuándo

• Antes de cada petición que envías, y cuando vuelves a la ventana del juego (por ejemplo después de iniciar sesión en el navegador o en una terminal).
• Cada 10 segundos mientras el panel muestra un problema, y cada 3 minutos en caso contrario. Si tu cuenta cierra la sesión mientras juegas, la conversación te avisa una vez.

Qué dice el panel, y qué hacer

4Tu primera construcción

Tu primera construcción cabe en una frase: pulsa K, describe lo que quieres, pulsa Intro y míralo aparecer. Para escribir una petición más precisa, lee cómo escribir una buena petición.

1. Pulsa K. En el campo de arriba («Describe lo que quieres construir…»), describe lo que quieres, en cualquier idioma: «una torre de mago de piedra con un tejado puntiagudo».
2. Pulsa Intro. La cápsula de la parte superior de la pantalla muestra el progreso. Puedes cerrar el panel y seguir jugando.
3. La construcción aparece bloque a bloque. Cuando termina, se reproduce una breve animación.
4. ¿No es lo que querías? Escribe /undo o abre la pestaña Historial. Describe lo que hay que cambiar e inténtalo de nuevo.

Consejos para construir mejor

• Mira el lugar donde lo quieres y di «aquí» o «allí».
• Para construir dentro de un área exacta, selecciona una zona con /zone wand. En un servidor multijugador, mira dos esquinas y usa /zone 1 y /zone 2.

5Ve más allá

• Voz: mantén V, di lo que quieres y suelta. Tus palabras se convierten en la petición. Funciona en tu ordenador: tu voz nunca sale de él.
• Deshacer y rehacer: /undo, /redo o la pestaña Historial. Escribe / en el campo para ver todos los comandos.
• Modelo: elige el modelo de Claude en Ajustes o con /model.
• Multijugador: funciona en servidores donde puedes usar /fill y /setblock. No se instala nada en el servidor: el mod construye desde tu ordenador, con tus propios permisos. Un jugador que no es operador construye a razón de un comando por segundo, aproximadamente.
• Actualizaciones: el mod te avisa cuando sale una versión nueva, y un clic la instala, con Fabric, Forge y NeoForge (probado con ejecuciones automáticas en un Mac). La actualización sustituye el archivo antiguo: la carpeta mods se queda con exactamente un archivo de Voxelwright AI, y la versión anterior va a config/craftai-update/previous. El juego sigue con la versión antigua hasta que lo reinicies. Escribe /update para comprobarlo.
• Saber más: cómo construir en Minecraft con una IA, cómo escribir una buena petición, construcciones reales con su petición y su tiempo, construir con la voz, usarlo en un servidor multijugador y Fabric, Forge o NeoForge para Minecraft 26.3.

Solución de problemas