Anthropic ha publicado una actualización coordinada de sus seis SDK oficiales —Python 1.2.0, TypeScript 0.122.0, Go 1.68.0, Java 2.59.0, Ruby 1.67.0 y C# 12.44.0— que saca de beta las APIs de Files y Skills. En paralelo, Claude Console estrena un sistema de claves que separa por fin las credenciales personales de las de servicio. Es una de esas versiones que no genera titulares y que sin embargo te rompe un despliegue si actualizas sin leer: hay dos cambios con efecto directo sobre código que hoy funciona.
Dos cambios que sí rompen código
El primero es de comportamiento. client.beta.skills.delete() ya no elimina una versión concreta: elimina la skill entera con todas sus versiones. Si tienes un script de limpieza que iteraba versiones antiguas para ahorrar espacio, con la nueva versión del SDK ese mismo bucle se lleva por delante la skill completa en la primera vuelta. No falla, no avisa: hace exactamente lo que le pides, solo que ahora eso significa otra cosa.
El segundo es de tipos. BetaSkill pasa a llamarse BetaContainerSkill. En TypeScript, Java o C# la compilación te lo dirá inmediatamente; en Python o Ruby te enterarás en tiempo de ejecución, con suerte en un entorno de pruebas y no en el cron de las tres de la mañana.
⚠️ Antes de actualizar: busca en tu código skills.delete y BetaSkill. Si aparece el primero, comprueba que de verdad quieres borrar la skill entera; si lo que querías era limpiar versiones sueltas, ese código ya no hace lo que crees. Es una revisión de dos minutos que evita una pérdida irreversible.
Qué pasa si no tocas nada
La buena noticia es que la migración está pensada para no obligar a nadie. Los métodos client.beta.files y client.beta.skills dejan de enviar los headers beta files-api-2025-04-14 y skills-2025-10-02, y devuelven las mismas estructuras que sus equivalentes estables. Pero las peticiones que sigan incluyendo esos headers de forma explícita mantienen el acceso a las versiones anteriores.
Traducido a decisiones: si tu integración manda los headers a mano, puedes actualizar el SDK sin cambiar nada y migrar cuando te convenga. Si confiabas en que el SDK los pusiera por ti, la actualización te mueve a la versión estable de golpe. Merece la pena mirarlo antes de subir la dependencia, sobre todo en proyectos donde el package.json o el requirements.txt permite saltos de versión menores automáticos.
Salir de beta no es un sello de calidad: es el momento en el que dejas de poder culpar a la etiqueta cuando algo cambia bajo tus pies.
Claves de cuenta de servicio: el fin de la API key compartida
El cambio en Claude Console es menos vistoso y probablemente más útil en el día a día. Ahora se pueden crear claves personales y claves de cuenta de servicio, ambas con los permisos específicos del usuario que las genera. Las claves quedan vinculadas a cuentas individuales y se desactivan solas cuando esa cuenta sale de la organización. Y se pueden acotar: o bien a un workspace concreto, o bien con acceso a varios a través de los endpoints administrativos.
Cualquiera que trabaje con varios clientes reconocerá el problema que esto resuelve. La práctica habitual es una clave por proyecto, guardada en el gestor de secretos con suerte, en un archivo .env con menos suerte, y sin ninguna relación con quién la creó ni con qué puede tocar. Cuando alguien deja el equipo o termina la colaboración, la revocación depende de que alguien se acuerde. Con claves ligadas a cuenta, esa desconexión es automática.
La distinción entre clave personal y de servicio también ordena algo que solemos mezclar: la clave con la que tú pruebas cosas en local no debería ser la misma con la que corre una automatización desatendida en producción. Si comparten identidad, comparten cuota, comparten permisos y comparten el rastro en los registros de uso, lo que convierte cualquier investigación de un gasto raro en un ejercicio de adivinación.
Agosto, el mes en que la plataforma salió de beta
Esta versión no es un hecho aislado, sino el enésimo paso de un movimiento sostenido durante todo el mes en la Developer Platform:
- 19 de agosto: computer use y browser use salen de beta, y la Files API y las Agent Skills dejan de requerir headers beta.
- 26 de agosto: los endpoints de sesión de la Compliance API pasan a producción para Cowork y Claude Code, y las transcripciones locales incorporan sesiones de Claude Science y de Claude para Microsoft 365 —Excel, PowerPoint, Word y Outlook— en beta para Enterprise. La Admin API llega a la CLI
anty a siete SDK bajoclient.beta.organization, cubriendo información de la organización, miembros, workspaces y gestión de claves. - 27 de agosto: la actualización coordinada de SDK y el nuevo sistema de claves de la Console.
El patrón es legible: capacidades que llevaban meses en beta se estabilizan, y alrededor de ellas aparece la fontanería aburrida —administración, cumplimiento, credenciales con alcance— que hace falta para vender esto dentro de una empresa. Es exactamente lo que se le pide a una plataforma que quiere dejar de ser un juguete de experimentación.
Qué revisar hoy en tus proyectos
Tres tareas cortas. Primera: busca las dos referencias que rompen —skills.delete y BetaSkill— antes de subir la versión del SDK, y comprueba si tu gestor de dependencias puede actualizarlo solo. Segunda: si tienes integraciones que dependen de headers beta escritos a mano, decide si migras ahora en frío o esperas, pero apunta la decisión en algún sitio; la compatibilidad hacia atrás siempre es temporal. Tercera, y la que más rentabiliza el rato: reparte las claves. Una de servicio por automatización, acotada al workspace que le corresponde, y las personales para lo que haces tú a mano.
Ninguna de las tres es urgente hoy. Las tres son mucho más baratas hoy que el día que hagan falta.
