So verwenden Sie Claude Code-Agenten: Einrichtung, Tools, Berechtigungen und Sandbox-Workflow

Um Claude Code-Agenten gut zu nutzen, behandeln Sie Claude Code als einen Agenten-Loop und nicht als ein Chat-Fenster: Starten Sie es im Repository, das Sie ändern möchten, geben Sie ihm klare Projektanweisungen, verbinden Sie nur die Tools, die es tatsächlich benötigt, halten Sie die Berechtigungen eng und führen Sie die Ausführung in einer isolierten Laufzeitumgebung durch, sobald der Workflow über risikoarme lokale Bearbeitungen hinausgeht. Das ist der Unterschied zwischen einer hilfreichen Codierungssitzung und einer teuren, unübersichtlichen.

Wenn Ihre Hauptfrage über Claude Code hinausgeht, beginnen Sie mit Was sind Coding-Agenten? für die Architekturansicht. Wenn Sie sich zuerst zwischen Tools entscheiden, vergleichen Sie Claude Code vs. Cursor. Dieser Leitfaden ist enger gefasst: Wie Sie Claude Code-Agenten in der Praxis verwenden.

Was die Leute normalerweise mit „Claude Code-Agenten“ meinen

Die meisten Entwickler, die nach „Claude Code-Agenten“ suchen, meinen eines von zwei Dingen:

1. Claude Code selbst als autonomen Coding-Agenten.
2. Mehrere spezialisierte Agenten, Tools oder Subagenten, die innerhalb eines Claude Code-Workflows arbeiten.

Beides ist gültig. Claude Code verhält sich bereits wie ein agentisches Codierungstool: Es kann ein Repository inspizieren, Dateien bearbeiten, Befehle ausführen und auf Ergebnisse reagieren. Anthropic dokumentiert auch verwandte Bausteine wie MCP-Tool-Integrationen, Hooks und Subagenten, weshalb der Begriff oft im Plural auftaucht.

Das praktische Modell ist einfach:

• Claude Code ist der Host-Workflow.
• Das Modell übernimmt die Planung und die Entscheidungen über die nächsten Schritte.
• Tools bieten Zugriff auf Dateien, Befehle, Browser, APIs und externe Systeme.
• Berechtigungen legen fest, was Claude ohne Nachfragen tun darf.
• Eine Sandbox bietet einen sicheren Ort für die Ausführung von Code und Tools.

Wenn Sie diese fünf Ebenen getrennt halten, wird Claude Code viel zuverlässiger bedienbar.

Schritt 1: Claude Code installieren und im richtigen Verzeichnis starten

Anthropic dokumentiert Claude Code als installierbare CLI. Der Standard-Installationspfad ist:

npm install -g @anthropic-ai/claude-code
claude

Das wichtige Detail ist nicht nur die Installation. Starten Sie Claude Code aus dem Repository, an dem es arbeiten soll. Claude Code liest das aktuelle Verzeichnis, lokale Projektanweisungen und alle projektspezifischen Tool-Konfigurationen von dort.

Wenn das Repository neu ist, führen Sie Folgendes aus:

/init

Dadurch wird eine Starterdatei CLAUDE.md für projektspezifische Anweisungen erstellt. Nutzen Sie sie für Dinge, an die sich Claude in jeder Sitzung erinnern soll: bevorzugte Testbefehle, Codierungsstandards, Architekturgrenzen, Überprüfungserwartungen und Dateien, die es vorsichtig behandeln soll.

Dies ist wichtiger, als die meisten Benutzer erwarten. Ein Claude Code-Agent ohne repository-spezifische Anweisungen ist in der Regel nicht zu schwach – er ist zu wenig spezifiziert.

Schritt 2: Dem Agenten eine Aufgabe geben, die er tatsächlich ausführen kann

Claude Code funktioniert am besten, wenn die Aufgabe ein konkretes Ergebnis und einen Überprüfungsschritt umfasst.

Gute Beispiele:

• „Rate-Limiting für /login hinzufügen, Tests aktualisieren und die betroffene Testdatei ausführen.“
• „Refaktorieren Sie den Abrechnungsdienst für den neuen Client und führen Sie dann die Komponententests für dieses Paket aus.“
• „Überprüfen Sie dieses PR-Diff auf Sicherheits- und Korrektheitsprobleme.“

Schwache Aufforderungen sind meist genau auf die falsche Weise vage:

• „Verbessern Sie diesen Code.“
• „Machen Sie die App besser.“
• „Überprüfen Sie das Projekt.“

Agentische Codierungstools schneiden besser ab, wenn die Ziellinie explizit ist. Wenn Sie Autonomie wünschen, definieren Sie den Erfolg. Wenn Sie Erkundung wünschen, definieren Sie den Umfang.

Schritt 3: Nur die benötigten Tools konfigurieren

Claude Code verwendet das Model Context Protocol für externe Tools. In der Praxis bedeutet das, dass MCP-Server die Erweiterungsfläche für Browser, Datenbanken, Issue-Tracker, GitHub, Codeläufer und interne Dienste sind.

Der häufigste Einrichtungsbefehl ist:

claude mcp add playwright -- npx -y @playwright/mcp@latest

Damit erhält Claude Browser-Automatisierungstools. Die MCP-Dokumentation und der Schnellstart von Anthropic beschreiben das gleiche Muster für andere Server.

Die wichtigste Betriebsregel ist Zurückhaltung: Hängen Sie nicht jedes Tool an, das Sie irgendwann einmal brauchen könnten. Hängen Sie das kleinste Toolset an, das zur Aufgabe passt. Zu viele Tools erhöhen das Startrauschen, erweitern die Aktionsfläche und machen die Toolauswahl weniger vorhersagbar.

Für die meisten Repository-Arbeiten ist ein sinnvoller Startsatz:

• lokaler Datei- und Shell-Zugriff
• ein Browser-Tool, wenn Web-QA erforderlich ist
• ein Issue- oder Dokumentations-Tool, wenn die Aufgabe von einem externen System abhängt

Alles andere sollte sich seinen Platz verdienen.

Schritt 4: Berechtigungen bewusst verwenden, nicht als Nebensache

Einer der größten Unterschiede zwischen einem sicheren Claude Code-Workflow und einem leichtsinnigen ist die Berechtigungsdisziplin.

Claude Code bietet Berechtigungskontrollen, weil die Tool-Ausführung die eigentliche Risikogrenze darstellt. Eine Datei zu lesen ist eine Sache. Installationsskripte auszuführen, Verzeichnisse zu löschen oder auf externe Dienste zuzugreifen, ist eine andere.

Verwenden Sie /permissions frühzeitig in einem Projekt, besonders wenn die Sitzung möglicherweise:

• viele Dateien schreibt
• Shell-Befehle ausführt
• Pakete installiert
• auf Geheimnisse oder interne Systeme zugreift
• MCP-Tools mit Seiteneffekten aufruft

Die richtige Einrichtung hängt von der Aufgabe ab:

• Für exploratives Debugging ist „vor Ausführung fragen“ normalerweise die sicherere Voreinstellung.
• Für wiederholte, klar abgegrenzte Repository-Arbeiten können Erlaubnisregeln Unterbrechungen reduzieren.
• Für risikoreiche Befehle oder sensible Pfade sollten Verbotsregeln explizit bleiben.

Hier machen viele Teams die falsche Optimierung. Sie entfernen Reibung, indem sie Berechtigungen zu weit öffnen, und versuchen dann, die Kontrolle nur durch die Formulierung des Prompts zurückzugewinnen. Das ist rückwärtsgewandt. Prompting ist Führung. Berechtigungen sind Durchsetzung.

Schritt 5: Den eigentlichen Agenten-Loop verstehen

Claude Code fühlt sich leistungsstark an, wenn Sie verstehen, was unter der Haube passiert.

Der Loop sieht normalerweise so aus:

1. Claude liest die Aufgabe und den Projektkontext.
2. Es plant den nächsten sinnvollen Schritt.
3. Es liest Dateien oder ruft Tools auf.
4. Es bearbeitet Code oder führt einen Befehl aus.
5. Es überprüft die Ausgabe.
6. Es überarbeitet den Plan basierend auf dem, was passiert ist.
7. Es stoppt, wenn das angeforderte Ergebnis vollständig ist.

Dieser Loop erklärt, warum sich Agenten-Workflows von der normalen Chatbot-Nutzung unterscheiden. Das Modell generiert nicht nur Code. Es koordiniert den Zustand über Tools, Dateien, Befehlsausgaben und zwischenzeitliche Fehlschläge hinweg.

Bei realer Repository-Arbeit sind die wichtigsten Teile normalerweise nicht die erste Antwort. Es sind die Wiederherstellungsschritte nach dem ersten Testfehler, Lint-Fehler oder Umgebungsinkonsistenz.

Schritt 6: Subagenten einsetzen, wenn Spezialisierung hilft

Claude Code unterstützt jetzt Subagenten, weil ein Allzweck-Agent nicht immer die beste Wahl für jede Aufgabe ist.

Subagenten sind sinnvoll, wenn der Workflow von Spezialisierung profitiert, zum Beispiel:

• ein Agent für die Implementierung
• ein Agent für die Code-Überprüfung
• ein Agent für die Dokumentation
• ein Agent für die Testuntersuchung

Das bedeutet nicht, dass jedes Projekt einen Schwarm braucht. In kleinen Repositories können mehrere Agenten mehr Overhead als Mehrwert verursachen. Aber für Teams mit wiederholbaren Übergaben sind Subagenten nützlich, weil sie die Formulierung enger gefasster Anweisungen und Verantwortlichkeiten ermöglichen.

Das Betriebsprinzip ist dasselbe, das gute Engineering-Teams bereits verwenden: Trennen Sie Rollen, wenn die Grenzen klar genug sind, um nützlich zu sein.

Wenn Sie nicht erklären können, warum ein zweiter Agent existiert, brauchen Sie ihn wahrscheinlich nicht.

Schritt 7: Hooks für Kontrolle und Nachvollziehbarkeit verwenden

Hooks sind die richtige Antwort, wenn Sie möchten, dass Claude Code-Sitzungen an bestimmten Punkten im Workflow vorhersagbare Überprüfungen auslösen.

Beispiele:

• Formatierung nach Dateiänderungen ausführen
• Dateiänderungen nach Schreibvorgängen protokollieren
• Befehle blockieren, die geschützte Pfade betreffen
• Ereignisse in ein lokales Audit-Trail senden

Hooks sind wichtig, weil sie den Workflow weniger davon abhängig machen, dass das Modell sich jedes Mal an jede Richtlinie erinnert. Wenn ein Schritt nach einer Kategorie von Aktionen immer stattfinden muss, automatisieren Sie diese Grenze, anstatt darauf zu hoffen, dass der Sitzungs-Prompt ausreicht.

Dies ist besonders wichtig, sobald Claude Code Teil eines wiederholbaren Teamprozesses und nicht mehr ein einmaliges individuelles Werkzeug wird.

Wo Novita in einen Claude Code-Agenten-Stack passt

Claude Code ist die Agentenschnittstelle. Es ist nicht der gesamte Stack.

Sobald ein Team Claude Code ernsthaft nutzt, tauchen zwei separate Infrastrukturfragen auf:

1. Welches Modell-Backend sollte das Denken übernehmen?
2. Wo soll die Tool-Ausführung tatsächlich stattfinden?

Genau das sind die Stellen, an denen Novita natürlich passt.

Novita LLM-API für Backend-Flexibilität nutzen

Novita dokumentiert einen Anthropic-kompatiblen Endpunkt für Claude Code-ähnliche Workflows. Das bedeutet, Sie können das Claude Code-Interaktionsmuster beibehalten, während Sie den Modellverkehr über bei Novita gehostete Modelle leiten, anstatt nur eine Standardroute zu verwenden.

Das Standard-Umgebungsmuster ist:

export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<your-novita-api-key>"
export ANTHROPIC_MODEL="qwen/qwen3-coder-480b-a35b-instruct"

Diese Einrichtung ist nützlich, wenn Sie verschiedene Codierungsmodelle benchmarken möchten, ohne Ihre Tool-Schicht neu aufzubauen.

Sie schafft auch einen natürlicheren Weg für Teams, die die Ergonomie von Claude Code, aber keine Ein-Modell-Betriebsannahme wünschen. Die Schnittstelle bleibt vertraut; das Backend wird testbar.

Novita Agent-Sandbox für Ausführungsisolation nutzen

Die zweite Hälfte des Problems ist die Ausführung.

Ein Claude Code-Agent, der nur kleine lokale Dateien liest und schreibt, ist eine Sache. Ein Claude Code-Agent, der Befehle ausführt, Pakete installiert, Browser startet, Abhängigkeiten herunterlädt oder produktionsähnliche Systeme berührt, ist eine andere.

Hier hört eine isolierte Laufzeitumgebung auf, optional zu sein, und wird Teil des Designs.

Die Novita Agent-Sandbox ist genau für diese Ebene positioniert: isolierte Umgebungen für Codeausführung, Dateisystemarbeit, Browserautomatisierung und langlebige Agenten-Workflows. Mit anderen Worten: Sie deckt den Teil des Stacks ab, in dem Seiteneffekte auftreten.

Das saubere Gedankenmodell ist:

• Verwenden Sie Claude Code für den Agenten-Workflow.
• Verwenden Sie Novita LLM-API für Modell-Routing und Experimente.
• Verwenden Sie Novita Agent-Sandbox für sichere Ausführungsgrenzen.

Denken und Ausführung getrennt zu halten, ist in der Regel die bessere langfristige Architektur.

Eine praktische Open-Model-Option im selben Workflow

Sobald Claude Code gut funktioniert, ist die nächste Frage normalerweise nicht „Kann das Agenten verwenden?“ sondern „Welches Backend lohnt sich täglich?“

An dieser Stelle werden Open-Weight-Coding-Modelle auf eine sehr praktische Weise interessant. Wenn Ihrem Team die Oberfläche von Claude Code gefällt, aber günstigere Experimente oder mehr Anbieterflexibilität gewünscht sind, kann ein offenes Modell der richtige nächste Benchmark sein.

Ein glaubwürdiger Kandidat ist Qwen3-Coder-480B-A35B-Instruct über Novitas Anthropic-kompatiblen Weg. Sie müssen es nicht als garantierte Ersetzung von Claude bei jeder Aufgabe behandeln. Sie sollten es als ernsthafte Coding-Modell-Option betrachten, die in denselben Bewertungssatz wie geschlossene Alternativen gehört.

Das ist die natürliche Verschiebung, die viele Teams vornehmen:

• den Agenten-Workflow behalten
• die Tools behalten
• das Berechtigungsmodell behalten
• das Backend ändern und tatsächliche Aufgabenergebnisse vergleichen

Wenn die Arbeit von Repository-Navigation, unkomplizierter Implementierung und Tool-Aufrufen dominiert wird und nicht von Denken auf Spitzenniveau, kann ein offenes Modell wettbewerbsfähig genug sein, um den Test zu rechtfertigen.

Das ist einer der nützlicheren Aspekte der Novita-Einrichtung: Sie ermöglicht es Ihnen, diese Frage innerhalb eines vertrauten Claude Code-Workflows zu vergleichen, anstatt den Benchmark in ein Migrationsprojekt zu verwandeln.

Häufige Fehler bei der Verwendung von Claude Code-Agenten

Die meisten Fehler kommen vom Workflow-Design, nicht von der Idee des agentischen Codierens selbst.

Dem Agenten breite Ziele ohne Ziellinie geben

Wenn Sie zuverlässige Ergebnisse wünschen, spezifizieren Sie das Lieferobjekt und wie es zu überprüfen ist.

Zu viele Tools anhängen

Mehr Tools machen Claude nicht automatisch schlauer. Sie machen das Routing normalerweise verrauschter.

Berechtigungen als UX-Ärgernis behandeln

Berechtigungen sind die Kontrollebene für Seiteneffekte. Sie sollten abgestimmt, nicht umgangen werden.

Risikoreiche Aktionen direkt auf einem Entwicklerrechner ausführen

Wenn der Agent Browserautomatisierung, Paketinstallationen oder wiederholte Befehlsausführungen durchführt, verwenden Sie eine isolierte Laufzeitumgebung.

Eine gute Demo mit einem Produktionsworkflow verwechseln

Eine Claude Code-Demo kann in fünf Minuten gut aussehen. Ein Produktionsworkflow benötigt Richtlinien, Prüfung, Laufzeitisolation und Modellauswahldisziplin.

Empfohlener Workflow für die meisten Teams

Wenn Sie einen pragmatischen Standard möchten, verwenden Sie diese Reihenfolge:

1. Starten Sie Claude Code im Ziel-Repository.
2. Führen Sie /init aus und machen Sie CLAUDE.md nützlich.
3. Hängen Sie nur die für die Aufgabe benötigten MCP-Tools an.
4. Konfigurieren Sie /permissions vor der breiten Ausführung.
5. Verwenden Sie eine Sandbox, wenn der Workflow echten Code oder Browserschritte ausführt.
6. Benchmarken Sie mindestens ein alternatives Backend über Novita, bevor Sie Kostenannahmen standardisieren.

Diese Sequenz hält das System verständlich. Sie verhindert auch, dass Produktergonomie, Modellqualität, Tool-Vielfalt und Laufzeitsicherheit zu einer einzigen verschwommenen Entscheidung vermischt werden.

FAQ

Ist Claude Code selbst ein Agent?

Ja. Claude Code ist ein agentischer Codierungs-Workflow und kein einfaches Code-Vervollständigungswerkzeug. Es kann Dateien inspizieren, Code bearbeiten, Befehle ausführen und auf Tool-Ergebnisse reagieren.

Brauche ich MCP, um Claude Code-Agenten zu verwenden?

Nein. Claude Code ist auch mit alleinigem lokalem Repository-Zugriff nützlich. MCP wird wichtig, wenn Sie externe Tools wie Browser, Datenbanken, APIs oder Issue-Systeme einbinden möchten.

Wann sollte ich eine Sandbox mit Claude Code verwenden?

Verwenden Sie eine, wenn der Workflow Code ausführt, Pakete installiert, Browser startet oder wiederholte Aktionen mit Seiteneffekten durchführt, die Sie nicht direkt auf dem Host ausgeführt haben möchten.

Kann Claude Code Modelle über Novita verwenden?

Novita dokumentiert eine Anthropic-kompatible Einrichtung für Claude Code-ähnliche Workflows, sodass Sie die Claude Code-Oberfläche beibehalten können, während Sie Modellanfragen über bei Novita gehostete Modelle leiten.

Sollte ich sofort mehrere Subagenten verwenden?

In der Regel nein. Beginnen Sie mit einem Agenten und fügen Sie Subagenten nur hinzu, wenn die Spezialisierung klar genug ist, um Verwirrung zu verringern, anstatt sie zu erzeugen.

Empfohlene Artikel

• Claude Code Plugins: Wie MCP-Tools Claude Code mit externen Fähigkeiten erweitern
• Claude Code Supported Models in 2026: Which One Should You Use?
• Was sind Coding-Agenten? Wie sie funktionieren und wie man einen erstellt

Quellen geprüft am 24. August 2026: Anthropic Claude Code overview, Anthropic Claude Code settings and permissions, Anthropic Claude Code hooks, Anthropic Claude Code subagents, Anthropic Claude Code MCP, Novita Claude Code guide, und Novita Sandbox overview.