Options d'authentification de la CLI

La CLI ant prend en charge plusieurs sources d'identifiants. Le Démarrage rapide couvre le chemin idéal en une seule commande (ant auth login). Cette page couvre toutes les options en détail.

Connexion interactive

ant auth login vous permet d'appeler l'API sans créer ni gérer de clé API. Cette commande ouvre un flux OAuth dans le navigateur vers la Claude Console et stocke les identifiants obtenus sous $ANTHROPIC_CONFIG_DIR (consultez Répertoire de configuration pour connaître l'emplacement par défaut selon le système d'exploitation). Sur un hôte distant ou dans tout environnement sans navigateur local, passez --no-browser pour afficher l'URL d'autorisation et collez le code renvoyé dans le terminal.

ant auth login

# Sur un hôte distant sans navigateur :
ant auth login --no-browser

# Lier à un espace de travail spécifique et ignorer le sélecteur de navigateur :
ant auth login --workspace-id wrkspc_01...

# Si le profil nommé que vous passez avec --profile n'existe pas,
# un nouveau profil nommé sera créé avec ce nom.
ant auth login --profile <profile-name>

Pendant le flux dans le navigateur, vous sélectionnez une organisation puis un workspace (espace de travail). Le jeton émis est limité à ce workspace, de sorte que la CLI ne peut voir que les ressources qui lui appartiennent. Passez --workspace-id pour lier directement et ignorer le sélecteur. Pour travailler dans plusieurs workspaces, consultez Basculer entre les workspaces.

La connexion interactive est destinée au développement local et à l'écriture de scripts sur votre propre machine. Pour les charges de travail non interactives telles que la CI, les serveurs et les conteneurs, utilisez plutôt Workload Identity Federation.

La connexion écrit les identifiants dans credentials/<profile>.json. La première connexion pour un profil crée également configs/<profile>.json et le définit comme profil actif. Pour supprimer les identifiants stockés, exécutez ant auth logout, ou ant auth logout --all pour effacer tous les profils.

Clé API

La CLI lit également votre clé API depuis la variable d'environnement ANTHROPIC_API_KEY. Obtenez une clé depuis la Claude Console.

Pour remplacer la clé pour une seule invocation, passez --api-key. Pour pointer vers un hôte d'API différent, définissez ANTHROPIC_BASE_URL ou passez --base-url.

Vérifier l'état de l'authentification

ant auth status affiche la source d'identifiants sélectionnée par la CLI (variable d'environnement de clé API, connexion OAuth, fédération ou profil), le profil actif, le workspace auquel le jeton actif est lié et les chemins du répertoire de configuration. Utilisez cette commande pour diagnostiquer pourquoi une charge de travail a choisi le mauvais identifiant ou le mauvais workspace.

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)

Lisez les lignes (active) pour voir quelle source d'identifiants et quel workspace ont été retenus. La commande rapporte l'état plutôt que d'effectuer une vérification de santé, ne vous basez donc pas sur le code de sortie dans vos scripts. Pour l'ordre complet des sources d'identifiants, consultez Priorité des identifiants.

Basculer entre les workspaces

Un jeton de connexion interactive est lié à un seul workspace. Pour utiliser la CLI avec plusieurs workspaces, connectez-vous à chacun sous son propre profil nommé, puis basculez entre eux :

# 1. Créez le profil (interactif ; choisissez l'autre espace de travail dans le
#    navigateur, ou passez --workspace-id pour ignorer le sélecteur) :
# ant auth login --profile other-ws

# 2. Définissez-le comme profil par défaut pour les commandes suivantes :
ant profile activate other-ws

# 3. Ou sélectionnez-le pour une seule commande sans modifier le profil par défaut :
ant --profile other-ws models list
ANTHROPIC_PROFILE=other-ws ant models list

Exécutez ant auth status pour confirmer quel profil et quel workspace sont actifs.

Gérer les profils

Les sous-commandes ant profile inspectent et modifient directement l'état des profils :

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

Les clés modifiables pour ant profile set sont workspace_id, base_url, organization_id, scope, client_id et console_url. Définir workspace_id enregistre le workspace cible dans la configuration du profil mais ne relie pas les identifiants déjà émis ; exécutez à nouveau ant auth login sous ce profil pour générer un jeton pour le nouveau workspace.

Pour le schéma du fichier de profil et le bloc de fédération, consultez Fichier de configuration de profil. Pour Workload Identity Federation, consultez la Vue d'ensemble de l'authentification et la référence WIF.