Ir al contenido principal

Instalar y usar OpenCode

OpenCode es una herramienta de codificación impulsada por agente. La herramienta está disponible como aplicación de terminal, aplicación de escritorio y extensión de IDE.

AI-School recomienda OpenCode principalmente para docentes, administradores y estudiantes con mucha experiencia en programación. OpenCode puede funcionar de forma más independiente que Aider y, por tanto, realizar muchos cambios más rápido.

Más información en la sitio web de OpenCode y en la documentación oficial de OpenCode.

¿Cuándo elegir OpenCode?​

Elija OpenCode si el usuario:

  • tiene experiencia con terminal, editores de código y git
  • comprende cómo se modifican los archivos locales
  • puede verificar los cambios antes de usarlos
  • quiere desarrollar tareas de programación más complejas

Para aprender a programar en clase con principiantes, Aider suele ser más adecuado.

Instalación​

La instalación más sencilla según la documentación de OpenCode es:

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

También puedes instalar OpenCode con Node.js:

npm install -g opencode-ai

O con Homebrew en macOS y Linux:

brew install anomalyco/tap/opencode

Conectar con Coderen​

OpenCode soporta proveedores compatibles con OpenAI personalizados. Crea un archivo opencode.json en la carpeta del proyecto.

Utiliza allí el endpoint Coderen y los modelos permitidos:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-school-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-School Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_SCHOOL_CODEREN_API_KEY}"
      },
      "models": {
        "gpt-5.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.6-luna",
  "small_model": "ai-school-coderen/gpt-5.6-luna"
}

Después pon la clave de API como variable de entorno.

También puedes usar un archivo .env en la carpeta del proyecto:

AI_SCHOOL_CODEREN_API_KEY=ais.tu-clave-de-api

Verifica después de abrir una nueva terminal si OpenCode puede leer esta variable. Si OpenCode no envía una clave, AI-School mostrará el error de que es obligatorio un encabezado Authorization con token Bearer.

macOS y Linux​

export AI_SCHOOL_CODEREN_API_KEY="ais.tu-clave-de-api"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.tu-clave-de-api"

Luego abre una nueva terminal.

Iniciar OpenCode​

Ve a la carpeta del proyecto:

cd ruta/a/tu/proyecto

Inicia OpenCode:

opencode

Usa en OpenCode la selección de modelos para elegir el modelo Coderen de AI-School si aún no ocurre automáticamente.

Solución de problemas​

El encabezado Authorization con token Bearer es obligatorio​

Este mensaje suele significar que OpenCode no envía una clave API. Verifica:

  • que AI_SCHOOL_CODEREN_API_KEY se llame exactamente así
  • que el valor empiece con ais.
  • que tras setx hayas abierto una nueva terminal
  • que el archivo .env esté en la carpeta del proyecto desde donde inicias OpenCode

Parámetro desconocido​

Algunas herramientas envían parámetros específicos del proveedor adicionales. Si obtienes un mensaje como Unknown parameter, elimina esa configuración de la configuración de OpenCode o usa una configuración de proveedor más simple. El endpoint de Coderen espera solicitudes de chat compatibles con OpenAI con modelo, mensajes y la configuración básica habitual.

Trabajo seguro con OpenCode​

Como OpenCode funciona de forma agentic, es importante revisar los cambios.

Procedimiento recomendado:

  1. Trabaja en un repositorio git.
  2. Comienza con tareas pequeñas.
  3. Revisa las diffs antes de usar el código.
  4. Prueba la aplicación después de los cambios.
  5. Commita solo los cambios que entiendas.

Para los estudiantes con poca experiencia, es recomendable usar OpenCode primero de forma demostrativa bajo la supervisión de un docente.

WhatsApp