Espaces de travail

Les espaces de travail offrent un moyen d'organiser votre utilisation de l'API au sein d'une organisation. Utilisez les espaces de travail pour séparer différents projets, environnements ou équipes tout en conservant une facturation et une administration centralisées.

Fonctionnement des espaces de travail

Chaque organisation dispose d'un Default Workspace (espace de travail par défaut) qui ne peut pas être renommé, archivé ni supprimé. Lorsque vous créez des espaces de travail supplémentaires, vous pouvez attribuer des clés API, des membres et des limites de ressources à chacun d'eux.

Caractéristiques principales :

• Les identifiants d'espace de travail utilisent le préfixe wrkspc_ (par exemple, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
• Maximum de 100 espaces de travail par organisation (les espaces de travail archivés ne sont pas comptabilisés)
• Le Default Workspace n'a pas d'ID et n'apparaît pas dans les points de terminaison de liste
• Les clés API sont limitées à un seul espace de travail et ne peuvent accéder qu'aux ressources de cet espace de travail

Espace de travail Claude Code

Lorsqu'un membre de votre organisation se connecte pour la première fois à Claude Code avec son compte Claude Console, Anthropic crée automatiquement un espace de travail Claude Code dans l'organisation et y ajoute ce membre. Chaque membre suivant qui se connecte à Claude Code est ajouté de la même manière.

L'espace de travail Claude Code sépare le trafic Claude Code de vos autres charges de travail API :

• Claude Code génère une clé API par utilisateur dans cet espace de travail lors de la connexion. Vous ne pouvez pas y créer de clés manuellement depuis la Console.
• Une clé Claude Code cesse de fonctionner si son propriétaire est retiré de l'espace de travail ou de l'organisation, contrairement aux clés d'espace de travail standard.
• L'utilisation de Claude Code est soumise à des limites de débit distinctes, et les administrateurs peuvent plafonner sa part des limites de l'organisation dans Settings > Workspaces.
• C'est le seul espace de travail qui prend en charge les limites de dépenses mensuelles par utilisateur.

Rôles et autorisations des espaces de travail

Les membres peuvent avoir des rôles différents dans chaque espace de travail, ce qui permet un contrôle d'accès granulaire.

Héritage des rôles

• Les administrateurs de l'organisation reçoivent automatiquement l'accès Workspace Admin à tous les espaces de travail
• Les membres de facturation de l'organisation reçoivent automatiquement l'accès Workspace Billing à tous les espaces de travail
• Les utilisateurs et développeurs de l'organisation doivent être explicitement ajoutés à chaque espace de travail

Gestion des espaces de travail

Utilisation de la Console

Créez et gérez des espaces de travail dans la Claude Console.

Créer un espace de travail

Modifier les détails d'un espace de travail

Pour modifier le nom ou la couleur d'un espace de travail :

1. Sélectionnez l'espace de travail dans la liste
2. Cliquez sur le menu à points de suspension (...) et choisissez Edit details
3. Mettez à jour le nom ou la couleur et enregistrez vos modifications

Ajouter des membres à un espace de travail

1. Accédez à l'onglet Members de l'espace de travail
2. Cliquez sur Add to Workspace
3. Sélectionnez un membre de l'organisation et attribuez-lui un rôle d'espace de travail
4. Confirmez l'ajout

Pour retirer un membre, cliquez sur l'icône de corbeille à côté de son nom.

Définir les limites d'un espace de travail

Dans l'onglet Limits, vous pouvez configurer :

• Limites de débit : définissez des limites par niveau de modèle pour les requêtes par minute, les tokens d'entrée ou les tokens de sortie
• Notifications de dépenses : configurez des alertes lorsque les dépenses atteignent certains seuils

Archiver un espace de travail

Pour archiver un espace de travail, cliquez sur le menu à points de suspension (...) et sélectionnez Archive. L'archivage :

• Préserve les données historiques pour les rapports
• Désactive l'espace de travail et toutes les clés API associées
• Ne peut pas être annulé

Utilisation de l'Admin API

Gérez les espaces de travail par programmation à l'aide de l'Admin API.

# Créer un espace de travail
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# Lister les espaces de travail
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Archiver un espace de travail
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Pour obtenir les détails complets des paramètres et les schémas de réponse, consultez la référence de l'API Workspaces.

Gestion des membres d'un espace de travail

Ajoutez, mettez à jour ou retirez des membres d'un espace de travail :

# Ajouter un membre à un espace de travail
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# Mettre à jour le rôle d'un membre
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"workspace_role": "workspace_admin"}'

# Supprimer un membre d'un espace de travail
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Pour obtenir les détails complets des paramètres, consultez la référence de l'API Workspace Members.

Clés API et portée des ressources

Les clés API sont limitées à un espace de travail spécifique. Lorsque vous créez une clé API dans un espace de travail, elle ne peut accéder qu'aux ressources de cet espace de travail.

Les ressources limitées aux espaces de travail incluent :

• Les fichiers créés via l'API Files
• Les lots de messages créés via l'API Batch
• Les compétences créées via l'API Skills

Certaines ressources sont gérées au niveau de l'organisation et ne peuvent pas être gérées avec une clé API d'espace de travail :

• Les tunnels MCP sont gérés avec un jeton OAuth à portée organisationnelle (org:manage_tunnels) obtenu via Workload Identity Federation, et non avec une clé API d'espace de travail, et le plafond de 10 tunnels actifs s'applique à l'ensemble de l'organisation. La gestion des tunnels nécessite un rôle disposant des autorisations de gestion des tunnels ; les développeurs de l'organisation peuvent les consulter mais pas les modifier. Les tunnels sont créés dans un espace de travail, et la liste MCP tunnels de la Console ainsi que le sélecteur de serveur Managed Agent n'affichent que les tunnels de l'espace de travail actuel.
• Les espaces de travail eux-mêmes et les membres de l'organisation sont gérés via l'Admin API, qui nécessite une clé Admin API.

Limites des espaces de travail

Vous pouvez définir des limites de dépenses et de débit personnalisées pour chaque espace de travail afin de vous protéger contre la surutilisation et d'assurer une répartition équitable des ressources.

Définition des limites d'espace de travail

Les limites d'espace de travail peuvent être définies à un niveau inférieur (mais pas supérieur) aux limites de votre organisation :

• Limites de dépenses : plafonnez les dépenses mensuelles d'un espace de travail
• Limites de débit : limitez les requêtes par minute, les tokens d'entrée par minute ou les tokens de sortie par minute

Pour des informations détaillées sur les limites de débit et leur fonctionnement, consultez Limites de débit. Vous pouvez également lire par programmation vos limites de débit actuelles au niveau de l'organisation et de l'espace de travail avec l'API Rate Limits.

Suivi de l'utilisation et des coûts

Suivez l'utilisation et les coûts par espace de travail à l'aide de l'API Usage and Cost :

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
group_by[]=workspace_id&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

L'utilisation et les coûts attribués au Default Workspace ont une valeur null pour workspace_id.

Cas d'utilisation courants

Séparation des environnements

Créez des espaces de travail distincts pour le développement, la préproduction et la production :

Isolation par équipe ou département

Attribuez des espaces de travail à différentes équipes pour l'allocation des coûts et le contrôle d'accès :

• Équipe d'ingénierie avec accès développeur
• Équipe de science des données avec ses propres clés API
• Équipe de support avec un accès limité pour les outils clients

Organisation par projet

Créez des espaces de travail pour des projets ou produits spécifiques afin de suivre l'utilisation et les coûts séparément.

Bonnes pratiques

FAQ

Voir aussi

• Admin API
• Référence de l'Admin API
• Limites de débit
• API Usage and Cost