Cómo Instalar Claude Code en Unreal Engine 5.8: Guía Completa (MCP, VibeUE y UnrealClaude)

Instalar Claude Code Unreal Engine 5.8 conecta a Claude con el editor vía Model Context Protocol (MCP): puede mover actores, crear materiales y compilar Blueprints directo desde texto plano. Esta guía te lleva paso a paso por toda la instalación: el MCP nativo del motor, el plugin VibeUE que lo expande, y UnrealClaude, un panel de chat opcional dentro del propio editor.

Incluye cada error real que nos encontramos instalando esto en un proyecto de Unreal Engine 5.8 sobre Windows 11, con su solución exacta, no la versión idealizada de un video de tres minutos. Vas a terminar con Claude Code corriendo por fuera del editor: la configuración con más poder real, porque combina acceso a archivos, terminal y git con control en vivo de la escena abierta.

Esta guía escrita es la base del tutorial en video que vamos a publicar próximamente en este mismo blog, quedate atento.

>>¿Qué es MCP y por qué le importa a quien trabaja en Unreal Engine?

MCP (Model Context Protocol) es, en el fondo, un traductor: un canal por el que Claude le puede decir a Unreal Engine “mueve ese actor”, “crea este material”, “compila este Blueprint”, y el motor lo entiende y lo ejecuta. Sin MCP, Claude solo puede hablar en texto; con MCP, puede actuar dentro del editor.

>>Tres piezas, tres trabajos distintos

Pieza	Qué hace
MCP nativo	Viene incluido en UE 5.8, no es un plugin externo. Expone Blueprints, PCG, Niagara, materiales y capturas anotadas directo desde el motor. Es la base sobre la que corren las otras dos piezas.
VibeUE	Expande el MCP nativo con lo que a Epic todavía le falta: Python arbitrario, importar GLB, control fino de materiales/terreno, y una biblioteca extendida de skills. 33 categorías de herramientas.
UnrealClaude	Panel de chat dentro del editor (Tools → Claude Assistant). Capa de conveniencia: interfaz visual, capturas del viewport, ejecutar scripts con confirmación. Plugin comunitario, código abierto, opcional.

Consejo: No compiten entre sí. El orden que mejor funciona en la práctica: dejar que el agente use el MCP nativo primero, y recurrir a VibeUE solo para lo que el nativo no cubre. UnrealClaude es un extra opcional encima de todo esto.

>>Requisitos antes de instalar Claude Code en Unreal Engine

Revisa esta lista antes de empezar, instalar estas piezas a mitad de camino es lo que más tiempo hace perder.

Requisito	Detalle
Unreal Engine	5.8 (esta guía está probada en 5.8; UnrealClaude está hecho oficialmente para 5.7, ver la nota más abajo)
Cuenta Claude	Suscripción Pro/Max, o una API key de Anthropic
Git	Git para Windows instalado y en el PATH
Node.js	Versión LTS (18 o superior)
Visual Studio	La edición Community más reciente (gratis), no alcanza con solo “Build Tools”, con dos componentes individuales extra: .NET Framework 4.6.2 SDK y el build tools MSVC v143 más reciente (v14.44+)
Cuenta VibeUE	Gratis, en vibeue.com/dashboard, la creas tú mismo. Solo hace falta para las herramientas de terreno real; el resto de VibeUE funciona sin ella
Tiempo	~60 min la primera vez (hay dos compilaciones de C++ de por medio)

>>Los 3 modos de usar Claude Code Unreal Engine

Esta es la parte que más confunde al empezar. Hay tres formas distintas de usar Claude con tu proyecto, y no hacen lo mismo.

>>Modo 1: Solo dentro del editor (panel UnrealClaude)

Puede: mover, crear y borrar actores en la escena abierta; editar Blueprints, materiales y animaciones ya existentes; tomar capturas del viewport.
No puede: crear un proyecto nuevo ni instalar/compilar plugins; usar asistentes de la UI como “Add Content Pack”; tocar archivos fuera de Content/.

>>Modo 2: Solo por fuera, sin conectar (terminal, sin .mcp.json)

Puede: acceso real a archivos, terminal, git, compiladores; instalar y compilar plugins de C++; editar .ini, .uproject, cualquier archivo.
No puede: “ver” el editor abierto en vivo ni mover nada en la escena, no hay canal MCP conectado.

>>Modo 3: Por fuera, conectado al editor en vivo, el modo recomendado

Con el editor abierto y el servidor MCP corriendo, Claude Code, corriendo afuera, en tu terminal, se conecta directo al mismo endpoint que usan VibeUE y el panel de adentro. Resultado: acceso completo a archivos y terminal a la vez que control en vivo de la escena. Es lo que armamos en el paso 4 de esta guía.

Por qué pasa esto: el panel de adentro (y cualquier conexión MCP) corre en un sandbox: cada acción tiene que existir como una “herramienta” (tool) registrada en el servidor. Si Epic o el plugin no expusieron esa función como tool, Claude simplemente no tiene forma de hacerla, por más que se lo pidas de mil maneras distintas.

Regla práctica: ¿vas a instalar algo, compilar, o mover un template entero? Necesitas el modo ② como mínimo. ¿Vas a pedir cambios en una escena ya abierta, aprovechando terminal y git al mismo tiempo? Usa el modo ③, es la configuración con más poder real. El modo ① es solo para una conversación rápida sin salir del editor.

>>Paso 1 de 5, Prepara tu proyecto con Git

Un solo paso, pero es el que te salva si algo sale mal más adelante: así puedes volver atrás con un git reset si un plugin o un cambio rompe algo.

cd "ruta\a\TuProyecto"
git init
git add .
git commit -m "Estado inicial antes de instalar Claude"

Agrega también un .gitignore de Unreal para evitar subir carpetas de caché pesadas (Binaries, Intermediate, Saved, DerivedDataCache).

>>Paso 2 de 5, Instala UnrealClaude (panel de chat dentro del editor)

Repositorio: github.com/Natfii/UnrealClaude, código abierto, licencia MIT.

Importante: UnrealClaude está hecho oficialmente para UE 5.7. En 5.8 compila, pero hay que parchear 6 archivos por un cambio interno de Epic en la API de JSON (tabla de problemas más abajo). Si tu proyecto ya es 5.7, te saltas ese problema por completo.

1. Cierra Unreal Editor. Windows bloquea los archivos del plugin si el editor tiene el proyecto abierto.
2. Clona el repositorio dentro de Plugins/, desde la carpeta del proyecto:

git clone --recurse-submodules https://github.com/Natfii/UnrealClaude.git Plugins/_src_UnrealClaude

3. Compílalo con RunUAT (reemplaza la ruta del motor si la tuya es distinta):

"C:\Program Files\Epic Games\UE_5.8\Engine\Build\BatchFiles\RunUAT.bat" BuildPlugin ^
  -Plugin="Plugins\_src_UnrealClaude\UnrealClaude\UnrealClaude.uplugin" ^
  -Package="Plugins\_build_UnrealClaude" -TargetPlatforms=Win64

4. Copia el resultado a Plugins/UnrealClaude: Binaries, Resources, Source, el .uplugin del build, más la carpeta Config del código fuente original (el build no la incluye).
5. Instala las dependencias del puente MCP:

cd Plugins\UnrealClaude\Resources\mcp-bridge
npm install

6. Instala la Claude Code CLI (si no la tienes), el panel de adentro necesita este ejecutable:

npm install -g @anthropic-ai/claude-code

7. Abre el proyecto y ve al menú Tools → Claude Assistant.

>>Problemas comunes al compilar UnrealClaude

Si te pasa esto…	Intenta esto
“Device or resource busy” al clonar o mover archivos del plugin	Unreal Editor tiene el proyecto abierto. Ciérralo por completo (revisa que UnrealEditor.exe no siga en el Administrador de tareas) y reintenta.
“Could not find NetFxSDK install dir”	Falta el .NET Framework 4.6.2 SDK (no el runtime, el SDK). Instálalo desde Visual Studio Installer → Componentes individuales.
Busco NetFxSDK en “Componentes individuales” y no aparece	Tienes solo Visual Studio Build Tools, no el IDE completo, ese componente no existe ahí. Instala Visual Studio Community (gratis) además, pueden convivir sin desinstalar nada. No hace falta el workload de C++ en Community si Build Tools ya lo tiene.
“UnrealBuildTool has banned the MSVC 14.40–14.43 toolchains”	Tu compilador de VS está en el rango bloqueado por bugs conocidos. Actualiza a MSVC v143 build tools v14.44 o más nuevo.
Errores C2664 / C2665 mencionando FJsonObjectSharedStringStorage	Cambio de API de JSON en UE 5.8. Envuelve cada Pair.Key problemático con FString(*Pair.Key) en los archivos que marque el compilador.
“‘node’ is not recognized” al correr npm install	El PATH no se actualizó en esta sesión de terminal tras instalar Node. Cierra y abre una terminal nueva, o usa la ruta completa.
Panel dice “Not logged in · Please run /login”	Hay que loguear la CLI desde una terminal real, no desde el panel, ver paso 5.
Un plugin de terceros sin compilar sigue en Plugins/ y el editor se cierra solo después del diálogo de “Missing Modules”	Pon "Enabled": false para ese plugin en el .uproject hasta que compile. Dejarlo “detectado pero no compilado” no es seguro para abrir el editor.

>>Paso 3 de 5, Activa los 4 plugins nativos de MCP e instala VibeUE

Repositorio: github.com/kevinpbuckley/VibeUE (rama 5-8), código abierto, MIT. Sitio: vibeue.com

1. Habilita los plugins nativos de toolsets primero. No es solo uno, son cuatro plugins ya incluidos con el motor bajo Engine/Plugins/Experimental/Toolsets/ (no hay que descargar nada, solo activarlos). Edítalos directo en el Plugins array de tu .uproject, o desde Edit → Plugins.

Plugin	Para qué sirve
ModelContextProtocol	El servidor MCP en sí, expone el editor como herramientas invocables. Es la base; sin este, ningún otro toolset tiene por dónde hablar.
EditorToolset	Herramientas generales del editor: actores, Blueprints, materiales, capturas del viewport.
MCPClientToolset	Genera la configuración de cliente (.mcp.json) para conectar Claude Code u otros clientes MCP desde fuera del editor.
NiagaraToolsets	Herramientas para crear y editar sistemas de partículas (Niagara), humo, polvo, chispas, vía MCP.

2. Activa el auto-inicio del servidor. Edit → Editor Preferences → General → Model Context Protocol → activa Auto Start Server. Endpoint por defecto: http://127.0.0.1:8000/mcp.

3. Clona VibeUE dentro de Plugins/ y compílalo con el mismo método RunUAT que UnrealClaude:

cd Plugins
git clone -b 5-8 https://github.com/kevinpbuckley/VibeUE.git VibeUE

"C:\Program Files\Epic Games\UE_5.8\Engine\Build\BatchFiles\RunUAT.bat" BuildPlugin ^
  -Plugin="Plugins\VibeUE\VibeUE.uplugin" ^
  -Package="Plugins\_build_VibeUE" -TargetPlatforms=Win64

A diferencia de UnrealClaude, el repo de VibeUE ya tiene la estructura correcta, solo copia la carpeta Binaries generada dentro de Plugins/VibeUE/.

4. Crea tu cuenta y copia tu API key en vibeue.com/dashboard, esto lo tienes que hacer tú, ningún asistente puede crear cuentas por ti. Solo hace falta para las herramientas de terreno real (GPS/heightmaps); el resto de VibeUE funciona sin ella.

5. Pega la API key en el editor: Edit → Editor Preferences → busca “VibeUE” en la barra lateral → pega la key.

Para confirmar que el servidor está vivo, con el editor abierto:

curl http://127.0.0.1:8000/mcp

Un 405 Method Not Allowed es buena señal, significa que el endpoint existe y solo acepta POST, no GET.

>>Paso 4 de 5, Conecta Claude Code por fuera del editor (recomendado)

El paso que resume esta guía: en vez de depender del panel de adentro, conecta tu Claude Code de terminal directo al MCP nativo que ya está corriendo.

1. Abre el proyecto en el editor y confirma que el servidor MCP está activo (paso anterior).
2. Genera la configuración de cliente desde la consola del editor. Ábrela con la tecla acento grave (`) y ejecuta:

ModelContextProtocol.GenerateClientConfig ClaudeCode

Esto escribe un archivo .mcp.json en la raíz del proyecto con la conexión ya configurada. También acepta Cursor, VSCode, Gemini, Codex, o All para generarlos todos.

3. Abre una terminal en la carpeta del proyecto (no dentro de Unreal) y arranca Claude Code normalmente:

cd "ruta\a\TuProyecto"
claude

4. Claude detecta el .mcp.json solo. Con el editor abierto, las herramientas de MCP nativo (y VibeUE, si está instalado) quedan disponibles en esta sesión, sin pasar por el panel de adentro. Esto vale sea que estés en una terminal pelada, en Claude Desktop, o en cualquier otra interfaz de Claude Code: lo que importa es que sea un cliente que arrancó afuera del editor y detectó el .mcp.json.

Consejo: si el servidor no arrancó solo, ejecuta ModelContextProtocol.StartServer en la misma consola del editor para levantarlo a mano.

No lo confundas con la captura del panel de adentro: ahí se ve el editor de Unreal completo, con el panel como una pestaña más adentro de él. Esta captura es lo opuesto: una ventana de cliente externo, que no es parte de la interfaz del editor, mostrando que igual puede usar las herramientas de Unreal.

>>Paso 5 de 5, Inicia sesión en la CLI de Claude

El paso que más gente se salta, y el panel de adentro no funciona sin esto.

No funciona: escribir /login dentro del panel de UnrealClaude. El panel solo reenvía texto a un proceso sin pantalla (no interactivo), no puede abrir un navegador para completar el login ahí adentro.

1. Abre una terminal normal de Windows (PowerShell o CMD, no el panel de Unreal).
2. Ejecuta el login:

claude auth login

3. Autoriza en el navegador que se abre, inicia sesión con tu cuenta de Anthropic ahí mismo. La sesión queda guardada en tu perfil de Windows, no hay que repetirlo.
4. Vuelve a Unreal y manda cualquier mensaje en el panel. Si sigue sin reconocerlo, cierra y vuelve a abrir el editor.

>>Verificación final: checklist de 8 puntos

Si marcas los ocho, tu instalación de Claude Code Unreal Engine quedó bien conectada:

• Node.js y Git responden en terminal (node -v, git --version)
• claude auth login confirma sesión iniciada
• Tools → Claude Assistant abre el panel sin “Not logged in”
• “MCP Tool Status” muestra herramientas disponibles (no un error)
• curl http://127.0.0.1:8000/mcp responde 200 o 405 (no “connection refused”)
• Editor Preferences → VibeUE muestra la API key guardada
• Existe un .mcp.json en la raíz del proyecto y claude lo detecta al arrancar desde esa carpeta
• El Plugins array del .uproject tiene ModelContextProtocol, EditorToolset, MCPClientToolset y NiagaraToolsets, los cuatro con "Enabled": true

>>¿Prefieres que Claude Code se instale solo? Dale este prompt

Dónde pegarlo: abre la app de escritorio de Claude Code, agrega la carpeta de tu proyecto de Unreal Engine con “Add another folder”, y pega el prompt completo en el cuadro de mensaje. No lo pegues en el panel de UnrealClaude dentro del editor, ese panel corre en el modo ② y no puede instalar nada.

Quiero que instales y conectes Claude Code a este proyecto de Unreal Engine.
Antes de tocar nada:

1. Revisa qué versión de Unreal Engine uso (léelo del .uproject) y qué
   herramientas ya tengo instaladas: git, Node.js, Visual Studio y sus
   componentes, y la Claude Code CLI.

2. Si falta algo que se instala a nivel de todo mi sistema (Node.js,
   componentes de Visual Studio), dime exactamente qué falta y por qué,
   y pídeme que lo instale yo mismo, no lo instales tú directamente.

3. Si Unreal Editor está abierto, dime que lo cierre antes de tocar la
   carpeta Plugins (Windows bloquea esos archivos con el editor abierto).

4. Antes de instalar cualquier plugin o mover contenido grande, revisa si
   el proyecto ya tiene git inicializado; si no, inícialo y haz un commit
   de respaldo antes de seguir.

5. Configura primero el MCP nativo de Unreal Engine: los cuatro plugins
   ModelContextProtocol, EditorToolset, MCPClientToolset y NiagaraToolsets
   (ya vienen con el motor, solo hay que activarlos), con Auto Start Server
   activado. Esto va antes que cualquier plugin de terceros.

6. Pregúntame si además quiero instalar VibeUE (más herramientas: Python,
   materiales, terreno) y/o UnrealClaude (panel de chat visual dentro del
   editor). Explícame en una frase para qué sirve cada uno antes de que
   yo decida.

7. Si algo no compila o da un error, no me pegues el error en crudo:
   explícamelo en palabras simples, dime qué vas a intentar, y confirma
   que la solución sí funcionó antes de seguir al siguiente paso.

8. Ve preguntándome antes de cada paso grande, instalar algo, borrar
   contenido, mover un template, en vez de hacerlo todo de una sola vez
   sin avisarme.

9. Al final, ayúdame a crear un archivo CLAUDE.md con lo que hayamos
   aprendido en el proceso (versión de motor, qué se instaló, qué
   problemas resolvimos), para no tener que explicártelo de nuevo la
   próxima vez que abra este proyecto.

Este prompt no le pide a Claude una lista de comandos, le pide un criterio: revisar antes de actuar, pedir permiso para instalar software del sistema, respaldar con git antes de cambios grandes, y explicar los errores en vez de solo mostrarlos.

>>Glosario rápido

• MCP, el “traductor” que conecta a Claude con un programa, en este caso Unreal Engine.
• PCG, Procedural Content Generation, el sistema de Unreal para generar contenido automáticamente a partir de reglas.
• Plugin, una pieza extra que le agregas a Unreal para darle nuevas funciones.
• API key, una contraseña especial que identifica tu cuenta al usar un servicio en línea.
• localhost, “esta misma computadora”; si algo corre en localhost, no sale a internet.
• .mcp.json, archivo de configuración que le dice a Claude Code dónde está el servidor MCP al que debe conectarse.
• CLAUDE.md, un archivo de notas que Claude lee automáticamente al abrir un proyecto, para no tener que explicarle lo mismo cada vez.
• Toolset, un grupo de herramientas MCP relacionadas entre sí (todas las que tocan materiales, o todas las que tocan Niagara, por ejemplo).

>>Preguntas frecuentes

>>¿Necesito saber programar para instalar Claude Code en Unreal Engine?

No, pero ayuda tener nociones básicas de terminal (copiar y pegar comandos, entender qué es una carpeta vs. un archivo). Cada comando de esta guía está pensado para copiarse y pegarse tal cual.

>>¿Es gratis conectar Claude a Unreal Engine?

El MCP nativo, UnrealClaude y VibeUE (sin cuenta) son gratis y de código abierto. Necesitas sí o sí una suscripción Claude Pro/Max o una API key de Anthropic para que Claude responda. La cuenta de VibeUE también es gratuita; solo destraba las herramientas de terreno real.

>>¿Funciona en Mac o Linux, o solo en Windows?

Esta guía está probada en Windows 11. Unreal Engine 5.8 y Claude Code corren también en Mac y Linux, y la lógica general (activar los plugins nativos, generar el .mcp.json, loguear la CLI) aplica igual, pero los comandos de terminal y las rutas de compilación cambian.

>>¿Cuál es la diferencia entre VibeUE y UnrealClaude?

VibeUE expande el MCP nativo con más herramientas (Python arbitrario, materiales, terreno). UnrealClaude es un panel de chat visual dentro del propio editor, pensado como capa de conveniencia. Son complementarios, no hace falta elegir uno solo.

>>¿Es seguro darle a Claude Code acceso a mi proyecto de Unreal Engine?

El servidor MCP corre en localhost, no sale a internet. Cada acción que Claude puede hacer pasa por una herramienta explícitamente registrada, no por acceso libre al sistema. Aun así, conviene iniciar git antes de instalar nada (paso 1) para poder revertir cualquier cambio con un simple git reset.

>>Referencia y enlaces

Recurso	Enlace
UnrealClaude (repo)	github.com/Natfii/UnrealClaude
VibeUE (repo)	github.com/kevinpbuckley/VibeUE
VibeUE (sitio + dashboard)	vibeue.com
Documentación MCP nativo de Epic	dev.epicgames.com, Unreal MCP
Node.js	nodejs.org

Si vienes del mundo del pipeline de arte para videojuegos, quizás también te interese nuestra guía de pipeline completo de un hero prop, de Blender a Unreal Engine 5.