Unbegrenzter Zugang zu Claude Code

Claude Code ist der offizielle Kommandozeilenagent von Anthropic für die Softwareentwicklung. Er arbeitet mit einem Kontextfenster von 200k, startet Unteragenten mit eigenen unabhängigen Kontexten, liest vollständige Dateien in den Gesprächsverlauf ein und sendet bei jedem Austausch den gesamten Kontext erneut — dadurch wächst der Tokenverbrauch in langen Sitzungen quadratisch. Das macht ihn zu einem der tokenintensivsten verfügbaren Entwicklertools. Die Anbindung von Claude Code an ein Gateway mit unbegrenzter Nutzung zum Pauschalpreis verwandelt ihn von einem sorgfältig rationierten Werkzeug in einen echten, jederzeit verfügbaren Entwicklungspartner.

Warum der Tokenverbrauch von Claude Code quadratisch wächst

Aus Sicht der API ist Claude Code zwischen den einzelnen Gesprächsschritten zustandslos. Jede Nachricht, die Sie senden, enthält den gesamten Gesprächsverlauf — alle vorherigen Nachrichten, alle eingelesenen Dateiinhalte, alle Tool-Ergebnisse und alle Antworten des Assistenten. Die erste Nachricht umfasst vielleicht 5,000 Tokens. Beim zehnten Austausch senden Sie bereits 50,000 Tokens an Verlauf zuzüglich aller neu hinzugekommenen Inhalte. Beim zwanzigsten Austausch kann der Kontext 150,000 Tokens pro Anfrage überschreiten.

Unteragenten verstärken diesen Effekt. Wenn Claude Code Arbeit an einen Unteragenten delegiert, erhält dieser ein eigenes Kontextfenster und beginnt, unabhängig seinen eigenen Verlauf aufzubauen. Der Kontext des übergeordneten Agenten wächst um die Zusammenfassung des Unteragenten, während der Unteragent selbst eigene Tokenkosten verursacht. Agententeams — in denen mehrere Unteragenten zusammenarbeiten — vervielfachen dies zusätzlich. Bei einer komplexen Aufgabe können ein übergeordneter Agent und drei Unteragenten beteiligt sein, jeder mit einem Kontext von 100k oder mehr Tokens, die alle denselben API-Schlüssel verwenden.

Der Befehl /compact hilft, indem er den Verlauf zusammenfasst und alten Kontext kürzt. Er ist jedoch ein manueller Eingriff, der Details zugunsten von Platz aufgibt. Bei einer Abrechnung pro Token komprimieren Nutzer ständig den Kontext, um die Kosten zu kontrollieren. Bei unbegrenzter Nutzung können Sie Gespräche natürlich wachsen lassen, den Kontext erst komprimieren, wenn seine Qualität nachlässt, und Unteragenten frei einsetzen, ohne deren Kosten im Kopf auszurechnen.

Konfiguration über Umgebungsvariablen

Claude Code liest seine API-Konfiguration aus Umgebungsvariablen. Die beiden wesentlichen Variablen sind ANTHROPIC_BASE_URL und entweder ANTHROPIC_API_KEY oder ANTHROPIC_AUTH_TOKEN. Setzen Sie ANTHROPIC_BASE_URL auf https://unlimited.aiprimetech.io — den Basishost ohne /v1, da das Anthropic SDK den API-Pfad automatisch anhängt. Verwenden Sie für den Schlüssel ANTHROPIC_API_KEY, wenn Ihr Gateway eine Authentifizierung über den Header x-api-key erwartet (das Standardformat von Anthropic).

Tragen Sie diese Variablen für eine dauerhafte Konfiguration in Ihr Shell-Profil ein (.bashrc, .zshrc oder PowerShell $PROFILE). Unter Windows können Sie sie auch über den Dialog „Erweiterte Systemeinstellungen“ als Systemumgebungsvariablen festlegen. Claude Code liest sie beim Start ein — wenn Sie sie ändern, starten Sie die Claude Code-Sitzung neu, damit die neuen Werte wirksam werden.

Für projektspezifische Überschreibungen erstellen Sie eine .env-Datei im Stammverzeichnis Ihres Projekts. Claude Code lädt .env-Dateien aus dem Arbeitsverzeichnis. So können Sie für jedes Projekt unterschiedliche API-Konfigurationen verwenden — nützlich, wenn Sie für einige Projekte unbegrenzte Nutzung und für andere die direkte Abrechnung über Anthropic verwenden. Die .env-Datei hat Vorrang vor Systemumgebungsvariablen.

Modellzuordnung für Sonnet, Opus, Haiku und Fable

Claude Code verwendet interne Modellaliase, die Sie mit Umgebungsvariablen überschreiben können. ANTHROPIC_DEFAULT_SONNET_MODEL steuert, welches Modell für die Standardauswahl „sonnet“ verwendet wird. ANTHROPIC_DEFAULT_OPUS_MODEL überschreibt die Auswahl „opus“. ANTHROPIC_DEFAULT_HAIKU_MODEL und ANTHROPIC_DEFAULT_FABLE_MODEL steuern die übrigen Modellstufen. Setzen Sie diese auf die exakten Modell-IDs, die Ihr Gateway unterstützt.

Setzen Sie beispielsweise ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5 und ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6.. Wenn Sie in Claude Code über /model oder das Startflag eine Modellstufe auswählen, wird diese auf das von Ihnen zugeordnete Modell aufgelöst. Das ist besonders nützlich, wenn das Gateway eigene Modellkennungen bereitstellt oder Sie bestimmte Modellversionen festlegen möchten.

Bei unbegrenzter Nutzung ist die Modellwahl ausschließlich eine Abwägung zwischen Qualität und Geschwindigkeit. Zwischen den Modellstufen gibt es keinen Kostenunterschied. Verwenden Sie Opus standardmäßig für maximale Qualität und wechseln Sie nur zu Sonnet oder Haiku, wenn Sie bei schnellen Iterationen kürzere Antwortzeiten benötigen. Mit dem Befehl /effort können Sie zusätzlich einstellen, wie gründlich Claude Code jede Aufgabe bearbeitet — kombinieren Sie einen hohen Aufwand mit Opus für die leistungsfähigste Konfiguration.

Unteragenten, Agententeams und Hintergrundagenten

Claude Code kann Unteragenten starten — unabhängige Claude-Instanzen mit eigenen Kontextfenstern, die delegierte Teilaufgaben bearbeiten. Wenn der Hauptagent auf eine komplexe Aufgabe trifft, kann er Recherche, Implementierung oder Überprüfung an Unteragenten delegieren, die isoliert arbeiten und anschließend Bericht erstatten. Jeder Unteragent beginnt mit einem frischen Kontext und baut seinen eigenen Gesprächsverlauf auf.

Agententeams erweitern dieses Konzept, indem sie mehreren Unteragenten ermöglichen, gleichzeitig an zusammenhängenden Aufgaben zu arbeiten. Der Hauptagent übernimmt die Koordination, verteilt Arbeit und führt Ergebnisse zusammen. Das ist bei umfangreichen Änderungen äußerst leistungsfähig — ein Unteragent kann Modul A refaktorieren, während ein anderer Modul B bearbeitet — allerdings steigt der API-Verbrauch linear mit der Anzahl aktiver Agenten.

Hintergrundagenten laufen asynchron, während Sie in der Hauptsitzung weiterarbeiten. Sie bearbeiten separate Aufgaben und melden die Ergebnisse nach Abschluss. Bei einer Abrechnung pro Token wird der gleichzeitige Betrieb mehrerer Hintergrundagenten schnell teuer. Bei unbegrenzter Nutzung können Sie mehrere Hintergrundagenten starten, sie an verschiedenen Aspekten Ihres Projekts arbeiten lassen und ihre Ergebnisse prüfen, sobald sie vorliegen — alles durch den Pauschalpreis abgedeckt.

Setzen Sie CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1, um zu verhindern, dass Claude Code Telemetriedaten und nicht wesentliche Anfragen sendet. Dies ist bei jedem benutzerdefinierten Gateway eine sinnvolle Maßnahme, um unnötigen Datenverkehr zu reduzieren. Zusätzlich weist CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 Claude Code an, das Gateway nach verfügbaren Modellen abzufragen, statt fest codierte Listen zu verwenden.

Headless-Modus und CI/CD-Integration

Der Headless-Modus von Claude Code (Flag --headless) läuft ohne interaktive Eingabeaufforderungen und eignet sich damit für CI/CD-Pipelines, automatisierte Code-Reviews und Stapelverarbeitung. Im Headless-Modus liest Claude Code Eingaben aus stdin oder aus Kommandozeilenargumenten und gibt Ergebnisse auf stdout aus. Er beendet sich, sobald die Aufgabe abgeschlossen ist, statt auf weitere Eingaben zu warten.

Für die CI-Integration legen Sie die Umgebungsvariablen in Ihrer Pipeline-Konfiguration fest (GitHub Actions-Secrets, GitLab CI-Variablen, Jenkins-Zugangsdaten) und rufen Claude Code mit der Aufgabenbeschreibung als Argument auf. Typische CI-Anwendungsfälle sind automatisierte PR-Reviews, die Erstellung von Dokumentation, das Schreiben von Tests und Migrationsskripte.

Bei unbegrenzter Nutzung ermöglicht der Headless-Modus Workflows mit hohem Durchsatz. Sie können Claude Code für jeden PR in einem Repository ausführen, Testsuites für ungetestete Module im Stapel erzeugen oder Dokumentationsaktualisierungen bei jeder Veröffentlichung automatisieren — ohne sich über Kosten pro Aufruf Gedanken machen zu müssen. Der Pauschalpreis deckt das gesamte Volumen ab, solange es innerhalb der Fair-Use-Ratenlimits bleibt.

CLAUDE.md-Projektgedächtnis und Hooks

CLAUDE.md-Dateien stellen dauerhaften Projektkontext bereit, den Claude Code automatisch lädt. Legen Sie eine CLAUDE.md im Stammverzeichnis Ihres Projekts an, die Coding-Standards, Architekturentscheidungen, gängige Muster und projektspezifische Anweisungen enthält. Dieser Inhalt wird in den System-Prompt jeder Anfrage aufgenommen. Das erhöht die Tokenzahl jedes Aufrufs, verbessert aber die Qualität und Konsistenz der Antworten erheblich.

Bei einer Abrechnung pro Token halten Nutzer CLAUDE.md möglichst knapp, um die Kosten zu kontrollieren — jedes Wort fügt während der gesamten Sitzung jeder einzelnen Anfrage Tokens hinzu. Bei unbegrenzter Nutzung können Sie so viel Kontext schreiben, wie tatsächlich hilfreich ist: ausführliche Architekturdokumentation, vollständige Styleguides, Erläuterungen zu Abhängigkeiten und Teamkonventionen. Die zusätzlichen Tokens pro Anfrage verursachen keine Mehrkosten, und die Qualitätsverbesserung verstärkt sich mit jeder Interaktion.

Mit Hooks können Sie benutzerdefinierte Skripte an bestimmten Punkten der Ausführung von Claude Code starten — vor und nach Tool-Aufrufen, beim Sitzungsstart und bei der Kontextkomprimierung. Verwenden Sie Hooks, um dynamischen Kontext einzufügen, Änderungen anhand von CI-Prüfungen zu validieren, Code automatisch zu formatieren oder Benachrichtigungen auszulösen. Hooks lassen sich nahtlos mit dem Gateway für unbegrenzte Nutzung einsetzen, da sie auf CLI-Ebene statt auf API-Ebene arbeiten.

Fehlerbehebung bei Gateway-Problemen mit Claude Code

Wenn Claude Code keine Verbindung herstellen kann, prüfen Sie, ob ANTHROPIC_BASE_URL auf den Basishost ohne /v1 gesetzt ist. Führen Sie echo $ANTHROPIC_BASE_URL aus (oder $env:ANTHROPIC_BASE_URL in PowerShell), um den Wert zu überprüfen. Das SDK hängt /v1/messages automatisch an — wenn Sie /v1 in die Basis-URL aufnehmen, gehen Anfragen an /v1/v1/messages, was einen 404 zurückgibt.

Fehler wegen eines nicht gefundenen Modells bedeuten, dass die Modell-ID in Ihrer Zuordnungsvariablen nicht mit dem übereinstimmt, was das Gateway bereitstellt. Prüfen Sie die exakten unterstützten Kennungen in Ihrem AI Prime Tech-Dashboard und aktualisieren Sie ANTHROPIC_DEFAULT_SONNET_MODEL entsprechend. Denken Sie daran, dass Modell-IDs zwischen Groß- und Kleinschreibung unterscheiden und Versionssuffixe enthalten.

Wenn Sitzungen funktionieren, Subagenten jedoch fehlschlagen, kann dies daran liegen, dass Subagenten Umgebungsvariablen je nach Art ihres Starts unterschiedlich übernehmen. Stellen Sie sicher, dass Ihre Umgebungsvariablen auf Systemebene gesetzt sind und nicht nur in der aktuellen Shell-Sitzung, insbesondere unter Windows, wo untergeordnete Prozesse möglicherweise keine lokalen Shell-Variablen übernehmen.

# Shell environment (add to .bashrc / .zshrc / $PROFILE)
export ANTHROPIC_BASE_URL="https://aiprimetech.io"
export ANTHROPIC_API_KEY="<your AI Prime Tech Unlimited key>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-6"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# Or per-project .env file:
# ANTHROPIC_BASE_URL=https://aiprimetech.io
# ANTHROPIC_API_KEY=sk-...
# ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-5

# Run Claude Code:
# claude            (interactive)
# claude --headless (CI/CD mode)

Häufig gestellte Fragen

AI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber.