Los "workspaces" (espacios de trabajo) proporcionan una forma de organizar tu uso de la API dentro de una organización. Usa workspaces para separar diferentes proyectos, entornos o equipos mientras mantienes la facturación y administración centralizadas.
Cada organización tiene un Default Workspace (workspace predeterminado) que no se puede renombrar, archivar ni eliminar. Cuando creas workspaces adicionales, puedes asignar claves de API, miembros y límites de recursos a cada uno.
Características clave:
wrkspc_ (por ejemplo, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)Cuando un miembro de tu organización inicia sesión por primera vez en Claude Code con su cuenta de Claude Console, Anthropic crea automáticamente un workspace de Claude Code en la organización y agrega a ese miembro a él. Cada miembro posterior que inicie sesión en Claude Code se agrega de la misma manera.
El workspace de Claude Code mantiene el tráfico de Claude Code separado de tus otras cargas de trabajo de la API:
Archivar el workspace de Claude Code deshabilita el inicio de sesión de Claude Code a través de la facturación de la Console para toda la organización.
Los miembros pueden tener diferentes roles en cada workspace, lo que permite un control de acceso detallado.
| Rol | Permisos |
|---|---|
| Workspace User | Usar solo el Anthropic Workbench |
| Workspace Limited Developer | Crear y gestionar claves de API, usar la API. No puede acceder a las vistas de rastreo de sesiones ni descargar archivos. |
| Workspace Developer | Crear y gestionar claves de API, usar la API |
| Workspace Admin | Control total sobre la configuración y los miembros del workspace |
| Workspace Billing | Ver la información de facturación del workspace (heredado del rol de facturación de la organización) |
El rol Workspace Billing no se puede asignar manualmente. Se hereda al tener el rol de facturación de la organización.
Solo los administradores de la organización pueden crear workspaces. Los usuarios y desarrolladores de la organización deben ser agregados a los workspaces por un administrador.
Crea y gestiona workspaces en la Claude Console.
Abre la configuración de workspaces
En la Claude Console, ve a Settings > Workspaces.
Crea un workspace
Haz clic en Create workspace.
Configura el workspace
Ingresa un nombre de workspace y selecciona un color para la identificación visual.
Crea el workspace
Haz clic en Create para finalizar.
Para cambiar entre workspaces en la Console, usa el selector de Workspaces en la esquina superior izquierda.
Para modificar el nombre o el color de un workspace:
El Default Workspace no se puede renombrar ni eliminar.
Para eliminar un miembro, haz clic en el ícono de papelera junto a su nombre.
Los administradores y miembros de facturación de la organización no pueden ser eliminados de los workspaces mientras tengan esos roles de organización.
En la pestaña Limits, puedes configurar:
Para archivar un workspace, haz clic en el menú de puntos suspensivos (...) y selecciona Archive. Archivar:
Archivar un workspace revoca inmediatamente todas las claves de API en ese workspace. Esta acción no se puede deshacer. Si archivas el workspace de Claude Code, los miembros de tu organización ya no podrán iniciar sesión en Claude Code a través de la facturación de la Console.
Gestiona workspaces de forma programática usando la Admin API.
Los endpoints de la Admin API requieren una clave de Admin API (que comienza con sk-ant-admin...) que difiere de las claves de API estándar. Consulta Crear una clave de Admin API para saber cómo aprovisionar una.
# Crear un espacio de trabajo
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"}'
# Listar espacios de trabajo
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"
# Archivar un espacio de trabajo
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"Para obtener detalles completos de los parámetros y los esquemas de respuesta, consulta la referencia de la API de Workspaces.
Agrega, actualiza o elimina miembros de un workspace:
# Agregar un miembro a un espacio de trabajo
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"
}'
# Actualizar el rol de un miembro
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"}'
# Eliminar un miembro de un espacio de trabajo
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"Para obtener detalles completos de los parámetros, consulta la referencia de la API de Workspace Members.
Las claves de API están limitadas a un workspace específico. Cuando creas una clave de API en un workspace, solo puede acceder a los recursos dentro de ese workspace.
Los recursos limitados a los workspaces incluyen:
Algunos recursos no se pueden gestionar con una clave de API de workspace:
workspace:manage_tunnels obtenido a través de Workload Identity Federation, no con una clave de API de workspace. Los túneles se crean en un workspace, y la lista de MCP tunnels de la Console y el selector de servidores del Managed Agent muestran solo los túneles del workspace actual; el límite de 10 túneles activos se aplica a toda la organización. La gestión de túneles requiere un rol con permisos de gestión de túneles; los desarrolladores de la organización pueden verlos pero no modificarlos.Las cachés de prompts también están aisladas por workspace en la Claude API, Claude Platform on AWS y Microsoft Foundry. En Amazon Bedrock y Google Cloud, las cachés de prompts están aisladas por organización.
Para recuperar los ID de workspace de tu organización, usa el endpoint List Workspaces, o encuéntralos en la Claude Console.
Puedes establecer límites personalizados de gasto y de velocidad para cada workspace para protegerte contra el uso excesivo y garantizar una distribución justa de los recursos.
Puedes establecer límites de workspace inferiores (pero no superiores) a los límites de tu organización:
Para obtener información detallada sobre los límites de velocidad y cómo funcionan, consulta Límites de velocidad. También puedes leer los límites de velocidad actuales de tu organización y workspace de forma programática con la Rate Limits API.
Realiza un seguimiento del uso y los costos por workspace usando la Usage and Cost API:
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"El uso y los costos atribuidos al Default Workspace tienen un valor null para workspace_id.
Crea workspaces separados para desarrollo, staging y producción:
| Workspace | Propósito |
|---|---|
| Desarrollo | Pruebas y experimentación con límites de velocidad más bajos |
| Staging | Pruebas previas a producción con límites similares a los de producción |
| Producción | Tráfico en vivo con límites de velocidad completos y monitoreo |
Asigna workspaces a diferentes equipos para la asignación de costos y el control de acceso:
Crea workspaces para proyectos o productos específicos para realizar un seguimiento del uso y los costos por separado.
Planifica la estructura de tus workspaces
Considera cómo organizarás los workspaces antes de crearlos. Piensa en las necesidades de facturación, control de acceso y seguimiento de uso.
Usa nombres significativos
Nombra los workspaces con claridad para indicar su propósito (por ejemplo, "Producción - Chatbot de clientes", "Dev - Herramientas internas").
Establece límites apropiados
Configura límites de gasto y de velocidad para prevenir costos inesperados y garantizar una distribución justa de los recursos.
Audita el acceso regularmente
Revisa la membresía de los workspaces periódicamente para asegurarte de que solo los usuarios apropiados tengan acceso.
Monitorea el uso
Usa la Usage and Cost API para realizar un seguimiento del consumo a nivel de workspace.
Was this page helpful?