> ## Documentation Index
> Fetch the complete documentation index at: https://docs.infercom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode Integrationsanleitung

> OpenCode CLI für Infercoms EU-souveräne KI-Inferenz konfigurieren. Terminal-UI mit Reasoning-Visualisierung und GDPR-konformer Infrastruktur.

[OpenCode](https://opencode.ai) ist ein terminalbasierter KI-Coding-Assistent mit reichhaltigem TUI (Text User Interface). Er bietet eine interaktive Coding-Erfahrung mit Dateiverwaltung, Reasoning-Visualisierung und Tool-Calling-Fähigkeiten.

<Info>
  **Verifiziert funktionierend** mit MiniMax-M2.7 auf Infercom.
</Info>

## Voraussetzungen

* macOS, Linux oder Windows
* [Infercom API-Schlüssel](https://cloud.infercom.ai/apis)

## Installation

```bash theme={null}
curl -fsSL https://opencode.ai/install | bash
```

Installation verifizieren:

```bash theme={null}
opencode --version
```

## Konfiguration

OpenCode benötigt eine Konfigurationsdatei um den Infercom-Provider zu definieren.

### Schritt 1: Konfigurationsdatei erstellen

`~/.config/opencode/opencode.json` erstellen:

```json theme={null}
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "infercom": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Infercom (EU Sovereign)",
      "options": {
        "baseURL": "https://api.infercom.ai/v1"
      },
      "models": {
        "MiniMax-M2.7": {
          "name": "MiniMax M2.7 (EU Sovereign)"
        }
      }
    }
  },
  "model": "infercom/MiniMax-M2.7"
}
```

<Tip>
  Für komplexe Aufgaben unterstützt OpenCode separate Plan/Build-Agenten. Sie können ein Frontier-Modell (Claude, GPT, Gemini) für die Planung und MiniMax-M2.7 für die Ausführung verwenden. Siehe [OpenCode Dokumentation](https://opencode.ai) für Multi-Provider-Konfiguration.
</Tip>

### Schritt 2: API-Schlüssel hinzufügen

Auth-Login-Befehl ausführen:

```bash theme={null}
opencode auth login
```

Infercom-Provider auswählen und API-Schlüssel eingeben wenn aufgefordert.

<Tip>
  Zugangsdaten werden in `~/.local/share/opencode/auth.json` gespeichert
</Tip>

### Schritt 3: Setup verifizieren

Prüfen dass der Provider konfiguriert ist:

```bash theme={null}
opencode providers list
```

Erwartete Ausgabe:

```
+  Credentials ~/.local/share/opencode/auth.json
|
*  infercom api
|
-  1 credential
```

Verfügbare Modelle auflisten:

```bash theme={null}
opencode models infercom
```

Erwartete Ausgabe:

```
infercom/MiniMax-M2.7
```

## Modell

`infercom/MiniMax-M2.7` verwenden - optimiert für Agentic Coding mit 192K Kontext, Reasoning und Tool Calling.

## Verwendung

### Interaktives TUI

TUI starten:

```bash theme={null}
opencode
```

`/models` verwenden um Modelle zu wechseln falls nötig.

### Nicht-interaktiver Modus

Für Skripte und CI:

```bash theme={null}
opencode run --model infercom/MiniMax-M2.7 "Ihre Aufgabenbeschreibung"
```

Beispiel:

```bash theme={null}
opencode run --model infercom/MiniMax-M2.7 \
  "Füge Input-Validierung zur Login-Funktion in auth.py hinzu"
```

## Fehlerbehebung

### Tool/Datei-Operationen geben leere Antworten

Wenn Tool- oder Dateioperationen leere Antworten zurückgeben, stellen Sie sicher dass `npm` auf `@ai-sdk/openai-compatible` gesetzt ist, nicht `@ai-sdk/openai`. Das `@ai-sdk/openai`-Paket routet zu einem Endpunkt mit einem bekannten Streaming-Problem bei Tool-Calls.

### Read-Before-Write Fehler

OpenCode erfordert das Lesen von Dateien vor dem Überschreiben (Sicherheitsfunktion):

```
Error: You must read file /path/to/file.py before overwriting it.
```

Dies ist erwartetes Verhalten. OpenCode wird die Datei automatisch lesen und erneut versuchen.

### Provider nicht gefunden

Sicherstellen dass die Konfigurationsdatei am richtigen Ort ist:

```bash theme={null}
ls ~/.config/opencode/opencode.json
```

### Authentifizierung fehlgeschlagen

Login-Befehl erneut ausführen:

```bash theme={null}
opencode providers login -p infercom
```

Oder manuell `~/.local/share/opencode/auth.json` bearbeiten:

```json theme={null}
{
  "infercom": {
    "type": "api",
    "key": "ihr-infercom-api-key"
  }
}
```

## Performance

* **Token-Durchsatz:** 400+ Tokens/Sek mit MiniMax-M2.7
* **Kontextfenster:** 192K Tokens
* **Tool Calling:** Vollständig unterstützt für Dateioperationen

## Nächste Schritte

* [Aider](/de/agentic-coding/aider) - Einfacheres Terminal-Tool
* [Tool auswählen](/de/agentic-coding/choosing-a-tool) - Optionen vergleichen
* [API-Referenz](/de/api-reference/overview) - Direkte API-Nutzung