Unbeaufsichtigt · 2026-10-26

Claude Code OAuth-Token abgelaufen: unbeaufsichtigte Läufe reparieren

Stand 2026-10-26 gilt bei unbeaufsichtigten claude -p-, cron- oder CI-Läufen: Ist das gespeicherte Login abgelaufen und lässt sich nicht erneuern, schlägt jede Modellanfrage mit Login expired fehl. Für CI und Skripte nennt die offizielle Dokumentation ein einjähriges OAuth-Token aus claude setup-token; Sie können sich auch mit einem API-Schlüssel oder einem Gateway-Token authentifizieren.

Aktualisiert 2026-10-26

Ein Key für Claude, GPT und führende chinesische Modelle, Bezahlung pro Token, in wenigen Minuten startklar.

#Login expired#setup-token#CLAUDE_CODE_OAUTH_TOKEN#ANTHROPIC_API_KEY

Was Sie prüfen sollten

1 Jahr

Laufzeit des langlebigen Tokens

claude setup-token erzeugt ein OAuth-Token für ein Jahr, das Sie in CLAUDE_CODE_OAUTH_TOKEN eintragen; laut Dokumentation ist ein Plan Pro, Max, Team oder Enterprise erforderlich.

Login expired

Fehler bei Ablauf

Wenn das gespeicherte Login abläuft und nicht erneuert werden kann, schlägt jede Modellanfrage mit Login expired fehl, bis Sie sich erneut anmelden.

3 Tage

Hinweis zur Verlängerung

Drei Tage vor Ablauf des Logins weist Claude Code beim Start darauf hin, dass das Login bald abläuft, und empfiehlt /login.

--bare

Hinweis zum Bare-Modus

Laut Dokumentation liest --bare weder OAuth-Zugangsdaten noch den Systemschlüsselbund und auch nicht CLAUDE_CODE_OAUTH_TOKEN; verwenden Sie in diesem Modus ANTHROPIC_API_KEY oder apiKeyHelper.

Welche Zugangsdaten für unbeaufsichtigte Läufe funktionieren

Stand 2026-10-26 nennt die offizielle Authentication-Dokumentation diese Quellen für Zugangsdaten: ein langlebiges OAuth-Token für Abonnenten (erzeugt mit claude setup-token und in CLAUDE_CODE_OAUTH_TOKEN eingetragen), einen API-Schlüssel aus der Claude Console (in ANTHROPIC_API_KEY eingetragen und im nicht interaktiven Modus -p verwendet, wenn vorhanden), ein Gateway-Token (in ANTHROPIC_AUTH_TOKEN eingetragen und als Bearer gesendet) sowie apiKeyHelper für dynamische Zugangsdaten. Wenn ein Login abläuft, melden Sie sich mit /login erneut an oder wechseln Sie zu langlebigen Zugangsdaten.

Was die offiziellen Seiten sagen

Die offizielle authentication-Dokumentation sagt: Drei Tage vor Ablauf des Logins erscheint ein Hinweis zur Verlängerung; nach Ablauf, wenn das Login nicht erneuert werden kann, schlägt jede Modellanfrage mit Login expired · Please run /login fehl; die Login-Zeile in /status zeigt Expired — log in again (Claude Code v2.1.210 oder neuer). Ein langlebiges Token wird mit claude setup-token erzeugt und erfordert einen Plan Pro, Max, Team oder Enterprise.

Zeitleiste

2026-10-18

Ein Community-Bericht (Zenn, veröffentlicht 2026-10-23): Der Windows-Aufgabenplaner startete claude -p um 3 Uhr nachts; nach Ablauf des Logins beendete sich der Prozess etwa 20 Sekunden nach dem Start mit einem Fehler, dass die OAuth-Sitzung abgelaufen und nicht erneuerbar sei, Exit-Code 1.

2026-10-23

Der Community-Artikel (an diesem Tag veröffentlicht) sagt, dass beim unbeaufsichtigten Lauf niemand den Anmeldehinweis sehen konnte; der Autor bemerkte es am Morgen des 2026-10-18, meldete sich erneut an und startete das Skript von Hand neu. Laut Artikel bleibt nach dem Ablauf nur die manuelle Anmeldung.

2026-10-26

Die Seiten authentication, headless und CLI reference auf code.claude.com sowie die environment-Seite der QCode-Dokumentation wurden geprüft; die Formulierungen zu Zugangsdaten und Fehlern folgen diesen Seiten vom 2026-10-26.

Bestätigt und unbestätigt

Bestätigt (wörtlich auf offiziellen Seiten)

Die Dokumentation sagt: claude setup-token erzeugt ein OAuth-Token für ein Jahr und erfordert einen Plan Pro, Max, Team oder Enterprise; CLAUDE_CODE_OAUTH_TOKEN ist für CI und Skripte gedacht; ANTHROPIC_API_KEY wird im Modus -p verwendet, wenn vorhanden; ANTHROPIC_AUTH_TOKEN ist für Gateways gedacht; --bare liest weder OAuth-Zugangsdaten noch den Systemschlüsselbund noch CLAUDE_CODE_OAUTH_TOKEN; die Expired-Zeile in /status erfordert v2.1.210 oder neuer.

Unbestätigt und nicht veröffentlicht

Ein Community-Bericht (Zenn, veröffentlicht 2026-10-23): Ein unbeaufsichtigter Lauf am 2026-10-18 endete etwa 20 Sekunden nach dem Start, weil die OAuth-Sitzung abgelaufen und nicht erneuerbar war. Das ist ein Nutzerbericht, keine offizielle Fehlerliste. Die Dokumentation sagt, dass eine Hintergrundsitzung in der Agent-Ansicht oder in Remote Control nach Ablauf der Zugangsdaten nicht weiterläuft; für CI und Skripte nennt sie das langlebige Token aus claude setup-token.

Abo-Login und API-Zugangsdaten

Abo-Login und langlebiges Token

claude setup-token erzeugt ein OAuth-Token für ein Jahr, das an ein Claude-Abo gebunden ist; es eignet sich für CI und Skripte. Der Bare-Modus liest diese Variable nicht.

API-Schlüssel und Gateway-Token

ANTHROPIC_API_KEY stammt aus der Claude Console und wird im Modus -p verwendet, wenn vorhanden; ANTHROPIC_AUTH_TOKEN ist für ein Gateway oder einen Proxy gedacht und wird als Bearer gesendet.

Schritte zur Fehlersuche

① Prüfen Sie Fehler und Status: Eine Anfrage schlägt mit Login expired fehl, oder die Login-Zeile in /status zeigt Expired; dann ist das gespeicherte Login abgelaufen. ② Wenn Sie interaktiv arbeiten können, führen Sie /login in einer Sitzung (oder claude auth login in der Shell) aus; auf einer unbeaufsichtigten Maschine nutzen Sie claude setup-token: Es startet denselben Browser-Autorisierungsablauf wie /login und gibt das Token im Terminal aus, ohne es zu speichern; kopieren Sie es nach CLAUDE_CODE_OAUTH_TOKEN. ③ Wenn das Skript --bare verwendet, setzen Sie ANTHROPIC_API_KEY (in der Claude Console erstellt) oder apiKeyHelper; --bare liest keine OAuth-Zugangsdaten. ④ Bei einer Verbindung über ein Gateway setzen Sie ANTHROPIC_AUTH_TOKEN; es hat Vorrang vor ANTHROPIC_API_KEY. ⑤ Legen Sie die Zugangsdaten in der cron-/CI-Umgebung oder als Secret ab und starten Sie erneut, um Exit-Code 0 zu bestätigen.

Unbeaufsichtigte Läufe mit einem QCode-Schlüssel

Die QCode-Dokumentation beschreibt die Verbindung über ANTHROPIC_BASE_URL=https://api.qcode.cc/api und ANTHROPIC_AUTH_TOKEN=Ihr QCode-Schlüssel (beginnt mit cr_); laut Dokumentation bieten alle drei Zugangsdomains dieselben Funktionen, und derselbe Schlüssel funktioniert auf allen. Der Schlüssel gehört in ANTHROPIC_AUTH_TOKEN statt in ANTHROPIC_API_KEY, und Claude Code sendet ihn als Bearer-Token; Modellaufrufe werden pro Token abgerechnet, die Preise je Modell stehen auf /models. Ein Privatplan gilt 30 Tage pro Kauf. Kein Monatsplan? «Nutzungspakete» starten bei $4 für ein einmaliges Kontingent, das Sie innerhalb von 7 Tagen aufbrauchen. Wenn Sie bereits einen Privatplan haben und mehr Kontingent brauchen, buchen Sie ein Booster-Pack dazu.

Häufig gestellte Fragen

Welcher Fehler erscheint, wenn das Claude Code OAuth-Token abläuft?

Die offizielle Dokumentation nennt Login expired · Please run /login; drei Tage vor Ablauf erscheint außerdem ein Hinweis zur Verlängerung.

Welche Zugangsdaten kann ein unbeaufsichtigtes claude -p verwenden?

Ein einjähriges CLAUDE_CODE_OAUTH_TOKEN aus claude setup-token (Abo erforderlich), einen ANTHROPIC_API_KEY aus der Claude Console oder ein ANTHROPIC_AUTH_TOKEN für ein Gateway; außerdem steht apiKeyHelper zur Verfügung.

Wie lange gilt ein Token aus claude setup-token?

Die Dokumentation nennt es one-year OAuth token, also ein Jahr; erforderlich ist ein Plan Pro, Max, Team oder Enterprise, und es kann nur Modellanfragen senden.

Warum schlägt die Authentifizierung im --bare-Modus trotzdem fehl?

Laut Dokumentation liest --bare weder OAuth-Zugangsdaten noch den Systemschlüsselbund noch CLAUDE_CODE_OAUTH_TOKEN; verwenden Sie in diesem Modus ANTHROPIC_API_KEY oder apiKeyHelper.

Wie komme ich nach Ablauf des Logins am schnellsten wieder ans Laufen?

In einer interaktiven Umgebung führen Sie /login aus; auf einer unbeaufsichtigten Maschine wechseln Sie zu einem langlebigen Token oder API-Schlüssel und prüfen die Login-Zeile in /status.

Nutzt ein QCode-Schlüssel den Abo-Login?

Die QCode-Dokumentation richtet die Verbindung über die Variablen ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN ein, der QCode-Schlüssel beginnt mit cr_; es ist kein Abo-/login. In der offiziellen Reihenfolge der Zugangsdaten steht ANTHROPIC_AUTH_TOKEN vor dem Abo-/login.

Quellen

Dokumentation authentication, headless und CLI reference auf code.claude.com (abgerufen am 2026-10-26); ein Community-Artikel auf Zenn (veröffentlicht 2026-10-23, Nutzerbericht); die Seiten environment und cloud-servers in der QCode-Dokumentation, qcode.cc/pricing und /pay-as-you-go (abgerufen am 2026-10-26); qcode.cc/models.

Unbeaufsichtigte Läufe auf einen API-Schlüssel umstellen

Soll der Agent dauerhaft auf einem Server laufen? Stellen Sie den Server im Ausland auf, installieren Sie Claude Code oder Codex und rufen Sie Modelle mit Ihrem QCode-Schlüssel auf; der AI-Dienst und der Cloud-Server nutzen dasselbe Guthaben. Siehe qcode.cc/en/cloud; die Oberfläche der Cloud-Server ist derzeit nur auf Chinesisch und Englisch verfügbar.

Unsicher, womit Sie anfangen sollen?

Eine Woche ausprobieren

Kleinpaket für $4: $30 Kontingent, 7 Tage gültig

Täglich im Einsatz

Starter für $9.00 pro Monat – pro $1 Kontingent etwa halb so teuer wie das Mittelpaket ($5 Kontingent pro Tag)