Authentification

L'API Claude prend en charge trois façons d'authentifier les requêtes :

Les clés API et Workload Identity Federation accordent le même accès aux points de terminaison de l'API Claude. Choisissez les clés API pour démarrer rapidement : une clé personnelle pour votre propre développement, ou une clé de compte de service pour tout ce qui est partagé. Passez à Workload Identity Federation lorsque votre charge de travail dispose déjà d'une identité émise par la plateforme que vous pouvez fédérer. Utilisez App Attest pour les applications iOS et macOS que vous distribuez aux utilisateurs finaux.

Clés API

Les clés API sont des secrets statiques que vous générez dans la Claude Console et envoyez à chaque requête comme jeton bearer dans l'en-tête Authorization.

Types de clés

Lorsque vous créez une clé, vous choisissez son type, qui détermine ce que la clé peut faire, où elle fonctionne et quand elle cesse de fonctionner :

Les clés personnelles et les clés de compte de service sont adossées à une identité : chacune appartient à un utilisateur ou à un compte de service que votre organisation gère déjà, et chaque requête agit en tant que cette identité. Lorsque cette identité est retirée de l'organisation, la clé cesse de fonctionner. Ainsi, les clés ne survivent pas accidentellement aux personnes ou aux charges de travail qui les possèdent. Privilégiez-les par rapport aux clés d'espace de travail pour les nouvelles intégrations.

Utilisez une clé personnelle pour votre propre développement et vos scripts. Une clé personnelle partagée agit comme une seule personne et cesse de fonctionner lorsqu'elle part. Pour les charges de travail partagées ou automatisées (CI, services de production), demandez à un administrateur de l'organisation de créer un compte de service afin que la charge de travail dispose de sa propre identité.

Les clés API d'espace de travail fonctionnent toujours mais doivent être considérées comme héritées ; les clés adossées à une identité ou Workload Identity Federation sont préférées. Pour migrer, consultez Remplacer les clés API d'espace de travail.

Créer et utiliser une clé

• Créer une clé : Dans la Claude Console, accédez à la page Clés API (platform.claude.com/settings/keys) et cliquez sur Create key. Nommez la clé et sélectionnez une expiration. Définissez Linked account sur vous-même pour une clé personnelle, ou sur un compte de service pour une clé partagée entre plusieurs utilisateurs. Vous pouvez également limiter la clé à un espace de travail spécifique, ce qui vous évite de définir manuellement un ID d'espace de travail dans les requêtes futures.
• Utiliser la clé : Envoyez-la sous la forme Authorization: Bearer <key> dans les requêtes HTTP directes, ou définissez la variable d'environnement ANTHROPIC_API_KEY et le SDK client la récupère automatiquement.

POST /v1/messages
Authorization: Bearer YOUR_API_KEY
anthropic-version: 2023-06-01
content-type: application/json

L'en-tête hérité x-api-key: YOUR_API_KEY est toujours pris en charge à la place de Authorization.

Stockez les clés API dans un gestionnaire de secrets, effectuez-en la rotation périodiquement, et désactivez ou supprimez toute clé que vous soupçonnez d'avoir fuité. Sur la page Clés API de la Claude Console, Disable est réversible (l'Admin API indique le status de la clé comme "inactive", et Re-enable le rétablit à "active"), tandis que Delete est définitif : la clé est archivée et apparaît toujours dans List API Keys avec status: "archived". Les clés expirées peuvent uniquement être supprimées. Vous pouvez également définir une expiration lors de la création d'une clé pour limiter la durée pendant laquelle un identifiant ayant fuité reste utilisable.

client = Anthropic(api_key="my-anthropic-api-key")
# ou, avec ANTHROPIC_API_KEY défini dans l'environnement :
client = Anthropic()

Sélectionner un espace de travail

Les clés API créées pour un espace de travail spécifique ne fonctionnent que dans cet espace de travail, et les requêtes API utilisant ces clés peuvent omettre l'ID de l'espace de travail.

Si votre clé API n'est pas limitée à un espace de travail, vous devez spécifier l'ID de l'espace de travail dans l'en-tête anthropic-workspace-id pour chaque requête. Consultez l'exemple suivant pour savoir comment définir cet en-tête dans une requête ou dans le SDK.

L'Admin API accepte une clé personnelle ou une clé de compte de service uniquement si la clé n'est pas limitée à un espace de travail spécifique.

Vous pouvez trouver l'ID d'un espace de travail dans la colonne ID de la page Espaces de travail (platform.claude.com/settings/workspaces) de la Claude Console, ou en appelant le point de terminaison List Workspaces. List Workspaces inclut l'espace de travail par défaut uniquement lorsque vous passez include_default=true ; son ID figure également dans l'en-tête de réponse anthropic-workspace-id de toute requête qui s'y exécute.

client = Anthropic()  # reads ANTHROPIC_API_KEY

# Requis pour chaque requête avec une clé qui n'est pas limitée à un espace de travail.
# Omettez extra_headers pour une clé limitée à un seul espace de travail.
message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    extra_headers={"anthropic-workspace-id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"},
)
print(message.content)

# Ou définissez-le une fois pour chaque requête de ce client :
workspace_client = Anthropic(
    default_headers={"anthropic-workspace-id": "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"},
)

Si une requête effectuée avec une clé qui n'est pas limitée à un espace de travail omet l'en-tête, l'API renvoie une erreur 400 invalid_request_error :

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "This API key is not scoped to a workspace, so this request must include the anthropic-workspace-id header with the ID of the workspace to use. Add the header, or use an API key that is scoped to a workspace."
  },
  "request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}

Une valeur d'en-tête qui n'est pas un ID d'espace de travail valide renvoie une erreur 400 invalid_request_error avec le message anthropic-workspace-id header must be a valid workspace ID. Si l'espace de travail n'existe pas, ou si l'utilisateur ou le compte de service de la clé n'y a pas accès, l'API renvoie une erreur 404 not_found_error avec le message Workspace `<id>` not found., la même réponse que pour tout espace de travail inconnu.

Workload Identity Federation sélectionne plutôt un espace de travail lors de l'échange de jetons ; consultez la référence WIF pour plus de détails.

Expiration des clés

Lorsque vous créez une clé API depuis la page Clés API de la Claude Console, vous choisissez une expiration : une valeur prédéfinie (3 heures, 1 jour, 7 jours ou 30 jours), une durée personnalisée, ou Never pour les clés que vous stockez dans un gestionnaire de secrets et dont vous effectuez vous-même la rotation. Si votre organisation applique une politique d'expiration maximale, la Console limite les valeurs prédéfinies et les durées personnalisées au maximum de la politique, et Never n'est pas disponible. Les clés existantes conservent leur comportement actuel ; l'expiration est définie au moment de la création et ne peut pas être modifiée par la suite. Le même choix d'expiration s'applique lorsque vous créez une clé Admin API dans la Claude Console.

Anthropic envoie un e-mail au créateur de la clé à l'approche de l'expiration : 7 jours avant l'expiration pour les clés créées avec une durée de vie d'au moins 14 jours, et 1 jour avant pour les clés avec une durée de vie d'au moins 7 jours. Les clés avec des durées de vie plus courtes expirent sans e-mail d'avertissement.

Après l'expiration d'une clé, les requêtes effectuées avec elle renvoient une erreur 401 authentication_error. Créez une nouvelle clé pour restaurer l'accès ; les clés expirées ne peuvent pas être réactivées.

Le tableau des clés API de la Console affiche l'expiration de chaque clé, et l'Admin API indique l'horodatage expires_at de chaque clé sur les points de terminaison List API Keys et Retrieve API Key, afin que vous puissiez auditer les clés et effectuer leur rotation avant leur expiration. Le champ vaut null pour les clés sans expiration.

L'expiration limite la durée de vie d'un identifiant ayant fuité, mais elle ne remplace pas une bonne hygiène des secrets. Quelle que soit l'expiration, stockez les clés dans un gestionnaire de secrets et désactivez ou supprimez toute clé que vous soupçonnez d'avoir fuité.

Remplacer les clés API d'espace de travail

Si vous avez une clé d'espace de travail, vous pouvez vouloir la remplacer par Workload Identity Federation ou par une clé personnelle ou de compte de service. Cela offre une meilleure sécurité et une meilleure observabilité.

Consultez la référence WIF pour plus de détails sur la configuration de Workload Identity Federation, qui est préférable aux clés de longue durée.

Pour remplacer une clé d'espace de travail par une clé personnelle ou de compte de service :

1. Décidez du type de clé. Votre propre outillage doit utiliser une clé personnelle. Une charge de travail partagée ou sans surveillance doit utiliser une clé de compte de service.
2. Créez un compte de service si nécessaire. Vous devrez peut-être demander à un administrateur de l'organisation d'en créer un sur la page Service accounts (platform.claude.com/settings/service-accounts) de la Claude Console et de l'ajouter à l'espace de travail concerné.
3. Créez la nouvelle clé. Créez-la spécifiquement pour l'espace de travail de l'intégration, sauf si l'intégration nécessite plusieurs espaces de travail.
4. Déployez la nouvelle clé. Remplacez l'ancienne clé partout où l'intégration la lit, généralement la variable d'environnement ANTHROPIC_API_KEY ou une entrée du gestionnaire de secrets. Pour une clé non limitée à un espace de travail, envoyez également l'en-tête anthropic-workspace-id comme indiqué dans Sélectionner un espace de travail.
5. Supprimez l'ancienne clé. Vérifiez que les requêtes aboutissent, puis supprimez la clé d'espace de travail sur la page des clés API de la Claude Console.

Workload Identity Federation

Workload Identity Federation (WIF) permet à une charge de travail de s'authentifier avec un jeton d'identité de courte durée émis par un fournisseur d'identité (IdP) auquel vous faites déjà confiance. Ces IdP incluent AWS IAM, Google Cloud et tout émetteur OIDC conforme aux normes (comme GitHub Actions, les comptes de service Kubernetes, SPIFFE, Microsoft Entra ID ou Okta). La charge de travail échange son JWT émis par l'IdP sur POST /v1/oauth/token contre un jeton d'accès de courte durée à l'API Claude, et le SDK actualise automatiquement ce jeton avant son expiration. Il n'y a aucune chaîne sk-ant-api... à générer, distribuer ou renouveler.

La fédération supprime les clés API Claude de longue durée de votre environnement, ce qui limite les dommages qu'un identifiant ayant fuité peut causer et vous permet de gérer l'accès avec les mêmes contrôles d'IdP que vous utilisez déjà pour les ressources cloud. Elle ne garantit pas, à elle seule, une sécurité de bout en bout : la chaîne de confiance n'est pas plus solide que la configuration de votre fournisseur d'identité, et un secret de longue durée situé une étape plus tôt dans cette chaîne (par exemple, un identifiant cloud statique capable de générer des jetons d'IdP) peut encore la compromettre. Associez la fédération aux contrôles de votre fournisseur, tels que les listes d'adresses IP autorisées, la MFA et la journalisation d'audit.

Pour configurer la fédération, vous créez trois ressources dans la Claude Console (un compte de service, un émetteur de fédération et une règle de fédération), puis vous pointez votre SDK vers la règle. Consultez Workload Identity Federation pour le guide de configuration complet.

App Attest

App Attest authentifie les applications iOS et macOS qui appellent l'API Claude directement depuis l'appareil. Chaque installation prouve qu'il s'agit d'une build authentique et non modifiée d'une application que vous avez enregistrée dans la Claude Console, à l'aide du service App Attest d'Apple. Anthropic émet ensuite pour l'appareil un jeton d'accès de courte durée qui facture l'utilisation à votre espace de travail. Les jetons sont limités à votre espace de travail, expirent après 1 heure et n'autorisent que les appels à la Messages API.

Pour enregistrer votre application et obtenir un ID client, consultez App Attest pour les applications iOS et macOS.

Étapes suivantes