Claude Code Serie Teil 6: Authentifizierung – Browser-Login und manuelle API-Key-Konfiguration

Authentifizierungsablauf: Browser-Login und manuelle API-Key-Konfiguration

Nach der Installation von Claude Code musst du dich authentifizieren, um es nutzen zu können. Du musst das Tool mit deinem Anthropic-Konto verbinden. Es gibt zwei Methoden: Browser-Login und manuelle API-Key-Konfiguration. Beide Methoden führen zum gleichen Ergebnis – wähle die, die dir am besten passt.

Methode 1: Browser-Login (empfohlen)

Claude Code bietet einen automatischen Authentifizierungsbefehl claude login, der einen Browser öffnet, damit du dich auf der Webseite authorisieren kannst. Anschließend werden die Anmeldedaten automatisch an das Terminal zurückgegeben.

Schritte:

Gib im Terminal ein:

bash claude login

Das System zeigt eine Meldung an und öffnet automatisch die Authorisierungsseite von Anthropic in deinem Standardbrowser.
Falls dies nicht automatisch geschieht, wird im Terminal ein Link angezeigt, den du manuell in den Browser kopieren kannst.
Melde dich im Browser mit deinem Anthropic-Konto an (falls du bereits angemeldet bist, fordert die Seite direkt zur Authorisierung auf).
Klicke auf „Erlauben“ oder „Autorisieren“. Die Browserseite zeigt dann „Authorisierung erfolgreich, du kannst diese Seite schließen“.
Kehre zum Terminal zurück. Dort siehst du eine Bestätigung der erfolgreichen Authentifizierung. Wenn du nun den Befehl claude ausführst, ist er mit deinem Konto verbunden.

Methode 2: Manuelle API-Key-Konfiguration

Wenn du einen Server ohne grafische Oberfläche, einen Container verwendest oder den Browser-Login vermeiden möchtest, kannst du einen API-Key von der Anthropic-Konsole abrufen und in Claude Code konfigurieren.

Schritte:

Öffne im Browser https://console.anthropic.com und melde dich mit deinem Anthropic-Konto an.
Gehe zur API-Keys-Seite (normalerweise unter Einstellungen oder Entwickleroptionen) und klicke auf „API-Key erstellen“.
Gib dem Key einen Namen (z. B. claude-code-local) und kopiere ihn sofort nach der Erstellung.
Hinweis: Der Key wird nur einmal angezeigt. Wenn du die Seite schließt, ist er nicht mehr sichtbar. Falls du vergessen hast, ihn zu speichern, lösche den alten und erstelle einen neuen.
Kehre zum Terminal zurück. Es gibt zwei Möglichkeiten, den Key an Claude Code zu übergeben:

A. Umgebungsvariable:

bash export ANTHROPIC_API_KEY=Ihr-API-Key

Füge diese Zeile in deine ~/.bashrc oder ~/.zshrc ein, damit sie bei jeder Sitzung automatisch gesetzt wird.

B. Konfiguration in Datei:

Claude Code liest auch seine eigene Konfigurationsdatei. Bearbeite manuell ~/.claude/config.json (falls nicht vorhanden, erstelle sie) und füge Folgendes ein:

json { "apiKey": "Ihr-API-Key" }

Hinweis: Es wird empfohlen, die Berechtigungen dieser Datei auf 600 zu setzen (chmod 600 ~/.claude/config.json), um den Zugriff durch andere Benutzer zu verhindern.

Teste die Verbindung:

bash claude "Hallo, antworte bitte mit 'OK'"

Wenn du eine normale Antwort erhältst, ist der Key korrekt konfiguriert.

Häufige Fehler bei der manuellen Konfiguration:

Beginnt der Key nicht mit sk-ant- oder sk-? Doch, der Anthropic-API-Key ist tatsächlich eine lange Zeichenfolge, die mit sk-ant-api03- beginnt. Achte darauf, beim Kopieren keine Zeichen auszulassen.
Wenn du sowohl die Umgebungsvariable als auch die Datei konfiguriert hast, hat die Umgebungsvariable Vorrang. Behalte nur eine Methode bei, um Verwirrung zu vermeiden.
Der Key ist eine kostenpflichtige Anmeldeinformation. Gib ihn nicht in ein Git-Repository. Es wird empfohlen, das gesamte ~/.claude-Verzeichnis oder die Konfigurationsdatei über .gitignore auszuschließen.

Konto wechseln oder abmelden

Um das Konto zu wechseln oder die lokalen Anmeldedaten zu löschen:

Wenn du claude login verwendet hast: Führe claude logout aus und anschließend erneut claude login.
Wenn du den Key manuell konfiguriert hast: Lösche den alten Key aus der Umgebungsvariable oder der Konfigurationsdatei und ersetze ihn durch den neuen.

Authentifizierung testen

claude "Erkläre, wozu das aktuelle Verzeichnis dient"

Wenn es deine Projektübersicht auslesen kann, ist die Umgebung einsatzbereit.