# So verwendest du Claude Code mit Unity Engine — AI Game Dev Verbinde Claude Code über AI Game Developer mit Unity Engine. Schritt für Schritt: Installation, Konfiguration und erste Szenenprüfung mit KI. Diese Seite wurde maschinell aus dem Englischen übersetzt. [Englisches Original lesen](https://ai-game.dev/blog/claude-code-unity-tutorial). [Blog](https://ai-game.dev/de/blog) Verbinde Claude Code über AI Game Developer mit Unity Engine. Schritt für Schritt: Installation, Konfiguration und erste Szenenprüfung mit KI. Ivan Murzak · 12. Januar 2026 · 5 Min. Lesezeit · **Aktualisiert am 17. Oktober 2026.** Seit Unity-MCP 1.0.0 liest und bearbeitet der Agent Szenen, GameObjects, Komponenten und Assets über RQL (rql-query, rql-mutate, rql-schema) statt über ein eigenes Tool pro Operation. Die folgenden Einrichtungsschritte sind unverändert, und die CLI-Beispiele verwenden die aktuellen Tool-Namen. Siehe ai-game.dev/docs/rql. Claude Code ist einer der besten verfügbaren KI-Agenten, angetrieben von Modellen wie Opus 4.5. In diesem Tutorial verbinden wir ihn direkt mit Unity Engine, sodass er deine Szenen lesen, Unity-APIs aufrufen und dein Projekt verändern kann — alles aus dem Terminal heraus. ## Was du brauchst - Unity 2021.3 oder neuer - Node.js ^20.19.0 oder >=22.12.0 (für die CLI) - Claude Code installiert (terminalbasierter KI-Agent) - AI Game Developer — die Brücke zwischen KI-Agenten und Unity: [github.com/IvanMurzak/Unity-MCP](https://github.com/IvanMurzak/Unity-MCP) ## AI Game Developer installieren AI Game Developer fungiert als Brücke zwischen fortschrittlichen KI-Agenten und Modellen und Unity Engine. Du kannst es manuell über den Unity Editor installieren oder die CLI für ein vollständig automatisiertes Setup verwenden. ### Option A: Manuelle Installation (Unity Editor) 1. Lade den Installer von der AI Game Developer GitHub-Seite herunter 2. Doppelklicke die Installer-Datei, um sie in Unity zu öffnen 3. Klicke im Unity-Importfenster auf „Import“ 4. Warte, bis Unity mit dem Kompilieren fertig ist ### Option B: Installation über die CLI (empfohlen) Das Tool unity-mcp-cli automatisiert das gesamte Setup über die Kommandozeile — kein manuelles Klicken nötig. Installiere es global und nutze es, um das Plugin zu jedem Unity-Projekt hinzuzufügen. 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 ``` Der Befehl install-plugin verändert direkt die Packages/manifest.json deines Projekts — er fügt die OpenUPM-Scoped-Registry und die Plugin-Abhängigkeit hinzu. Eine bestehende Installation wird dabei nie herabgestuft. Öffne das Projekt nach dem Ausführen in Unity, um die Paketinstallation abzuschließen. ## Verbindung konfigurieren Sobald das Paket importiert ist, erscheint das Fenster von AI Game Developer. Scrolle nach unten zum Abschnitt Claude Code und klicke auf „Configure“ — mehr Konfiguration ist nicht nötig. Klicke dann auf „Connect“, um den Verbindungsvorgang zu starten. Zunächst siehst du Fehler, weil Claude Code noch nicht läuft — das ist zu erwarten. ### CLI: MCP für Claude Code einrichten Die CLI kann die MCP-Integration für Claude Code automatisch konfigurieren — ohne Unity Editor UI nötig. Sie schreibt die richtigen Konfigurationsdateien, sodass Claude Code den AI Game Developer-Server beim Start findet. 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 ``` ## Claude Code starten Du kannst Claude Code aus Visual Studio Code oder direkt aus dem Terminal starten. In diesem Tutorial nutzen wir den Terminal-Ansatz. Öffne das Terminal in deinem Unity-Projektordner — klicke dazu in Unity mit der rechten Maustaste in den Assets-Ordner, wähle „Show in Explorer“, klicke dann erneut mit der rechten Maustaste und wähle „Open in Terminal“. Bash Terminal ```bash # Navigate to your Unity project folder and start Claude Code cd /path/to/your/unity/project claude ``` Sobald Claude Code startet, wechselt der Status im Fenster von AI Game Developer auf „Connected“. Um zu prüfen, ob alles funktioniert, tippe /mcp in Claude Code ein — du solltest „AI Game Developer“ als verbunden in der Liste sehen. ## KI in deiner Unity-Szene testen Probiere bei bestehender Verbindung, die KI etwas zu fragen wie „Was siehst du in dieser Szene im Unity-Projekt?“ Die KI nutzt die von AI Game Developer bereitgestellten MCP-Tools, um deine Szenenhierarchie zu lesen, GameObjects zu untersuchen und zurückzumelden, was sie findet. Sie arbeitet sich Schritt für Schritt vor — liest die Szenendaten, untersucht verschachtelte Objekte und setzt ein vollständiges Bild deines Projekts zusammen. Wenn Claude Code um Erlaubnis bittet, ein Tool zu verwenden, kannst du Option 2 wählen, um es zu erlauben und künftige Nachfragen für dasselbe Tool zu überspringen. Danach liest die KI deine Szene, identifiziert Objekte wie Meshes, Lichter und verschachtelte Hierarchien und liefert eine ausführliche Beschreibung von allem, was sie gefunden hat. ## Kontext optimieren AI Game Developer stellt der KI viele MCP-Tools bereit. Ein wichtiger Tipp: Deaktiviere die Tools, die du nicht brauchst. Jedes aktivierte Tool verbraucht KI-Kontext, und ein sauberer Kontext lässt die KI effizienter arbeiten und bessere Ergebnisse liefern. Du kannst Tools im Fenster von AI Game Developer ein- und ausschalten — oder die CLI verwenden. 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 ``` - Deaktiviere Tools, die du nicht verwendest, um den KI-Kontext schlank zu halten - Erwäge, Resources zu deaktivieren, wenn du sie nicht brauchst - Prompts sind Slash-Befehle — tippe / in Claude Code, um verfügbare Befehle wie „set up an animation“ oder „add a component“ zu sehen - Prüfe die Statusanzeige Connected, um sicherzugehen, dass die Verbindung aktiv ist ## Was du von hier aus tun kannst Mit Claude Code, verbunden mit Unity, kannst du die KI alles tun lassen, was die MCP-Tools unterstützen — Szenen inspizieren, GameObjects erstellen, Komponenten ändern, Animationen generieren, UI bauen und vieles mehr. Die KI hat Zugriff auf einen umfangreichen Satz an Tools und kann jedes davon anhand deiner natürlichsprachlichen Prompts aufrufen. Du kannst MCP-Tools auch direkt über die Kommandozeile ausführen, ohne den Umweg über die KI — das ist nützlich für Skripte und CI-Pipelines. 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"}' ``` ### Vollständige Automatisierung: Von null zur fertigen Verbindung Die CLI kann den gesamten Workflow automatisieren — ein Projekt erstellen, das Plugin installieren, Claude Code konfigurieren, Unity öffnen, auf die Verbindung warten und Tools ausführen. Hier ist ein vollständiges Skript, das alles von Grund auf einrichtet. 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"}' ``` ## Loslegen AI Game Developer ist Open Source. Installiere das Unity-Paket, konfiguriere Claude Code und starte mit den ersten Prompts. Das CLI-Tool ist auf npm für automatisierte Workflows verfügbar. Ausführliche Einrichtungshinweise findest du im Quickstart-Leitfaden unter [ai-game.dev/docs/quickstart](https://ai-game.dev/docs/quickstart). - AI Game Developer (Unity-MCP): [github.com/IvanMurzak/Unity-MCP](https://github.com/IvanMurzak/Unity-MCP) - AI Animation Extension: [github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md](https://github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md) - CLI-Tool: [npmjs.com/package/unity-mcp-cli](https://npmjs.com/package/unity-mcp-cli) - Download: [ai-game.dev/download](https://ai-game.dev/download) - Als Nächstes: Animationen mit KI generieren — [ai-game.dev/blog/generating-unity-animations-with-ai](https://ai-game.dev/blog/generating-unity-animations-with-ai) ## Mehr aus dem Blog [Alle Beiträge](https://ai-game.dev/de/blog) ### [Von Referenzbildern zum spielfertigen 3D-Modell — Tripo AI in AI Game Developer](https://ai-game.dev/de/blog/tripo-ai-3d-models-from-reference-images) 26. Oktober 2026 Zwei bis vier Referenzansichten werden in AI Game Developer per Tripo zu einem 3D-Modell, das du im Chat texturierst, riggst und animierst. Ivan Murzak 7 Min. Lesezeit ### [Erst planen, dann ändern — der Plan-Modus für KI-Agenten in der Spieleentwicklung](https://ai-game.dev/de/blog/plan-mode-ai-agent-game-development) 26. Oktober 2026 Mit Plan-Modus, klärenden Fragen, Nachrichten-Queue und Code-Review-Karten in AI Game Developer behalten Sie die Kontrolle über den KI-Agenten. Ivan Murzak 6 Min. Lesezeit --- Source (HTML): https://ai-game.dev/de/blog/claude-code-unity-tutorial Machine-translated (de) from the English page: https://ai-game.dev/blog/claude-code-unity-tutorial