En este ejemplo, haremos que Claude escriba una función en Python que verifique si una cadena es un palíndromo.

​
Requisitos previos

Para completar este inicio rápido, necesitas:

Anthropic proporciona SDKs de Python y TypeScript, aunque puedes hacer solicitudes HTTP directas a la API.

​
Comienza con el Workbench

Cualquier llamada a la API que hagas, independientemente de la tarea específica, envía un prompt bien configurado a la API de Anthropic. Mientras aprendes a aprovechar al máximo Claude, recomendamos que comiences el proceso de desarrollo en el Workbench, una interfaz web para Claude.

Inicia sesión en la Console de Anthropic y haz clic en Workbench.

En la sección central, debajo de User, hagámosle una pregunta a Claude.

User
¿Por qué el océano es salado?

Haz clic en Run. En el lado derecho, verás una salida como

Response
El océano es salado debido a varios factores:

1. Erosión de rocas: Durante millones de años, la lluvia, los ríos y los arroyos han erosionado rocas que contienen sales minerales. Estas sales son transportadas al océano por la escorrentía del agua.
2. Actividad volcánica: Los volcanes submarinos y las fuentes hidrotermales liberan minerales, incluidas sales, en el agua del océano.
3. Deposición atmosférica: Las partículas de sal de la espuma del océano pueden ser transportadas por el viento y depositadas nuevamente en el océano.
4. Evaporación: A medida que el agua se evapora de la superficie del océano, deja atrás sales disueltas, aumentando la concentración de sal en el agua restante.
5. Procesos biológicos: Algunos organismos marinos contribuyen a la salinidad del océano al liberar compuestos salinos como subproductos de su metabolismo.

Con el tiempo, estos procesos han agregado continuamente sales al océano, mientras que la evaporación elimina el agua pura, lo que lleva a los niveles actuales de salinidad del océano. Es importante tener en cuenta que la cantidad total de sal en el océano permanece relativamente estable porque la entrada de sales se equilibra con la eliminación de sales a través de procesos como la formación de depósitos evaporíticos.

Esta es una buena respuesta, pero digamos que queremos controlar el tipo exacto de respuesta que da Claude. Por ejemplo, solo permitir que Claude responda preguntas con poemas. Podemos controlar el formato, el tono y la personalidad de la respuesta agregando un System Prompt.

System prompt
Eres un poeta de clase mundial. Responde solo con poemas cortos.

Haz clic en Run nuevamente.

Response
La salmuera salada del océano,
Un cuento de tiempo y elementos combinados.
Rocas y lluvia, una lenta erosión,
Minerales transportados en solución.
Pasan eones, la sal permanece,
En el vasto y eterno dominio acuático.

¿Ves cómo ha cambiado la respuesta de Claude? Los LLM responden bien a instrucciones claras y directas. Puedes poner las instrucciones de rol en el system prompt o en el mensaje del usuario. Recomendamos probar para ver qué forma produce los mejores resultados para tu caso de uso.

Una vez que hayas ajustado las entradas de tal manera que estés satisfecho con la salida, y tengas una buena idea de cómo usar Claude, convierte tu Workbench en una integración.

Haz clic en Get Code para copiar el código generado que representa tu sesión de Workbench.

​
Instala el SDK

Anthropic proporciona SDKs para Python (3.7+) y TypeScript (4.5+).

En el directorio de tu proyecto, crea un entorno virtual.

Python
python -m venv claude-env

Activa el entorno virtual usando

  • En macOS o Linux, source claude-env/bin/activate
  • En Windows, claude-env\Scripts\activate
Python
pip install anthropic

​
Configura tu clave de API

Cada llamada a la API requiere una clave de API válida. Los SDKs están diseñados para obtener la clave de API de una variable de entorno ANTHROPIC_API_KEY. También puedes proporcionar la clave al cliente de Anthropic al inicializarlo.

export ANTHROPIC_API_KEY='tu-clave-de-api-aquí'

​
Llama a la API

Llama a la API pasando los parámetros adecuados al endpoint /messages/create.

Ten en cuenta que el código proporcionado por el Workbench establece la clave de API en el constructor. Si estableces la clave de API como una variable de entorno, puedes omitir esa línea como se muestra a continuación.

claude_quickstart.py
import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-5-sonnet-20240620",
    max_tokens=1000,
    temperature=0,
    system="Eres un poeta de clase mundial. Responde solo con poemas cortos.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "¿Por qué el océano es salado?"
                }
            ]
        }
    ]
)
print(message.content)

Ejecuta el código usando python3 claude_quickstart.py o node claude_quickstart.js.

Response
[TextBlock(text="La salmuera salada del océano,\nUn cuento de tiempo y diseño.\nRocas y ríos, sus minerales derraman,\nAcumulándose en el lecho del océano.\nLa evaporación deja la sal atrás,\nEn las vastas aguas, por siempre consagrada.", type='text')]
El Workbench y los ejemplos de código utilizan configuraciones de modelo predeterminadas para: modelo (nombre), temperatura y tokens máximos a muestrear.

Este inicio rápido muestra cómo desarrollar una aplicación básica pero funcional impulsada por Claude utilizando la Console, el Workbench y la API. Puedes usar este mismo flujo de trabajo como base para casos de uso mucho más potentes.

​
Próximos pasos

Ahora que has realizado tu primera solicitud a la API de Anthropic, es hora de explorar qué más es posible:

Guía de ingeniería de prompts

Optimiza el rendimiento de Claude a través de prompts.

Recetario de Anthropic

Aprende con cuadernos interactivos de Jupyter que demuestran cómo cargar PDFs, embeddings y más.

Biblioteca de prompts

Explora docenas de ejemplos de prompts para inspirarte en diferentes casos de uso.

ResumenIntroducción a Claude