Claude Code · API-Schlüssel
Claude Code API-Schlüssel: In 1 Minute erstellen und einrichten
Claude Code kann mit einem API-Schlüssel anstelle eines Claude-Plan-Logins verwendet werden. Erstelle einen Schlüssel auf aicodewith, füge zwei Umgebungsvariablen hinzu, und jede Anfrage wird pro Token von deinem Prepaid-Guthaben abgerechnet. Diese Seite erklärt, wo du den Schlüssel erhältst, wo du ihn einträgst und wie du prüfst, ob er funktioniert.
Zuletzt geprüft
API-Schlüssel vs. Anmeldung mit Abo
Claude Code bietet zwei Authentifizierungsmöglichkeiten. Mit /login nutzt es deinen Claude-Pro- oder Claude-Max-Tarif, und die Nutzung wird auf das 5-Stunden- und Wochenkontingent dieses Tarifs angerechnet. Mit einem API-Schlüssel sendet es Anfragen an den von dir konfigurierten API-Endpunkt, und du zahlst pro Token.
| Anmeldung mit Abo | API-Schlüssel (Pay-as-you-go) | |
|---|---|---|
| Wie du zahlst | Fester monatlicher Tarifpreis | Pro Token, abgezogen vom Prepaid-Guthaben |
| Grenzen | 5-Stunden-Sitzung und Wochenkontingent | Rate- und Nebenläufigkeitslimits; eigene Ausgabenobergrenzen pro Schlüssel |
| Funktioniert in CI, Skripten und gemeinsam genutzten Servern | An die Anmeldung einer Person gebunden | Ja, ein Schlüssel pro Job oder Teammitglied |
| Nutzungsverfolgung | Einstellungen > Nutzung in deinem Claude-Konto | Nutzungsdatensätze pro Schlüssel im Dashboard, plus /cost |
| Einrichtung | /login in Claude Code | Zwei Umgebungsvariablen |
Wenn ein API-Schlüssel konfiguriert ist, wird über diesen Schlüssel abgerechnet und das Kontingent deines Claude-Tarifs wird nicht verbraucht. Entferne die Variablen und führe /login aus, um zurückzuwechseln.
Wo du einen Schlüssel bekommst und wie du Guthaben auflädst
1. Registrieren
Erstelle ein Konto auf aicodewith.ai mit E-Mail, Google oder GitHub.
2. Lade dein Guthaben auf
Die Abrechnung erfolgt im Voraus (Prepaid). Internationale Konten zahlen in USD per Karte über Stripe; Konten in Festlandchina zahlen in CNY über Alipay. Die Abrechnungsregion wird bei der ersten Aufladung gewählt, der Mindestbetrag wird an der Kasse angezeigt.
3. Schlüssel erstellen
Öffne im Dashboard API Keys und erstelle einen Schlüssel. Optional kannst du eine tägliche, monatliche oder gesamte Ausgabenobergrenze festlegen. Kopiere den Schlüssel; du fügst ihn als Nächstes in Claude Code ein.
Dein Guthaben wird pro Token zum Preis des von dir verwendeten Modells und Kanals berechnet. Credits sind ein Jahr gültig, und nicht genutztes Guthaben kann innerhalb von 90 Tagen nach der Aufladung erstattet werden; dabei wird eine Gebühr von 10 % erhoben.
Optionen zum AufladenFAQ zu Zahlungen und ErstattungenErstattungsrichtlinie
| Model (USD per 1M tokens) | Anthropic list price, input / output | Cache read / 5-min cache write (list) | aicodewith Economy channel, input / output |
|---|---|---|---|
| Claude Opus 5.5 | $4.00 / $20.00 | $0.20 / $5.00 | from $0.76 / from $3.80 |
| Claude Sonnet 5.5 | $2.00 / $10.00 | $0.10 / $2.50 | from $0.38 / from $1.90 |
| Claude Haiku 5.5 | $0.10 / $0.50 | $0.01 / $0.125 | from $0.019 / from $0.095 |
"From" prices are based on the Economy channel, the lowest-priced Claude channel currently listed (about 19% of Anthropic list price). Other channels cost more; the rate depends on the channel you choose, and the models page is always the source of truth.
Wohin mit dem Schlüssel
Wähle einen Ort. settings.json ist am zuverlässigsten, weil die Claude Code CLI und ihre IDE-Erweiterungen diese Datei lesen. Shell-Variablen sind praktisch für einen schnellen Test oder einen CI-Job.
1. Option A: ~/.claude/settings.json (empfohlen)
macOS und Linux: ~/.claude/settings.json. Windows: %USERPROFILE%\.claude\settings.json. Erstelle die Datei, falls sie nicht existiert, und füge den env-Block ein, falls sie existiert.
~/.claude/settings.json{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_API_KEY": "", "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai" } }2. Überspringe den Anmeldebildschirm beim ersten Start
Füge bei einer frischen Installation dieses Feld zu ~/.claude.json hinzu, damit Claude Code dich nicht zur Anmeldung mit einem Anthropic-Konto auffordert. Wenn die Datei existiert, füge das Feld hinzu, statt sie zu überschreiben.
~/.claude.json{ "hasCompletedOnboarding": true }3. Option B: Shell-Umgebungsvariablen
Füge diese Zeilen zu ~/.zshrc oder ~/.bashrc hinzu (oder exportiere sie in einem CI-Schritt) und öffne dann ein neues Terminal.
bash / zshexport ANTHROPIC_BASE_URL="https://api.aicodewith.ai" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_API_KEY=""4. Option B unter Windows (PowerShell)
Setzt Variablen auf Benutzerebene. Öffne danach ein neues Terminal.
PowerShell[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.aicodewith.ai", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")
ANTHROPIC_BASE_URL ist die reine Domain https://api.aicodewith.ai. Füge kein /v1 hinzu; Claude Code hängt den Pfad selbst an, und /v1 führt zu 404-Fehlern.
ANTHROPIC_AUTH_TOKEN oder ANTHROPIC_API_KEY?
| Variable | Was Claude Code damit macht | Für aicodewith |
|---|---|---|
| ANTHROPIC_AUTH_TOKEN | Sendet den Wert als Authorization: Bearer <key> | Füge hier deinen aicodewith-Schlüssel ein |
| ANTHROPIC_API_KEY | Sendet den Wert als x-api-key-Header; gedacht für Schlüssel der Anthropic Console | Leer lassen |
| ANTHROPIC_BASE_URL | Wohin Anfragen gehen | https://api.aicodewith.ai |
Es ist wichtig, ANTHROPIC_API_KEY auf eine leere Zeichenkette zu setzen: Wenn in deiner Shell noch ein alter Anthropic-Schlüssel exportiert ist, kann dieser anstelle deines aicodewith-Schlüssels gesendet werden, und die Anfrage schlägt mit 401 fehl.
Prüfen, ob es funktioniert, und was Fehler bedeuten
- Schließe jede Claude Code-Sitzung und führe claude erneut aus.
- Führe /status aus und bestätige, dass der API-Endpunkt api.aicodewith.ai anzeigt.
- Sende eine kurze Nachricht. Die Anfrage und ihre Kosten erscheinen in den Nutzungsdatensätzen des Dashboards.
- Führe /cost aus, um die Kosten pro Token der Sitzung zu sehen.
| Was du siehst | Wahrscheinliche Ursache | Behebung |
|---|---|---|
| 401 / ungültiger API-Schlüssel | Schlüssel falsch eingegeben oder gelöscht, oder ein alter ANTHROPIC_API_KEY wird stattdessen gesendet | Kopiere den Schlüssel erneut, setze ANTHROPIC_API_KEY auf leer und führe echo $ANTHROPIC_API_KEY aus, um zu prüfen |
| 404 Not Found | Basis-URL endet auf /v1 oder enthält einen Tippfehler | Verwende exakt https://api.aicodewith.ai und starte dann neu |
| Claude Code fordert weiterhin zur Anmeldung auf oder zeigt die Limitmeldung deines Tarifs | Konfiguration nicht geladen; Claude Code verwendet noch die Abo-Anmeldung | Prüfe den Pfad von settings.json und dass das JSON gültig ist, starte neu, führe /status aus |
| Nicht genug Guthaben | Prepaid-Guthaben oder die Ausgabenobergrenze des Schlüssels ist aufgebraucht | Lade Guthaben auf oder erhöhe die Obergrenze; es wird nichts automatisch abgebucht |
| 429 / Rate-Limit erreicht | Anfragenrate oder Nebenläufigkeit liegt über dem Rate-Limit | Führe weniger parallele Subagenten aus und versuche es nach einem Moment erneut |
Ein Schlüssel für mehrere Projekte und Maschinen
Ein Schlüssel ist weder an ein Gerät noch an ein Projekt gebunden. Verwende denselben Schlüssel auf deinem Laptop, einem Dev-Server und in CI, oder erstelle einen Schlüssel pro Projekt, Teammitglied oder Pipeline. Getrennte Schlüssel ergeben getrennte Nutzungsdatensätze und getrennte Ausgabenobergrenzen, und du kannst einen löschen, ohne die anderen zu beeinflussen.
- Tägliche, monatliche oder gesamte Ausgabenobergrenzen pro Schlüssel verhindern, dass eine außer Kontrolle geratene Agent-Schleife das Guthaben aufbraucht.
- Nutzungsdatensätze zeigen jede Anfrage mit Modell, Tokens und Kosten.
- Behandle Schlüssel wie Passwörter: halte sie aus git heraus und rotiere einen Schlüssel, wenn er bekannt wird.
Nächste Schritte
Claude Code ohne Abo nutzenAlternative zu Claude Max: pro Token zahlenNutzungslimits von Claude Code erklärtIntegrationsanleitung für Claude CodeDokumentation
FAQ
Kann ich Claude Code mit einem API-Schlüssel statt mit einem Abonnement nutzen?
Ja. Setzen Sie ANTHROPIC_BASE_URL auf https://api.aicodewith.ai und ANTHROPIC_AUTH_TOKEN auf Ihren Schlüssel. Claude Code rechnet dann pro Token von Ihrem Prepaid-Guthaben ab, anstatt ein Claude-Plan-Kontingent zu nutzen.
Soll ich ANTHROPIC_AUTH_TOKEN oder ANTHROPIC_API_KEY verwenden?
Verwenden Sie ANTHROPIC_AUTH_TOKEN für Ihren aicodewith-Schlüssel und lassen Sie ANTHROPIC_API_KEY leer, damit kein übrig gebliebener Anthropic-Schlüssel in Ihrer Shell stattdessen gesendet wird.
Muss die Basis-URL /v1 enthalten?
Nein. Verwenden Sie nur https://api.aicodewith.ai. Claude Code fügt den Pfad selbst hinzu, und /v1 führt zu 404-Fehlern.
Woher weiß ich, dass Claude Code meinen Schlüssel verwendet?
Führen Sie /status aus und prüfen Sie, dass der Endpunkt api.aicodewith.ai ist. Senden Sie dann eine Nachricht und suchen Sie in den Nutzungsaufzeichnungen Ihres Dashboards danach. /cost zeigt die Sitzungskosten.
Kann ich einen Schlüssel auf mehreren Computern verwenden?
Ja. Ein Schlüssel funktioniert überall. Erstellen Sie zusätzliche Schlüssel, wenn Sie getrennte Nutzungsaufzeichnungen oder Ausgabenobergrenzen pro Projekt, Teammitglied oder CI-Job wünschen.
Gibt es ein Rate-Limit?
Ja. Es gelten Rate-Limits und Parallelitätslimits; Anfragen darüber erhalten eine 429-Antwort. Sie können außerdem für jeden Schlüssel ein eigenes Tages-, Monats- oder Gesamtausgabenlimit festlegen.
Wie bezahle ich, und kann ich eine Rückerstattung erhalten?
Internationale Konten zahlen per Karte in USD über Stripe; Konten in Festlandchina zahlen in CNY über Alipay. Unverbrauchtes Guthaben kann innerhalb von 90 Tagen nach der Aufladung erstattet werden; es fällt eine Gebühr von 10 % an.
Ist aicodewith mit Anthropic verbunden?
Nein. aicodewith ist eine unabhängige API-Plattform. Claude und Claude Code sind Marken von Anthropic.
Bereit zum Ausprobieren?
Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben. Es gelten Limits für Rate und Parallelität, und du kannst für jeden API-Schlüssel tägliche, monatliche oder gesamte Ausgabenlimits festlegen.
Ähnliche Themen
Quellen
- Dokumentation zu Claude Code: Einstellungen
- Dokumentation zu Claude Code: Kosten
- Dokumentation zu Claude Code: Fehler
Claude und Claude Code sind Marken von Anthropic PBC. aicodewith ist eine unabhängige Plattform und weder mit Anthropic verbunden noch von Anthropic unterstützt. Die Preise stammen aus Live-Preisdaten; Listenpreise sind die Listenpreise von Anthropic. Geprüft: 2026-10-10.