Claude Setup-Token für BYOK generieren

Was ist ein Setup-Token?

Ein Setup-Token ist ein OAuth-Token, der über die Claude Code CLI generiert wird. Damit kannst du dein bestehendes Claude-Abo (Pro oder Max) für deine ClawHosters-Instanz nutzen, anstatt separat für API-Zugang über die Anthropic Console zu bezahlen.

Das ist der empfohlene Weg, wenn du bereits ein Claude Pro (20 $/Monat) oder Claude Max (100 $/Monat bzw. 200 $/Monat) Abo hast.

Voraussetzungen

Bevor du loslegst, brauchst du:

• Ein aktives Claude Pro oder Claude Max Abo auf claude.ai
• Claude Code auf deinem Computer installiert (das CLI-Tool, nicht die Web-Oberfläche)
• Ein Terminal oder eine Eingabeaufforderung

Falls du Claude Code noch nicht installiert hast, folge der offiziellen Installationsanleitung.

Setup-Token generieren

Öffne dein Terminal und führe folgenden Befehl aus:

claude setup-token

Dadurch öffnet sich ein Browserfenster zur Authentifizierung. Melde dich mit deinem Claude-Konto an, bestätige die Anfrage, und der Token erscheint in deiner Terminal-Ausgabe.

Kopiere den gesamten Token-String. Das ist eine lange kodierte Zeichenkette mit einem erkennbaren Präfix. Bewahre ihn vorübergehend sicher auf — du wirst ihn im nächsten Schritt in ClawHosters einfügen.

Achtung: Behandle diesen Token wie ein Passwort. Jeder mit deinem Setup-Token kann dein Claude-Abo nutzen. Teile ihn nicht öffentlich und speichere ihn nicht in Versionskontrollsystemen.

Token in ClawHosters verwenden

Es gibt zwei Stellen, an denen du deinen Setup-Token eingeben kannst:

Bei der Instanz-Erstellung (Erstellungs-Assistent)

1. Wähle im Erstellungs-Assistenten BYOK (Bring Your Own Key) als LLM-Modus
2. Wähle Anthropic als Anbieter
3. Füge deinen Setup-Token in das API-Key-Feld ein
4. Fahre mit dem Assistenten fort

Nach der Instanz-Erstellung (Instanz-Einstellungen)

1. Gehe zu deiner Instanz im ClawHosters Dashboard
2. Öffne die Instanz-Einstellungen
3. Finde den Bereich für die LLM-Konfiguration
4. Wähle Anthropic und füge deinen Setup-Token ein

Dein Token wird mit AES-256 verschlüsselt und auf deutschen Servern gespeichert. ClawHosters liest oder verarbeitet deinen Token nie direkt — er wird unmittelbar an das OpenClaw Gateway auf deiner dedizierten Instanz weitergeleitet.

Setup-Token vs API-Key

Token erneuern und Ablauf

Setup-Token sind langlebig, aber nicht unbegrenzt gültig. Wenn dein Token abläuft oder nicht mehr funktioniert:

1. Öffne dein Terminal
2. Führe erneut claude setup-token aus
3. Authentifiziere dich im Browser
4. Kopiere den neuen Token
5. Aktualisiere ihn in deinen ClawHosters Instanz-Einstellungen

Anzeichen, dass dein Token erneuert werden muss:

• Deine Instanz zeigt LLM-Verbindungsfehler an
• Antworten funktionieren nicht mehr nach einer langen Phase normalen Betriebs
• Du hast dein Claude-Abo oder deine Kontoeinstellungen geändert

Fehlerbehebung

"Command not found" beim Ausführen von claude setup-token

Claude Code ist nicht installiert oder nicht in deinem System-PATH. Installiere es von der offiziellen Setup-Seite und stelle sicher, dass der claude-Befehl in deinem Terminal erreichbar ist.

Token wird beim Setup abgelehnt

• Überprüfe, ob du ein aktives Claude Pro oder Max Abo hast
• Stelle sicher, dass du den Browser-Authentifizierungsschritt abgeschlossen hast
• Generiere einen neuen Token
• Achte darauf, dass du den gesamten Token-String ohne zusätzliche Leerzeichen kopiert hast

Instanz funktioniert anfangs, antwortet dann aber nicht mehr

Dein Token ist möglicherweise abgelaufen. Generiere einen neuen mit claude setup-token und aktualisiere ihn in deinen Instanz-Einstellungen.

"Invalid API key"-Fehler in den Instanz-Logs

Möglicherweise hast du einen Anthropic Console API-Key statt eines Setup-Tokens eingefügt, oder umgekehrt. Setup-Token und API-Keys haben unterschiedliche Formate. Stelle sicher, dass du den richtigen für deine gewählte Authentifizierungsmethode verwendest.

Verwandte Anleitungen

• Schnellstart-Anleitung — Komplette Anleitung zur Erstellung deiner ersten Instanz