In 3 Schritten OpenCode an API-Relay anbinden und den freien Wechsel zwischen 400+ KI-Modellen freischalten

Möchten Sie OpenCode, diesen Open-Source-AI-Programmierassistenten, nutzen, haben aber Bedenken wegen der hohen offiziellen API-Preise oder instabiler Netzwerkverbindungen? Ein API-Relay ist die ideale Lösung für Sie. In diesem Artikel zeigen wir Ihnen Schritt für Schritt, wie Sie in nur 3 Schritten OpenCode mit Relay-Diensten wie APIYI, OpenRouter und anderen verbinden, damit Sie kostengünstig auf über 75 führende KI-Modelle wie Claude, GPT-4 und Gemini zugreifen können.

Kernvorteil: Nach der Lektüre dieses Artikels werden Sie wissen, wie Sie OpenCode mit jeder OpenAI-kompatiblen API konfigurieren, um einen flexiblen Modellwechsel und eine Kostenoptimierung zu erreichen.

Was ist OpenCode? Warum ein API-Relay nutzen?

OpenCode ist ein quelloffener KI-Programmierassistent für das Terminal, der oft als Open-Source-Alternative zu Claude Code bezeichnet wird. Es basiert auf der Sprache Go und bietet eine elegante TUI-Oberfläche, Multi-Session-Management, LSP-Integration und weitere professionelle Funktionen.

OpenCode Kernfunktionen im Überblick

Warum ein API-Relay verwenden?

Die direkte Nutzung offizieller APIs kann folgende Hürden mit sich bringen:

🚀 Schnellstart: Wir empfehlen die Nutzung von APIYI (apiyi.com) als Relay. Es bietet sofort einsatzbereite OpenAI-kompatible Schnittstellen. Registrieren Sie sich und erhalten Sie ein kostenloses Testguthaben – die Konfiguration von OpenCode dauert nur 5 Minuten.

Kernelemente der OpenCode-Anbindung an API-Relaisstationen

Bevor du mit der Konfiguration beginnst, werfen wir einen Blick auf das API-Anbindungsprinzip von OpenCode:

Beschreibung der Konfigurationsarchitektur

OpenCode nutzt ein einheitliches Konfigurationsmanagement-System, das mehrschichtige Überschreibungen unterstützt:

API-Relais-Anbindungsprinzip

OpenCode unterstützt über den @ai-sdk/openai-compatible-Adapter jede OpenAI-kompatible API. Die wichtigsten Konfigurationspunkte sind:

• baseURL: Die Schnittstellenadresse der API-Relaisstation.
• apiKey: Der von der Relaisstation bereitgestellte API-Key.
• models: Liste der verfügbaren Modelle.

Das bedeutet: Solange die Relaisstation die Standard-Schnittstelle /v1/chat/completions bereitstellt, kann sie direkt in OpenCode eingebunden werden.

OpenCode Schnellstart-Konfiguration

Schritt 1: OpenCode installieren

OpenCode bietet verschiedene Installationswege an, wähle den für dich passendsten:

Ein-Klick-Installationsskript (empfohlen):

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

Homebrew Installation (macOS/Linux):

brew install opencode-ai/tap/opencode

npm Installation:

npm i -g opencode-ai@latest

Go Installation:

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

Installation überprüfen:

opencode --version

Schritt 2: API-Relais-Key konfigurieren

OpenCode unterstützt zwei Authentifizierungsmethoden:

Option 1: Über den /connect-Befehl (empfohlen)

Starte OpenCode und gib den Befehl /connect ein:

opencode
# Im TUI-Interface eingeben
/connect

Wähle Other, um einen benutzerdefinierten Provider hinzuzufügen, und gib deinen API-Key ein. Der Key wird sicher unter ~/.local/share/opencode/auth.json gespeichert.

Option 2: Konfiguration über Umgebungsvariablen

Füge in deiner ~/.zshrc oder ~/.bashrc hinzu:

# APIYI Relais-Konfiguration
export OPENAI_API_KEY="sk-your-apiyi-key"
export OPENAI_BASE_URL="https://api.apiyi.com/v1"

Konfiguration anwenden:

source ~/.zshrc

Schritt 3: opencode.json Konfigurationsdatei erstellen

Dies ist der wichtigste Schritt: Erstelle eine Konfigurationsdatei, um die API-Relaisstation festzulegen.

Globale Konfiguration (gilt für alle Projekte):

mkdir -p ~/.config/opencode
touch ~/.config/opencode/opencode.json

Projektkonfiguration (gilt nur für das aktuelle Projekt):

touch opencode.json  # Im Projekt-Stammverzeichnis

Minimalistisches Konfigurationsbeispiel

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI",
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4"
        },
        "gpt-4o": {
          "name": "GPT-4o"
        }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514"
}

Konfigurationshinweis: Die Syntax {env:OPENAI_API_KEY} liest automatisch die Umgebungsvariable aus, um das Hardcoding von Keys in der Datei zu vermeiden. API-Keys, die über APIYI (apiyi.com) bezogen werden, sind OpenAI-kompatibel und können direkt verwendet werden.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI (empfohlen)",
      "options": {
        "baseURL": "https://api.apiyi.com/v1",
        "apiKey": "{env:APIYI_API_KEY}"
      },
      "models": {
        "claude-sonnet-4-20250514": {
          "name": "Claude Sonnet 4",
          "limit": {
            "context": 200000,
            "output": 65536
          }
        },
        "claude-opus-4-20250514": {
          "name": "Claude Opus 4",
          "limit": {
            "context": 200000,
            "output": 32000
          }
        },
        "gpt-4o": {
          "name": "GPT-4o",
          "limit": {
            "context": 128000,
            "output": 16384
          }
        },
        "gpt-4o-mini": {
          "name": "GPT-4o Mini",
          "limit": {
            "context": 128000,
            "output": 16384
          }
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro",
          "limit": {
            "context": 1000000,
            "output": 65536
          }
        },
        "deepseek-chat": {
          "name": "DeepSeek V3",
          "limit": {
            "context": 64000,
            "output": 8192
          }
        }
      }
    },
    "openrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenRouter",
      "options": {
        "baseURL": "https://openrouter.ai/api/v1",
        "apiKey": "{env:OPENROUTER_API_KEY}",
        "headers": {
          "HTTP-Referer": "https://your-site.com",
          "X-Title": "OpenCode Client"
        }
      },
      "models": {
        "anthropic/claude-sonnet-4": {
          "name": "Claude Sonnet 4 (OpenRouter)"
        },
        "openai/gpt-4o": {
          "name": "GPT-4o (OpenRouter)"
        }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514",
  "small_model": "apiyi/gpt-4o-mini",
  "agent": {
    "coder": {
      "model": "apiyi/claude-sonnet-4-20250514",
      "maxTokens": 8000
    },
    "planner": {
      "model": "apiyi/gpt-4o",
      "maxTokens": 4000
    }
  },
  "tools": {
    "write": true,
    "bash": true,
    "glob": true,
    "grep": true
  }
}

Vergleich der von OpenCode unterstützten API-Proxys

Konfigurationsparameter gängiger API-Proxys

APIYI-Konfiguration im Detail

APIYI ist eine für Entwickler optimierte Plattform für AI-API-Proxys und bietet:

• Eine einheitliche, OpenAI-kompatible Schnittstelle
• Unterstützung für Claude, GPT, Gemini, DeepSeek und andere gängige Modelle
• Pay-as-you-go Abrechnung ohne monatliche Grundgebühr
• Gratis-Testguthaben für den Einstieg
• Dedizierten Support

{
  "provider": {
    "apiyi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIYI",
      "options": {
        "baseURL": "https://api.apiyi.com/v1"
      },
      "models": {
        "claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
        "claude-opus-4-20250514": { "name": "Claude Opus 4" },
        "gpt-4o": { "name": "GPT-4o" },
        "gpt-4o-mini": { "name": "GPT-4o Mini" },
        "gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
        "deepseek-chat": { "name": "DeepSeek V3" }
      }
    }
  }
}

OpenRouter-Konfiguration im Detail

OpenRouter aggregiert über 400 KI-Modelle und ist ideal, wenn du flexibel zwischen verschiedenen Modellen wechseln möchtest:

{
  "provider": {
    "openrouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OpenRouter",
      "options": {
        "baseURL": "https://openrouter.ai/api/v1",
        "apiKey": "{env:OPENROUTER_API_KEY}",
        "headers": {
          "HTTP-Referer": "https://your-app.com",
          "X-Title": "My OpenCode App"
        }
      },
      "models": {
        "anthropic/claude-sonnet-4": {
          "name": "Claude Sonnet 4"
        },
        "google/gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro"
        },
        "meta-llama/llama-3.1-405b": {
          "name": "Llama 3.1 405B"
        }
      }
    }
  }
}

💡 Empfehlung: Wenn du hauptsächlich Claude- und GPT-Modelle nutzt, ist APIYI (apiyi.com) aufgrund der attraktiven Preise und der hohen Geschwindigkeit zu empfehlen. Für spezielle Open-Source- oder Nischenmodelle bietet OpenRouter die beste Abdeckung.

OpenCode Fortgeschrittene Konfigurationstipps

Zuweisungsstrategie für Agent-Modelle

OpenCode verfügt über zwei integrierte Agents, den Coder und den Planner. Sie können diesen unterschiedliche Modelle zuweisen:

{
  "agent": {
    "coder": {
      "model": "apiyi/claude-sonnet-4-20250514",
      "maxTokens": 8000,
      "description": "Hauptkodierungsaufgaben, verwendet ein leistungsstarkes Modell"
    },
    "planner": {
      "model": "apiyi/gpt-4o-mini",
      "maxTokens": 4000,
      "description": "Planungsanalyse, verwendet ein leichtgewichtiges Modell zur Kostenersparnis"
    }
  }
}

Wechsel zwischen mehreren Providern

Sobald mehrere Provider konfiguriert sind, können Sie in OpenCode jederzeit mit dem Befehl /models zwischen ihnen wechseln:

# OpenCode starten
opencode

# In der TUI das Modell wechseln
/models
# Wählen Sie apiyi/claude-sonnet-4-20250514 oder ein anderes Modell aus

Best Practices für Umgebungsvariablen

Es wird empfohlen, API-Keys in einer .env-Datei zu verwalten:

# .env Datei
APIYI_API_KEY=sk-your-apiyi-key
OPENROUTER_API_KEY=sk-or-your-openrouter-key

Referenzieren Sie diese anschließend in der opencode.json:

{
  "provider": {
    "apiyi": {
      "options": {
        "apiKey": "{env:APIYI_API_KEY}"
      }
    }
  }
}

Konfiguration von Token-Limits

Legen Sie Kontext- und Ausgabebeschränkungen für Modelle fest, um Fehler durch Limitüberschreitungen zu vermeiden:

{
  "models": {
    "claude-sonnet-4-20250514": {
      "name": "Claude Sonnet 4",
      "limit": {
        "context": 200000,
        "output": 65536
      }
    }
  }
}

OpenCode Fehlerbehebung und häufig gestellte Fragen (FAQ)

Hier finden Sie Lösungen für Probleme, die bei der Konfiguration auftreten können:

"baseURL": "https://api.apiyi.com/v1"

"baseURL": "https://api.apiyi.com/v1/chat/completions"

{
  "provider": {
    "apiyi": {
      "models": {
        "claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" }
      }
    }
  },
  "model": "apiyi/claude-sonnet-4-20250514"
}

# Konfigurierte Authentifizierungsinformationen anzeigen
opencode auth list

# Verfügbare Modelle anzeigen
opencode
/models

# Einfachen Dialog testen
opencode -p "Hallo, bitte antworte auf Deutsch"

opencode
/models
# Wählen Sie einfach ein Modell unter einem anderen Provider aus

{
  "model": "apiyi/claude-sonnet-4-20250514"
}

OpenCode vs. Claude Code: Vergleich der API-Anbindungsmethoden

🎯 Technischer Rat: Der größte Vorteil von OpenCode ist die Modellflexibilität. In Kombination mit dem APIYI (apiyi.com) Gateway können Sie mit derselben Konfiguration zwischen verschiedenen Modellen wie Claude, GPT-4 und Gemini wechseln, um die kosteneffizienteste Lösung zu finden.

Referenzmaterialien

Hier sind einige Referenzmaterialien, die Sie bei der Konfiguration von OpenCode benötigen könnten:

Fazit

Mit der in diesem Artikel beschriebenen 3-Schritte-Konfiguration haben Sie Folgendes gelernt:

1. Installation von OpenCode: Schnelle Installation über ein One-Click-Skript oder einen Paketmanager.
2. Konfiguration des API-Schlüssels: Einrichtung der Authentifizierung über /connect oder Umgebungsvariablen.
3. Erstellung der Konfigurationsdatei: Schreiben der opencode.json, um den API-Proxy und das Modell festzulegen.

Als Open-Source-KI-Programmierassistent für das Terminal bietet OpenCode in Kombination mit einem API-Proxy ein Erlebnis, das mit Claude Code vergleichbar ist – bei gleichzeitig kontrollierbaren Kosten und Modellflexibilität.

Wir empfehlen, Ihren API-Schlüssel schnell über APIYI apiyi.com zu beziehen und mit dem Testen zu beginnen. Die Plattform bietet ein kostenloses Kontingent, unterstützt gängige Modelle wie Claude, GPT und Gemini und macht die Konfiguration durch ein einheitliches Schnittstellenformat noch einfacher.

📝 Autor: APIYI-Technikteam | APIYI apiyi.com – Macht den Aufruf von KI-APIs einfacher.