Cada API en la sección Admin de esta guía (la Admin API, las Analytics APIs, la Compliance API, la Spend Limits API, la Usage and Cost API y la Rate Limits API) se autentica con una clave de Admin API. No necesitas una clave separada para cada API.
El lugar donde creas la clave depende de qué producto de Claude usa tu organización.
| Tu organización | Crea la clave en | Prefijo de la clave | Quién puede crearla | Funciona con |
|---|---|---|---|---|
Claude Console (Claude Platform, platform.claude.com) | Claude Console > Settings > Admin keys | sk-ant-admin01-... | Miembros de la organización con el rol de admin | Admin API, Usage and Cost API, Rate Limits API, Claude Code Analytics API y el Activity Feed de la Compliance API |
Claude Enterprise (claude.ai) | claude.ai > Organization settings > API | sk-ant-api01-... | El propietario principal de la organización | Compliance API, Claude Enterprise Analytics API y Spend Limits API, según los scopes que selecciones |
Una clave creada en una organización no puede usarse para administrar una organización diferente. Si tu empresa usa tanto Claude Console como Claude Enterprise, crea una clave en cada uno.
Inicia sesión como administrador de la organización
Solo los miembros de la organización con el rol de admin pueden crear claves de Admin API. Consulta Roles y permisos de la organización.
Abre la configuración de Admin keys
Crea la clave
Haz clic en Create key, asígnale un nombre y haz clic en Create. Las claves de Claude Console no tienen scopes seleccionables; cada clave otorga acceso completo a la Admin API.
Copia y guarda el secreto
Copia el secreto mostrado (que comienza con sk-ant-admin01-) y guárdalo en tu gestor de secretos. El secreto completo se muestra solo una vez.
Inicia sesión como propietario principal
Solo el propietario principal de la organización principal de Claude Enterprise puede crear estas claves.
Abre la configuración de API
Ve a claude.ai > Organization settings > API y busca la sección Keys.
Haz clic en + Create key
Asigna un nombre a la clave y selecciona los scopes que necesitas de la tabla de scopes. Puedes combinar scopes de diferentes APIs (por ejemplo, read:analytics y read:spend_limits) en una sola clave.
Copia y guarda el secreto
Copia el secreto mostrado (que comienza con sk-ant-api01-) y guárdalo en tu gestor de secretos. El secreto completo se muestra solo una vez.
Cuando creas una clave de Claude Enterprise, selecciona todos los "scopes" (alcances) que requieren las APIs que planeas llamar. Los scopes se fijan al momento de la creación; para agregar un scope más adelante, crea una nueva clave.
| Para llamar a... | Selecciona estos scopes |
|---|---|
| Spend Limits API: leer los límites de gasto efectivos de los miembros y las solicitudes de aumento | read:spend_limits |
| Spend Limits API: establecer o eliminar límites de gasto por usuario; aprobar o denegar solicitudes de aumento | write:spend_limits |
| Claude Enterprise Analytics API: informes de interacción, adopción, costos y uso | read:analytics |
| Activity Feed de la Compliance API: eventos de actividad de toda la organización | read:compliance_activities |
| Endpoints de contenido de la Compliance API: leer chats, archivos, proyectos y usuarios | read:compliance_user_data |
| Endpoints de contenido de la Compliance API: eliminar chats, archivos y proyectos |
Las APIs de Compliance y Analytics deben estar habilitadas para tu organización antes de que puedan usarse las claves con esos scopes. Consulta Obtener acceso a la Compliance API y Analytics APIs.
Pasa la clave en el encabezado x-api-key en cada solicitud. Consulta la documentación de cada API para ver ejemplos completos de solicitudes.
Una llamada que excede los scopes de la clave devuelve 403 Forbidden con un mensaje que enumera los scopes que tiene la clave y los scopes que necesita el endpoint.
Administra miembros de la organización, espacios de trabajo y claves de API.
Establece límites de gasto por miembro y revisa solicitudes de aumento para tu organización de Claude Enterprise.
Genera informes sobre la productividad de Claude Code o la interacción y adopción de Claude Enterprise.
Audita la actividad y recupera o elimina contenido de usuarios en toda tu organización.
Was this page helpful?
delete:compliance_user_data |
| Endpoints de organización de la Compliance API: leer metadatos y configuración de la organización | read:compliance_org_data, read:compliance_org_settings |