Ressources, aides & dépannage

Ç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 :

• Claude Code : code.claude.com/docs (la doc a quitté docs.claude.com et docs.anthropic.com). Installation, hooks, skills, MCP, réglages : tout est là.
• OpenCode : opencode.ai. Install, fournisseurs, configuration multi-modèles.
• Pi : pi.dev. L’alternative minimaliste et extensible à OpenCode (cœur réduit, extensions TypeScript). Voir Installer l’agent.
• Antigravity CLI : antigravity.google. L’agent CLI de Google (ex-Gemini CLI) et sa doc de migration.
• API unifiées : openrouter.ai (des centaines de modèles, une seule clé) et opencode.ai/zen + opencode.ai/go (la passerelle triée d’OpenCode, à l’usage ou au forfait). Voir Installer l’agent.
• Orca : onorca.dev (open-source). L’environnement pour faire tourner plusieurs agents en parallèle.
• Ollama : docs.ollama.com pour la doc (taille du contexte, branchement de Claude Code ou d’OpenCode), et ollama.com/library pour parcourir les modèles dispo et leurs tailles.
• Quelle IA : quelleia.com, le classement des modèles de langage en français, tenu par l’auteur de ce guide. Pour l’IA locale, c’est la page à ouvrir avant tout téléchargement : quelle IA sur quelle machine, le classement des modèles locaux, et Trouver mon modèle en quatre questions. Voir Choisir et dimensionner son modèle.
• llmfit : llmfit.org (open-source AlexsJones/llmfit). Scanne votre machine et vous dit quels modèles locaux tournent bien dessus, et avec quel quant. Voir Choisir et dimensionner son modèle.
• CanIRun.ai : canirun.ai. La même idée, en un clic dans le navigateur (zéro install) : il estime votre matériel et note chaque modèle, de « Runs great » à « Too heavy ». Idéal pour dégrossir vite avant de sortir llmfit.
• Tailscale : tailscale.com/docs. La documentation officielle, claire et à jour.
• Cloudflare Tunnel : developers.cloudflare.com. Pour exposer un service au public proprement.
• Ubuntu : ubuntu.com et docs.ubuntu.com pour le système lui-même.

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.
• Quelle IA, en français : chaque semaine, les modèles classés par tâche (code, agents, français…), le rapport qualité-prix, et Comparer pour mettre deux modèles face à face.
• 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 :

• r/LocalLLaMA, pour tout ce qui touche aux modèles locaux et à Ollama.
• Les forums et Discord officiels, Ollama, Tailscale, Cloudflare.
• Ask Ubuntu et Ubuntu Discourse, qui a remplacé les anciens forums Ubuntu en 2025 : la mine d’or pour les soucis système.
• Stack Overflow, l’incontournable dès qu’il s’agit de code ou de commandes.

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 :

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.