Claude Code publicó hoy la versión 2.1.261, y la novedad principal ataca un problema que casi nadie mide: el contexto que consumes sin darte cuenta. El nuevo comando /skill-doctor lista las skills que tienes cargadas pero no estás usando, y pone al lado de cada una cuánto contexto te está costando. Con esa foto delante, podar deja de ser una intuición y pasa a ser una decisión con números.
La entrega incluye además dos ajustes nuevos para la salida de comandos y tareas, una forma de pasar prompts de subagente demasiado largos para la línea de comandos, y una línea de diagnóstico en /status y claude doctor que explica por qué no se pudo cargar la política de la organización.
Una skill cargada ocupa sitio aunque no la llames
Este es el punto que conviene entender antes de mirar el comando. Las skills disponibles se anuncian al modelo aunque no se usen: su nombre y su descripción viajan en el prompt para que Claude sepa que existen y pueda decidir invocarlas. Eso significa que cada skill instalada tiene un coste fijo por sesión, se utilice o no.
Con dos o tres skills el efecto es despreciable. El problema aparece cuando llevas meses acumulando: un plugin que probaste una tarde, un paquete que instalaste para un cliente concreto, tres o cuatro skills de un marketplace que te parecieron interesantes. Nadie desinstala nada, porque nada se rompe. Simplemente arrancas cada sesión con menos espacio útil y con una factura ligeramente más alta, sin ninguna señal que te lo indique.
Y el coste no es solo económico. El contexto ocupado por descripciones que no vas a usar es contexto que no está disponible para el código, para los ficheros del proyecto o para el historial de la conversación. En sesiones largas, esa diferencia se traduce en compactaciones más frecuentes y en la sensación —tan común como difícil de diagnosticar— de que el modelo «se olvida» antes de lo que debería.
Qué te devuelve exactamente el diagnóstico
/skill-doctor responde a dos preguntas concretas: qué skills están cargadas y sin usar, y cuánto contexto consume cada una. No decide por ti ni desinstala nada; produce el inventario que hasta ahora había que reconstruir a mano revisando configuraciones y plugins uno por uno.
La lectura práctica es sencilla: lo que aparezca como no utilizado y con un coste apreciable es candidato inmediato a salir. Lo que no uses pero cueste poco puede quedarse sin remordimientos. Y si algo que sí usas aparece con un coste alto, al menos ya sabes qué estás pagando por tenerlo.
💡 Cómo usarlo sin llevarte sorpresas
Ejecútalo en un proyecto donde trabajes a diario, no en uno recién abierto: el listado de lo no utilizado solo es significativo si la sesión ha tenido tiempo de usar lo que de verdad necesita. Y antes de retirar algo, comprueba si forma parte de un flujo automatizado que se lanza sin que tú lo veas; ahí la ausencia de uso interactivo no significa que no haga falta.
Hasta 128K caracteres antes de volcar la salida a un archivo
Los otros dos ajustes de la versión son bashOutputMaxChars y taskOutputMaxChars, que controlan cuánta salida de comandos y de tareas recibe Claude en línea antes de que se guarde en un archivo. El nuevo límite llega hasta 128.000 caracteres.
Quien haya depurado un build o un test suite largo conoce el problema que resuelven: justo cuando la traza se pone interesante, la salida se corta y acaba en un fichero que hay que volver a abrir, lo que rompe el hilo del diagnóstico y añade pasos innecesarios. Subir el umbral evita ese corte en los casos en los que la salida es grande pero toda ella es relevante.
Conviene, eso sí, subirlo con criterio. Ese texto entra en el contexto y se paga como entrada, así que un valor máximo aplicado a comandos que escupen decenas de miles de líneas de log rutinario consigue justo lo contrario de lo que busca /skill-doctor. El ajuste sensato es subirlo donde te está estorbando, no de forma global.
Prompts de subagente que ya no caben en una línea
La tercera novedad es --append-subagent-system-prompt-file, pensada para cuando el prompt de sistema de un subagente es demasiado largo para pasarlo por la línea de comandos. En lugar de encajarlo como argumento, se apunta a un fichero.
Es una mejora pequeña con una consecuencia buena: el prompt pasa a vivir en un archivo versionable, revisable en un diff y compartible con el equipo, en vez de dentro de una cadena escapada en un script de arranque. Si orquestas subagentes desde n8n o desde un pipeline de CI, este cambio elimina uno de los puntos donde más fácil es romper algo sin enterarse: un carácter mal escapado en una cadena kilométrica.
Por qué no cargó la política de tu organización
Cierra la versión una línea de «Organization policy» en /status y en claude doctor que explica el motivo cuando la política de la organización no se ha podido cargar. Es puro diagnóstico, y afecta sobre todo a equipos con configuración gestionada.
El escenario que resuelve es conocido: alguien tiene una restricción aplicada y otro no, nadie sabe por qué, y se pierden dos horas comparando configuraciones. Tener el motivo escrito en /status convierte esa investigación en una consulta de diez segundos.
Por dónde empezar a podar hoy
Si vas a dedicarle diez minutos a esta actualización, dedícaselos al inventario. Actualiza, trabaja media hora con normalidad y lanza /skill-doctor. Lo que aparezca arriba del listado, sin uso y con coste alto, es contexto que llevas meses pagando por nada.
El patrón de fondo de las dos últimas versiones es el mismo, y merece la pena señalarlo: primero fue saber por qué se te caía la caché, ahora saber qué ocupa tu contexto. Claude Code está convirtiendo en visible lo que antes solo se notaba en la factura, y eso es exactamente lo que necesitas para trabajar de forma sostenible con sesiones largas.
