Ce guide est la suite naturelle d’OpenRouter en 15 minutes : la clé créée là-bas, avec son plafond de dépense, devient le moteur d’un agent qui travaille dans vos fichiers. Fin du parcours : une vraie tâche accomplie par OpenCode sous vos yeux.

Étape 1 · Installez

Deux voies équivalentes, depuis la documentation officielle : le script (curl -fsSL https://opencode.ai/install | bash) ou, si vous avez Node, npm install -g opencode-ai. Vérifiez avec opencode --version : s’il répond un numéro, vous y êtes.

Étape 2 · Branchez le modèle

Créez un dossier de travail dédié et lancez opencode dedans. Au premier démarrage, utilisez la commande /connect : cherchez OpenRouter dans la liste des fournisseurs, collez la clé. Puis choisissez le modèle : pour le premier tour, un modèle moyen convient parfaitement, et pour dépenser zéro il y a les variantes :free de plusieurs modèles ouverts (avec la limite par minute documentée dans la fiche OpenRouter).

Étape 3 · Clôturez le champ

Un agent qui lit, écrit et exécute se traite comme un collaborateur nouveau : périmètre clair avant la première tâche. La règle pratique : travaillez toujours dans un dossier dédié qui ne contient que le matériel de la tâche, jamais dans le répertoire personnel ni dans des dossiers avec des documents sans rapport. À l’intérieur de cette clôture, l’agent ne peut faire que des dégâts réduits et récupérables.

Étape 4 · La première vraie tâche

Mettez dans le dossier un fichier sur lequel l’agent puisse travailler (un CSV à analyser, une poignée de notes à réorganiser, un script à commenter) et décrivez la tâche comme à une personne : ce qu’il y a, ce que vous voulez, comment vous reconnaissez un bon résultat. Puis regardez-le travailler : OpenCode montre les étapes et les modifications, et vous supervisez. Le moment formateur est exactement là : voir le cycle lire-agir-vérifier se produire dans vos fichiers, avec vos contenus.

Les erreurs typiques

La tâche vague. « Arrange-moi ces fichiers » produit des résultats vagues avec n’importe quel agent. Objectif, matériel, critère de réussite : les trois choses que vous donneriez à un collègue, vous les donnez ici aussi.

La clôture sautée. La tentation de le lancer « juste une seconde » dans le dossier des vrais documents. Copier trois fichiers dans un dossier propre coûte trente secondes ; l’alternative est de superviser en retenant son souffle.

Le mauvais modèle pour la tâche. Si les résultats déçoivent, avant de condamner l’agent, essayez un modèle plus capable : avec OpenCode le changement est une commande, et c’est exactement le genre d’expérience pour lequel le couple avec une passerelle existe.

État du contrôle : installation et version réellement vérifiées le 19/07/2026 (v1.18.3, via npm). Le tour complet de l’étape 4 a été exécuté à la même date, avec une vraie clé et un vrai modèle, par le workflow de contrôle du site : OpenCode a lu le CSV des matériaux du cours dans une clôture dédiée, produit l’analyse avec le total et les 4 anomalies que le matériel contient exprès, sans toucher au fichier original. Exactement le cycle lire-agir-vérifier décrit plus haut.