Chaque API de la section Admin de ce guide (l'Admin API, les Analytics APIs, la Compliance API, la Spend Limits API, l'Usage and Cost API et la Rate Limits API) est authentifiée à l'aide d'une clé Admin API. Vous n'avez pas besoin d'une clé distincte pour chaque API.
L'emplacement où vous créez la clé dépend du produit Claude utilisé par votre organisation.
| Votre organisation | Créer la clé dans | Préfixe de la clé | Qui peut la créer | Fonctionne avec |
|---|---|---|---|---|
Claude Console (Claude Platform, platform.claude.com) | Claude Console > Settings > Admin keys | sk-ant-admin01-... | Les membres de l'organisation ayant le rôle admin | Admin API, Usage and Cost API, Rate Limits API, Claude Code Analytics API et le flux d'activité de la Compliance API |
Claude Enterprise (claude.ai) | claude.ai > Organization settings > API | sk-ant-api01-... | Le propriétaire principal de l'organisation | Compliance API, Claude Enterprise Analytics API et Spend Limits API, 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 d'elles.
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 Admin API. Consultez Rôles et autorisations de l'organisation.
Ouvrez les paramètres des clés Admin
Accédez à Claude Console > Settings > Admin keys.
Créez la clé
Cliquez sur Create key, donnez-lui un nom, puis cliquez sur Create. Les clés Claude Console n'ont pas de portées sélectionnables ; chaque clé dispose d'un accès complet à l'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.
Connectez-vous en tant que propriétaire principal
Seul le propriétaire principal de l'organisation parente Claude Enterprise peut créer ces clés.
Ouvrez les paramètres de l'API
Accédez à claude.ai > Organization settings > API et repérez la section Keys.
Cliquez sur + Create key
Nommez la clé et sélectionnez les portées dont vous avez besoin dans le tableau des portées. Vous pouvez combiner des portées de différentes API (par exemple, read:analytics et read: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.
Lorsque vous créez une clé Claude Enterprise, sélectionnez toutes les portées requises 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 |
|---|---|
| Spend Limits API : lire les limites de dépenses effectives des membres et les demandes d'augmentation | read:spend_limits |
| Spend Limits API : 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ûts et d'utilisation | read:analytics |
| Flux d'activité de la Compliance API : événements d'activité à l'échelle de l'organisation | read:compliance_activities |
| Points de terminaison de contenu de la Compliance API : lire les conversations, fichiers, projets et utilisateurs | read:compliance_user_data |
| Points de terminaison de contenu de la Compliance API : supprimer les conversations, fichiers et projets | delete:compliance_user_data |
| Points de terminaison d'organisation de la Compliance API : lire les métadonnées et paramètres de l'organisation | read:compliance_org_data, read:compliance_org_settings |
Les API Compliance et Analytics doivent être activées pour votre organisation avant que les clés dotées de ces portées puissent être utilisées. Consultez Obtenir l'accès à la Compliance API et Analytics APIs.
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 requises par le point de terminaison.
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.
Générez 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 l'ensemble de votre organisation.
Was this page helpful?