Guía práctica: Novedades de la API de Claude y actualizaciones del Workbench

Si utilizas la API de Claude para atención al cliente, generación de contenido o análisis de código, las últimas actualizaciones son muy prácticas: se ha ampliado la salida máxima de Claude Sonnet 3.5 y la consola (Workbench) ha incorporado funciones para generar prompts y evaluar resultados. A continuación, explicamos las nuevas funcionalidades clave de la API de Claude desde un enfoque 100% aplicable.

Salida ampliada de Sonnet 3.5: De 4096 a 8192 tokens

Dentro de la API de Claude, el límite máximo de tokens de salida para Claude Sonnet 3.5 se ha duplicado, pasando de 4096 a 8192. Esto es especialmente útil para resúmenes extensos, explicaciones de código largo y redacción de lotes de correos. Para activar la salida ampliada, es necesario añadir un encabezado de solicitud beta, no solo modificar el parámetro `max_tokens`.

La sintaxis oficial indicada es: añadir el encabezado "anthropic-beta": "max-tokens-3-5-sonnet-2024-07-15" al llamar a la API de Claude. Se recomienda validar primero los cambios en la longitud de respuesta y el costo con tráfico no crítico, antes de escalar gradualmente, para evitar fluctuaciones en el costo por saturar la salida larga de una sola vez.

Actualización del Workbench de Claude: El generador de prompts ahorra tiempo

El Workbench de la consola de Claude ha incorporado un «Generador de Prompts». Solo debes describir el objetivo de la tarea (por ejemplo, "clasificar solicitudes entrantes de soporte al cliente") y te ayudará a producir una estructura de prompt más completa. Para equipos sin ingeniería especializada en prompts, esto reduce el tiempo de elaboración de "horas" a "minutos".

Lo más importante es que estandariza la implementación de la API de Claude: para una misma tarea se puede obtener rápidamente una "plantilla reutilizable", y luego solo es necesario reemplazar los campos variables. También puedes migrar el prompt generado directamente al código, reduciendo inconsistencias entre entornos.

Modo Evaluación: Compara salidas de prompts en paralelo, menos conjeturas

El Workbench ahora incluye un «Modo Evaluación» que permite comparar en paralelo la salida de dos o más prompts y calificar la respuesta de Claude con una escala de 5 puntos. Esta función es clave para iterar los prompts de la API de Claude, ya que convierte la "sensación subjetiva de mejor" en un resultado de comparación registrable y trazable.

En la práctica, puedes fijar un mismo conjunto de muestras de entrada y probar diferentes instrucciones, formatos o condiciones, para luego establecer la versión con mayor puntuación como estándar del equipo. Este enfoque suele mejorar de forma más estable la calidad de la salida que simplemente alargar el prompt sin criterio.

Panel de Uso y Costos: Seguimiento más intuitivo por USD, tokens y clave API

La consola para desarrolladores añade las pestañas «Usage» (Uso) y «Spend» (Costos), permitiendo rastrear el uso y la facturación de la API de Claude por monto en USD, cantidad de tokens y clave API. Para equipos que ejecutan múltiples proyectos y entornos (pruebas/producción) en paralelo, esto ayuda a identificar rápidamente "quién consumió los recursos".

Se recomienda usar claves API separadas para distintas líneas de negocio y revisar periódicamente este panel: qué endpoints generan respuestas con demasiados tokens, qué escenarios son aptos para formatos de respuesta más cortos. Gestionar los costos de forma proactiva suele ser más efectivo que reconciliarlos al final del mes.

Notas de lanzamiento y recursos: La documentación de la API de Claude es más accesible

La documentación de la API de Claude incluye ahora notas de lanzamiento más completas, cubriendo actualizaciones de la API, la consola de Claude y las aplicaciones de Claude, lo que facilita el registro de cambios de versión. Asimismo, Anthropic ha lanzado nuevos cursos educativos (Fundamentos de la API de Claude, Uso de herramientas de Claude) y ha ampliado el "Claude Cookbook" con guías sobre habilidades clave como citas, RAG y clasificación.

Si estás integrando la API de Claude en un sistema existente, se sugiere primero usar los cursos para comprender la estructura de solicitudes, la conexión de herramientas y la salida estructurada JSON, y luego aplicar los patrones del Cookbook para una implementación más robusta.