Resposta curta
Use o mesmo canal que instalou o OpenCode
A atualização segura permanece no mesmo canal: Homebrew com Homebrew, npm com npm e uma instalação V2 por shell com o fluxo de upgrade documentado pela CLI. Misturar canais pode colocar dois executáveis no PATH; o shell então continua chamando uma cópia antiga.
Antes de alterar algo, rode opencode --version e anote o caminho. Copie a configuração do projeto, a configuração global e os plugins ou skills necessários. É um ponto de restauração pequeno, não um backup completo do computador.
Este guia trata atualizações normais de uma instalação funcionando. A passagem de V1 para V2 é uma migração principal: use o guia de migração do OpenCode V2.
Descubra o canal antes de atualizar o OpenCode
Não adivinhe pelo nome do comando. O OpenCode pode vir do instalador shell, npm, Bun, Homebrew, Arch, de um binário do Windows ou de uma imagem de contêiner.
| Canal provável | Pista | Limite |
|---|---|---|
| Instalador V2 | Foi usado opencode.ai/v2/install | Use o upgrade da CLI V2 e confirme o caminho. |
| npm | npm list -g @opencode/cli mostra o pacote | Atualize o pacote global e confirme o postinstall. |
| Bun, pnpm ou Yarn | Aparece na lista global do gerenciador | Use a sintaxe global e a permissão de scripts correta. |
| Homebrew | brew list --formula contém OpenCode | Atualize essa fórmula, sem instalar outro binário. |
| Windows | where opencode aponta para um exe | Siga o download oficial e substitua o arquivo certo. |
No Unix, command -v opencode e type -a opencode mostram as cópias. No PowerShell, use Get-Command opencode | Format-List Source,Version. Vários caminhos exigem limpar o PATH antes do update.
Comandos de atualização por canal
Os exemplos seguem os caminhos oficiais conferidos hoje. Pacotes e plataformas podem mudar; abra a documentação oficial e escolha uma única linha compatível com sua instalação.
CLI V2 já instalada
A CLI V2 documenta opencode upgrade e o alias opencode update. Confira a versão antes e depois. Se o comando não existir, pode haver um pacote V1 ou outro binário no caminho.
opencode --version
opencode upgrade
opencode --versionnpm, Bun, pnpm e Homebrew
O pacote npm da V2 é @opencode/cli. Bun e pnpm podem exigir permissão explícita para scripts; o Homebrew deve atualizar a fórmula já instalada.
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-v2Não execute todas as linhas. Verifique erros de permissão, scripts ignorados e o prefixo. Uma transação concluída não prova que o shell usa o binário novo.
Windows, contêiner e CI
A página oficial da V2 oferece um caminho de binário para Windows. Depois de substituir o arquivo, abra outra sessão do PowerShell. Em contêiner e CI, atualize a imagem ou o lockfile e reconstrua; uma alteração manual em um contêiner em execução não é reproduzível.
Verifique a atualização antes de usar em um repositório real
O número da versão apenas mostra qual executável respondeu. Uma verificação útil cobre as tarefas que podem quebrar depois da troca do pacote.
- Confirme o binário.Rode
opencode --versione o comando de caminho do sistema. - Use um projeto de baixo risco.Comece em um repositório descartável ou branch limpa.
- Teste provider e modelo.Faça uma solicitação somente leitura sem registrar segredos.
- Teste permissões.Verifique leitura, pequena edição e comando que exige aprovação.
- Teste extensões.Execute um agent, command, skill, servidor MCP ou plugin importante.
- Revise o diff.Procure arquivos inesperados, logs e mudanças na configuração.
Registre sistema operacional, shell, canal, provider, modelo e tarefa. Assim o próximo OpenCode update fica comparável e a equipe tem um ponto de retorno.
Faça rollback quando a atualização quebrar a CLI
Pare de usar a instalação alterada e separe problema de caminho, pacote ou compatibilidade. Preserve o cache ou instalador anterior conforme a política e mantenha o backup da configuração separado do executável.
Comando não encontrado
Abra um shell novo, use where opencode ou command -v opencode e compare o prefixo do gerenciador. Corrija o PATH antes de reinstalar.
Provider ou modelo falha
Compare o caminho de configuração e o ID do modelo com a anotação anterior. Não publique chaves. Teste uma solicitação de leitura e consulte as notas do provider.
Plugin ou MCP falha
Desative a extensão em um projeto de teste e confirme que a CLI base funciona. Consulte o guia de plugins ou o guia de MCP. Uma migração V1-V2 precisa do plano oficial.
Nota sobre a versão atual do OpenCode
Em 18 de outubro de 2026, o changelog oficial mostrava v2.0.32 na primeira entrada, datada de 16 de outubro. A página oficial de download listava instalador V2, npm, Bun, Homebrew, Arch e binários. É uma verificação datada, não uma promessa de latest permanente.
Não inventamos link direto, tamanho de arquivo ou resultado de segurança. Use o caminho oficial e registre o resultado de opencode --version.
Perguntas frequentes sobre opencode update
Como atualizar o OpenCode?
Identifique o canal, registre a versão e execute o comando desse canal. Em uma CLI V2 use opencode upgrade; update é o alias. npm, Bun, pnpm, Homebrew e binário continuam na origem original.
Qual é o comando de atualização da CLI do OpenCode?
Em uma instalação V2 use opencode upgrade. Se não existir, verifique pacote V1 ou outra cópia no PATH.
Como atualizar para a versão mais recente?
Latest depende do canal e do sistema. Consulte changelog e download oficiais, atualize pelo mesmo canal e confirme a versão impressa pelo binário.
Como atualizar o OpenCode no Windows?
Use a rota oficial para a arquitetura, substitua o exe, abra o PowerShell de novo e verifique Get-Command opencode e opencode --version.
A atualização reescreve minha configuração?
Uma atualização normal não é uma migração de configuração. Guarde uma cópia, leia os avisos e trate V1 para V2 separadamente.
Devo atualizar plugins antes da CLI?
Atualize primeiro o núcleo em um projeto de teste e depois verifique cada plugin, MCP, agent e cliente de editor.
Fontes oficiais e guias relacionados
Comandos e versão foram conferidos em 18 de outubro de 2026. Abra as fontes novamente antes de uma atualização futura.