¿Buscas simplemente chatear con Claude? ¡Visita claude.ai!

¿Quieres sumergirte directamente en la comprensión de nuestra API? Consulta nuestra documentación de referencia de API para obtener más detalles.

¡Vamos a ponerte en marcha rápidamente con Claude! En esta guía, te guiaremos a través del proceso de configuración de tu entorno, la instalación de las bibliotecas necesarias y el envío de tu primera solicitud de API a Claude. ¡Comencemos!

Ten en cuenta que, aunque esta guía utiliza nuestro SDK de Python, también mantenemos un SDK de TypeScript y admitimos integraciones HTTP directas. Consulta nuestra documentación de SDKs de cliente y referencia de API para obtener más detalles.


Requisitos previos

Antes de comenzar, asegúrate de tener lo siguiente:

Paso 1: Configura tu entorno

¡Haz una copia de nuestro cuaderno de inicio rápido de Google Colab para comenzar de inmediato sin configurar un entorno!

Primero, asegúrate de tener Python instalado. Abre tu terminal (en macOS) o el símbolo del sistema (en Windows) y escribe:

Shell
python --version

Si ves un número de versión como “Python 3.12.2”, estás listo. Si no, visita el sitio web oficial de Python y descarga la última versión.

(Opcional) Crea un entorno virtual

Aunque no es obligatorio, se recomienda crear un entorno virtual para tus proyectos de Claude. Esto ayuda a mantener organizadas tus dependencias y evita conflictos con otros proyectos. Para crear un entorno virtual, ejecuta:

Shell
python -m venv claude-env

Luego, actívalo:

  • En macOS o Linux: source claude-env/bin/activate
  • En Windows: claude-env\Scripts\activate

Paso 2: Instala el SDK de Python de Anthropic

Con tu entorno configurado, es hora de instalar la biblioteca de Python de Claude. Simplemente ejecuta:

Shell
pip install anthropic

Este comando instalará la última versión de la biblioteca, junto con las dependencias necesarias.

Paso 3: (Opcional) Configura tu clave de API

Para usar Claude, deberás proporcionar tu clave de API. Puedes hacer que tu clave de API esté disponible para todos tus proyectos de Claude configurando una variable de entorno. Así es como:

  • En macOS o Linux:
    1. Abre tu terminal y escribe: nano ~/.bash_profile (o nano ~/.zshrc si estás usando una versión más reciente de macOS)
    2. Agrega esta línea al archivo, reemplazando your-api-key-here con tu clave de API real: export ANTHROPIC_API_KEY='your-api-key-here'
    3. Guarda el archivo y sal del editor (presiona Ctrl+O, luego Enter, luego Ctrl+X)
    4. Carga el perfil actualizado ejecutando: source ~/.bash_profile (o source ~/.zshrc)
  • En Windows:
    1. Abre el símbolo del sistema y escribe: setx ANTHROPIC_API_KEY "your-api-key-here", reemplazando your-api-key-here con tu clave de API real
    2. Para hacer este cambio permanente, sigue estos pasos:
      • Haz clic derecho en ‘Este equipo’ o ‘Mi PC’ y selecciona ‘Propiedades’
      • Haz clic en ‘Configuración avanzada del sistema’
      • Haz clic en el botón ‘Variables de entorno’
      • En la sección ‘Variables del sistema’, haz clic en ‘Nuevo…’ e ingresa ANTHROPIC_API_KEY como el nombre de la variable y tu clave de API como el valor de la variable

Paso 4: Envía tu primera solicitud de API

¡Ya casi estás allí! Enviemos tu primera solicitud de API a Claude. Crea un nuevo archivo de Python (por ejemplo, claude_test.py) y agrega el siguiente código:

Python
import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)

message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0.0,
    system="Responde solo en el estilo de Yoda.",
    messages=[
        {"role": "user", "content": "¿Cómo estás hoy?"}
    ]
)

print(message.content)

Desglosemos lo que está sucediendo aquí:

  • Importamos la biblioteca anthropic, que proporciona una forma conveniente de interactuar con la API de Claude.
  • Creamos una instancia del cliente Anthropic, pasando nuestra clave de API (si configuraste una variable de entorno, puedes omitir esto).
  • Llamamos al método messages.create() para enviar un mensaje a Claude. Especificamos el modelo que queremos usar (claude-3-opus-20240229), el número máximo de tokens en la respuesta (max_tokens=1000), la temperatura (que controla la aleatoriedad de la salida, temperature=0.0 significa una aleatoriedad mínima) y el mensaje del sistema (que establece el contexto para la conversación).
  • Finalmente, imprimimos la respuesta de Claude.

Para ejecutar el código, simplemente escribe python claude_test.py en tu terminal o símbolo del sistema. ¡Deberías ver una respuesta similar a un proverbio de Claude!

Visita Ejemplos de la API de mensajes para obtener más estructuras de ejemplo de llamadas a la API. Para obtener más información sobre los parámetros de la API, consulta la referencia de la API de mensajes.


Próximos pasos

¡Felicitaciones, has enviado con éxito tu primera solicitud de API a Claude! Aquí hay algunos pasos siguientes para continuar tu viaje.

Recursos de la API

Sumérgete en nuestra documentación de la API para obtener más detalles sobre los endpoints y parámetros disponibles.

Echa un vistazo a nuestros SDKs de cliente para obtener un conjunto de herramientas que facilitan la creación e integración de Claude en tus aplicaciones.

Recetario de Anthropic

El recetario de Anthropic alberga un conjunto de recetas en forma de cuadernos de Jupyter. Estos cuadernos presentan código copiable que demuestra cómo usar Claude de manera ingeniosa y efectiva en escenarios más avanzados, como cargar PDFs, uso de herramientas y llamadas a funciones, embeddings y más.

Otros recursos

Esperamos ver lo que creas con Claude. ¡Feliz codificación!