OpenCode Desktop (Beta) · parcours 2026

Tutoriel de l'application de bureau OpenCode : installation, Plan mode et première application

L'agent de code libre et gratuit OpenCode s'offre désormais une application de bureau en beta pour macOS, Windows et Linux. Ce parcours en 16 étapes couvre l'installation via le cask brew, la connexion des fournisseurs ou des modèles gratuits, les questions du Plan mode, la liste de tâches du Build mode, les diff unifiés, les commentaires en ligne et le terminal intégré — chaque étape vérifiée sur un enregistrement d'écran propre.

L'essentiel — c'est quoi l'application de bureau OpenCode ?

  • OpenCode Desktop est l'habillage graphique de l'agent OpenCode — le même agent que la CLI, dans une fenêtre avec navigateur de fichiers, revue de diff et onglets de terminal. Sur opencode.ai/download, il reste étiqueté OpenCode Desktop (Beta), avec des installateurs pour macOS (Apple Silicon et Intel), Windows x64 et Linux (.deb/.rpm), plus la voie Homebrew : brew install --cask opencode-desktop.
  • Pas besoin de choisir un fournisseur de modèles dès le départ. La boîte de dialogue Select model embarque des modèles gratuits (Big Pickle, DeepSeek V4 Flash Free, MiMo V2.5 Free, Nemotron 3 Ultra Free, North Mini Code Free), et Popular providers couvre OpenCode Zen, OpenCode Go, Anthropic, GitHub Copilot, OpenAI, Google et plus — un abonnement Copilot se connecte par login d'appareil sans clé API supplémentaire.
  • Le rythme de travail : Plan → Build → revue. Le Plan mode pose des questions de cadrage et rédige un plan sans écrire de fichiers ; vous l'approuvez, vous basculez en Build mode et l'agent coche une liste de tâches. Session changes affiche un diff unifié de 11 fichiers commentable ligne par ligne, et l'onglet terminal fait tourner les serveurs de dev.
  • Le contexte des versions en 2026 : la branche OpenCode 2.0 est arrivée en septembre (étiquettes v2.0.0 à v2.0.11 au 20 septembre), l'application de bureau a été portée de Tauri vers Electron au printemps, et tout avance vite — si une étape ne correspond plus, mettez à jour depuis la page de téléchargement.

How to Download, Install & Use OpenCode Desktop App | Vibe Coding Machine | Build Two Apps

Vidéo du parcours:WebStylePress7:51

Ouvrir

OpenCode Desktop: Great UI/UX + Run Multiple AI Agents (Free)

Vidéo du parcours:AI With Nathan9:32

Ouvrir

OpenCode Desktop App — 75+ Providers, Parallel Sessions, File Browser & More

Vidéo du parcours:AI Stack Engineer8:22

Ouvrir

How to Install OpenCode Desktop App on Windows 10/11 2026

Vidéo du parcours:United Top Tech2:46

Ouvrir

OpenCode Download & Docs — OpenCode Desktop (Beta), v2 install

Faits produit:opencode.aiDownload page

Ouvrir

Les étapes 1-3, 6, 8 et 9 sont des captures du parcours Windows de WebStylePress ; l'étape 4 vient de l'enregistrement d'installation de United Top Tech ; les étapes 5 et 7 viennent de la configuration des fournisseurs par AI Stack Engineer ; les étapes 10-16 sont des captures de la session plan-to-build d'AI With Nathan. Les commandes d'installation et les faits sur la 2.0 sont cités d'opencode.ai/download et du dépôt anomalyco/opencode.

Les captures sont créditées aux vidéos sources, chacune avec un lien profond vers son horodatage. Le texte de ce guide est original ; les faits viennent de ces enregistrements ainsi que de la page de téléchargement officielle, de la documentation et du dépôt.

OpenCode Desktop, étape par étape

1 · Installer l'application de bureau OpenCode

  1. 1

    Ouvrir la page de téléchargement et récupérer l'installateur OpenCode Desktop (Beta)

    Rendez-vous sur opencode.ai/download et descendez jusqu'à la section 2, OpenCode Desktop (Beta). Les utilisateurs de Homebrew sur macOS peuvent lancer brew install --cask opencode-desktop ; les autres choisissent leur bouton Download — macOS (Apple Silicon), macOS (Intel), Windows (x64), Linux (.deb) ou Linux (.rpm). Le téléchargement Windows pèse environ 116 Mo. La section 3 de la même page installe les extensions VS Code, Cursor, Zed et Windsurf si vous voulez une intégration IDE plus tard.

    OpenCode download page with the OpenCode Desktop (Beta) section showing the brew install --cask opencode-desktop command above Download buttons for macOS Apple Silicon, macOS Intel, Windows x64, Linux .deb and .rpm
    La section OpenCode Desktop (Beta) d'opencode.ai/download avec la commande du cask Homebrew.Voir à 0:25
  2. 2

    Passer le SmartScreen de Windows avec More info

    L'application de bureau est une beta signée par un éditeur récent : Microsoft Defender SmartScreen affiche donc le classique avertissement Windows protected your PC et bloque l'application non reconnue. Cliquez sur More info dans l'avertissement — la boîte de dialogue se déploie et révèle qui a signé le fichier ainsi qu'un bouton Run anyway. Sur macOS et Linux, cette étape n'existe pas : montez le .dmg ou installez le paquet .deb/.rpm.

    Windows Defender SmartScreen warning reading Windows protected your PC over the OpenCode download page, with the More info link you click before running the OpenCode Desktop installer
    SmartScreen bloque l'installateur non reconnu jusqu'à un clic sur More info.Voir à 0:33
  3. 3

    Cliquer sur Run anyway et laisser l'installation se terminer

    La boîte déployée nomme OpenCode Desktop Installer.exe et son éditeur, Anomaly Innovations, Inc. Cliquez sur Run anyway, l'assistant d'installation fait le reste. Le premier lancement prend quelques secondes le temps que l'application démarre son serveur local — c'est normal sur les trois plates-formes.

    Expanded SmartScreen dialog naming OpenCode Desktop Installer.exe from Anomaly Innovations, Inc with the Run anyway button that unblocks the OpenCode desktop app setup on Windows
    La boîte déployée affiche l'éditeur ; Run anyway lance l'installation.Voir à 0:40
  4. 4

    Premier lancement : vérifier Local Server et ouvrir un projet

    L’écran d’accueil montre le point vert Local Server, la liste Recent projects et le bouton Open project. Cliquez sur Open project et choisissez n’importe quel dossier — un dossier vide tout neuf convient très bien — et l’application vous dépose dans un espace de travail avec la zone de saisie Build anything. Recent projects retiendra vos dossiers à partir de là.

    OpenCode desktop app first launch on Windows with the green Local Server dot, the Recent projects list and the Open project button used to pick your code folder
    Premier lancement : Local Server tourne et Recent projects reste vide tant qu'aucun dossier n'est ouvert.Voir à 1:02

2 · Connecter un fournisseur et choisir un modèle

  1. 5

    Utiliser la carte Getting started pour connecter votre premier fournisseur

    Une installation neuve vous accueille avec une carte Getting started : OpenCode inclut des modèles gratuits pour démarrer immédiatement, et Connect any provider pour utiliser les modèles de Claude, GPT, Gemini et plus. Le bouton Connect provider de cette carte est le chemin le plus rapide vers la configuration — ou passez-la entièrement et restez sur les modèles gratuits.

    OpenCode desktop Getting started card saying free models are included next to the Connect provider button that opens provider and model setup in a new session
    La carte Getting started pointe vers Connect provider ; les modèles gratuits marchent sans réglage.Voir à 2:20
  2. 6

    Choisir un fournisseur dans Settings → Providers

    Ouvrez l'icône d'engrenage et choisissez Providers. OpenCode Zen (modèles sélectionnés dont Claude, GPT et Gemini) et OpenCode Go (abonnement à bas coût) trônent en Recommended, suivis d'Anthropic pour l'accès direct à Claude, GitHub Copilot, OpenAI, Google — et OpenRouter, qui transporte une pile de modèles gratuits. Une entrée de fournisseur personnalisé couvre tout le reste.

    OpenCode desktop Settings Providers pane with No connected providers above the Popular providers list OpenCode Zen, OpenCode Go, Anthropic, GitHub Copilot, OpenAI and Google, each with a Connect button
    Settings → Providers : OpenCode Zen et OpenCode Go sont les lignes recommandées.Voir à 1:26
  3. 7

    Connecter GitHub Copilot par login d'appareil

    Si vous payez déjà GitHub Copilot — Pro, Pro+, Business ou Enterprise — vous pouvez l'utiliser sans clé API supplémentaire. Choisissez GitHub Copilot : l'application affiche la boîte Connect GitHub Copilot avec un code de confirmation et un lien. Ouvrez github.com/login/device, saisissez le code, autorisez, et les modèles de votre plan Copilot apparaissent dans le sélecteur.

    Connect GitHub Copilot dialog in the OpenCode desktop app showing the confirmation code 6AF3-F63B and Waiting for authorization while github.com/login/device is open behind it
    Le flux de login d'appareil : saisir le code sur github.com/login/device et autoriser.Voir à 2:30
  4. 8

    Sélectionner un modèle — des gratuits inclus

    La boîte Select model liste les modèles gratuits fournis par OpenCode : Big Pickle, DeepSeek V4 Flash Free, MiMo V2.5 Free, Nemotron 3 Ultra Free et North Mini Code Free. En dessous, Add more models from popular providers ajoute OpenCode Zen, Anthropic, GitHub Copilot et compagnie. Selon le modèle, un sélecteur d'effort de réflexion (de low à max) peut apparaître — gardez la valeur par défaut pour votre première passe.

    Select model dialog in the OpenCode desktop app listing the free models Big Pickle, DeepSeek V4 Flash Free, MiMo V2.5 Free, Nemotron 3 Ultra Free and North Mini Code Free above Add more models from popular providers
    Cinq modèles gratuits sont livrés avec l'application ; les modèles des fournisseurs s'ajoutent dans la même boîte.Voir à 2:44

3 · Plan mode : cadrer le travail avant la moindre ligne de code

  1. 9

    Basculer la zone de saisie en Plan mode

    Sous la zone de texte se trouvent deux menus déroulants : le mode (Build ou Plan) et le modèle. Passez le mode sur Plan avant d'envoyer quoi que ce soit. Le Plan mode est l'un des deux agents intégrés : il peut analyser votre projet et proposer une approche, mais pas écrire ni modifier de fichiers — la même paire Plan/Build qu'avec la touche Tab dans l'interface terminal, où un indicateur en bas à droite montre le mode actif.

    OpenCode desktop composer with the mode dropdown set to Plan beside the Big Pickle model picker on an empty Build anything workspace, before any prompt is sent
    Le menu de mode bascule entre Plan et Build juste sous la zone de saisie.Voir à 3:00
  2. 10

    Répondre aux questions de cadrage

    Envoyez votre brief — dans l'enregistrement, une application web d'analyse de données CSV — et le Plan mode répond avec un panneau Questions au lieu de code. Cette session en a reçu quatre : Tech Stack (React + Node.js, Next.js, Vue + FastAPI ou Plain HTML/JS), Charting Library, Processing Location et Insight Depth. Répondez à chacune, ajoutez vos remarques et validez ; les réponses façonnent le plan.

    Plan mode Questions panel in the OpenCode desktop app asking What tech stack would you like to use with answer chips including Plain HTML/JS no framework for a CSV data analysis web app
    Le Plan mode pose des questions de cadrage avant d'écrire le moindre fichier.Voir à 3:20
  3. 11

    Approuver le plan et passer en Build

    Quand le plan est prêt, l’agent demande Ready to build. Should I proceed? avec la réponse rapide yes proceed. L’écriture de fichiers reste bloquée tant que le Build mode n’est pas actif — et en beta, l’agent ne bascule pas toujours tout seul : déplacez vous-même le menu de mode de Plan vers Build, puis confirmez. C’est ce que dit la documentation officielle : d’abord plan, ensuite build pour faire les changements.

    OpenCode desktop chat replying Ready to build. Should I proceed? with a yes proceed quick reply and the mode dropdown moved to Build over Claude Sonnet 4.6
    Approuvez avec la réponse rapide, puis basculez le menu de mode sur Build.Voir à 4:05
  4. 12

    Regarder le Build mode cocher sa liste de tâches

    Le Build mode transforme le plan en liste de To-dos — Create index.html, Create style.css, Create app.js — et la déroule avec des appels à l’outil Write, en cochant les cases au fil de l’eau. Une aspérité beta de l’enregistrement : le panneau de tâches s’est affiché deux fois ; sans gravité, mais c’est exactement le genre d’aspérité à attendre d’une beta.

    Build mode running in the OpenCode desktop app with the To-dos checklist at 0/3 for index.html, style.css and app.js plus a Write index.html tool call in progress
    Le Build mode avance dans la liste de To-dos et coche chaque fichier écrit.Voir à 4:11

4 · Construire, relire et lancer votre application

  1. 13

    Relire le diff dans Session changes

    Le panneau Session changes compte chaque fichier touché — 11 Changes dans la session de l'app de finances — avec All files à côté, et chaque diff s'ouvre en vue Unified ou Split avec Collapse all. Les lignes vertes sont des ajouts, les rouges des suppressions ; comme les changements sont suivis par session, vous pouvez revenir en arrière avec undo.

    Session changes panel in the OpenCode desktop app with Unified and Split view toggles over an 11 Changes diff of app/goals/page.tsx showing green added lines in the file tree
    Session changes : 11 fichiers touchés, vue Unified plutôt que Split.Voir à 8:20
  2. 14

    Guider l'agent avec des commentaires en ligne

    Ouvrez n'importe quel fichier généré dans la visionneuse, cliquez sur une ligne — la ligne 62 d'app.js dans l'enregistrement — et ajoutez un commentaire sur place. Le champ de commentaire affiche Commenting on line N avec les boutons Cancel et Comment, et l'agent lit les commentaires en ligne comme des instructions ciblées — bien plus précis que de décrire des positions dans le chat.

    app.js open in the OpenCode desktop file viewer with line 62 highlighted to leave an inline comment on a dropZone event listener in the generated data analysis app
    Sélectionnez n'importe quelle ligne dans la visionneuse pour laisser un commentaire en ligne à l'agent.Voir à 5:12
  3. 15

    Lancer des commandes dans le terminal intégré

    L'onglet terminal fait tourner npm run dev, git status, l'installation de paquets — et la CLI OpenCode elle-même si vous voulez la TUI à côté de la GUI. Un réglage compte : Settings → General → Terminal Shell. Dans l'enregistrement, un shell bash laissait la commande du serveur sans effet depuis le chat ; passé sur Auto, les commandes passaient. Gardez Auto tant que vous n'avez pas de raison de changer.

    Terminal 1 tab inside the OpenCode desktop app running the OpenCode CLI welcome screen with Build, Gemini 3 Pro Preview OpenRouter and ctrl+p commands hints under the open app.js file
    L'onglet terminal exécute les serveurs de dev — et la CLI OpenCode elle-même.Voir à 5:18
  4. 16

    Ouvrir l'application finie et continuer d'itérer

    Les applications statiques fonctionnent d'un double-clic sur index.html ; une application Next.js tourne sur localhost:3000 dès que npm run dev est lancé — la page Goals terminée affiche les cartes Total Goals, Total Saved et Overall Progress avec le nouvel objectif Vacation. Continuez à demander des modifications dans la même session, ou ouvrez une session parallèle — plusieurs agents travaillent de front, chacun avec son projet et son modèle.

    Finished Goals page from an OpenCode personal finance build at localhost:3000/goals with Total Goals, Total Saved and Overall Progress cards and a Vacation savings target
    La page Goals construite par l'agent, en train de tourner sur localhost:3000/goals.Voir à 7:40

FAQ de l'application de bureau OpenCode

Continuer l'exploration