Cada API en la sección Admin de esta guía (la Admin API, las APIs de Analytics, la API de Compliance, la API de Límites de Gasto, la API de Uso y Costo y la API de Límites de Velocidad) se autentica con una clave de API de administrador. 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, API de Uso y Costo, API de Límites de Velocidad, API de Analytics de Claude Code y el Activity Feed de la API de Compliance |
Claude Enterprise (claude.ai) | claude.ai > Organization settings > API | sk-ant-api01-... | El propietario principal de la organización principal (todas las organizaciones vinculadas). Un propietario de organización puede crear una que lleve únicamente los scopes de la API de Compliance, restringida a su propia organización | API de Compliance, API de Analytics de Claude Enterprise y API de Límites de Gasto, 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 una.
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 API de administrador. 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 tiene acceso completo a la Admin API.
Copia y guarda el secreto
Copia el secreto que se muestra (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 o propietario de organización
El propietario principal de la organización principal de Claude Enterprise puede crear una clave que pueda acceder a todas las organizaciones vinculadas, o una restringida a una sola organización. Un propietario de organización puede crear una clave únicamente con los scopes de la API de Compliance, restringida a su propia organización.
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. El propietario principal puede 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 que se muestra (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 que requieren las APIs que planeas llamar. Los scopes se fijan en el momento de la creación; para agregar un scope más adelante, crea una nueva clave.
| Para llamar a... | Selecciona estos scopes |
|---|---|
| API de Límites de Gasto: leer los límites de gasto efectivos de los miembros y las solicitudes de aumento | read:spend_limits |
| API de Límites de Gasto: establecer o eliminar límites de gasto por usuario; aprobar o denegar solicitudes de aumento | write:spend_limits |
| API de Analytics de Claude Enterprise: informes de participación, adopción, costo y uso | read:analytics |
| Activity Feed de la API de Compliance: eventos de actividad de toda la organización | read:compliance_activities |
| Endpoints de contenido de la API de Compliance: leer chats, archivos, proyectos y usuarios | read:compliance_user_data |
| Endpoints de contenido de la API de Compliance: eliminar chats, archivos y proyectos | delete:compliance_user_data |
| Endpoints de organización de la API de Compliance: leer metadatos de la organización y configuraciones efectivas | read:compliance_org_data |
Las APIs de Compliance y Analytics deben estar habilitadas para tu organización antes de que se puedan usar claves con esos scopes. Consulta Configura la API de Compliance y APIs de Analytics.
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 exceda 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 las solicitudes de aumento para tu organización de Claude Enterprise.
Genera informes sobre la productividad de Claude Code o la participació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?