Installer facilement OpenCode sur Mac et Windows

L'installation d'OpenCode peut parfois sembler déroutante lorsque des erreurs de configuration interrompent le processus ou que l'outil ne fonctionne pas comme prévu. Des commandes manquantes aux problèmes de compatibilité avec Node.js, les utilisateurs rencontrent souvent des difficultés lors de l'installation initiale. Ce guide d'installation d'OpenCode propose une solution complète pour corriger les erreurs courantes et configurer correctement OpenCode sur Mac et Windows, que vous utilisiez Desktop ou CLI/TUI, afin de pouvoir commencer à programmer sans attendre.

OpenCode est un agent de programmation par IA open source conçu pour aider les développeurs à écrire, modifier, déboguer et gérer du code directement depuis leur environnement préféré, qu'il s'agisse d'un terminal, d'un IDE ou d'une application de bureau. Contrairement aux assistants de programmation par IA traditionnels, principalement axés sur les suggestions de code, OpenCode peut comprendre l'ensemble d'une base de code, modifier des fichiers, exécuter des commandes et automatiser les flux de travail de développement. Il prend également en charge plusieurs modèles d'IA et modèles locaux, offrant aux développeurs davantage de flexibilité et de contrôle dans la création de logiciels.

Avant d'installer OpenCode, vérifiez que votre système répond aux exigences de base. Les prérequis exacts dépendent de votre choix entre l'application de bureau et l'interface basée sur le terminal, mais une configuration adaptée contribuera au bon déroulement de l'installation.

Système d'exploitation : macOS / Windows / Linux

OpenCode propose des applications de bureau pour les principaux systèmes d'exploitation, ce qui permet aux développeurs d'installer et d'utiliser l'outil dans l'environnement de leur choix. Vérifiez que votre système utilise un système d'exploitation compatible, tel que macOS (Apple Silicon ou Intel), Windows (x64) ou Linux (.deb, .rpm).

Autorisation d'installer des applications : vous pouvez avoir besoin de droits d'administrateur ou de droits système pour télécharger et installer des logiciels sur votre appareil. Cela est particulièrement important dans les environnements professionnels ou informatiques gérés, où les droits d'installation peuvent être restreints.

Connexion Internet stable : une connexion Internet fiable est nécessaire pour télécharger OpenCode, installer les mises à jour et se connecter aux modèles et services d'IA pris en charge lors de la configuration et de l'utilisation.

Accès au terminal : OpenCode peut être installé et utilisé directement depuis la ligne de commande. Vérifiez que vous avez accès à une application de terminal, telle que Terminal sur macOS, Invite de commandes ou PowerShell sur Windows, ou un shell Linux.

Une méthode d'installation : OpenCode prend en charge plusieurs méthodes d'installation afin de s'adapter aux différents systèmes d'exploitation et préférences des développeurs. Choisissez le gestionnaire de paquets ou l'outil d'installation le mieux adapté à votre environnement, comme npm, curl, brew, Scoop, Chocolatey ou WSL.

Connaissances de base de la ligne de commande : la maîtrise des commandes courantes du terminal peut grandement faciliter l'installation et l'utilisation quotidienne. Une expertise avancée n'est pas nécessaire, mais il est recommandé de comprendre les bases de la navigation et de l'exécution des commandes.

L'installation d'OpenCode Desktop est simple et ne nécessite que quelques étapes pour mettre l'application en service. Voici les étapes à suivre.

Étape 1 : télécharger OpenCode Desktop

Accédez à la page de téléchargement officielle d'OpenCode et sélectionnez la version Windows ou macOS de l'application. Le programme d'installation se téléchargera automatiquement sur votre système. Pour des raisons de sécurité et d'authenticité, veillez à le télécharger depuis la source officielle.

Étape 2 : Exécuter le programme d’installation

Localisez le fichier d’installation téléchargé et double-cliquez dessus pour lancer l’installation. Suivez les instructions à l’écran pour terminer la configuration.

Étape 3 : Terminer l’installation

Suivez les invites de configuration au fur et à mesure qu’elles s’affichent et sélectionnez le répertoire d’installation de votre choix lorsque cela vous est demandé. Laissez ensuite le programme d’installation terminer la configuration sur votre système.

Étape 4 : Lancer OpenCode Desktop

Une fois l’installation terminée, ouvrez OpenCode Desktop depuis le menu Démarrer ou le raccourci du bureau. Créez ensuite un nouveau projet ou ouvrez un dossier existant pour commencer à travailler. Une fois votre espace de travail chargé, vous pouvez interagir avec l’assistant IA afin de générer du code, de déboguer des problèmes ou de développer des fonctionnalités directement dans votre projet.

OpenCode Terminal (TUI) sur Mac peut être installé directement à l’aide de gestionnaires de paquets officiels ou d’une commande d’installation sur une seule ligne. Il est conçu pour les développeurs qui préfèrent travailler dans le terminal plutôt qu’avec une interface graphique. Suivez ces étapes pour installer OpenCode TUI sur Mac.

Étape 1 : Choisir une méthode d’installation d’OpenCode Terminal

Accédez à la page de téléchargement officielle d’OpenCode, puis à la section OpenCode Terminal. Vous y trouverez plusieurs options d’installation, notamment curl, Homebrew, npm et bun. Sélectionnez la méthode la mieux adaptée à votre environnement de développement et copiez la commande d’installation correspondante.

Étape 2 : Ouvrir l’application Terminal sur Mac

Lancez l’application Terminal sur votre Mac. Vous pouvez l’ouvrir depuis Applications > Utilitaires > Terminal ou la trouver rapidement avec la recherche Spotlight. C’est là que vous exécuterez la commande d’installation d’OpenCode.

Étape 3 : Installer OpenCode Terminal

Collez la commande d’installation suivante dans le Terminal, puis appuyez sur Entrée :

Attendez la fin de l’installation. OpenCode téléchargera les fichiers requis et configurera automatiquement l’interface CLI.

Étape 4 : Lancer l’interface du terminal OpenCode

Une fois l’installation terminée, exécutez la commande OpenCode dans le Terminal pour démarrer l’interface utilisateur du terminal (TUI). L’interface interactive s’ouvrira directement dans votre fenêtre de terminal et vous permettra de vous connecter à un fournisseur d’IA, de configurer les paramètres et de commencer à travailler avec OpenCode.

OpenCode prend en charge plusieurs méthodes d’installation sous Windows, notamment WSL, npm et bun. Pour une compatibilité et une expérience optimales, la documentation officielle recommande d’utiliser le sous-système Windows pour Linux (WSL). Les étapes ci-dessous utilisent la méthode d’installation via WSL. Si WSL est déjà installé, vous pouvez passer la première étape.

Étape 1 : Installer WSL (recommandé)

Ouvrez PowerShell en tant qu’administrateur, puis exécutez la commande suivante :

Cette commande active le sous-système Windows pour Linux (WSL) et installe Ubuntu par défaut. Une fois l’installation terminée, redémarrez votre ordinateur. La première fois que vous ouvrirez Ubuntu, Windows terminera automatiquement la configuration de l’environnement Linux.

Étape 2 : Ouvrir WSL et installer OpenCode

Lancez votre terminal WSL, tel qu’Ubuntu, depuis le menu Démarrer de Windows. Si vous l’ouvrez pour la première fois, effectuez la configuration initiale. Exécutez ensuite la commande suivante pour installer OpenCode :

Attendez la fin de l’installation avant de continuer.

Étape 3 : Vérifier l’installation

Une fois l’installation terminée, exécutez la commande suivante :

Si OpenCode Terminal/TUI se lance correctement, l’installation est terminée et vous pouvez commencer à utiliser OpenCode pour programmer avec l’aide de l’IA.

L’un des principaux atouts d’OpenCode est sa capacité à se connecter à des fournisseurs externes de modèles d’IA via des intégrations API. En ajoutant votre propre clé API, vous pouvez accéder à différents modèles de langage et choisir celui qui convient le mieux à votre flux de travail de programmation.

Voici les étapes à suivre pour intégrer des API externes à OpenCode :

Étape 1 : Créer un compte et générer une clé API

Commencez par créer un compte auprès du fournisseur d’IA de votre choix, comme Kimi ou un autre service pris en charge. Une fois votre compte configuré, accédez à la page de gestion des clés API du fournisseur et générez une nouvelle clé API. Conservez cette clé en lieu sûr, car elle sera nécessaire pour connecter le fournisseur à OpenCode.

Étape 2 : Ouvrir le menu de connexion des fournisseurs

Lancez OpenCode et ouvrez votre espace de travail. Dans l’interface de commande, exécutez la commande suivante :

Cette commande ouvre le menu de connexion des fournisseurs, dans lequel vous pouvez ajouter et gérer des services d’IA externes.

Étape 3 : Ajouter votre clé API

Sélectionnez dans la liste des options disponibles le fournisseur que vous souhaitez utiliser. Lorsque vous y êtes invité, collez la clé API générée précédemment et confirmez la connexion. OpenCode stockera la clé de manière sécurisée et l’utilisera pour authentifier les requêtes adressées au fournisseur sélectionné.

Étape 4 : Afficher les modèles disponibles

Après avoir connecté votre fournisseur, exécutez la commande suivante pour afficher tous les modèles disponibles via cette API :

OpenCode affichera la liste des modèles pris en charge, ainsi que leurs noms et options de configuration.

Étape 5 : Sélectionner un modèle et commencer à l’utiliser

Choisissez dans la liste disponible le modèle avec lequel vous souhaitez travailler. Une fois sélectionné, OpenCode acheminera vos requêtes vers ce modèle, ce qui vous permettra de générer du code, déboguer des applications et effectuer d’autres tâches de développement à l’aide de l’API connectée. Vous pourrez changer de modèle ultérieurement si vos besoins évoluent.

OpenCode prend en charge plusieurs fournisseurs d’IA, ce qui permet aux développeurs de connecter des modèles externes à l’aide de clés API pour plus de flexibilité. L’une des options les plus puissantes est l’API Kimi.

L’API Kimi, fournie par la plateforme ouverte Moonshot AI, donne accès à des modèles de langage Kimi avancés via une interface compatible avec OpenAI. Elle s’intègre facilement aux outils de programmation, aux applications et aux flux de travail pilotés par l’IA grâce à une clé API sécurisée. La plateforme propose une gamme de modèles Kimi optimisés pour les tâches de programmation, de raisonnement et de compréhension de longs contextes.

Suivez ces étapes pour intégrer les API Kimi à OpenCode.

Étape 1 : Créer un compte Moonshot AI et générer une clé API

1. Rendez-vous sur la plateforme ouverte Kimi AI et connectez-vous à votre compte.

2. Depuis le tableau de bord, accédez à API Keys et cliquez sur Create API Key.

3. Une fois la clé générée (elle commence par sk-), copiez-la immédiatement et stockez-la de manière sécurisée. La clé n’est affichée qu’une seule fois et sert à authentifier les requêtes entre OpenCode et Moonshot AI.

Étape 2 : Connecter Moonshot AI à OpenCode

Ouvrez votre espace de travail OpenCode et exécutez :

Le menu de connexion des fournisseurs s’affiche. Recherchez Moonshot AI (ou Kimi) dans la liste des fournisseurs intégrés et sélectionnez-le. OpenCode vous invitera à saisir votre clé API.

Lorsque vous y êtes invité, collez la clé API générée depuis la console Moonshot AI et appuyez sur Entrée :

Une fois vérifié, OpenCode enregistrera de manière sécurisée l’identifiant dans ~/.local/share/opencode/auth.json et l’associera à la configuration de votre fournisseur Moonshot AI.

Remarque : OpenCode stocke les clés API séparément du fichier de configuration principal pour des raisons de sécurité. La commande /connect gère le stockage des identifiants, tandis que le comportement du fournisseur est configuré dans opencode.json.

Étape 3 : Configurer le fournisseur dans opencode.json (si nécessaire)

Si vous rencontrez une erreur No endpoints found après la connexion, ou si vous devez personnaliser la configuration du fournisseur, ajoutez la configuration Moonshot AI à votre fichier opencode.json :

Enregistrez le fichier et redémarrez OpenCode pour appliquer les modifications.

Étape 4 : Afficher les modèles Kimi disponibles

Après avoir connecté le fournisseur, exécutez :

OpenCode affichera tous les modèles disponibles via votre compte Moonshot AI, notamment :

Étape 5 : Sélectionner un modèle Kimi et commencer à programmer

Sélectionnez moonshotai/kimi-k3 et définissez-le comme modèle actif. Une fois sélectionné, OpenCode utilisera le modèle Kimi choisi pour la génération de code, le débogage, la refactorisation et d’autres tâches de développement assistées par l’IA.

Vous pouvez passer à un autre modèle à tout moment depuis le même menu de sélection des modèles.

Conseil : si vous rencontrez des problèmes avec le mode Agent/Outil (tels que des erreurs de validation JSON Schema), il s’agit d’un problème de compatibilité connu entre les exigences strictes de Moonshot AI en matière de schéma et le format des paramètres d’outil d’OpenCode. Pour une meilleure stabilité, utilisez le mode Chat ou installez le plugin opencode-moonshot-compatibility afin de gérer automatiquement la compatibilité de la température.

L’API Kimi est conçue pour accompagner les flux de travail de développement modernes en aidant les équipes à passer plus efficacement des idées à la mise en œuvre. Au-delà de la génération de code, elle peut comprendre différents types d’entrées, s’adapter aux exigences des projets et automatiser les tâches d’ingénierie courantes. Voici quelques-uns de ses principaux avantages :

• Transformer des entrées multimodales en implémentations fonctionnelles

Kimi API peut interpréter des informations provenant de plusieurs formats, notamment des maquettes de conception, des diagrammes d'architecture, des organigrammes et des vidéos. Il utilise ce contexte pour comprendre les exigences du projet et les convertir en spécifications techniques ou en code fonctionnel. Les équipes peuvent ainsi passer du concept à l'implémentation en limitant les étapes de traduction manuelles.

• Gérer le codage à long terme et les tâches d'ingénierie complexes

Kimi API aide OpenCode à gérer des tâches de codage plus importantes qui exigent planification, cohérence et amélioration. Il est utile pour développer des fonctionnalités, refactoriser du code et résoudre des problèmes d'ingénierie complexes.

• Résoudre des problèmes grâce à des appels d'outils en plusieurs étapes

Kimi API peut raisonner sur des tâches en plusieurs étapes et appeler des outils lorsque nécessaire. Cela facilite le débogage, l'analyse de code et les workflows qui ne peuvent pas être réalisés en une seule réponse.

L'installation d'OpenCode est généralement simple, mais des erreurs de configuration courantes peuvent survenir en raison d'incompatibilités d'environnement, de dépendances ou de problèmes de paramétrage. Vous trouverez ci-dessous un guide clair et pratique pour résoudre rapidement et efficacement les problèmes d'installation les plus fréquents.

• Commande introuvable : opencode

Si cette erreur s'affiche, cela signifie que le système ne parvient pas à localiser l'exécutable OpenCode dans votre PATH. Cela se produit généralement lorsque l'installation est incomplète ou que les variables d'environnement ne sont pas correctement définies.

Pour y remédier, vérifiez d'abord l'installation et assurez-vous que le répertoire des binaires est ajouté au PATH de votre système. En cas d'installation via npm, vérifiez le chemin de vos binaires npm globaux et mettez à jour la configuration de votre shell en conséquence. Après les corrections, le redémarrage du terminal résout souvent le problème.

• Version de Node.js trop ancienne

Seule la méthode d'installation via npm nécessite un environnement Node.js ; le script d'installation et les gestionnaires de paquets (Homebrew, Scoop, Chocolatey) installent un binaire autonome qui ne requiert pas Node.js.

Si vous avez installé via npm et rencontrez des erreurs de version, vérifiez votre version actuelle avec node --version et mettez à niveau Node.js à l'aide d'un gestionnaire de versions tel que nvm. Après la mise à niveau, réinstallez OpenCode afin d'assurer sa compatibilité avec l'environnement d'exécution mis à jour.

• Erreurs d'autorisation npm

Les erreurs d'autorisation surviennent généralement lorsque npm tente d'installer des paquets globaux sans disposer des droits d'écriture nécessaires.

Au lieu d'utiliser sudo, configurez un répertoire global npm dédié dans votre dossier personnel et mettez à jour les paramètres PATH. Cela garantit des installations plus sûres et plus stables. Une fois les autorisations corrigées, relancez la commande d'installation pour terminer correctement la configuration.

• Problèmes de réseau ou de pare-feu

Dans les réseaux restreints ou les environnements d'entreprise, l'installation d'OpenCode peut échouer en raison d'un accès bloqué au registre npm ou de téléchargements lents.

Pour résoudre ce problème, utilisez un autre registre npm ou une méthode d'installation directe, telle que curl ou le téléchargement du binaire. Vérifiez également que votre pare-feu autorise le trafic Node.js et npm, car des connexions bloquées interrompent souvent l'installation des paquets.

• Problèmes d'affichage du TUI

Si OpenCode s'ouvre mais semble défectueux, mal aligné ou affiche du texte illisible, le problème vient généralement de la compatibilité du terminal.

Utilisez un émulateur de terminal moderne prenant en charge les couleurs réelles et le rendu Unicode, tel que Windows Terminal, WezTerm ou iTerm2. La mise à jour des paramètres de votre terminal ou le changement d'environnement résout généralement les problèmes d'affichage immédiatement.

Une installation correcte d'OpenCode et une configuration appropriée garantissent un fonctionnement fluide sur différents systèmes tout en réduisant le risque d'erreurs de configuration courantes. Lorsque les dépendances, les paramètres du terminal et les connexions API sont correctement gérés, les utilisateurs peuvent résoudre rapidement les problèmes et maintenir un environnement de développement stable. L'intégration de services externes tels que Kimi API offre davantage de flexibilité en permettant l'accès à des modèles avancés dans les workflows.