Espacios de trabajo

Los espacios de trabajo proporcionan una forma de organizar tu uso de API dentro de una organización. Utiliza espacios de trabajo para separar diferentes proyectos, entornos o equipos mientras mantienes facturación y administración centralizada.

Cómo funcionan los espacios de trabajo

Cada organización tiene un Espacio de trabajo predeterminado que no se puede renombrar, archivar ni eliminar. Cuando creas espacios de trabajo adicionales, puedes asignar claves API, miembros y límites de recursos a cada uno.

Características clave:

• Identificadores de espacio de trabajo utilizan el prefijo wrkspc_ (por ejemplo, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
• Máximo 100 espacios de trabajo por organización (los espacios de trabajo archivados no cuentan)
• Espacio de trabajo predeterminado no tiene ID y no aparece en los puntos finales de lista
• Claves API están limitadas a un único espacio de trabajo y solo pueden acceder a recursos dentro de ese espacio de trabajo

Roles y permisos del espacio de trabajo

Los miembros pueden tener diferentes roles en cada espacio de trabajo, permitiendo control de acceso granular.

Herencia de roles

• Administradores de la organización reciben automáticamente acceso de Administrador del espacio de trabajo a todos los espacios de trabajo
• Miembros de facturación de la organización reciben automáticamente acceso de Facturación del espacio de trabajo a todos los espacios de trabajo
• Usuarios y desarrolladores de la organización deben agregarse explícitamente a cada espacio de trabajo

Gestión de espacios de trabajo

A través de la consola

Crea y gestiona espacios de trabajo en la Consola Claude.

Crear un espacio de trabajo

Editar detalles del espacio de trabajo

Para modificar el nombre o color de un espacio de trabajo:

1. Selecciona el espacio de trabajo de la lista
2. Haz clic en el menú de puntos suspensivos (...) y elige Editar detalles
3. Actualiza el nombre o color y guarda tus cambios

Agregar miembros a un espacio de trabajo

1. Navega a la pestaña Miembros del espacio de trabajo
2. Haz clic en Agregar al espacio de trabajo
3. Selecciona un miembro de la organización y asígnale un rol del espacio de trabajo
4. Confirma la adición

Para eliminar un miembro, haz clic en el icono de papelera junto a su nombre.

Establecer límites del espacio de trabajo

En la pestaña Límites, puedes configurar:

• Límites de velocidad: Establece límites por nivel de modelo para solicitudes por minuto, tokens de entrada o tokens de salida
• Notificaciones de gasto: Configura alertas cuando el gasto alcanza ciertos umbrales

Archivar un espacio de trabajo

Para archivar un espacio de trabajo, haz clic en el menú de puntos suspensivos (...) y selecciona Archivar. El archivado:

• Preserva datos históricos para informes
• Desactiva el espacio de trabajo y todas las claves API asociadas
• No se puede deshacer

A través de la API de administración

Gestiona espacios de trabajo mediante programación usando la API de administración.

# Create a workspace
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"}'

# List workspaces
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"

# Archive a workspace
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"

Para obtener detalles completos de parámetros y esquemas de respuesta, consulta la referencia de API de espacios de trabajo.

Gestión de miembros del espacio de trabajo

Agrega, actualiza o elimina miembros de un espacio de trabajo:

# Add a member to a workspace
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"
  }'

# Update a member's role
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"}'

# Remove a member from a workspace
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"

Para obtener detalles completos de parámetros, consulta la referencia de API de miembros del espacio de trabajo.

Claves API y alcance de recursos

Las claves API están limitadas a un espacio de trabajo específico. Cuando creas una clave API en un espacio de trabajo, solo puede acceder a recursos dentro de ese espacio de trabajo.

Los recursos limitados a espacios de trabajo incluyen:

• Archivos creados a través de la API de archivos
• Lotes de mensajes creados a través de la API de lotes
• Habilidades creadas a través de la API de habilidades

Límites del espacio de trabajo

Puedes establecer límites de gasto y velocidad personalizados para cada espacio de trabajo para protegerte contra el uso excesivo y garantizar una distribución justa de recursos.

Establecimiento de límites del espacio de trabajo

Los límites del espacio de trabajo se pueden establecer más bajos que (pero no más altos que) los límites de tu organización:

• Límites de gasto: Limita el gasto mensual de un espacio de trabajo
• Límites de velocidad: Limita solicitudes por minuto, tokens de entrada por minuto o tokens de salida por minuto

Para obtener información detallada sobre límites de velocidad y cómo funcionan, consulta Límites de velocidad.

Seguimiento de uso y costos

Realiza un seguimiento del uso y los costos por espacio de trabajo usando la API de uso y costos:

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: $ADMIN_API_KEY"

El uso y los costos atribuidos al espacio de trabajo predeterminado tienen un valor null para workspace_id.

Casos de uso comunes

Separación de entornos

Crea espacios de trabajo separados para desarrollo, ensayo y producción:

Aislamiento de equipo o departamento

Asigna espacios de trabajo a diferentes equipos para asignación de costos y control de acceso:

• Equipo de ingeniería con acceso de desarrollador
• Equipo de ciencia de datos con sus propias claves API
• Equipo de soporte con acceso limitado para herramientas de cliente

Organización basada en proyectos

Crea espacios de trabajo para proyectos o productos específicos para rastrear el uso y los costos por separado.

Mejores prácticas

Preguntas frecuentes

Ver también

• Descripción general de la API de administración
• Referencia de la API de administración
• Límites de velocidad
• API de uso y costos