Hacer tu primera solicitud a la API de Anthropic es sencillo una vez que entiendes la configuración y estructura básicas. Esta guía recorre los pasos esenciales para lograr que Claude responda a tus indicaciones usando Python.
Configurando tu entorno
Antes de hacer cualquier llamada a la API, necesitas instalar los paquetes requeridos y configurar tu clave de API de forma segura.
Primero, instala las dependencias necesarias en tu Jupyter notebook:
%pip install "anthropic<1" python-dotenvA continuación, crea un archivo .env en el mismo directorio que tu notebook para almacenar tu clave de API de forma segura:
ANTHROPIC_API_KEY="your-api-key-here"Este enfoque mantiene tu clave de API fuera de tu código y evita confirmarla accidentalmente en el control de versiones. Siempre agrega .env a tu archivo .gitignore.
Carga las variables de entorno y crea tu cliente de API:
from dotenv import load_dotenv
load_dotenv()
from anthropic import Anthropic
client = Anthropic()
model = "claude-haiku-4-5"Mantén este modelo y esta versión del paquete durante todo el curso. Las versiones más nuevas rechazan configuraciones que las lecciones posteriores enseñan, como temperature y los mensajes de asistente precompletados.
La función create
El núcleo para hacer solicitudes a la API es la función client.messages.create(). Esta función requiere tres parámetros clave:

- model - El nombre del modelo de Claude que deseas usar
- max_tokens - Un límite de seguridad sobre la longitud de la respuesta (no un objetivo)
- messages - El historial de la conversación que estás enviando a Claude
El parámetro max_tokens actúa como un mecanismo de seguridad. Si lo configuras en 1000, Claude dejará de generar después de 1000 tokens incluso si tiene más que decir. Claude no intenta alcanzar este límite: simplemente escribe lo que considera apropiado y se detiene si llega al máximo.
Entendiendo los mensajes
Los mensajes representan la conversación entre tú y Claude, similar a una aplicación de chat. Hay dos tipos de mensajes:

- Mensajes de usuario - Contenido que deseas enviar a Claude (escrito por humanos)
- Mensajes de asistente - Respuestas que Claude ha generado
Cada mensaje es un diccionario con un role (ya sea "user" o "assistant") y content (el texto real).
Haciendo tu primera solicitud
Aquí tienes un ejemplo completo de cómo hacer una solicitud a Claude:
message = client.messages.create(
model=model,
max_tokens=1000,
messages=[
{
"role": "user",
"content": "What is quantum computing? Answer in one sentence"
}
]
)Cuando ejecutas este código, Claude procesará tu solicitud y devolverá un objeto de respuesta que contiene el texto generado junto con metadatos sobre la solicitud.
Extrayendo la respuesta
El objeto de respuesta contiene mucha información, pero normalmente solo quieres el texto generado. Accede a él usando:
message.content[0].textEsto te da una salida limpia y legible como: "La computación cuántica es un tipo de computación que aprovecha los principios de la mecánica cuántica, como la superposición y el entrelazamiento, para procesar información usando bits cuánticos (qubits), lo que potencialmente resuelve ciertos problemas complejos exponencialmente más rápido que las computadoras clásicas."
Con estos conceptos básicos en su lugar, puedes comenzar a experimentar con diferentes indicaciones y construir interacciones más complejas con Claude.