AI Code With

Probado · 2026-10-15

Base de conocimiento IA local: preguntas y respuestas sobre tus docs

Pon documentos en una carpeta local y deja que Claude Code los indexe para que las respuestas salgan solo de tus archivos, con citas. En nuestra prueba escribió un script de recuperación `ask.py` con la biblioteca estándar de Python. Las preguntas que no están en los docs devuelven «not found in the documents» en vez de inventar.

  • ✓3 docs de política: script de recuperación escrito en 67 segundos
  • ✓4 preguntas respondidas bien con archivos fuente; una pregunta de «plus de fitness» que no estaba en los docs devolvió «not found in the documents»
  • ✓Rechequeado el 2026-10-15: las mismas 4 respuestas. El script en sí no llama a ninguna API

Configura una vez: apunta la config global a AICodeWith

Hazlo una vez; todos los casos lo reutilizan. Otras herramientas: guías de integración. Dónde obtener una clave: Obtener una clave API.

  1. 1. Instalar Claude Code

    Sigue la documentación oficial de instalación de Claude Code. Listo cuando claude --version imprime un número de versión.

  2. 2. Crear una clave y editar la config global

    Entra, abre la página **Claves API** del panel y crea una clave. Si no sabes dónde está, mira Obtener una clave API.

    Abre la config global ~/.claude/settings.json y pon la URL base y la clave bajo env:

    ~/.claude/settings.json
    {
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_KEY"
  }
}
    No añadas /v1 al final de la URL base. Reabre la terminal, ejecuta claude; una respuesta normal confirma que la conexión funciona.

Pasos probados

  1. 1. Prepara los docs y pide una herramienta de Q&A

    Crea una carpeta, pon archivos Markdown en docs/, ejecuta claude en la carpeta y escribe:

    text
    La carpeta docs/ tiene unos documentos de política de la empresa. Construye una herramienta de Q&A local: escribe un script Python ask.py que no necesite clave API de terceros, lea Markdown bajo docs/, trocee por párrafo, recupere los pasajes más relevantes con palabra clave/BM25 y muestre la respuesta más la fuente (nombre de archivo + frase original). Luego úsalo para responder estas preguntas y escribe los resultados en qa-results.md: (sustituye por tus preguntas). Si no está en los documentos, di "not found in the documents". No inventes respuestas.
    Mantén la última frase de decir «not found in the documents» y no inventar respuestas. Eso evita que el script adivine.

  2. 2. Pregunta después sin Claude Code

    Cuando el script existe, ya no necesitas Claude Code. Pregunta en la terminal:

    bash
    python3 ask.py "How many vacation days after 12 years?"
python3 ask.py -k 3 "Who do I ask for a test phone?"   # top 3 candidate passages
    Los scripts que escribe Claude Code pueden variar. La primera vez, prueba unas preguntas cuyas respuestas ya conoces.

Solución de problemas

Dice que no está aunque los docs lo contienen
Pídele que baje el umbral de coincidencia o añada sinónimos, y vuelve a lanzar esa pregunta.
Los docs son Word o PDF
Solo probamos Markdown. Puedes pedirle a Claude Code que los convierta primero (ese paso no está probado).
401 o solicitud fallida
Comprueba que la clave está completa y que la URL base es https://api.aicodewith.ai (sin /v1). Reabre la terminal después de cambiarlo.

FAQ

¿Se suben los documentos?

El script de recuperación corre en local y no llama a ninguna API, así que las preguntas no salen de tu ordenador. Escribir el script sí envía la petición y los extractos necesarios al endpoint de Claude Code que configuraste.

¿Inventará respuestas?

En nuestra prueba el script solo devolvió frases originales y fuentes, o «not found in the documents.»

¿Necesito una base vectorial?

No. El script probado usa la biblioteca estándar de Python y puntuación por palabras clave. Considera otra cosa cuando tengas muchos documentos y necesites búsqueda semántica.

¿Quieres una versión de un clic? Deja tu correo

¿No quieres configurar esto tú mismo? Estamos evaluando una herramienta de un clic para “base de conocimiento IA local” y te avisaremos por correo.