OpenCode Installation und OmniProxy-Konfiguration

OpenCode ist ein Open-Source-Programmierassistent, mit dem Sie Code von einem Terminal, einer IDE oder dem Desktop aus schreiben können. Er speichert weder Ihren Code noch Ihren Kontext und ist daher für datenschutzsensible Projekte geeignet. build wird verwendet, um ein Projekt zu ändern, während plan standardmäßig schreibgeschützt ist und nützlich ist, um unbekannten Code zu verstehen und Änderungen zu planen, bevor sie vorgenommen werden. Sie können einen Modelldienst basierend auf Ihren Anforderungen auswählen.

Vorbereitung

Das Installationsskript ist die einfachste Option. Sie benötigen ein modernes Terminal – eine Terminalanwendung, die Befehle ausführen und mit Projektdateien arbeiten kann – wie WezTerm, Alacritty, Ghostty oder Kitty. Unter Windows wird WSL bevorzugt. Es bietet eine Linux-Umgebung innerhalb von Windows mit vollständigerer Leistung und Funktionalität.

Am einfachsten

Installationsskript

• curl opencode.ai/install
• Direkt unter macOS Linux verwenden
• WSL wird unter Windows empfohlen

macOS Linux

Homebrew Tap

• anomalyco/tap/opencode
• Wird häufiger aktualisiert als die Formel
• Ein Paket ist auch für Arch verfügbar

Natives Windows

Paketmanager

• choco oder scoop
• Oder global mit npm installieren
• Sie können es auch von Releases herunterladen

Bereiten Sie auch die Modell-ID aus der aktuellen Modellliste vor. Eine Modell-ID ist der Name, den der Dienst verwendet, um ein bestimmtes Modell genau zu identifizieren.

Installation und erster Start

Der einfachste Installationsbefehl lautet:

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

Sie können auch eine dieser Installationsmethoden verwenden:

• Node.js: npm install -g opencode-ai. Bun, pnpm und Yarn haben ebenfalls entsprechende globale Installationsbefehle; siehe die Einführungsseite am Ende dieses Leitfadens.
• Homebrew unter macOS und Linux: brew install anomalyco/tap/opencode. Verwenden Sie diesen Tap, da er häufiger aktualisiert wird als brew install opencode, der vom Homebrew-Team gepflegt wird.
• Arch Linux: verwenden Sie sudo pacman -S opencode für die stabile Version oder das AUR-Paket opencode-bin für eine neuere Version.
• Windows: verwenden Sie choco install opencode oder scoop install opencode. Sie können auch npm install -g opencode-aiverwenden. Binärdateien können auch von Releases heruntergeladen werden. Die Unterstützung für die Installation mit Bun unter Windows ist noch in Arbeit.

Gehen Sie in Ihr Projektverzeichnis und starten Sie OpenCode:

cd /path/to/project
opencode

Bei der ersten Verwendung können Sie /initausführen. Es analysiert das Projekt und erstellt AGENTS.md im Projektstammverzeichnis. Diese Datei kann in Git committet werden, damit das Projekt diese Anweisungen beibehält.

Verbindungswerte von OmniProxy abrufen

baseURL: https://your-omniproxy-origin.example/v1
API Key: <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

baseURL ist die Dienstadresse, API Key ist das Zugriffskennwort und Model ID ist der vollständige Name des Modells.

Wenn Sie /v1/chat/completionsverwenden, setzen Sie das npm-Paket auf @ai-sdk/openai-compatible. Chat Completions ist eine Art von Chat-Anfrageschnittstelle. Wechseln Sie nur zu @ai-sdk/openai wenn das Modell /v1/responsesverwendet. Wenn OmniProxy über den Chat-Completions-Endpunkt verwendet wird, behalten Sie das Kompatibilitätspaket bei.

Kopieren Sie die gesamte Modell-ID aus der aktuellen Liste von OmniProxy, einschließlich aller Schrägstriche. Am 09.10.2026 waren zwei Referenz-IDs claude-sonnet-5-5 und gpt-6-luna. gpt-6-luna unterstützt Chat Completions; Funktionsaufrufe über Chat Completions werden nur unterstützt, wenn reasoning_effort ist none. Kopieren Sie keine ID, die nicht in der Liste enthalten ist.

Tool-Konfiguration eingeben

Ein Provider kann als eine Reihe von Konfigurationswerten verstanden werden, die OpenCode verwendet, um eine Verbindung zu einem Modelldienst herzustellen. Die Provider-Dokumentation behandelt einen OpenAI-kompatiblen Dienst, der nicht unter /connect aufgeführt ist, als benutzerdefinierten Provider. Ein OpenAI-kompatibler Dienst verwendet dasselbe Anfrageformat und kann vom gleichen Client-Typ aufgerufen werden.

1. Führen Sie /connect in OpenCode aus und scrollen Sie zu Other.
2. Geben Sie eine Provider-ID ein. Das Beispiel unten verwendet omniproxy. Wählen Sie eine ID, die leicht zu merken ist, da Sie dieselbe in der Konfigurationsdatei verwenden müssen.
3. Geben Sie den OmniProxy API-Schlüssel ein. Dieser Schritt speichert nur das Kennwort; die Adresse und die Modelle müssen noch zu opencode.jsonhinzugefügt werden. Das Kennwort wird in ~/.local/share/opencode/auth.jsongespeichert.
4. Erstellen oder ändern Sie opencode.json im Projektverzeichnis:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniproxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniProxy",
      "options": {
        "baseURL": "https://your-omniproxy-origin.example/v1"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "gpt-6-luna": { "name": "GPT-6 Luna" }
      }
    }
  }
}

5. Führen Sie /modelsaus. Der benutzerdefinierte Provider und seine Modelle erscheinen in der Liste.

Die unter /connect eingegebene ID muss mit dem Schlüssel in opencode.jsonübereinstimmen. Geben Sie keinen echten geheimen Schlüssel in diese Datei ein. Wenn Sie /connectnicht verwenden, können Sie die Umgebungsvariablen-Syntax in options.apiKeyverwenden, wie z. B. {env:VARIABLE_NAME}. Bei Tests am 09.10.2026 mit OpenCode 1.18.34 funktionierte auch das direkte Einfügen des Schlüssels in das options.apiKey des Projekts ohne Verwendung von /connect . Wenn das Gateway den Schlüssel nicht validiert, kann dieser Wert eine Platzhalter-Zeichenfolge sein, die nur auf dem lokalen Computer verwendet wird. Die Schlüssel unter models müssen die vollständigen IDs aus der Liste verwenden.

Schlüssel

/connect

• Wählen Sie unten Other
• Wählen Sie Ihre eigene Provider-ID
• Gespeichert in auth.json

Projekt

opencode.json

• Der Provider-Schlüssel muss denselben Namen verwenden
• Verwenden Sie ein kompatibles npm-Paket
• baseURL endet mit /v1

Auswählen

/models

• Das Modell erscheint in der Liste
• Wählen Sie eines aus, bevor Sie eine Frage stellen
• Verwenden Sie die ID aus der Gateway-Liste

Mit einer echten Aufgabe verifizieren

Führen Sie zuerst eine echte Aufgabe aus dem Projektverzeichnis aus. Das Format der Modellreferenz lautet Provider ID/model ID; behalten Sie alle Schrägstriche innerhalb der Modell-ID bei:

opencode run --model omniproxy/claude-sonnet-5-5 --auto "Explain what a file you specify does. Do not modify the file."

--auto ermöglicht diesem Lauf die Verwendung von Tools wie Dateilese-Tools. Bei Tests am 09.10.2026 mit OpenCode 1.18.34 wurde der Inhalt der angegebenen Datei erfolgreich gelesen. Der erste Lauf dauerte etwa zwei Minuten.

Für die interaktive Nutzung führen Sie opencodeaus und wählen Sie dann ein Modell mit /models. Sie können @ verwenden, um nach Dateien zu suchen. Verwenden Sie opencode auth list um das über /connectgespeicherte Kennwort zu bestätigen, und überprüfen Sie dann die Anfrageprotokolle von OmniProxy, um die Quelle und die Modell-ID zu verifizieren.

Starten

opencode startet

• Zuerst cd in das Projekt
• auth list zeigt die ID
• Die Konfigurationsdatei befindet sich im Projekt

Aufgabe

Es hat den Code gelesen

• Fragen Sie nach einer bestimmten Datei
• Überprüfen Sie die Erklärung
• Verwenden Sie /undo, wenn es falsch ist

Protokolle

Sichtbar im Gateway

• Quelle ist OpenCode
• Modell-ID stimmt überein
• Den Schlüssel nicht committen

Häufige Fehler

• OmniProxy erscheint nicht unter /models: Überprüfen Sie, ob die unter /connect eingegebene ID mit dem Schlüssel in opencode.jsonübereinstimmt, dass npm auf @ai-sdk/openai-compatiblegesetzt ist und dass baseURL mit /v1endet.
• Das Kennwort fehlt: Führen Sie opencode auth listaus. Provider wie Bedrock, die auf Umgebungsvariablen angewiesen sind, erscheinen hier nicht; ein benutzerdefinierter Provider, der über /connect konfiguriert wurde, sollte sichtbar sein.
• Windows-Funktionalität ist unvollständig: Verwenden Sie stattdessen das Installationsskript innerhalb von WSL.
• Die Modell-ID ist ungültig: Kopieren Sie sie erneut aus der aktuellen Liste von OmniProxy und aktualisieren Sie den entsprechenden Schlüssel unter models.
• Anfragen gehen an den falschen Endpunkt: Behalten Sie @ai-sdk/openai-compatible für Chat Completions bei. Ändern Sie das Paket für die Responses-Schnittstelle nicht, es sei denn, das Modell auf OmniProxy verwendet tatsächlich /v1/responses.

Offizielle Referenzen

Für die Installation siehe die OpenCode introduction. Für benutzerdefinierte Provider siehe Providers. Für die in den Beispielen verwendeten Modell-IDs siehe Claude model overview und GPT-6 Luna.

Ersetzen Sie jeden Platzhalter mit Werten aus Ihrer eigenen OmniProxy-Konfiguration. Veröffentlichen Sie niemals einen echten Schlüssel.

Ein gespeicherter HTTP 200 allein beweist keine vollständige Agenten-Kompatibilität. Überprüfen Sie die Quelle und das Modell im Aufrufprotokoll von OmniProxy.

Offizielle Quellen · OpenCode ↗