CLI-Authentifizierungsoptionen

Die ant-CLI unterstützt mehrere Quellen für Anmeldedaten. Der Schnellstart behandelt den einfachsten Weg mit einem einzigen Befehl (ant auth login). Diese Seite behandelt alle Optionen im Detail.

Interaktiver Login

Mit ant auth login kannst du die API aufrufen, ohne einen API-Key erstellen oder verwalten zu müssen. Der Befehl öffnet einen browserbasierten OAuth-Flow gegen die Claude Console und speichert die resultierenden Anmeldedaten unter $ANTHROPIC_CONFIG_DIR (siehe Konfigurationsverzeichnis für den betriebssystemspezifischen Standardpfad). Auf einem Remote-Host oder in einer Umgebung ohne lokalen Browser übergibst du --no-browser, um die Autorisierungs-URL auszugeben und den zurückgegebenen Code ins Terminal einzufügen.

ant auth login

# Auf einem Remote-Host ohne Browser:
ant auth login --no-browser

# An einen bestimmten Workspace binden und die Browser-Auswahl überspringen:
ant auth login --workspace-id wrkspc_01...

# Wenn das benannte Profil, das du mit --profile übergibst, nicht existiert,
# wird ein neues benanntes Profil mit diesem Namen erstellt.
ant auth login --profile <profile-name>

Während des Browser-Flows wählst du eine Organisation und anschließend einen Workspace aus. Das ausgestellte Token ist auf diesen Workspace beschränkt, sodass die CLI nur Ressourcen sehen kann, die zu diesem gehören. Übergib --workspace-id, um direkt zu binden und die Auswahl zu überspringen. Um in mehr als einem Workspace zu arbeiten, siehe Zwischen Workspaces wechseln.

Der interaktive Login ist für die lokale Entwicklung und das Scripting auf deinem eigenen Rechner gedacht. Für nicht-interaktive Workloads wie CI, Server und Container verwende stattdessen Workload Identity Federation.

Der Login schreibt Anmeldedaten nach credentials/<profile>.json. Der erste Login für ein Profil erstellt außerdem configs/<profile>.json und setzt es als aktives Profil. Um gespeicherte Anmeldedaten zu entfernen, führe ant auth logout aus, oder ant auth logout --all, um alle Profile zu löschen.

API-Key

Die CLI liest deinen API-Key auch aus der Umgebungsvariable ANTHROPIC_API_KEY. Hole dir einen Key aus der Claude Console.

Um den Key für einen einzelnen Aufruf zu überschreiben, übergib --api-key. Um auf einen anderen API-Host zu verweisen, setze ANTHROPIC_BASE_URL oder übergib --base-url.

Authentifizierungsstatus prüfen

ant auth status gibt die von der CLI ausgewählte Quelle der Anmeldedaten aus (API-Key-Umgebungsvariable, OAuth-Login, Federation oder Profil), das aktive Profil, den Workspace, an den das aktive Token gebunden ist, sowie die Pfade des Konfigurationsverzeichnisses. Verwende den Befehl, um herauszufinden, warum ein Workload die falschen Anmeldedaten oder den falschen Workspace ausgewählt hat.

ant auth status

Active profile:  default
Config dir:      ~/.config/anthropic
Profile config:  ~/.config/anthropic/configs/default.json
Credentials:     ~/.config/anthropic/credentials/default.json

Credentials
  (active) * Profile (user_oauth) [via active_config]       sk-ant-oat01-EXA...
...

Workspace
  (active) * Workspace                                      wrkspc_01... (Engineering)

Lies die (active)-Zeilen, um zu sehen, welche Quelle der Anmeldedaten und welcher Workspace gewonnen haben. Der Befehl meldet den Status, führt aber keinen Health-Check durch – schreibe also keine Skripte, die sich auf den Exit-Status verlassen. Die vollständige Reihenfolge der Quellen für Anmeldedaten findest du unter Priorität der Anmeldedaten.

Zwischen Workspaces wechseln

Ein Token aus dem interaktiven Login ist an einen einzelnen Workspace gebunden. Um die CLI mit mehr als einem Workspace zu verwenden, logge dich in jeden unter einem eigenen benannten Profil ein und wechsle dann zwischen ihnen:

# 1. Erstelle das Profil (interaktiv; wähle den anderen Workspace im
#    Browser aus, oder übergib --workspace-id, um die Auswahl zu überspringen):
# ant auth login --profile other-ws

# 2. Lege es als Standard für nachfolgende Befehle fest:
ant profile activate other-ws

# 3. Oder wähle es für einen einzelnen Befehl aus, ohne den Standard zu ändern:
ant --profile other-ws models list
ANTHROPIC_PROFILE=other-ws ant models list

Führe ant auth status aus, um zu bestätigen, welches Profil und welcher Workspace aktiv sind.

Profile verwalten

Die ant profile-Unterbefehle prüfen und bearbeiten den Profilstatus direkt:

ant profile list
ant profile get --profile other-ws
ant profile set workspace_id wrkspc_01... --profile other-ws

Die beschreibbaren Schlüssel für ant profile set sind workspace_id, base_url, organization_id, scope, client_id und console_url. Das Setzen von workspace_id speichert den Ziel-Workspace in der Profilkonfiguration, bindet aber bereits ausgestellte Anmeldedaten nicht neu; führe ant auth login erneut unter diesem Profil aus, um ein Token für den neuen Workspace zu erstellen.

Das Schema der Profildatei und den Federation-Block findest du unter Profil-Konfigurationsdatei. Für Workload Identity Federation siehe die Authentifizierungsübersicht und die WIF-Referenz.