Instalar y usar OpenCode

OpenCode es una herramienta de codificación con capacidad de 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 alumnos con mucha experiencia en programación. OpenCode puede operar de forma más autónoma que Aider y, por tanto, realizar cambios rápidamente.

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

¿Cuándo elegir OpenCode?

Elige OpenCode si el usuario:

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

Para aprendizaje clásico de programación 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 admite proveedores compatibles con OpenAI personalizados. Crea un archivo opencode.json en la carpeta del proyecto.

Utiliza en él el endpoint de 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.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.4-mini",
  "small_model": "ai-school-coderen/gpt-5.4-mini"
}

Luego pon la clave 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-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-api"

Windows

setx AI_SCHOOL_CODEREN_API_KEY "ais.tu-clave-api"

Abre luego una nueva terminal.

Iniciar OpenCode

Ve a la carpeta del proyecto:

cd ruta/a/tu/proyecto

Inicia OpenCode:

opencode

En OpenCode selecciona el modelo para elegir el modelo de Coderen de AI-School si aún no ocurre automáticamente.

Solución de problemas

Se requiere el encabezado Authorization con token Bearer

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

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

Parámetro desconocido

Algunas herramientas envían parámetros adicionales específicos del proveedor. Si recibes 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 Coderen espera solicitudes de chat compatibles con OpenAI con modelo, mensajes y la configuración base habitual.

Trabajar con OpenCode de forma segura

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

Prácticas recomendadas:

1. Trabaja en un repositorio git.
2. Comienza con tareas pequeñas.
3. Revisa las difs antes de usar el código. 4.Prueba la aplicación tras los cambios.
4. Confirma solo los cambios que entiendas.

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