Jumeau numérique · Sous-section

Comment utiliser OpenCode Desktop

Tout pour devenir autonome sur OpenCode Desktop en 20 minutes : brancher tes modèles et tes outils, comprendre l'interface (panneaux, raccourcis, modes build et plan) et ouvrir l'IA au bon endroit pour chaque type de travail.

Source : https://prisme.one/plateforme/ia-juillet-2026/semaine-1-opencode

Ouvrir le PDF

Objectif

Exemples : OpenAI, Anthropic, OpenRouter, Fireworks, DeepInfra, Infomaniak.

Output attendu

Exemples : GPT 5.6, Fable / Claude Opus 4.8, DeepSeek V4 Flash, GLM 5.2, Qwen 3.6.

Comment utiliser OpenCode Desktop

Dans cette leçon, je t'explique comment configurer OpenCode Desktop pour qu'il soit parfaitement opérationnel, puis comment l'utiliser au quotidien.

Comment utiliser OpenCode Desktop
Walkthrough complet : ce qu'est OpenCode, configurer fournisseurs et modèles, connecter des outils, comprendre l'interface, modes plan/build, ouvrir l'IA au bon dossier.
Note importante : "Prisme Workspace", c'est OpenCode Desktop

Dans la vidéo, je parle de "Prisme Workspace". C'est un abus de langage : Prisme Workspace n'existe plus (en tout cas pas pour le moment, et pas sous cette forme). L'outil qu'on te recommande d'utiliser, c'est tout simplement OpenCode Desktop.

Donc à chaque fois que tu m'entends dire "Prisme Workspace" dans la vidéo, remplace mentalement par OpenCode Desktop : c'est le même outil, la même interface, la même configuration. Tout ce que je montre marche exactement pareil.

OpenCode, c'est un harnais agentique open-source : tu y ouvres un LLM (un modèle qui prédit le token suivant) et le harnais ajoute autour tout ce qui transforme un simple chatbot en agent (coder, appeler des outils, déléguer à des sous-agents, se planifier, s'auto-évaluer, respecter des permissions). C'est pour ça qu'on l'utilise plutôt qu'un chatbot question-réponse : la boucle agentique fait le travail, pas juste la réponse. C'est aussi un outil ouvert : tu y branches n'importe quel modèle (ChatGPT, Claude, DeepSeek, GLM, Qwen...) sans dépendre d'un seul fournisseur, et l'interface desktop reste très simple à prendre en main.

Étape 1 : Configurer tes fournisseurs et tes modèles

C'est la première chose à faire en arrivant. Clique sur la roue crantée en bas à gauche, puis va dans la section Fournisseurs et Modèles.

Fournisseur vs modèle, c'est quoi la différence ?

Fournisseur (provider)
L'infrastructure qui fait tourner l'IA

Ce sont les serveurs sur lesquels tourne le modèle. Chaque fournisseur a ses propriétés : prix, vitesse, confidentialité, infrastructure géographique.

Exemples : OpenAI, Anthropic, OpenRouter, Fireworks, DeepInfra, Infomaniak.

Modèle
Le cerveau, exposé par le fournisseur

Chaque fournisseur propose un catalogue de modèles différents. Certains sont propriétaires (GPT, Claude), d'autres open source (DeepSeek, Qwen, GLM, Kimi, Llama, Gemma).

Exemples : GPT 5.6, Fable / Claude Opus 4.8, DeepSeek V4 Flash, GLM 5.2, Qwen 3.6.

Pour résumer : tu choisis ton fournisseur en fonction de ses propriétés (prix, confidentialité, vitesse), puis tu actives chez ce fournisseur les modèles que tu veux utiliser. Par exemple, Fireworks est un fournisseur qui propose uniquement des modèles open source très optimisés pour tourner vite.

Les deux modes de connexion

La plupart du temps
Connexion par clé API

Tu vas sur le site du fournisseur, tu te connectes, tu génères une clé API dans les paramètres de ta plateforme, et tu la colles dans OpenCode Desktop.

Concerne : OpenRouter, Fireworks, Infomaniak, DeepInfra, Vercel, Anthropic, et la grande majorité des fournisseurs.

Cas plus rares
Connexion par OAuth (compte)

Tu te connectes directement avec ton compte existant via une fenêtre du navigateur. Pas de clé API à gérer, et tu utilises ton abonnement au lieu de payer à la consommation.

Concerne : GitHub Copilot, OpenAI (ChatGPT Plus / Pro), Google dans certains cas.

Tutoriel : connecter OpenAI via abonnement ChatGPT

Stop : lis ça avant de connecter OpenAI
Si tu as déjà ChatGPT Plus ou Pro, NE mets PAS ta clé API

C'est l'erreur n°1 qui coûte de l'argent à ceux qui débutent. La clé API OpenAI facture chaque token que tu consommes, et ça chiffre très vite. Ton abonnement ChatGPT, lui, est déjà payé : tu peux l'utiliser dans OpenCode Desktop sans payer un centime de plus.

Beaucoup de gens croient que "c'est impossible" d'utiliser son abonnement ChatGPT dans un outil externe. C'est faux. Il suffit de choisir "se connecter avec un abonnement existant" (connexion OAuth / login OpenAI) au lieu de coller une clé API. C'est exactement ce qu'on fait juste en dessous.

Piège fréquent avec OpenRouter

Dans OpenRouter, décoche TOUS les modèles GPT. Sinon tu risques de payer GPT une deuxième fois, au token, via OpenRouter, alors que tu l'as déjà via ton abonnement. GPT ne doit être coché que dans le fournisseur OpenAI connecté avec ton abonnement.

Quand tu cliques pour ajouter OpenAI, OpenCode Desktop te demande :

  1. Veux-tu mettre une clé API ? (paiement à la consommation, donc plus cher si tu utilises beaucoup) ou
  2. Veux-tu te connecter avec un abonnement existant ? (recommandé si tu as déjà ChatGPT Plus ou Pro)

Choisis l'option 2. Une page s'ouvre dans ton navigateur, tu te connectes, tu cliques sur Continue, et c'est plié. OpenAI est connecté, et tu peux maintenant sélectionner les modèles que tu veux activer.

À savoir sur les abonnements
  • Le mode Pro de GPT 5.6 n'est pas exposé via le login ChatGPT dans OpenCode : tu auras GPT 5.6 et GPT 5.6 Fast, largement suffisants pour la plupart des tâches.
  • Anthropic n'autorise plus de connexion par abonnement Claude Pro ou Max dans des apps tierces. Il faut une clé API, donc tu payes à la consommation, ce qui peut vite chiffrer. C'est l'exception. Si tu veux Claude via abonnement, passe par l'app Claude Code en CLI (voir la leçon dédiée).

La barre du bas et le sélecteur de modèles

Une fois tes fournisseurs configurés, tu retrouves tout en bas de ton écran :

Astuce : décoche les modèles que tu n'utilises jamais, sinon ta barre devient un fouillis. Par exemple, sur OpenRouter, il y a des centaines de modèles disponibles. Garde-en 5 à 10 pertinents et désactive le reste pour avoir une interface propre.

Étape 2 : Connecter tes outils (MCP)

Sous le capot, OpenCode Desktop fait tourner OpenCode. Donc connecter des outils à OpenCode Desktop, c'est en réalité connecter des outils à OpenCode. La bonne nouvelle : tu as déjà tout ce qu'il faut dans ton coffre du bootcamp.

La méthode recommandée : /connect-mcp

Dans OpenCode Desktop, tape simplement :

/connect-mcp

Puis le nom de l'outil que tu veux ajouter (par exemple notion, firecrawl, playwright, microsoft 365). L'IA te guide étape par étape : elle identifie le bon package, récupère les variables d'environnement nécessaires, patche ta configuration sans rien casser de ce qui existe déjà.

Par défaut, le MCP est ajouté à la configuration OpenCode globale de ton ordinateur. Cela veut dire que tous tes workspaces ont accès à l'outil. Si tu changes de workspace (par exemple, du workspace démo à ton workspace principal), tu retrouves les mêmes MCP disponibles.

MCP et contexte : active-les seulement quand tu en as besoin

Un MCP chargé au démarrage rajoute facilement 15 000 à 20 000 tokens de contexte à chaque conversation : ça te coûte de l'argent et ça remplit le contexte plus vite. La bonne pratique : démarre tes conversations avec zéro MCP activé, et active-les uniquement pour la tâche qui en a besoin.

Quand c'est possible, privilégie la version CLI d'un outil (ligne de commande) plutôt que sa version MCP : c'est plus rapide, plus déterministe, et ça consomme beaucoup moins de tokens. La plupart des outils que tu connectes en MCP ont un équivalent CLI.

Les trois sections de Paramètres

Serveurs MCP
Liste des MCP connectés. Tu n'as pas à toucher cette section directement, /connect-mcp s'en occupe.
Serveurs (non-MCP)
Tu n'as pas besoin de t'en occuper pour le moment.
Plugins OpenCode
Si tu vois un plugin OpenCode intéressant (par exemple "Oh My OpenCode"), tu peux demander à l'IA "installe-moi ce plugin OpenCode" et il apparaîtra directement dans cette section.

Étape 3 : Comprendre l'interface

La barre latérale (icône crayon)

Quand tu cliques sur le crayon en haut à droite, une barre latérale s'ouvre. Elle te donne plusieurs vues utiles :

Vue Statistiques
Comprendre ce qui se passe dans ta session
  • Nombre de tokens en entrée et en sortie
  • Modèle utilisé pour chaque message
  • Voir le JSON exact envoyé à l'IA (très utile pour comprendre/déboguer)
Vue Console
Suivre l'utilisation du contexte
  • Pourcentage d'appels d'outils (par exemple "67 % d'appels d'outils")
  • Limite de contexte et où tu en es
  • Utilisation du contexte par message

L'éditeur de notes intégré

Toujours dans la barre latérale, tu peux ouvrir le panneau Documents et éditer une note directement. C'est un éditeur Markdown léger, parfait pour travailler sur le même fichier que l'IA dans la même interface.

Étape 4 : Ouvrir l'IA dans le bon dossier

C'est le principe le plus important. L'IA voit ce qui est dans le dossier où tu l'ouvres. Rien d'autre.

Si tu suis le bootcamp
Ouvre ton Workspace complet

Le dossier Workspace (avec ton Second Cerveau, ton AGENTS.md, tes skills) devient le projet global d'OpenCode Desktop. L'IA a accès à tout ton contexte et à tous tes projets séquencés à l'intérieur.

Pour un projet isolé
Ouvre uniquement le dossier du projet

Tu travailles sur une présentation, un site, une analyse client ? Crée un dossier dédié, mets-y tes notes et tes fichiers, ouvre OpenCode Desktop à l'intérieur. L'IA n'a que ce contexte, plus rapide et plus précis.

Attacher un fichier ou pointer avec @

Tu peux enrichir ton contexte de deux manières en plein milieu d'une conversation :

Étape 5 : Niveau d'effort et modes (build / plan)

Niveau d'effort

Selon le modèle, tu as parfois une option niveau d'effort (thinking on/off). Plus le niveau est élevé, plus le modèle va prendre le temps de réfléchir avant de répondre. Certains modèles te le proposent, d'autres sont en non-thinking par défaut (réponse directe, pas de phase de réflexion).

Build mode vs Plan mode

Tu as deux modes principaux dans le sélecteur en bas de la barre de prompt :

Plan mode
L'IA réfléchit, lit les fichiers, propose un plan structuré. Elle ne touche à rien tant que tu n'as pas validé.
Build mode
L'IA exécute le plan validé : écrit, édite, crée. À utiliser après le plan mode pour le travail concret.

Tu peux aussi ajouter des modes custom selon tes usages. Tout cela est détaillé dans la prochaine leçon "Bien utiliser l'IA".

Étape 6 : Recherche rapide avec Cmd+K

Le raccourci magique : Cmd+K ouvre une barre de recherche universelle. Tu peux chercher :

C'est l'équivalent du Spotlight du Mac, mais pour ton workspace. À utiliser tout le temps.

Si tu rencontres un problème

Si tu rencontres un bug ou un comportement étrange dans OpenCode Desktop :

  1. Reporter sur GitHub : ouvre une issue sur le repo public d'OpenCode.
  2. Nous écrire un email à contact@perspectives.ac avec une description et idéalement un screenshot.

On corrige vite, et chaque retour participant améliore l'app pour tout le monde.

Vidéos