OpenCode installeren en gebruiken

OpenCode is een agentic coding tool. De tool is beschikbaar als terminalapplicatie, desktopapplicatie en IDE-extensie.

AI-School adviseert OpenCode vooral voor docenten, beheerders en leerlingen met veel programmeerervaring. OpenCode kan zelfstandiger werken dan Aider en kan daardoor sneller veel wijzigingen uitvoeren.

Meer informatie vind je op de OpenCode-website en in de officiële OpenCode-documentatie.

Wanneer kies je OpenCode?

Kies OpenCode als de gebruiker:

• ervaring heeft met terminal, code-editors en git
• begrijpt hoe lokale bestanden worden aangepast
• wijzigingen kan controleren voordat ze worden gebruikt
• complexere programmeertaken wil uitwerken

Voor klassikaal leren programmeren met beginners is Aider meestal geschikter.

Installeren

De eenvoudigste installatie volgens de OpenCode-documentatie is:

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

Je kunt OpenCode ook installeren met Node.js:

npm install -g opencode-ai

Of met Homebrew op macOS en Linux:

brew install anomalyco/tap/opencode

Verbinden met Coderen

OpenCode ondersteunt aangepaste OpenAI-compatible providers. Maak in de projectmap een bestand opencode.json.

Gebruik daarin de Coderen endpoint en de toegestane modellen:

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

Zet de API-sleutel daarna als omgevingsvariabele.

Je kunt hiervoor ook een .env bestand in de projectmap gebruiken:

AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel

Controleer na het openen van een nieuwe terminal of OpenCode deze variabele kan lezen. Als OpenCode geen sleutel meestuurt, geeft AI-School de foutmelding dat een Authorization header met Bearer token verplicht is.

macOS en Linux

export AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"

Windows

setx AI_SCHOOL_CODEREN_API_KEY "ais.jouw-api-sleutel"

Open daarna een nieuwe terminal.

OpenCode starten

Ga naar de projectmap:

cd pad/naar/je/project

Start OpenCode:

opencode

Gebruik in OpenCode de modelkeuze om het AI-School Coderen model te selecteren als dat nog niet automatisch gebeurt.

Problemen oplossen

Authorization header met Bearer token is verplicht

Deze melding betekent meestal dat OpenCode geen API-sleutel meestuurt. Controleer:

• of AI_SCHOOL_CODEREN_API_KEY exact zo heet
• of de waarde begint met ais.
• of je na setx een nieuwe terminal hebt geopend
• of het .env bestand in de projectmap staat waar je OpenCode start

Unknown parameter

Sommige tools sturen extra provider-specifieke parameters mee. Als je een melding krijgt zoals Unknown parameter, verwijder dan die instelling uit de OpenCode-configuratie of gebruik een eenvoudiger providerconfiguratie. De Coderen endpoint verwacht OpenAI-compatible chatverzoeken met model, berichten en de gebruikelijke basisinstellingen.

Veilig werken met OpenCode

Omdat OpenCode agentic werkt, is het belangrijk om wijzigingen te controleren.

Aanbevolen werkwijze:

1. Werk in een git-repository.
2. Begin met kleine opdrachten.
3. Controleer diffs voordat je code gebruikt.
4. Test de applicatie na wijzigingen.
5. Commit alleen wijzigingen die je begrijpt.

Voor leerlingen met weinig ervaring is het verstandig om OpenCode eerst demonstratief te gebruiken onder begeleiding van een docent.