Espacios de trabajo

Los "workspaces" (espacios de trabajo) proporcionan una forma de organizar tu uso de la API dentro de una organización. Usa espacios de trabajo para separar diferentes proyectos, entornos o equipos mientras mantienes la facturación y administración centralizadas.

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 de API, miembros y límites de recursos a cada uno.

Características clave:

• Los identificadores de espacio de trabajo usan el prefijo wrkspc_ (por ejemplo, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
• Máximo de 100 espacios de trabajo por organización (los espacios de trabajo archivados no cuentan)
• El Espacio de trabajo predeterminado no tiene ID y no aparece en los endpoints de listado
• Las claves de API están limitadas a un único espacio de trabajo y solo pueden acceder a recursos dentro de ese espacio de trabajo

Espacio de trabajo de Claude Code

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 espacio de trabajo de Claude Code en la organización y agrega a ese miembro. Cada miembro posterior que inicie sesión en Claude Code se agrega de la misma manera.

El espacio de trabajo de Claude Code mantiene el tráfico de Claude Code separado de tus otras cargas de trabajo de la API:

• Claude Code genera una clave de API por usuario en este espacio de trabajo al iniciar sesión. No puedes crear claves en él manualmente desde la Consola.
• Una clave de Claude Code deja de funcionar si su propietario es eliminado del espacio de trabajo o de la organización, a diferencia de las claves de espacio de trabajo estándar.
• El uso de Claude Code tiene límites de velocidad separados, y los administradores pueden limitar su porción de los límites de la organización en Settings > Workspaces.
• Es el único espacio de trabajo que admite límites de gasto mensual por usuario.

Roles y permisos del espacio de trabajo

Los miembros pueden tener diferentes roles en cada espacio de trabajo, lo que permite un control de acceso detallado.

Herencia de roles

• Los administradores de la organización reciben automáticamente acceso de Workspace Admin a todos los espacios de trabajo
• Los miembros de facturación de la organización reciben automáticamente acceso de Workspace Billing a todos los espacios de trabajo
• Los usuarios y desarrolladores de la organización deben agregarse explícitamente a cada espacio de trabajo

Gestión de espacios de trabajo

Usando la Consola

Crea y gestiona espacios de trabajo en la Claude Console.

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 Edit details
3. Actualiza el nombre o color y guarda tus cambios

Agregar miembros a un espacio de trabajo

1. Navega a la pestaña Members del espacio de trabajo
2. Haz clic en Add to Workspace
3. Selecciona un miembro de la organización y asígnale un rol de 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 Limits, 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 alcance ciertos umbrales

Archivar un espacio de trabajo

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

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

Usando la Admin API

Gestiona espacios de trabajo de forma programática usando la Admin API.

# Crea un espacio de trabajo
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"}'

# Lista los espacios de trabajo
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"

# Archiva un espacio de trabajo
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 la API de Workspaces.

Gestión de miembros del espacio de trabajo

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

# Agregar un miembro a un espacio de trabajo
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"
  }'

# Actualizar el rol de un miembro
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"}'

# Eliminar un miembro de un espacio de trabajo
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 la API de Workspace Members.

Claves de API y alcance de recursos

Las claves de API están limitadas a un espacio de trabajo específico. Cuando creas una clave de 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 Files API
• Lotes de mensajes creados a través de la Batch API
• Skills creadas a través de la Skills API

Algunos recursos se gestionan a nivel de organización y no se pueden gestionar con una clave de API de espacio de trabajo:

• Los túneles MCP se gestionan con un token OAuth con alcance de organización (org:manage_tunnels) obtenido a través de Workload Identity Federation, no con una clave de API de espacio de trabajo, y 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. Los túneles se crean en un espacio de trabajo, y la lista de MCP tunnels de la Consola y el selector de servidores de Managed Agent muestran únicamente los túneles del espacio de trabajo actual.
• Los espacios de trabajo en sí y los miembros de la organización se gestionan a través de la Admin API, que requiere una clave de Admin API.

Límites del espacio de trabajo

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

Establecer límites del espacio de trabajo

Los límites del espacio de trabajo se pueden establecer por debajo de (pero no por encima de) 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 las solicitudes por minuto, tokens de entrada por minuto o tokens de salida por minuto

Para obtener información detallada sobre los límites de velocidad y cómo funcionan, consulta Límites de velocidad. También puedes leer tus límites de velocidad actuales de organización y espacio de trabajo de forma programática con la Rate Limits API.

Seguimiento de uso y costos

Realiza un seguimiento del uso y los costos por espacio de trabajo 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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_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, staging y producción:

Aislamiento de equipos o departamentos

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

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

Organización basada en proyectos

Crea espacios de trabajo para proyectos o productos específicos para realizar un seguimiento del uso y los costos por separado.

Mejores prácticas

Preguntas frecuentes

Ver también

• Admin API
• Referencia de la Admin API
• Límites de velocidad
• Usage and Cost API