Zum Hauptinhalt springen

OpenCode installieren und verwenden

OpenCode ist ein agentic Coding-Tool. Das Tool ist als Terminalanwendung, Desktopanwendung und IDE-Erweiterung verfügbar.

AI-School empfiehlt OpenCode vor allem für Lehrkräfte, Administratoren und Schüler mit viel Programmiererfahrung. OpenCode kann selbstständiger arbeiten als Aider und dadurch schneller viele Änderungen ausführen.

Mehr Informationen findest du auf der OpenCode-Website und in der offiziellen OpenCode-Dokumentation.

Wann wählst du OpenCode?​

Wähle OpenCode, wenn der Benutzer:

  • Erfahrung mit Terminal, Code-Editoren und Git hat
  • versteht, wie lokale Dateien geändert werden
  • Änderungen prüfen kann, bevor sie verwendet werden
  • komplexere Programmieraufgaben ausarbeiten möchte

Für das Programmierenlernen mit Anfängern im Unterricht ist Aider meistens besser geeignet.

Installieren​

Die einfachste Installation laut OpenCode-Dokumentation ist:

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

Du kannst OpenCode auch mit Node.js installieren:

npm install -g opencode-ai

Oder mit Homebrew auf macOS und Linux:

brew install anomalyco/tap/opencode

Mit Coding verbinden​

OpenCode unterstützt angepasste OpenAI-kompatible Provider. Erstelle im Projektordner eine Datei opencode.json.

Verwende darin den Coding-Endpoint und die erlaubten Modelle:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-school-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-School Coding",
      "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"
}

Setze den API-Schlüssel danach als Umgebungsvariable.

macOS und Linux​

export AI_SCHOOL_CODEREN_API_KEY="ais.dein-api-schluessel"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.dein-api-schluessel"

Öffne danach ein neues Terminal.

OpenCode starten​

Gehe in den Projektordner:

cd pfad/zu/deinem/projekt

Starte OpenCode:

opencode

Verwende in OpenCode die Modellauswahl, um das AI-School Coding-Modell auszuwählen, falls das nicht automatisch geschieht.

Sicher mit OpenCode arbeiten​

Weil OpenCode agentic arbeitet, ist es wichtig, Änderungen zu prüfen.

Empfohlene Arbeitsweise:

  1. Arbeite in einem Git-Repository.
  2. Beginne mit kleinen Aufgaben.
  3. Prüfe Diffs, bevor du Code verwendest.
  4. Teste die Anwendung nach Änderungen.
  5. Committe nur Änderungen, die du verstehst.

Für Schüler mit wenig Erfahrung ist es sinnvoll, OpenCode zuerst demonstrativ unter Begleitung einer Lehrkraft zu verwenden.

Umgebungsvariablen und OpenCode​

F?r OpenCode k?nnen Sie den Coding-API-Schl?ssel in einer lokalen .env-Datei im Projektordner speichern:

AI_SCHOOL_CODEREN_API_KEY=ais.ihr-api-schluessel

Stellen Sie sicher, dass OpenCode diese Umgebungsvariable tats?chlich l?dt. In PowerShell k?nnen Sie sie auch tempor?r f?r das aktuelle Terminal setzen:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.ihr-api-schluessel"

Wenn Authorization header met Bearer token is verplicht angezeigt wird, sendet das Tool den Schl?ssel nicht als Authorization: Bearer .... Wenn Unknown parameter angezeigt wird, entfernen Sie anbieterspezifische Einstellungen, die der Coding-Endpunkt von AI-School nicht unterst?tzt.