Obtén tu clave de API de Claude

Las "API keys" (claves de API) para la Claude API (también llamadas claves de API de Anthropic) se encuentran en la Claude Console. Para ver tus claves existentes o crear una nueva, ve a Settings → API keys.

Elige un tipo de clave

Cuando creas una clave, eliges su tipo, lo que determina qué puede hacer la clave, dónde funciona y cuándo deja de funcionar. Una clave personal actúa como tú y deja de funcionar si abandonas una organización. Una clave de cuenta de servicio representa una cuenta de servicio que puede ser utilizada por cargas de trabajo como pipelines de CI, servicios de producción o agentes. Usa una clave personal para tu propio desarrollo y una clave de cuenta de servicio para cualquier cosa compartida.

También puedes crear una clave de workspace, una clave heredada sin propietario: pertenece al workspace en el que la creas y sigue funcionando después de que su creador se va. Es preferible usar una clave personal o de cuenta de servicio, ya que estas dejan de funcionar automáticamente cuando su cuenta asociada se elimina de la organización.

Crea una clave de API

1. 1

   Inicia sesión en la Claude Console

   Ve a platform.claude.com e inicia sesión, o crea una cuenta si aún no tienes una.

2. 2

   Abre la página de claves de API

   Ve a Settings → API keys.

3. 3

   Crea una clave

   Haz clic en Create key, asigna un nombre a la clave, elige una expiración y establece Linked account en ti mismo o en una cuenta de servicio. También puedes elegir un workspace al cual limitar el alcance de la clave.

4. 4

   Copia y guarda la clave

   La Console muestra la clave completa, que comienza con sk-ant-, solo una vez, en el momento de la creación. Cópiala y guárdala en un lugar seguro, como un gestor de secretos. Si pierdes una clave, no puedes volver a verla en la Console. En su lugar, crea una clave nueva.

Si el botón Create key en la página de claves de API está deshabilitado, es posible que tu rol no te permita crear claves allí. Pide a un administrador de la organización que cambie tu rol o que cree una clave de cuenta de servicio para tu carga de trabajo.

Usa tu clave de API

Establece la clave como una variable de entorno:

export ANTHROPIC_API_KEY="sk-ant-api03-..."

Los SDK de cliente leen ANTHROPIC_API_KEY automáticamente. Las solicitudes HTTP directas envían la clave en el encabezado x-api-key. Si tu clave de API funciona en varios workspaces, también debes enviar el encabezado anthropic-workspace-id en cada solicitud a la Claude API, como se muestra en Selecciona un workspace. Para la Admin API, consulta Claves de API y la Admin API.

Para realizar tu primera solicitud, sigue el Inicio rápido y consulta Autenticación para obtener el panorama completo, incluidas las credenciales de corta duración con Workload Identity Federation.

Claves de API y la Admin API

La Admin API incluye endpoints para administrar las claves de API de tu organización de forma programática, como Retrieve API Key y List API Keys. Estos endpoints son para administradores de la organización que automatizan la gestión de claves. Aceptan una clave de Admin API, un token OAuth con el alcance org:admin, o una clave personal o de cuenta de servicio que no esté limitada a un workspace específico; las claves de workspace no funcionan allí. Nunca devuelven el valor secreto de una clave, solo una pista parcialmente oculta.