OpenCode: OpenCode Installation

Última atualização: 2026-08-31

--- title: Instalação do OpenCode description: Compreenda os métodos de instalação do OpenCode em diferentes sistemas operacionais, incluindo instalação com um clique, via gerenciador de pacotes e verificação order: 2 lang: pt-br

O OpenCode suporta instalação em múltiplas plataformas. Recomendamos o script de instalação rápida.

1. O Que Você Vai Aprender

• Requisitos de sistema
• Instalação com um clique
• Métodos de instalação por plataforma
• Verificação e inicialização

2. Requisitos de Sistema

(1) Sistema Operacional

(2) Terminal

Um terminal moderno é necessário para a melhor experiência:

(3) API Key

O OpenCode não inclui modelos — é necessário configurar um serviço de IA:

• OpenCode Zen (seleção oficial, com modelos gratuitos)
• OpenAI (GPT)
• Anthropic (Claude)
• DeepSeek
• Alibaba Bailian
• GLM / MiniMax

3. Instalação com Um Clique (Recomendado)

Para macOS / Linux / WSL:

curl -fsSL https://opencode.ai/install | bash

Após a instalação, entre no diretório do projeto e inicie:

cd <project>
opencode

4. Instalação via Node.js

Se você está familiarizado com o ecossistema Node.js:

npm install -g opencode-ai

Ou com pnpm:

pnpm install -g opencode-ai

Ou com yarn:

yarn global add opencode-ai

5. Instalação por Plataforma

(1) macOS (Homebrew)

brew install anomalyco/tap/opencode

Recomendado usar o tap oficial para atualizações mais rápidas.

(2) Windows

Recomendado usar WSL para mais estabilidade e suporte completo.

Outras opções:

# Chocolatey
choco install opencode

# Scoop
scoop install opencode

# NPM
npm install -g opencode-ai

# Mise
mise use -g github:anomalyco/opencode

# Docker
docker run -it --rm ghcr.io/anomalyco/opencode

Também é possível baixar o binário diretamente do GitHub Releases.

(3) Linux

# Método universal (recomendado)
curl -fsSL https://opencode.ai/install | bash

# Arch Linux
sudo pacman -S opencode

# Docker
docker run -it --rm ghcr.io/anomalyco/opencode

6. Verificação da Instalação

opencode --version

Saída semelhante a:

1.1.50

7. Iniciando o OpenCode

opencode

Se ocorrer erro EACCES: permission denied, corrija as permissões:

BASH

📋 Copy

sudo chown -R $(whoami) ~/.local
chmod -R 755 ~/.local

8. Solução de Problemas de Permissão

❓ FAQ

P: Windows nativo ou WSL, qual escolher?

R: Recomendado WSL. O Windows nativo tem suporte limitado para algumas funcionalidades, enquanto o WSL oferece uma experiência Linux completa com melhor compatibilidade.

P: O que fazer se command not found aparecer após a instalação?

R: Geralmente é um problema de PATH. Execute npm prefix -g para verificar o caminho de instalação global e adicione o diretório bin ao PATH.

P: Alice instala no macOS, Bob no Windows. Quem tem mais facilidade?

R: Alice. O macOS tem suporte nativo com um único comando. Bob precisa instalar o WSL primeiro. Recomendamos que Bob use WSL.

P: Quais são as limitações da instalação via Docker?

R: O Docker roda em contêiner, sem acesso aos arquivos do host por padrão. Monte o diretório do projeto com -v: docker run -it --rm -v $(pwd):/workspace ghcr.io/anomalyco/opencode

📖 Resumo

• Instalação com um clique curl -fsSL https://opencode.ai/install | bash é a forma mais rápida
• Usuários Windows devem usar WSL
• Instalação via Node.js é ideal para desenvolvedores frontend
• Problemas de permissão se resolvem com chown e chmod
• Verifique com opencode --version após instalar

📝 Exercícios

1. Básico: Instale o OpenCode no seu sistema operacional e verifique a versão.

2. Intermediário: Tente dois métodos diferentes de instalação e compare prós e contras.

3. Avançado: Execute o OpenCode no Docker montando um diretório de projeto local.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós