Guía de inicio rápido
¿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:
- Una cuenta con acceso a la API (consulta nuestra guía aquí sobre cómo obtener acceso a Claude)
- Una clave de API (disponible a través de tu Configuración de cuenta)
- Python 3.7.1 o una versión más reciente instalada en tu computadora
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:
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:
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:
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:
- Abre tu terminal y escribe:
nano ~/.bash_profile
(onano ~/.zshrc
si estás usando una versión más reciente de macOS) - 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'
- Guarda el archivo y sal del editor (presiona
Ctrl+O
, luegoEnter
, luegoCtrl+X
) - Carga el perfil actualizado ejecutando:
source ~/.bash_profile
(osource ~/.zshrc
)
- Abre tu terminal y escribe:
- En Windows:
- Abre el símbolo del sistema y escribe:
setx ANTHROPIC_API_KEY "your-api-key-here"
, reemplazandoyour-api-key-here
con tu clave de API real - 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
- Abre el símbolo del sistema y escribe:
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:
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
- Visita nuestra guía de migración para aprender cómo hacer la transición de tu caso de uso a Claude.
- Explora el glosario de términos para familiarizarte con la terminología utilizada en IA, LLMs y el ecosistema de Claude.
- Únete a nuestro servidor de Discord para desarrolladores para conectarte con otros desarrolladores, hacer preguntas y compartir tus proyectos.
- Visita la biblioteca de prompts para obtener inspiración y prompts listos para usar en varias tareas, o sumerge tus pies en la ingeniería de prompts consultando la introducción a los prompts.
Esperamos ver lo que creas con Claude. ¡Feliz codificación!