projekte/Blender-Claude-Addon
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
2 commits 1 branch 0 tags 307 KiB
  • Python 100%
Find a file
Exact
bmen d12bccbdcf initial commit
2026-04-23 16:45:22 +02:00
claude_blender_addon.py initial commit 2026-04-23 16:45:22 +02:00
LICENSE Initial commit 2026-04-23 14:20:43 +00:00
README.md initial commit 2026-04-23 16:45:22 +02:00
screenshot.png initial commit 2026-04-23 16:45:22 +02:00

README.md

Blender-Claude-Addon

Claude AI Assistant – Blender Addon

Ein Blender-Addon, das den KI-Assistenten Claude von Anthropic direkt in den 3D Viewport integriert. Stelle Fragen, lass dir Python-Skripte generieren und führe sie per Knopfdruck aus – ohne Blender zu verlassen.

Screenshot

Features

  • 💬 Interaktiver Chat direkt im N-Panel des 3D Viewports
  • 🐍 Skript-Ausführung – generierte Python-Skripte mit einem Klick in Blender ausführen
  • 🔁 Automatische Fehlerbehandlung – Laufzeitfehler werden automatisch an Claude zurückgemeldet und korrigiert
  • 📋 Code kopieren / im Text-Editor öffnen – für manuelle Anpassungen
  • 📜 Gesprächsverlauf mit Scroll-Navigation (6 Nachrichten pro Seite)
  • ✏️ Editierbarer System Prompt – das Verhalten von Claude individuell anpassen
  • 🔌 Verbindungstest – API-Key direkt in den Einstellungen überprüfen
  • 🤖 Modellauswahl – Claude Sonnet, Opus oder Haiku wählbar

Voraussetzungen

  • Blender 4.0 oder neuer (getestet mit Blender 5.0 Flatpak)
  • Anthropic API Key – erhältlich unter console.anthropic.com
  • Internetverbindung

Es wird kein zusätzliches Python-Paket benötigt. Das Addon nutzt ausschließlich Blenders eingebaute Standardbibliotheken (urllib, json, threading).

Installation

  1. Die Datei claude_blender_addon.py herunterladen
  2. In Blender: Edit → Preferences → Add-ons → Install from Disk...
  3. Die .py-Datei auswählen und bestätigen
  4. Das Addon „Claude AI Assistant" in der Liste aktivieren (Häkchen setzen)

Einrichtung

  1. In den Addon-Einstellungen (Edit → Preferences → Add-ons → Claude AI Assistant):
    • Den Anthropic API Key (sk-ant-...) eintragen
    • Das gewünschte Modell auswählen
    • Optional: Max Tokens und Auto-Fehlererfassung konfigurieren
  2. Mit „Verbindung testen" prüfen, ob der Key gültig ist
  3. Im 3D Viewport das N-Panel öffnen (Taste N) und den Tab „Claude" wählen

Verwendung

Chat

Nachricht im Textfeld eingeben und auf „Senden" klicken. Claude antwortet direkt im Panel.

Skripte ausführen

Enthält eine Antwort von Claude Python-Code, erscheinen drei Schaltflächen:

Button Funktion
▶ Ausführen Skript direkt in Blender ausführen
Kopieren Code in die Zwischenablage kopieren
Editor Skript im Blender Text-Editor öffnen

Automatische Fehlerkorrektur

Schlägt ein Skript fehl, wird der Traceback automatisch an Claude geschickt. Claude analysiert den Fehler und liefert ein korrigiertes Skript – sofern „Auto-capture script errors" in den Einstellungen aktiviert ist.

System Prompt anpassen

Im Chat-Panel den Bereich „System Prompt" aufklappen und den Text nach Bedarf anpassen, z. B. um Claude auf einen bestimmten Workflow oder Stil zu fokussieren.

Modelle

Modell Beschreibung
Claude Sonnet 4.5 (empfohlen) Gute Balance aus Geschwindigkeit und Intelligenz
Claude Opus 4.5 Leistungsstärkstes Modell, etwas langsamer
Claude Haiku 4.5 Schnellstes und günstigstes Modell

Hinweise

  • Der Gesprächsverlauf wird pro Blender-Session im Scene-Datensatz gespeichert und geht beim Schließen verloren.
  • Bei sehr langen Antworten wird der Anzeigetext im Panel gekürzt. Der vollständige Code ist trotzdem über die Buttons zugänglich.
  • Das Addon sendet den gesamten bisherigen Gesprächsverlauf bei jeder Anfrage mit – für mehr Kontext, aber auch höheren Token-Verbrauch.

Lizenz

MIT License – Copyright (c) 2026 projekte

Vollständiger Lizenztext: LICENSE