Risposta rapida
Usa lo stesso canale con cui hai installato OpenCode
Un aggiornamento sicuro resta nello stesso canale: Homebrew con Homebrew, npm con npm e l'installazione V2 via shell con il flusso di upgrade della CLI. Mescolare i canali può lasciare due eseguibili in PATH, quindi la shell può avviare una copia vecchia.
Prima di cambiare qualcosa esegui opencode --version e annota il percorso. Copia configurazione del progetto, configurazione globale e plugin o skill necessari. È un punto di ripristino piccolo, non un backup completo del computer.
Questa guida tratta gli aggiornamenti normali. Il passaggio da V1 a V2 è una migrazione principale: consulta la guida alla migrazione OpenCode V2.
Individua il canale prima dell'aggiornamento OpenCode
Non dedurlo solo dal nome del comando. OpenCode può provenire da installer shell, npm, Bun, Homebrew, Arch, eseguibile Windows o immagine container.
| Canale probabile | Indizio | Confine dell'update |
|---|---|---|
| Installer V2 | È stato usato opencode.ai/v2/install | Usa l'upgrade V2 e controlla di nuovo il percorso. |
| npm | npm list -g @opencode/cli mostra il pacchetto | Aggiorna il pacchetto globale e il postinstall. |
| Bun, pnpm o Yarn | Il pacchetto è nella lista globale | Usa sintassi globale e permessi per gli script. |
| Homebrew | brew list --formula contiene OpenCode | Aggiorna quella formula, senza installare un secondo binario. |
| Windows | where opencode punta a un exe | Segui il download ufficiale e sostituisci il file corretto. |
Su Unix command -v opencode e type -a opencode mostrano le copie. In PowerShell usa Get-Command opencode | Format-List Source,Version. Più percorsi vanno risolti prima di aggiornare.
Comandi per aggiornare OpenCode in base al canale
Gli esempi seguono i percorsi ufficiali controllati oggi. Pacchetti e piattaforme cambiano: apri la documentazione ufficiale e scegli una sola riga compatibile.
CLI V2 già installata
La CLI V2 documenta opencode upgrade e l'alias opencode update. Controlla la versione prima e dopo. Se il comando manca, potresti usare V1 o un altro eseguibile.
opencode --version
opencode upgrade
opencode --versionnpm, Bun, pnpm e Homebrew
Il pacchetto npm V2 è @opencode/cli. Bun e pnpm possono richiedere un permesso esplicito per gli script; Homebrew deve aggiornare la formula già presente.
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-v2Non eseguire tutte le righe. Controlla errori di permesso, script saltati e prefisso. Una transazione riuscita non dimostra che la shell usi il nuovo binario.
Windows, container e CI
La pagina V2 ufficiale offre un percorso binario per Windows. Dopo la sostituzione apri una nuova sessione PowerShell. In container e CI aggiorna immagine o lockfile e ricostruisci: una modifica in un container attivo non è riproducibile.
Verifica l'aggiornamento prima di un repository reale
Il numero di versione indica solo quale eseguibile ha risposto. Una buona verifica copre le operazioni che possono rompersi dopo il cambio del pacchetto.
- Conferma il binario.Esegui
opencode --versione il comando di percorso del sistema. - Usa un progetto a basso rischio.Parti da un repository usa e getta o da un branch pulito.
- Prova provider e modello.Invia una richiesta in sola lettura senza registrare segreti.
- Prova i permessi.Controlla lettura, piccola modifica e comando che richiede approvazione.
- Prova le estensioni.Esegui un agent, command, skill, server MCP o plugin importante.
- Controlla il diff.Cerca file, log e configurazioni inattese.
Annota sistema operativo, shell, canale, provider, modello e attività. Il prossimo OpenCode update sarà confrontabile e il team avrà un punto di ripristino.
Rollback quando l'aggiornamento rompe la CLI
Interrompi l'uso dell'installazione modificata e separa problema di percorso, pacchetto o compatibilità. Conserva cache o installer precedente secondo la policy e separa il backup della configurazione dall'eseguibile.
Comando non trovato
Apri una shell nuova, usa where opencode o command -v opencode e confronta il prefisso del gestore. Correggi PATH prima di reinstallare.
Provider o modello non funziona
Confronta percorso della configurazione e ID del modello con la nota precedente. Non pubblicare chiavi. Prova una richiesta in lettura e controlla le note del provider.
Plugin o MCP non funziona
Disattiva l'estensione in un progetto di prova e conferma che la CLI base funzioni. Consulta la guida plugin o la guida MCP. La migrazione V1-V2 richiede il piano ufficiale.
Nota sulla versione corrente di OpenCode
Il 18 ottobre 2026 il changelog ufficiale mostrava v2.0.32 come prima voce, datata 16 ottobre. La pagina ufficiale elencava installer V2, npm, Bun, Homebrew, Arch e binari. È una verifica datata, non una promessa di latest permanente.
Non inventiamo URL diretti, dimensioni o risultati di sicurezza. Usa il percorso ufficiale e annota il risultato di opencode --version.
Domande frequenti su opencode update
Come aggiorno OpenCode?
Identifica il canale, annota la versione ed esegui il comando di quel canale. In una CLI V2 usa opencode upgrade; update è l'alias. npm, Bun, pnpm, Homebrew e binario restano sulla fonte originale.
Qual è il comando di aggiornamento della CLI OpenCode?
Per una installazione V2 è opencode upgrade. Se manca, controlla pacchetto V1 o un'altra copia in PATH.
Come aggiorno OpenCode all'ultima versione?
Latest dipende dal canale e dal sistema. Controlla changelog e download ufficiali, aggiorna dallo stesso canale e verifica la versione stampata.
Come aggiorno OpenCode su Windows?
Usa il percorso ufficiale per l'architettura, sostituisci l'exe, riapri PowerShell e verifica Get-Command opencode e opencode --version.
L'aggiornamento riscrive la configurazione?
Un update normale non è una migrazione della configurazione. Conserva una copia, leggi gli avvisi e tratta V1 verso V2 separatamente.
Devo aggiornare prima plugin o CLI?
Aggiorna prima il core in un progetto di prova, poi controlla ogni plugin, MCP, agent e client editor.
Fonti ufficiali e guide correlate
Comandi e versione sono stati controllati il 18 ottobre 2026. Riapri le fonti prima di un aggiornamento futuro.