SECCIÓN 18

Resolución de problemas

"No API key configured"

ixtli auth set-key hki_xxxxxxxxxxxxxxxx

En CI:

export IXTLI_API_KEY=hki_xxxxxxxxxxxxxxxx

Verificar el estado general

ixtli doctor

Muestra el estado de todos los componentes y te dice qué corregir si algo no está configurado.

"Not inside a git repository"

git init

"No files to review. Stage some changes first."

git add .
ixtli review

# o revisar archivos sin stagear:
ixtli review --unstaged

# o archivos específicos:
ixtli review src/auth.py

"No stored issues for <file>"

ixtli re-review necesita que haya una sesión guardada. Asegúrate de correr primero:

ixtli review

O usa el flag --fix para enviar una descripción directa sin requerir sesión:

ixtli re-review src/api/auth.py --fix "Applied parameterized queries"

El PIL da resultados incorrectos o desactualizados

ixtli index clear
ixtli index init

Los hooks bloquean commits legítimamente

# Saltarse el hook en este commit específico
git commit --no-verify -m "WIP"

# Deshabilitar temporalmente
ixtli hooks disable
git commit -m "mi commit"
ixtli hooks enable

# Cambiar el umbral de severidad
ixtli hooks install --min-severity-commit critical

El MCP no conecta con Claude Code

  1. Verifica que el servidor arranca:

    ixtli mcp serve

  2. Verifica el archivo .mcp.json:

    cat .mcp.json

  3. Verifica que ixtli está en el PATH del entorno donde corre Claude Code.

  4. Reinstala:

    ixtli tools install-skill claude --mcp

El LSP no encuentra el servidor

ixtli lsp status
ixtli lsp install python

"Quota exhausted"

ixtli cambia automáticamente a análisis estático cuando se agota la cuota de LLM. El análisis estático sigue detectando issues de forma efectiva, pero sin el razonamiento contextual del LLM.

Para ver tu uso y cuota: https://app.ixtli.app/settings/usage

Reinstalar desde cero

rm ~/.local/bin/ixtli
rm -rf ~/.ixtli
rm -rf .ixtli

curl -fsSL https://cdn.ixtli.app/install | bash
ixtli setup --auto
Exit codesReferencia rápida