Créer une clé API Admin
Créez une clé API Admin pour votre organisation Claude Console ou Claude Enterprise.
Une clé API Admin authentifie chaque API de la section Administration de ce guide : l’Admin API, les API d’analytique, la Compliance API, l’API Plugins, l’API Claude Tag, l’API Spend Limits, l’API Usage and Cost Analytics, l’API d’utilisation et de coûts et l’API des limites de débit. Vous n’avez pas besoin d’une clé distincte pour chaque API. La seule exception concerne les points de terminaison des comptes de service, des émetteurs de fédération et des règles de fédération de l’Admin API, qui n’acceptent qu’un jeton bearer OAuth avec la portée org:admin. Consultez Obtenir un jeton bearer OAuth.
L’endroit où vous créez la clé dépend du produit Claude utilisé par votre organisation.
De quelle clé avez-vous besoin ?
| Votre organisation | Créez la clé dans | Préfixe de la clé | Qui peut la créer | Fonctionne avec |
|---|---|---|---|---|
Claude Console (Claude Platform, platform.claude.com) | Page Clés d’administration (platform.claude.com/settings/admin-keys) dans la Claude Console | sk-ant-admin01-... | Les membres de l’organisation ayant le rôle admin | Admin API, API Usage and Cost Analytics, API d’utilisation et de coûts, API des limites de débit, API Claude Code Analytics et le flux d’activité de la Compliance API |
Claude Enterprise (claude.ai) | claude.ai > Paramètres de l’organisation > API | sk-ant-api01-... | Le Propriétaire principal de l’organisation parente (toutes les organisations liées). Un propriétaire d’organisation peut en créer une portant uniquement les portées de la Compliance API, restreinte à sa propre organisation | Gestion des utilisateurs (les points de terminaison des membres, des invitations et des groupes de l’Admin API), API Plugins, API Claude Tag, Compliance API, Claude Enterprise Analytics API, API Usage and Cost Analytics et API Spend Limits, selon les portées que vous sélectionnez |
Une clé créée dans une organisation ne peut pas être utilisée pour gérer une autre organisation. Si votre entreprise utilise à la fois Claude Console et Claude Enterprise, créez une clé dans chacune.
Créer une clé pour une organisation Claude Console
Connectez-vous en tant qu’administrateur de l’organisation
Seuls les membres de l’organisation ayant le rôle admin peuvent créer des clés API Admin. Consultez Rôles et permissions de l’organisation.
Ouvrez les paramètres Clés d’administration
Dans la Claude Console, accédez à la page Clés d’administration (
platform.claude.com/settings/admin-keys).Créez la clé
Cliquez sur Créer une clé d’administration, donnez-lui un nom, sélectionnez une expiration de clé, puis cliquez sur Ajouter. Les clés de la Claude Console n’ont pas de portées sélectionnables ; chaque clé dispose d’un accès complet à tous les points de terminaison qui acceptent les clés Admin API (les points de terminaison relatifs aux comptes de service et à la fédération mentionnés en haut de cette page n’acceptent pas les clés Admin API).
Copiez et stockez le secret
Copiez le secret affiché (commençant par
sk-ant-admin01-) et stockez-le dans votre gestionnaire de secrets. Le secret complet n’est affiché qu’une seule fois.
Créer une clé pour une organisation Claude Enterprise
Connectez-vous en tant que propriétaire principal ou propriétaire d’organisation
Le propriétaire principal de l’organisation parente Claude Enterprise peut créer une clé pouvant accéder à chaque organisation liée, ou une clé restreinte à une seule organisation. Un propriétaire d’organisation peut créer une clé portant uniquement les portées de la Compliance API, restreinte à sa propre organisation.
Ouvrez les paramètres API
Accédez à claude.ai > Paramètres de l’organisation > API et trouvez la section Clés.
Cliquez sur + Créer une clé
Nommez la clé et sélectionnez les portées dont vous avez besoin dans le tableau des portées. Le propriétaire principal peut combiner des portées de différentes API (par exemple,
read:analyticsetread:spend_limits) sur une seule clé.Copiez et stockez le secret
Copiez le secret affiché (commençant par
sk-ant-api01-) et stockez-le dans votre gestionnaire de secrets. Le secret complet n’est affiché qu’une seule fois.
Choisir les portées pour une clé Claude Enterprise
Lorsque vous créez une clé Claude Enterprise, sélectionnez chaque portée requise par les API que vous prévoyez d’appeler. Les portées sont fixées à la création ; pour ajouter une portée ultérieurement, créez une nouvelle clé.
| Pour appeler... | Sélectionnez ces portées |
|---|---|
| Gestion des utilisateurs de l’Admin API : lister et rechercher les membres et les invitations ; lire les rôles personnalisés et leurs permissions | read:members |
Gestion des utilisateurs de l’Admin API : modifier les rôles des membres, supprimer des membres, déconnecter des membres partout (bêta), créer et retirer des invitations (pour attribuer le rôle managed lors d’un changement de rôle ou d’une invitation, sélectionnez également write:rbac_groups) | write:members |
| Gestion des utilisateurs de l’Admin API : lire les groupes et leurs membres | read:rbac_groups |
Gestion des utilisateurs de l’Admin API : créer, renommer et supprimer des groupes ; ajouter et retirer des membres de groupes ; avec write:members, attribuer le rôle managed (lors d’une invitation ou d’un changement de rôle) ou attribuer des groupes lors d’une invitation | write:rbac_groups |
| API Plugins : lire les plugins, les versions, les paramètres d’installation, les partages et les marketplaces ; télécharger les fichiers de plugins, y compris les fichiers des plugins personnels des membres ; valider une marketplace avant de la connecter | read:plugins |
API Plugins : téléverser des plugins et des versions ; choisir la version servie aux membres ; supprimer des plugins, y compris les plugins personnels des membres ; définir et supprimer des paramètres d’installation ; définir le paramètre d’installation par défaut d’une marketplace ; valider une marketplace avant de la connecter (pour lire les plugins, sélectionnez également read:plugins) | write:plugins |
| API Claude Tag : lire les paramètres de Claude Tag sur les canaux Slack et les espaces de travail Slack ; lister les packs d’accès et l’endroit où ils sont attachés (aucune autre portée ne donne accès à l’API Claude Tag) | read:claude_tag |
API Claude Tag : configurer et supprimer des canaux ; modifier des paramètres ; attacher et détacher des packs d’accès (pour lire aussi, sélectionnez également read:claude_tag) | write:claude_tag |
| API Spend Limits : lire les limites de dépenses effectives des membres et les demandes d’augmentation | read:spend_limits |
| API Spend Limits : définir ou effacer les limites de dépenses par utilisateur ; approuver ou refuser les demandes d’augmentation | write:spend_limits |
| Claude Enterprise Analytics API : rapports d’engagement, d’adoption, de coût et d’utilisation ; API Usage and Cost Analytics : rapports d’utilisation des tokens et de coûts | read:analytics |
| Flux d’activité de la Compliance API : événements d’activité à l’échelle de l’organisation | read:compliance_activities |
| Points de terminaison des chats, fichiers et projets de la Compliance API et points de terminaison des sessions de la Compliance API : lire les chats, fichiers, projets, transcriptions de session et utilisateurs de l’organisation | read:compliance_user_data |
| Points de terminaison des chats, fichiers et projets de la Compliance API : supprimer les chats, fichiers et projets | delete:compliance_user_data |
Points de terminaison d’organisation de la Compliance API : lire les métadonnées de l’organisation et les paramètres effectifs ; API Plugins : chaque point de terminaison GET, y compris les téléchargements de fichiers | read:compliance_org_data |
Points de terminaison de lecture de la gestion des utilisateurs de l’Admin API, chaque point de terminaison de lecture de la Compliance API et chaque point de terminaison GET de la Plugins API, y compris les téléchargements de fichiers, avec une seule portée en lecture seule (pour les intégrations d’audit de sécurité ; n’inclut pas les API Spend Limits ou Analytics) | read:org_audit |
Les Compliance et Analytics APIs doivent être activées pour votre organisation avant que les clés portant ces portées puissent être utilisées. Consultez Configurer la Compliance API et Obtenir l’accès à la Claude Enterprise Analytics API.
Vous ne pouvez créer et utiliser des clés avec read:plugins ou write:plugins que si votre organisation peut utiliser la Plugins API. Le guide de l’API Plugins indique quelles organisations peuvent l’utiliser. Dans ces organisations, les clés avec read:org_audit ou read:compliance_org_data peuvent également appeler les points de terminaison de lecture de la Plugins API, y compris les téléchargements de fichiers, mais pas la validation de marketplace. Les portées read:plugins et write:plugins n’agissent que sur l’organisation dans laquelle la clé a été créée. Consultez Portées de la Plugins API et Lire une autre organisation sous le même parent.
Utiliser la clé
Transmettez la clé dans l’en-tête x-api-key à chaque requête. Consultez la documentation de chaque API pour des exemples de requêtes complets.
Un appel qui dépasse les portées de la clé renvoie 403 Forbidden avec un message listant les portées dont dispose la clé et les portées dont l’endpoint a besoin.
Prochaines étapes
Gérez les membres de l’organisation, les espaces de travail et les clés API.
Définissez des limites de dépenses par membre et examinez les demandes d’augmentation pour votre organisation Claude Enterprise.
Établissez des rapports sur la productivité de Claude Code ou sur l’engagement et l’adoption de Claude Enterprise.
Auditez l’activité et récupérez ou supprimez le contenu des utilisateurs dans toute votre organisation.
Cette page vous a-t-elle été utile ?