# Cómo usar Claude Code con Unity Engine — AI Game Dev Conecta Claude Code a Unity Engine con AI Game Developer: instalación, configuración y tu primera inspección de escena con IA. Esta página se tradujo automáticamente del inglés. [Lee el original en inglés](https://ai-game.dev/blog/claude-code-unity-tutorial). [Blog](https://ai-game.dev/es/blog) Conecta Claude Code a Unity Engine con AI Game Developer: instalación, configuración y tu primera inspección de escena con IA. Ivan Murzak · 12 de enero de 2026 · 5 min de lectura · **Actualizado el 17 de octubre de 2026.** Desde Unity-MCP 1.0.0, el agente lee y edita escenas, GameObjects, componentes y assets mediante RQL (rql-query, rql-mutate, rql-schema) en lugar de una herramienta por operación. Los pasos de configuración que siguen no han cambiado y los ejemplos de CLI usan los nombres de herramientas actuales. Consulta ai-game.dev/docs/rql. Claude Code es uno de los mejores agentes de IA disponibles, impulsado por modelos como Opus 4.5. En este tutorial lo conectamos directamente a Unity Engine para que pueda leer tus escenas, llamar a las API de Unity y modificar tu proyecto, todo desde la terminal. ## Lo que necesitas - Unity 2021.3 o superior - Node.js ^20.19.0 o >=22.12.0 (para la CLI) - Claude Code instalado (agente de IA basado en terminal) - AI Game Developer — el puente entre los agentes de IA y Unity: [github.com/IvanMurzak/Unity-MCP](https://github.com/IvanMurzak/Unity-MCP) ## Instalar AI Game Developer AI Game Developer funciona como un puente entre agentes y modelos de IA avanzados y Unity Engine. Puedes instalarlo manualmente desde el Unity Editor o usar la CLI para una configuración totalmente automatizada. ### Opción A: instalación manual (Unity Editor) 1. Descarga el instalador desde la página de GitHub de AI Game Developer 2. Haz doble clic en el archivo del instalador para abrirlo en Unity 3. Haz clic en "Import" en la ventana de importación de Unity 4. Espera a que Unity termine de compilar ### Opción B: instalación con la CLI (recomendada) La herramienta unity-mcp-cli automatiza toda la configuración desde la línea de comandos, sin necesidad de hacer clic manualmente. Instálala de forma global y úsala para añadir el plugin a cualquier proyecto de Unity. Bash Terminal ```bash # Install the CLI globally npm install -g unity-mcp-cli # Install the AI Game Developer plugin into your Unity project unity-mcp-cli install-plugin ./MyUnityProject ``` El comando install-plugin modifica directamente el archivo Packages/manifest.json de tu proyecto: añade el registro con ámbito de OpenUPM y la dependencia del plugin. Nunca degrada una instalación existente. Después de ejecutarlo, abre el proyecto en Unity para completar la instalación del paquete. ## Configurar la conexión Una vez importado el paquete, aparece la ventana de AI Game Developer. Desplázate hacia abajo hasta la sección de Claude Code y haz clic en "Configure": esa es toda la configuración necesaria. Después haz clic en "Connect" para iniciar el proceso de conexión. Al principio verás errores porque Claude Code todavía no se está ejecutando; es lo esperado. ### CLI: configurar MCP para Claude Code La CLI puede configurar automáticamente la integración de MCP para Claude Code, sin necesidad de usar la interfaz del Unity Editor. Escribe los archivos de configuración correctos para que Claude Code descubra el servidor de AI Game Developer al iniciarse. Bash Terminal ```bash # Configure Claude Code MCP integration unity-mcp-cli setup-mcp claude-code ./MyUnityProject # Generate skill files so Claude Code knows about available tools unity-mcp-cli setup-skills claude-code ./MyUnityProject ``` ## Iniciar Claude Code Puedes iniciar Claude Code desde Visual Studio Code o directamente desde la terminal. Para este tutorial usamos el enfoque de la terminal. Abre la terminal en la carpeta de tu proyecto de Unity; puedes hacerlo haciendo clic derecho en la carpeta Assets de Unity, seleccionando "Show in Explorer" y luego haciendo clic derecho y eligiendo "Open in Terminal". Bash Terminal ```bash # Navigate to your Unity project folder and start Claude Code cd /path/to/your/unity/project claude ``` Cuando Claude Code se inicie, el estado en la ventana de AI Game Developer cambiará a "Connected". Para comprobar que todo funciona, escribe /mcp en Claude Code: deberías ver "AI Game Developer" en la lista y conectado. ## Probar la IA en tu escena de Unity Con la conexión establecida, prueba a preguntarle a la IA algo como "¿Qué ves en esta escena del proyecto de Unity?". La IA usará las herramientas MCP que proporciona AI Game Developer para leer la jerarquía de tu escena, inspeccionar los GameObjects y contarte lo que encuentra. Itera paso a paso: lee los datos de la escena, examina los objetos anidados y construye una imagen completa de tu proyecto. Cuando Claude Code solicite permiso para usar una herramienta, puedes elegir la opción 2 para permitirlo y omitir las solicitudes futuras de esa misma herramienta. Después, la IA leerá tu escena, identificará objetos como mallas, luces y jerarquías anidadas, y ofrecerá una descripción detallada de todo lo que encontró. ## Optimizar el contexto AI Game Developer expone muchas herramientas MCP a la IA. Un consejo clave: desactiva las herramientas que no necesites. Cada herramienta activa consume contexto de la IA, y mantener el contexto limpio permite que la IA trabaje con más eficiencia y produzca mejores resultados. Puedes activar y desactivar herramientas en la ventana de AI Game Developer, o usar la CLI. Bash Terminal ```bash # List current tool/prompt/resource configuration unity-mcp-cli configure ./MyUnityProject --list # Enable only the tools you need unity-mcp-cli configure ./MyUnityProject \ --enable-tools rql-query,rql-mutate,rql-schema,script-update-or-create \ --disable-all-prompts # Or enable everything at once unity-mcp-cli configure ./MyUnityProject \ --enable-all-tools \ --enable-all-prompts ``` - Desactiva las herramientas que no uses para mantener ligero el contexto de la IA - Plantea desactivar Resources si no los necesitas - Los prompts son comandos de barra: escribe / en Claude Code para ver comandos disponibles como "configurar una animación" o "añadir un componente" - Revisa el indicador de estado Connected para confirmar que el enlace está activo ## Qué puedes hacer a partir de aquí Con Claude Code conectado a Unity, puedes pedirle a la IA cualquier cosa que permitan las herramientas MCP: inspeccionar escenas, crear GameObjects, modificar componentes, generar animaciones, construir interfaces y mucho más. La IA tiene acceso a un conjunto completo de herramientas y puede invocar cualquiera de ellas a partir de tus peticiones en lenguaje natural. También puedes ejecutar las herramientas MCP directamente desde la línea de comandos, sin pasar por la IA, lo que resulta útil para scripting y pipelines de CI. Bash Terminal ```bash # Check connection status at a glance unity-mcp-cli status ./MyUnityProject # Run an MCP tool directly from the CLI unity-mcp-cli run-tool rql-query ./MyUnityProject --input '{"query":"objects | where name == \"Player\" | select $ref name transform.position"}' # Run Unity tests via MCP unity-mcp-cli run-tool tests-run ./MyUnityProject --input '{"testMode":"EditMode"}' ``` ### Automatización total: de cero a conectado La CLI puede automatizar todo el flujo de trabajo: crear un proyecto, instalar el plugin, configurar Claude Code, abrir Unity, esperar la conexión y ejecutar herramientas. Aquí tienes un script completo que lo configura todo desde cero. Bash full-setup.sh ```bash # 1. Create a new Unity project unity-mcp-cli create-project ./MyAIGame --unity 6000.3.1f1 # 2. Install the AI Game Developer plugin unity-mcp-cli install-plugin ./MyAIGame # 3. Enable all MCP tools unity-mcp-cli configure ./MyAIGame --enable-all-tools # 4. Configure Claude Code MCP integration unity-mcp-cli setup-mcp claude-code ./MyAIGame # 5. Open the project with MCP connection unity-mcp-cli open ./MyAIGame --keep-connected # 6. Wait for Unity and MCP server to be ready unity-mcp-cli wait-for-ready ./MyAIGame # 7. Generate Claude Code skills unity-mcp-cli setup-skills claude-code ./MyAIGame # 8. Verify by running a tool unity-mcp-cli run-tool tests-run ./MyAIGame --input '{"testMode":"EditMode"}' ``` ## Empezar AI Game Developer es de código abierto. Instala el paquete de Unity, configura Claude Code y empieza a escribir prompts. La herramienta CLI está disponible en npm para flujos de trabajo automatizados. Consulta la guía de inicio rápido en [ai-game.dev/docs/quickstart](https://ai-game.dev/docs/quickstart) para ver las instrucciones de configuración detalladas. - AI Game Developer (Unity-MCP): [github.com/IvanMurzak/Unity-MCP](https://github.com/IvanMurzak/Unity-MCP) - Extensión de animación con IA: [github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md](https://github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md) - Herramienta CLI: [npmjs.com/package/unity-mcp-cli](https://npmjs.com/package/unity-mcp-cli) - Descarga: [ai-game.dev/download](https://ai-game.dev/download) - Siguiente: generar animaciones con IA — [ai-game.dev/blog/generating-unity-animations-with-ai](https://ai-game.dev/blog/generating-unity-animations-with-ai) ## Más del blog [Todas las entradas](https://ai-game.dev/es/blog) ### [De imágenes de referencia a un modelo 3D listo para el juego: Tripo AI dentro de AI Game Developer](https://ai-game.dev/es/blog/tripo-ai-3d-models-from-reference-images) 26 de octubre de 2026 Convierte de dos a cuatro vistas en un modelo 3D con Tripo en AI Game Developer y luego texturízalo, límpialo, rígcalo y anímalo en el mismo chat. Ivan Murzak 7 min de lectura ### [Planifica primero, luego cambia: el modo plan para agentes de IA en el desarrollo de juegos](https://ai-game.dev/es/blog/plan-mode-ai-agent-game-development) 26 de octubre de 2026 Usa el modo plan, preguntas de aclaración, cola de mensajes y tarjetas de revisión en AI Game Developer para controlar al agente en tareas grandes. Ivan Murzak 6 min de lectura --- Source (HTML): https://ai-game.dev/es/blog/claude-code-unity-tutorial Machine-translated (es) from the English page: https://ai-game.dev/blog/claude-code-unity-tutorial