文档
Documentação em Português
Introdução

Introdução

OpenCode é um agente de programação com IA de código aberto disponível como interface de terminal, aplicativo de desktop ou extensão de IDE. Ele permite que desenvolvedores interajam com IA para tarefas relacionadas a código.

Pré-requisitos

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

  1. Emulador de Terminal Moderno - As opções incluem:

    • WezTerm (multiplataforma)
    • Alacritty (multiplataforma)
    • Ghostty (Linux e macOS)
    • Kitty (Linux e macOS)

  2. Chaves API - Credenciais para seus provedores de LLM escolhidos

Instalação

Instalação Universal

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

Gerenciadores de Pacotes Node.js

# npm
npm install -g opencode-ai
 
# Bun
bun install -g opencode-ai
 
# pnpm
pnpm install -g opencode-ai
 
# Yarn
yarn global add opencode-ai

Gerenciadores de Pacotes do Sistema

# Homebrew (macOS/Linux)
brew install anomalyco/tap/opencode
 
# Paru (Arch Linux)
paru -S opencode-bin
 
# Chocolatey (Windows)
choco install opencode
 
# Scoop (Windows)
scoop bucket add extras && scoop install extras/opencode
 
# Docker
docker run -it --rm ghcr.io/anomalyco/opencode

Configuração

  1. Execute o comando /connect dentro da interface do terminal
  2. Selecione seu provedor preferido
  3. Autentique-se em opencode.ai/auth
  4. Configure as informações de faturamento
  5. Recupere e insira sua chave API

Recomendamos o OpenCode Zen como uma coleção curada e testada de modelos para iniciantes.

Inicialização do Projeto

Navegue até o diretório do seu projeto e inicie:

cd /path/to/project
opencode

Inicialize o projeto com:

/init

Isso gera um arquivo AGENTS.md na raiz do seu projeto, que deve ser commitado no controle de versão.

Padrões de Uso Básicos

Perguntas sobre o Código

Use @ para pesquisar arquivos do projeto:

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

Desenvolvimento de Funcionalidades

  1. Modo Plan (tecla Tab) - IA sugere abordagens de implementação sem fazer alterações
  2. Iteração - Refine planos com feedback e referências visuais
  3. Modo Build (tecla Tab) - Execute as alterações aprovadas

Reverter Alterações

  • Comando desfazer: /undo
  • Comando refazer: /redo
  • Múltiplos desfazer são suportados

Colaboração

Compartilhe conversas via:

/share

Isso gera um link compartilhável copiado para a área de transferência.

Personalização

Personalize sua experiência:

  • Seleção de tema
  • Atalhos de teclado
  • Formatadores de código
  • Comandos personalizados
  • Configurações
Configuração