Hola a todos, soy Nitin Gavhane. En este artículo analizo habilidades (skills), plugins y herramientas prácticas para Claude Code que ayudan a reducir el desperdicio de tokens, de modo que una jornada habitual de programación se mantenga por debajo de aproximadamente 13 dólares en consumo de API o permita aprovechar durante más tiempo los límites de una suscripción.
Los costos de tokens en Claude Code provienen principalmente de la acumulación excesiva de contexto: archivos CLAUDE.md demasiado grandes que se cargan en cada interacción, salidas completas de la terminal, lecturas repetidas de archivos, historiales de conversación extensos y respuestas demasiado detalladas del modelo.
Las recomendaciones de Anthropic para gestionar sesiones y varias pruebas de rendimiento realizadas por la comunidad muestran que las sesiones sin control suelen consumir entre 200.000 y 400.000 tokens durante una jornada de trabajo intensa. Con las tarifas actuales de Opus y Sonnet, estos costos pueden acumularse rápidamente. Las herramientas que se presentan a continuación están diseñadas para abordar las principales fuentes de ese consumo innecesario.
Las cifras proceden de archivos README de los proyectos, pruebas de rendimiento independientes y recomendaciones publicadas por Anthropic. Los resultados varían según el tamaño del código base y la forma de trabajar, por lo que los porcentajes deben considerarse puntos de referencia y no garantías.
1. codesight
codesight es una herramienta de línea de comandos (CLI) que no requiere dependencias adicionales. Analiza tu proyecto una sola vez y genera un paquete compacto de contexto que incluye un mapa de la estructura, las funciones y exportaciones principales, el grafo de dependencias, las rutas, los esquemas y los puntos de entrada.
Puedes incorporar el contexto generado a una nueva sesión de Claude Code para que el modelo comprenda la organización del proyecto desde el principio, en lugar de consumir entre 25.000 y 60.000 tokens explorando archivos.
Las reducciones de consumo reportadas se sitúan entre 9 y 13 veces en bases de código medianas y grandes.
Instalación y uso
Ejecuta el siguiente comando desde la carpeta raíz del proyecto:
npx codesightPara utilizarlo específicamente con Claude Code:
npx codesight --profile claude-codeO bien:
npx codesight --mcpLa segunda opción permite exponer herramientas a través de MCP.
Al comenzar una sesión, pega el contexto generado o indica a Claude que consulte los archivos de salida de .codesight.
También puedes utilizar opciones adicionales:
--wiki: para generar documentación.
--init: para inicializar la configuración.
--hook: para configurar la actualización automática del contexto.
2. Superpowers Framework
obra/superpowers reúne un conjunto de habilidades para organizar los flujos de trabajo, como brainstorming, planificación, desarrollo guiado por pruebas, depuración sistemática y otras tareas.
Estas habilidades obligan a Claude a seguir una secuencia de trabajo estructurada:
Aclarar → Diseñar → Planificar → Programar → Verificar.
Las comparaciones controladas han mostrado un consumo de tokens aproximadamente entre un 9 % y un 14 % menor, además de reducir los ciclos innecesarios de iteración, porque el agente planifica y realiza pruebas antes de efectuar modificaciones importantes en el código.
Instalación y uso
Dentro de Claude Code, ejecuta:
/plugin install superpowers@claude-plugins-officialTambién puedes registrar primero el marketplace:
/plugin marketplace add obra/superpowers-marketplaceY después instalar el plugin:
/plugin install superpowers@superpowers-marketplaceUna vez instalado, las habilidades se activan automáticamente cuando las tareas son relevantes.
También puedes invocarlas explícitamente mediante estos comandos:
/brainstorm
/write-plan
/execute-planSi las habilidades no aparecen, reinicia Claude Code o inicia una sesión nueva.
3. cost-mode Skill
Sagargupta16/claude-cost-optimizer incluye una habilidad instalable llamada cost-mode, diseñada para optimizar el consumo de tokens.
Esta herramienta elimina contenido innecesario de las respuestas, recomienda modelos más económicos para tareas sencillas, recuerda cuándo conviene compactar el contexto y prioriza los cambios puntuales mediante diferencias de código (diffs) en lugar de reescribir archivos completos.
Los ahorros habituales reportados se sitúan entre el 30 % y el 60 % en cargas de trabajo variadas.
Instalación y uso
Primero, registra el marketplace:
/plugin marketplace add Sagargupta16/claude-cost-optimizerDespués, instala la habilidad:
/plugin install cost-mode@claude-cost-optimizerComo alternativa, puedes instalarla mediante:
npx skills add Sagargupta16/claude-cost-optimizerUna vez instalada, puedes activar diferentes modos dentro de cualquier sesión:
/cost-mode
/cost-mode lite
/cost-mode strict
/cost-mode offEl primer comando activa el modo estándar. Los modos lite y strict permiten ajustar el nivel de optimización, mientras que off desactiva la habilidad.
La configuración permanece activa durante toda la sesión hasta que decidas desactivarla.
4. rtk (Rust Token Killer)
rtk-ai/rtk funciona como una capa intermedia entre Claude Code y la terminal.
Intercepta comandos habituales, como git status, herramientas de ejecución de pruebas, ls, grep y otros, para devolver resúmenes comprimidos en lugar de mostrar toda la salida original.
Según las cifras publicadas por el proyecto, permite reducir entre un 60 % y un 90 % los tokens consumidos por los resultados de esos comandos.
Sin embargo, las pruebas de rendimiento independientes han mostrado resultados variados, por lo que conviene medir su impacto en tu propia carga de trabajo.
Instalación y uso
Puedes instalarlo con el siguiente comando:
curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/master/install.sh | shOtra opción es utilizar Homebrew:
brew install rtkO instalarlo mediante Cargo:
cargo install --git https://github.com/rtk-ai/rtkPara verificar la instalación, ejecuta:
rtk gainEste comando debe mostrar el panel de ahorro de tokens y no un mensaje indicando que el comando no existe.
Después, ejecuta:
rtk init -gCuando el sistema solicite autorización para modificar el archivo settings.json, responde y.
Reinicia Claude Code.
A partir de ese momento, los comandos habituales se reescribirán automáticamente para optimizar sus resultados.
Para confirmar que el hook está activo, utiliza:
rtk init --show5. Headroom
Headroom y su herramienta de línea de comandos de código abierto, disponible en headroomlabs-ai/headroom, funcionan como un proxy local que comprime las salidas extensas de herramientas, registros de actividad (logs) y contenido repetitivo antes de que ingresen al contexto de la conversación.
Los ahorros reportados a nivel de sesión se sitúan aproximadamente entre el 40 % y el 50 % en cargas de trabajo reales con agentes de IA.
Instalación y uso
Puedes instalar Headroom mediante:
pip install "headroom-ai[all]"También puedes utilizar la aplicación de escritorio disponible en su sitio web o instalarla mediante Homebrew Cask.
Después de la instalación, ejecuta:
headroom wrap claudeEste comando inicia el proxy y ejecuta Claude Code.
Si únicamente deseas utilizarlo con herramientas MCP, ejecuta:
headroom mcp installDespués, inicia Claude Code normalmente.
La compresión es reversible, por lo que Claude puede recuperar el contenido original cuando sea necesario.
6. Habilidades progresivas en lugar de un archivo CLAUDE.md demasiado grande
La documentación de Anthropic y varias guías de optimización coinciden en una misma recomendación: el archivo CLAUDE.md se carga en cada interacción.
Por este motivo, conviene trasladar cualquier instrucción que ocupe más de un par de frases a habilidades independientes.
Las habilidades únicamente cargan una descripción breve al iniciar la sesión, generalmente de unas pocas decenas de tokens cada una. Su contenido completo se incorpora al contexto únicamente cuando Claude determina que la habilidad resulta relevante para la tarea.
Un proyecto que contenga veinte procedimientos habituales puede recuperar entre 10.000 y 15.000 tokens por sesión utilizando este enfoque.
Configuración y uso
Mantén el archivo CLAUDE.md limitado a la información esencial:
Tecnologías utilizadas en el proyecto.
Mapa de directorios.
Algunas reglas obligatorias de funcionamiento.
El objetivo recomendado es mantenerlo por debajo de 150 a 200 líneas.
Crea las habilidades como carpetas dentro de alguno de estos directorios:
Para habilidades disponibles a nivel de usuario:
~/.claude/skills/Para habilidades específicas del proyecto:
.claude/skills/Cada habilidad debe incluir un archivo:
SKILL.mdEste archivo debe contener una descripción breve en formato YAML, junto con las instrucciones detalladas correspondientes.
Claude descubre estas habilidades y las carga cuando las necesita.
No se requiere ninguna instalación adicional, aparte de colocar los archivos en las carpetas correspondientes.
7. Hábitos de uso de /compact, /clear y /context
Anthropic explica claramente la importancia de estos comandos en sus recomendaciones oficiales para aprovechar mejor Claude Code.
Los tres comandos están integrados directamente en la herramienta.
Cómo utilizarlos
Utiliza:
/clearEntre tareas que no estén relacionadas.
Esto evita que el contexto de trabajos anteriores siga incorporándose a cada nueva solicitud.
Ejecuta:
/contextAl comenzar una sesión nueva para comprobar qué información se encuentra cargada.
Esto incluye el prompt del sistema, las herramientas MCP y las habilidades disponibles.
También puedes utilizar:
/compactAntes de interrumpir tu trabajo.
Compactar la conversación mientras la caché del prompt todavía está activa resulta más económico que tener que reconstruir el contexto posteriormente.
Estos tres comandos tienen un costo prácticamente insignificante y ayudan a eliminar una de las principales fuentes de crecimiento silencioso del consumo de tokens.
8. Subagentes para tareas exigentes
Cuando Claude necesita buscar información en numerosos archivos, ejecutar pruebas largas o explorar una parte extensa del código, es recomendable delegar ese trabajo a un subagente.
Los subagentes disponen de su propia ventana de contexto.
Esto significa que el trabajo realizado por el subagente no tiene que incorporarse íntegramente a la conversación principal.
Únicamente se devuelve el resumen final o el resultado de la tarea.
Cómo utilizarlos
Puedes solicitar explícitamente a Claude que utilice un subagente o la herramienta Task para realizar la parte más exigente del trabajo.
Por ejemplo:
Utiliza un subagente para buscar en todo el código cada llamada a X y devuelve únicamente las ubicaciones encontradas y un breve resumen.
De esta forma, la sesión principal mantiene un contexto reducido y evita acumular información innecesaria.
No es necesario instalar ningún componente adicional, ya que se trata de una funcionalidad nativa de Claude Code.
9. Plugins de inteligencia de código
Anthropic recomienda utilizar plugins de inteligencia de código para trabajar con lenguajes de programación que cuentan con sistemas de tipos.
Estos plugins permiten a Claude navegar directamente entre símbolos, funciones, clases y definiciones, en lugar de depender de búsquedas repetitivas de texto o de la lectura completa de archivos.
Reducir la cantidad de lecturas exploratorias también disminuye los tokens necesarios simplemente para localizar una función o un tipo de dato.
Instalación y uso
Puedes explorar los plugins disponibles mediante:
/pluginTambién puedes instalar directamente el plugin del servidor de lenguaje correspondiente.
Por ejemplo, para TypeScript:
/plugin install typescript-lsp@claude-plugins-officialExisten alternativas equivalentes para otros lenguajes:
Python: Pyright.
Go: gopls.
Rust: rust-analyzer.
El ejecutable del servidor de lenguaje debe estar previamente instalado y disponible en la variable de entorno PATH.
Después de instalarlo, Claude utiliza automáticamente las herramientas de navegación estructurada y recibe diagnósticos tras modificar el código.
10. Cambiar de modelo y nivel de esfuerzo según la tarea
No todas las tareas requieren utilizar el modelo más costoso o la configuración de esfuerzo más elevada.
Para generar código repetitivo, corregir errores sencillos, dar formato a archivos o realizar consultas básicas, puedes utilizar Haiku o un nivel de esfuerzo medio.
Una serie de pruebas publicada mostró una reducción aproximada del 45 % en los tokens de salida al pasar de un nivel de esfuerzo alto a uno medio, utilizando el mismo conjunto de tareas y con una pérdida de calidad reducida en trabajos rutinarios.
Configuración y uso
Selecciona el modelo y el nivel de esfuerzo al comenzar la sesión.
Por ejemplo, puedes utilizar:
/modelTambién puedes establecer estas opciones mediante los parámetros de inicio de la sesión.
Cambiar el modelo o el nivel de esfuerzo durante una conversación puede invalidar la caché del prompt y aumentar el costo.
Por este motivo, es recomendable decidir qué configuración utilizar antes de comenzar.
Utiliza Haiku para trabajos sencillos y reserva los modelos de mayor capacidad para tareas de arquitectura de software o depuración compleja.
Conclusión
Combinar varias de estas técnicas puede generar un efecto acumulativo considerable en el consumo de tokens.
Mantener un archivo CLAUDE.md reducido y complementarlo con habilidades, utilizar codesight para comprender la estructura del proyecto, incorporar cost-mode o Headroom para eliminar información innecesaria, delegar la exploración a subagentes y seleccionar cuidadosamente el modelo permite reducir de forma importante el consumo durante las sesiones.
Aplicadas conjuntamente, estas prácticas pueden reducir sesiones que normalmente consumen alrededor de 300.000 tokens hasta niveles que permitan mantenerse cómodamente por debajo de un objetivo de 13 dólares diarios para un uso moderado de la API, o prolongar el aprovechamiento de los límites de un plan Max.
¿Cuáles de estas herramientas has utilizado en un proyecto real? ¿Qué diferencias observaste en el consumo de tokens antes y después de implementarlas?
Gracias por leer Código en Casa.
Si esto te a ayudado y te sumo algo Dale un 👏 , compártelo con tu red o dejame un comentario para saber tu opinión.