AI Code With

Testé · 2026-10-15

Base de connaissances IA locale : Q&R sur vos propres docs

Mettez des documents dans un dossier local et laissez Claude Code les indexer pour que les réponses viennent uniquement de vos fichiers, avec citations. Dans notre essai elle a écrit un script de récupération `ask.py` en bibliothèque standard Python. Les questions absentes des docs renvoient « not found in the documents » au lieu d'une invention.

  • ✓3 docs de politique : script de récupération écrit en 67 secondes
  • ✓4 questions répondues correctement avec fichiers sources ; une question « indemnité fitness » absente des docs a renvoyé « not found in the documents »
  • ✓Revérifié le 2026-10-15 : les mêmes 4 réponses. Le script lui-même n'appelle aucune API

Configurer une fois : pointer la config globale vers AICodeWith

À faire une fois ; tous les cas d'usage s'en servent. Autres outils : guides d'intégration. Où obtenir une clé : Obtenir une clé API.

  1. 1. Installer Claude Code

    Suivez la documentation officielle d'installation de Claude Code. C'est bon quand claude --version affiche un numéro de version.

  2. 2. Créer une clé et modifier la config globale

    Connectez-vous, ouvrez la page **Clés API** du tableau de bord, et créez une clé. Si vous ne savez pas où c'est, voir Obtenir une clé API.

    Ouvrez la config globale ~/.claude/settings.json et renseignez l'URL de base et la clé sous env :

    ~/.claude/settings.json
    {
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_KEY"
  }
}
    N'ajoutez pas /v1 à la fin de l'URL de base. Rouvrez le terminal, lancez claude : une réponse normale confirme que la connexion marche.

Étapes testées

  1. 1. Préparez les docs et demandez un outil de Q&R

    Créez un dossier, mettez des fichiers Markdown dans docs/, lancez claude dans le dossier, et tapez :

    text
    Le dossier docs/ contient quelques documents de politique interne. Construis un outil de Q&R local : écris un script Python ask.py qui n'a besoin d'aucune clé API tierce, lit le Markdown sous docs/, découpe par paragraphe, récupère les passages les plus pertinents avec mot-clé/BM25, et affiche la réponse plus la source (nom de fichier + phrase d'origine). Puis utilise-le pour répondre à ces questions et écris les résultats dans qa-results.md : (remplace par tes questions). Si ce n'est pas dans les documents, dis "not found in the documents". N'invente pas de réponses.
    Gardez la dernière phrase sur « not found in the documents » et ne pas inventer de réponses. C'est ce qui empêche le script de deviner.

  2. 2. Posez des questions plus tard sans Claude Code

    Une fois le script là, vous n'avez plus besoin de Claude Code. Demandez dans le 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
    Les scripts écrits par Claude Code peuvent varier. La première fois, essayez quelques questions dont vous connaissez déjà la réponse.

Dépannage

Il dit introuvable alors que les docs le contiennent
Demandez-lui d'abaisser le seuil de correspondance ou d'ajouter des synonymes, puis relancez cette question.
Les docs sont Word ou PDF
Nous n'avons testé que Markdown. Vous pouvez demander à Claude Code de les convertir d'abord (étape non testée).
401 ou requête en échec
Vérifiez que la clé est complète et que l'URL de base est https://api.aicodewith.ai (sans /v1). Rouvrez le terminal après modification.

FAQ

Les documents sont-ils envoyés ailleurs ?

Le script de récupération tourne en local et n'appelle aucune API, donc les questions ne quittent pas votre ordinateur. Écrire le script envoie la requête et les extraits nécessaires au point de terminaison Claude Code que vous avez configuré.

Inventera-t-il des réponses ?

Dans notre essai le script n'a renvoyé que des phrases d'origine et des sources, ou « not found in the documents. »

Faut-il une base vectorielle ?

Non. Le script testé utilise la bibliothèque standard Python et un score par mots-clés. Envisagez autre chose quand vous avez beaucoup de documents et besoin de recherche sémantique.

Une version en un clic ? Laissez votre e-mail

Vous ne voulez pas tout configurer vous-même ? Nous évaluons un outil en un clic pour « base de connaissances IA locale » et vous préviendrons par e-mail.