Cómo instalar Graphify para ahorrar 70% de tokens en Claude Code
Guía completa para configurar Graphify y optimizar tu plan Pro de $20 para que rinda como el de $100, creando un grafo de conocimiento persistente de tu código.
Por Martin Reche ·
Martin Reche · Sistemas de conversión con IA para negocios
Hemos construido sistemas de conversión para más de 50 negocios: desde el anuncio en Meta Ads hasta el cliente cerrado, pasando por la cualificación del lead y la venta. Todo lo que ves en esta guía está funcionando en negocios reales.
QUÉ ES Y POR QUÉ LO NECESITAS
Convierte tu plan de $20 en uno de $100 con un mapa de tu código
El problema: Cada vez que abres Claude Code, empieza desde cero. Para entender tu proyecto, lee archivo por archivo, función por función, gastando miles de tokens solo en 'entender el contexto' antes de ayudarte. La solución: Graphify lee tu código una sola vez y crea un grafo de conocimiento (un mapa completo de archivos, funciones y dependencias). En las siguientes sesiones, Claude consulta este mapa en lugar de releer todo el código. El resultado: Ahorras entre 5x y 70x tokens. Tu plan de $20 dura lo que antes duraba uno de $100, especialmente en proyectos grandes.
¿Qué es exactamente Graphify? Es una herramienta de código abierto que genera un Knowledge Graph de tu proyecto. Funciona como un 'índice' permanente que Claude Code puede consultar instantáneamente sin necesidad de analizar todo el codebase desde cero en cada sesión.
El flujo completo
1. Instala Graphify
Una sola vez por proyecto
2. Indexa tu código
Genera el grafo completo (5-10 min)
3. Trabaja normalmente
Claude consulta el mapa, ahorra tokens
VÍA RÁPIDA: DEJA QUE CLAUDE LO HAGA TODO
El método más simple (recomendado)
No necesitas tocar la terminal ni editar archivos de configuración. Simplemente pégale este prompt a Claude Code y él instalará Graphify, configurará todo y generará el grafo de tu proyecto automáticamente.
Necesito instalar y configurar Graphify en este proyecto para optimizar el consumo de tokens. Por favor:
1. Verifica que tengo Node.js instalado (v18 o superior). Si no lo tengo, indícame cómo instalarlo según mi sistema operativo.
2. Busca el repositorio oficial de Graphify (el que genera knowledge graphs para optimizar Claude Code) y clónalo o instálalo como dependencia global según sea más apropiado.
3. Configura Graphify para este proyecto específico (crea los archivos de config necesarios).
4. Ejecuta la indexación inicial para generar el grafo de conocimiento de todo el codebase.
5. Configura el entorno para que las siguientes sesiones de Claude Code usen este grafo en lugar de releer archivos individuales.
6. Explícame brevemente cómo funciona y cómo sé que está ahorrando tokens.
Ve contándome cada paso que vas realizando y si necesito ejecutar algún comando yo mismo, escríbelo listo para copiar y pegar.Consejo: Una vez que Claude termine, te dirá exactamente qué comandos usar para regenerar el grafo cuando añadas archivos nuevos al proyecto (típicamente `graphify update` o similar).
REQUISITOS PREVIOS
Lo que necesitas antes de empezar
Cuenta Claude Pro
Plan de $20/mes de Anthropic. Graphify optimiza este plan específicamente.
Verifica en: https://console.anthropic.comClaude Code instalado
La herramienta de CLI de Anthropic para desarrollo.
npm install -g @anthropic-ai/claude-codeNode.js 18+
Necesario para ejecutar Graphify.
node --version # Debe decir v18.x.x o superiorGit
Para clonar el repositorio de Graphify.
git --version¿Te trabas en algún paso? Lo vemos en una llamada desde 49€, con acciones por escrito.
Ver sesionesINSTALACIÓN MANUAL (SI PREFIERES HACERLO TÚ)
Paso a paso para instalar Graphify sin agentes
Navega a tu proyecto objetivo
Abre la terminal y entra en la carpeta raíz del proyecto que quieres optimizar. Debes ver archivos como `package.json`, `src/`, `README.md` o similares cuando hagas `ls` o `dir`.
cd ruta/a/tu/proyecto
# Verifica que estás en la raíz
lsInstala Graphify globalmente
Instala la herramienta para poder usarla desde cualquier proyecto. Esto descarga el indexador de código y el generador de grafos.
npm install -g graphify-code
# O si prefieres usar npx sin instalar globalmente:
npx graphify-code initNota sobre el nombre del paquete: Graphify puede estar publicado con diferentes nombres en npm (`graphify-code`, `@graphify/cli`, etc.). Si el comando anterior falla, busca 'graphify claude code' en GitHub para encontrar el repositorio oficial exacto y sus instrucciones de instalación.
Inicializa Graphify en tu proyecto
Este comando crea el archivo de configuración `graphify.config.json` y prepara la estructura para el grafo de conocimiento.
graphify init
# O si usas npx:
npx graphify initGenera el grafo de conocimiento
Este es el paso clave. Graphify analizará todos los archivos de tu proyecto (ignorando node_modules, .git, etc.) y creará un archivo `.graphify/knowledge-graph.json` con el mapa completo de dependencias, funciones y relaciones.
graphify index
# Verás una barra de progreso analizando archivos¿Qué está pasando aquí? Graphify está leyendo cada archivo de código, identificando funciones, clases, imports y exports, y construyendo un grafo relacional. Este proceso gasta tokens una vez, pero ahorrarás esa cantidad multiplicada por 10-70 en futuras sesiones.
Configura Claude Code para usar el grafo
Crea un archivo `.claude-context` en la raíz de tu proyecto. Este archivo le dice a Claude Code que consulte el grafo de Graphify antes de preguntar sobre el código.
echo "Use the knowledge graph at .graphify/knowledge-graph.json to understand code structure before reading files. Consult the graph for: file relationships, function definitions, and imports. Only read source files when specific implementation details are needed." > .claude-contextCÓMO USARLO EN TU DÍA A DÍA
Flujo de trabajo optimizado
Una vez configurado, el flujo cambia radicalmente:
- Abre Claude Code en tu proyecto: `claude`
- Pregunta normalmente: 'Explica cómo funciona el módulo de autenticación' o 'Refactoriza la función handleUserLogin'
- Claude consulta el grafo primero: En lugar de leer 15 archivos para entender la estructura, consulta el knowledge graph en milisegundos y sabe exactamente qué archivos son relevantes.
- Acción específica: Solo lee los archivos específicos que necesita modificar, ahorrando miles de tokens por consulta.
Actualiza el grafo cuando cambie el código
Cada vez que añadas nuevos archivos, funciones o cambies la estructura significativamente, regenera el grafo para mantenerlo actualizado.
graphify update
# O para forzar una reindexación completa:
graphify index --forceERRORES COMUNES Y SOLUCIONES
Si algo no funciona como esperabas
Graphify no encuentra archivos en mi proyecto
Verifica que estás en la carpeta raíz (donde está package.json, .git, o similar). Si tu código está en una subcarpeta específica (como `src/`), configura el directorio base en `graphify.config.json` o ejecuta `graphify init` dentro de esa subcarpeta.
Claude sigue leyendo todos los archivos uno por uno
Asegúrate de que el archivo `.claude-context` existe en la raíz y que Claude Code lo está leyendo. Al iniciar Claude, debería decir 'Loaded context from .claude-context'. Si no, asegúrate de tener la última versión de Claude Code: `npm update -g @anthropic-ai/claude-code`.
El grafo ocupa mucho espacio o tarda mucho en proyectos grandes
Excluye carpetas innecesarias editando `.graphifyignore` (similar a .gitignore). Añade ahí: `node_modules/`, `dist/`, `build/`, `*.test.js`, `coverage/`, etc. También puedes usar `graphify index --exclude '*.md'` para ignorar documentación.
No encuentro el paquete 'graphify-code' en npm
Es posible que el nombre exacto sea diferente o que la herramienta esté en GitHub pero no en npm aún. Busca 'Graphify Claude Code' en GitHub y clona el repo: `git clone https://github.com/[usuario]/graphify.git`. Luego instálalo manualmente con `cd graphify && npm install && npm link`.
Importante: Graphify funciona mejor con proyectos estructurados. Si tu código es un 'spaghetti' sin imports claros ni estructura de carpetas lógica, el grafo será menos útil y Claude podría necesitar leer más archivos de todos modos.
QUÉ PUEDES HACER AHORA CON ESTO
Casos de uso reales para sacarle el máximo provecho
🏢
Onboarding de desarrolladores nuevos
Pasa el grafo a un nuevo dev y pídele a Claude que 'explique la arquitectura del proyecto usando solo el knowledge graph'. Obtendrá un mapa completo en segundos sin gastar tokens en lectura de archivos.
🔍
Refactorización masiva segura
Pide a Claude: 'Usando el grafo, identifica todos los archivos que dependen de la función validateUser y refactorízala'. Claude sabrá exactamente qué tocar sin leer todo el codebase.
🐛
Debugging de dependencias circulares
Consulta el grafo para visualizar importaciones circulares: 'Muestra los ciclos de dependencia entre módulos usando el knowledge graph'. Detecta problemas de arquitectura instantáneamente.
📊
Documentación automática del proyecto
Pide a Claude que genere documentación técnica basándose solo en el grafo: 'Genera un diagrama de arquitectura y descripción de módulos consultando el knowledge graph'. Ahorras tokens y obtienes docs actualizadas.
Repositorio oficial de Graphify
Graphify es un proyecto en evolución. Para la última versión, instrucciones actualizadas y reporte de issues, visita el repositorio oficial.
Si quieres ir más rápido
Sistemas de conversión que funcionan, no demos de IA
Soy Martin Reche. Hemos construido sistemas de conversión para más de 50 negocios: desde el anuncio en Meta Ads hasta el cliente cerrado, pasando por la cualificación del lead y la venta. Todo lo que ves en esta guía está funcionando en negocios reales. Si quieres aplicarlo a tu caso, lo vemos en una llamada: te digo qué montar, con qué y en qué orden, y te lo dejo por escrito. Y si prefieres que lo montemos por ti, eso es NovaChat.
Sistemas de conversión
Del anuncio al cliente cerrado: captación, seguimiento y venta en un solo flujo que funciona.
Cualificación de leads
Cada contacto se filtra, se atiende y se lleva a la venta sin que nadie lo persiga a mano.
Agentes de IA que atienden y venden
Voz, WhatsApp, web e Instagram: responden, cualifican y cierran citas 24/7.
Consultoría 1:1
Desde 49 €: te digo qué montar, con qué y en qué orden, por escrito.
Consultoría 1:1 · Google Meet
Una llamada y sales sabiendo qué hacer y qué no
Me cuentas tu caso en un formulario de dos minutos, pagas, eliges hora. Garantía simple: si en los primeros 10 minutos veo que no te puedo ayudar, te devuelvo el importe. Pack de 3 Revisiones por 249 € si quieres que te acompañe 90 días.
49€
30 min · Diagnóstico 1:1
99€
60 min · Revisión 1:1
149€
90 min · Estrategia 1:1
¿Prefieres que lo montemos por ti?
En NovaChat IA construimos agentes de voz, chatbots y automatizaciones para pymes. Tú lo usas, nosotros lo mantenemos.