AI Open Guide
← Claude · Para quienes construyen

1En una frase

La API es la forma en que un programa habla directamente con Claude: envía un mensaje y recibe una respuesta en forma de datos, para que puedas meter a Claude en tu propia app, web o flujo de trabajo.

2Palabras nuevas

  • API (application programming interface, interfaz de programación de aplicaciones) — una puerta para programas. En lugar de una ventana de chat, tu código envía peticiones y recibe respuestas.
  • Clave de API (API key) — una cadena secreta y larga que identifica tu cuenta. Cualquiera que la tenga puede gastar tu dinero; trátala como una contraseña.
  • Petición y respuesta (Request and response) — lo que envías (el mensaje, el modelo, los ajustes) y lo que vuelve (la respuesta más información como cuántos tokens se usaron).
  • Token — la unidad con la que Claude cuenta el texto, más o menos tres cuartos de palabra. Pagas por cada token que entra y que sale.
  • Consola (Console) — la web de Anthropic para desarrolladores, donde obtienes claves, ves el uso y pones límites de gasto.

3Para qué te sirve

Todo lo que hay hasta ahora en esta guía es una persona hablando con Claude. La API es Claude dentro de algo: un bot de soporte en tu web, una herramienta que resume cada documento que llega, un informe cada noche. Se paga por uso, y los modelos más baratos cuestan una fracción de céntimo por petición.

4Pruébalo ahora

(una cuenta de desarrollador de Anthropic)

  1. Crea una cuenta en la consola de desarrolladores, añade una pequeña cantidad de crédito, pon un límite de gasto mensual y crea una clave de API. (Los planes Max, Ultra y Team ahora incluyen créditos mensuales de API; reclámalos en Billing (Facturación), dentro de la configuración de Claude, vinculando una cuenta de la consola.)
  2. En el workbench (banco de trabajo) de la consola, envía un mensaje de prueba al modelo más pequeño y lee la respuesta.
  3. Pídele a Claude Code: Escribe un script de 20 líneas que envíe un mensaje a la API de Claude usando mi clave desde una variable de entorno, y que imprima la respuesta. Ejecútalo.

5Lo que verás

[Imagen pendiente: el workbench de la consola con una petición y su respuesta.] Una respuesta que contiene el texto de la respuesta, qué modelo respondió, por qué se detuvo y el recuento de tokens. Tu script imprime el texto. La consola muestra el coste.

6Cuidado

  • Nunca pegues una clave en un chat, en código que compartes ni en un archivo de un repo. Guárdala en una variable de entorno o en un almacén de secretos.
  • Pon un límite de gasto antes del primer uso real. Un bucle que llama a la API por error puede gastar muy rápido.
  • Los modelos antiguos se retiran. El 30 de noviembre de 2026, Claude Sonnet 4.5 deja de funcionar en la API y se elimina el modo rápido de Opus 4.8; pasa tus scripts a Sonnet 5.5 u Opus 5.5.

7Ve más allá

Cambia el nombre del modelo y los ajustes en tu script y compara las respuestas y el coste. El Capítulo 6.7 enumera las funciones de la API que marcan la diferencia entre una demo y un producto.