Anthropic amplía los errores del SDK de Python 2.6

Anthropic ha publicado la versión 2.6.0 de su SDK oficial para Python, la biblioteca que usan los desarrolladores para llamar a la API de Claude desde sus aplicaciones. La actualización añade códigos de error para los límites de rampa (ramp limits) y para los fallos de validación de External Key, y permite cerrar la sesión de los miembros de una organización en todos los dispositivos. También incluye correcciones de errores y mejoras en la documentación.

Qué hay detrás

Un SDK traduce las llamadas a la API en código cómodo de usar, y en la práctica los errores son lo que más trabajo da. Una aplicación que recibe un fallo genérico no sabe si debe reintentar, esperar o avisar a un administrador. Por eso buena parte de los cambios de esta versión van en la misma dirección: códigos y tipos de error más precisos, documentados método por método.

Hay además un matiz relevante. Claude también se ofrece a través de las plataformas de nube de AWS (Amazon Bedrock) y Google Cloud (Vertex AI), y el SDK incluye clientes específicos para ellas. Una de las correcciones hace que las excepciones de código y de estado funcionen también en esos clientes, de modo que un error se trate igual independientemente de dónde se consuma el modelo. Otra corrige que las copias creadas con copy y with_options no conservaban el http_client personalizado ni el aws_profile.

El material no explica qué activa exactamente los límites de rampa ni los fallos de External Key. Conviene consultar la documentación de la API antes de tratar esos códigos en producción.

Claves

• Errores más específicos: los nuevos códigos permiten distinguir causas que antes llegaban mezcladas.
• Clientes de nube: las excepciones de estado y código ya se lanzan en los clientes de Bedrock y Vertex.
• Copias del cliente: copy y with_options mantienen ahora la configuración personalizada.
• Telemetría: el SDK deja de registrar los parámetros de muestreo en los spans de OpenTelemetry.
• Pruebas: la suite elimina las variables de entorno ANTHROPIC_ y AWS_ antes de ejecutarse, para evitar resultados contaminados por la configuración local.