Coding-Agenten wie Claude Code, Cursor oder Codex arbeiten direkt im Repository. Sie lesen Dateien, führen Befehle aus, schreiben Code und legen Commits an. Bevor sie einen Befehl ausführen, der nicht ausdrücklich erlaubt ist, fragen sie nach. Diese Abfrage bietet meist mehrere Antworten: einmal erlauben, ablehnen oder erlauben und künftig nicht mehr fragen.
Die letzte Option ist bequem. Wer an einem Nachmittag zwanzigmal dieselbe Testsuite freigibt, wählt sie irgendwann. Damit wird aus einer einzelnen Entscheidung eine Regel, und diese Regel gilt oft für mehr als den einen Befehl, den man gerade gesehen hat. Bei Befehlen wie git add, git commit oder git push kann das dazu führen, dass Zugangsdaten aus dem Arbeitsverzeichnis in ein Repository gelangen, ohne dass ein Mensch den Inhalt je gesehen hat. Wie solche Schlüssel später öffentlich auffindbar werden, beschreiben wir im Beitrag Offene API-Schlüssel im Quelltext.
Was eine dauerhafte Freigabe tatsächlich erlaubt
Eine Freigabe mit „nicht mehr fragen“ wird als Berechtigungsregel gespeichert, häufig mit einem Platzhalter. Aus der Freigabe für npm test wird dann etwa eine Regel für npm test *, also für jeden Aufruf, der so beginnt. Das ist für Tests unproblematisch. Bei Befehlen, die Dateien sammeln oder Daten nach außen schicken, sieht es anders aus:
git addmit Platzhalter erlaubt auchgit add .odergit add -A. Damit landen alle neuen Dateien im nächsten Commit, auch eine lokale.env-Datei, ein exportierter Dienstkonto-Schlüssel oder ein Datenbank-Dump, der nur kurz zum Testen dort lag.git pushmit Platzhalter erlaubt jeden Push auf jeden Branch und jedes Remote. Der Agent fragt nicht mehr, ob der Commit vorher angesehen wurde.- Freigaben für
curloder Skripte erlauben, Daten an beliebige Adressen zu senden, auch Inhalte von Dateien, die der Agent zuvor gelesen hat.
Der Agent handelt dabei nicht böswillig. Er erledigt die Aufgabe auf dem kürzesten Weg, und git add . ist ein kurzer Weg. Das Problem ist die Kombination: Geheimnisse liegen unverschlüsselt im Arbeitsverzeichnis, und die Schritte, die sie hinaustragen könnten, sind ohne Rückfrage erlaubt.
| Einmal erlauben | Nicht mehr fragen | |
|---|---|---|
| Gilt für | genau diesen einen Befehl | alle Befehle, die zur Regel passen |
| Wer sieht den Inhalt | ein Mensch vor der Ausführung | niemand, solange die Regel gilt |
| Bei git add . | fällt eine neue Datei auf | landet sie still im Commit |
| Rücknahme | nicht nötig | Regel muss gefunden und gelöscht werden |
Grafik verwenden? Gern, mit Quelle Wundrig und Link auf diesen Beitrag. Hinweise
Warum eine Anweisung im Projekt nicht genügt
Viele Teams schreiben in ihre Projektregeln, etwa in CLAUDE.md oder AGENTS.md, dass der Agent niemals Zugangsdaten committen soll. Das ist richtig, reicht aber nicht. Die Dokumentation von Claude Code hält fest, dass Berechtigungsregeln vom Werkzeug durchgesetzt werden, nicht vom Modell. Anweisungen in Projektdateien bestimmen, was der Agent versucht. Regeln bestimmen, was er tatsächlich darf.
Für Geheimnisse heißt das: Der Schutz muss an Stellen liegen, die unabhängig davon greifen, was das Modell gerade für richtig hält. Das gleiche Prinzip gilt für Agenten im Betrieb, wie wir in Zugriffsrechte für KI-Agenten beschrieben haben.
Drei Stellen, an denen der Schutz greift
Zuverlässig wird es erst, wenn mehrere Sperren hintereinander liegen. Fällt eine aus, greift die nächste.
| Stelle | Maßnahme | Was sie verhindert |
|---|---|---|
| Werkzeug des Agenten | Ablehnungsregeln für Geheimnisdateien und für git push |
Dass der Agent Schlüssel liest oder ohne Rückfrage veröffentlicht |
| Lokales Repository | .gitignore für Schlüsseldateien, Secret-Scan vor jedem Commit |
Dass Schlüssel überhaupt in einen Commit gelangen |
| Entferntes Repository | Push-Schutz des Hosting-Anbieters | Dass ein Commit mit erkanntem Schlüssel angenommen wird |
Im Werkzeug lassen sich bei Claude Code Ablehnungsregeln setzen, etwa Read(./.env) oder Read(./secrets/**). Ablehnungen werden vor Erlaubnissen ausgewertet: Eine breite Ablehnung wie für git push lässt sich durch keine engere Erlaubnis aushebeln. Diese Regeln gehören in die Projekteinstellungen im Repository, damit sie für alle im Team gelten und nicht davon abhängen, was jemand lokal einmal angeklickt hat.
Im lokalen Repository gehören Schlüsseldateien in die .gitignore, bevor sie das erste Mal angelegt werden. Ergänzend prüft ein Secret-Scanner als Pre-Commit-Hook jeden Commit, bevor er entsteht. Das OWASP-Merkblatt zum Umgang mit Geheimnissen empfiehlt genau diese Erkennung auf Ebene der Entwicklerinnen und Entwickler, bevor etwas in den Code eingecheckt wird.
Beim Hosting-Anbieter blockiert der Push-Schutz von GitHub Pushes, in denen ein bekanntes Schlüsselformat erkannt wird, noch bevor sie im Repository ankommen. Das ist die letzte Sperre: Sie erkennt nur, was sie als Schlüssel einordnen kann.
Ein Beispiel aus unserem Alltag
Die Beiträge in diesem Blog schreibt eine KI-Routine, die selbstständig läuft, ohne dass jemand zusieht. Sie arbeitet in einer Umgebung, in der auch die Zugangsdaten für ihre eigenen Werkzeuge vorhanden sind. Eine Rückfrage vor jedem Befehl gibt es dort nicht, weil niemand da wäre, der sie beantwortet. Deshalb sind die Regeln vorher festgelegt und eng:
- Die Routine fügt nie das ganze Verzeichnis zum Commit hinzu, sondern nur die Pfade, die zu einem Beitrag gehören: das Verzeichnis mit den Beiträgen, die Sitemap, den RSS-Feed und die Übersicht für Sprachmodelle.
- Dateien mit Zugangsdaten darf sie benutzen, aber nicht ausgeben, ändern oder committen.
- Gepusht wird nur, wenn Build und Tests vorher bestanden sind. Schlägt ein Schritt fehl, wird nichts veröffentlicht.
Das Entscheidende ist die erste Regel. Ein Commit mit genau benannten Pfaden kann keine Datei mitnehmen, die zufällig daneben liegt. Diesen Grundsatz übertragen wir auch auf Teams, die wir beim Umstieg auf Agentic Coding begleiten.
Was Sie in Ihrem Team festlegen sollten
Diese Punkte lassen sich kurzfristig umsetzen:
- Bestehende Freigaben prüfen. Gehen Sie die lokalen und projektweiten Berechtigungsregeln durch. Jede Regel mit Platzhalter für
git,curloder eigene Skripte gehört auf den Prüfstand. - Ablehnungen ins Repository schreiben. Lesen von Geheimnisdateien und
git pushwerden projektweit abgelehnt oder erfordern immer eine Rückfrage. git add .durch benannte Pfade ersetzen. In Projektregeln und Skripten wird festgelegt, dass der Agent nur Dateien hinzufügt, die er selbst geändert hat.- Secret-Scan vor dem Commit einrichten und den Push-Schutz im Repository aktivieren.
- Schlüssel für Agenten getrennt vergeben. Ein Agent arbeitet mit eigenen Zugangsdaten mit wenigen Rechten, nicht mit den persönlichen Schlüsseln der Entwicklerin.
- Den Ernstfall regeln. Wurde ein Schlüssel gepusht, wird er beim Anbieter gesperrt und ersetzt. Das Entfernen aus dem Repository allein genügt nicht, weil er in der Versionsgeschichte und in Kopien erhalten bleibt.
Wie dieser Rahmen um einen Coding-Agenten insgesamt aufgebaut ist, mit Projektregeln, Hooks und Prüfungen, beschreibt die Seite KI-Harness-Architektur.
Fazit
Eine dauerhafte Freigabe ist eine Regel, keine einzelne Entscheidung, und sie gilt oft weiter, als es in der Abfrage aussieht. Gefährlich wird das, wenn Zugangsdaten unverschlüsselt im Arbeitsverzeichnis liegen und Befehle wie git add . oder git push ohne Rückfrage erlaubt sind. Verlässlich ist der Schutz erst, wenn er an mehreren Stellen liegt: Ablehnungsregeln im Werkzeug, .gitignore und Secret-Scan im lokalen Repository, Push-Schutz beim Hosting-Anbieter. Wer dazu Commits nur mit benannten Pfaden zulässt und Agenten eigene Schlüssel mit wenigen Rechten gibt, kann Coding-Agenten auch ohne ständige Rückfragen arbeiten lassen.
Häufige Fragen
Was bedeutet „nicht mehr fragen“ bei einem Coding-Agenten?
Die Freigabe wird als Berechtigungsregel gespeichert und gilt künftig ohne Rückfrage. Häufig enthält die Regel einen Platzhalter und deckt damit alle Befehle ab, die gleich beginnen. Es lohnt sich deshalb, gespeicherte Regeln regelmäßig durchzusehen.
Wie verhindere ich, dass ein KI-Agent API-Schlüssel ins Repository committet?
Mit mehreren Sperren: Ablehnungsregeln für Geheimnisdateien im Werkzeug, Schlüsseldateien in der .gitignore, ein Secret-Scan vor jedem Commit und der Push-Schutz des Hosting-Anbieters. Zusätzlich sollte der Agent nur benannte Pfade zum Commit hinzufügen statt des ganzen Verzeichnisses.
Was tun, wenn ein Schlüssel versehentlich gepusht wurde?
Den Schlüssel sofort beim Anbieter sperren und durch einen neuen ersetzen. Das Löschen aus dem Repository allein reicht nicht, weil der Schlüssel in der Versionsgeschichte und in Kopien weiter lesbar sein kann.