Dépannage
“upstream 404”
Cause la plus fréquente : le nom du modèle dans votre config ne correspond à rien d’installé. Lancez ollama list pour voir vos modèles, puis téléchargez celui que vous voulez (ollama pull qwen2.5-coder:7b) ou changez avec /model depuis Mini-claude.
L’en-tête affiche “weak tool calling”
Votre modèle annonce la capacité tools mais émet ses appels en texte au lieu du champ structuré. Mini-claude en récupère beaucoup via son parseur de secours, mais les tâches multi-étapes seront capricieuses. Pour du vrai travail d’agent, passez à un modèle vérifié (mistral:7b, qwen3:8b, llama3.1:8b), voir Modèles. Pour un résumé de projet fiable malgré tout, utilisez /audit.
L’agent « mouline » longtemps sur une tâche
Normal pour un agent local : chaque tour fait tourner le modèle, et une tâche enchaîne plusieurs tours d’outils. Un 7B sur CPU tourne lentement, c’est l’inférence, pas un bug. Pistes : un modèle plus petit pour les tâches simples, un GPU si possible, ou /audit qui ne demande qu’une seule synthèse au modèle.
“connection refused”
Le serveur d’inférence n’écoute pas à l’URL configurée. Vérifiez MINI_CLAUDE_URL (défaut http://localhost:11434) et confirmez qu’Ollama tourne :
curl http://localhost:11434/v1/modelsLes réponses sont extrêmement lentes
L’inférence locale sur CPU est lente, surtout pour les modèles 7B+. Pour des réponses plus rapides, passez à un modèle plus petit (au prix du tool calling). Si vous avez un GPU, vérifiez qu’Ollama le détecte (ollama ps). Au premier message après un changement de modèle, comptez aussi le temps de chargement à froid.
La TUI a l’air cassée / les couleurs sont fausses
Votre terminal n’annonce peut-être pas le support truecolor. Essayez export COLORTERM=truecolor avant le lancement.
Cliquer sur le lien miniclaude.fr n’ouvre pas le navigateur
Il vous faut un terminal moderne qui supporte les hyperliens OSC 8 (iTerm2, Terminal.app récent, WezTerm, Kitty, Alacritty). Essayez Cmd+clic sur macOS, Ctrl+clic sur Linux.
La sélection à la souris ne marche pas
Si vous êtes sur une vieille version, maintenez Option (macOS) ou Shift (Linux) en sélectionnant pour contourner la capture souris du terminal. Les versions récentes de Mini-claude désactivent la capture par défaut.