Steuererklärung mit Claude Code: Dateien auswerten, prüfen, vorbereiten

Drei Orte, drei Aufgaben

Was „lokal“ bei Steuerdaten wirklich heißt

Claude Code läuft auf Ihrem Rechner, das Modell nicht. Laut Dokumentation gehen Eingaben und Modellausgaben über das Netz; was Claude aus einer Datei liest, wird damit Teil der Unterhaltung.

• Lesen fragt nicht nach: Dateien im Arbeitsordner liest Claude Code laut Dokumentation ohne Rückfrage. Starten Sie deshalb in einem Ordner nur für diese Aufgabe.
• Der Verlauf bleibt liegen: Sitzungen stehen standardmäßig 30 Tage im Klartext unter ~/.claude/projects/; die Dauer stellt cleanupPeriodDays ein.
• Training und Aufbewahrung hängen vom Tarif ab: In den privaten Tarifen entscheiden Sie per Einstellung, bei Team, Enterprise und API trainiert der Anbieter von Claude laut Dokumentation nicht mit Ihren Eingaben, solange Sie nicht ausdrücklich zustimmen.
• Summen statt Zeilen: Lassen Sie ein Skript rechnen und nur Ergebnisse ausgeben. Dann kommen Verwendungszwecke und Namen gar nicht erst ins Gespräch.

Beispiel: Bankexport gegen die Anlage EÜR

Ein Auftrag für Einzelunternehmer und Freiberufler mit EÜR. Der Ordner enthält nur den Export Ihrer Bank; die Beträge sind erfunden:

Auftrag:
In diesem Ordner liegt bank-2025.csv.
1. Nur die Kopfzeile lesen, keine Buchungszeilen.
2. Ein Skript schreiben, das Zuflüsse und Abflüsse 2025 summiert
   und ausschließlich die beiden Summen ausgibt.
3. list_fiscal_years, dann get_euer für 2025 mit details=true.
4. Summen gegenüberstellen und die Hinweise der Vorschau nennen.
Nichts buchen und nichts vorbereiten.

Ergebnis:
Zuflüsse laut Bankexport       84.310,20 €
Betriebseinnahmen laut EÜR     82.950,20 €
Abweichung                      1.360,00 €

Eine Abweichung ist noch kein Fehler. Auf dem Konto landen auch Privateinlagen oder Darlehen, die keine Betriebseinnahmen sind. Claude Code zeigt die Lücke und mit details=true die Hinweise samt Buchungsnummern; was dahintersteckt, klären Sie. Bleibt eine Zahlung ungebucht, holen Sie das in den Büchern nach, bevor Sie die EÜR freigeben.

Die Software rechnet die Vorschau aus den Büchern. Ihr Skript rechnet nur Ihre Gegenprobe, und das Modell stellt beides nebeneinander.

Von der Vorschau zur Abgabe

Dieselbe Kette gilt für alle unterstützten Arten. Die Antworten sind gekürzt, die letzte Zeile zeigt die Sperre:

check_tax_filing {"art":"euer","year":2025}
  → 409 freigabe_in_app        erst in der App freigeben

check_tax_filing {"art":"euer","year":2025}
  → valid: true, hindernisse: [], manifest_sha256: "…"

prepare_tax_filing {"art":"euer","year":2025}
  → vorgang_id, sendebereit: true, gilt 30 Minuten

request_tax_filing_approval {"id":"<vorgang_id>"}
  → Freigabe-Link, sieben Tage gültig

check_tax_filing {"art":"est","year":2025}
  → abgelehnt: art kennt die Einkommensteuer nicht

Nach Ihrer Abgabe in der App meldet get_tax_operation den Stand samt Transferticket. Bei der EÜR ist der Stand gebunden, den Sie freigegeben haben. Ein Skript, das diese Kette selbst durchläuft, endet deshalb beim Link: Der Sendeaufruf steht zwar im Schema der Schnittstelle, antwortet aber mit 403, weil kein Schlüssel das nötige Recht bekommt.

Schlüssel und Regeln: so wenig Recht wie möglich

check_tax_filing und prepare_tax_filing verlangen das Recht „Schreiben“, in der App der Haken „Buchen“. Dasselbe Recht erlaubt bei einer Gesellschaft mit Buchhaltung oder EÜR auch das Buchen. Legen Sie deshalb in .claude/settings.json fest, was immer nachfragen muss; der Server heißt hier buchhaltung:

{
  "permissions": {
    "allow": [
      "mcp__buchhaltung__get_euer",
      "mcp__buchhaltung__list_tax_deadlines",
      "mcp__buchhaltung__list_tax_filings"
    ],
    "ask": [
      "mcp__buchhaltung__check_tax_filing",
      "mcp__buchhaltung__prepare_tax_filing",
      "mcp__buchhaltung__request_tax_filing_approval"
    ],
    "deny": ["Read(./privat/**)"]
  }
}

• Regeln greifen laut Dokumentation in der Reihenfolge deny, ask, allow.
• Eine Read-Sperre wirkt bei den Dateiwerkzeugen und bei erkannten Befehlen wie cat, aber nicht bei einem Skript, das Dateien selbst öffnet. Ein sauberer Ordner bleibt der bessere Schutz.
• Für die reine Auswertung genügt ein Schlüssel mit Leserecht: get_euer, list_tax_filings und list_tax_deadlines laufen damit, gebucht wird mit ihm nie.
• Erst üben: Mit einem Schlüssel aus der Sandbox gehen Prüfen und Vorbereiten, übermittelt wird dort nie. get_entity meldet dann sandbox=true.
• Der Schlüssel gehört in eine Umgebungsvariable, nicht in den Chat und nicht in den Steuerordner.

Wofür sich der lokale Abgleich lohnt

Die Bücher rechnet die Software. Der Ordner auf Ihrem Rechner ist für Gegenproben da, die aus einer zweiten Quelle kommen.

• Bankexport gegen Anlage EÜR: Fehlen Einnahmen, oder stehen Zahlungen doppelt in den Büchern?
• Plattformabrechnung gegen Voranmeldung: Passt die Monatssumme eines Marktplatzes zu den Kennzahlen aus get_vat_return?
• Vorjahresvergleich: Zwei Exporte nebeneinander zeigen Posten, die stark abweichen und eine Erklärung brauchen.
• Übergabe an die Kanzlei: Claude Code schreibt offene Punkte als kurze Liste in eine Datei, ohne Kontoauszüge beizulegen.

Und die private Erklärung?

Claude Code kann Ihre eigenen Dateien zusammenrechnen, etwa Spendenquittungen oder Fahrten. Mehr ist es nicht: Für die Einkommensteuer gibt es kein Werkzeug, die Anbindung bleibt dafür gesperrt. Inhaber eines Einzelunternehmens erstellen die Erklärung im eigenen Modul der App, in das der Gewinn aus der freigegebenen EÜR oder dem Abschluss einfließt. Für Privatpersonen ohne Betrieb und für Gesellschafter gehört sie nicht zur Software.

Grenzen

• Dieser Weg setzt Erfahrung mit dem Terminal voraus. Ohne sie ist der Konnektor in claude.ai der einfachere Einstieg.
• Lokale Skripte sind keine Buchführung. Maßgeblich bleiben die Bücher und der freigegebene Stand.
• Höchstens 30 Prüfungen, Vorbereitungen und Entwürfe zusammen je Stunde und Schlüssel.
• Die Schnittstelle nutzt nur das ELSTER-Zertifikat der Gesellschaft; ein Kanzlei-Zertifikat kommt allein in der App zum Einsatz.
• Die Software ersetzt keine Steuerberatung. Ihre Angaben machen Sie nach bestem Wissen und Gewissen (§ 150 Abs. 2 AO); das nimmt Ihnen kein Programm ab.

Häufige Fragen

Kann Claude Code meine Steuererklärung abgeben?

Nein. Es prüft amtlich und bereitet vor. Die Abgabe erfolgt über den Freigabe-Link in der App mit Ihrer PIN, und ein Recht zum Senden ohne die App wird derzeit nicht vergeben.

Bleiben meine Steuerdateien auf meinem Rechner?

Die Dateien ja, ihr gelesener Inhalt nicht. Was Claude liest, wird Teil der Unterhaltung und geht an das Modell. Lassen Sie deshalb Skripte rechnen und nur Summen ausgeben.

Welches Recht braucht der Schlüssel?

Für Fristen, Stand und EÜR-Vorschau genügt Lesen. Amtlich prüfen, vorbereiten und den Freigabe-Link anfordern verlangen das Recht Schreiben.

Kann ich die Einkommensteuer mit check_tax_filing prüfen?

Nein. Die Einkommensteuer gehört nicht zu den Arten, die die Schnittstelle kennt. Inhaber eines Einzelunternehmens prüfen sie im eigenen Modul der App.

Wie probiere ich das gefahrlos aus?

In der Sandbox, dem versteckten Zwilling einer Gesellschaft mit eigenen Schlüsseln. Prüfen und Vorbereiten funktionieren dort, nach außen geht nichts.

Muss ich programmieren können?

Sie sollten Befehle im Terminal lesen können, denn Sie bestätigen sie. Die Skripte schreibt Claude Code. Ohne diese Erfahrung ist der Konnektor der bessere Weg.