Claude Code mit API-Key statt Abo nutzen

Welche Zugangsdaten verwendet Ihre Claude-Code-Sitzung?

Eine Claude-Code-Anmeldung funktioniert auf eine von zwei Arten. Sie melden sich mit einem Claude-Abonnementkonto von claude.ai an oder authentifizieren sich gegenüber einer Anthropic-Console-Organisation. In diesem Fall wird Ihre Token-Nutzung dieser API-Organisation (Application Programming Interface) berechnet und nicht Ihrem Tarif. Führen Sie in einer laufenden Sitzung /status aus, um die aktive Methode anzuzeigen: Auf der Registerkarte „Status“ enthält die Ausgabe eine Zeile Login method für das Konto, mit dem Sie sich angemeldet haben. Wenn stattdessen ein API-Schlüssel die Zugangsdaten liefert, erscheint zusätzlich eine Zeile API key.

Ob das Tool überhaupt durch Ihren Tarif abgedeckt ist, ist eine separate Frage. Die Antwort finden Sie unter ob Claude Code in einem Claude-Pro-Abonnement enthalten ist. Die Funktionsweise von Schlüsseln für die Claude API wird unter wie die Authentifizierung der Claude API funktioniert erläutert. Im Folgenden geht es um den Teil, den diese beiden Themen nicht abdecken: Welche Zugangsdaten eine Sitzung tatsächlich verwendet und wie Sie diese ändern.

Das folgende Verhalten basiert auf der Dokumentation zur Claude-Code-Authentifizierung von Anthropic, die am 10. Oktober 2026 gelesen wurde. Claude Code wird häufig aktualisiert, und mehrere dieser Verhaltensweisen setzen eine Mindestversion voraus. Führen Sie daher claude --version aus, bevor Sie von einem Fehler auf Ihrem Rechner ausgehen.

Zwei Konten können dieselbe E-Mail-Adresse verwenden

Ein claude.ai-Konto und ein Claude-Console-Konto auf platform.claude.com sind unterschiedliche Konten. Sie können dieselbe E-Mail-Adresse verwenden und trotzdem getrennte Anmeldungen mit separaten Guthaben in unterschiedlichen Organisationen bleiben. Durch das Erstellen des einen Kontos wird das andere nicht erstellt. Wenn Sie das Guthaben einer Console-Organisation aufladen, wird Ihrem Tarif kein Guthaben hinzugefügt.

Für die umgekehrte Richtung gibt es eine Ausnahme, die am 10. Oktober 2026 geprüft wurde. Die Tarife Max 5x und Max 20x enthalten jetzt monatliche API-Guthaben in Höhe von $100 beziehungsweise $200 pro Monat. Team-Tarife erhalten einen gemeinsamen Guthabenbetrag. Dieses Guthaben wird erst dann einer Console-Organisation gutgeschrieben, wenn Sie in den Abrechnungseinstellungen auf claude.ai eine Organisation verknüpfen. Es gilt nicht für Claude Code. In der Plattformdokumentation von Anthropic ist Claude Code ausdrücklich ausgeschlossen. Das Hilfezentrum nimmt nur claude -p-Ausführungen aus, die einen API-Schlüssel der verknüpften Organisation verwenden. Eine interaktive Sitzung, die einer Organisation mit ausschließlich diesem Guthaben belastet werden soll, schlägt daher mit Credit balance too low fehl.

Die Guthaben unterscheiden sich, weil die Abrechnungsmodelle unterschiedlich sind. Eine Anmeldung mit Abonnement verwendet das Nutzungskontingent Ihres Tarifs. Dieses wird in einem rollierenden Zeitfenster von fünf Stunden und einem wöchentlichen Zeitfenster zurückgesetzt. Das Kontingent wird mit Claude im Web geteilt. Ein Console-Zugang wird pro Token der Organisation in Rechnung gestellt. Die maßgeblichen Werte finden Sie auf der Console-Nutzungsseite. Welche Kosten dieser Unterschied bei der tatsächlichen Arbeit verursacht, wird unter Abrechnung pro Token im Vergleich zur Abrechnung per Abonnement behandelt.

Ein Kontotyp kann den Weg über ein Abonnement überhaupt nicht verwenden. Anthropic führt als mögliche Anmeldungen ein Pro- oder Max-Abonnement, einen Claude-for-Teams- oder Enterprise-Sitz, ein Claude-Console-Konto, einen Cloud-Anbieter sowie ein Cloud-Gateway auf. Gemeint ist damit ein selbst gehostetes Claude-Apps-Gateway, das von Ihrer Organisation betrieben wird und bei dem Sie sich über /login mit dem Unternehmens-SSO (Single Sign-on) anmelden. Ein kostenloses claude.ai-Konto steht nicht auf dieser Liste. Nutzer des kostenlosen Tarifs verfügen daher über keine Anmeldedaten für ein Abonnement. Auch was die kostenlose Claude-Stufe umfasst und was nicht gilt nicht für das Befehlszeilentool. Der verbleibende Weg ist eine Console-Organisation mit API-Guthaben. Dabei handelt es sich um ein kostenpflichtiges Konto mit einem anderen Modell.

Pfad eins: Anmeldung mit Ihrem Claude-Abonnement

Führen Sie claude in einem Projektverzeichnis aus. Beim ersten Start öffnet sich ein Browserfenster, in dem Sie sich mit dem claude.ai-Konto anmelden können, das Ihren Plan enthält.

claude

Auf einem Server verhalten sich zwei Dinge anders. Wenn sich der Browser nicht öffnet, drücken Sie c, um die Anmelde-URL in Ihre Zwischenablage zu kopieren, und fügen Sie diese in einen Browser auf Ihrem lokalen Rechner ein. Wenn dieser Browser daraufhin einen Anmeldecode anzeigt, anstatt Sie zum Terminal zurückzuführen, fügen Sie den Code bei der entsprechenden Aufforderung ein. Dieser zweite Fall ist bei SSH (Secure Shell), in WSL2 und innerhalb von Containern normal, da der Browser den lokalen Callback-Server, den Claude Code auf der Remote-Maschine gestartet hat, nicht erreichen kann.

Überprüfen Sie die Anmeldung nach Abschluss, anstatt sie vorauszusetzen. Starten Sie eine Sitzung und führen Sie /status aus. Der Status-Tab nennt die Anmeldemethode sowie die Organisation und die E-Mail-Adresse, die gespeichert wurden. /login führt den Ablauf erneut für ein anderes Konto aus, und /logout entfernt die gespeicherten Anmeldedaten. Das Abmelden setzt auch den Einrichtungsstatus des ersten Starts zurück, sodass das nächste claude Sie erneut durch das Onboarding führt.

Es ist wichtig zu wissen, wo diese Anmeldedaten abgelegt werden, wenn Sie einen Rechner neu aufsetzen oder übergeben:

• Linux: ~/.claude/.credentials.json, Dateimodus 0600.
• macOS: der verschlüsselte Keychain. Wenn der Keychain den Schreibvorgang verweigert, was passiert, wenn er in einer SSH-Sitzung gesperrt ist, greift Claude Code auf dieselbe 0600-Datei zurück. Eine Konsolenanmeldung, die einen API-Key erstellt, nutzt diesen Fallback nicht und schlägt fehl, bis der Keychain beschreibbar ist.
• Windows: %USERPROFILE%\.claude\.credentials.json, beschränkt auf Ihren Benutzer durch die Zugriffskontrollen des Profilverzeichnisses.
• Jede Plattform mit gesetztem CLAUDE_CONFIG_DIR: Die Datei wird in dieses Verzeichnis verschoben, und der macOS-Keychain-Eintrag wird darauf referenziert, sodass eine Sitzung, die mit einem anderen CLAUDE_CONFIG_DIR gestartet wurde, andere Anmeldedaten liest.

Claude Code verwaltet diese Datei über /login und /logout. Das manuelle Bearbeiten der Datei ist keine unterstützte Methode, um zwischen Konten zu wechseln.

Pfad zwei: Authentifizierung gegenüber einer Console-Organisation

Der Zugriff auf die Console beginnt bei einem Administrator. Dieser lädt Sie über die Console unter Settings, dann Members und schließlich Invite ein. Zudem wird eine Rolle zugewiesen: Die Rolle Claude Code erlaubt nur das Erstellen von Claude Code API-Keys, während die Rolle Developer das Erstellen beliebiger Keys ermöglicht. Sie wählen anschließend das Anthropic Console-Konto an der /login-Eingabeaufforderung aus.

Ab Claude Code v2.1.242 gibt es zwei Console-Routen, die unterschiedliche Daten speichern. Die Anmeldung mit Ihrem Console-Konto behält das OAuth-Token (Open Authorisation) dieser Browser-Anmeldung bei und speichert es als Anthropic-Profil, ohne dabei einen API-Key zu erstellen. Claude Code aktualisiert diese Anmeldung selbstständig; schlägt die Aktualisierung fehl, schlagen Anfragen fehl, bis Sie sich erneut anmelden. Diese schlüssellose Anmeldung meldet Sie auch von allen auf dem Rechner gespeicherten claude.ai-Anmeldungen ab. Das Erstellen eines API-Keys, den die Eingabeaufforderung als Legacy bezeichnet, generiert einen Console-Key und speichert ihn zusammen mit Ihren anderen Zugangsdaten. Ein statischer Key muss nie aktualisiert werden und funktioniert daher, bis er widerrufen wird. Dies ist auf einem Build-Server nützlich, stellt jedoch auf einem Laptop ein Sicherheitsrisiko dar.

Heben Sie die Einstellung von ANTHROPIC_API_KEY auf, bevor Sie eine schlüssellose Console-Anmeldung starten. Ist diese Variable gesetzt, überspringt Claude Code die Anmeldeaufforderung vollständig und bittet Sie stattdessen, den gefundenen Key zu bestätigen.

Sie haben nicht immer die Wahl. Claude Code erstellt automatisch einen Key, wenn die Sitzung bei einem Cloud-Anbieter läuft, wenn eine Konfigurationsdatei forceLoginOrgUUID setzt oder forceLoginMethod auf "claudeai" oder "console" festlegt, oder wenn eine verwaltete Konfigurationsquelle auf dem Rechner existiert, die Claude Code nicht lesen kann. Dies sind administrative Entscheidungen. Wenn die schlüssellose Option für Sie nicht erscheint, wenden Sie sich an die für die Verwaltung zuständige Person. /status gibt zudem eine Setting sources-Zeile aus, die jede geladene Konfigurationsdatei der Sitzung auflistet und die verwaltete Quelle benennt, falls eine solche auf Sie zutrifft.

Wenn Sie Claude Code zum ersten Mal gegenüber einer Console-Organisation authentifizieren, erstellt die Console einen Arbeitsbereich namens "Claude Code" dafür. Dieser Arbeitsbereich dient dazu, die Ausgaben von Claude Code zentral zu erfassen; innerhalb dieses Bereichs können Sie keine API-Keys erstellen.

Warum ANTHROPIC_API_KEY nach der Anmeldung Vorrang hat

Claude Code fragt nicht nach, welche Anmeldedaten Sie bevorzugen. Das Tool prüft die Quellen in einer festen Reihenfolge und verwendet die erste gefundene. Wie im Oktober 2026 dokumentiert, lautet diese Reihenfolge:

1. Cloud-Provider-Anmeldedaten, wenn CLAUDE_CODE_USE_BEDROCK, CLAUDE_CODE_USE_VERTEX oder CLAUDE_CODE_USE_FOUNDRY gesetzt ist.
2. ANTHROPIC_AUTH_TOKEN, gesendet als Authorization: Bearer-Header, für Gateways, die sich mit Bearer-Tokens authentifizieren.
3. ANTHROPIC_API_KEY, gesendet als X-Api-Key-Header.
4. Die Ausgabe eines apiKeyHelper-Skripts, das in einer Einstellungsdatei definiert ist.
5. CLAUDE_CODE_OAUTH_TOKEN, das langlebige Token aus claude setup-token.
6. Anthropic-Profil- und Föderations-Anmeldedaten, also die Anmeldedaten, die das ant-CLI und Workload Identity Federation verwenden.
7. Die Abonnement-Anmeldedaten, die von /login geschrieben wurden.

Für diese Liste gibt es zwei Ausnahmen. Ein Profil steht an Position 6, wenn Sie es in ANTHROPIC_PROFILE benennen, wenn die Föderationsvariablen gesetzt sind oder wenn das aktive Profil ein Workload-Identity-Federation-Profil ist. Ein aktives Profil im user_oauth-Modus, wie es ant auth login oder eine schlüssellose Konsolenanmeldung schreibt, rangiert hingegen unterhalb eines funktionierenden /login-Anmeldedatensatzes. Eine angemeldete Claude-Apps-Gateway-Sitzung steht außerhalb dieser Liste: Sie hat Vorrang vor allem anderen, einschließlich der Cloud-Provider-Variablen. Wenn die verwalteten Einstellungen eines Administrators die Gateway-Anmeldung erfordern, überspringt Claude Code die anderen Quellen und fordert Sie auf, sich über /login anzumelden.

Keine dieser Ausnahmen schützt Ihr Abonnement vor einem exportierten Schlüssel. Ohne Gateway hat alles von Position 1 bis 5 Vorrang vor dem Konto, mit dem Sie sich angemeldet haben. Daher gewinnt ein überall in der Prozessumgebung exportiertes ANTHROPIC_API_KEY, und die Sitzung wird einer Konsolenorganisation in Rechnung gestellt, während Sie davon ausgehen, dass Ihr Plan belastet wird. Es liegt kein Fehler vor. Die Reihenfolge arbeitet wie dokumentiert, weshalb keine Warnung ausgegeben wird.

Zwei Details führen dazu, dass dies leicht übersehen wird. In einer interaktiven Sitzung fragt Claude Code einmalig, ob der gefundene Schlüssel verwendet werden soll, und merkt sich Ihre Antwort; eine Entscheidung von vor einem Monat gilt also auch heute noch. Im nicht-interaktiven Modus mit -p gibt es keine Abfrage, und der Schlüssel wird bei Vorhandensein immer verwendet. -p ist der Modus, in dem ein Cron-Job oder ein CI-Schritt (Continuous Integration) ausgeführt wird; ein unbeaufsichtigter Job ist also genau der Ort, an dem die falschen Anmeldedaten am längsten unbemerkt bleiben.

Es gibt eine schnelle visuelle Überprüfung innerhalb der Sitzung. Solange ANTHROPIC_API_KEY gesetzt ist, zeigt /config einen Schalter für "Use custom API key" an. Dieser Schalter existiert nur, solange die Variable gesetzt ist; sein Fehlen bedeutet also, dass die Umgebung sauber ist.

Auffinden eines verwaisten Schlüssels auf einem Server

Ein exportierter Schlüssel existiert an mehr Stellen als nur in einem Shell-Profil:

• ~/.bashrc, ~/.bash_profile, ~/.profile oder ~/.zshrc, die bei jeder neuen Login-Shell eingelesen werden.
• Eine systemd-Unit, über Environment= oder EnvironmentFile=, für jeden Dienst, den Sie ausführen.
• Der tmux-Server, der eine Kopie der Umgebung behält, mit der er gestartet wurde. Ein heute geöffnetes Fenster kann eine Variable erben, die Sie letzte Woche aus Ihrem Profil gelöscht haben, da der Server seit dem Zeitpunkt vor der Bearbeitung läuft.
• Ein Container-Image oder eine CI-Job-Definition, bei denen die Variable außerhalb jeder Datei gesetzt ist, die Sie innerhalb der Shell lesen können.
• Der env-Block einer Konfigurationsdatei von Claude Code, der ein gewöhnlicher Einstellungsschlüssel ist und der normalen Rangfolge für Einstellungen folgt.

Überprüfen Sie diese Stellen, bevor Sie weitere Schritte unternehmen:

[ -n "$ANTHROPIC_API_KEY" ] && echo "ANTHROPIC_API_KEY is set" || echo "not set"
env | grep -E '^(ANTHROPIC_|CLAUDE_CODE_)' | cut -d= -f1
grep -n 'ANTHROPIC_API_KEY' ~/.bashrc ~/.bash_profile ~/.profile ~/.zshrc 2>/dev/null
tmux show-environment 2>/dev/null | grep ANTHROPIC
grep -n 'ANTHROPIC_API_KEY\|apiKeyHelper' ~/.claude/settings.json .claude/settings.json .claude/settings.local.json 2>/dev/null

Der zweite Befehl leitet die Ausgabe absichtlich durch cut, damit nur die Variablennamen gedruckt werden, ohne die geheimen Werte auf einem Bildschirm anzuzeigen, den Sie möglicherweise teilen oder aufzeichnen. Der erste Befehl klärt die Frage: Wenn er anzeigt, dass die Variable gesetzt ist, verwendet jede weitere claude, die Sie von dieser Shell aus starten, diesen Schlüssel. Wenn alle fünf Befehle keine Ausgabe liefern, existiert keine Umgebungskennung, sodass eine hier gestartete Sitzung auf Ihre /login-Kennung zurückgreift.

Fügen Sie systemctl cat your-unit.service | grep -i environment für jeden Dienst hinzu, der Claude Code ausführt, da eine Unit-Datei ihre eigene Umgebung festlegt und niemals Ihr Shell-Profil einliest.

Wechseln einer Sitzung von einem Anmeldeinformationssatz zum anderen

Um zu Ihrem Abonnement zurückzukehren:

unset ANTHROPIC_API_KEY
[ -n "$ANTHROPIC_API_KEY" ] && echo "still set" || echo "clear"
claude

Erwarten Sie clear und führen Sie anschließend /status in der neuen Sitzung aus. Bestätigen Sie, dass die Zeile API key verschwunden ist. Das Aufheben der Variable in Ihrer Shell hat keine Auswirkungen auf einen bereits laufenden Claude Code-Prozess, da ein Prozess die Umgebung beibehält, mit der er gestartet wurde. Starten Sie die Sitzung neu.

Löschen Sie anschließend den export-Befehl aus der Datei, in der er gesetzt wurde, da er sonst bei der nächsten Anmeldung erneut geladen wird. Innerhalb von tmux löscht tmux set-environment -u ANTHROPIC_API_KEY die Variable für Fenster, die nach diesem Zeitpunkt in der Sitzung geöffnet werden, während bereits geöffnete Fenster ihre eigene Kopie behalten.

Um in die andere Richtung zu wechseln, setzen Sie ANTHROPIC_API_KEY in der Umgebung oder führen Sie /login aus und wählen Sie das Console-Konto aus. Um eine gespeicherte Anmeldung vollständig zu löschen, führen Sie /logout aus. Nach einer schlüssellosen Console-Anmeldung entfernt und widerruft /logout die Anmeldeinformationen, die durch diese Anmeldung erstellt wurden.

Wenn /status weiterhin nicht Ihren Erwartungen entspricht, führen Sie claude doctor aus. Dies listet die Einstellungs-Einträge auf, die von Claude Code abgelehnt wurden. Dies hilft dabei, Einstellungsdateien zu identifizieren, die aufgrund von Parsing-Fehlern nicht angewendet wurden.

Authentifizierung ohne Browser

claude setup-token öffnet denselben Browser-Autorisierungsablauf wie /login und gibt ein einjähriges OAuth-Token im Terminal aus.

claude setup-token

Das Token wird nirgendwo gespeichert; kopieren Sie es daher, sobald es erscheint. Setzen Sie es auf dem Zielrechner als CLAUDE_CODE_OAUTH_TOKEN. Das Token authentifiziert sich gegenüber Ihrem Abonnement und erfordert daher einen Pro-, Max-, Team- oder Enterprise-Plan; es kann ausschließlich Modellanfragen durchführen. Der Bare-Modus liest dieses Token nicht aus, daher benötigt ein Skript, das --bare übergibt, stattdessen ANTHROPIC_API_KEY oder eine apiKeyHelper.

Auch hier spielt die Rangfolge eine Rolle. Wenn CLAUDE_CODE_OAUTH_TOKEN in einem Shell-Profil definiert ist, schaltet die Ausführung von /login die aktuelle Sitzung auf den neuen Login um. Jede neue Sitzung liest die Variable erneut, bis Sie diese entfernen.

Falls Ihr Unternehmen Inferenz über Amazon Bedrock, Google Cloud oder Microsoft Foundry betreibt, stehen diese Anmeldedaten in der Rangfolge ganz oben und es findet kein Browser-Login statt. Die Einrichtung ist eine separate Aufgabe, die unter Claude Code mit Bedrock oder Vertex ausführen beschrieben wird.

Langlebige Sitzungen auf einem VPS (Virtual Private Server) sind der Ort, an dem sich diese Probleme konzentrieren, da die Shell, die den Prozess gestartet hat, möglicherweise vor Monaten konfiguriert und seitdem nie neu gestartet wurde. Claude Code auf einem VPS innerhalb von tmux ausführen behandelt die Sitzungsseite dieser Konfiguration.

Prüfen, was die einzelnen Zugangsdaten tatsächlich verbraucht haben

Bei einer Anmeldung mit einem Abonnement zeigt /usage die Nutzungsbalken Ihres Tarifs und eine Aufschlüsselung der Verbrauchsanteile an. Der Dollarbetrag im Abschnitt Session wird lokal anhand der Tokenanzahl zum Listenpreis berechnet. Wenn ein Administrator in den verwalteten Einstellungen eine modelPricing-Tabelle hinterlegt hat, werden stattdessen die vertraglich vereinbarten Preise Ihrer Organisation verwendet. In diesem Fall weist die Zeile Total cost darauf hin. Betrachten Sie den Betrag in jedem Fall als Schätzung für API-Nutzer und nicht als Rechnung. Abonnenten sollten sich an den Balken und nicht an den Dollarbeträgen orientieren.

Bei einer Console-Zugangsberechtigung sind die relevanten Zahlen in der Console zu finden: Die Nutzungsseite zeigt die Ausgaben, das Claude Code-Dashboard die Werte pro Mitglied. Für diese Abrechnung ist keine Ausgabe in Ihrem Terminal maßgeblich.

Wenn sich die Planbalken während Ihrer Arbeit nie bewegen, wird wahrscheinlich eine Umgebungs-Zugangsberechtigung in der Reihenfolge bevorzugt. /status schafft hier Klarheit. Eine Ausnahme sind bereits vollständig gefüllte Balken: Eine Sitzung mit einem Abonnement kann die enthaltene Nutzungsgrenze bei den Nutzungsguthaben überschreiten. Anthropic rechnet die zusätzliche Nutzung zu den Standardpreisen der API ab, während die Balken unverändert bleiben. Außerhalb dieses Falls sind unveränderte Balken das deutlichste Zeichen dafür, dass die falsche Zugangsberechtigung verwendet wird. Ermitteln, was eine Claude-Code-Sitzung verbraucht beschreibt die Messung genauer. Wenn sich die Balken bewegen und dann stehen bleiben, haben Sie stattdessen eine Tarifgrenze erreicht. Wie Claude-Nutzungslimits und Rücksetzungszeiträume funktionieren erläutert dieses Verhalten.

Fehlerfälle und worauf Sie achten sollten

Alles funktioniert, aber der Verbrauch Ihres Plans ändert sich nicht. In der Regel ist eine Umgebungsanmeldeinformation aktiv: /status zeigt eine Zeile mit API key, und die Shell-Prüfung oben zeigt die Variable. Wenn beides nicht der Fall ist und die Balken ihr Limit erreicht haben, verwendet die Sitzung Verbrauchsguthaben. Diese werden zu den Standardpreisen der API abgerechnet. Die Kosten finden Sie auf claude.ai unter Settings und anschließend Usage.

Anfragen schlagen fehl, obwohl Ihr Abonnement aktiv ist. Ein Schlüssel einer deaktivierten oder abgelaufenen Console-Organisation hat Vorrang vor Ihrer Anmeldung. Führen Sie unset ANTHROPIC_API_KEY aus, starten Sie eine neue Sitzung und prüfen Sie /status erneut. Wenn der Fehler einen ungültigen API-Schlüssel nennt, beschreibt den Fehler mit dem ungültigen API-Schlüssel in Claude Code beheben diesen Fall ausführlich. Dort wird auch erklärt, warum eine erneute Ausführung von /login das Problem nicht behebt.

Beim Start erscheint eine Warnung, dass Ihre Anmeldung bald abläuft. Aktuelle Versionen warnen, wenn eine /login-Anmeldeinformation innerhalb von drei Tagen abläuft. Nach dem tatsächlichen Ablauf zeigt /status die Anmeldezeile als abgelaufen an. Dabei werden die gespeicherte Organisation und E-Mail-Adresse angezeigt. Führen Sie /login aus, um die Anmeldung zu verlängern. Die Warnung blockiert keine Anfrage. Deshalb wird sie leicht ignoriert, bis eine unbeaufsichtigte Sitzung keine Fortschritte mehr macht.

Ein apiKeyHelper ist langsam oder schlägt fehl. Claude Code führt das Hilfsprogramm standardmäßig alle fünf Minuten erneut aus. Mit CLAUDE_CODE_API_KEY_HELPER_TTL_MS lässt sich dieses Intervall anpassen. Wenn eine Ausführung länger als zehn Sekunden dauert, zeigt Claude Code einen Hinweis in der Eingabeaufforderungsleiste an. Wenn das Hilfsprogramm keinen Schlüssel zurückgibt, weil ein Fehler aufgetreten ist oder eine Zeitüberschreitung eingetreten ist, schlagen Anfragen innerhalb von drei Versuchen fehl.

Die richtige Anmeldeinformation, aber die falsche Organisation. Eine E-Mail-Adresse kann zu zwei Organisationen gehören. /status nennt die Organisation, bei der die Authentifizierung erfolgt ist. Lesen Sie daher diese Zeile, statt anzunehmen, in welcher Organisation Sie gelandet sind.

FAQ

Woran erkenne ich, welches Konto Claude Code derzeit verwendet?

Führen Sie /status in der Sitzung aus. Auf der Registerkarte Status zeigt eine Zeile Login method das Konto, mit dem Sie sich angemeldet haben. Wenn ein API-Schlüssel als Anmeldedaten verwendet wird, wird zusätzlich eine Zeile API key angezeigt. Wenn stattdessen ein Anthropic-Profil oder eine Federation-Anmeldedaten ausgewählt ist, ersetzt eine Zeile Profile die Anmeldezeile. Außerhalb der Sitzung zeigt die Prüfung, ob ANTHROPIC_API_KEY in Ihrer Shell gesetzt ist, ob Anmeldedaten aus der Umgebung vorhanden sind, die Vorrang vor Ihrer Anmeldung haben.

Warum wird mein Claude Pro- oder Max-Abonnement ignoriert?

Weil Anmeldedaten aus der Umgebung Vorrang haben. Claude Code verwendet die ersten Anmeldedaten, die es in einer festen Reihenfolge findet. Die Abonnement-Anmeldedaten /login stehen unter den Cloud-Provider-Variablen, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY, apiKeyHelper, CLAUDE_CODE_OAUTH_TOKEN sowie allen Anthropic-Profilen oder Federation-Anmeldedaten, die Sie mit ANTHROPIC_PROFILE oder den Federation-Variablen auswählen. Nur ein aktives Profil im Modus user_oauth hat eine niedrigere Priorität. Eine angemeldete Claude apps gateway-Sitzung hat Vorrang vor der gesamten Liste. Führen Sie unset ANTHROPIC_API_KEY aus, starten Sie eine neue Sitzung und prüfen Sie das Ergebnis mit /status. Entfernen Sie anschließend den Export aus dem Shell-Profil, der systemd-Unit, der tmux-Umgebung oder der Containerdefinition, durch die er gesetzt wurde. Andernfalls wird er in der nächsten Login-Shell erneut gesetzt.

Kann ich Claude Code mit einem kostenlosen Claude-Konto verwenden?

Nein. Als Kontotypen für die Anmeldung nennt Anthropic ein Pro- oder Max-Abonnement, einen Claude for Teams- oder Enterprise-Sitzplatz, ein Claude Console-Konto, einen Cloud-Provider und ein Cloud gateway. Dabei handelt es sich um ein selbst gehostetes Claude apps gateway, das über Corporate SSO mit /login angemeldet ist. Ein kostenloses claude.ai-Konto gehört nicht dazu. Daher gibt es dafür keine Abonnement-Anmeldedaten, die gespeichert werden könnten. Die kostenpflichtige Alternative zu einem Abonnement ist eine Claude Console-Organisation mit API-Guthaben, die pro Token abgerechnet wird. Sie ist ein separates Konto, auch wenn sie dieselbe E-Mail-Adresse verwendet.

Haben mein claude.ai-Konto und mein Console-Konto ein gemeinsames Guthaben?

Nein. Es handelt sich um separate Konten mit separater Abrechnung, auch wenn beide dieselbe E-Mail-Adresse verwenden. Die Nutzung des Abonnements wird auf das Kontingent Ihres Tarifs angerechnet. Dieses Kontingent wird mit Claude im Web gemeinsam genutzt und in einem gleitenden Fünf-Stunden-Fenster sowie einem wöchentlichen Fenster zurückgesetzt. Die Console-Nutzung wird der Organisation pro Token in Rechnung gestellt und auf der Console-Nutzungsseite angezeigt. Wenn Sie einem Konto Guthaben hinzufügen, hat das keine Auswirkungen auf das andere. Die einzige optionale Verknüpfung geht vom Tarif zur Console: Ein Max- oder Team-Tarif kann seine monatlichen API-Guthaben an eine Console-Organisation übertragen, die Sie über claude.ai verknüpfen. Diese Guthaben decken Claude Code nicht ab.

Wie authentifiziere ich Claude Code auf einem Headless-Server?

Es gibt zwei Möglichkeiten. Führen Sie claude über SSH aus und schließen Sie die Browser-Anmeldung auf Ihrem eigenen Rechner ab. Drücken Sie c, um die URL zu kopieren, melden Sie sich dort an und fügen Sie den Code anschließend wieder im Terminal ein, wenn der Browser statt einer Weiterleitung einen Code anzeigt. Oder führen Sie claude setup-token auf einem Rechner mit Browser aus, kopieren Sie das ausgegebene Token mit einer Gültigkeit von einem Jahr und setzen Sie es auf dem Server als CLAUDE_CODE_OAUTH_TOKEN. Dieses Token erfordert einen Pro-, Max-, Team- oder Enterprise-Tarif und kann nur Modellanfragen stellen. Ein Skript, das --bare verwendet, benötigt daher stattdessen einen API-Schlüssel oder einen apiKeyHelper.