Revisada el 2026-10-10
En una frase: la API de Claude permite usar Claude desde tu propio programa.
Una API es una puerta para que un programa hable con otro. Para cruzarla hacen falta tres cosas: una cuenta, una clave secreta y una librería oficial.
La API se factura por uso y tiene su propia cuenta de facturación. Una suscripción al chat no hace que sus llamadas sean ilimitadas.
A veces hay créditos de API para suscriptores. Se comprueban en la cuenta, con un adulto.
Tema avanzado
Esta ficha es para quien programa. Aquí tienes la idea; el código está en la versión adulta, enlazada al final.
Cómo se ve
Qué necesitas
- Una cuenta en la Console, la web de Anthropic para quien programa.
- Una clave de API creada en esa cuenta.
- Python, un lenguaje de programación, y su instalador de paquetes.
La clave es secreta, como la contraseña de tu correo. No se comparte ni se escribe en el código. Crear la cuenta, pedir la clave y pagar es cosa de un adulto.
Qué pasa, paso a paso
- Un adulto crea la cuenta en la Console y genera la clave.
- La clave se guarda en una variable de entorno. Es un dato que el ordenador guarda aparte del código. La librería oficial la lee sola.
- En una carpeta nueva, solo para ese proyecto, se instala el SDK. Es la librería oficial: código ya hecho que te ahorra trabajo.
- Se escribe la primera llamada, de unas diez líneas. Dice qué modelo usar, cuánto puede ocupar la respuesta y qué preguntas. En el ejemplo, la pregunta es: «Explícame qué es un token en dos frases».
- Se ejecuta el programa. La respuesta llega en bloques, como piezas dentro de una caja. El programa saca solo los bloques de texto.
- Se mira el apartado de uso de la respuesta. Cuenta los tokens que entraron y los que salieron. Si se usa la caché, distingue lo que se escribe y lo que se lee. Las herramientas del servidor pueden añadir cargos.
Todo junto es como pedir en el mostrador de una tienda. Enseñas tu carné de cliente, pides y te dan el pedido con el tique.
La documentación usa en su ejemplo un modelo potente. Para hacer pruebas, la versión adulta propone uno más barato.
Un ejemplo de la vida real
Imagina una app que redacta textos con ayuda de Claude. La app llama a la API con una librería oficial.
La clave va en un archivo oculto de configuración. Ese archivo está marcado para no subirse nunca a internet con el código. Así, aunque compartas el código, la clave se queda en tu ordenador.
Es una buena costumbre en cualquier proyecto. La clave va en el entorno, nunca en el código.
Qué modelo elegir y cuánto cuesta
Hay varios modelos de Claude. Unos son más potentes y caros; otros, más rápidos y baratos.
- Los más potentes sirven para razonar mucho y para trabajos largos.
- Los más pequeños van bien en tareas rápidas y repetidas, como clasificar mensajes.
- Todos tienen una ventana de contexto enorme: pueden tener mucho texto a la vista.
- Si dudas, la documentación aconseja empezar por uno potente y subir si no alcanza.
- Pedir muchas tareas juntas, por lotes, cuesta la mitad. Reutilizar un texto ya enviado, guardado en caché, cuesta mucho menos.
Es como elegir transporte: no llamas a un camión para llevar una carta.
Los precios cambian. Están en la versión adulta y en la web oficial. Para elegir según la tarea, mira mejor modelo para cada tarea.
Errores que conviene evitar
- Subir la clave a un repositorio público, un almacén de código abierto a todos. Si pasa, un adulto la anula en la Console y crea otra.
- Olvidar el límite de respuesta. Es obligatorio y limita solo la salida. No frena el gasto total de una app con varias llamadas, caché o herramientas.
- Usar el modelo más caro para tareas simples.
- Creer que la suscripción del chat incluye la API. La API tiene su propia facturación.
Pruébalo tú
- ¿Por qué la clave va en una variable de entorno y no dentro del código?
- Tienes que clasificar mil mensajes cortos. ¿Usas el modelo más potente o uno rápido y barato?
Respuestas
- Porque el código se comparte o se sube a internet. Si la clave va dentro, otra persona podría usarla y gastar a tu costa.
- Uno rápido y barato. Para tareas sencillas y repetidas, el más potente gasta más sin necesidad.
Palabras clave
- API: puerta para que un programa use un servicio, como Claude.
- Clave de API: contraseña secreta que dice quién usa la API y quién paga.
- SDK: librería oficial con código ya hecho para usar la API.
- Variable de entorno: dato que el ordenador guarda aparte del código.
- Token: trozo de texto con el que trabaja el modelo; la API cobra por tokens.