Saltar para o conteúdo principal

Visão geral

Tipo: Ferramenta de códigoCaminho principal: OpenAI-compatibleNível de suporte: Caminho compatível
OpenCode é um assistente de programação com AI de código aberto que roda no seu terminal. Ele oferece suporte a vários provedores de LLM e pode ser configurado para usar a API do LemonData para acessar mais de 300 modelos.

Instalação

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

Configuração

Etapa 1: Definir variáveis de ambiente

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

Etapa 2: Configurar o OpenCode

A documentação atual do OpenCode recomenda configurar provedores por meio de opencode.json ou opencode.jsonc. Para o LemonData, use um provedor personalizado em vez de sobrescrever o provedor openai integrado:
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "lemondata": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LemonData",
      "options": {
        "baseURL": "https://api.lemondata.cc/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        }
      }
    }
  },
  "model": "lemondata/gpt-5.4"
}
Use @ai-sdk/openai-compatible para compatibilidade no estilo chat-completions. Se você precisar especificamente de um caminho de provedor baseado em /v1/responses, a documentação de provedores do OpenCode recomenda trocar o pacote para @ai-sdk/openai.

Uso básico

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

Modelos disponíveis

ModelMelhor para
gpt-5.4Tarefas complexas, arquitetura de código
gpt-5-miniCorreções rápidas, consultas simples
claude-sonnet-4-6Revisão de código, documentação
claude-opus-4-6Raciocí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

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

Solução de problemas

  • Verifique se options.baseURL 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 options.apiKey referencia {env:OPENAI_API_KEY} ou outra fonte de segredo válida
  • Verifique se a chave começa com sk-
  • Certifique-se de que a chave está ativa no dashboard do LemonData
  • Verifique se o nome do modelo na configuração corresponde exatamente
  • Verifique a disponibilidade do modelo em lemondata.cc/en/models

Boas 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-5-mini) para tarefas simples e modelos mais robustos (gpt-5.4, claude-sonnet-4-6) para tarefas complexas.
Sempre revise o código gerado por AI antes de aplicar alterações ao seu projeto.