Zum Hauptinhalt springen

OpenCode installieren und verwenden

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

AI-Public empfiehlt OpenCode für Entwickler, Administratoren und andere fortgeschrittene Benutzer. OpenCode kann eigenständig Dateien anpassen und Aufgaben ausarbeiten. Überprüfe daher immer die vorgeschlagenen Änderungen.

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

Installieren​

Die einfachste Installation laut 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 Codieren​

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

Verwende darin den Codieren-Endpunkt und die erlaubten Modelle:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-public-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Public Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-public-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_PUBLIC_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-public-coderen/gpt-5.6-luna",
  "small_model": "ai-public-coderen/gpt-5.6-luna"
}

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

macOS und Linux​

export AI_PUBLIC_CODEREN_API_KEY="aip.dein-api-schluessel"

Windows​

setx AI_PUBLIC_CODEREN_API_KEY "aip.dein-api-schluessel"

Öffne danach ein neues Terminal.

OpenCode starten​

Gehe in das Projektverzeichnis:

cd pfad/zu/deinem/projekt

Starte OpenCode:

opencode

Verwende in OpenCode die Modellwahl, um das AI-Public Coderen-Modell auszuwählen, falls dies noch nicht automatisch geschieht.

Sicheres Arbeiten mit 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.

Umgebungsvariablen und OpenCode​

Für OpenCode kannst du den Coderen-API-Schlüssel in einer lokalen .env-Datei im Projektordner speichern:

AI_PUBLIC_CODEREN_API_KEY=aip.dein-api-schluessel

Stelle sicher, dass OpenCode diese Umgebungsvariable auch wirklich lädt. In PowerShell kannst du die Variable auch vorübergehend für die aktuelle Sitzung setzen:

$env:AI_PUBLIC_CODEREN_API_KEY="aip.dein-api-schluessel"

Siehst du Authorization header with Bearer token is required, sendet das Tool den Schlüssel nicht mit als Authorization: Bearer .... Siehst du Unknown parameter, entferne dann provider-spezifische Einstellungen, die der Coderen-Endpunkt von AI-Public nicht unterstützt.

WhatsApp