Los últimos modelos de Claude y cómo usar una clave API con seguridad

La generación actual de Anthropic es la familia Claude 5. En el momento de escribir (octubre de 2026) incluye Claude Fable 5.1, el modelo más capaz de amplia disponibilidad, además de Claude Opus 5.5, Claude Sonnet 5.5 y Claude Haiku 5.5. Todos funcionan con la misma Messages API, así que cambiar de uno a otro suele reducirse a cambiar un identificador. La gama cambia rápido: toma la tabla como una instantánea y confirma precios e IDs en la documentación oficial antes de fijar un presupuesto.

Mi opción por defecto para funciones de producto y código agéntico es Claude Opus 5.5: es el Opus actual, más barato que su predecesor y suficientemente fuerte para la mayoría de las tareas reales. Claude Sonnet 5.5 sirve para velocidad y volumen: ayuda diaria con código, agentes de soporte y procesos empresariales. Claude Haiku 5.5 encaja en clasificación, enrutado, extracción y otros pasos masivos baratos. Claude Fable 5.1 solo justifica su precio en el razonamiento más difícil y el trabajo autónomo prolongado. Un patrón habitual: un modelo potente para planificar y uno más barato para los muchos pasos pequeños. Mide con tus propios datos: el modelo correcto es el más barato que supera tu conjunto de evaluación.

El código escrito para modelos antiguos de Claude puede romperse con los nuevos. El prefill del asistente se eliminó: controla el formato con salidas estructuradas o instrucciones claras. Los parámetros de muestreo como temperature y top_p se rechazan en la mayoría de los modelos más recientes. En Opus 5.5 el razonamiento no se puede desactivar, así que controla coste y latencia con el parámetro effort, y ten en cuenta que Opus 5.5 usa medium por defecto, no high. Forzar una herramienta concreta con tool_choice se rechaza; usa auto con una instrucción clara y esquemas de herramientas estrictos. Por último, los clasificadores de seguridad pueden cerrar una respuesta con el motivo refusal: comprueba siempre stop_reason antes de leer el contenido y decide qué hace tu producto en ese caso.

Una clave API es una contraseña vinculada a una cuenta de facturación: quien la tiene puede gastar tu dinero y leer lo que contienen tus prompts. Crea las claves en la Consola de Anthropic, da a cada entorno o proyecto su propia clave en un workspace separado, nómbralas con claridad y fija límites de gasto para que una fuga o un bucle descontrolado tengan un techo. Una clave por servicio permite además revocar una sin detener todo.

La clave debe vivir solo en el servidor. Nunca en código de navegador, en el bundle de una app móvil, en un repositorio público ni en una variable con prefijo público como NEXT_PUBLIC_. En Next.js, llama a Claude desde un route handler o una server action, lee la clave del entorno y deja que el frontend hable con tu propio endpoint, que comprueba al usuario, aplica límites de frecuencia y acota el tamaño de la solicitud. El SDK oficial lee ANTHROPIC_API_KEY del entorno automáticamente, así que el cliente se puede crear sin la clave en el código fuente.

En local, guarda la clave en un archivo .env.local ignorado por git y sube solo un .env.example con valores vacíos. En producción usa el almacén de secretos de tu hosting o nube, no un archivo dentro de la imagen. Mantén las claves fuera de logs, informes de error y capturas de pantalla, y activa el análisis de secretos en el repositorio. Si una clave se filtra, revócala de inmediato y crea otra; borrar el commit no basta. En local puedes iniciar sesión con la CLI de Anthropic en vez de gestionar una clave a mano, y para cargas en la nube la federación de identidad de carga de trabajo elimina por completo las claves de larga duración.

Empieza con una llamada desde el servidor: ID del modelo, un max_tokens generoso y streaming si las salidas son largas, para no chocar con los tiempos de espera. Lee los campos usage de la respuesta para ver el coste de cada llamada y añade prompt caching si reenvías el mismo prompt de sistema largo o los mismos documentos: leer de caché cuesta una fracción de la entrada normal. Gestiona errores tipados, porque los límites y las sobrecargas son normales y el SDK ya reintenta algunos. Registra tokens y coste por función desde el primer día para que la factura nunca sorprenda.

Si quieres integrar Claude en tu producto, con manejo de claves, evaluación y control de costes bien hechos, envíame la tarea y su principal restricción.