Les « workspaces » (espaces de travail) offrent un moyen d'organiser votre utilisation de l'API au sein d'une organisation. Utilisez les workspaces pour séparer différents projets, environnements ou équipes tout en maintenant une facturation et une administration centralisées.
Chaque organisation dispose d'un Workspace par défaut qui ne peut pas être renommé, archivé ou supprimé. Lorsque vous créez des workspaces supplémentaires, vous pouvez attribuer des clés API, des membres et des limites de ressources à chacun d'eux.
Caractéristiques principales :
wrkspc_ (par exemple, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)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 workspace 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.
Le workspace Claude Code maintient le trafic de Claude Code séparé de vos autres charges de travail API :
L'archivage du workspace Claude Code désactive la connexion à Claude Code via la facturation Console pour toute l'organisation.
Les membres peuvent avoir des rôles différents dans chaque workspace, ce qui permet un contrôle d'accès précis.
| Rôle | Autorisations |
|---|---|
| Workspace User | Utiliser uniquement l'Anthropic Workbench |
| Workspace Limited Developer | Créer et gérer des clés API, utiliser l'API. Ne peut pas accéder aux vues de traçage de session ni télécharger des fichiers. |
| Workspace Developer | Créer et gérer des clés API, utiliser l'API |
| Workspace Admin | Contrôle total sur les paramètres et les membres du workspace |
| Workspace Billing | Consulter les informations de facturation du workspace (hérité du rôle de facturation de l'organisation) |
Le rôle Workspace Billing ne peut pas être attribué manuellement. Il est hérité du fait de détenir le rôle de facturation de l'organisation.
Seuls les administrateurs de l'organisation peuvent créer des workspaces. Les utilisateurs et développeurs de l'organisation doivent être ajoutés aux workspaces par un administrateur.
Créez et gérez des workspaces dans la Claude Console.
Ouvrir les paramètres du workspace
Dans la Claude Console, accédez à Settings > Workspaces.
Créer un workspace
Cliquez sur Create workspace.
Configurer le workspace
Saisissez un nom de workspace et sélectionnez une couleur pour l'identification visuelle.
Créer le workspace
Cliquez sur Create pour finaliser.
Pour basculer entre les workspaces dans la Console, utilisez le sélecteur Workspaces dans le coin supérieur gauche.
Pour modifier le nom ou la couleur d'un workspace :
Le Workspace par défaut ne peut pas être renommé ou supprimé.
Pour retirer un membre, cliquez sur l'icône de corbeille à côté de son nom.
Les administrateurs et les membres de facturation de l'organisation ne peuvent pas être retirés des workspaces tant qu'ils détiennent ces rôles d'organisation.
Dans l'onglet Limits, vous pouvez configurer :
Pour archiver un workspace, cliquez sur le menu à points de suspension (...) et sélectionnez Archive. L'archivage :
L'archivage d'un workspace révoque immédiatement toutes les clés API de ce workspace. Cette action ne peut pas être annulée. Si vous archivez le workspace Claude Code, les membres de votre organisation ne peuvent plus se connecter à Claude Code via la facturation Console.
Gérez les workspaces par programmation à l'aide de l'Admin API.
Les points de terminaison de l'Admin API nécessitent une clé Admin API (commençant par sk-ant-admin...) qui diffère des clés API standard. Consultez Créer une clé Admin API pour savoir comment en provisionner une.
# Créer un espace de travail
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-d '{"name": "Production"}'
# Lister les espaces de travail
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
# Archiver un espace de travail
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"Pour les détails complets des paramètres et les schémas de réponse, consultez la référence de l'API Workspaces.
Ajoutez, mettez à jour ou retirez des membres d'un workspace :
# Ajouter un membre à un espace de travail
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-d '{
"user_id": "user_xxx",
"workspace_role": "workspace_developer"
}'
# Mettre à jour le rôle d'un membre
curl -X POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-d '{"workspace_role": "workspace_admin"}'
# Supprimer un membre d'un espace de travail
curl -X DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"Pour les détails complets des paramètres, consultez la référence de l'API Workspace Members.
Les clés API sont limitées à un workspace spécifique. Lorsque vous créez une clé API dans un workspace, elle ne peut accéder qu'aux ressources de ce workspace.
Les ressources limitées aux workspaces incluent :
Certaines ressources ne peuvent pas être gérées avec une clé API de workspace :
workspace:manage_tunnels obtenu via la Workload Identity Federation, et non avec une clé API de workspace. Les tunnels sont créés dans un workspace, et la liste MCP tunnels de la Console ainsi que le sélecteur de serveur Managed Agent n'affichent que les tunnels du workspace actuel ; le plafond de 10 tunnels actifs s'applique à l'échelle de l'organisation. La gestion des tunnels nécessite un rôle avec des autorisations de gestion des tunnels ; les développeurs de l'organisation peuvent les consulter mais pas les modifier.Les caches de prompts sont également isolés par workspace sur l'API Claude, la Claude Platform on AWS et Microsoft Foundry. Sur Amazon Bedrock et Google Cloud, les caches de prompts sont isolés par organisation.
Pour récupérer les ID de workspace de votre organisation, utilisez le point de terminaison List Workspaces, ou trouvez-les dans la Claude Console.
Vous pouvez définir des limites de dépenses et de débit personnalisées pour chaque workspace afin de vous protéger contre la surutilisation et d'assurer une répartition équitable des ressources.
Vous pouvez définir des limites de workspace inférieures (mais pas supérieures) aux limites de votre organisation :
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 les limites de débit actuelles de votre organisation et de vos workspaces avec l'API Rate Limits.
Suivez l'utilisation et les coûts par workspace à 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" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"L'utilisation et les coûts attribués au Workspace par défaut ont une valeur null pour workspace_id.
Créez des workspaces distincts pour le développement, la préproduction et la production :
| Workspace | Objectif |
|---|---|
| Développement | Tests et expérimentation avec des limites de débit plus basses |
| Préproduction | Tests de préproduction avec des limites similaires à la production |
| Production | Trafic en direct avec des limites de débit complètes et une surveillance |
Attribuez des workspaces à différentes équipes pour l'allocation des coûts et le contrôle d'accès :
Créez des workspaces pour des projets ou des produits spécifiques afin de suivre l'utilisation et les coûts séparément.
Planifiez la structure de vos workspaces
Réfléchissez à la manière dont vous organiserez les workspaces avant de les créer. Pensez aux besoins en matière de facturation, de contrôle d'accès et de suivi de l'utilisation.
Utilisez des noms significatifs
Nommez les workspaces clairement pour indiquer leur objectif (par exemple, « Production - Chatbot client », « Dev - Outils internes »).
Définissez des limites appropriées
Configurez des limites de dépenses et de débit pour éviter les coûts imprévus et assurer une répartition équitable des ressources.
Auditez régulièrement les accès
Examinez périodiquement les membres des workspaces pour vous assurer que seuls les utilisateurs appropriés y ont accès.
Surveillez l'utilisation
Utilisez l'API Usage and Cost pour suivre la consommation au niveau du workspace.
Was this page helpful?