12 Se connecter à Claude Code12 Se connecter à Claude Code

13</h2>13</h2>

14 14 

15Après [l'installation de Claude Code](/docs/fr/setup#install-claude-code), exécutez `claude` dans votre terminal. Au premier lancement, Claude Code ouvre une fenêtre de navigateur pour vous permettre de vous connecter.15Après [l'installation de Claude Code](/docs/fr/setup#install-claude-code), exécutez `claude` dans votre terminal. Au premier lancement, Claude Code ouvre une fenêtre de navigateur pour vous permettre de vous connecter. Si vous avez défini la variable d'environnement `ANTHROPIC_API_KEY`, Claude Code ignore l'invite de connexion et vous demande plutôt d'approuver la clé.

16 16 

17Si le navigateur ne s'ouvre pas automatiquement, appuyez sur `c` pour copier l'URL de connexion dans votre presse-papiers, puis collez-la dans votre navigateur.17Si le navigateur ne s'ouvre pas automatiquement, appuyez sur `c` pour copier l'URL de connexion dans votre presse-papiers, puis collez-la dans votre navigateur.

18 18 

24 24 

25* **Abonnement Claude Pro ou Max** : connectez-vous avec votre compte Claude.ai. Abonnez-vous sur [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).25* **Abonnement Claude Pro ou Max** : connectez-vous avec votre compte Claude.ai. Abonnez-vous sur [claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max).

26* **Claude for Teams ou Enterprise** : connectez-vous avec le compte Claude.ai que votre administrateur d'équipe vous a invité à utiliser.26* **Claude for Teams ou Enterprise** : connectez-vous avec le compte Claude.ai que votre administrateur d'équipe vous a invité à utiliser.

27* **Claude Console** : connectez-vous avec vos identifiants Console. Votre administrateur doit vous avoir [invité](#claude-console-authentication) au préalable.27* **Claude Console** : connectez-vous avec vos identifiants Console. Votre administrateur doit vous avoir [invité](#claude-console-authentication) au préalable. Vous pouvez vous connecter avec ou sans [créer une clé API](#sign-in-without-an-api-key).

28* **Fournisseurs cloud** : si votre organisation utilise [Amazon Bedrock](/docs/fr/amazon-bedrock), [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) ou [Microsoft Foundry](/docs/fr/microsoft-foundry), définissez les variables d'environnement requises avant d'exécuter `claude`, ou sélectionnez **3rd-party platform** à l'invite de connexion, ce qui lance un assistant de configuration interactif pour Bedrock et Vertex AI. Aucune connexion au navigateur n'est nécessaire.28* **Fournisseurs cloud** : si votre organisation utilise [Amazon Bedrock](/docs/fr/amazon-bedrock), [Google Cloud's Agent Platform](/docs/fr/google-vertex-ai) ou [Microsoft Foundry](/docs/fr/microsoft-foundry), définissez les variables d'environnement requises avant d'exécuter `claude`, ou sélectionnez **3rd-party platform** à l'invite de connexion, ce qui lance un assistant de configuration interactif pour Bedrock et Vertex AI. Aucune connexion au navigateur n'est nécessaire.

29* **Passerelle cloud** : si votre organisation exécute une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway) auto-hébergée, connectez-vous avec l'authentification unique d'entreprise via `/login`. Le jeton émis par la passerelle est la seule credential de la session.29* **Passerelle cloud** : si votre organisation exécute une [passerelle d'applications Claude](/docs/fr/claude-apps-gateway) auto-hébergée, connectez-vous avec l'authentification unique d'entreprise via `/login`. Le jeton émis par la passerelle est la seule credential de la session.

30 30 

31Les administrateurs peuvent restreindre la connexion interactive avec les paramètres gérés [`forceLoginMethod` et `forceLoginOrgUUID`](/docs/fr/settings#available-settings). Lorsque l'un d'eux est défini, les sessions authentifiées par `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` sont bloquées au démarrage ; les sessions des fournisseurs cloud ne sont pas affectées.31Les administrateurs peuvent diriger la méthode de connexion que les développeurs utilisent et exiger que les connexions claude.ai appartiennent à une organisation spécifique ; voir [Restreindre la connexion à votre organisation](#restrict-login-to-your-organization).

32 32 

33Pour vous déconnecter et vous réauthentifier, tapez `/logout` à l'invite Claude Code. La déconnexion réinitialise également votre état de configuration au premier lancement, de sorte que la prochaine fois que vous exécutez `claude`, il vous guide à nouveau à travers la connexion et la configuration.33Pour vous déconnecter et vous réauthentifier, tapez `/logout` à l'invite Claude Code. La déconnexion réinitialise également votre état de configuration au premier lancement, de sorte que la prochaine fois que vous exécutez `claude`, il vous guide à nouveau à travers la connexion et la configuration.

34 34 

105 </Step>105 </Step>

106</Steps>106</Steps>

107 107 

108<h4 id="sign-in-without-an-api-key">

109 Se connecter sans clé API

110</h4>

111 

112Vous pouvez vous connecter à votre compte Console sans créer de clé API, même si votre organisation ne permet pas aux développeurs d'en créer. Choisissez le compte Anthropic Console à l'invite `/login` et Claude Code vous demande comment vous souhaitez vous connecter. Nécessite Claude Code v2.1.242 ou version ultérieure. Les deux itinéraires vous connectent à Console dans le navigateur et diffèrent dans ce que Claude Code stocke ensuite :

113 

114* **Se connecter avec votre compte Console**, étiqueté `(recommandé)` : Claude Code conserve le jeton OAuth de cette connexion et le stocke en tant que [profil Anthropic](#anthropic-profiles-and-federation-credentials). Il ne crée aucune clé API

115* **Créer une clé API**, étiqueté `(hérité)` : Claude Code crée une clé API Console pour vous et la stocke avec vos autres identifiants

116 

117En pratique, le profil stocke une connexion OAuth tandis qu'une clé API est un identifiant statique : Claude Code actualise automatiquement la connexion du profil, et lorsque l'actualisation échoue, les demandes échouent avec [Anthropic profile login expired](/docs/fr/errors#anthropic-profile-login-expired) jusqu'à ce que vous vous reconnectiez.

118 

119Vous n'avez pas le choix sur chaque machine. Claude Code crée une clé API sans demander dans ces cas :

120 

121* Vous exécutez contre un fournisseur cloud, tel que [Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry](/docs/fr/third-party-integrations) ou [Claude Platform on AWS](/docs/fr/claude-platform-on-aws)

122* Tout fichier de paramètres définit [`forceLoginOrgUUID`](#restrict-login-to-your-organization), ou définit `forceLoginMethod` sur `"claudeai"` ou `"console"`

123* Une source de paramètres gérés sur votre machine, telle que le fichier de paramètres gérés, un profil MDM ou les paramètres gérés par serveur en cache, existe mais Claude Code [ne peut pas le lire](/docs/fr/managed-settings#invalid-entries-in-managed-settings) et aucune autre source gérée ne fournit de politique

124 

125Désactivez `ANTHROPIC_API_KEY` avant de vous connecter sans clé. Un profil écrit par la propre connexion Console de Claude Code, ou par la commande `ant auth login` de la CLI Claude Platform, est le même type d'identifiant, donc se reconnecter le remplace.

126 

127Après vous être connecté sans clé, vous avez un profil au lieu d'une clé API stockée :

128 

129* **Quel profil il écrit** : Claude Code écrit le profil nommé par `ANTHROPIC_PROFILE`, ou votre profil actif, ou `default`. Si ce profil est un profil de fédération, Claude Code refuse la connexion au lieu de le remplacer

130* **Ce dont il vous déconnecte** : Claude Code vous déconnecte de toute connexion claude.ai stockée sur la machine

131* **Comment l'annuler** : exécutez `/logout`, qui supprime et révoque l'identifiant que cette connexion a écrit

132 

133Tout le reste concernant les profils s'applique à cette connexion, y compris son classement par rapport à vos autres identifiants, la ligne `Profile` que vous obtenez dans `/status`, et les fonctionnalités qui nécessitent une connexion claude.ai. Voir [Anthropic profiles and federation credentials](#anthropic-profiles-and-federation-credentials).

134 

108<h3 id="cloud-provider-authentication">135<h3 id="cloud-provider-authentication">

109 Authentification du fournisseur cloud136 Authentification du fournisseur cloud

110</h3>137</h3>

125 </Step>152 </Step>

126</Steps>153</Steps>

127 154 

155<h3 id="restrict-login-to-your-organization">

156 Restreindre la connexion à votre organisation

157</h3>

158 

159Pour exiger que les connexions claude.ai des développeurs appartiennent à une organisation Anthropic spécifique, définissez [`forceLoginMethod`](/docs/fr/settings-reference#forceloginmethod) et [`forceLoginOrgUUID`](/docs/fr/settings-reference#forceloginorguuid) dans les [paramètres gérés](/docs/fr/managed-settings). Définissez `forceLoginOrgUUID` sur votre ID d'organisation, affiché dans les [paramètres d'administration claude.ai](https://claude.ai/admin-settings/organization) pour les organisations Claude for Teams ou Enterprise. Claude Code signale une erreur pour une connexion claude.ai à toute autre organisation et se ferme au démarrage si l'identifiant claude.ai en cours d'utilisation appartient à une organisation qui n'est pas répertoriée.

160 

161Pour les connexions Claude Console, Claude Code utilise `forceLoginOrgUUID` pour présélectionner l'organisation sur la page de connexion Console lorsque vous la définissez sur un seul ID d'organisation Console, affiché sur [platform.claude.com/settings/organization](https://platform.claude.com/settings/organization). Il ne vérifie pas à quelle organisation appartient l'identifiant Console résultant, à la connexion ou au démarrage, et un développeur qui s'est connecté avec un compte Console avant que vous ayez déployé les clés reste connecté.

162 

163Si vous définissez `forceLoginOrgUUID` dans un fichier de paramètres, Claude Code cesse d'offrir la [connexion Console sans clé](#sign-in-without-an-api-key) dans les sessions auxquelles ce fichier s'applique et crée une clé API à la place. Pour diriger les développeurs vers la connexion claude.ai à la place, définissez `forceLoginMethod` sur `"claudeai"`.

164 

165Les développeurs peuvent se connecter à partir de plusieurs chemins : le flux terminal `/login`, l'[extension VS Code](/docs/fr/vs-code), l'Agent SDK, `claude setup-token`, `/install-github-app`, et la [connexion gateway](/docs/fr/claude-apps-gateway) pour les organisations qui acheminent via une passerelle cloud. Sur Claude Code v2.1.212 ou version ultérieure, chaque chemin applique `forceLoginMethod` ; avant v2.1.212, seules les connexions terminales appliquaient l'une ou l'autre clé. Sur l'écran de connexion interactif du terminal, accessible par `/login` ou l'intégration au premier démarrage, Claude Code présélectionne une méthode `claudeai` ou `console` sans l'appliquer, donc même avec `forceLoginMethod` défini sur `"claudeai"`, un développeur peut toujours compléter une connexion Console là. Les chemins diffèrent sur `forceLoginOrgUUID` :

166 

167* **Connexions terminales, extension VS Code et Agent SDK** : vérifiez `forceLoginOrgUUID` pour les connexions de compte claude.ai

168* **`claude setup-token` et `/install-github-app`** : appliquez uniquement `forceLoginMethod`, afin qu'ils puissent créer un jeton dans une organisation différente

169* **Connexion [Gateway](/docs/fr/claude-apps-gateway)** : sélectionnée par `forceLoginMethod: "gateway"` plutôt que restreinte par elle, et ne s'authentifie pas auprès d'une organisation Anthropic, donc `forceLoginOrgUUID` ne s'applique pas ; utilisez votre fournisseur d'identité de passerelle pour restreindre l'accès

170 

171Déployez les clés via votre outil de gestion des appareils. Les [paramètres gérés par serveur](/docs/fr/server-managed-settings) ne s'appliquent qu'aux comptes déjà authentifiés dans votre organisation, ils ne peuvent donc pas rediriger la première connexion d'un développeur. Si votre organisation distribue également des paramètres gérés par serveur, définissez les clés aux deux endroits : les sources de [paramètres gérés ne fusionnent pas](/docs/fr/server-managed-settings#settings-precedence), et les paramètres gérés par serveur en cache remplacent le fichier géré par appareil, à l'exception de deux types de clés qui se remplissent toujours à partir d'une source perdante :

172 

173* **Le bloc `env`** : [fusionne par clé](/docs/fr/server-managed-settings#per-key-exceptions-across-managed-sources) dans Claude Code v2.1.223 ou version ultérieure

174* **Les [clés de verrouillage inter-sources](/docs/fr/server-managed-settings#per-key-exceptions-across-managed-sources)** : honorées à partir de n'importe quelle source d'administration

175 

176`forceLoginMethod` et `forceLoginOrgUUID` ne sont ni l'un ni l'autre, donc gardez-les aux deux endroits.

177 

178Les clés décident également si une session qui n'utilise pas d'identifiant de connexion peut démarrer. Voir [`forceLoginOrgUUID`](/docs/fr/settings-reference#forceloginorguuid) dans la référence des paramètres pour le comportement complet.

179 

180* **`ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper`** : bloqués au démarrage, car l'appartenance à l'organisation ne peut pas être vérifiée pour un identifiant d'environnement

181* **Sessions de fournisseur cloud telles que Amazon Bedrock** : non bloquées, car elles s'authentifient auprès de votre fournisseur cloud. Restreignez-les via vos politiques IAM cloud

182* **[Profil Anthropic ou identifiants de fédération](#anthropic-profiles-and-federation-credentials)** : non bloqués, et les clés ne vérifient pas à quelle organisation le profil appartient

183 

128<h2 id="credential-management">184<h2 id="credential-management">

129 Gestion des identifiants185 Gestion des identifiants

130</h2>186</h2>

132Claude Code gère de manière sécurisée vos identifiants d'authentification :188Claude Code gère de manière sécurisée vos identifiants d'authentification :

133 189 

134* **Emplacement de stockage** :190* **Emplacement de stockage** :

135 * Sur macOS, les identifiants sont stockés dans le Keychain macOS chiffré.191 * Sur macOS, les identifiants sont stockés dans le Keychain macOS chiffré. Lorsque le Keychain rejette l'écriture, par exemple lorsqu'il est verrouillé dans une session SSH, Claude Code stocke votre connexion dans `~/.claude/.credentials.json` avec le mode fichier `0600` à la place, le même stockage qu'il utilise sur Linux. Une connexion Console qui crée une clé API échoue jusqu'à ce que le Keychain soit accessible en écriture. Pour déplacer votre connexion dans le Keychain, suivez [les étapes de récupération](/docs/fr/troubleshoot-install#not-logged-in-or-token-expired).

136 * Sur Linux, les identifiants sont stockés dans `~/.claude/.credentials.json` avec le mode fichier `0600`.192 * Sur Linux, les identifiants sont stockés dans `~/.claude/.credentials.json` avec le mode fichier `0600`.

137 * Sur Windows, les identifiants sont stockés dans `%USERPROFILE%\.claude\.credentials.json` et héritent des contrôles d'accès de votre répertoire de profil utilisateur, ce qui restreint le fichier à votre compte utilisateur par défaut.193 * Sur Windows, les identifiants sont stockés dans `%USERPROFILE%\.claude\.credentials.json` et héritent des contrôles d'accès de votre répertoire de profil utilisateur, ce qui restreint le fichier à votre compte utilisateur par défaut.

138 * Si vous avez défini la variable d'environnement `CLAUDE_CONFIG_DIR` sur Linux ou Windows, le fichier `.credentials.json` se trouve sous ce répertoire à la place.194 * Si vous avez défini la variable d'environnement `CLAUDE_CONFIG_DIR`, Claude Code conserve le fichier `.credentials.json` sous ce répertoire à la place, y compris le fichier que le fallback macOS écrit, et clé l'entrée macOS Keychain sur ce répertoire également, de sorte qu'une session avec un `CLAUDE_CONFIG_DIR` différent lit une entrée différente.

139 * Claude Code gère `.credentials.json` via `/login` et `/logout`. Pour router les requêtes via un point de terminaison API personnalisé, définissez plutôt la variable d'environnement [`ANTHROPIC_BASE_URL`](/docs/fr/env-vars).195 * Claude Code gère `.credentials.json` via `/login` et `/logout`. Pour router les requêtes via un point de terminaison API personnalisé, définissez plutôt la variable d'environnement [`ANTHROPIC_BASE_URL`](/docs/fr/env-vars).

140* **Types d'authentification pris en charge** : identifiants Claude.ai, identifiants API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth et jetons de session de la [passerelle d'applications Claude](/docs/fr/claude-apps-gateway).196* **Types d'authentification pris en charge** : identifiants Claude.ai, identifiants API Claude, Microsoft Foundry Auth, Bedrock Auth, Vertex Auth, identifiants de profil Anthropic et [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation), et jetons de session de la [passerelle d'applications Claude](/docs/fr/claude-apps-gateway).

141* **Scripts d'identifiants personnalisés** : le paramètre [`apiKeyHelper`](/docs/fr/settings#available-settings) peut être configuré pour exécuter un script shell qui retourne une clé API.197* **Scripts d'identifiants personnalisés** : configurez le paramètre [`apiKeyHelper`](/docs/fr/settings-reference#apikeyhelper) pour exécuter un script shell qui retourne une clé API.

142* **Intervalles d'actualisation** : par défaut, `apiKeyHelper` est appelé après 5 minutes ou en réponse HTTP 401. Définissez la variable d'environnement `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` pour les intervalles d'actualisation personnalisés.198* **Intervalles d'actualisation** : Claude Code réexécute `apiKeyHelper` après cinq minutes par défaut. Définissez la variable d'environnement `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` pour les intervalles d'actualisation personnalisés. Consultez [`apiKeyHelper`](/docs/fr/settings-reference#apikeyhelper) pour les autres cas dans lesquels Claude Code réexécute l'assistant.

143* **Avis d'assistant lent** : si `apiKeyHelper` prend plus de 10 secondes pour retourner une clé, Claude Code affiche un avis d'avertissement dans la barre d'invite montrant le temps écoulé. Si vous voyez cet avis régulièrement, vérifiez si votre script d'identifiants peut être optimisé.199* **Avis d'assistant lent** : si `apiKeyHelper` prend plus de 10 secondes pour retourner une clé, Claude Code affiche un avis d'avertissement dans la barre d'invite montrant le temps écoulé. Si vous voyez cet avis régulièrement, vérifiez si votre script d'identifiants peut être optimisé.

144* **Échecs de l'assistant** : lorsque le script se termine avec une erreur, expire ou n'affiche rien, les requêtes échouent avec [`Your apiKeyHelper script is failing`](/docs/fr/errors#your-apikeyhelper-script-is-failing) après trois tentatives. Avant v2.1.208, les échecs de l'assistant s'affichaient comme une erreur 401 générique après environ dix tentatives silencieuses.200* **Échecs de l'assistant** : lorsque le script se termine avec une erreur, expire ou n'affiche rien, les requêtes échouent avec [`Your apiKeyHelper script is failing`](/docs/fr/errors#your-apikeyhelper-script-is-failing) après trois tentatives. Avant v2.1.208, les échecs de l'assistant s'affichaient comme une erreur 401 générique après environ dix tentatives silencieuses.

145 201 

149 Renouveler une connexion qui expire205 Renouveler une connexion qui expire

150</h3>206</h3>

151 207 

152Lorsque la connexion que vous avez créée avec `/login` est à moins de cinq jours de l'expiration, Claude Code affiche un avertissement au démarrage : `Your login expires in 3 days · run /login to renew`. Nécessite Claude Code v2.1.203 ou version ultérieure.208Lorsque la connexion que vous avez créée avec `/login` est à moins de trois jours de l'expiration, Claude Code affiche un avertissement au démarrage : `Your login expires in 3 days · run /login to renew`. Nécessite Claude Code v2.1.203 ou version ultérieure. Avant v2.1.217, l'avertissement apparaissait cinq jours avant.

153 209 

154Exécutez `/login` pour renouveler. L'avertissement est informatif et ne bloque jamais une requête : l'authentification continue de fonctionner jusqu'à ce que la connexion expire réellement. La durée de vie de la connexion elle-même est inchangée ; l'avertissement préalable est ce que v2.1.203 ajoute.210Exécutez `/login` pour renouveler. L'avertissement est informatif et ne bloque jamais une requête : l'authentification continue de fonctionner jusqu'à ce que la connexion expire réellement. La durée de vie de la connexion elle-même est inchangée ; l'avertissement préalable est ce que v2.1.203 ajoute.

155 211 

156Une fois que la connexion stockée expire et ne peut pas être actualisée, chaque requête échoue avec [`Login expired · Please run /login`](/docs/fr/errors#login-expired) jusqu'à ce que vous vous reconnectiez. Avant v2.1.206, une connexion expirée s'affichait comme une erreur de modèle à la place.212Une fois que la connexion stockée expire et ne peut pas être actualisée, chaque requête de modèle échoue avec [`Login expired · Please run /login`](/docs/fr/errors#login-expired) jusqu'à ce que vous vous reconnectiez. Avant v2.1.206, Claude Code signalait une connexion expirée sur les requêtes de modèle comme une erreur de modèle à la place.

213 

214Vous pouvez vérifier cet état avant qu'une requête échoue : [`/status`](/docs/fr/commands) affiche une ligne `Login` indiquant `Expired — log in again`, plus l'organisation et l'e-mail qu'il a enregistrés pour la connexion expirée. La ligne n'apparaît que lorsque la connexion claude.ai ou Claude Console enregistrée est l'identifiant actif. La ligne nécessite Claude Code v2.1.210 ou version ultérieure.

157 215 

158L'avertissement n'apparaît que lorsqu'une connexion claude.ai ou Claude Console est l'identifiant actif, et non lorsqu'un fournisseur cloud, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` fournit l'identifiant.216L'avertissement n'apparaît que lorsqu'une connexion claude.ai ou Claude Console est l'identifiant actif, et non lorsqu'un fournisseur cloud, `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN` ou `apiKeyHelper` fournit l'identifiant.

159 217 

1681. Identifiants du fournisseur cloud, lorsque `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` est défini. Consultez [intégrations tierces](/docs/fr/third-party-integrations) pour la configuration.2261. Identifiants du fournisseur cloud, lorsque `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` est défini. Consultez [intégrations tierces](/docs/fr/third-party-integrations) pour la configuration.

1692. Variable d'environnement `ANTHROPIC_AUTH_TOKEN`. Envoyée en tant qu'en-tête `Authorization: Bearer`. Utilisez ceci lors du routage via une [passerelle LLM ou proxy](/docs/fr/llm-gateway) qui s'authentifie avec des jetons porteurs plutôt que des clés API Anthropic.2272. Variable d'environnement `ANTHROPIC_AUTH_TOKEN`. Envoyée en tant qu'en-tête `Authorization: Bearer`. Utilisez ceci lors du routage via une [passerelle LLM ou proxy](/docs/fr/llm-gateway) qui s'authentifie avec des jetons porteurs plutôt que des clés API Anthropic.

1703. Variable d'environnement `ANTHROPIC_API_KEY`. Envoyée en tant qu'en-tête `X-Api-Key`. Utilisez ceci pour l'accès direct à l'API Anthropic avec une clé de la [Claude Console](https://platform.claude.com). En mode interactif, vous êtes invité une fois à approuver ou refuser la clé, et votre choix est mémorisé. Pour le modifier ultérieurement, utilisez le bouton bascule « Use custom API key » dans `/config`. Le bouton bascule n'apparaît que lorsque `ANTHROPIC_API_KEY` est défini dans votre environnement. En mode non interactif (`-p`), la clé est toujours utilisée lorsqu'elle est présente.2283. Variable d'environnement `ANTHROPIC_API_KEY`. Envoyée en tant qu'en-tête `X-Api-Key`. Utilisez ceci pour l'accès direct à l'API Anthropic avec une clé de la [Claude Console](https://platform.claude.com). En mode interactif, vous êtes invité une fois à approuver ou refuser la clé, et votre choix est mémorisé. Pour le modifier ultérieurement, utilisez le bouton bascule « Use custom API key » dans `/config`. Le bouton bascule n'apparaît que lorsque `ANTHROPIC_API_KEY` est défini dans votre environnement. En mode non interactif (`-p`), la clé est toujours utilisée lorsqu'elle est présente.

1714. Sortie du script [`apiKeyHelper`](/docs/fr/settings#available-settings). Utilisez ceci pour les identifiants dynamiques ou rotatifs, tels que les jetons de courte durée récupérés à partir d'un coffre-fort.2294. Sortie du script [`apiKeyHelper`](/docs/fr/settings-reference#apikeyhelper). Utilisez ceci pour les identifiants dynamiques ou rotatifs, tels que les jetons de courte durée récupérés à partir d'un coffre-fort.

1725. Variable d'environnement `CLAUDE_CODE_OAUTH_TOKEN`. Un jeton OAuth de longue durée généré par [`claude setup-token`](#generate-a-long-lived-token). Utilisez ceci pour les pipelines CI et les scripts où la connexion au navigateur n'est pas disponible.2305. Variable d'environnement `CLAUDE_CODE_OAUTH_TOKEN`. Un jeton OAuth de longue durée généré par [`claude setup-token`](#generate-a-long-lived-token). Utilisez ceci pour les pipelines CI et les scripts où la connexion au navigateur n'est pas disponible. Si vous exécutez `/login` alors que la variable est définie, Claude Code bascule la session actuelle vers la nouvelle connexion, mais relit la variable dans chaque nouvelle session jusqu'à ce que vous la supprimiez de votre profil shell ou du bloc `env` d'un [fichier de paramètres](/docs/fr/settings).

1736. Identifiants OAuth d'abonnement de `/login`. C'est la valeur par défaut pour les utilisateurs Claude Pro, Max, Team et Enterprise.2316. Identifiants de profil Anthropic et de fédération, les identifiants que la CLI `ant` et Workload Identity Federation utilisent. Un profil que `ant auth login` a écrit ne se classe ici que lorsque vous le nommez dans `ANTHROPIC_PROFILE` ; sinon, il se classe en dessous de `/login`. Consultez [Profils Anthropic et identifiants de fédération](#anthropic-profiles-and-federation-credentials).

2327. Identifiants OAuth d'abonnement de `/login`. C'est la valeur par défaut pour les utilisateurs Claude Pro, Max, Team et Enterprise.

174 233 

175Une session [passerelle d'applications Claude](/docs/fr/claude-apps-gateway) signée se situe en dehors de cette liste : c'est une sélection de fournisseur comme Amazon Bedrock ou Google Cloud's Agent Platform, et elle les surclasse. Lorsqu'une session de passerelle existe, la CLI s'authentifie avec le jeton de passerelle même si `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` est défini, et les entrées de jeton porteur, clé API et `apiKeyHelper` ci-dessus ne sont pas utilisées.234Une session [passerelle d'applications Claude](/docs/fr/claude-apps-gateway) signée se situe en dehors de cette liste : c'est une sélection de fournisseur comme Amazon Bedrock ou Google Cloud's Agent Platform, et elle les surclasse. Lorsqu'une session de passerelle existe, la CLI s'authentifie avec le jeton de passerelle même si `CLAUDE_CODE_USE_BEDROCK`, `CLAUDE_CODE_USE_VERTEX` ou `CLAUDE_CODE_USE_FOUNDRY` est défini, et les sources d'identifiants ci-dessus telles que le jeton porteur, la clé API, `apiKeyHelper` et les profils ne sont pas utilisés.

176 235 

177Si vous avez un abonnement Claude actif mais que vous avez également `ANTHROPIC_API_KEY` défini dans votre environnement, la clé API prend priorité une fois approuvée. Cela peut causer des échecs d'authentification si la clé appartient à une organisation désactivée ou expirée. Exécutez `unset ANTHROPIC_API_KEY` pour revenir à votre abonnement, et vérifiez `/status` pour confirmer quelle méthode est active. La ligne `Login method` affiche votre compte d'abonnement, et une ligne `API key` apparaît lorsqu'une clé API est en cours d'utilisation.236Si vous avez un abonnement Claude actif mais que vous avez également `ANTHROPIC_API_KEY` défini dans votre environnement, la clé API prend priorité une fois approuvée. Cela peut causer des échecs d'authentification si la clé appartient à une organisation désactivée ou expirée. Exécutez `unset ANTHROPIC_API_KEY` pour revenir à votre abonnement, et vérifiez `/status` pour confirmer quelle méthode est active. La ligne `Login method` affiche votre compte d'abonnement, et une ligne `API key` apparaît lorsqu'une clé API est en cours d'utilisation.

178 237 

179[Claude Code sur le Web](/docs/fr/claude-code-on-the-web) utilise toujours vos identifiants d'abonnement. Si vous définissez `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN` dans l'environnement sandbox, cela ne remplace pas vos identifiants d'abonnement.238[Claude Code sur le Web](/docs/fr/claude-code-on-the-web) utilise toujours vos identifiants d'abonnement. Si vous définissez `ANTHROPIC_API_KEY` ou `ANTHROPIC_AUTH_TOKEN` dans l'environnement sandbox, cela ne remplace pas vos identifiants d'abonnement.

180 239 

240<h4 id="anthropic-profiles-and-federation-credentials">

241 Profils Anthropic et identifiants de fédération

242</h4>

243 

244Un profil est un fichier de configuration d'identifiants nommé dans votre [répertoire de configuration Anthropic](https://platform.claude.com/docs/en/manage-claude/wif-reference#configuration-directory), par défaut `~/.config/anthropic` sur macOS et Linux ou `%APPDATA%\Anthropic` sur Windows. Le mode d'authentification d'un profil est `oidc_federation` lorsque vous le configurez pour [Workload Identity Federation (WIF)](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) ou `user_oauth` lorsque [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) l'a écrit ou que vous [vous êtes connecté à un compte Console sans clé API](#sign-in-without-an-api-key).

245 

246Claude Code ne lit pas les profils ou les variables de fédération en [mode bare](/docs/fr/headless#start-faster-with-bare-mode), dans Claude Desktop ou dans les sessions cloud. Dans ces sessions, `/status` n'affiche aucune ligne `Profile`.

247 

248Claude Code vérifie trois sources dans cet ordre et s'arrête à la première qui est définie. Le tableau montre ce qui définit chaque source et où elle se classe par rapport à votre identifiant `/login`.

249 

250| Source | Défini par | Rang par rapport à `/login` |

251| :---------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

252| Profil nommé | `ANTHROPIC_PROFILE` | Au-dessus, quel que soit le mode d'authentification du profil |

253| Variables de fédération | `ANTHROPIC_FEDERATION_RULE_ID` et `ANTHROPIC_ORGANIZATION_ID`, tous deux définis | Au-dessus |

254| Profil actif | Le fichier [`active_config`](https://platform.claude.com/docs/en/manage-claude/wif-reference#active-profile) dans votre répertoire de configuration, ou un profil nommé `default` | Au-dessus lorsque son mode d'authentification est `oidc_federation` ; en dessous d'un identifiant `/login` fonctionnant lorsque son mode d'authentification est `user_oauth` |

255 

256La règle `user_oauth` empêche un profil `ant auth login` résiduel de déplacer vos requêtes hors du compte auquel vous vous êtes connecté avec `/login`. Pour les variables de fédération, Claude Code lit également les autres variables dans la [référence WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#environment-variables), telles que `ANTHROPIC_IDENTITY_TOKEN_FILE`, lorsqu'il échange votre jeton d'identité. Pour le format du fichier de profil, consultez la [référence WIF](https://platform.claude.com/docs/en/manage-claude/wif-reference#profile-configuration-file).

257 

258Pour confirmer quelle source Claude Code a choisie, exécutez `/status` : une ligne `Profile` nomme la source à la place de la ligne `Login method`. Si vous démarrez Claude Code avec `--debug`, il écrit également une ligne `Using Anthropic profile auth` avec le nom de la source dans le journal de débogage à `~/.claude/debug/<session-id>.txt`. Lorsque Claude Code passe sur un profil actif `user_oauth` parce que vous avez un identifiant `/login` fonctionnant, il écrit un avertissement dans le journal de débogage indiquant qu'il utilise la connexion claude.ai à la place. Lorsque la connexion d'un profil `user_oauth` a expiré et que Claude Code ne peut pas la renouveler, les requêtes échouent avec [Anthropic profile login expired](/docs/fr/errors#anthropic-profile-login-expired).

259 

260Les fonctionnalités qui nécessitent votre connexion claude.ai, telles que [les connecteurs claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai) et [`/schedule`](/docs/fr/routines), ne sont pas disponibles lorsqu'une de ces sources est sélectionnée. Pour empêcher Claude Code de sélectionner une source :

261 

262* **Profil nommé ou variables de fédération** : désactivez `ANTHROPIC_PROFILE`, ou désactivez l'une des variables de fédération

263* **Profil actif** : exécutez `/logout` pour un profil `user_oauth` dont l'identifiant actuel vous avez écrit en [vous connectant à un compte Console sans clé API](#sign-in-without-an-api-key), exécutez `ant auth logout` pour un dont l'identifiant actuel `ant auth login` a écrit, ou supprimez le fichier du profil de `configs/` dans votre répertoire de configuration pour l'un ou l'autre mode d'authentification

264 

181<h3 id="generate-a-long-lived-token">265<h3 id="generate-a-long-lived-token">

182 Générer un jeton de longue durée266 Générer un jeton de longue durée

183</h3>267</h3>

188claude setup-token272claude setup-token

189```273```

190 274 

191La commande vous guide à travers l'autorisation OAuth et affiche un jeton dans le terminal. Elle ne sauvegarde le jeton nulle part ; copiez-le et définissez-le en tant que variable d'environnement `CLAUDE_CODE_OAUTH_TOKEN` partout où vous souhaitez vous authentifier :275La commande ouvre le même flux d'autorisation du navigateur que `/login`, et le jeton s'affiche dans le terminal après que vous ayez approuvé l'accès dans le navigateur. Il ne sauvegarde le jeton nulle part ; copiez-le et définissez-le en tant que variable d'environnement `CLAUDE_CODE_OAUTH_TOKEN` partout où vous souhaitez vous authentifier :

192 276 

193```bash theme={null}277```bash theme={null}

194export CLAUDE_CODE_OAUTH_TOKEN=your-token278export CLAUDE_CODE_OAUTH_TOKEN=your-token

195```279```

196 280 

197Ce jeton s'authentifie avec votre abonnement Claude et nécessite un plan Pro, Max, Team ou Enterprise. Il est limité à l'inférence uniquement et ne peut pas établir de sessions [Remote Control](/docs/fr/remote-control).281Ce jeton s'authentifie avec votre abonnement Claude et nécessite un plan Pro, Max, Team ou Enterprise. Il ne peut faire que des requêtes de modèle, il ne peut donc pas établir de sessions [Remote Control](/docs/fr/remote-control) ou récupérer [les connecteurs claude.ai](/docs/fr/mcp#use-mcp-servers-from-claude-ai). Les serveurs MCP que vous configurez localement fonctionnent toujours.

198 282 

199[Le mode bare](/docs/fr/headless#start-faster-with-bare-mode) ne lit pas `CLAUDE_CODE_OAUTH_TOKEN`. Si votre script passe `--bare`, authentifiez-vous avec `ANTHROPIC_API_KEY` ou un `apiKeyHelper` à la place.283[Le mode bare](/docs/fr/headless#start-faster-with-bare-mode) ne lit pas `CLAUDE_CODE_OAUTH_TOKEN`. Si votre script passe `--bare`, authentifiez-vous avec `ANTHROPIC_API_KEY` ou un `apiKeyHelper` à la place.