KI-Coding-Agenten für Agenturen: Einsatz in mehreren Kundenprojekten

Um KI-Coding-Agenten über mehrere Kundenprojekte hinweg einzusetzen, gib jedem Kunden einen eigenen Ordner, eine eigene Anweisungsdatei und, wenn der Vertrag es verlangt, ein eigenes Agenten-Konto, und starte jeden Agenten ausschließlich im Ordner dieses Kunden. Die meisten Probleme, von denen Agenturen mit Agenten berichten (falsche Konventionen, durchgesickerter Kontext, überraschende Kosten), kommen von einem geteilten Setup, nicht vom Modell.

Dieser Leitfaden richtet sich an kleine Agenturen und Freelancer, die Claude Code, Codex oder einen anderen Coding-Agenten bereits in einem Projekt nutzen und ihn jetzt in fünf einsetzen wollen. Er behandelt das Setup pro Kunde, sichtbare Kosten, das Review vor der Auslieferung und wie du all das in einem Fenster behältst.

Warum ein Setup für alle Kunden nicht funktioniert

Ein Coding-Agent arbeitet mit dem, was er sieht: dem Ordner, in dem er startet, den Anweisungsdateien darin und dem Konto, mit dem er angemeldet ist. Werden diese über Kunden hinweg geteilt, gehen drei Dinge schief:

• Konventionen sickern durch. Der Agent übernimmt Gewohnheiten aus dem Code oder den Anweisungen des letzten Kunden und wendet sie beim nächsten an.
• Kosten verschwimmen. Ein Konto und ein Nutzungsbalken für alles heißt, dass du nicht erkennst, welcher Kunde was verbraucht hat.
• Der Zugriff ist breiter als nötig. Ein Agent, der in einem übergeordneten Ordner startet, kann jeden Kundenordner darunter lesen, auch .env-Dateien.

Die Lösung ist langweilig und funktioniert: eine Grenze pro Kunde.

Schritt 1: ein Ordner pro Kunde, und Agenten darin starten

Leg jeden Kunden in einen eigenen Ordner mit eigenem Repository:

~/clients/
  acme-shop/
  dental-clinic-site/
  logistics-dashboard/

Starte den Agenten immer aus einem einzelnen Kundenordner heraus, nie aus ~/clients/. Claude Code, Codex und Gemini CLI behandeln alle den Ordner, in dem du sie startest, als Projekt. Brauchst du einen zweiten Agenten beim selben Kunden, etwa einen für einen Bugfix und einen für eine neue Seite, gib ihm einen Git-Worktree, damit sie nicht dieselben Dateien bearbeiten.

Schritt 2: eine Anweisungsdatei pro Kunde schreiben

Jeder Coding-Agent liest zu Beginn einer Sitzung eine Projekt-Anweisungsdatei: CLAUDE.md bei Claude Code, AGENTS.md bei Codex und vielen anderen. Leg eine ins Stammverzeichnis jedes Kundenordners. Halte sie kurz und konkret:

# Kunde: Onlineshop (Shopify-Theme + Node-API)

- Stack: Liquid-Theme, Node 22, Postgres. Tests: npm test.
- Stil des Kunden: keine neuen Abhängigkeiten ohne Rückfrage; Texte auf Türkisch und Englisch.
- Nie anfassen: Zahlungseinstellungen, /infra, .env-Dateien der Produktion.
- Fertig heißt: Tests laufen durch, ein Pull Request mit kurzer Zusammenfassung für den Kunden.

Diese Datei macht den Unterschied zwischen einem Agenten, der rät, und einem, der die Regeln des Kunden befolgt. Ändert ein Kunde eine Regel, änderst du die Datei, nicht deine Prompts.

Schritt 3: Konten pro Kunde festlegen

Manchen Kunden ist egal, auf welchem Konto der Agent läuft. Andere wollen, dass die Arbeit auf einem Konto erledigt wird, das sie bezahlen, oder verbieten, ihren Code an einen Anbieter zu schicken, den sie nicht freigegeben haben. Prüf zuerst den Vertrag.

Braucht ein Kunde eine eigene Anmeldung, gib diesem Konto einen eigenen Config-Ordner. Claude Code liest seinen Ordner aus CLAUDE_CONFIG_DIR und Codex aus CODEX_HOME, zwei Ordner bedeuten also zwei Anmeldungen auf demselben Rechner, ohne dich abzumelden. Unser Leitfaden zum Wechseln von Claude-Code-Konten zeigt das manuelle Setup Schritt für Schritt.

Schritt 4: Secrets außer Reichweite halten

Agenten lesen Dateien, um ein Projekt zu verstehen, und .env-Dateien sind Dateien. Pro Kunde:

• halte Zugangsdaten der Produktion aus dem Arbeitsordner heraus; nutze eine Entwicklungs-.env mit Testschlüsseln;
• trag die sensiblen Pfade in der Anweisungsdatei unter „Nie anfassen“ ein;
• nutze die Berechtigungseinstellungen des Agenten, damit er nachfragt, bevor er Befehle ausführt, die deployen, migrieren oder löschen.

Schritt 5: Tokens pro Kunde messen

Wenn du KI-Nutzung abrechnen oder einfach wissen willst, welcher Kunde sich rechnet, miss sie vom ersten Tag an pro Agent und pro Ordner. Zwei einfache Regeln helfen:

• setz ein Tageslimit pro Agent, damit eine hängende Schleife nicht über Nacht das Budget eines Kunden verbrennt;
• nimm das günstigere Modell für Routineänderungen und das stärkere nur für Design und Debugging.

Unser Beitrag zu den Nutzungslimits von Claude Code erklärt, wie das 5-Stunden- und das Wochenlimit funktionieren. Das wird wichtig, sobald sich mehrere Kunden ein Abo teilen.

Schritt 6: jeden Diff prüfen, bevor der Kunde ihn sieht

Lass Agenten auf einem Branch arbeiten und einen Pull Request öffnen. Lies den Diff, führe die Tests aus und sieh dir die Seite selbst an. Kunden bezahlen nicht für Code, den ein Agent geschrieben hat; sie bezahlen für Code, den jemand geprüft hat, dem sie vertrauen. Eine kurze schriftliche Zusammenfassung pro Pull Request macht außerdem das wöchentliche Kunden-Update einfach.

Das alles in einem Fenster mit AgentVera

Die Schritte oben funktionieren mit normalen Terminals. Schwierig ist es, fünf Kunden und zehn Agenten im Blick zu behalten. AgentVera ist eine Desktop-App für macOS, Windows und Linux, die Claude Code, Codex, Gemini CLI und andere Agenten nebeneinander ausführt, jeden in einem echten Terminal mit deiner eigenen Installation und Anmeldung. Für Agenturarbeit zählen diese Teile:

• Ein Raster pro Projekt. Jeder Kundenordner bekommt eigene Agenten, und du wechselst zwischen Kunden, ohne ihren Zustand zu verlieren. Siehe Workspace.
• Ein Konto pro Agent. Füge Konten unter Settings → Accounts hinzu und wähle beim Erstellen eines Agenten eines aus, damit die Agenten eines Kunden immer mit der richtigen Anmeldung laufen. Siehe Konten.
• Token-Limits pro Agent. Limits pro Agent, pro Runde und pro Tag, eine Warnung bei 80 %, und am Limit stoppt der Agent, behält aber seine Unterhaltung. Siehe Token-Budgets.
• Code-Review vor der Auslieferung. Prüfe die Änderungen des Agenten in der App, bevor sie ins Repository des Kunden gehen. Siehe Code-Review.

Der kostenlose Plan umfasst bis zu 18 Agenten, MCP, Git, Docker, SSH, Code-Review und Token-Einsparungen. Pro kostet 9,99 $ im Monat; wenn du noch nie eine Testphase hattest, schaltet deine erste Anmeldung in der App Pro für 7 Tage frei, ohne Karte.

Fazit

Agenten skalieren auf viele Kunden, wenn jeder Kunde eine klare Grenze hat: einen eigenen Ordner, eine eigene Anweisungsdatei, das richtige Konto, keine Produktions-Secrets in Reichweite, eine eigene Token-Zählung und ein menschliches Review vor der Auslieferung. Richte das einmal pro Kunde ein, und der sechste Kunde kostet dich Minuten, nicht eine Woche Aufräumarbeit.

Quellen: Claude Code settings, AGENTS.md.