# Plugin de Graph Indexer para Claude Code

> Instala el plugin de Graph Indexer para Claude Code con dos comandos. Incluye el servidor MCP, tres hooks y el sub-agente code-structure, todo en local.

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:

```text
/plugin marketplace add MaquinaTech/graph-indexer
/plugin install graph-indexer@graph-indexer
```

El primero registra el marketplace `graph-indexer` desde el [repositorio de GitHub](https://github.com/MaquinaTech/graph-indexer). 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](/es/install/).

## ¿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](/es/tools/): `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](/es/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`](/es/install/) 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](/es/agents/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](https://github.com/MaquinaTech/graph-indexer/blob/main/SECURITY.md).

## 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.

---

Actualizado: 2026-10-08 · Graph Indexer 3.0.0 · https://graph-indexer.vercel.app/es/claude-code-plugin/