Zum Hauptinhalt springen

OpenCode installieren und verwenden

OpenCode ist ein agentischer 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 Lernende mit viel Programmiererfahrung. OpenCode kann eigenständiger arbeiten als Aider und daher schneller viele Änderungen durchführen.

Weitere 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 angepasst werden
  • Änderungen vor der Verwendung überprüfen kann
  • komplexere Programmieraufgaben ausarbeiten möchte

Für klassisches Lernen des Programmierens mit Anfängern ist Aider in der Regel besser geeignet.

Installieren​

Die einfachste Installation gemäß der 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

Verbinden mit Coderen​

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

Gebrauch darin den Coderen-Endpunkt und die erlaubten Modelle:

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

Lege danach den API-Schlüssel als Umgebungsvariable fest.

Dazu kannst du auch eine .env-Datei im Projektordner verwenden:

AI_SCHOOL_CODEREN_API_KEY=ais.dein-api-schluessel

Prüfe nach dem Öffnen eines neuen Terminals, ob OpenCode diese Variable lesen kann. Wenn OpenCode keinen Schlüssel mitliefert, gibt AI-School die Fehlermeldung aus, dass ein Authorization-Header mit Bearer-Token Pflicht ist.

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 anschließend 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 Coderen-Modell auszuwählen, falls dies nicht automatisch geschieht.

Probleme lösen​

Authorization header mit Bearer token ist Pflicht​

Diese Meldung bedeutet in der Regel, dass OpenCode keinen API-Schlüssel mitsendet. Prüfe:

  • ob AI_SCHOOL_CODEREN_API_KEY exakt so heißt
  • ob der Wert mit ais. beginnt
  • ob du nach setx ein neues Terminal geöffnet hast
  • ob die .env-Datei im Projektordner liegt, von wo aus du OpenCode startest

Unknown parameter​

Einige Tools senden zusätzliche, provider-spezifische Parameter mit. Falls du eine Meldung wie Unknown parameter erhältst, entferne diese Einstellung aus der OpenCode-Konfiguration oder verwende eine einfachere Provider-Konfiguration. Der Coderen-Endpunkt erwartet OpenAI-kompatible Chat-Anfragen mit Modell, Nachrichten und den üblichen Basiseinstellungen.

Sichere Nutzung von OpenCode​

Da OpenCode agentisch arbeitet, ist es wichtig, Änderungen zu überprüfen.

Empfohlene Vorgehensweise:

  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 Lernende mit wenig Erfahrung ist es sinnvoll, OpenCode zunächst demonstrativ unter Anleitung eines Lehrers zu verwenden.

WhatsApp