Claude para Godot: cómo crear un juego de Godot con Claude Code, paso a paso

Claude para Godot funciona hasta que el juego tiene que ejecutarse

Pídele a Claude Code un doble salto en un plataformas de Godot y te devuelve un script limpio: un contador de saltos, un reinicio cuando el jugador aterriza y el segundo salto un poco más débil que el primero. Se lee bien. Pulsas F5 y el jugador salta una sola vez, porque el contador se reinicia en el mismo frame en que el primer salto despega del suelo. Claude nunca vio que pasara eso. Escribió el código y se detuvo.

Esa brecha es toda la historia de Claude y Godot. Claude escribe bien GDScript, conoce los tipos de nodo del motor y lee un archivo de escena sin problemas. Lo que separa las cuatro configuraciones de abajo es cuánto del juego en ejecución puede ver Claude: nada, sus errores, o sus errores más imágenes y las teclas que tú pulsarías.

Todas las configuraciones parten del mismo sitio. Un proyecto de Godot 4 es una carpeta de archivos de texto: project.godot, escenas como .tscn, recursos como .tres, scripts como .gd. Cualquier cosa que pueda editar archivos puede editar un juego de Godot. La pregunta es qué pasa después de la edición.

Opción 1: Claude Code en la carpeta de tu proyecto de Godot

Claude Code es el agente de programación de Anthropic. Se ejecuta en una terminal, o en la pestaña Code de la app de escritorio de Claude, y trabaja sobre los archivos de la carpeta en la que lo inicias. Necesita un plan de pago de Claude (Pro, Max, Team o Enterprise) o una cuenta de Anthropic Console facturada por uso; el plan gratuito de claude.ai no lo incluye.

En Windows, instálalo desde PowerShell con la línea de abajo. Anthropic también ofrece winget install Anthropic.ClaudeCode y un paquete de npm. Después abre una terminal en la carpeta que contiene project.godot, escribe claude e inicia sesión cuando te lo pida.

Empieza con una pregunta en lugar de un cambio: pídele a Claude que describa el proyecto en cinco frases, que nombre la escena principal y que liste los autoloads. Si el resumen está mal, los cambios también lo estarán. Después pide un cambio cada vez, cada uno con una forma de comprobarlo.

Un archivo CLAUDE.md le dice a Claude que está trabajando en Godot 4

Claude Code lee un archivo llamado CLAUDE.md en la raíz de la carpeta antes de empezar. Pon ahí los datos que de otro modo adivinaría: la versión de Godot, que los scripts son GDScript con tipado estático, dónde está la escena principal y que la carpeta .godot es la caché propia de Godot y nunca se debe editar.

La línea más útil es una comprobación que pueda ejecutar por sí mismo. La línea de comandos de Godot puede hacer una ejecución headless de tu juego y salir tras un número fijo de frames, imprimiendo cada error en stdout. Si Godot está en tu PATH, Claude puede ejecutarla después de cada cambio y leer qué se rompió. En Windows, apúntalo a la build de consola de Godot, el ejecutable cuyo nombre termina en _console.exe, para que la salida llegue a la terminal.

Esa única línea es casi toda la diferencia entre que Claude escriba código y que Claude compruebe código. Aun así, no es lo mismo que jugar: un arranque headless te dice que el script se analiza sin errores y que la escena carga, no que el salto funcione.

Lo que Claude Code puede y no puede hacer solo con la carpeta

Puede leer y escribir cada script, escena y recurso, renombrar cosas entre archivos, añadir acciones de entrada a project.godot y perseguir un bug a través de tres scripts más rápido que tú. Con tu permiso puede ejecutar Godot desde la terminal, como arriba, y leer los errores.

No puede ver el juego. No sabe que el jugador atraviesa el suelo, que la cámara apunta al cielo o que la UI tapa la puntuación. No puede pulsar una tecla en tu juego ni mirar el editor. Los archivos de escena son texto, pero llevan IDs de recurso y UIDs que es fácil equivocar sutilmente a mano, y cuando Claude edita un .tscn está adivinando lo que habría escrito el editor.

Hay una trampa en la que todo el mundo cae una vez. Si un script está abierto en el editor de Godot mientras Claude lo cambia en disco, Godot lo detecta y pregunta si quieres recargarlo. Responde Reload. Guardar la copia del editor vuelve a escribir el texto antiguo encima del cambio de Claude.

Coste: nada aparte de tu plan de Claude. Pro cuesta $20 al mes, o $17 al mes con facturación anual; Max empieza en $100 al mes. Godot en sí es gratis.

Forma 2: Claude Code más un servidor MCP para Godot

MCP, el Model Context Protocol, es la forma de darle a un agente herramientas más allá de leer y escribir archivos. Un servidor MCP de Godot es un pequeño programa que se sitúa entre Claude y Godot: Claude le pide que ejecute el juego, y él ejecuta el juego y le devuelve lo que Godot imprimió. Esta es la configuración que cierra el ciclo entre escribir código y verlo fallar.

El gratuito con el que empieza casi todo el mundo es godot-mcp de Coding-Solo, con licencia MIT y unas 5,900 estrellas en GitHub. Lanza el editor, ejecuta el proyecto en modo depuración y captura su salida, lo detiene, crea escenas, añade nodos, carga sprites y guarda escenas. Su README no menciona capturas de pantalla ni entrada simulada. Necesita Node.js 18 o posterior y encuentra Godot por sí mismo, o mediante una variable GODOT_PATH. Una sola línea lo registra en Claude Code.

Dos servidores de pago se conectan al editor de Godot que ya usas. GDAI MCP cuesta $19 en un solo pago: edita escenas, nodos, scripts y recursos, lee los logs y los errores del depurador, hace capturas de pantalla del editor y del juego en ejecución, e inyecta eventos de teclado y de acciones de entrada en el juego en ejecución, en Godot 4.2 y posteriores. Godot MCP Pro cuesta $15 en un solo pago y anuncia 187 herramientas en su propia web, entre ellas capturas de pantalla, simulación de entrada e inspección del juego en ejecución, en Godot 4.4 y posteriores.

Summer Engine, una app de escritorio basada en Godot, también incluye un servidor MCP gratuito con licencia MIT. Su página dice que un agente externo puede ejecutar el juego, recoger sus errores, enviarle entrada, hacer capturas de pantalla y editar escenas y scripts. Esas herramientas controlan la app de Summer Engine en lugar de un editor de Godot normal, así que la app tiene que estar abierta con el proyecto cargado.

Después de añadir cualquier servidor, escribe /mcp dentro de Claude Code. Muestra cada servidor y si se conectó. La comparación de los servidores en sí, herramienta por herramienta, está en el mejor servidor MCP para Godot.

Opción 2 con Flockbay: Claude construye dentro del editor de Godot

Flockbay es un creador de juegos con IA gratuito basado en Godot: una app de escritorio con el Godot 4.7.2 oficial dentro, no un fork, donde tu juego es un proyecto real de Godot 4 que puedes abrir, leer y cambiar. Le da a tu propio agente sus herramientas por MCP, y conectar uno es gratis. Necesitas la app abierta con tu juego y una cuenta gratuita de Flockbay.

En la app de Flockbay, abre Connectors desde el menú de Flockbay, pulsa Set up en la fila Another agent (MCP), pulsa Turn on, elige Claude Code y pulsa Copy. Pega la línea en PowerShell. Registra un servidor, flockbay-stage, para tu usuario, así que Claude Code lo encuentra desde cualquier carpeta. La app escribe la línea con las rutas de tu propia máquina ya puestas; la forma está abajo. Junto a Copy, Install skills and hooks pone las instrucciones de Flockbay en Claude Code, además de hooks que comprueban que un script se analiza sin errores después de que Claude lo edite y que le piden a Claude que juegue al juego antes de decir que un cambio funciona.

Lo que Claude recibe es el juego en ejecución, no solo sus archivos. Edita escenas, nodos, scripts, recursos y señales a través del editor de Godot abierto, y cada cambio es un paso en el historial de deshacer del propio Godot, así que Ctrl+Z lo revierte igual que uno tuyo. Juega al juego y lee stdout, con el archivo, la línea y la pila de llamadas de cada error. Captura el viewport del juego tal como lo ve el jugador y el viewport 3D o 2D del editor. Inyecta eventos de teclado y ratón temporizados en el juego, y lee y cambia el árbol de escenas en vivo mientras se ejecuta.

También recibe el mundo: terreno, agua, cielo, clima, el controlador del jugador y props, seis familias en un mundo 3D y cuatro en uno 2D. Son sistemas completos que Claude llama en lugar de escribir, así que una costa es una petición en lugar de cuatrocientas líneas de código de mallas. Su trabajo aparece en la app en su propio chat, llamado Your agent.

Los límites son claros. La app de Flockbay funciona hoy en Windows; la versión para Mac llega más adelante. Necesita conexión a internet mientras construyes. Trabaja sobre el juego que la app tiene abierto, que puede ser un proyecto de Godot que ya tengas: Flockbay pregunta antes de añadirle nada. Flockbay es de código cerrado. El recorrido completo desde la instalación hasta un juego jugable está en cómo hacer juegos en Claude Code.

Opción 3: Claude Desktop con un servidor MCP de Godot

La app de escritorio de Claude, en Windows y macOS, tiene dos puertas. La pestaña Code es el propio Claude Code, sin nada más que instalar: todo lo de la Opción 1 y la Opción 2 vale ahí. La pestaña Chat es Claude como chat, que llega a tu juego solo a través de los servidores MCP que le des.

Para añadir un servidor a Chat, abre Settings, luego Developer, luego Edit Config. Eso abre claude_desktop_config.json, que en Windows está en %APPDATA%\Claude\claude_desktop_config.json. Añade el servidor bajo mcpServers, guarda, y luego cierra Claude Desktop por completo y vuelve a abrirlo. El servidor aparece entonces en Connectors, en el menú de abajo a la izquierda del cuadro de mensaje. Algunos servidores también vienen como Desktop Extensions, archivos .mcpb que se instalan desde Settings, luego Extensions.

Chat sirve para hacer preguntas sobre una escena o para que Claude ejecute el juego y explique un error. Encaja mal para escribir un juego, porque solo toca lo que expone el servidor: con un servidor que ejecuta y lee, y sin acceso a archivos, puede describir un arreglo pero no hacerlo. Usa la pestaña Code para construir.

El diálogo de configuración de la app de Flockbay no incluye Claude Desktop. El bloque que da para Cursor tiene la misma forma mcpServers que lee Claude Desktop, pero no lo hemos probado ahí, así que tómalo como no probado.

Opción 4: Claude Code dentro de Flockbay, con tu plan de Claude

La última opción no necesita terminal. En la app de Flockbay eliges Claude en el menú de modelos, y Flockbay ejecuta Claude Code con tu plan Claude Pro o Max detrás de su propio chat, junto al editor de Godot. Encuentra Claude Code o lo instala la primera vez, inicias sesión en la página de Anthropic, y el menú muestra los modelos y los niveles de esfuerzo que Claude Code da a tu cuenta. No se pega nada, y Flockbay no cobra nada por ello. Está en Windows, desde Flockbay 2.0.

Funciona con las mismas herramientas que la Opción 2, y más. Hace una ronda de preguntas cada vez, escribe un planteamiento corto de lo que va a construir primero y solo construye después de que lo apruebes. Luego construye el mundo, escribe el código y hace playtest del juego. Las imágenes, el sonido y los modelos 3D generados funcionan con tus propias claves de ElevenLabs y Tripo. El constructor, los botones alrededor de la vista 3D y 2D de Godot para esculpir, pintar y colocar, está ahí para las partes que prefieras hacer a mano.

Hay otras dos formas de usar modelos de Claude dentro de la app: tu propia clave de API de Anthropic, añadida en Connectors y facturada por ese proveedor según lo que uses, y los planes opcionales de Flockbay, cuyo menú de modelos incluye modelos de Claude. Las cuentas nuevas también reciben una pequeña asignación gratuita llamada Demo, que usa un modelo pequeño y de baja calidad en lugar de Claude, y la app lo indica.

Lo que toda configuración de Claude y Godot sigue dejándote a ti

Ni siquiera la configuración que hace playtest del juego y captura el viewport puede decirte si el juego es bueno. Claude puede leer la altura de salto del jugador e informar de que pasó de 0 a 4.2 metros. No puede decirte que el salto se siente flotante, que la cámara te marea o que el segundo nivel es aburrido. Una imagen muestra un frame, y el game feel vive entre un frame y otro.

Así que el ciclo que funciona es corto: un cambio, Claude lo comprueba hasta donde llegan sus herramientas, tú lo juegas y dices qué está mal. Quien le entrega a Claude un documento de diseño de cuarenta líneas y espera un juego terminado recibe un montón de código plausible. Quien pide una mecánica, la juega y pide la siguiente obtiene un juego.

Haz commit en git antes de cada sesión, sea cual sea la configuración. Deshacer en el editor cubre un cambio; el control de versiones cubre una mala tarde.

Qué configuración de Claude para Godot elegir

Escribes código y quieres a Claude como un par de manos rápidas en un proyecto que ya tienes: Opción 1, y añade el servidor de Coding-Solo la primera vez que te descubras pegándole un error de vuelta.

Quieres que Claude pruebe su propio trabajo en un proyecto existente: Opción 2 con GDAI MCP o Godot MCP Pro, que llegan al juego en ejecución dentro de tu propio editor de Godot.

Empiezas un juego nuevo y quieres que Claude construya el mundo además del código, con el constructor en tus propias manos: Opción 2 con la app de Flockbay, gratis con el plan de Claude que ya pagas, en Windows.

No quieres terminal en absoluto: Opción 4, con el plan de Claude que ya pagas.

Hoy estás en un Mac: Opciones 1 a 3 con cualquiera de los servidores de arriba. La app de Flockbay es solo para Windows por ahora.

Claude para Godot: gratis frente a de pago, a 29 de septiembre de 2026

Godot es gratis. Claude Code necesita Claude Pro ($20 al mes, o $17 con facturación anual), Max (desde $100), Team, Enterprise o créditos de API de pago por uso a través de una cuenta de Console.

Además de eso: godot-mcp de Coding-Solo es gratis. GDAI MCP cuesta $19 en un solo pago y Godot MCP Pro, $15 en un solo pago. El servidor MCP de Summer Engine es gratis, y sus planes cuestan $20, $60 y $200 al mes. La app de Flockbay es gratis con tu propio plan de Claude o ChatGPT, tu propio agente o tu propia clave de API, y sus planes opcionales cuestan $20, $60 y $200 al mes.

El resumen honesto: si ya pagas Claude, puedes hacer que Claude ejecute y pruebe un juego de Godot sin gastar un dólar más.

Solución de problemas de Claude con Godot

El servidor no aparece en Claude Code. Escribe /mcp. Si falta, lo registraste en otra carpeta: el ámbito por defecto de Claude Code es la carpeta en la que estabas. Quítalo con claude mcp remove y vuelve a añadirlo con --scope user, que es lo que ya hace la línea de la app de Flockbay.

El servidor aparece como fallido. Ejecuta claude mcp get con el nombre del servidor para ver por qué. Para un servidor npx, comprueba que node --version sea 18 o posterior. Para Claude Desktop, lee los logs en %APPDATA%\Claude\logs, donde cada servidor escribe su propio archivo.

El servidor de Flockbay se conecta pero muestra una sola herramienta. La app todavía no está sirviendo a tu agente: abre la app de Flockbay, abre tu juego y activa Another agent en Connectors. Las herramientas aparecen entonces solas. Si siguen sin aparecer, inicia una nueva sesión de Claude Code.

El cambio de Claude desapareció. El editor de Godot guardó su copia antigua encima. Pulsa Reload cuando Godot diga que un archivo cambió en disco, y guarda en Godot antes de pedirle a Claude que edite un archivo que tienes abierto.

Cuándo otra configuración es mejor opción

Un proyecto de Godot que quieres mantener en tu propio editor: GDAI MCP o Godot MCP Pro llegan a él ahí, y el servidor de Coding-Solo lo hace gratis. Flockbay también abre un proyecto existente, en el editor que aloja.

Un Mac, hoy: Claude Code con cualquiera de los servidores, o Summer Engine, que sale en macOS. La app de Flockbay es solo para Windows hasta su versión para Mac.

Sin gastar más allá de Claude y sin una app nueva: Claude Code con godot-mcp de Coding-Solo.

Preguntas frecuentes

¿Cómo uso Claude con Godot?

Instala Claude Code, abre una terminal en la carpeta de tu proyecto de Godot y escribe claude. Así Claude puede leer y editar tus scripts y escenas. Para que además pueda ejecutar el juego y leer los errores, añade un servidor MCP de Godot con claude mcp add.

¿Claude es bueno con GDScript?

Sí, con el GDScript de Godot 4, sobre todo cuando le dices la versión de Godot y que usas tipado estático. Sus errores rara vez son de sintaxis; son comportamientos que no podía ver, y por eso una configuración que ejecuta el juego importa más que el modelo.

¿Puede Claude ejecutar mi juego de Godot y arreglar el bug por sí solo?

Con un servidor MCP de Godot, sí: ejecuta el juego, lee el error con su archivo y su línea, lo arregla y lo vuelve a ejecutar. Sin uno, solo puede arrancar el juego en modo headless desde la terminal si se lo permites. Ninguna configuración le permite juzgar si el juego se siente bien; esa parte es tuya.

¿Usar Claude con Godot es gratis?

Godot es gratis, y godot-mcp de Coding-Solo es gratis. Claude Code en sí necesita un plan de pago de Claude desde $20 al mes, o créditos de API. Conectar Claude Code a la app de Flockbay no cuesta nada más.

¿Uso Claude Code o Claude Desktop para Godot?

Claude Code, en una terminal o en la pestaña Code de la app de escritorio, porque edita tus archivos y ejecuta comandos. La pestaña Chat llega a tu juego solo a través de un servidor MCP y sirve más para preguntas que para construir.

¿Claude necesita el editor de Godot abierto?

No para editar archivos. Los servidores que actúan dentro del editor, como GDAI MCP, Godot MCP Pro y las herramientas de la app de Flockbay, lo necesitan abierto; el servidor de Coding-Solo lanza Godot por sí mismo.

¿Qué modelos de Claude puedo usar en Flockbay?

Con tu plan de Claude, los modelos que Claude Code da a tu cuenta, dentro de la app o desde tu terminal. Con tu propia clave de Anthropic, los modelos de Claude a los que llega esa clave. Con un plan de Flockbay, los modelos de Claude que ofrece su menú de modelos.

Descarga Flockbay

Flockbay es un creador de juegos con IA gratuito basado en Godot, para Windows. La guía paso a paso va desde la instalación hasta un juego que puedes jugar.

Configura Claude Code con Flockbay

Sigue leyendo

• Claude o ChatGPT con Godot
• Cómo hacer juegos en Claude Code, paso a paso
• El mejor servidor MCP para Godot
• Guía de servidores MCP para Godot
• Plantillas de prompts para tu agente en Flockbay