Saltar para o conteúdo principal

​
Visão Geral

O OpenCode é um assistente de codificação de IA de código aberto que roda no seu terminal. Ele suporta múltiplos provedores de LLM e pode ser configurado para usar a API da LemonData para acessar mais de 300 modelos.

​
Instalação

curl -fsSL https://opencode.ai/install | bash
Verifique a instalação: 
opencode --version

​
Configuração

​
Passo 1: Definir Variáveis de Ambiente

export OPENAI_API_KEY="sk-your-lemondata-key"
export LOCAL_ENDPOINT="https://api.lemondata.cc/v1"
Para configuração permanente, adicione ao ~/.bashrc ou ~/.zshrc: 
echo 'export OPENAI_API_KEY="sk-your-lemondata-key"' >> ~/.zshrc
echo 'export LOCAL_ENDPOINT="https://api.lemondata.cc/v1"' >> ~/.zshrc
source ~/.zshrc

​
Passo 2: Configurar o OpenCode

Crie ou edite ~/.config/opencode/opencode.json (global) ou opencode.json na raiz do seu projeto: 
{
  "provider": {
    "openai": {
      "options": {
        "apiKey": "sk-your-lemondata-key",
        "baseURL": "https://api.lemondata.cc/v1"
      }
    }
  },
  "model": "gpt-4o",
  "agent": {
    "coder": {
      "model": "gpt-4o"
    }
  }
}

​
Uso Básico

Iniciar modo interativo: 
opencode
Executar com um prompt: 
opencode "Explain this codebase"
Especificar modelo: 
opencode --model gpt-4o "Fix the bugs in main.py"

​
Modelos Disponíveis

ModeloIdeal Para
gpt-4oTarefas complexas, arquitetura de código
gpt-4o-miniCorreções rápidas, consultas simples
claude-sonnet-4-5Revisão de código, documentação
claude-opus-4-5Raciocínio complexo
gemini-2.5-flashRespostas rápidas
deepseek-r1Design de algoritmos

​
Comandos Comuns

Analisar código: 
opencode "What does this function do?" < src/utils.ts
Gerar código: 
opencode "Create a REST API with Express"
Revisar alterações: 
git diff | opencode "Review these changes"
Corrigir erros: 
opencode "Fix the TypeScript errors in this project"

​
Comandos Interativos

ComandoDescrição
/helpMostrar comandos disponíveis
/model <name>Alternar para um modelo diferente
/clearLimpar histórico da conversa
/exitSair do OpenCode

​
Solução de Problemas

  • Verifique se LOCAL_ENDPOINT está definido como https://api.lemondata.cc/v1
  • Verifique a conectividade de rede
  • Tente curl https://api.lemondata.cc/v1/models para testar
  • Verifique se a variável de ambiente OPENAI_API_KEY está definida
  • Verifique se a chave começa com sk-
  • Certifique-se de que a chave está ativa no painel da LemonData
  • Verifique se o nome do modelo na configuração corresponde exatamente
  • Verifique a disponibilidade do modelo em lemondata.cc/en/models

​
Melhores Práticas

Execute o OpenCode a partir da raiz do seu projeto para uma melhor compreensão da sua base de código.
Use modelos mais rápidos (gpt-4o-mini) para tarefas simples e modelos potentes (gpt-4o, claude) para tarefas complexas.
Sempre revise o código gerado por IA antes de aplicar as alterações ao seu projeto.