# Graph Indexer para Codex CLI

> Añade Graph Indexer a Codex CLI: init imprime el bloque [mcp_servers] para ~/.codex/config.toml y escribe en AGENTS.md las reglas de búsqueda que Codex lee.

Graph Indexer para Codex CLI es un servidor MCP local que da a Codex referencias exactas, grafos de llamadas e impacto de cambios. Como Codex guarda los servidores MCP en `~/.codex/config.toml`, `npx graph-indexer init` imprime el bloque TOML para pegar ahí y escribe en `AGENTS.md`, que Codex lee, un bloque gestionado con las reglas de búsqueda.

## ¿Cómo añado Graph Indexer a Codex?

Ejecuta init para Codex desde la raíz del repositorio, con Node.js 22.5 o superior:

```bash
npx graph-indexer init --agents codex
```

Codex también se selecciona solo cuando el repositorio tiene un `AGENTS.md` o un directorio `.codex`. A diferencia de otros agentes, `init` no escribe ningún archivo de configuración de proyecto para Codex: imprime la entrada del servidor y deja intacta tu configuración global.

## ¿Qué hace `npx graph-indexer init` con Codex?

Para Codex CLI, `init` hace dos cosas:

| Acción | Detalle |
|---|---|
| Imprime una entrada TOML | Una tabla `[mcp_servers.graph-indexer]` con `command`, `args` y `cwd` apuntando al repositorio |
| Escribe `AGENTS.md` | Un bloque gestionado con las reglas de búsqueda y cuándo usar `find_references`, `call_graph`, `change_impact` y `check_changes` |

También añade `.graph-indexer/` al `.gitignore`.

## ¿Cómo es la configuración de Codex?

Añade esto a `~/.codex/config.toml`. La forma manual del README pasa el repositorio con `--repo`:

```toml
[mcp_servers.graph-indexer]
command = "npx"
args = ["-y", "graph-indexer@3", "serve", "--repo", "/ruta/al/repo"]
```

El bloque que imprime `init` usa `cwd = "/ruta/al/repo"` en lugar del argumento `--repo`. Ambos apuntan el servidor al repositorio que quieres indexar.

## ¿Soporta Graph Indexer hooks en Codex?

El comando `hook` de Graph Indexer entiende los payloads de Codex: el código fuente indica que Codex comparte el formato de Claude Code y reconoce nombres de herramienta de Codex como `apply_patch` y `exec_command`. Sin embargo, `init --hooks` no escribe una configuración de hooks para Codex, así que en Codex la vía soportada son las herramientas MCP más el bloque de `AGENTS.md`.

## ¿Qué gana Codex con Graph Indexer?

Codex gana ocho herramientas de solo lectura. En una sesión de Codex, estas son las que conviene usar:

- `find_references` para los puntos de llamada exactos de una función, con `kind` en `inherit` para subclases e implementaciones.
- `call_graph` para llamadores de llamadores.
- `change_impact` antes de cambiar una firma, y `check_changes` después.
- `read_code` para leer varios símbolos a la vez en lugar de abrir archivos enteros.

El bloque de `AGENTS.md` indica además al agente que explore de una pasada y lea la función o las 50 o 100 líneas que necesita en vez de archivos completos. Las herramientas devuelven texto plano, acotado y con el mejor resultado primero. Consulta la [referencia de herramientas](/es/tools/) y la [guía de instalación](/es/install/).

## Preguntas frecuentes

### ¿Por qué init no edita la configuración de Codex por mí?

Codex guarda sus servidores MCP en el ~/.codex/config.toml de usuario e init solo escribe archivos de proyecto, así que nunca edita ese archivo global. En su lugar imprime el TOML para que lo revises y lo pegues.

### ¿Uso cwd o --repo para indicar el repositorio?

Cualquiera de los dos. El bloque que imprime init fija cwd al repositorio. El ejemplo manual del README pasa --repo. Sin ninguno, el servidor indexa el repositorio git que contiene su directorio de trabajo.

### ¿Dónde lee Codex las instrucciones de búsqueda?

En AGENTS.md. init añade ahí un bloque gestionado corto, entre marcas graph-indexer:start y graph-indexer:end, y lo actualiza en su sitio cuando vuelves a ejecutar init.

### ¿Sirve con varios repositorios en Codex?

El bloque impreso va atado a un repositorio mediante cwd. Con varios repositorios, define una entrada de servidor por repo con nombres distintos, o quita la ruta y lanza Codex desde dentro del repositorio.

---

Actualizado: 2026-10-08 · Graph Indexer 3.0.0 · https://graph-indexer.vercel.app/es/agents/codex/