OpenCode

Configura OpenCode para usar la API de LemonData

​

Descripción general

OpenCode es un asistente de programación con AI de código abierto que se ejecuta en tu terminal. Es compatible con múltiples proveedores de LLM y se puede configurar para usar la API de LemonData para acceder a más de 300 modelos.

​

Instalación

Script de instalación

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

Homebrew

brew install opencode-ai/tap/opencode

O usa el tap de la comunidad (actualizaciones más frecuentes):

brew install anomalyco/tap/opencode

Go

go install github.com/opencode-ai/opencode@latest

Verifica la instalación:

opencode --version

​

Configuración

​

Paso 1: Establecer variables de entorno

export OPENAI_API_KEY="sk-your-lemondata-key"

Para una configuración permanente, añade esto a ~/.bashrc o ~/.zshrc:

echo 'export OPENAI_API_KEY="sk-your-lemondata-key"' >> ~/.zshrc
source ~/.zshrc

​

Paso 2: Configurar OpenCode

La documentación actual de OpenCode recomienda configurar proveedores mediante opencode.json o opencode.jsonc. Para LemonData, usa un proveedor personalizado en lugar de sobrecargar el proveedor integrado openai:

{
  "$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"
}

Usa @ai-sdk/openai-compatible para compatibilidad con el estilo de chat-completions. Si específicamente necesitas una ruta de proveedor basada en /v1/responses, la documentación de proveedores de OpenCode recomienda cambiar el paquete a @ai-sdk/openai.

​

Uso básico

Iniciar modo interactivo:

opencode

Ejecutar con un prompt:

opencode "Explain this codebase"

Especificar modelo:

opencode --model lemondata/gpt-5.4 "Fix the bugs in main.py"

​

Modelos disponibles

Model	Mejor para
gpt-5.4	Tareas complejas, arquitectura de código
gpt-5-mini	Correcciones rápidas, consultas simples
claude-sonnet-4-6	Revisión de código, documentación
claude-opus-4-6	Razonamiento complejo
gemini-2.5-flash	Respuestas rápidas
deepseek-r1	Diseño de algoritmos

​

Comandos comunes

Analizar código:

opencode "What does this function do?" < src/utils.ts

Generar código:

opencode "Create a REST API with Express"

Revisar cambios:

git diff | opencode "Review these changes"

Corregir errores:

opencode "Fix the TypeScript errors in this project"

​

Comandos interactivos

Command	Descripción
/help	Mostrar comandos disponibles
/model <name>	Cambiar a un modelo diferente
/clear	Borrar el historial de conversación
/exit	Salir de OpenCode

​

Solución de problemas

Error de conexión

• Verifica que options.baseURL esté establecido en https://api.lemondata.cc/v1
• Comprueba la conectividad de red
• Prueba curl https://api.lemondata.cc/v1/models para verificar

Autenticación fallida

• Verifica que la variable de entorno OPENAI_API_KEY esté establecida
• Verifica que options.apiKey haga referencia a {env:OPENAI_API_KEY} u otra fuente de secreto válida
• Comprueba que la clave comience con sk-
• Asegúrate de que la clave esté activa en el dashboard de LemonData

Modelo no encontrado

• Comprueba que el nombre del modelo en la configuración coincida exactamente
• Verifica la disponibilidad del modelo en lemondata.cc/en/models

​

Buenas prácticas

Usa el contexto del proyecto

Ejecuta OpenCode desde la raíz de tu proyecto para comprender mejor tu codebase.

Elige modelos apropiados

Usa modelos más rápidos (gpt-5-mini) para tareas simples y modelos más potentes (gpt-5.4, claude-sonnet-4-6) para las complejas.

Revisa el código generado

Revisa siempre el código generado por AI antes de aplicar cambios a tu proyecto.