Guía de la API Claude: precios, configuración y tu primera solicitud

Para realizar tu primera solicitud a la API de Claude, crea una clave de la consola de Claude, guárdala en una variable de entorno, llama al punto final «Messages» y lee la respuesta devuelta uso campos y calcular el coste del token. Esta guía te guía a lo largo de ese proceso con los ID de los modelos y los precios actuales, verificados el 8 de septiembre de 2026.

Una vez que comprendas el funcionamiento de la API, la siguiente pregunta es: ¿qué parte de tu trabajo diario requiere realmente una integración personalizada? En lo que respecta a la investigación, la redacción, la programación y la producción creativa, GlobalGPT Ofrece una forma más económica de utilizar Claude junto con GPT-5.6 Sol, Gemini 3 Pro, Kimi K3 y otros modelos líderes. Una única suscripción reúne los modelos y un amplio conjunto de herramientas de IA en un único panel de control, de modo que el trabajo puede pasar de la idea al resultado sin tener que dividirse entre distintos servicios. Cuando necesites incorporar la IA a tu entorno de desarrollo, la CLI de GlobalGPT conecta ese mismo espacio de trabajo a tu terminal y a tus herramientas de producción existentes.

Prueba Claude Opus 5

¿Qué es la API Claude?

La API Claude es la interfaz para desarrolladores de Anthropic que permite enviar solicitudes estructuradas a los modelos de Claude desde una aplicación, un script o un servicio de backend. Se envían mensajes a un punto final HTTPS y se recibe una respuesta estructurada que contiene el contenido generado, además de metadatos como el modelo, el motivo de la interrupción y el uso del token.

Suscripciones a Claude API frente a Claude.ai

El acceso a la API y las suscripciones a Claude.ai sirven para fines distintos. Un plan de Claude.ai permite acceder al producto de chat de Anthropic. La API es un acceso para desarrolladores con consumo medido a través de la consola de Claude, con facturación independiente basada en el uso. El Centro de ayuda de Anthropic indica que Claude Pro no incluye el uso de la API de la consola.

Si necesitas conocer la diferencia general entre los planes para consumidores, el código Claude y la facturación por tokens, consulta nuestra guía completa Guía de precios de Claude. En este tutorial, lo importante es muy sencillo: crear y recargar la cuenta de la API por separado de cualquier suscripción a Claude.ai.

Los cinco pasos para realizar una primera solicitud

1. Crea una clave API en la consola de Claude.
2. Guárdalo en el ANTHROPIC_API_KEY variable de entorno.
3. Envía una solicitud a https://api.anthropic.com/v1/messages.
4. Lee el contenido devuelto y uso objeto.
5. Multiplica cada categoría de tokens por la tarifa correspondiente por cada millón de tokens.

Precios de la API Claude e ID de los modelos actuales

Anthropic muestra los precios de la API en dólares estadounidenses por millón de tokens, lo que a menudo se abrevia como MTok. Las entradas y las salidas se facturan por separado. El almacenamiento en caché de las consultas añade tarifas distintas para las escrituras de cinco minutos, las escrituras de una hora y las lecturas de la caché, por lo que una estimación fiable debe mantener separadas esas categorías.

Modelos actuales e identificadores exactos de la API

¿Qué modelo deberías utilizar para este tutorial?

Se ha utilizado la guía de inicio rápido oficial claude-opus-5 en el momento en que se verificó esta guía, por lo que los ejemplos de cURL y Python que aparecen a continuación utilizan el mismo ID. Considera Opus como punto de partida para el tutorial y, a continuación, elige el modelo de producción en función de la carga de trabajo, los requisitos de calidad, la latencia y el presupuesto. Los ID de los modelos y el estado de su ciclo de vida pueden cambiar, por lo que te recomendamos que vuelvas a consultar las páginas «Modelos» y «Modelos obsoletos» antes de implementar código de larga duración.

Lo que necesitas antes de realizar tu primera solicitud

Crea una cuenta de la consola Claude y una clave API

Abre la consola de Claude, crea o selecciona la organización correspondiente y crea una clave API. Anthropic advierte de que una nueva clave solo se muestra una vez, por lo que debes guardarla en un gestor de secretos autorizado o en otra ubicación segura cuando aparezca. No incluyas la clave en una captura de pantalla, un documento compartido, un repositorio público ni en código JavaScript del navegador.

Guarda la clave en una variable de entorno

En los ejemplos se espera que la variable ANTHROPIC_API_KEY. Introduce el valor real únicamente en tu terminal privada o en tu sistema de gestión de secretos. El comando que aparece a continuación lee el valor sin mostrarlo en pantalla y, a continuación, lo exporta para la sesión actual del shell:

read -s ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY

Las variables de entorno reducen la exposición accidental, pero no constituyen una estrategia completa de gestión de secretos. Las aplicaciones de producción deben seguir las prácticas de almacenamiento de secretos y control de acceso de la plataforma de alojamiento.

Comprueba la facturación y elige un límite de prueba seguro

La facturación de la API es independiente de las suscripciones a Claude.ai. Según Anthropic, la mayoría de las organizaciones pagan por adelantado los créditos de uso, mientras que las organizaciones con facturación mensual son una excepción. Comprueba que tu cuenta de la Consola pueda realizar solicitudes a la API y, a continuación, haz que la primera solicitud sea pequeña con max_tokens: 128. Ese campo limita la producción generada; no reserva ni garantiza 128 fichas de producción facturadas.

Envía tu primera solicitud a la API Claude con cURL

cURL resulta útil para ver directamente el contenido de la solicitud. El ejemplo siguiente utiliza el punto final «Messages», el tipo de contenido JSON, el encabezado de la clave de API, el encabezado de versión de Anthropic, el ID del modelo Quickstart verificado y un mensaje de usuario.

Antes de ejecutar cualquiera de los ejemplos, añade tu propia clave de API y comprueba que la facturación de la API esté habilitada para la organización. El código sigue el formato de solicitud documentado por Anthropic y ha superado las comprobaciones sintácticas locales, pero aquí no se incluye ninguna respuesta de una cuenta real.

curl https://api.anthropic.com/v1/messages \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data '{
    "model": "claude-opus-5",
    "max_tokens": 128,
    "messages": [{
 "role": "user",
 "content": "Responde con una frase explicando qué es una API."
    }]
  }'

Función de cada encabezado y campo JSON

Si el comando devuelve un error, comprueba el estado HTTP y el tipo de error antes de modificar la solicitud. Los errores de autenticación y facturación requieren una corrección en la cuenta, mientras que un JSON mal formado o un ID de modelo no válido requieren una modificación de la solicitud.

Enviar la misma solicitud con el SDK de Python

Instala el SDK oficial de Anthropic

python -m pip install anthropic

Utiliza un entorno virtual cuando forme parte de tu flujo de trabajo habitual con Python. El SDK lee ANTHROPIC_API_KEY del entorno cuando anthropic.Anthropic() se crea sin una clave explícita.

Ejecuta la solicitud equivalente en Python

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=128,
    messages=[
 {
 "role": "user",
 "content": "Responde con una frase explicando qué es una API.",
 }
    ],
)

for block in message.content:
    if block.type == "text":
    print(block.text)

print(message.usage)

Lee el texto devuelto de forma segura

Una respuesta de mensaje puede contener más de un bloque de contenido, por lo que en el ejemplo se comprueba el tipo de cada bloque antes de mostrar el texto. Las aplicaciones reales también deberían mantener disponible el ID de la solicitud para fines de asistencia técnica y registro, sin revelarlo públicamente; registrar el modelo devuelto y el motivo de la interrupción; y gestionar los errores de la API de forma explícita.

Mantén la comprobación del bloque de contenido incluso cuando esperes una respuesta breve. Así resulta más fácil ampliar el ejemplo cuando una respuesta contiene varios bloques, y al imprimir message.usage te proporciona las cifras necesarias para el cálculo de costes que figura a continuación.

Cómo leer el consumo y calcular el coste

Busca el texto de la respuesta, el modelo, el motivo de la interrupción y el ID de la solicitud

El contrato de respuesta de la API de mensajes incluye contenido generado, el modelo que gestionó la solicitud y el motivo de la interrupción. La respuesta HTTP también contiene un identificador de solicitud que puede ayudar al servicio de asistencia de Anthropic a rastrear un problema. Registra los identificadores con cuidado; no los publiques junto con el contenido o las credenciales de los clientes.

Consultar el uso de tokens de entrada, salida y caché

En uso El objeto informa de las categorías de tokens necesarias para el análisis de costes. Como mínimo, busca los tokens de entrada y de salida. Cuando se utilice el almacenamiento en caché de indicaciones, mantenga separadas las escrituras en caché de cinco minutos, las de una hora y las lecturas de caché, ya que tienen diferentes tarifas. El punto final de recuento de tokens de Anthropic puede estimar los tokens de entrada antes de una solicitud, pero la estimación puede diferir ligeramente del uso final de entrada y tiene sus propios límites de tarifa.

Convertir el uso de tokens en un coste estimado

Calcula cada categoría por separado y, a continuación, suma los resultados. En un ejemplo de planificación en el que se utiliza Claude Opus 5 con tarifas globales estándar, 1.000 tokens de entrada no almacenados en caché cuestan 1.000 × $5 / 1.000.000 = $0,005, mientras que 300 tokens de salida cuestan 300 × $25 / 1 000 000 = $0,0075. El total estimado es de $0.0125. Sustituye estas cifras ilustrativas por las uso valores de tu propia respuesta.

Calculadora de precios de la API Claude

Utiliza la calculadora para modificar el modelo, el número de solicitudes, las categorías de tokens, el modo de facturación y la zona geográfica de inferencia. El procesamiento por lotes aplica a los usos elegibles tarifas estándar de 50%. La inferencia exclusiva para EE. UU. aplica un factor de 1,1 a todas las categorías de tokens para los modelos elegibles Claude 4,6+; Claude Haiku 4,5 no es elegible, por lo que esa combinación devuelve un estado no compatible.

El presupuesto es una herramienta de planificación, no una factura. No incluye impuestos, conversión de divisas, condiciones negociadas, el modo rápido, cargos por herramientas de servidor ni condiciones específicas de la cuenta. Los precios y los requisitos de elegibilidad pueden variar, por lo que te recomendamos que consultes de nuevo la página oficial de precios antes de tomar una decisión de compra o de arquitectura.

La calculadora anterior muestra la estructura de costes de las llamadas a la API Claude programables y facturadas por consumo. Para el trabajo diario que abarca varios modelos y capacidades de IA, GlobalGPT ofrece un tipo de valor diferente: una sola suscripción reúne múltiples modelos y herramientas de uso general en un único panel de control, lo que facilita la previsión de los costes y evita tener que recurrir a suscripciones separadas e interfaces dispersas para la investigación, la redacción, la programación y el trabajo creativo. Su interfaz de línea de comandos (CLI) lleva esta misma plataforma al desarrollo basado en terminal y a las herramientas de producción que ya utilizas. Nuestra guía sobre trabajar con varios modelos de IA en un mismo lugar muestra cómo encajan las distintas partes de la plataforma en su conjunto.

Errores habituales de la API Claude y sus soluciones

Empieza por el estado HTTP y el tipo de error Anthropic; a continuación, analiza la solicitud sin revelar la clave. La definición oficial reduce el ámbito de la búsqueda; no obstante, la causa probable sigue dependiendo de tu cuenta, del modelo seleccionado, del formato de la solicitud y del tráfico.

Un orden de depuración seguro

1. Registra el estado, el tipo de error, la marca de tiempo y el ID de la solicitud sin registrar la clave de la API.
2. Comprueba el punto final, los encabezados, la sintaxis JSON, el ID del modelo y el límite de tamaño de la solicitud.
3. Comprueba la facturación de la organización, los permisos, los encabezados de limitación de solicitudes y el ciclo de vida actual del modelo.
4. Reintentar únicamente los errores que, con toda razón, puedan ser temporales, utilizando un retroceso exponencial limitado y una variación de tiempo.
5. Si el error persiste, reduce la solicitud al caso reproducible más sencillo antes de ponerte en contacto con el servicio de asistencia.

Los SDK oficiales de Anthropic reintentan, por defecto, dos veces los errores de conexión, las respuestas 429 y las respuestas 5xx. La lógica de reintentos a nivel de aplicación sigue necesitando límites y tener en cuenta la idempotencia, especialmente cuando una solicitud puede activar herramientas u otra acción externa.

Cómo controlar los costes de la API Claude

Establecer límites de salida conservadores

Empieza por el más pequeño max_tokens valor que aún puede generar una respuesta útil. Mide el uso real de la salida antes de aumentarlo. Las indicaciones más breves pueden ayudar, pero eliminar instrucciones que eviten nuevos intentos, errores o salidas inutilizables puede suponer un coste mayor en general.

Utiliza el almacenamiento en caché de comandos y el procesamiento por lotes solo cuando sea adecuado

• Utiliza el almacenamiento en caché de las indicaciones cuando se repita un prefijo sustancial de la indicación y la duración de la caché se ajuste al flujo de trabajo.
• Utiliza Batch para las tareas que se puedan completar de forma asíncrona; el uso de Batch que cumpla los requisitos se factura a 50% según las tarifas estándar.
• Mantén separadas las operaciones de escritura y lectura de la caché en los informes, para que el ahorro sea visible y no se dé por supuesto.
• Utiliza la inferencia exclusiva para EE. UU. únicamente cuando el requisito de residencia justifique su factor de precio de los tokens de 1,1x y el modelo seleccionado cumpla los requisitos.

Supervisar el uso, los límites de velocidad y los límites de gasto

Realiza un seguimiento del recuento de solicitudes, el ID del modelo, el uso de entradas y salidas, las categorías de caché, los reintentos y los errores. Configura las alertas o los controles de gasto disponibles para tu organización, pero no des por sentado que el nivel o el límite de otra cuenta se aplica al tuyo. Nuestra guía más detallada sobre Planes Claude, costes de la API y límites abarca las vías de facturación más amplias.

Próximos pasos tras tu primera solicitud

Elige el camino adecuado para tu próximo proyecto

Para una aplicación, consulta la referencia oficial de la API de mensajes de Anthropic, las directrices sobre streaming, la documentación sobre el uso de herramientas, las páginas sobre el ciclo de vida de los modelos y tu propio plan de registro y evaluación. Define una estrategia de modelos de forma deliberada, gestiona los errores antes de añadir tráfico y calcula los costes a partir del uso observado, en lugar de basarte únicamente en la longitud de las peticiones.

Si la programación es tu principal uso, nuestra guía sobre utilizar Claude AI para codificar aborda formas prácticas de pasar de una tarea de programación interactiva a un flujo de trabajo de desarrollo repetible.

Cuándo un espacio de trabajo multimodelo es la mejor herramienta

El acceso directo a la API es la opción más adecuada cuando se necesita una integración a nivel de código, facturación para desarrolladores, metadatos de las solicitudes o controles oficiales de la plataforma. Si tu objetivo es la redacción interactiva, la investigación, la planificación o la comparación de resultados entre distintos proveedores sin tener que desarrollar una aplicación, un espacio de trabajo multimodelo puede resultar más práctico.

Preguntas frecuentes

¿La API Claude es gratuita?

No se garantiza aquí ninguna cuota gratuita universal de API. El uso de la API de Claude se factura por separado a través de la Consola de Claude, y Anthropic indica que la mayoría de las organizaciones financian dicho uso con créditos prepagados, mientras que las organizaciones con facturación mensual son una excepción. Consulta la información actualizada de la Consola y los precios oficiales correspondientes a tu organización antes de enviar solicitudes.

¿Cómo puedo obtener una clave API Claude?

Crea una clave en la consola Claude para la organización correspondiente. Anthropic advierte de que la nueva clave solo se muestra una vez, por lo que debes guardarla en un lugar seguro cuando aparezca. Carga la clave a través de una variable de entorno del servidor o un gestor de secretos, y nunca la expongas en el código del navegador, en capturas de pantalla ni en un repositorio público.

¿Qué ID de modelo Claude debo utilizar?

En este tutorial se utiliza claude-opus-5 porque ese era el modelo que figuraba en la guía oficial de inicio rápido de Anthropic cuando se comprobó el 8 de septiembre de 2026. Elige el modelo que mejor se adapte a tu carga de trabajo y a tu presupuesto, y vuelve a consultar las páginas de «Modelos» y «Modelos obsoletos» de Anthropic, ya que los identificadores de los modelos, los alias y el estado de su ciclo de vida pueden cambiar.

¿Qué punto final utiliza la API Claude?

La primera solicitud de esta guía utiliza el punto final «Messages» en https://api.anthropic.com/v1/messages. Envía un JSON con los encabezados «content-type», «x-api-key» y «anthropic-version». Anthropic también ofrece otras funcionalidades de API, así que consulta la página de referencia correspondiente a la operación que estés implementando.

¿Incluye el plan Claude Pro créditos de API?

En el Centro de ayuda de Anthropic se indica que Claude Pro no incluye el uso a través de la Consola de Claude. La suscripción a Claude.ai y la facturación por API son productos independientes. Configura la facturación por API en la Consola para las solicitudes de los desarrolladores y utiliza nuestro Guía de precios de Claude para una comparación más amplia de las tarifas.

¿Cuánto cuesta una solicitud de API Claude?

El coste depende del modelo seleccionado, los tokens de entrada, los tokens de salida, las escrituras en caché, las lecturas en caché, el modo por lotes y la zona geográfica admisible para la inferencia. Calcula cada categoría multiplicando el número de solicitudes por el número de tokens y por su tarifa efectiva por millón de tokens, y dividiendo el resultado entre un millón; a continuación, suma las categorías. Utiliza la calculadora anterior para obtener una estimación.

¿Por qué me aparece un error 401?

El código 401 indica un error de autenticación. Comprueba que la clave API exista, siga activa, pertenezca a la organización correcta y llegue al servidor en el x-api-key Encabezado. No imprimas ni compartas la clave durante la depuración. Los intentos repetidos no solucionarán el problema de una credencial que falte o sea inválida.

¿Por qué me aparece el error 429?

Un código 429 indica que la solicitud ha superado un límite de frecuencia. Los límites pueden variar según la organización y el nivel de uso, por lo que conviene revisar los encabezados de límite de frecuencia devueltos, así como la Consola o la documentación actual. Reduce la concurrencia, respeta los tiempos de reintento y utiliza un retroceso exponencial acotado con fluctuación, en lugar de repetir inmediatamente la misma ráfaga.

Nota sobre el origen y la frescura: Los ID de los modelos, los precios, el comportamiento de la API y las políticas de asistencia se han comprobado con la documentación oficial de Anthropic a fecha de 8 de septiembre de 2026. Consulta las páginas actuales de modelos y precios antes de utilizarlos en producción y, a continuación, ejecuta los ejemplos con tu propia clave de la consola Claude, tu configuración de facturación y el acceso a tu cuenta.