Claude Code - Tutoriel 6 : Comment s'authentifier - Connexion via navigateur et configuration manuelle de la clé API

Processus d'authentification : Connexion via navigateur et configuration manuelle de la clé API

Après avoir installé Claude Code, vous devez vous authentifier avant de pouvoir l'utiliser. Vous devez lier l'outil à votre compte Anthropic. Il existe deux méthodes de liaison : connexion via navigateur et configuration manuelle de la clé API. Les deux méthodes donnent le même résultat final, choisissez celle qui vous convient.

Méthode 1 : Connexion via navigateur (recommandée)

Claude Code fournit une commande d'authentification automatique claude login qui ouvre votre navigateur, vous permet d'autoriser sur la page web, puis enregistre automatiquement les identifiants dans le terminal.

Étapes :

Dans le terminal, saisissez :

bash claude login

Le système affiche une série d'invites et ouvre automatiquement la page d'autorisation Anthropic dans votre navigateur par défaut.
Si elle ne s'ouvre pas automatiquement, un lien sera affiché dans le terminal ; vous pouvez le copier manuellement dans votre navigateur.
Connectez-vous à votre compte Anthropic dans le navigateur (si déjà connecté, la page demandera directement l'autorisation).
Cliquez sur « Autoriser » ou « Permettre », la page du navigateur affichera « Autorisation réussie, vous pouvez fermer cette page ».
Revenez au terminal, vous verrez un message de fin d'authentification. Désormais, lorsque vous exécutez la commande claude, elle sera liée à votre compte.

Méthode 2 : Configuration manuelle de la clé API

Si vous utilisez un serveur sans interface graphique, un conteneur, ou si vous ne souhaitez pas passer par l'autorisation du navigateur, vous pouvez obtenir une clé API depuis la console Anthropic et la configurer dans Claude Code.

Étapes :

Ouvrez un navigateur, accédez à https://console.anthropic.com, connectez-vous à votre compte Anthropic.
Allez dans la page API Keys (généralement dans les paramètres ou les options développeur), cliquez sur « Créer une clé API ».
Donnez un nom à la clé (par exemple claude-code-local), générez-la et copiez-la immédiatement.
Attention : cette clé n'est affichée qu'une seule fois ; si vous fermez la page, vous ne pourrez plus la voir. Si vous oubliez de la sauvegarder, supprimez l'ancienne et générez-en une nouvelle.
Revenez au terminal, il y a deux façons de fournir la clé à Claude Code :

A. Par variable d'environnement :

bash export ANTHROPIC_API_KEY=votre-clé-api

Ajoutez cette ligne dans votre ~/.bashrc ou ~/.zshrc pour qu'elle soit chargée automatiquement à chaque session.

B. Par fichier de configuration :

Claude Code peut également lire son propre fichier de configuration. Modifiez manuellement ~/.claude/config.json (créez-le s'il n'existe pas), et écrivez :

json { "apiKey": "votre-clé-api" }

Note : il est recommandé de définir les permissions de ce fichier sur 600 (chmod 600 ~/.claude/config.json) pour empêcher les autres utilisateurs de le lire.

Testez la connexion :

bash claude "Bonjour, veuillez répondre par 'OK'"

Si vous recevez une réponse normale, la clé est bien configurée.

Erreurs fréquentes lors de la configuration manuelle :

La clé ne doit-elle pas commencer par sk-ant- ou sk- ? Si, la clé API d'Anthropic est bien une longue chaîne commençant par sk-ant-api03-. Ne manquez aucun caractère lors de la copie.
Si vous avez défini à la fois la variable d'environnement et le fichier, la variable d'environnement a la priorité. Ne gardez qu'une seule méthode pour éviter toute confusion.
La clé est un identifiant payant, ne la commettez pas dans un dépôt Git. Il est conseillé d'ignorer tout le répertoire ~/.claude ou le fichier de configuration via .gitignore.

Changer de compte ou se déconnecter

Pour changer de compte ou effacer les identifiants locaux :

Si vous avez utilisé claude login : exécutez claude logout, puis refaites claude login.
Si vous avez configuré manuellement une clé : supprimez l'ancienne clé de la variable d'environnement ou du fichier de configuration, et remplacez-la par la nouvelle.

Tester si l'authentification fonctionne

claude "Expliquez à quoi sert le répertoire actuel"

S'il parvient à lire le résumé de votre projet, l'environnement est prêt.