Aller au contenu
minimachine.
← Le parcours
Étape 27 · Bien bosser Facile · 8 min

📚Ressources, aides & dépannage

Les liens qui comptent, les communautés où poser vos questions, et les réflexes quand quelque chose coince. Votre carnet d'adresses pour la suite.

Ça y est, votre machine tourne et votre agent bosse. Reste une vérité simple : vous n’allez pas tout retenir, et un jour quelque chose va casser. C’est normal. Cette fiche, c’est votre carnet d’adresses, la doc qui fait foi, les gens qui répondent, et les gestes à faire quand ça part en vrille.

La documentation officielle

Quand un doute technique se pose, la source officielle bat toujours le tuto recopié dix fois. Voici les pages qui font autorité, par outil :

Apprendre et s’inspirer

Au-delà du dépannage, c’est là qu’on prend du recul et qu’on découvre ce qui bouge :

  • Anthropic Engineering, les billets d’Anthropic, dont les bonnes pratiques Claude Code. Lecture qui change vraiment votre façon de piloter un agent.
  • Hugging Face, le hub des modèles open-weight. Quasiment tout ce qui sort en local passe par là.
  • r/LocalLLaMA, le pouls de la communauté des modèles locaux. Nouveautés, benchmarks maison, retours du terrain.
  • Artificial Analysis, comparatifs de modèles (vitesse, qualité, prix) sur des bases mesurées plutôt qu’au feeling.

Où demander de l’aide

Le réflexe le plus rentable : quelqu’un a déjà rencontré votre erreur. Vraiment. Collez le message exact dans un moteur de recherche, et vous tombez souvent sur la solution écrite par un inconnu qui galérait comme vous il y a six mois. Et si ce n’est pas le cas, ces endroits accueillent les questions :

Les réflexes de dépannage

Quand un truc casse, pas de panique. Il y a un ordre des opérations qui résout 90 % des cas :

Lisez vraiment le message d'erreur

Ne le fermez pas en panique. La plupart des erreurs disent exactement ce qui ne va pas, en clair. Prenez dix secondes pour le lire.

Donnez-le à votre agent

Collez l’erreur dans Claude Code ou OpenCode. Décoder les messages cryptiques, c’est précisément ce qu’il fait de mieux. Souvent il diagnostique et propose le correctif dans la foulée.

Regardez les logs du service

Si c’est un service qui flanche, les logs parlent : journalctl -u <service> -e pour les dernières lignes, et systemctl status <service> pour voir s’il tourne et pourquoi il a planté.

Cherchez la chaîne d'erreur exacte

Copiez le bout d’erreur le plus précis (pas tout, juste la phrase clé) dans un moteur de recherche. Quelqu’un est passé par là avant vous.

git est votre bouton « annuler »

Si vous avez cassé quelque chose en éditant, et que vous commitiez régulièrement, vous revenez en arrière sans douleur. C’est tout l’intérêt des commits comme filet de sécurité, détaillé dans Sécuriser les accès.

Redémarrez

Oui, vraiment. Un reboot règle plus de problèmes qu’on n’aime l’avouer, services bloqués, montages capricieux, état bancal. À tenter avant de désespérer.

Garder la machine en forme

Quelques commandes à connaître pour un check de santé express :

htop          # charge CPU/RAM en temps réel, et qui mange quoi
df -h          # espace disque, les modèles le remplissent VITE
ollama ps      # quels modèles sont chargés en mémoire là, maintenant

Et pour la maintenance qui tourne toute seule : les mises à jour de sécurité automatiques (unattended-upgrades, configurées dans Réglages système) gardent le système patché sans que vous y pensiez. C’est le genre de truc qu’on installe une fois et qu’on oublie, exactement comme il faut.