Saltar al contenido

Guía 04 · Claude Code · 5 min de lectura

Claude gasta menos tokens con un mapa

Le das a Claude un índice de tu carpeta y deja de buscar a ciegas: abre menos archivos y gasta menos en cada pregunta. Es lo que instalé en mi carpeta de trabajo, de casi 2.000 archivos. Dos comandos para instalar, uno para armar el mapa. La herramienta es gratis; lo que cuesta son los tokens de la primera pasada.

01 / 04 · por qué te importa

Claude relee la conversación entera en cada paso

El modelo no tiene memoria entre un paso y el siguiente. Cada vez que busca un archivo, lo abre o te responde, vuelve a leer todo lo que hay en la conversación. Si para encontrar algo abrió seis archivos que no eran, esos seis se quedan en el contexto y los vuelve a leer en cada paso de la sesión. Una búsqueda a ciegas no se paga una vez: se paga el resto del día.

El mapa es un índice: ruta, fecha y de qué trata cada archivo. Con eso Claude va a los dos o tres que importan en vez de tantear. Esto fue la misma pregunta en mi carpeta, en dos chats nuevos, el 7-oct-2026:

Sin mapa«cuáles son las mejores clases que he hecho»
6 búsquedas · 48.187 tokens de búsqueda · 989.019 tokens procesados en total.
Con mapala misma pregunta
4 búsquedas · 8.210 tokens de búsqueda · 553.811 procesados. La sesión completa cerró en 3,6 millones contra 4,6 sin mapa.

Es una medición mía, una vez por lado: una señal, no un estudio. Y no siempre gana: en una pregunta con nombres propios y una sola carpeta clara, el mapa ahorró búsqueda pero empató en el total. Gana en las preguntas difusas, donde no sabes en qué archivo está lo que buscas. Si tu carpeta tiene menos de cien archivos, no lo necesitas: con un archivo de texto que describa qué hay en cada carpeta, alcanza.

02 / 04 · instala

Instala graphify

Dos comandos, desde la terminal de tu sistema, no desde el chat de Claude (yo lo hice primero desde la terminal de la app de Claude y quedó en un espacio aislado: fuera de la app, graphify no existía). En Windows abre PowerShell (búscala en el menú Inicio); en Mac, la app Terminal. Pega una línea, envíala, espera a que termine, y sigue con la siguiente. No necesitas tener Python: uv lo trae solo.

  1. 01

    Windows · uv, el que instala herramientas de Python (después cierra PowerShell y ábrela de nuevo)

    winget install -e --id astral-sh.uv --accept-source-agreements --accept-package-agreements

  2. 02

    Windows · graphify. Va con doble «y»; lo de los corchetes le agrega la lectura de PDF, Word y Excel

    uv tool install "graphifyy[pdf,office]"

  1. 01

    Mac · uv (si no tienes Homebrew, instálalo antes desde brew.sh)

    brew install uv

  2. 02

    Mac · graphify. Doble «y»; los corchetes agregan la lectura de PDF, Word y Excel

    uv tool install "graphifyy[pdf,office]"

Comprueba que quedó: graphify --version. Al escribir esto respondía 0.9.74. Si la terminal dice que no conoce graphify, escribe uv tool update-shell, ciérrala y ábrela de nuevo. Después, en la misma terminal, conéctalo a Claude Code:

Es el camino que recomienda la documentación oficial. Yo lo instalé con pipx (pipx install "graphifyy[pdf,office]") y funciona igual; si ya tienes pipx, úsalo.

  1. 01

    Windows y Mac · instala la orden /graphify en tu Claude Code

    graphify install

03 / 04 · arma el mapa

Deja fuera lo sensible, arma el mapa y pídeselo

Primero lo que no entra. Lo que entra al mapa, Claude lo lee. Antes de armarlo, deja en la raíz de tu carpeta un archivo llamado .graphifyignore con una línea por carpeta o archivo que no debe entrar: datos de clientes, contraseñas, archivos .env. Pídeselo a Claude Code con tu carpeta abierta:

  1. 01

    En Claude Code, con tu carpeta elegida. Cambia las rutas por las tuyas

    Crea en la raíz de esta carpeta un archivo llamado .graphifyignore con estas líneas, una por línea: clientes/datos-pacientes/, *.env y *.credentials.json. No lo abras ni lo cambies después.

Después el mapa. En ese mismo chat, escribe la orden. Claude lee los archivos y deja todo en una carpeta nueva, graphify-out: el mapa (graph.json), un gráfico para verlo en el navegador (graph.html) y un informe en texto (GRAPH_REPORT.md).

  1. 01

    Arma el mapa de la carpeta abierta. La primera vez tarda

    /graphify .

  2. 02

    Cuando cambien tus archivos: solo relee lo que cambió

    /graphify . --update

Lo que cuesta: entre 8.000 y 20.000 tokens por archivo la primera vez. Mi carpeta, de casi 2.000 archivos, costó unos 16 millones. Actualizar después cuesta solo lo que cambió. Y una cosa más: graphify guarda copias en texto de tus Word y Excel en graphify-out/converted. Si tu carpeta tiene datos de personas, borra esa subcarpeta cuando termine.

Pídeselo

Desde ahí, cuando necesites algo, dile que use el mapa. Si quieres ver tu carpeta desde arriba, abre graphify-out/graph.html en el navegador.

  1. 01

    En cualquier chat nuevo sobre esa carpeta

    usa el mapa de graphify y dime dónde quedó la última propuesta que le mandé a este cliente

Opcional, es lo que tengo yo: registrar el mapa como herramienta de Claude Code, para que lo consulte solo sin pasar por la terminal. Necesita que graphify se haya instalado con mcp entre los corchetes (uv tool install --force "graphifyy[pdf,office,mcp]"). Después, en PowerShell o Terminal, cambiando la ruta por la de tu carpeta: claude mcp add graphify -s user -- graphify-mcp "C:\ruta\a\tu\carpeta\graphify-out\graph.json". Lo compruebas con claude mcp list.

04 / 04 · si algo falla

Lo que me salió mal, para que no te pase

  • «graphify» no se reconoce como comando: cierra la terminal y ábrela de nuevo; si sigue, uv tool update-shell y otra vez cerrar y abrir. Si lo instalaste desde el chat de Claude, desinstálalo con uv tool uninstall graphifyy y repite el 02 desde PowerShell.
  • No lee mis PDF, Word o Excel: te faltaron los corchetes al instalar. Reinstala con uv tool install --force "graphifyy[pdf,office]" y vuelve a correr /graphify . --update.
  • El mapa me dio un precio viejo. Apuntó a un documento de agosto que ya estaba superado. Para precios, fechas y estados, pídele a Claude que use el archivo más reciente y lo confirme en el original. El mapa dice dónde está algo, no si sigue vigente.
  • Medí mal la primera vez. Miré el círculo de contexto, que muestra el tamaño del chat, no lo que Claude leyó. Lo que baja con el mapa es lo que agrega cada búsqueda y lo que el modelo procesa sumando cada paso.
  • Cowork no veía el mapa. Abría subcarpetas. En Cowork elige la carpeta raíz, la que tiene graphify-out adentro.
  • Lo que vive fuera de la carpeta no está en el mapa. Mis tareas programadas viven en otra carpeta y no aparecían. El mapa es de la carpeta que le diste, nada más.

Si sigue fallando, pégale a Claude el mensaje de error completo y pídele que lo resuelva.

tu turno

Mide si te sirve

Haz la misma pregunta dos veces, cada una en un chat nuevo: una sin mapa y otra con él. Elige una pregunta difusa, de esas en que no sabes en qué archivo está la respuesta, y compara cuántos archivos abrió y cuánto tardó cada vez. Si prefieres verlo hecho en video, la clase está en SystemIA LAB, la comunidad; entrar es gratis.

Cuéntame tus dos números, con y sin mapa: por Instagram a @jose.digital.ia o, si estás en el LAB, ahí mismo. Si el mapa te lo arma Claude pero después responde peor, la guía 02 dice qué comando toca.