OpenCode

Überblick

Typ: Coding-ToolPrimärer Pfad: OpenAI-kompatibelSupport-Niveau: Unterstützter Pfad

OpenCode ist ein Open-Source-AI-Coding-Assistent, der in Ihrem Terminal läuft. Er unterstützt mehrere LLM-Anbieter und kann so konfiguriert werden, dass er die API von TokenLab für den Zugriff auf über 300 Modelle verwendet.

Installation

Installationsskript
Homebrew
Go

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

brew install opencode-ai/tap/opencode

Oder verwenden Sie den Community-Tap (häufigere Updates):

brew install anomalyco/tap/opencode

go install github.com/opencode-ai/opencode@latest

Installation überprüfen:

opencode --version

Konfiguration

Schritt 1: Umgebungsvariablen setzen

export OPENAI_API_KEY="sk-your-tokenlab-key"

Für eine permanente Konfiguration fügen Sie Folgendes zu ~/.bashrc oder ~/.zshrc hinzu:

echo 'export OPENAI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
source ~/.zshrc

Schritt 2: OpenCode konfigurieren

Die aktuelle Dokumentation von OpenCode empfiehlt, Anbieter über opencode.json oder opencode.jsonc zu konfigurieren. Für TokenLab verwenden Sie einen benutzerdefinierten Anbieter, anstatt den integrierten openai-Anbieter zu überladen:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenlab": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TokenLab",
      "options": {
        "baseURL": "https://api.tokenlab.sh/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        }
      }
    }
  },
  "model": "tokenlab/gpt-5.4"
}

Verwenden Sie @ai-sdk/openai-compatible für Kompatibilität im Stil von chat-completions. Wenn Sie ausdrücklich einen Anbieterpfad benötigen, der auf /v1/responses basiert, empfiehlt die Anbieter-Dokumentation von OpenCode, das Paket auf @ai-sdk/openai umzustellen.

Grundlegende Verwendung

Interaktiven Modus starten:

opencode

Mit einem Prompt ausführen:

opencode "Explain this codebase"

Modell angeben:

opencode --model tokenlab/gpt-5.4 "Fix the bugs in main.py"

Verfügbare Modelle

Modell	Am besten geeignet für
`gpt-5.4`	Komplexe Aufgaben, Code-Architektur
`gpt-5-mini`	Schnelle Korrekturen, einfache Abfragen
`claude-sonnet-4-6`	Code-Review, Dokumentation
`claude-opus-4-6`	Komplexes Schlussfolgern
`gemini-3.5-flash`	Schnelle Antworten
`deepseek-r1`	Algorithmusdesign

Häufige Befehle

Code analysieren:

opencode "What does this function do?" < src/utils.ts

Code generieren:

opencode "Create a REST API with Express"

Änderungen überprüfen:

git diff | opencode "Review these changes"

Fehler beheben:

opencode "Fix the TypeScript errors in this project"

Interaktive Befehle

Command	Beschreibung
`/help`	Verfügbare Befehle anzeigen
`/model <name>`	Zu einem anderen Modell wechseln
`/clear`	Konversationsverlauf löschen
`/exit`	OpenCode beenden

Fehlerbehebung

Verbindungsfehler

Überprüfen Sie, ob options.baseURL auf https://api.tokenlab.sh/v1 gesetzt ist
Überprüfen Sie die Netzwerkverbindung
Versuchen Sie curl https://api.tokenlab.sh/v1/models zum Testen

Authentifizierung fehlgeschlagen

Überprüfen Sie, ob die Umgebungsvariable OPENAI_API_KEY gesetzt ist
Überprüfen Sie, ob options.apiKey auf {env:OPENAI_API_KEY} oder eine andere gültige Secret-Quelle verweist
Prüfen Sie, ob der Schlüssel mit sk- beginnt
Stellen Sie sicher, dass der Schlüssel im TokenLab-Dashboard aktiv ist

Modell nicht gefunden

Prüfen Sie, ob der Modellname in der Konfiguration exakt übereinstimmt
Überprüfen Sie die Modellverfügbarkeit unter tokenlab.sh/en/models

Bewährte Praktiken

Projektkontext verwenden

Führen Sie OpenCode im Stammverzeichnis Ihres Projekts aus, damit Ihre Codebasis besser verstanden wird.

Geeignete Modelle wählen

Verwenden Sie schnellere Modelle (gpt-5-mini) für einfache Aufgaben und leistungsstärkere Modelle (gpt-5.4, claude-sonnet-4-6) für komplexe Aufgaben.

Generierten Code überprüfen

Überprüfen Sie AI-generierten Code immer, bevor Sie Änderungen auf Ihr Projekt anwenden.

Kompatibilitätsmatrix

Coding-Tools

Native SDKs (nativ)

Frameworks & Plattformen

Chat-Apps

Überblick

Installation

Konfiguration

Schritt 1: Umgebungsvariablen setzen

Schritt 2: OpenCode konfigurieren

Grundlegende Verwendung

Verfügbare Modelle

Häufige Befehle

Interaktive Befehle

Fehlerbehebung

Bewährte Praktiken

​Überblick

​Installation

​Konfiguration

​Schritt 1: Umgebungsvariablen setzen

​Schritt 2: OpenCode konfigurieren

​Grundlegende Verwendung

​Verfügbare Modelle

​Häufige Befehle

​Interaktive Befehle

​Fehlerbehebung

​Bewährte Praktiken

Überblick

Installation

Konfiguration

Schritt 1: Umgebungsvariablen setzen

Schritt 2: OpenCode konfigurieren

Grundlegende Verwendung

Verfügbare Modelle

Häufige Befehle

Interaktive Befehle

Fehlerbehebung

Bewährte Praktiken