| Symptôme / message | Cause | Solution |
|---|---|---|
| « Clé Claude absente : renseignez ANTHROPIC_API_KEY dans .env » | Pas de clé (ou clé vide) | ANTHROPIC_API_KEY=sk-ant-… dans .env, relancer ./rag. La recherche marche déjà : http://localhost:8765/api/recherche?q=… |
| « Claude : … 401 / authentication » | Clé invalide ou révoquée | Nouvelle clé sur console.anthropic.com |
| « Claude : … 429 » | Limite de débit du compte | Réessayer ; CLAUDE_MODEL=claude-sonnet-5-5 |
| La réponse ne trouve pas un document présent | Pas encore indexé, format non lu, PDF scanné | Documents indexés ; rapport de synchro (« en échec ») ; /api/recherche?q=… montre les extraits envoyés |
| « Dossier introuvable » | Chemin erroné ou disque débranché | Corriger le chemin ; l'index est gardé tant que le dossier manque |
| Fichiers OneDrive/Drive indexés vides | Fichiers « en ligne uniquement » | « Toujours garder sur cet appareil » sur le dossier |
Google : redirect_uri_mismatch | URI absente du client OAuth, ou autre port | Ajouter http://localhost:8765/auth/google/callback au client ; garder PORT=8765 |
Google : access_denied | Compte absent des utilisateurs test | Google Auth Platform → Audience → Utilisateurs test |
Google : « Compte … non connecté » ou invalid_grant | Jeton expiré (7 jours en mode test) ou accès retiré | Se reconnecter (03) |
| 1er lancement long | Téléchargement du modèle local (≈ 220 Mo) | Une fois ; ou EMBEDDINGS=voyage |
| Tout est réindexé au démarrage | Modèle d'embeddings changé | Normal (vecteurs incompatibles) |
Address already in use | Port 8765 pris | PORT=8766 dans .env (et l'URI de redirection Google correspondante) |
Leçon 29 — Rag local claude