de una sola lectura: Un Gancho de Código Claude que Evita Lecturas Redundantes de Archivos
Un desarrollador ha creado un gancho PreToolUse llamado read-once que aborda la tendencia de Claude Code de leer repetidamente los mismos archivos durante una sesión, lo que consume tokens innecesarios.
El Problema y la Solución
Claude Code a menudo vuelve a leer archivos que ya tiene en contexto. Por ejemplo, abrir un archivo de 500 líneas, hacer una pequeña edición y hacer que Claude lea todo el archivo nuevamente cuesta aproximadamente 2,000+ tokens por lectura. En sesiones típicas, los mismos archivos podrían leerse de 5 a 10 veces.
El gancho read-once rastrea qué archivos ha leído Claude en la sesión actual. Cuando Claude intenta volver a leer un archivo sin cambios, el gancho lo bloquea y muestra un mensaje como: "read-once: config.rs (~3,400 tokens) ya está en contexto (leído hace 4m, sin cambios). Ahorro en sesión: ~12,000 tokens."
Cómo Funciona
- En la primera lectura: Registra la ruta del archivo, la hora de modificación y la marca de tiempo, luego permite la lectura normalmente.
- En la relectura de un archivo sin cambios: Bloquea la lectura ya que Claude ya tiene el contenido.
- En la relectura de un archivo modificado: En lugar de permitir una relectura completa, el gancho calcula la diferencia y devuelve solo lo que cambió. Claude ya tiene la versión anterior en contexto y solo necesita el delta. Para un archivo de 500 líneas donde cambiaron 3 líneas, esto usa ~30 tokens en lugar de ~2,000, ahorrando 80-95% en iteraciones de archivos.
Características y Configuración
La herramienta es consciente del TTL con entradas de caché que expiran después de 20 minutos (configurable). Después de la expiración, se permiten relecturas porque Claude puede haber compactado el contexto y perdido contenido anterior.
La configuración se realiza mediante variables de entorno:
READ_ONCE_TTL=1200- segundos antes de que expire el caché (predeterminado 20 min)READ_ONCE_DIFF=1- habilitar modo de diferenciasREAD_ONCE_DIFF_MAX=40- líneas máximas de diferencia antes de recurrir a relectura completaREAD_ONCE_DISABLED=1- desactivarlo por completo
Detalles Técnicos
Toda la herramienta tiene aproximadamente 250 líneas de bash sin dependencias más allá de jq y diff. Tiene licencia MIT y se instala agregándose a sus ganchos .claude/settings.json.
El desarrollador construyó esta herramienta porque ejecuta Claude Code en un bucle autónomo donde los costos de tokens se acumulan rápidamente. Solo el modo de diferencias supuestamente redujo su uso de tokens por sesión en aproximadamente un 30%.
📖 Read the full source: r/ClaudeAI
👀 Ver también
Configuración de Control por Voz Local para Agentes de IA en Apple Silicon
Configura el control de voz local para agentes de IA utilizando Parakeet STT y Kokoro TTS en Apple Silicon para interacciones rápidas e independientes de la nube.
Enjambre Abierto: Sistema de Código Abierto para Ejecutar Miles de Agentes de IA en Paralelo
Open Swarm es un sistema de código abierto que genera miles de agentes de IA paralelos con acceso completo a más de 150 herramientas de internet, incluyendo correo electrónico, redes sociales, Google Workspace, búsqueda web, ejecución de código y programación cron.
Session Inspector para Claude Code proporciona visibilidad en tiempo real de las operaciones de agentes de IA.
Vibeyard, un IDE de terminal de código abierto que envuelve Claude Code, ha añadido una función de Inspector de Sesión que proporciona visibilidad en tiempo real de las sesiones de Claude Code con seguimiento de línea de tiempo, desglose de costos, análisis de herramientas y monitoreo de ventana de contexto.
La Plantilla de Razonamiento Estructurado Mejora la Precisión de la Revisión de Código por IA
Un usuario de Reddit comparte una plantilla de razonamiento estructurado adaptada de una investigación de Meta que obliga a los modelos de IA a completar pasos analíticos específicos antes de generar revisiones de código, mejorando la precisión entre 5 y 12 puntos porcentuales según arXiv:2603.01896.