Claude Code API ohne Abonnement
Claude Code im lokalen Terminal kann API-Abrechnung statt eines monatlichen Claude-Plans verwenden. Die Nutzung bleibt kostenpflichtig; nur Authentifizierung und Abrechnung ändern sich.
Du kannst die Claude Code API ohne Abonnement im lokalen Terminal nutzen, indem du einen API-abgerechneten Provider statt eines kostenpflichtigen Claude.ai-Plans auswählst. Anthropic unterstützt Console API, Cloud Provider und LLM-Gateways neben Pro, Max, Team und Enterprise.
Mit OmniaKey bedeutet das: Prepaid-Guthaben aufladen, API-Key erstellen und Claude Code eine Anthropic-kompatible Base URL plus Bearer Token geben. Es gibt keinen wiederkehrenden Claude-Plan, aber jede Modellanfrage kostet API-Gebühren.
Ohne Abonnement bedeutet nicht kostenlos oder unbegrenzt. Ein wiederkehrender Plan und seine inkludierten Limits werden durch gemessene API-Abrechnung ersetzt. Das API- oder Gateway-Konto muss autorisiert und finanziert sein.
Braucht Claude Code ein Abonnement?
Für den lokalen Terminal-Workflow nicht zwingend.
| Weg | Authentifizierung | Zahlung | Geeignet für |
|---|---|---|---|
| Claude Pro/Max/Team/Enterprise | Subscription OAuth über /login | Plan mit inkludierter Nutzung | Regelmäßige interaktive Nutzung und Hosted Surfaces |
| Claude Console | Console Login oder ANTHROPIC_API_KEY | Anthropic API Usage | Direkte Anthropic-Abrechnung |
| LLM-Gateway wie OmniaKey | ANTHROPIC_BASE_URL plus ANTHROPIC_AUTH_TOKEN | Gateway-Guthaben/Vertrag | Pay as you go und zentrale Usage |
| Bedrock, Google Cloud, Foundry | Cloud-Credentials | Cloud-Rechnung | Cloud-standardisierte Organisationen |
Anthropics Auth-Dokumentation priorisiert ANTHROPIC_AUTH_TOKEN vor ANTHROPIC_API_KEY und gespeicherten Subscription-Credentials. Eine korrekt konfigurierte Gateway-Session funktioniert daher unabhängig von einem Claude-Abonnement.
Dieser Artikel betrifft die lokale Claude-Code-CLI. Claude Code on the Web nutzt immer Subscription-Credentials; Umgebungs-API-Keys überschreiben diese Oberfläche nicht.
Claude Code mit OmniaKey auf Pay as you go einrichten
1. Claude Code installieren
Folge den aktuellen Claude-Code-Setup-Anweisungen und prüfe:
claude --version
Die Installation finanziert keine Modellanfragen. Das nächste Credential bestimmt Abrechnung und Berechtigung.
2. Guthaben und API-Key anlegen
Lade OmniaKey-Guthaben auf und erstelle im API-Keys-Dashboard einen Key. Nutze je Maschine oder Automation einen eigenen Key, damit du ihn einzeln widerrufen kannst.
Lege ihn nicht in Repository, Shell History, Issue oder Screenshot ab. Behandle ihn wie ein Passwort.
3. Base URL und Bearer Token setzen
macOS/Linux:
export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude
PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.omniakey.com"
$env:ANTHROPIC_AUTH_TOKEN = "your-omniakey-api-key"
claude
ANTHROPIC_AUTH_TOKEN wird als Authorization: Bearer gesendet.
Bare Host ohne /v1 verwenden. Claude Code ergänzt /v1/messages. https://api.omniakey.com/v1 erzeugt den falschen Pfad /v1/v1/messages.
Windows, Model IDs und Endpoint-Vertrag stehen im Claude-Code-API-Key-Guide. Die OmniaKey-spezifische Einrichtung erklärt Claude Code Setup.
4. Aktiven Billing-Weg prüfen
Führe in Claude Code aus:
/status
Sende eine kleine Read-only-Anfrage und prüfe, ob Usage im OmniaKey-Dashboard erscheint. Nur ANTHROPIC_BASE_URL ersetzt kein gespeichertes Subscription-Credential. Für ein Gateway brauchst du URL und Credential.
Wenn ANTHROPIC_API_KEY ebenfalls gesetzt ist, entferne es aus dieser Shell, sofern es nicht der beabsichtigte Weg ist:
unset ANTHROPIC_API_KEY
In geteilter Automation nicht blind Credentials entfernen.
Was kostet Claude Code mit API-Abrechnung?
Claude Code ist eine Agent-Schleife. Repository, Kontext, Cache, Thinking, Retries, MCP und parallele Sessions verändern die Rechnung.
Aktuelle OmniaKey-Preise vom 18. September 2026 pro Million Tokens:
| Modell | Input | Cache Hit | Output | Beispiel: 1M Input + 100K Output |
|---|---|---|---|---|
| Claude Haiku 4.5 | $0.28 | $0.028 | $1.40 | $0.42 |
| Claude Sonnet 5 | $0.84 | $0.084 | $4.20 | $1.26 |
| Claude Opus 5 | $1.40 | $0.14 | $7.00 | $2.10 |
Die Beispiele schließen Cache Writes, Long-Context-Modifikatoren, Retries und zusätzliche Tool-Turns aus. Sie sind Vergleichseinheiten, keine Prognose eines vollständigen Coding-Tasks.
Wann API-Abrechnung sinnvoll ist
- Claude Code wird gelegentlich oder in Bursts genutzt;
- Ausgaben sollen an tatsächliche Requests gebunden sein;
- mehrere Tools sollen ein Prepaid-Guthaben teilen;
- lokale Maschinen oder CI brauchen widerrufbare Keys;
- Routine soll günstig, schwierige Arbeit explizit hochgestuft werden.
Ein Plan kann besser sein, wenn du Claude Code täglich stark nutzt, Web brauchst oder Subscription-Features benötigst. Ohne eigene Messung ist keine allgemeine Preisbehauptung belastbar.
API-Ausgaben kontrollieren
Der Guide zur Token-Reduktion in Claude Code behandelt Kontext, Tool-Output, Effort und Kosten pro fertiger Aufgabe.
Mit dem passenden Modell starten
Sonnet 5 eignet sich als Balanced-Default, Haiku 4.5 für enge wiederholbare Tasks und Opus 5 bei hoher Ambiguität. Die vollständige Auswahl steht im Claude-Code-Modellguide.
Alten Kontext zwischen unabhängigen Aufgaben löschen
Lange Gespräche senden mehr Kontext. Session umbenennen, dann /clear vor einer unabhängigen Aufgabe verwenden.
Nicht verwendete Tools deaktivieren
Jede aktive Integration bringt Definitionen und Ergebnisse in den Kontext. Halte MCP fokussiert und filtere große Logs.
Fertige Arbeit statt eine Antwort bewerten
Ein günstiger Tokenpreis verliert seinen Vorteil bei wiederholter Korrektur. Miss Kosten eines gemergten Fixes, akzeptierten Reviews oder erfolgreichen Features einschließlich Retries und Human Cleanup.
Häufige Fehler
Nur ANTHROPIC_BASE_URL setzen
Die URL ändert das Ziel, nicht zwingend das Credential. Setze den passenden ANTHROPIC_AUTH_TOKEN und prüfe /status.
/v1 an die Base URL hängen
Nutze https://api.omniakey.com, nicht https://api.omniakey.com/v1. Claude Code ergänzt den Messages-Pfad.
Direct- und Gateway-Credentials mischen
ANTHROPIC_AUTH_TOKEN hat Priorität. Gib jedem Shell-Job genau einen beabsichtigten Billing-Weg.
Hosted Web mit API-Key öffnen
Claude Code on the Web nutzt Subscription-Credentials. Diese Konfiguration gilt für lokale CLI-Flows.
„Ohne Abo“ als „ohne Zahlung“ verstehen
API Billing braucht Guthaben. Nullsaldo, widerrufener Key oder Spending Limit stoppt Requests.
FAQ
Kann ich Claude Code ohne Claude Pro oder Max nutzen?
Ja. Die lokale CLI kann Console API, Cloud Provider oder LLM-Gateway nutzen, jeweils mit gültigem Credential und Guthaben.
Ist Claude-Code-API ohne Abonnement kostenlos?
Nein. Model Calls werden über API oder Gateway nach Verbrauch berechnet.
Verbraucht ein API-Key mein Claude-Abonnement?
Nicht, wenn das beabsichtigte API/Gateway-Credential aktiv ist. Prüfe /status und das Usage-Dashboard.
Funktioniert die Konfiguration in Claude Code on the Web?
Nein. Das Hosted Web nutzt Subscription-Credentials.
Welche OmniaKey-Variable brauche ich?
ANTHROPIC_AUTH_TOKEN für den Bearer Token und ANTHROPIC_BASE_URL=https://api.omniakey.com. Kein /v1 anhängen.
Geprüfte Quellen
- Anthropic: Claude Code authentication
- Anthropic: manage Claude Code costs
- Anthropic: connect Claude Code to an LLM gateway
- Anthropic: Claude API pricing
- OmniaKey Claude Code API key guide
Fakten geprüft am 18. September 2026. Authentifizierung, Modellverfügbarkeit und Preise können sich ändern; Primärquellen und Live-Katalog vor der Nutzung prüfen.
Related English references: Claude Sonnet 5 (English), Claude Haiku 4.5 (English), Claude Opus 5 (English), transparent billing (English), and model catalog (English).