El plugin de Graph Indexer para Claude Code se instala con dos comandos, /plugin marketplace add MaquinaTech/graph-indexer y /plugin install graph-indexer@graph-indexer. Incluye el servidor MCP de Graph Indexer, tres hooks y un sub-agente code-structure de solo lectura, de modo que Claude Code obtiene referencias exactas, grafos de llamadas e impacto de cambios desde un índice local, sin modelo y sin red.
¿Cómo instalo el plugin de Graph Indexer en Claude Code?
Ejecuta estos dos comandos dentro de Claude Code:
/plugin marketplace add MaquinaTech/graph-indexer
/plugin install graph-indexer@graph-indexerEl primero registra el marketplace graph-indexer desde el repositorio de GitHub. El segundo instala desde él el plugin del mismo nombre. Necesitas Node.js 22.5 o superior, el mismo requisito que la instalación con npx.
¿Qué incluye el plugin?
El plugin de Graph Indexer (licencia MIT, publicado por MaquinaTech) contiene tres piezas:
| Componente | Qué hace |
|---|---|
| Servidor MCP | Ejecuta npx -y graph-indexer@3.0.0 serve y expone las ocho herramientas de solo lectura: read_code, search_text, search_code, find_references, call_graph, change_impact, check_changes y outline |
| Hooks | PostToolUse (sobre Edit, Write, MultiEdit, Grep, Bash y Read), SessionStart y SubagentStart |
Sub-agente code-structure | Un ayudante de solo lectura sobre el modelo pequeño haiku que responde preguntas de llamadas, llamadores, subclases e impacto de cambios y no puede editar archivos |
El servidor indexa el repositorio git que contiene el directorio donde corre Claude Code, así que no hace falta el argumento --repo.
¿Qué hacen los hooks?
Los hooks de Graph Indexer meten el índice en el flujo normal de Claude Code y se quedan en silencio salvo que tengan algo útil que aportar. Tras una edición, PostToolUse ejecuta el comprobador sobre el archivo editado: errores de sintaxis introducidos, llamadas que ya no encajan con una firma cambiada y nombres eliminados que siguen en uso. Cuando el agente lleva un rato buscando y leyendo sin editar, indica además dónde están definidos los nombres de las líneas leídas y, tras un grep de un nombre compartido, cuál definición es cuál. SessionStart añade una línea que avisa de que el índice existe y lo construye en segundo plano si falta. SubagentStart da esa misma línea y las reglas de consulta a los sub-agentes. El comando del hook del plugin es un cliente pequeño que habla con el proceso residente local que mantiene el servidor MCP, responde en decenas de milisegundos y falla en abierto: ante cualquier error no imprime nada.
¿Qué hace el sub-agente code-structure?
El sub-agente code-structure responde preguntas estructurales de forma exacta y breve desde el índice, con un modelo pequeño: todas las llamadas a un método (distinguiéndolo de métodos con el mismo nombre en otras clases), llamadores de llamadores, clases que extienden o implementan un tipo, y qué afectaría un cambio con los tests que lo cubren. Responde con líneas path:line e indica si la lista está completa. Claude Code puede delegarle estas búsquedas en lugar de hacer grep y leer archivos. Sus mediciones están en la página de benchmarks.
¿Qué diferencia hay entre el plugin y npx graph-indexer init?
Ambos dan a Claude Code el mismo servidor MCP, los mismos hooks y el mismo sub-agente. Cambia dónde vive la configuración.
| Plugin de Claude Code | npx graph-indexer init --hooks | |
|---|---|---|
| Se instala con | Comandos /plugin | Un comando en tu terminal |
| La configuración vive en | El almacén de plugins de Claude Code | Archivos del proyecto: .mcp.json, .claude/settings.json, .claude/agents/code-structure.md |
| Compartido con tu equipo | Cada persona instala el plugin | Versionas los archivos y todos los tienen |
Escribe el bloque de CLAUDE.md | No | Sí (salvo --no-instructions) |
| Otros agentes (Cursor, Codex, …) | No, solo Claude Code | Sí, con --agents o --all |
Elige el plugin para una puesta en marcha rápida en tu máquina. Elige init si quieres la configuración versionada en el repositorio o usas también otros agentes.
¿Cómo verifico que el plugin funciona?
Ejecuta /mcp en Claude Code. El servidor graph-indexer debería aparecer conectado, con sus herramientas. Después hazle a Claude Code una pregunta estructural, como qué métodos llaman a UserService.find, y comprueba que usa find_references o el sub-agente code-structure en lugar de hacer grep del nombre. Hay más sobre la configuración en la página del agente Claude Code.
¿El plugin hace llamadas de red?
No. Graph Indexer no hace llamadas de red ni envía telemetría. El agente sigue enviando lo que lee a su proveedor de modelo. La descarga del paquete con npx y la instalación del plugin desde GitHub las hacen Node.js y Claude Code, no Graph Indexer en ejecución. Consulta la política de seguridad.
Preguntas frecuentes
¿Necesito el plugin y también npx graph-indexer init?
No, son alternativas para Claude Code. El plugin instala el servidor MCP, los hooks y el sub-agente mediante el sistema de plugins de Claude Code. El comando init escribe las mismas piezas como archivos de proyecto que puedes versionar y compartir con tu equipo.
¿El plugin envía mi código a algún sitio?
Graph Indexer no hace llamadas de red ni envía telemetría. El índice es un archivo local. Claude Code sigue enviando lo que lee a su proveedor de modelo, igual que sin el plugin.