Red de nodos interconectados que representa el grafo de conocimiento de un repositorio generado por Graphify en Claude Code

Cómo Instalar Graphify en Claude Code y Otros LLMs: Mapea tu Repositorio en un Grafo de Conocimiento

PorWeb Marketing MX

Instalar Graphify en Claude Code convierte tu repositorio completo —código, docs, PDFs, imágenes y videos— en un grafo de conocimiento que consultas en segundos en lugar de buscar archivo por archivo con grep. Es una herramienta open source que se integra con Claude Code, Codex, Cursor, Gemini CLI y más de veinte asistentes de IA. En esta guía paso a paso lo instalamos, mapeamos un proyecto real y lo dejamos funcionando de forma automática.

¿Qué es Graphify y por qué usarlo?

Graphify escanea tu proyecto y extrae las relaciones entre archivos, funciones, clases y módulos usando análisis AST con tree-sitter. El resultado es un grafo navegable que tu asistente de IA consulta para entender dependencias e impacto sin releer todo el código.

Al terminar el mapeo obtienes tres archivos dentro de la carpeta graphify-out/:

  • graph.html — visualización interactiva para abrir en el navegador y explorar nodos.
  • GRAPH_REPORT.md — resumen con conceptos clave, conexiones y preguntas sugeridas.
  • graph.json — el grafo completo, consultable cuando quieras sin re-leer los archivos.

Requisitos previos

  • Python 3.9 o superior instalado en tu sistema.
  • Git para clonar el repositorio.
  • Claude Code (u otro asistente compatible) ya configurado.
  • Opcional: una API key de LLM (Gemini, Claude, OpenAI) solo si quieres extraer también docs, PDFs e imágenes. El grafo de código no requiere key.

Cómo instalar Graphify en Claude Code paso a paso

1. Instala el paquete

La vía más rápida es instalarlo desde PyPI. El paquete se publica como graphifyy:

pip install graphifyy

Si prefieres la versión de desarrollo, clona el repositorio oficial e instálalo en modo editable:

git clone https://github.com/safishamsi/graphify.git
pip install -e ./graphify

2. Mapea tu proyecto

Sitúate en la carpeta de tu proyecto y ejecuta el mapeo de código, que no necesita ninguna API key:

python -m graphify update .

Graphify escanea los archivos, hace la extracción AST en paralelo y construye el grafo. En un proyecto mediano genera miles de nodos y comunidades en menos de un minuto. Si quieres incluir documentos e imágenes, define una variable como GEMINI_API_KEY y usa graphify . para la extracción semántica completa.

3. Integra Graphify con Claude Code

Este es el paso que automatiza todo. Ejecuta el instalador para Claude Code:

graphify claude install

El comando escribe una sección en tu CLAUDE.md y registra un hook PreToolUse en .claude/settings.json. A partir de ahí, Claude Code consulta el grafo de conocimiento antes de responder preguntas sobre el código y lo reconstruye automáticamente después de cada cambio. No tienes que hacer nada más.

Instalar Graphify en otros LLMs

Graphify no es exclusivo de Claude Code. Cada plataforma tiene su propio subcomando de instalación que escribe la configuración correcta:

  • Codex: graphify codex install
  • Cursor: graphify cursor install
  • Gemini CLI: graphify gemini install
  • OpenCode, Aider, Amp, Factory Droid y más: graphify install --platform <plataforma>

En total soporta más de veinte asistentes, incluidos Kilo Code, GitHub Copilot CLI, VS Code Copilot Chat, Trae, Kiro y Google Antigravity. Si trabajas con varios asistentes a la vez, este flujo se complementa muy bien con convertir tu WordPress en un servidor MCP con Royal MCP para tener toda tu operación gobernada desde el mismo asistente.

Cómo consultar el grafo de conocimiento

Una vez mapeado el proyecto, puedes interrogar el grafo directamente desde la terminal con cuatro comandos principales:

  • Preguntar: graphify query "¿cómo funciona la autenticación?"
  • Ruta entre nodos: graphify path "NodoA" "NodoB"
  • Explicar un nodo: graphify explain "NombreDeFuncion"
  • Ver impacto de un cambio: graphify affected "NombreDeArchivo"

Con Claude Code integrado, ni siquiera necesitas correr estos comandos a mano: el asistente consulta el grafo por ti. Este enfoque de darle contexto estructurado a la IA sigue la misma lógica de otras integraciones útiles, como instalar Claude SEO en Claude Code o conectar Google Search Console a Claude Code para trabajar con datos reales.

Conclusión

Instalar Graphify en Claude Code toma unos minutos y cambia por completo la forma de trabajar con proyectos grandes: en lugar de rastrear archivos, tu asistente entiende la arquitectura completa desde un grafo. Instálalo, mapea tu repositorio y deja que la IA itere con contexto real.

Preguntas frecuentes

Respuestas rápidas para desarrolladores.
Encuentra aquí todo lo relacionado con la instalación multiplataforma, la automatización de grafos y el uso de API keys con Graphify.

No para el grafo de código. La extracción de código con graphify update funciona sin key. Solo necesitas una API key (Gemini, Claude u OpenAI) si quieres incluir documentos, PDFs e imágenes en el grafo.

Sí. Al ser un paquete de Python funciona en los tres sistemas. En Windows recuerda agregar la carpeta de Scripts de Python a tu PATH o ejecuta los comandos con python -m graphify.

Graphify genera igual el grafo en graph.json, pero la visualización HTML se omite si supera unos 5.000 nodos. Puedes seguir consultando el grafo con los comandos de terminal o ajustar el límite con la variable de entorno correspondiente.

Sí, si instalaste la integración con graphify claude install. El hook reconstruye el grafo después de los cambios de código. También puedes forzar una actualización manual con python -m graphify update .

Sí. Puedes correr el subcomando de instalación de cada plataforma (Claude Code, Codex, Cursor, Gemini, etc.) sobre el mismo proyecto y todos consultarán el mismo grafo de conocimiento.

Publicaciones Similares