Cómo ahorrar un 70% de los tokens de Claude con acceso puntual al código

Un desarrollador creó una herramienta que ahorra el 70% de la ventana de contexto de Claude al trabajar con proyectos grandes. En lugar de leer archivos completos, un agente de IA obtiene acceso dirigido al código necesario — exactamente lo que se requiere para la tarea.

Problema: el contexto valioso se desperdicia

Claude Code conoce la arquitectura del proyecto desde CLAUDE.md y entiende qué archivos son responsables de qué. Pero en la práctica, el agente sigue leyendo archivos completos. Necesita un método — lee la clase completa con todos sus métodos. Necesita encontrar dónde se llama una función — lee directorio tras directorio buscando patrones. El contexto se agota rápidamente y no se ha realizado ningún trabajo útil aún.

Un escenario típico: un desarrollador le pide a Claude que encuentre un campo en una entidad. El agente abre el archivo completo, aunque solo necesita las primeras 20 líneas con descripciones de campos y constructor. O más simple: entender la estructura de relación entre tablas de base de datos. Claude lee archivos SQL completos, aunque solo los nombres de tablas y claves serían suficientes para la respuesta.

La ventana de contexto es el recurso principal al trabajar con IA en proyectos grandes. De 200K tokens, 100K podrían gastarse leyendo código que podría haberse obtenido de manera más inteligente.

Solución: gráfico de dependencias y acceso dirigido

El desarrollador creó dos scripts PHP que funcionan juntos:

buildGraph.php — escanea el proyecto una vez y construye un gráfico de dependencias en SQLite. Analiza código PHP y JavaScript: extrae clases, métodos, funciones, importaciones, cadenas de herencia. La ejecución es incremental — en ejecuciones posteriores, actualiza solo los archivos que han cambiado. Esto toma 100–200 milisegundos para un proyecto mediano.

claudeSearch.php — interfaz CLI para agentes. Con un comando, da a Claude exactamente lo que necesita:

• Un método de clase específico con firma y cuerpo
• Todos los campos y el constructor de la clase
• Toda la cadena de herencia para una entidad
• Todas las consultas SQL para una tabla específica
• Una lista de todas las llamadas de función en todo el proyecto
• Dependencias entre módulos

En lugar de `Read(path/to/huge-file.php)`, Claude ahora escribe `search("User", "fields")` y obtiene 15 líneas. En lugar de leer tres directorios, escribe `search("saveOrder()", "calls")` y ve todos los lugares donde se usa este método.

Soporte de lenguajes y rendimiento

Actualmente, la herramienta admite completamente PHP y JavaScript. El soporte para Go ya se ha añadido. C vendrá después. La velocidad de análisis es crítica — el gráfico debe actualizarse tan rápido como el desarrollador cambia el código. Las actualizaciones incrementales resuelven este problema: el primer paso analiza todo el proyecto (puede tomar varios segundos en un repositorio grande), los pasos posteriores actualizan solo archivos modificados en 100–200 ms.

Lo que ofrece en la práctica

Según los cálculos del autor, la herramienta reduce el consumo de tokens en un 70% para un proyecto mediano típico. Esto no significa que cada solicitud individual ahorre el 70% — significa que durante una sesión de desarrollo, el contexto se utiliza 3 veces más eficientemente. En lugar de gastar 150K tokens leyendo y luego 50K trabajando, un desarrollador puede gastar 70K buscando y 80K trabajando.

La herramienta es especialmente útil para asistentes CLI y bots que no pueden ver el sistema de archivos por sí mismos. El gráfico se convierte en la fuente de verdad sobre la estructura del proyecto para ellos.

Lo que significa

La herramienta apunta en una dirección: escalar el trabajo de Claude en proyectos grandes no es solo cuestión de decisiones arquitectónicas y un CLAUDE.md bien escrito. Lo que se necesita es acceso inteligente al código. Lectura dirigida en lugar de completa. Gráfico en lugar de sistema de archivos. Cuando el contexto se convierte en una limitación, necesitas leer basado en lo que realmente necesitas, no en el volumen de código.