Crear una clave de API de administrador
Crea una clave de API de administrador para tu organización de Claude Console o Claude Enterprise.
Una clave de API de administrador autentica todas las API de la sección Administración de esta guía: la Admin API, las APIs de analítica, la Compliance API, la API de plugins, la API de Claude Tag, la API de Límites de Gasto, la API de análisis de uso y costos, la API de uso y costos y la API de límites de velocidad. No necesitas una clave independiente para cada API. La única excepción son los endpoints de cuentas de servicio, emisores de federación y reglas de federación de la Admin API, que solo aceptan un token bearer de OAuth con el alcance org:admin. Consulta Obtener un token bearer de OAuth.
El lugar donde creas la clave depende del producto de Claude que use tu organización.
¿Qué clave necesitas?
| Tu organización | Crea la clave en | Prefijo de la clave | Quién puede crearla | Funciona con |
|---|---|---|---|---|
Claude Console (Claude Platform, platform.claude.com) | Página Claves de administrador (platform.claude.com/settings/admin-keys) en Claude Console | sk-ant-admin01-... | Miembros de la organización con el rol Administrador | Admin API, API de análisis de uso y costos, API de uso y costos, API de límites de velocidad, API de Analytics de Claude Code y el Activity Feed de la Compliance API |
Claude Enterprise (claude.ai) | claude.ai > Configuración de la organización > API | sk-ant-api01-... | El Propietario principal de la organización padre (todas las organizaciones vinculadas). Un propietario de organización puede crear una que lleve únicamente alcances de la Compliance API, restringida a su propia organización | Gestión de usuarios (los endpoints de miembros, invitaciones y grupos de la Admin API), API de plugins, API de Claude Tag, Compliance API, Claude Enterprise Analytics API, API de análisis de uso y costos y API de Límites de Gasto, según los alcances que selecciones |
Una clave creada en una organización no puede usarse para administrar otra organización. Si tu empresa usa tanto Claude Console como Claude Enterprise, crea una clave en cada una.
Crear una clave para una organización de Claude Console
Inicia sesión como administrador de la organización
Solo los miembros de la organización con el rol Administrador pueden crear claves de API de administrador. Consulta Roles y permisos de la organización.
Abre la configuración de Claves de administrador
En Claude Console, ve a la página Claves de administrador (
platform.claude.com/settings/admin-keys).Crea la clave
Haz clic en Crear clave de administrador, asígnale un nombre, selecciona una expiración de clave y haz clic en Agregar. Las claves de la Claude Console no tienen alcances seleccionables; cada clave tiene acceso completo a todos los endpoints que aceptan claves de API de administrador (los endpoints de cuentas de servicio y de federación mencionados al principio de esta página no aceptan claves de API de administrador).
Copia y guarda el secreto
Copia el secreto que se muestra (comienza con
sk-ant-admin01-) y guárdalo en tu gestor de secretos. El secreto completo se muestra solo una vez.
Crear una clave para una organización de Claude Enterprise
Inicia sesión como propietario principal o propietario de organización
El propietario principal de la organización padre de Claude Enterprise puede crear una clave con acceso a todas las organizaciones vinculadas, o una restringida a una sola organización. Un propietario de organización puede crear una clave únicamente con alcances de la Compliance API, restringida a su propia organización.
Abre la configuración de API
Ve a claude.ai > Configuración de la organización > API y busca la sección Claves.
Haz clic en + Crear clave
Asigna un nombre a la clave y selecciona los alcances que necesites de la tabla de alcances. El propietario principal puede combinar alcances de distintas API (por ejemplo,
read:analyticsyread:spend_limits) en una sola clave.Copia y guarda el secreto
Copia el secreto que se muestra (comienza con
sk-ant-api01-) y guárdalo en tu gestor de secretos. El secreto completo se muestra solo una vez.
Elegir alcances para una clave de Claude Enterprise
Cuando crees una clave de Claude Enterprise, selecciona todos los “scopes” (alcances) que requieran las API que planeas llamar. Los alcances quedan fijos al momento de la creación; para agregar un alcance más adelante, crea una clave nueva.
| Para llamar a... | Selecciona estos alcances |
|---|---|
| Gestión de usuarios de la Admin API: listar y consultar miembros e invitaciones; leer roles personalizados y sus permisos | read:members |
Gestión de usuarios de la Admin API: cambiar roles de miembros, eliminar miembros, cerrar la sesión de miembros en todas partes (beta), crear y retirar invitaciones (para asignar el rol managed en un cambio de rol o una invitación, selecciona también write:rbac_groups) | write:members |
| Gestión de usuarios de la Admin API: leer grupos y sus miembros | read:rbac_groups |
Gestión de usuarios de la Admin API: crear, renombrar y eliminar grupos; agregar y quitar miembros de grupos; con write:members, asignar el rol managed (en una invitación o un cambio de rol) o asignar grupos en una invitación | write:rbac_groups |
| API de plugins: leer plugins, versiones, configuraciones de instalación, elementos compartidos y marketplaces; descargar archivos de plugins, incluidos los archivos de los plugins personales de los miembros; validar un marketplace antes de conectarlo | read:plugins |
API de plugins: subir plugins y versiones; elegir qué versión se sirve a los miembros; eliminar plugins, incluidos los plugins personales de los miembros; establecer y eliminar configuraciones de instalación; establecer la configuración de instalación predeterminada de un marketplace; validar un marketplace antes de conectarlo (para leer plugins, selecciona también read:plugins) | write:plugins |
| API de Claude Tag: leer la configuración de Claude Tag en canales y espacios de trabajo de Slack; listar los paquetes de acceso y dónde están vinculados (ningún otro alcance otorga acceso a la API de Claude Tag) | read:claude_tag |
API de Claude Tag: dar de alta y eliminar canales; cambiar la configuración; vincular y desvincular paquetes de acceso (para leer también, selecciona además read:claude_tag) | write:claude_tag |
| 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 rechazar solicitudes de aumento | write:spend_limits |
| Claude Enterprise Analytics API: informes de participación, adopción, costo y uso; API de análisis de uso y costos: informes de uso de tokens y costo | read:analytics |
| Activity Feed de la Compliance API: eventos de actividad de toda la organización | read:compliance_activities |
| Endpoints de chats, archivos y proyectos de la Compliance API y endpoints de sesiones de la Compliance API: leer chats, archivos, proyectos, transcripciones de sesiones y usuarios de la organización | read:compliance_user_data |
| Endpoints de chats, archivos y proyectos de la Compliance API: eliminar chats, archivos y proyectos | delete:compliance_user_data |
Endpoints de organización de la Compliance API: leer los metadatos de la organización y la configuración efectiva; API de plugins: todos los endpoints GET, incluidas las descargas de archivos | read:compliance_org_data |
Endpoints de lectura de gestión de usuarios de la Admin API, todos los endpoints de lectura de la Compliance API y todos los endpoints GET de la API de plugins, incluidas las descargas de archivos, con un único alcance de solo lectura (para integraciones de auditoría de seguridad; no incluye las API de Límites de Gasto ni de analítica) | read:org_audit |
Las Compliance y Analytics APIs deben estar habilitadas para tu organización antes de que puedan usarse claves con esos alcances. Consulta Configurar la Compliance API y Obtener acceso a la Claude Enterprise Analytics API.
Puedes crear y usar claves con read:plugins o write:plugins solo si tu organización puede usar la Plugins API. La guía de la API de plugins indica qué organizaciones pueden usarla. En esas organizaciones, las claves con read:org_audit o read:compliance_org_data también pueden llamar a los endpoints de lectura de la Plugins API, incluidas las descargas de archivos, pero no a la validación de marketplaces. Los alcances read:plugins y write:plugins actúan solo sobre la organización en la que se creó la clave. Consulta Alcances de la Plugins API y Leer otra organización bajo la misma organización matriz.
Usar la clave
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 alcances de la clave devuelve 403 Forbidden con un mensaje que enumera los alcances que tiene la clave y los alcances que necesita el endpoint.
Próximos pasos
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 participación y adopción de Claude Enterprise.
Audita la actividad y recupera o elimina contenido de usuarios en toda tu organización.
¿Te resultó útil esta página?