--- title: Configurar la Compliance API url: https://platform.claude.com/docs/es/manage-claude/compliance-api-access description: Habilita la Compliance API para tu organización, luego crea una Compliance Access Key (con permisos delimitados) o una clave de Admin API, y aprende cuál usar. --- Las organizaciones de Claude Enterprise y las organizaciones independientes de Claude Console elegibles tienen acceso de autoservicio a la Compliance API. Esta página describe cómo habilitar la Compliance API para tu organización y crear claves de API. **Rol requerido:** administrador de la organización (Claude Console), o propietario principal o propietario de la organización (claude.ai). La Compliance API usa dos tipos de claves, y cuál creas depende de qué producto de Claude usa tu organización. Los propietarios principales y los propietarios de la organización crean Compliance Access Keys (claves de acceso de cumplimiento) en claude.ai; estas claves desbloquean la Compliance API completa. La clave de un propietario principal puede cubrir todas las organizaciones bajo la organización padre; la clave de un propietario de la organización cubre únicamente su propia organización. Los administradores de la organización crean claves de Admin API en Claude Console; estas claves desbloquean únicamente el [Activity Feed](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed) (feed de actividad). ## ¿Qué clave necesitas? | Tipo de clave | Se crea en | Se usa para | ¿Funciona con la Compliance API? | | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | | **Compliance Access Key** (`sk-ant-api01-...`) | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | Activity Feed, chats, archivos, proyectos, sesiones (en aplicaciones como Cowork y Claude Code), usuarios, metadatos de la organización y configuración de la organización | Sí (todos los endpoints) | | **Clave de Admin API** (`sk-ant-admin01-...`) | Página [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) en Claude Console | La [Admin API](https://platform.claude.com/docs/es/manage-claude/admin-api) y el Activity Feed de la Compliance API | Solo Activity Feed | | **Clave de Analytics API** | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | La Analytics API de Claude Enterprise (consulta [Analytics APIs](https://platform.claude.com/docs/es/manage-claude/analytics-api)) | No | | **Clave de Claude API** (`sk-ant-api03-...`) | Página [API keys](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`) en Claude Console | Llamar a los modelos de Claude a través de la [Claude API](https://platform.claude.com/docs/es/api/overview) | No | Un tenant de Claude Enterprise tiene una **organización padre** que centraliza la identidad, el SSO y el SCIM para cada organización de carga de trabajo que está debajo de ella. Estas organizaciones de carga de trabajo son las **organizaciones vinculadas** de la organización padre. **Las organizaciones padre de Claude Enterprise no aparecen en Claude Console (`platform.claude.com`).** La organización padre no tiene cargas de trabajo, ni claves de Claude API, ni claves de Admin API. Crea las Compliance Access Keys en **Organization settings** de claude.ai, no en Claude Console. ## Configurar la Compliance API La configuración es un solo flujo: habilita la Compliance API para tu organización y luego crea una Compliance Access Key en claude.ai. Una organización de Claude Console, en cambio, [crea una clave de Admin API](https://platform.claude.com/docs/es/manage-claude/compliance-api-access#create-an-admin-api-key) después de la habilitación; las claves de Admin API solo alcanzan el [Activity Feed](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed). Una Compliance Access Key con `read:compliance_user_data` puede leer cada chat, archivo, proyecto y transcripción de sesión en cada organización vinculada, incluido contenido que el propietario principal no ha visto. Una clave con `delete:compliance_user_data` puede eliminar permanentemente chats, archivos y proyectos. Trata las Compliance Access Keys como credenciales de bases de datos de producción: guárdalas en un gestor de secretos, nunca en el control de código fuente ni en la configuración de un reenviador de SIEM. Dónde habilitas la Compliance API depende de cómo está configurada tu organización: * **Organizaciones de Claude Enterprise:** El propietario principal habilita la Compliance API en [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access). La habilitación ocurre a nivel de la organización padre y se propaga en cascada a cada organización vinculada, tanto de claude.ai como de Claude Console. * **Organizaciones independientes de Claude Console:** Un administrador de la organización activa el interruptor **Compliance API** en la página [Compliance](https://platform.claude.com/settings/security) (`platform.claude.com/settings/security`) de Claude Console. La habilitación es de autoservicio para las organizaciones que cumplen los requisitos, y el cambio surte efecto de inmediato. Si la página muestra un error de página no encontrada, o no muestra la sección **Compliance API**, es porque no tienes el rol de administrador, tu organización está vinculada a una organización padre (en ese caso, la Compliance API se habilita desde la organización padre) o tu organización no cumple los requisitos para la habilitación de autoservicio; contacta a tu equipo de cuenta o al [soporte de Anthropic](https://support.claude.com) si no estás seguro de cuál es tu caso. * **Organizaciones de Claude Console vinculadas a una organización padre:** No hay nada que activar en Claude Console. Pide al propietario principal de tu organización padre que habilite la Compliance API en claude.ai, o contacta a tu equipo de cuenta. **Desactivar la Compliance API detiene el registro de actividad.** Un administrador de la organización puede desactivar la Compliance API en cualquier momento con el mismo interruptor **Compliance API** que la activa. Mientras la Compliance API está desactivada, no se registran eventos de actividad para tu organización, por lo que el [Activity Feed](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed) no recibe eventos nuevos. Si tu organización está inscrita en [Access Transparency](https://platform.claude.com/docs/es/manage-claude/access-transparency), desactivar la Compliance API también detiene la entrega de eventos de Access Transparency. La actividad que no se registra mientras la Compliance API está desactivada no se puede recuperar después. Volver a activar la Compliance API reanuda el registro a partir de ese momento; la actividad que ya se había registrado no se elimina. Para las organizaciones de Claude Enterprise, la configuración de la Compliance API en claude.ai también rige la captura de transcripciones de las [sesiones locales](https://platform.claude.com/docs/es/manage-claude/compliance-sessions#retrieve-local-sessions) (sesiones en las máquinas de los usuarios): la captura comienza cuando se habilita la Compliance API y se detiene mientras está desactivada, y el contenido de las transcripciones de las sesiones que se ejecutan mientras está desactivada no se captura y no se puede recuperar después. Una organización independiente de Claude Console usa claves de Admin API en lugar de Compliance Access Keys: después de la habilitación, omite los pasos restantes y [crea una nueva clave de Admin API](https://platform.claude.com/docs/es/manage-claude/compliance-api-access#create-an-admin-api-key) en su lugar. Los pasos restantes aprovisionan Compliance Access Keys, que están disponibles únicamente para organizaciones que forman parte de un tenant de Claude Enterprise. El acceso de una clave se establece cuando se crea. Decide qué organizaciones cubre la clave: * Una clave para la **organización padre** puede acceder a todas las organizaciones bajo la organización padre. * Una clave para una **sola organización** puede acceder únicamente a esa organización. Inicia sesión en claude.ai. El propietario principal de la organización padre puede crear una clave con cualquiera de los dos alcances. Un propietario de la organización puede crear una clave restringida únicamente a su propia organización. Si la página **API** descrita en el siguiente paso no está visible, o los alcances de cumplimiento no están disponibles al crear una clave, o bien tu rol no puede crear Compliance Access Keys, o bien la Compliance API aún no se ha habilitado para tu organización (vuelve al primer paso). Ve a [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) y busca la sección **Keys**. Haz clic en **Create key**, asigna un nombre a la clave y selecciona uno o más alcances (scopes) de la siguiente tabla. Haz clic en **Create**. | Alcance | Otorga | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `read:compliance_activities` | Leer el Activity Feed. Una clave que cubre la organización padre lee los eventos de la organización padre y de todas las organizaciones vinculadas. | | `read:compliance_user_data` | Leer preferencias de usuario, chats, mensajes, archivos, proyectos, metadatos y transcripciones de sesiones de los usuarios, usuarios de la organización y miembros de grupos | | `delete:compliance_user_data` | Eliminar chats, archivos y proyectos de los usuarios | | `read:compliance_org_data` | Leer los metadatos de la organización (nombres, tipos, roles y grupos) y la configuración efectiva vigente para las organizaciones bajo la organización padre. Los listados de usuarios y la membresía de grupos requieren `read:compliance_user_data`. | Con la Plugins API, `read:compliance_org_data` también lee el inventario de plugins y marketplaces de plugins de tu organización a través de la Admin API, incluidos los plugins personales de los miembros y sus archivos. Ese inventario identifica a los miembros: contiene el ID de usuario de cada miembro que posee o creó un plugin, o con quien se ha compartido un plugin individualmente, y la dirección de correo electrónico del creador de un plugin mientras siga siendo miembro; consulta [Leer plugins y marketplaces de plugins](https://platform.claude.com/docs/es/manage-claude/compliance-org-data#read-plugins-and-plugin-marketplaces). Elige el conjunto de alcances más pequeño que necesite tu integración: * Un pipeline de auditoría que solo lee el Activity Feed necesita únicamente `read:compliance_activities`. * Una herramienta de eDiscovery que lee chats y archivos pero nunca los elimina no necesita `delete:compliance_user_data`. * Si tu flujo de trabajo lee y también elimina, usa **dos claves** con alcances separados para que una clave de lectura filtrada no pueda eliminar datos. Los alcances de una Compliance Access Key son inmutables después de su creación. Para cambiar los alcances, crea una nueva clave con los alcances que quieras y luego elimina la anterior. Copia la clave secreta que se muestra (comienza con `sk-ant-api01-`) y guárdala en tu gestor de secretos. El secreto completo se muestra solo una vez. Establece la clave como una variable de entorno para que los ejemplos de shell de esta guía puedan leerla: ```bash export ANTHROPIC_COMPLIANCE_ACCESS_KEY=sk-ant-api01-... ``` ## Crear una clave de Admin API La Compliance API ya debe estar [habilitada para tu organización de Claude Console](https://platform.claude.com/docs/es/manage-claude/compliance-api-access#set-up-the-compliance-api) antes de que una clave de Admin API pueda llamar al Activity Feed. Sigue los pasos de [Crear una clave de Admin API](https://platform.claude.com/docs/es/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization) y luego establece la clave como una variable de entorno: ```bash export ANTHROPIC_ADMIN_KEY=sk-ant-admin01-... ``` El nombre de variable distinto evita que la clave de Admin API sobrescriba una Compliance Access Key si aprovisionas ambas. Los ejemplos de cURL de esta guía leen la clave desde `$ANTHROPIC_COMPLIANCE_ACCESS_KEY`; sustitúyela por `$ANTHROPIC_ADMIN_KEY` cuando llames al [Activity Feed](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed) con una clave de Admin API. Las claves de Admin API tienen el alcance `read:compliance_activities` solo si la Compliance API estaba habilitada para la organización en el momento en que se creó la clave; consulta [Configurar la Compliance API](https://platform.claude.com/docs/es/manage-claude/compliance-api-access#set-up-the-compliance-api). No se les puede otorgar ningún otro alcance de la Compliance API, por lo que las llamadas a cualquier endpoint distinto del Activity Feed devuelven [403 Forbidden](https://platform.claude.com/docs/es/manage-claude/compliance-errors#403-forbidden). Para conocer el rol de esta misma clave en la administración de tu organización de Claude Console, consulta [Admin API](https://platform.claude.com/docs/es/manage-claude/admin-api). ## Verifica los alcances de tu clave Para inspeccionar los alcances de una clave que ya tienes, usa una de las siguientes señales. * **Prefijo de la clave.** `sk-ant-admin01-` es una clave de Admin API (solo tiene `read:compliance_activities`, sujeto al momento de habilitación descrito en la sección anterior). `sk-ant-api01-` es una Compliance Access Key; sus ámbitos son el subconjunto que seleccionaste al crearla. * **Interfaz de configuración.** Para una Compliance Access Key, abre la sección **Keys** en [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) y lee la columna **Scopes** de la clave. Las claves de Admin API, que aparecen en la página [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) de Claude Console, no tienen alcances seleccionables. * **Respuestas de error.** Una llamada que excede los ámbitos de la clave devuelve un 403 con un mensaje en el formato `Missing required scopes. Got: [] Needed one of: []` (`Needed: [...]` en los endpoints de eliminación). Consulta [Gestionar errores de la Compliance API](https://platform.claude.com/docs/es/manage-claude/compliance-errors#403-forbidden) para ver el catálogo completo de errores. ```json { "error": { "type": "permission_error", "message": "Missing required scopes. Got: ['read:compliance_activities'] Needed one of: ['read:compliance_user_data', 'read:org_audit']" } } ``` ## Administrar y rotar claves Elimina una Compliance Access Key desde la misma tabla **Keys** donde la creaste: ve a [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access). Elimina una clave de Admin API desde la página [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) de Claude Console. Eliminar una clave surte efecto en la siguiente solicitud: no hay período de gracia. Las Compliance Access Keys no expiran por sí solas. Para rotar una clave sin interrupciones: 1. Crea una nueva clave con los mismos alcances. 2. Actualiza tu integración para que use la nueva clave. 3. Verifica que la integración funcione correctamente con la nueva clave. 4. Elimina la clave anterior. Los cursores de paginación almacenados antes de una rotación siguen siendo válidos: los cursores están delimitados a la organización, no a la clave. Si una Compliance Access Key se filtra, elimínala de inmediato, audita el [Activity Feed](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed) en busca de actividades `compliance_api_accessed` realizadas por la clave comprometida, y rota cualquier credencial posterior a la que la clave filtrada pudiera acceder. Pasa `activity_types[]=compliance_api_accessed` para delimitar la consulta y luego, en tu cliente, conserva las actividades cuyo `actor.type` sea `api_actor` y cuyo `actor.api_key_id` coincida con la clave comprometida; consulta [Comprender el objeto Activity](https://platform.claude.com/docs/es/manage-claude/compliance-activity-feed#understand-the-activity-object) para ver el esquema del actor. ## Próximos pasos Lee eventos de actividad de toda la organización con cualquier clave que tenga `read:compliance_activities`. Usa una Compliance Access Key con `read:compliance_user_data` para recuperar chats, archivos y proyectos de claude.ai, y `delete:compliance_user_data` para eliminarlos. Usa una Compliance Access Key con `read:compliance_user_data` para listar las sesiones que tus usuarios ejecutan en aplicaciones y agentes de Claude, como Cowork y Claude Code, y recuperar sus transcripciones.