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 llama3.2:3b) ou changez avec /model depuis mini-claude.
“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+. Passez à llama3.2:1b ou qwen2.5:0.5b pour des réponses plus rapides. Si vous avez un GPU, vérifiez qu’Ollama le détecte (ollama ps).
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.