KI-Coding-Agenten für VBA: Claude Code und Codex

Ein Chat liefert Code, den man selbst kopiert, einfügt und testet. Ein Coding-Agent geht weiter: Er liest die Dateien eines Projekts, ändert sie, führt Befehle aus und prüft das Ergebnis. Die bekanntesten Vertreter sind Claude Code von Anthropic und Codex von OpenAI. Für VBA gibt es eine Hürde: Der Code steckt in der Excel-Datei. Mit einem Export der Module als Textdateien lässt sie sich gut überwinden.

Kurz gesagt

  • Agenten arbeiten mit Textdateien. VBA-Module werden deshalb als .bas, .cls und .frm in einen Projektordner exportiert.
  • Der Agent ändert die Textdateien, ein Makro oder Skript liest sie wieder in die Mappe ein. Dann wird kompiliert und getestet.
  • Eine Anweisungsdatei im Projektordner legt Regeln fest, etwa Option Explicit, deutsche Formeln und keine festen Pfade.
  • Ein Agent läuft mit Ihren Rechten. Arbeiten Sie mit Kopien, mit Versionsverwaltung und ohne echte Kundendaten.

Was ein Agent anders macht

Ein Agent läuft im Terminal oder in einem Editor wie Visual Studio Code. Sie beschreiben eine Aufgabe, etwa „Die Funktion für die Urlaubsplanung soll Feiertage aus dem Blatt Feiertage berücksichtigen“. Der Agent sucht die betroffenen Module, ändert sie, ruft ein Testskript auf, liest die Fehlermeldung und bessert nach. Vor Änderungen an Dateien und vor Befehlen fragt er je nach Einstellung um Erlaubnis.

Beide Werkzeuge werden mit einem Konto des Anbieters genutzt, entweder über ein Abo oder über die Schnittstelle nach Verbrauch. Installation und Preise ändern sich häufig. Maßgeblich ist die Anleitung auf den Seiten von Anthropic und OpenAI.

Module als Textdateien

Excel speichert den VBA-Code in der .xlsm-Datei, die ein Agent nicht lesen kann. Das folgende Modul exportiert alle Module, Klassen und Formulare in einen Ordner und liest geänderte Standardmodule wieder ein:

Option Explicit

' Exportiert alle Module, Klassen und Formulare einer Mappe als Textdateien in einen Ordner.
' Voraussetzung: Trust Center > Makroeinstellungen > "Zugriff auf das VBA-Projektobjektmodell vertrauen".
Public Function ModuleExportieren(ByVal wb As Workbook, ByVal ordner As String) As Long
    Dim komp As Object, endung As String
    If Right$(ordner, 1) <> "\" Then ordner = ordner & "\"
    If Len(Dir$(ordner, vbDirectory)) = 0 Then MkDir ordner
    For Each komp In wb.VBProject.VBComponents
        Select Case komp.Type
            Case 1: endung = ".bas"   ' Standardmodul
            Case 2: endung = ".cls"   ' Klassenmodul
            Case 3: endung = ".frm"   ' UserForm (zusätzlich entsteht eine .frx)
            Case Else: endung = ""    ' Tabellen und DieseArbeitsmappe: siehe Text
        End Select
        If Len(endung) > 0 Then
            komp.Export ordner & komp.Name & endung
            ModuleExportieren = ModuleExportieren + 1
        End If
    Next komp
End Function

' Ersetzt Standardmodule der Mappe durch die .bas-Dateien aus dem Ordner und liefert ein Protokoll.
' Übersprungen werden: das Modul "ausnahme", Dateien, deren Modulname nicht zum Dateinamen passt,
' und gleichnamige Komponenten, die kein Standardmodul sind. Das alte Modul wird erst entfernt,
' wenn der Import geklappt hat. Nutzen Sie das Makro an einer Kopie der Mappe.
Public Function ModuleImportieren(ByVal wb As Workbook, ByVal ordner As String, _
                                  Optional ByVal ausnahme As String = "Werkzeug") As String
    Dim datei As String, name As String, komp As Object, protokoll As String
    If Right$(ordner, 1) <> "\" Then ordner = ordner & "\"
    datei = Dir$(ordner & "*.bas")
    Do While Len(datei) > 0
        name = Left$(datei, Len(datei) - 4)
        Set komp = Nothing
        On Error Resume Next
        Set komp = wb.VBProject.VBComponents(name)
        On Error GoTo 0
        If StrComp(name, ausnahme, vbTextCompare) = 0 Then
            protokoll = protokoll & name & ": übersprungen (Werkzeug-Modul)" & vbLf
        ElseIf StrComp(ModulnameInDatei(ordner & datei), name, vbTextCompare) <> 0 Then
            protokoll = protokoll & name & ": übersprungen (Modulname in der Datei passt nicht)" & vbLf
        ElseIf KeinStandardmodul(komp) Then
            protokoll = protokoll & name & ": übersprungen (vorhandene Komponente ist kein Standardmodul)" & vbLf
        Else
            protokoll = protokoll & name & ": " & ModulErsetzen(wb, komp, ordner & datei, name) & vbLf
        End If
        datei = Dir$()
    Loop
    ModuleImportieren = protokoll
End Function

' Altes Modul umbenennen, neues importieren, bei Erfolg altes entfernen, sonst alten Namen zurückgeben.
Private Function ModulErsetzen(ByVal wb As Workbook, ByVal alt As Object, ByVal pfad As String, _
                               ByVal name As String) As String
    Dim neu As Object
    If Not alt Is Nothing Then alt.Name = name & "_alt"
    On Error Resume Next
    Set neu = wb.VBProject.VBComponents.Import(pfad)
    If Err.Number <> 0 Or neu Is Nothing Then
        ModulErsetzen = "Import fehlgeschlagen (" & Err.Description & "), altes Modul bleibt"
        Err.Clear
        On Error GoTo 0
        If Not alt Is Nothing Then alt.Name = name
        Exit Function
    End If
    On Error GoTo 0
    If neu.Name <> name Then neu.Name = name
    If Not alt Is Nothing Then wb.VBProject.VBComponents.Remove alt
    ModulErsetzen = "ersetzt"
End Function

Private Function KeinStandardmodul(ByVal komp As Object) As Boolean
    If Not komp Is Nothing Then KeinStandardmodul = (komp.Type <> 1)
End Function

' Liest den Modulnamen aus der Zeile Attribute VB_Name der exportierten Datei.
Private Function ModulnameInDatei(ByVal pfad As String) As String
    Dim nr As Integer, zeile As String
    nr = FreeFile
    Open pfad For Input As #nr
    Do While Not EOF(nr)
        Line Input #nr, zeile
        If Left$(zeile, 17) = "Attribute VB_Name" Then
            ModulnameInDatei = Trim$(Replace(Mid$(zeile, InStr(zeile, "=") + 1), """", ""))
            Exit Do
        End If
    Loop
    Close #nr
End Function

Voraussetzung ist die Einstellung Datei > Optionen > Trust Center > Einstellungen für das Trust Center > Makroeinstellungen > „Zugriff auf das VBA-Projektobjektmodell vertrauen“. Sie erlaubt Makros, VBA-Code zu verändern. Schalten Sie sie nur auf Entwicklungsrechnern ein.

Aufruf: ModuleExportieren ThisWorkbook, "C:\Projekte\Urlaubsplanung\src". Das Modul, in dem der Werkzeugcode selbst steht, nennen Sie „Werkzeug“, dann ersetzt ModuleImportieren es nicht. Die Funktion liefert ein Protokoll: Sie überspringt Dateien, deren Modulname nicht zum Dateinamen passt, und gleichnamige Klassen oder Formulare. Das alte Modul wird erst entfernt, wenn der Import geklappt hat, sonst bekommt es seinen Namen zurück. Arbeiten Sie trotzdem an einer Kopie der Mappe, kompilieren Sie danach (Debuggen > Kompilieren) und übernehmen Sie erst die geprüfte Kopie. Code in Tabellenblättern und DieseArbeitsmappe wird nicht exportiert. Halten Sie ihn deshalb kurz und rufen Sie von dort nur Prozeduren in Standardmodulen auf. Formulare bestehen aus einer .frm-Datei mit dem Code und einer .frx-Datei mit dem Layout. Den Code kann der Agent ändern, das Layout nicht.

Ein typischer Projektordner

Urlaubsplanung\
    Urlaubsplanung.xlsm      Arbeitsmappe mit Werkzeug-Modul
    src\                     exportierte Module (.bas, .cls, .frm)
    tests\                   Testmappen und Testskripte
    CLAUDE.md / AGENTS.md    Anweisungen für den Agenten

Claude Code liest die Datei CLAUDE.md, Codex die Datei AGENTS.md. Darin steht, was der Agent über das Projekt wissen muss:

  • Zweck der Mappe und Aufbau der Blätter
  • Regeln für den Code: Option Explicit, sprechende Namen, Fehlerbehandlung, keine festen Pfade, keine Zugangsdaten im Code
  • Excel-Version und Sprache: deutsche Formeln über FormulaLocal, Semikolon als Trennzeichen
  • Wie getestet wird: welches Skript, welche Testmappe, was ein erfolgreicher Test ausgibt
  • Was der Agent nicht tun darf, etwa die Originalmappe überschreiben oder Dateien außerhalb des Projekts löschen

Testen lassen

Seine Stärke spielt ein Agent aus, wenn er selbst testen kann. Dafür braucht es einen Ablauf, den er ohne Ihre Hilfe ausführt: Eine Testmappe wird angelegt, die Module aus src werden importiert, das Projekt kompiliert, Testfunktionen laufen und schreiben ihr Ergebnis in eine Datei. Ein solches Skript in PowerShell lässt sich vom Agenten selbst schreiben, wenn Sie den Ablauf beschreiben.

Zwei Dinge sind dabei wichtig. Meldungsfenster und Eingabedialoge halten einen automatischen Test an, deshalb werden sie im Test durch eine Protokollfunktion ersetzt. Und eine unsichtbare Excel-Instanz, die hängen bleibt, muss das Skript nach einer Zeitgrenze beenden, ohne andere geöffnete Excel-Fenster zu treffen.

Versionsverwaltung

Mit den Modulen als Textdateien lässt sich das Projekt in Git verwalten. Jede Änderung des Agenten wird so als Unterschied sichtbar, und ein misslungener Versuch ist mit einem Befehl zurückgenommen. Das ist der wichtigste Schutz bei der Arbeit mit Agenten.

Was gut funktioniert und was nicht

AufgabeEignung
Neue Funktionen in Standardmodulen, Umbau bestehender Prozedurengut, besonders mit Tests
Fehler finden anhand einer Fehlermeldung oder eines Testfallsgut
Code kommentieren, vereinheitlichen, Dokumentation schreibengut
Layout von UserForms, Steuerelemente auf Blätternschwach, Layout liegt in Binärdateien
Abläufe mit Dialogen, Druck, Outlook-Versandnur mit Vorsicht, schwer automatisch zu testen
Fachliche Regeln, die nirgends beschrieben sindnicht ohne Ihre Angaben

Sicherheit

  • Rechte: Der Agent kann alles, was Ihr Benutzerkonto kann. Lassen Sie Befehle bestätigen, bis Sie dem Ablauf vertrauen, und arbeiten Sie in einem eigenen Projektordner.
  • Daten: Was der Agent liest, geht an den Anbieter. Testmappen enthalten Beispieldaten, keine echten Kunden- oder Personaldaten.
  • Fremde Inhalte: Texte in Dateien, Webseiten oder E-Mails können Anweisungen enthalten, die den Agenten in die Irre führen. Lassen Sie ihn keine unbekannten Dateien verarbeiten, ohne das Ergebnis zu prüfen.
  • Abnahme: Den fertigen Code prüft ein Mensch, bevor er in der echten Mappe landet.

Passende Beiträge

KI im eigenen Betrieb

KI, die in Ihre Abläufe passt.

Belege, E-Mails und PDFs automatisch erfassen und Excel-Lösungen schneller umsetzen. Am Anfang steht eine kurze Potenzialanalyse, damit klar ist, was sich lohnt.