Saltar al contenido Saltar al contenido
Flockbay

Claude Code para Godot en 2026: cómo conectarlo a tu juego y qué construye

Para usar Claude Code con Godot, dale una forma de ejecutar el juego que edita: Flockbay ejecuta Claude Code con tu propio plan de Claude dentro de su app, o tu propio Claude Code se conecta al servidor MCP de Flockbay, gratis para tu primera versión jugable en los dos casos, y Claude construye en el editor de Godot y le hace playtest al juego. Sin Flockbay, Claude Code sigue editando los archivos de tu proyecto desde una terminal, y un servidor MCP de Godot como el godot-mcp de Coding-Solo le permite ejecutar el juego y leer los errores. Esta guía cubre cada forma de conectar Claude Code a Godot, con los pasos exactos, lo que Claude puede y no puede hacer en cada una y lo que cuesta cada una, a 24 oct 2026. IA gratis para empezar: la IA de Flockbay y tu propio Claude, ChatGPT, agente o clave de API son gratis para tu primera versión jugable; después, un plan te permite seguir construyendo. Funciona en Windows, macOS y Linux, sobre el motor oficial de Godot.

Por Eduardo Orellana · Publicado el 2026-09-28 · Guides

Read this page in English

Claude Code con 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.

Nosotros hacemos Flockbay, y dos de las formas de abajo son nuestras: Claude Code con tu plan de Claude dentro de la app de Flockbay y tu propio Claude Code conectado a Flockbay por MCP. Las demás no necesitan nada de nosotros.

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.

# PowerShell, once
irm https://claude.ai/install.ps1 | iex

# then, in the folder that holds project.godot
cd "C:\path\to\your-game"
claude

Un archivo CLAUDE.md le dice a Claude Code 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.

# CLAUDE.md
This is a Godot 4.7 project. Scripts are GDScript with static types.
The main scene is res://scenes/main.tscn. Never edit anything under .godot/.
After changing a script or a scene, run:
  godot --headless --path . --quit-after 300
and fix every error it prints before saying the change is done.

Lo que Claude Code puede y no puede hacer solo con una carpeta de Godot

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.

claude mcp add godot -- npx @coding-solo/godot-mcp

Forma 2 con Flockbay: Claude Code construye dentro del editor de Godot

Flockbay es un creador de juegos con IA gratuito construido sobre Godot: una app de escritorio que funciona con Godot 4.6+, con el Godot oficial dentro, no un fork, donde tu juego es un proyecto real de Godot 4 que puedes abrir, leer y cambiar. Da a tu propio agente sus herramientas por MCP, y conectar uno es gratis para tu primera versión jugable; después, un plan te permite seguir construyendo. Necesitas la app abierta con tu juego y una cuenta gratuita de Flockbay, que la app crea en el primer arranque.

En la app de Flockbay, abre Connectors desde el menú de Flockbay, pulsa Set up en la fila Connect your agent (MCP), pulsa Turn on, elige Claude Code y pulsa Copy. Pega la línea en PowerShell. Registra un servidor, flockbay, 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 las herramientas de escena, que crean escenas y añaden, mueven y ajustan nodos a través del editor abierto, y la biblioteca de objetos, que importa un modelo ya hecho al proyecto. Son operaciones enteras que Claude llama en lugar de escribir, así que una fila de casas son unas pocas peticiones en vez de cuatrocientas líneas de código de malla. Su trabajo aparece en la app en su propio chat, llamado «Your agent».

Los límites son claros. La app de Flockbay funciona en Windows, macOS y Linux. Necesita conexión a internet mientras construyes. Trabaja sobre el juego que tiene abierto la app, 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.

claude mcp add --scope user flockbay -e "FLOCKBAY_MCP_DESCRIPTOR=<descriptor>" -- "<node>" "<coordinator>" --external-stage-mcp

Forma 3: Claude Desktop ejecuta Claude Code en su pestaña Code, y un servidor MCP de Godot en Chat

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.

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": [
        "@coding-solo/godot-mcp"
      ]
    }
  }
}

Forma 4: Claude Code dentro del editor de Godot 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. En Windows, Claude Code viene con la app; en un Mac usa el que instalaste o lo instala con Homebrew; en Linux usa el que instalaste. 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 tu primera versión jugable con él es gratis por parte de Flockbay; después, las cuentas nuevas construyen con Claude con un plan. Está en Windows, macOS y Linux.

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 construirá primero y construye solo cuando lo apruebas. Luego construye las escenas, escribe el código y hace playtest del juego. Genera imágenes y sonido; los modelos 3D se generan con tu propia clave de Tripo. El propio editor de Godot está ahí, en las vistas Standard y Full, para las decisiones que prefieres tomar a mano, con el deshacer de Godot.

Otra forma ejecuta 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. Cada cuenta también recibe IA gratis para su primera versión jugable en el modelo alojado, Flockbay en el menú de modelos, que no es un modelo de Claude. Después de la primera versión jugable, un plan te permite seguir construyendo.

Lo que cualquier configuración de Claude Code y Godot sigue dejando en tus manos

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 Code y 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 las escenas además del código, con el propio editor de Godot para las decisiones que tomas a mano: la vía 2 con la app de Flockbay, gratis para tu primera versión jugable con el plan de Claude que ya pagas, en Windows, macOS o Linux.

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

Estás en un Mac con Intel: Opciones 1 a 3 con cualquiera de los servidores de arriba. La app de Flockbay funciona en Windows, en Macs con Apple Silicon y en Linux.

Claude Code para Godot no cuesta nada además de un plan de Claude, a 24 oct 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 una vez y Godot MCP Pro $15 una vez. El servidor MCP de Summer Engine es gratis, y sus planes son $20, $60 y $200 al mes. La app de Flockbay es gratis para empezar: IA alojada gratis para tu primera versión jugable, o tu propio plan de Claude o ChatGPT, tu propio agente o tu propia clave de API, gratis hasta entonces. Sus planes, para más IA alojada y, en las cuentas nuevas, tu propia IA después de la primera versión jugable, son Hobby a $49, Indie Developer a $99 y Studio a $249 al mes.

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

Solución de problemas de Claude Code 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 Connect your agent (MCP) en Connectors. Las herramientas aparecen entonces por sí solas. Si aun así no aparecen, inicia una sesión nueva 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.

Todas las formas de conectar Claude Code a Godot, lado a lado Comprobado: 2026-10-24.
HerramientaA qué llega ClaudeEjecuta el juego y lee erroresCaptura el viewport y envía entradaCoste además de ClaudeFunciona enFuentes
Claude Code on the folderYour project's filesOnly if you let it run Godot in the terminalNoNothingWindows, macOS, LinuxClaude Code setup, Claude pricing
Claude Code + Coding-Solo godot-mcpFiles, plus scenes and nodes through GodotYes: runs in debug mode, captures outputNot in its READMEFree, MITWherever Godot and Node.js 18+ rungodot-mcp README
Claude Code + godot-aiYour own Godot 4.7+ editor: 46 tools, 120+ operationsYes: game and editor logsPictures of the editor and the running game; timed keys, mouse and gamepadFree, MITWherever Godot 4.7 and uv rungodot-ai README
Claude Code + GoPeakFiles, with Godot's language server and debuggerYes: an edit, run, inspect and fix loopThrough its runtime add-onFree, MITWherever Godot and Node.js runGoPeak README
Claude Code + satelliteoflove godot-mcpEditor state and tile maps; files stay with Claude CodeYes, and steps game time frame by framePictures, and input riding inside each time stepFree, MITGodot 4.5+godot-mcp README
Claude Code + GDAI MCPScenes, nodes, scripts and resources in your editorYes: logs and debugger errorsScreenshots and simulated input$19 onceGodot 4.2+ on Windows, macOS, LinuxGDAI MCP
Claude Code + Godot MCP ProThe Godot 4 editor, 187 toolsYes: inspects the running gameScreenshots and input simulation$15 onceGodot 4.4+ on Windows, macOS, LinuxGodot MCP Pro
Claude Code + Summer Engine's MCPThe Summer Engine app, open with the project loadedYes: runs it, collects errors and warningsScreenshots and input to the running gameMCP free, MIT; plans $20, $60, $200 a monthmacOS on Apple silicon, WindowsSummer Engine MCP, Summer Engine pricing, Summer Engine download
Claude Desktop (Chat) + a serverOnly what the server exposesIf the server doesIf the server doesThe server's own priceWindows, macOSConnect local MCP servers
Flockbay app + your Claude CodeThe open Godot editor, the running game, the scene tools and the object library, in the game Flockbay has openYes, with file, line and call stackPictures of the game and the editor's view; keys and mouseFree for your first buildWindows, macOS (Apple Silicon) and LinuxConnect your own agent, Pricing
Flockbay app, Claude Code inside itThe same tools, from the app's chatYesYesFree for your first build on your Claude Pro or Max planWindows, macOS (Apple Silicon) and LinuxPricing

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 con Intel: Claude Code con cualquiera de los servidores. La build para Mac de la app de Flockbay es para Apple Silicon.

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 Code 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 ejecute el juego y lea los errores, añade un servidor MCP de Godot con claude mcp add. O elige Claude en el menú de modelos de la app de Flockbay, y Flockbay ejecuta Claude Code con tu plan de Claude junto al editor de Godot.
¿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 para tu primera versión jugable; después, un plan te permite seguir construyendo.
¿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. El modelo alojado de Flockbay, Flockbay en el menú de modelos, es gratis para tu primera versión jugable y no es un modelo de Claude.

Descarga Flockbay

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

Descargar para macOSDescargar para WindowsDescargar para LinuxDescargar para ChromebookDescargando…

AppImage, x86_64. Ubuntu 22.04, Debian 12, Fedora 39 o posterior.

Chromebook Intel o AMD, con Linux activado.

Descargar para macOSDescargar para Windows

Flockbay es una app de escritorio para Windows, macOS y Linux. Regístrate y envía la descarga a tu equipo.

Registrarse

Configura Claude Code con Flockbay

Sigue leyendo