OpenCode installeren en gebruiken

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

AI-Corporate adviseert OpenCode voor ontwikkelaars, beheerders en andere gevorderde gebruikers. OpenCode kan zelfstandig bestanden aanpassen en taken uitwerken. Controleer daarom altijd de voorgestelde wijzigingen.

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

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-corporate-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Corporate Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_CORPORATE_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-corporate-coderen/gpt-5.4-mini",
  "small_model": "ai-corporate-coderen/gpt-5.4-mini"
}

Zet de API-sleutel daarna als omgevingsvariabele.

macOS en Linux

export AI_CORPORATE_CODEREN_API_KEY="aic.jouw-api-sleutel"

Windows

setx AI_CORPORATE_CODEREN_API_KEY "aic.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-Corporate Coderen model te selecteren als dat nog niet automatisch gebeurt.

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.

Omgevingsvariabelen en OpenCode

Voor OpenCode kun je de Coderen API-sleutel opslaan in een lokaal .env bestand in de projectmap:

AI_SCHOOL_CODEREN_API_KEY=ais.jouw-api-sleutel

Zorg dat OpenCode deze omgevingsvariabele ook echt laadt. In PowerShell kun je de variabele ook tijdelijk voor de huidige terminal zetten:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.jouw-api-sleutel"

Zie je Authorization header met Bearer token is verplicht, dan stuurt de tool de sleutel niet mee als Authorization: Bearer .... Zie je Unknown parameter, verwijder dan provider-specifieke instellingen die de Coderen endpoint van AI-Corporate niet ondersteunt.