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

Un desarrollador ha escrito una herramienta que ahorra un 70 % de la ventana de contexto de Claude en proyectos grandes. En lugar de leer archivos enteros, el agente de IA accede de forma puntual al código que necesita, justo lo que requiere la tarea.

El problema: el contexto, que es valioso, se malgasta

Claude Code conoce la arquitectura del proyecto gracias a CLAUDE.md y entiende qué archivos se encargan de qué. Pero en la práctica el agente sigue leyendo archivos enteros. Si necesita un solo método, lee la clase completa con todos sus métodos. Si debe encontrar dónde se llama una función, lee directorio tras directorio en busca de patrones. El contexto se esfuma y todavía no se ha hecho ningún trabajo útil.

Un escenario típico: un desarrollador pide a Claude que encuentre un campo en una entidad. El agente abre el archivo completo, aunque solo hacen falta las primeras 20 líneas, con la descripción de los campos y el constructor. O algo más simple: hay que entender la estructura de relaciones entre las tablas de una base de datos. Claude lee archivos SQL enteros, cuando para responder bastaban los nombres de las tablas y las claves.

La ventana de contexto es el recurso principal al trabajar con IA en proyectos grandes. De 200K tokens, 100K pueden ir a leer código que se podría haber obtenido de forma más inteligente.

La solución: un grafo de dependencias y acceso puntual

El desarrollador escribió dos scripts en PHP que funcionan juntos:

buildGraph.php escanea el proyecto una vez y construye un grafo de dependencias en SQLite. Analiza código PHP y JavaScript y extrae clases, métodos, funciones, importaciones y cadenas de herencia. Su ejecución es incremental: en las siguientes pasadas solo actualiza los archivos que han cambiado. Esto tarda entre 100 y 200 milisegundos en un proyecto medio.

claudeSearch.php es una interfaz CLI para agentes. Con un solo comando entrega a Claude exactamente lo que necesita:

• Un método concreto de una clase, con su firma y su cuerpo
• Todos los campos y el constructor de una clase
• La cadena de herencia completa de una entidad
• Todas las consultas SQL a una tabla concreta
• La lista de todas las llamadas a una función en todo el proyecto
• Las dependencias entre módulos

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

Compatibilidad de lenguajes y velocidad

Por ahora, la herramienta es totalmente compatible con PHP y JavaScript. El soporte para Go ya está añadido. C llegará más adelante.

La velocidad de análisis es crítica: el grafo debe actualizarse al menos tan rápido como el desarrollador cambia el código. La actualización incremental resuelve el problema: la primera pasada analiza todo el proyecto (puede tardar unos segundos en un repositorio grande) y las siguientes, en 100–200 ms, actualizan solo los archivos modificados.

Qué aporta en la práctica

Según los cálculos del autor, la herramienta reduce el consumo de tokens un 70 % en un proyecto medio típico. Eso no significa que cada consulta individual ahorre un 70 %, sino que, a lo largo de una sesión de desarrollo, el contexto se aprovecha tres veces mejor. En lugar de gastar 150K tokens en leer y luego 50K en trabajar, el desarrollador puede gastar 70K en buscar y 80K en trabajar.

La herramienta es especialmente útil para asistentes CLI y bots que no ven el sistema de archivos por sí mismos. Para ellos, el grafo se convierte en la fuente de verdad sobre la estructura del proyecto.

Qué significa

La herramienta señala un rumbo: escalar el trabajo con Claude en proyectos grandes no depende solo de las decisiones de arquitectura y de un CLAUDE.md bien escrito. Hace falta un acceso inteligente al código. Lectura puntual en lugar de lectura completa. Un grafo en lugar del sistema de archivos. Cuando el contexto se convierte en una limitación, hay que leer en función de lo que realmente se necesita, no de la cantidad de código.