Configuración inicial

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

​

Prerrequisitos

Necesitarás:

• Una cuenta de Console de Anthropic
• Una clave API
• Python 3.7+ o TypeScript 4.5+

Anthropic proporciona SDKs de Python y TypeScript, aunque puedes hacer peticiones 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 sacar el máximo provecho de Claude, recomendamos que comiences el proceso de desarrollo en el Workbench, una interfaz web para Claude.

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

En la sección central, bajo User, hagamos una pregunta a Claude.

¿Por qué el océano es salado?

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

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 arroyos han erosionado rocas que contienen sales minerales. Estas sales son transportadas al océano por la escorrentía.
2. Actividad volcánica: Los volcanes submarinos y las fuentes hidrotermales liberan minerales, incluyendo sales, en el agua del océano.
3. Deposición atmosférica: Las partículas de sal del rocío marino pueden ser transportadas por el viento y depositadas de nuevo en el océano.
4. Evaporación: Cuando 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 añadido continuamente sales al océano, mientras que la evaporación elimina agua pura, lo que lleva a los niveles actuales de salinidad del océano. Es importante señalar que la cantidad total de sal en el océano se mantiene relativamente estable porque la entrada de sales está equilibrada por la eliminación de sales a través de procesos como la formación de depósitos de evaporitas.

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

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

Haz clic en Run de nuevo.

La salada agua del mar,
Una historia de tiempo y elementos sin par.
Rocas y lluvia, lenta erosión,
Minerales viajando en solución.
Pasan eones, la sal permanece,
En el vasto dominio acuático que prevalece.

¿Ves cómo ha cambiado la respuesta de Claude? Los LLMs responden bien a instrucciones claras y directas. Puedes poner las instrucciones de rol tanto en el system prompt como 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 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.

​

Instala el SDK

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

• Python
• TypeScript

python -m venv claude-env

pip install anthropic

​

Configura tu clave API

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

• macOS and Linux
• Windows

export ANTHROPIC_API_KEY='your-api-key-here'

​

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 API en el constructor. Si configuraste la clave API como una variable de entorno, puedes omitir esa línea como se muestra a continuación.

• Python
• TypeScript

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    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.

[TextBlock(text="La salada agua del mar,\nUna historia de tiempo y diseño.\nRocas y ríos, sus minerales ceden,\nAcumulándose en el lecho oceánico.\nLa evaporación deja sal atrás,\nEn las vastas aguas, eternamente guardada.", type='text')]

Esta guía rápida muestra cómo desarrollar una aplicación básica, pero funcional, impulsada por Claude usando la Console, Workbench y API. Puedes usar este mismo flujo de trabajo como base para casos de uso mucho más potentes.

​

Siguientes pasos

Ahora que has realizado tu primera petición a la API de Anthropic, es momento de explorar qué más es posible: