Guía: conecta Claude y construye

Lo que necesitas

• Minecraft: Java Edition 26.3 con Fabric (Fabric Loader 0.19.5 o posterior, y Fabric API). CRAFT AI no funciona con Forge ni con NeoForge.
• Java 25, que el lanzador suele traer.
• Una suscripción de Claude: Pro, Max, Team o Enterprise. El plan gratuito no incluye Claude Code.
• Una licencia de CRAFT AI: 15 €, de pago único, para un solo ordenador.

1Instala Claude Code

CRAFT AI habla con Claude a través de Claude Code. Instálalo una sola vez, en el ordenador en el que juegas.

1. Abre la página de Claude Code y sigue el instalador de tu sistema. En Windows, usa el instalador nativo.
2. Comprueba que ha funcionado: abre una terminal y ejecuta el comando de abajo. Si aparece un número de versión, Claude Code está instalado.

claude --version

2Instala el mod

1. En la sección Instalar, descarga el archivo de CRAFT AI y Fabric API, e instala Fabric Loader para Minecraft 26.3 si aún no lo tienes.
2. Pon los dos archivos .jar en la carpeta mods de tu perfil de Fabric y elimina cualquier craftai-*.jar anterior. La carpeta habitual es %appdata%\.minecraft\mods en Windows, ~/Library/Application Support/minecraft/mods en macOS y ~/.minecraft/mods en Linux. Con otro lanzador (Lunar, Prism, Modrinth, CurseForge), usa la carpeta mods de tu perfil.
3. Inicia Minecraft 26.3 con Fabric y abre un mundo. Pulsa K para abrir el panel de CRAFT AI (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 y escribe que has iniciado sesión. Si la página muestra un código en lugar de terminar, copia el código y pégalo en el campo de mensaje del panel, luego 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. El juego lo comprueba de nuevo en cuanto vuelves a su ventana.

Qué comprueba el mod, y cuándo

• Antes de cada petición que envías, para que el panel nunca esté desactualizado.
• 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

4Activa tu licencia

1. En la página de Cuenta, inicia sesión o crea una cuenta y compra tu licencia (15 €, pago único). Tu clave de licencia aparece en tu página de cuenta.
2. En el juego, pulsa K, pega la clave en el campo de arriba (dice «Pega aquí tu clave de licencia…») y pulsa Intro. La licencia queda vinculada a este ordenador.
3. Para comprobarla en cualquier momento, escribe /license. Para usar CRAFT AI en otro ordenador, escribe /license release en el primero.

5Tu primera construcció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í». La IA ve lo que miras y un mapa de lo que te rodea.
• Sé concreto con el estilo y los materiales: «una pagoda japonesa de madera oscura y yeso blanco sobre la colina».
• Elige el nivel de detalle en Ajustes, en Nivel de detalle. Más detalle tarda más.
• 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.

6Ve 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. Escribe /update para comprobarlo.

Solución de problemas