Espacios de trabajo

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

Cómo funcionan los workspaces

Cada organización tiene un espacio de trabajo predeterminado que no se puede renombrar, archivar ni eliminar. Cuando creas workspaces adicionales, puedes asignar miembros, cuentas de servicio, claves de API 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 de forma predeterminada (los espacios de trabajo archivados no cuentan). Contacta a tu equipo de cuenta si necesitas más.
• El espacio de trabajo predeterminado tiene un ID wrkspc_ como cualquier otro espacio de trabajo (devuelto en el encabezado de respuesta anthropic-workspace-id y aceptado por Obtener espacio de trabajoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver.), pero aparece en los resultados de Listar espacios de trabajoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. solo cuando pasas include_default=true. La API de análisis de uso y costos informa su uso y costo bajo ese ID, mientras que los informes de la API de uso y costos heredada muestran null en su workspace_id (el campo scope de una clave de API contiene el ID real para una clave vinculada al espacio de trabajo predeterminado).
• Las claves de API pueden limitarse a un único espacio de trabajo. En este caso, solo pueden acceder a recursos dentro de ese espacio de trabajo. Otras claves de API no están limitadas a un espacio de trabajo. Con una de estas claves, envía un encabezado de ID de espacio de trabajo en cada solicitud para elegir el espacio de trabajo. El usuario o la cuenta de servicio de la clave debe tener acceso a ese espacio de trabajo.

Workspace 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 workspace de Claude Code en la organización y agrega a ese miembro a él. Cada miembro posterior que inicia 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 API:

• Claude Code genera una clave de API por usuario en este workspace al iniciar sesión. No puedes crear claves en él manualmente desde la Console.
• Una clave de Claude Code deja de funcionar si su propietario es eliminado del workspace o de la organización, a diferencia de una clave de workspace.
• El uso de Claude Code tiene límites de velocidad por separado, y los administradores pueden limitar su parte de los límites de la organización en Límites de frecuencia en Claude Console.
• Es el único workspace que admite límites de gasto mensual por usuario.

Roles y permisos de workspace

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

Herencia de roles

• Los administradores de la organización reciben automáticamente acceso de Administrador del espacio de trabajo a todos los espacios de trabajo.
• Los 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.
• Los usuarios y desarrolladores de la organización deben agregarse explícitamente a cada espacio de trabajo.
• Las cuentas de servicio se agregan a los workspaces en la página Cuentas de servicio (platform.claude.com/settings/service-accounts) de la Claude Console: selecciona Agregar al espacio de trabajo en el menú de la cuenta o en su propia página. Para ver las cuentas en un workspace, filtra la lista por workspace.

Gestión de workspaces

Usando la Console

Crea y gestiona espacios de trabajo en la página Espacios de trabajo de Claude Console.

Crear un workspace

1. 1

   Abre la configuración del workspace

   En la Claude Console, ve a la página Espacios de trabajo (platform.claude.com/settings/workspaces).

2. 2

   Abre la página Crear espacio de trabajo

   Haz clic en Crear espacio de trabajo para abrir la página Crear espacio de trabajo (platform.claude.com/settings/workspaces/new) en la Console.

3. 3

   Configura el workspace

   Ingresa un nombre para el workspace y selecciona un color para identificarlo visualmente.

4. 4

   Crea el workspace

   Haz clic en Crear espacio de trabajo para finalizar.

Editar detalles del workspace

Para modificar el nombre o color de un workspace:

1. Selecciona el workspace de la lista.
2. Abre el menú Más acciones (tres puntos) y selecciona Editar detalles.
3. Actualiza el nombre o color y guarda tus cambios.

Agregar miembros a un workspace

1. En la Claude Console, ve a la página Miembros (platform.claude.com/settings/members).
2. Haz clic en Agregar al espacio de trabajo.
3. Selecciona el workspace, el miembro de la organización que quieres agregar y su rol de workspace.
4. Haz clic en Agregar al espacio de trabajo para confirmar.

Eliminar miembros de un workspace

1. En la página Miembros de la Claude Console, selecciona el workspace en el menú desplegable Espacio de trabajo. Si muestra Todos, Eliminar miembro elimina al miembro de tu organización en su lugar.
2. Al final de la fila del miembro, abre el menú Más acciones (tres puntos) y selecciona Eliminar miembro.
3. Haz clic en Quitar para confirmar.

Establecer límites de workspace

Los límites de velocidad y los límites de gasto de un workspace se establecen en lugares diferentes:

• Límites de velocidad: En Límites de frecuencia en Claude Console, selecciona el espacio de trabajo en el menú desplegable Espacio de trabajo y haz clic en Editar junto a un modelo para establecer límites de solicitudes por minuto, tokens de entrada o tokens de salida.
• Límites de gasto: En la página Espacios de trabajo de la Claude Console, selecciona el workspace. En el panel que se abre, haz clic en Límites de gasto para limitar el gasto mensual y configurar alertas cuando el gasto alcance ciertos umbrales.

Archivar un workspace

Para archivar un workspace, abre su menú Más acciones (tres puntos) y selecciona Archivar espacio de trabajo. Archivar:

• Preserva los datos históricos para informes
• Desactiva el workspace y archiva cada clave de API creada para él
• No se puede deshacer

Usando la Admin API

Gestiona workspaces de forma programática usando la Admin API.

Los siguientes ejemplos de SDK y CLI construyen el cliente predeterminado, que lee la clave de Admin API de la variable de entorno ANTHROPIC_API_KEY; el SDK expone estos endpoints en client.organization.workspaces. Los métodos de listado del SDK obtienen páginas adicionales bajo demanda, por lo que limit establece el tamaño de página; los ejemplos de PHP, Ruby y curl devuelven una página.

Crear un workspace:

client = anthropic.Anthropic()

workspace = client.organization.workspaces.create(name="Production")

print(f"id: {workspace.id}")
print(f"name: {workspace.name}")

Listar workspaces:

client = anthropic.Anthropic()

workspaces = client.organization.workspaces.list(limit=10, include_archived=False)

for workspace in workspaces:
    print(f"{workspace.id}: {workspace.name}")

Archivar un workspace:

client = anthropic.Anthropic()

workspace = client.organization.workspaces.archive("wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ")

print(f"id: {workspace.id}")
print(f"archived_at: {workspace.archived_at}")

Para obtener detalles completos de los parámetros y los esquemas de respuesta, consulta la referencia de la API de WorkspacesVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver..

Gestión de miembros del workspace

Agregar un miembro a un workspace:

client = anthropic.Anthropic()

member = client.organization.workspaces.members.add(
    "wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    user_id="user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_role="workspace_developer",
)

print(f"user_id: {member.user_id}")
print(f"workspace_role: {member.workspace_role}")

Actualizar el rol de un miembro:

client = anthropic.Anthropic()

member = client.organization.workspaces.members.update(
    "user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
    workspace_role="workspace_admin",
)

print(f"user_id: {member.user_id}")
print(f"workspace_role: {member.workspace_role}")

Eliminar un miembro de un workspace:

client = anthropic.Anthropic()

removed_member = client.organization.workspaces.members.remove(
    "user_01WxYzAbCdEfGhJkMnPqRsTu",
    workspace_id="wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ",
)

print(f"user_id: {removed_member.user_id}")

Para obtener detalles completos de los parámetros, consulta la referencia de la API de miembros de espacios de trabajoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver..

Claves de API y alcance de recursos

Cada solicitud se ejecuta en exactamente un workspace y solo puede acceder a recursos dentro de ese workspace. Qué workspace depende del tipo de clave:

• Una clave de workspace (una clave heredada sin propietario) pertenece al workspace en el que se creó y siempre se ejecuta ahí.
• Una clave personal o clave de cuenta de servicio actúa como su usuario o cuenta de servicio. Una clave de un solo espacio de trabajo siempre se ejecuta en el espacio de trabajo elegido cuando se creó. Una clave que no está limitada a un espacio de trabajo se ejecuta en el espacio de trabajo indicado por el encabezado anthropic-workspace-id de cada solicitud. Las cuentas deben tener acceso al espacio de trabajo para usarlo.

Los recursos limitados a workspaces incluyen:

• Archivos creados a través de la Files API
• Lotes de mensajes creados a través de la Batch API
• Skills creados a través de la Skills API

Algunos recursos se gestionan de manera diferente:

• Los túneles MCP se gestionan con un token OAuth workspace:manage_tunnels obtenido a través de Workload Identity Federation, no con una clave de API. Los túneles se crean en un workspace, y la lista de Túneles MCP de la Console y el selector de servidor de Managed Agent muestran los túneles solo en el 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 cambiarlos.
• Los workspaces en sí mismos y los miembros de la organización se gestionan a nivel de organización a través de la Admin API, usando una clave de Admin API, un token OAuth org:admin, o una clave personal o de cuenta de servicio que no esté limitada a un workspace específico.

Para consultar los ID de los espacios de trabajo de tu organización, llama al endpoint Listar espacios de trabajoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. (pasa include_default=true para incluir el espacio de trabajo predeterminado) o encuéntralos en la página Espacios de trabajo de Claude Console.

Identificar el workspace detrás de una respuesta de API

Las respuestas de la Claude API incluyen un encabezado anthropic-workspace-id junto con los encabezados de respuesta request-id y anthropic-organization-id. Su valor es el ID con prefijo wrkspc_ del workspace al que se resolvió la clave de API o el token de acceso de la solicitud, incluso cuando ese workspace es el espacio de trabajo predeterminado. Por ejemplo, una respuesta exitosa incluye encabezados como estos:

HTTP/1.1 200 OK
request-id: req_018EeWyXxfu5pfWkrYcMdjWG
anthropic-organization-id: 0d0e7a3b-52f1-4c7e-9a51-3f6f2f7c1b9e
anthropic-workspace-id: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ

El encabezado está ausente cuando la credencial no se resuelve a un workspace (por ejemplo, en solicitudes de la Admin API) o cuando la solicitud falla antes de que se complete la autenticación, como un error 401.

Los siguientes ejemplos envían una solicitud de la Messages API y leen el ID del workspace de los encabezados de respuesta:

client = anthropic.Anthropic()

response = client.messages.with_raw_response.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
)
workspace_id = response.headers.get("anthropic-workspace-id")
print(f"Workspace ID: {workspace_id}")

Workspace ID: wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ

Los mismos accesores leen el encabezado de otros endpoints de la Claude API también, incluyendo las APIs de Claude Managed Agents. Por ejemplo, lee anthropic-workspace-id de la respuesta que crea una sesión para registrar a qué workspace pertenece la sesión.

Con el ID del workspace de una respuesta, puedes:

• Confirmar hacia qué uso, costo y límites de velocidad del workspace contó la solicitud
• Compararlo con el campo workspace_id de las filas de la API de análisis de uso y costos, que contienen este mismo ID para el espacio de trabajo predeterminado, y con el campo scope de las claves de API en la Admin API, que contiene el ID real del workspace al que está vinculada una clave, incluido el espacio de trabajo predeterminado
• Comprobar si es el ID de tu espacio de trabajo predeterminado pasándolo a Obtener espacio de trabajoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. con una clave de Admin API: el espacio de trabajo predeterminado se devuelve con "name": "Default", aunque Listar espacios de trabajoVista previa disponible con enlaces a la referencia de la API — presiona Tab hasta que el foco entre a la tarjeta y Escape para volver. lo omite a menos que pases include_default=true
• Abrir ese workspace en la Console para encontrar los recursos de la solicitud, como sesiones, archivos, lotes de mensajes y skills

Límites de workspace

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

Establecer límites de workspace

Puedes establecer límites de workspace 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 workspace. Para establecerlos, ve a la página Espacios de trabajo (platform.claude.com/settings/workspaces) de la Claude Console y selecciona el workspace. En el panel que se abre, haz clic en Límites de gasto.
• Límites de velocidad: Limita las solicitudes por minuto, los tokens de entrada por minuto o los tokens de salida por minuto. Para establecerlos, ve a Límites de frecuencia en Claude Console, selecciona el espacio de trabajo en el menú desplegable Espacio de trabajo y haz clic en Editar junto a un modelo.

Para obtener información detallada sobre los “rate limits” (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 de tu espacio de trabajo, y establecer límites de velocidad del espacio de trabajo de forma programática con la API de límites de velocidad, que almacena un valor por encima del límite de la organización pero aun así aplica el menor de los dos.

Seguimiento de uso y costos

Haz un seguimiento del uso y los costos por workspace con la API de análisis de uso y costos:

client = anthropic.Anthropic()

rows = client.beta.organization.analytics.usage.list(
    starting_at="2026-09-01T00:00:00Z",
    ending_at="2026-09-08T00:00:00Z",
    time_bucket_width="1d",
    workspace_ids=["wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ"],
    group_by=["workspace_id"],
)

for row in rows:
    print(f"{row.starting_at} {row.group.workspace_id}: {row.usage.total_tokens}")

El uso y los costos del espacio de trabajo predeterminado se informan bajo el propio ID del espacio de trabajo predeterminado.

Casos de uso comunes

Separación de entornos

Crea workspaces separados para desarrollo, staging y producción:

Aislamiento de equipo o departamento

Asigna workspaces 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 clientes

Organización basada en proyectos

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

Mejores prácticas

1. 1

   Planifica la estructura de tu workspace

   Considera cómo organizarás los workspaces antes de crearlos. Piensa en las necesidades de facturación, control de acceso y seguimiento de uso.

2. 2

   Usa nombres significativos

   Nombra los workspaces claramente para indicar su propósito (por ejemplo, “Production - Customer Chatbot” o “Dev - Internal Tools”).

3. 3

   Establece límites apropiados

   Configura límites de gasto y velocidad para prevenir costos inesperados y garantizar una distribución justa de recursos.

4. 4

   Audita el acceso regularmente

   Revisa la membresía del workspace periódicamente para garantizar que solo los usuarios apropiados tengan acceso.

5. 5

   Monitorea el uso

   Usa la API de análisis de uso y costos para hacer un seguimiento del consumo a nivel de workspace.

Preguntas frecuentes

Consulta también

• Admin API
• Referencia de la Admin API
• Límites de velocidad
• API de análisis de uso y costos y la API de uso y costos heredada