README.Br

</picture>

Instalação

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

# Gerenciadores de pacotes
npm i -g opencode-ai@latest        # ou bun/pnpm/yarn
scoop install opencode             # Windows
choco install opencode             # Windows
brew install anomalyco/tap/opencode # macOS e Linux (recomendado, sempre atualizado)
brew install opencode              # macOS e Linux (fórmula oficial do brew, atualiza menos)
sudo pacman -S opencode            # Arch Linux (Stable)
paru -S opencode-bin               # Arch Linux (Latest from AUR)
mise use -g opencode               # qualquer sistema
nix run nixpkgs#opencode           # ou github:anomalyco/opencode para a branch dev mais recente

[!TIP] Remova versões anteriores a 0.1.x antes de instalar.

App desktop (BETA)

O OpenCode também está disponível como aplicativo desktop. Baixe diretamente pela página de releases ou em opencode.ai/download.

# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktop

Diretório de instalação

O script de instalação respeita a seguinte ordem de prioridade para o caminho de instalação:

1. $OPENCODE_INSTALL_DIR - Diretório de instalação personalizado
2. $XDG_BIN_DIR - Caminho compatível com a especificação XDG Base Directory
3. $HOME/bin - Diretório binário padrão do usuário (se existir ou puder ser criado)
4. $HOME/.opencode/bin - Fallback padrão

# Exemplos
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash

Agents

O OpenCode inclui dois agents integrados, que você pode alternar com a tecla Tab.

• build - Padrão, agent com acesso total para trabalho de desenvolvimento
• plan - Agent somente leitura para análise e exploração de código
  • Nega edições de arquivos por padrão
  • Pede permissão antes de executar comandos bash
  • Ideal para explorar codebases desconhecidas ou planejar mudanças

Também há um subagent general para buscas complexas e tarefas em várias etapas. Ele é usado internamente e pode ser invocado com @general nas mensagens.

Saiba mais sobre agents.

Documentação

Para mais informações sobre como configurar o OpenCode, veja nossa documentação.

Contribuir

Se você tem interesse em contribuir com o OpenCode, leia os contributing docs antes de enviar um pull request.

Construindo com OpenCode

Se você estiver trabalhando em um projeto relacionado ao OpenCode e estiver usando "opencode" como parte do nome (por exemplo, "opencode-dashboard" ou "opencode-mobile"), adicione uma nota no README para deixar claro que não foi construído pela equipe do OpenCode e não é afiliado a nós de nenhuma forma.

FAQ

Como isso é diferente do Claude Code?

É muito parecido com o Claude Code em termos de capacidade. Aqui estão as principais diferenças:

• 100% open source
• Não está acoplado a nenhum provedor. Embora recomendemos os modelos que oferecemos pelo OpenCode Zen; o OpenCode pode ser usado com Claude, OpenAI, Google ou até modelos locais. À medida que os modelos evoluem, as diferenças diminuem e os preços caem, então ser provider-agnostic é importante.
• Suporte a LSP pronto para uso
• Foco em TUI. O OpenCode é construído por usuários de neovim e pelos criadores do terminal.shop; vamos levar ao limite o que é possível no terminal.
• Arquitetura cliente/servidor. Isso, por exemplo, permite executar o OpenCode no seu computador enquanto você o controla remotamente por um aplicativo mobile. Isso significa que o frontend TUI é apenas um dos possíveis clientes.

Junte-se à nossa comunidade Discord | X.com