Introdução

Comece com OpenCode.

OpenCode é um agente de programação com IA de código aberto. Está disponível como interface de terminal, aplicativo de desktop ou extensão de IDE.

Vamos começar.

Pré-requisitos

Para usar o OpenCode no seu terminal, você precisará de:

• Um emulador de terminal moderno como:
  • WezTerm (opens in a new tab), multiplataforma
  • Alacritty (opens in a new tab), multiplataforma
  • Ghostty (opens in a new tab), Linux e macOS
  • Kitty (opens in a new tab), Linux e macOS
• Chaves API para os provedores de LLM que você deseja usar.

Instalação

A maneira mais fácil de instalar o OpenCode é através do script de instalação.

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

Você também pode instalá-lo com os seguintes comandos:

• Usando Node.js

npm install -g opencode-ai

• Usando Homebrew no macOS e Linux

brew install anomalyco/tap/opencode

Recomendamos usar o tap do OpenCode para as versões mais atualizadas. A fórmula oficial brew install opencode é mantida pela equipe do Homebrew e é atualizada com menos frequência.

• Usando Paru no Arch Linux

paru -S opencode-bin

Windows

• Usando Chocolatey

choco install opencode

• Usando Scoop

scoop install opencode

• Usando NPM

npm install -g opencode-ai

• Usando Mise

mise use -g github:anomalyco/opencode

• Usando Docker

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

O suporte para instalar o OpenCode no Windows usando Bun está atualmente em andamento.

Você também pode baixar o binário das Releases (opens in a new tab).

Configuração

Com o OpenCode você pode usar qualquer provedor de LLM configurando suas chaves API.

Se você é novo no uso de provedores de LLM, recomendamos usar o OpenCode Zen. É uma lista curada de modelos que foram testados e verificados pela equipe do OpenCode.

1. Execute o comando /connect na TUI, selecione opencode e acesse opencode.ai/auth (opens in a new tab).

/connect

2. Faça login, adicione seus dados de faturamento e copie sua chave API.

3. Cole sua chave API.

┌ API key
│
│
└ enter

Alternativamente, você pode selecionar um dos outros provedores. Saiba mais.

Inicialização

Agora que você configurou um provedor, pode navegar até um projeto no qual deseja trabalhar.

cd /path/to/project

E execute o OpenCode.

opencode

Em seguida, inicialize o OpenCode para o projeto executando o seguinte comando.

/init

Isso fará com que o OpenCode analise seu projeto e crie um arquivo AGENTS.md na raiz do projeto.

Isso ajuda o OpenCode a entender a estrutura do projeto e os padrões de codificação utilizados.

Uso

Agora você está pronto para usar o OpenCode para trabalhar no seu projeto. Sinta-se à vontade para perguntar qualquer coisa!

Se você é novo no uso de um agente de programação com IA, aqui estão alguns exemplos que podem ajudar.

Fazer perguntas

Você pode pedir ao OpenCode para explicar o código para você.

How is authentication handled in @packages/functions/src/api/index.ts

Isso é útil se houver uma parte do código que você não trabalhou.

Adicionar funcionalidades

Você pode pedir ao OpenCode para adicionar novas funcionalidades ao seu projeto. Porém, primeiro recomendamos pedir para ele criar um plano.

1. Criar um plano

   O OpenCode tem um Modo Plan que desabilita sua capacidade de fazer alterações e, em vez disso, sugere como ele implementará a funcionalidade.

   Mude para ele usando a tecla Tab. Você verá um indicador disso no canto inferior direito.

   <TAB>

   Agora vamos descrever o que queremos que ele faça.

   When a user deletes a note, we'd like to flag it as deleted in the database.
   Then create a screen that shows all the recently deleted notes.
   From this screen, the user can undelete a note or permanently delete it.

   Você quer dar ao OpenCode detalhes suficientes para entender o que você quer. Ajuda falar com ele como se estivesse falando com um desenvolvedor júnior da sua equipe.

   Dica

   Dê ao OpenCode bastante contexto e exemplos para ajudá-lo a entender o que você quer.

2. Iterar no plano

   Uma vez que ele te der um plano, você pode dar feedback ou adicionar mais detalhes.

   We'd like to design this new screen using a design I've used before.
   [Image #1] Take a look at this image and use it as a reference.
   Dica

   Arraste e solte imagens no terminal para adicioná-las ao prompt.

   O OpenCode pode escanear qualquer imagem que você fornecer e adicioná-las ao prompt. Você pode fazer isso arrastando e soltando uma imagem no terminal.

3. Construir a funcionalidade

   Quando você se sentir confortável com o plano, volte para o Modo Build pressionando a tecla Tab novamente.

   <TAB>

   E pedindo para ele fazer as alterações.

   Sounds good! Go ahead and make the changes.

Fazer alterações

Para alterações mais diretas, você pode pedir ao OpenCode para construir diretamente sem ter que revisar o plano primeiro.

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

Você quer ter certeza de fornecer uma boa quantidade de detalhes para que o OpenCode faça as alterações corretas.

Desfazer alterações

Digamos que você peça ao OpenCode para fazer algumas alterações.

Can you refactor the function in @packages/functions/src/api/index.ts?

Mas você percebe que não é o que você queria. Você pode desfazer as alterações usando o comando /undo.

/undo

O OpenCode agora reverterá as alterações que você fez e mostrará sua mensagem original novamente.

Can you refactor the function in @packages/functions/src/api/index.ts?

A partir daqui você pode ajustar o prompt e pedir ao OpenCode para tentar novamente.

Ou você pode refazer as alterações usando o comando /redo.

/redo

Compartilhar

As conversas que você tem com o OpenCode podem ser compartilhadas com sua equipe.

/share

Isso criará um link para a conversa atual e o copiará para sua área de transferência.

Aqui está uma conversa de exemplo (opens in a new tab) com o OpenCode.

Personalização

E é isso! Agora você é um profissional no uso do OpenCode.

Para torná-lo seu, recomendamos escolher um tema, personalizar os atalhos de teclado, configurar formatadores de código, criar comandos personalizados ou brincar com a configuração do OpenCode.