Pular para o conteúdo
Docs de V1
Instalação

Introdução

opencode é um agente de codificação de IA de código aberto. Está disponível como uma interface baseada em terminal, aplicativo desktop ou extensão de IDE.

opencode TUI com o tema opencode

Vamos começar.

Pré-requisitos

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

  1. Um emulador de terminal moderno como:

  2. Chaves de API para os provedores de LLM que você deseja usar.

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

Terminal
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

    Terminal
    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

    Terminal
    sudo pacman -S opencode           # Arch Linux (Stable)
paru -S opencode-bin              # Arch Linux (Latest from AUR)

Windows

  • Usando Chocolatey

    Terminal
    choco install opencode

  • Usando Scoop

    Terminal
    scoop install opencode

  • Usando NPM

    Terminal
    npm install -g opencode-ai

  • Usando Mise

    Terminal
    mise use -g github:anomalyco/opencode

  • Usando Docker

    Terminal
    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 na seção Releases.

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

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

  1. Execute o comando /connect no TUI, selecione opencode e acesse opencode.ai/auth.

    /connect

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

  3. Cole sua chave de API.

    ┌ API key
│
│
└ enter

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

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

Terminal
cd /path/to/project

E execute o opencode.

Terminal
opencode

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

Terminal
/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.

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

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

Você pode pedir ao opencode para explicar a base de código para você.

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

Isso é útil se houver uma parte da base de código na qual você não trabalhou.

Você pode pedir ao opencode para adicionar novos recursos ao seu projeto. Embora primeiro recomendemos pedir para ele criar um plano.

  1. Criar um plano

    O opencode tem um Modo de Plano que desabilita sua capacidade de fazer alterações e, em vez disso, sugere como implementará o recurso.

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

    Mudar para o Modo de Plano
    <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ê deseja. Ajuda conversar com ele como se você estivesse falando com um desenvolvedor júnior da sua equipe.

  2. Iterar sobre o plano

    Uma vez que ele lhe 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.

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

  3. Construir o recurso

    Uma vez que você se sinta confortável com o plano, volte para o Modo de Construção pressionando a tecla Tab novamente.

    Terminal
    <TAB>

    E peça para ele fazer as alterações.

    Terminal
    Sounds good! Go ahead and make the changes.

Para alterações mais simples, você pode pedir ao opencode para construí-las diretamente sem precisar 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.

Vamos supor 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 era isso que você queria. Você pode desfazer as alterações usando o comando /undo.

Terminal
/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.

Terminal
/redo

E é isso! Agora você é um profissional em usar o 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.