Aiberm logo
Anmelden

OpenCode CLI einrichten

Erfahren Sie, wie Sie die OpenCode CLI für die Aiberm-API konfigurieren. Diese Anleitung behandelt Installation und Konfiguration für Windows, macOS und Linux.

Was ist OpenCode?

OpenCode ist ein in Go geschriebenes Open-Source-Kommandozeilen-Programmierwerkzeug (CLI), das Entwicklern leistungsstarke KI-Unterstützung bietet. Es stellt eine intuitive Terminal User Interface (TUI) bereit und unterstützt mehrere LLM-Anbieter, darunter OpenAI, Anthropic, Gemini und mehr.

Durch die Integration von OpenCode mit der Aiberm API können Sie über eine einheitliche Oberfläche mit einem Schlüssel und einer Base URL auf jedes bei Aiberm verfügbare Modell zugreifen (einschließlich Claude, GPT, Gemini und mehr).

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

Terminal-Emulator

OpenCode benötigt einen modernen Terminal-Emulator. Empfohlene Optionen:

  • WezTerm (plattformübergreifend)
  • Alacritty (plattformübergreifend)
  • Ghostty (Linux und macOS)
  • Kitty (Linux und macOS)

Windows-Benutzer können auch PowerShell oder Windows Terminal nutzen. macOS-Benutzer können die eingebaute Terminal.app oder iTerm2 verwenden. Linux-Benutzer können das eingebaute Terminal oder GNOME Terminal, Konsole usw. nutzen.

Installation

Wählen Sie unten Ihr Betriebssystem für die Installationsanleitung.

macOS & Linux

Am einfachsten ist das Installationsskript:

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

Oder mit Homebrew:

brew install anomalyco/tap/opencode

Installation prüfen:

opencode --version

Windows

Windows-Benutzer sollten zuerst Node.js installieren und anschließend über NPM installieren:

npm i -g opencode-ai@latest

Oder mit Chocolatey:

choco install opencode

Oder mit Scoop:

scoop bucket add extras
scoop install extras/opencode

Installation prüfen:

opencode --version

Wenn Sie eine grafische Oberfläche bevorzugen, bietet OpenCode auch eine Desktop-App auf der OpenCode-Downloadseite.

Konfiguration

Schritt 1: Anbieter initialisieren

Führen Sie nach der Installation den folgenden Befehl in Ihrem Terminal aus, bevor Sie OpenCode starten:

opencode auth login
  1. Wählen Sie in der Anbieterliste other (ganz unten, Sie können danach suchen)
  2. Geben Sie die Provider ID ein: tippen Sie aiberm
  3. Geben Sie das API Key token ein: Sie können einen beliebigen Wert eingeben (z. B. admin); der eigentliche Schlüssel wird über die Konfigurationsdatei referenziert

Dieser Schritt registriert einen benutzerdefinierten Anbieter im lokalen Anmeldedaten-Manager von OpenCode.

Schritt 2: Konfigurationsdatei bearbeiten

Öffnen Sie das OpenCode-Konfigurationsverzeichnis:

Windows:

Drücken Sie Win + R, fügen Sie Folgendes ein und drücken Sie Enter:

%userprofile%\.config\opencode

macOS / Linux:

Führen Sie im Terminal aus:

cd ~/.config/opencode

Oder öffnen Sie ~/.config/opencode/ im Finder/Dateimanager.

Erstellen oder bearbeiten Sie in diesem Verzeichnis opencode.json. Unten finden Sie eine Beispielkonfiguration mit Claude-Modellen:

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "aiberm": {
            "npm": "@ai-sdk/anthropic",
            "name": "Aiberm",
            "options": {
                "baseURL": "https://aiberm.com/v1",
                "apiKey": "sk-your-aiberm-api-key"
            },
            "models": {
                "claude-opus-4-5-20251101": {
                    "name": "Claude-4.5-Opus"
                },
                "claude-sonnet-4-5-20250929": {
                    "name": "Claude-4.5-Sonnet"
                },
                "claude-haiku-4-5-20251001": {
                    "name": "Claude-4.5-Haiku"
                }
            }
        }
    }
}

Sie können auch andere bei Aiberm verfügbare Modelle hinzufügen. Um beispielsweise OpenAI-GPT-Modelle hinzuzufügen:

{
    "$schema": "https://opencode.ai/config.json",
    "provider": {
        "aiberm": {
            "npm": "@ai-sdk/openai",
            "name": "Aiberm",
            "options": {
                "baseURL": "https://aiberm.com/v1",
                "apiKey": "sk-your-aiberm-api-key"
            },
            "models": {
                "openai/gpt-4.1": {
                    "name": "GPT-4.1"
                },
                "openai/gpt-4.1-mini": {
                    "name": "GPT-4.1 Mini"
                },
                "openai/gpt-4.1-nano": {
                    "name": "GPT-4.1 Nano"
                },
                "openai/gpt-4o": {
                    "name": "GPT-4o"
                },
                "openai/gpt-4o-mini": {
                    "name": "GPT-4o Mini"
                }
            }
        }
    }
}

Prüfen Sie die Seite Modellliste oder Aiberm Pricing für alle bei Aiberm verfügbaren Modelle.

Wichtig:

  • Ersetzen Sie "sk-your-aiberm-api-key" durch Ihren tatsächlichen API-Schlüssel aus der Aiberm-Konsole
  • Das JSON-Format ist empfindlich gegenüber Sonderzeichen

Konfiguration prüfen

Starten Sie nach dem Speichern der Konfigurationsdatei Ihr Terminal neu und wechseln Sie in Ihr Arbeitsverzeichnis:

cd your-working-directory

Starten Sie OpenCode:

opencode

Geben Sie in der Chat-Oberfläche den Befehl ein:

/models

Sie sollten Aiberm und seine Modelle in der Modellliste sehen. Wählen Sie eines aus, und Sie können loslegen!

Modelle wechseln

Geben Sie in der OpenCode-Oberfläche den Befehl /models ein und wählen Sie anschließend das gewünschte Modell aus der Liste.

Beispielmodelle, die über Aiberm verfügbar sind:

  • anthropic/claude-sonnet-4-5-20250514: Claude 4.5 Sonnet von Anthropic
  • anthropic/claude-opus-4-20250514: Claude 4 Opus von Anthropic
  • openai/gpt-4.1: GPT-4.1 von OpenAI
  • openai/gpt-4o-mini: GPT-4o Mini von OpenAI
  • google/gemini-3-pro: Gemini 3 Pro von Google
  • Und mehr…

Die vollständige Liste der verfügbaren Modelle finden Sie unter Aiberm Pricing.

Fehlerbehebung

Konfigurationsänderungen werden nicht wirksam

  • Starten Sie OpenCode neu
  • Prüfen Sie die Syntax von opencode.json (JSON-Format)
  • Prüfen Sie, ob der Pfad der Konfigurationsdatei korrekt ist

401/403-Fehler

  • 401-Fehler: API-Schlüssel nicht gesetzt oder ungültig
  • 403-Fehler: Unzureichende Berechtigungen oder abgelaufener Schlüssel
  • Prüfen Sie den apiKey in Ihrer Konfigurationsdatei
  • Prüfen Sie Ihren API-Schlüssel in der Aiberm-Konsole

OpenCode nicht gefunden

macOS/Linux:

# Check if OpenCode is in your PATH
which opencode

# If not found, try reinstalling:
curl -fsSL https://opencode.ai/install | bash

Windows:

  • Prüfen Sie, ob Node.js korrekt installiert ist
  • Versuchen Sie die Neuinstallation über npm: npm i -g opencode-ai@latest

Speicherort der Konfigurationsdatei

Die Konfigurationsdatei opencode.json sollte hier liegen:

  • Windows: C:\Users\{username}\.config\opencode\opencode.json
  • macOS / Linux: ~/.config/opencode/opencode.json

Hinweise

  • Führen Sie OpenCode in einem eigenen Projektordner aus. Vermeiden Sie sensible Verzeichnisse (z. B. Systemordner oder Verzeichnisse mit Anmeldedaten). OpenCode arbeitet ausgehend vom aktuellen Arbeitsverzeichnis.
  • OpenCode verwendet Konfigurationsdateien im JSON-Format. Stellen Sie sicher, dass die Syntax korrekt ist. Sie können Online-JSON-Validatoren zur Prüfung nutzen.
  • OpenCode liest Dateiinhalte nur, wenn Sie das ausdrücklich erlauben. Es wird empfohlen, es in einem eigenen Projektordner zu verwenden.
  • Chinesische Ein- und Ausgabe werden vollständig unterstützt.
Diese Seite auf GitHub bearbeiten