Réponse courte
Utilisez le même canal que celui de l'installation
Une mise à jour OpenCode sûre reste dans le même canal : Homebrew avec Homebrew, npm avec npm, et l'installation V2 par shell avec le flux d'upgrade de la CLI. Mélanger les canaux peut placer deux exécutables dans PATH et vous faire lancer une ancienne copie.
Avant de modifier quoi que ce soit, exécutez opencode --version et notez le chemin du binaire. Copiez la configuration du projet, la configuration globale et les plugins ou skills nécessaires. C'est un petit point de restauration, pas une sauvegarde complète de la machine.
Cette page décrit les mises à jour courantes. Un passage de V1 à V2 est une migration majeure : consultez le guide de migration OpenCode V2.
Identifiez le canal avant de mettre OpenCode à jour
Ne déduisez pas l'origine du seul nom de commande. OpenCode peut venir de l'installateur shell, de npm, Bun, Homebrew, Arch, d'un exécutable Windows ou d'une image de conteneur.
| Canal probable | Indice | Limite |
|---|---|---|
| Installateur V2 | opencode.ai/v2/install a été utilisé | Suivez le flux d'upgrade V2 et revérifiez le chemin. |
| npm | npm list -g @opencode/cli affiche le paquet | Mettez à jour le paquet global et son postinstall. |
| Bun, pnpm ou Yarn | Le paquet est dans la liste globale | Utilisez la syntaxe globale et les permissions de scripts. |
| Homebrew | brew list --formula contient OpenCode | Mettez à jour cette formule sans installer un second binaire. |
| Windows | where opencode pointe vers un exe | Utilisez la page officielle et remplacez le bon fichier. |
Sur Unix, command -v opencode et type -a opencode montrent les copies. Dans PowerShell, utilisez Get-Command opencode | Format-List Source,Version. Plusieurs chemins signifient qu'il faut clarifier PATH avant l'upgrade.
Commandes de mise à jour selon le canal
Ces exemples correspondent aux chemins officiels contrôlés aujourd'hui. Les noms de paquets et les plateformes évoluent ; ouvrez la documentation officielle avant d'exécuter une commande et choisissez une seule ligne.
CLI V2 déjà installée
La CLI V2 documente opencode upgrade et l'alias opencode update. Vérifiez la version avant et après. Une commande absente indique souvent une installation V1 ou un autre binaire sur le chemin.
opencode --version
opencode upgrade
opencode --versionnpm, Bun, pnpm et Homebrew
Le paquet V2 est @opencode/cli. Bun et pnpm peuvent demander une permission explicite pour les scripts ; Homebrew doit mettre à jour la formule déjà installée.
npm install -g @opencode/cli
bun install -g --trust @opencode/cli
pnpm add -g --allow-build=@opencode/cli @opencode/cli
brew upgrade anomalyco/tap/opencode-v2Ne lancez pas toutes les lignes. Examinez les erreurs de permission, les scripts ignorés et le préfixe du gestionnaire. Une transaction réussie ne prouve pas que le shell utilise le nouveau binaire.
Windows, conteneurs et CI
La page V2 officielle fournit un parcours binaire pour Windows. Après remplacement, ouvrez une nouvelle session PowerShell. Dans un conteneur ou la CI, mettez à jour l'image ou le lockfile puis reconstruisez ; ne considérez pas une modification temporaire du conteneur comme reproductible.
Vérifiez l'update avant un dépôt réel
Le numéro de version dit seulement quel exécutable a répondu. Une vérification utile couvre les opérations qui cassent après un changement de paquet.
- Confirmez le binaire.Exécutez
opencode --versionet la commande de chemin du système. - Utilisez un projet peu risqué.Commencez dans un dépôt jetable ou une branche propre.
- Testez fournisseur et modèle.Faites une requête en lecture seule sans exposer de secret.
- Testez les permissions.Vérifiez lecture, petite modification et commande soumise à approbation.
- Testez les extensions.Exécutez un agent, une commande, une skill, un serveur MCP ou un plugin important.
- Inspectez le diff.Recherchez fichiers inattendus, logs et changements de configuration.
Notez système, shell, canal, fournisseur, modèle et tâche. Cette fiche rend le prochain OpenCode update comparable et donne à l'équipe un point de retour.
Revenir en arrière si la CLI ne fonctionne plus
Arrêtez l'installation modifiée et distinguez problème de chemin, de paquet ou de compatibilité. Gardez l'ancien cache ou installateur selon la politique de l'équipe, et séparez la sauvegarde de configuration du binaire.
Commande introuvable
Ouvrez un shell neuf, utilisez where opencode ou command -v opencode, puis comparez le préfixe du gestionnaire. Corrigez PATH avant de réinstaller.
Provider ou modèle en échec
Comparez le chemin de configuration et l'identifiant du modèle avec votre note. Ne publiez pas de clé. Testez une requête en lecture seule et consultez les notes du provider.
Plugin ou MCP en échec
Désactivez l'extension dans un projet de test et confirmez que le cœur fonctionne. Consultez le guide des plugins ou le guide MCP. Une migration V1-V2 doit suivre le plan officiel.
Note sur la version actuelle
Le 18 octobre 2026, le changelog officiel affichait v2.0.32 en tête, avec une date du 16 octobre. La page officielle listait l'installateur V2, npm, Bun, Homebrew, Arch et les binaires. Cette observation est datée ; elle ne promet pas une version latest permanente.
Nous n'inventons ni lien direct, ni taille, ni scan de sécurité. Utilisez le parcours officiel et notez le résultat de opencode --version.
Questions fréquentes sur opencode update
Comment mettre OpenCode à jour ?
Identifiez le canal, notez la version, puis utilisez la commande de ce canal. Une CLI V2 utilise opencode upgrade et l'alias update. npm, Bun, pnpm, Homebrew et les binaires restent sur leur source d'origine.
Quelle est la commande d'update de la CLI OpenCode ?
Pour une installation V2, utilisez opencode upgrade. Si elle manque, vérifiez un paquet V1 ou une autre copie dans PATH.
Comment passer à la dernière version ?
La dernière version dépend du canal et du système. Consultez le changelog et la page de téléchargement, mettez à jour par le même canal puis vérifiez la version imprimée.
Comment mettre OpenCode à jour sous Windows ?
Utilisez la route officielle pour l'architecture voulue, remplacez l'exe, ouvrez PowerShell de nouveau et vérifiez Get-Command opencode et opencode --version.
Une mise à jour réécrit-elle ma configuration ?
Une mise à jour courante n'est pas une migration de configuration. Gardez une copie, lisez les notes et traitez V1 vers V2 séparément.
Faut-il mettre à jour les plugins avant la CLI ?
Mettez d'abord le cœur à jour dans un projet de test, puis vérifiez chaque plugin, MCP, agent et client avec sa version compatible.
Sources officielles et guides liés
Les commandes et la version ont été vérifiées le 18 octobre 2026. Consultez à nouveau les sources lors d'une prochaine mise à jour.