Getestet · 2026-10-15

Lokale KI-Wissensbasis: Q&A über deine eigenen Docs

Lege Dokumente in einen lokalen Ordner und lass Claude Code sie indexieren, damit Antworten nur aus deinen Dateien kommen, mit Quellen. In unserem Lauf schrieb sie ein Retrieval-Skript `ask.py` mit der Python-Standardbibliothek. Fragen, die nicht in den Docs stehen, liefern „not found in the documents“ statt einer Vermutung.

✓3 Policy-Docs: Retrieval-Skript in 67 Sekunden geschrieben
✓4 Fragen korrekt mit Quelldateien beantwortet; eine Frage zu „Fitnesszuschuss“, die nicht in den Docs stand, lieferte „not found in the documents“
✓Nachgeprüft am 2026-10-15: dieselben 4 Antworten. Das Skript selbst ruft keine API auf

Einmal einrichten: globale Config auf AICodeWith zeigen

Das machst du einmal; jeder Anwendungsfall nutzt es. Andere Tools: Integrationsanleitungen. Schlüssel holen: API-Schlüssel holen.

1. Claude Code installieren
Folge der offiziellen Claude-Code-Installationsdoku. Fertig bist du, wenn claude --version eine Versionsnummer ausgibt.
2. Einen Schlüssel anlegen und die globale Config bearbeiten
Melde dich an, öffne im Dashboard die Seite **API-Schlüssel** und erstelle einen Schlüssel. Wenn du nicht weißt, wo das ist, siehe API-Schlüssel holen.
Öffne die globale Config ~/.claude/settings.json und setze Base-URL und Schlüssel unter env:
~/.claude/settings.json
```
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_KEY"
  }
}
```
Hänge /v1 nicht an das Ende der Base-URL. Öffne das Terminal neu, starte claude; eine normale Antwort heißt, die Verbindung steht.

Getestete Schritte

1. Docs vorbereiten und um ein Q&A-Tool bitten

Lege einen Ordner an, lege Markdown-Dateien in docs/, starte claude im Ordner und tippe:

text

Der Ordner docs/ hat ein paar interne Policy-Dokumente. Baue ein lokales Q&A-Tool: schreibe ein Python-Skript ask.py, das keinen Drittschlüssel braucht, Markdown unter docs/ liest, nach Absatz splittet, die relevantesten Passagen mit Keyword/BM25 holt und Antwort plus Quelle (Dateiname + Originalsatz) ausgibt. Nutze es dann, um diese Fragen zu beantworten, und schreibe die Ergebnisse nach qa-results.md: (ersetze durch deine Fragen). Steht es nicht in den Dokumenten, sag "not found in the documents". Erfinde keine Antworten.

Behalte den letzten Satz zu „not found in the documents“ und dem Nicht-Erfinden von Antworten. Das hält das Skript vom Raten ab.

2. Später ohne Claude Code fragen
Wenn das Skript da ist, brauchst du Claude Code nicht mehr. Frage im 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
```
Skripte, die Claude Code schreibt, können sich unterscheiden. Beim ersten Mal probiere ein paar Fragen, deren Antwort du schon kennst.

Fehlerbehebung

Es sagt nicht gefunden, obwohl es in den Docs steht: Bitte sie, die Match-Schwelle zu senken oder Synonyme hinzuzufügen, und führe diese Frage erneut aus.
Die Docs sind Word oder PDF: Wir haben nur Markdown getestet. Du kannst Claude Code bitten, sie zuerst zu konvertieren (dieser Schritt ist ungetestet).
401 oder Anfrage fehlgeschlagen: Prüfe, dass der Schlüssel vollständig ist und die Base-URL https://api.aicodewith.ai lautet (ohne /v1). Öffne das Terminal nach der Änderung neu.

FAQ

Werden die Dokumente hochgeladen?

Das Retrieval-Skript läuft lokal und ruft keine API auf, also verlassen Fragen deinen Rechner nicht. Das Schreiben des Skripts schickt die Anfrage und nötige Auszüge an den Claude-Code-Endpunkt, den du konfiguriert hast.

Erfindet es Antworten?

In unserem Lauf lieferte das Skript nur Originalsätze und Quellen, oder „not found in the documents.“

Brauche ich eine Vektordatenbank?

Nein. Das getestete Skript nutzt die Python-Standardbibliothek und Keyword-Scoring. Nimm etwas anderes, wenn du viele Dokumente hast und semantische Suche brauchst.

Eine Ein-Klick-Version? E-Mail hinterlassen

Du willst das nicht selbst einrichten? Wir prüfen ein Ein-Klick-Tool für „lokale KI-Wissensbasis“ und mailen dir, wenn es soweit ist.

Einmal einrichten: globale Config auf AICodeWith zeigen

1. Claude Code installieren

2. Einen Schlüssel anlegen und die globale Config bearbeiten