Freunde einladen und kostenlose Tokens verdienen!Mehr erfahren

OpenCode mit benutzerdefinierten CodingPlanX-Modellen integrieren

> Nutzen Sie den Open-Source-Terminal-KI-Programmierassistenten OpenCode in Kombination mit der CodingPlanX API, um das ultimative Kommandozeilen-Entwicklungserlebnis zu schaffen.

🌟 Projektvorstellung

OpenCode ist ein zu 100 % plattformunabhängiger Open-Source-Terminal-KI-Programmierassistent. Es ist im Design ähnlich wie Claude Code, bietet jedoch ein extrem hohes Maß an Flexibilität und Anpassbarkeit. Es ist an keinen bestimmten KI-Dienstleister gebunden, unterstützt den nahtlosen Wechsel zwischen mehreren Modellen, native LSP-Integration (Language Server Protocol) und eine geek-freundliche TUI (Terminal User Interface).

OpenCode Benutzeroberfläche Screenshot

1. OpenCode Kernfunktionen

OpenCode ist ein Open-Source-KI-Programmieragent, der vom SST-Team entwickelt wurde, speziell für Geeks und Terminal-Power-User:

  • 🔓 100% Open Source: Basierend auf der MIT-Lizenz ist der Code völlig transparent.
  • 🧠 Multi-Modell-Unterstützung: Kann gleichzeitig Modelle wie Claude, OpenAI, Google Gemini konfigurieren und nahtlos zwischen ihnen wechseln.
  • ⚡ Native LSP-Unterstützung: Integriertes Language Server Protocol für extrem schnelle und genaue intelligente Code-Analyse und Navigation.
  • 🖥️ TUI First: Speziell für Terminalbenutzer entwickelt, von erfahrenen Neovim-Benutzern mit vollem Tastatursupport erstellt.
  • 🌐 C/S Architektur: Unterstützt Remote-Steuerung; Sie können den Server lokal ausführen und ihn von einem mobilen Gerät oder einem anderen Computer aus fernsteuern.
  • 🔄 Zwei integrierte Agenten: Beinhaltet standardmäßig build (vollständige Lese-/Schreibrechte, Hauptentwicklung) und plan (nur Lesezugriff, für Analyse und Planung).

2. oh-my-opencode (Empfohlenes Erweiterungspaket)

oh-my-opencode ist das stärkste Erweiterungs-Plugin für OpenCode und wird von der Community als "OpenCode auf Steroiden" bezeichnet. Es bietet Ihnen ein professionelles KI-Programmiererlebnis direkt out-of-the-box.

oh-my-opencode Benutzeroberfläche

Kern-Erweiterungsfunktionen:

  • Asynchrone Sub-Agenten: Ähnlich der parallelen Aufgabenverarbeitung von Claude Code, wodurch die Effizienz bei komplexen Aufgaben deutlich gesteigert wird.
  • Ausgewählte Agenten-Konfigurationen: Vorkonfiguriert mit mehreren professionellen Agentenrollen (wie Architekt, Bibliothekar, Explorer usw.).
  • Erweiterte AST-Tools: Unterstützt intelligente Refactorings, tiefgreifende Codeanalysen, Symbolsuche und andere erweiterte Funktionen.
  • Ultra-starker paralleler Modus: Fügen Sie einfach ultrawork zu Ihrem Prompt hinzu, um automatisch den stärksten parallelen Modus zu aktivieren.

Übersicht der integrierten Agentenrollen:

AgentennameEmpfohlenes ModellHauptverwendungszweck
👑 SisyphusClaude Opus 4.6Hauptorchestrierungs-Agent, verantwortlich für die globale Planung und das Delegieren von parallelen Hintergrundaufgaben
🔮 OracleGPT 5.2Architekturdesign, tiefgreifendes Code-Review, strategische Technologieanalyse
📚 LibrarianClaude Sonnet 4.6Multi-Repository-Analyse, Lesen offizieller Dokumentation, Suchen nach Open-Source-Implementierungsbeispielen
🗺️ ExploreGrok Code / HaikuExtrem schnelles Code-Suchen, Codebasis-Exploration und Mustererkennung
🎨 FrontendGemini 3 ProSpezialisiert auf Frontend-Entwicklung, hervorragend bei der Erstellung ansprechender und intuitiver UI/UX

🚀 Installation und Konfiguration

Schritt 1: OpenCode-Hauptprogramm installieren

OpenCode wird sehr schnell iteriert. Es wird empfohlen, das offizielle Skript zu verwenden, um die neueste Version zu installieren (Offizielle Dokumentation):

# Schnelle Installation mit curl (Empfohlen)
curl -fsSL https://opencode.ai/install | bash

# Oder mit einem Node.js-Paketmanager
npm install -g opencode  # bun / pnpm / yarn sind ebenfalls möglich

# macOS-Benutzer können auch Homebrew verwenden
brew install opencode

Schritt 2: oh-my-opencode installieren (Dringend empfohlen)

oh-my-opencode bietet einsatzbereite professionelle Konfigurationsvorlagen, die mühsames manuelles Tuning überflüssig machen:

bunx oh-my-opencode install

> 💡 Tipp: Während der Installation wird ein interaktiver Assistent gestartet, der fragt, welche KI-Abonnements Sie besitzen (z. B. Claude, ChatGPT usw.). Bitte kreuzen Sie entsprechend Ihrer tatsächlichen Situation an.

Schritt 3: CodingPlanX API-Knoten und Modelle konfigurieren

Dies ist der wichtigste Schritt! Bitte verwenden Sie einen Texteditor, um die Konfigurationsdatei zu erstellen oder zu ändern: ~/.config/opencode/opencode.json.

> 🎯 Zur Modellauswahl: > Die untenstehende Konfigurationsvorlage verwendet die von CodingPlanX bereitgestellte Kombination aus Claude-Serie und GPT Codex-Serie Modellen. Sie schneiden bei verschiedenen maßgeblichen Programmier-Benchmarks am besten ab und sind der goldene Partner für Entwickler.

Kopieren Sie den folgenden JSON-Inhalt vollständig und überschreiben Sie ihn in Ihrer opencode.json:

<details open=""> <summary><b>Klicken Sie hier, um den vollständigen opencode.json Konfigurationscode anzuzeigen</b></summary> 
{
  "$schema": "https://opencode.ai/config.json",

  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.codingplanx.ai/v1"
      }
    },
    "openai": {
      "options": {
        "baseURL": "https://api.codingplanx.ai"
      }
    }
  },

  "model": "anthropic/claude-opus-4-5-20251101",
  "small_model": "anthropic/claude-haiku-4-5-20251001",
  "default_agent": "build",

  "permission": {
    "read": "allow", "list": "allow", "glob": "allow", "grep": "allow",
    "codesearch": "allow", "lsp": "allow",
    "edit": "ask", "bash": "ask", "webfetch": "ask", "websearch": "ask",
    "external_directory": "deny", "doom_loop": "ask"
  },

  "agent": {
    "plan": {
      "mode": "primary",
      "description": "Planung/Zerlegung/Technische Lösung (Nur-Lese-Zugriff, um versehentliche Codeänderungen zu vermeiden)",
      "model": "anthropic/claude-opus-4-5-20251101",
      "temperature": 0.1,
      "prompt": "Sie sind ein erfahrener technischer Leiter. Ziel: Zerlegen Sie die Anforderungen in ausführbare Schritte (einschließlich Akzeptanzkriterien/Risiken/Rollback). Standardmäßig Nur-Lese-Zugriff, ändern Sie keine Dateien, führen Sie keine Befehle aus; falls eine Ausführung zwingend erforderlich ist, erklären Sie zuerst den Grund und schlagen Sie vor, zu build/codex zu wechseln.",
      "permission": { "edit": "deny", "bash": "deny", "webfetch": "deny", "websearch": "deny", "doom_loop": "deny" }
    },

    "build": {
      "mode": "primary",
      "description": "Hauptentwicklung (End-to-End Implementierung/Debugging/Testreparatur) - Claude Opus 4.6",
      "model": "anthropic/claude-opus-4-5-20251101",
      "temperature": 0.2,
      "prompt": "Sie sind der primäre Software-Engineering-Agent. Priorität: Minimal praktikable Änderungen, Lesbarkeit, Testbarkeit. Erklären Sie die Lösung kurz, bevor Sie Änderungen vornehmen; geben Sie nach der Änderung unbedingt an: Wichtige Diff-Punkte, wie man lokal verifiziert (Befehle), potenzielle Randbedingungen.",
      "permission": { "edit": "allow", "bash": "allow", "webfetch": "ask", "websearch": "ask", "doom_loop": "ask" }
    },

    "codex": {
      "mode": "primary",
      "description": "Refactoring/Migration/Große Änderungen (Codex) - GPT-5.2",
      "model": "openai/gpt-5.2-2025-12-11",
      "temperature": 0.2,
      "prompt": "Sie sind ein Engineering-Agent im Codex-Stil, der sich auf groß angelegte Refactorings, Migrationen, Code-Reviews und die Zusammenarbeit mit komplexen Toolchains spezialisiert hat. Priorität auf Lauffähigkeit des Projekts: Schrittweise Commits, jeder Schritt ist verifizierbar; fügen Sie bei Unsicherheiten zuerst Schutzmaßnahmen und Tests hinzu.",
      "permission": { "edit": "allow", "bash": "allow", "webfetch": "ask", "websearch": "ask", "doom_loop": "ask" }
    },

    "review": {
      "mode": "subagent",
      "description": "Code Review/Zweites Gehirn (Nur-Lese-Zugriff) - GPT-5.1-Codex-Max",
      "model": "openai/gpt-5.1-codex-max",
      "temperature": 0.1,
      "prompt": "Sie sind ein strenger Code-Reviewer. Ausgabe: 1) Wichtige Risiken (Bugs/Sicherheit/Nebenläufigkeit/Grenzen) 2) Vorschläge zur Wartbarkeit 3) Minimale Änderungsvorschläge (Pseudo-Diff verwendbar) 4) Notwendige Testpunkte. Standardmäßig Nur-Lese-Zugriff, keine Dateien ändern/Befehle ausführen.",
      "permission": { "edit": "deny", "bash": "deny", "webfetch": "deny", "websearch": "deny", "doom_loop": "deny" }
    },

    "explore": {
      "mode": "subagent",
      "description": "Schnelles Code-Scannen/Dateien lokalisieren/Kontext zusammenfassen (Nur-Lese-Zugriff) - Claude Haiku 4.5",
      "model": "anthropic/claude-haiku-4-5-20251001",
      "temperature": 0.1,
      "prompt": "Sie sind ein schneller Explorations-Sub-Agent: Verwenden Sie die wenigsten Schritte, um relevante Dateien/Funktionen/Aufrufketten zu lokalisieren und klare Pfade und Zusammenfassungen zu liefern. Standardmäßig Nur-Lese-Zugriff, keine Dateien ändern/Befehle ausführen.",
      "permission": { "edit": "deny", "bash": "deny" }
    },

    "general": {
      "mode": "subagent",
      "description": "Allgemeine Forschung/Dokumentation schreiben/Lösungen vergleichen (Mittlere Kosten) - Claude Sonnet 4.6",
      "model": "anthropic/claude-sonnet-4-5-20250929",
      "temperature": 0.2,
      "prompt": "Sie sind ein Sub-Agent für allgemeine Analysen: Schwerpunkt auf Erklärungen, Abwägungen, Schreiben von Dokumentationen und Vergleichen von Lösungen; standardmäßig Nur-Lese-Zugriff, versuchen Sie, keinen Code zu ändern.",
      "permission": { "edit": "deny", "bash": "deny" }
    },

    "think": {
      "mode": "subagent",
      "description": "Gedankenunterstützung/Ableitung von Randbedingungen (Nur-Lese-Zugriff) - GPT-5.2",
      "model": "openai/gpt-5.2-2025-12-11",
      "temperature": 0.2,
      "prompt": "Sie sind ein Sub-Agent für Argumentation und Ableitung von Randbedingungen: Geben Sie strukturierte Analysen und Vorschläge zu Design, Ausnahmepfaden, Nebenläufigkeit/Konsistenz und Leistungsengpässen. Standardmäßig Nur-Lese-Zugriff.",
      "permission": { "edit": "deny", "bash": "deny" }
    }
  }
}
</details>

Schritt 4: API Key konfigurieren

Da wir zwei Anbieter (Anthropic und OpenAI) konfiguriert haben, müssen Sie Ihren von CodingPlanX erhaltenen API-Schlüssel intern in OpenCode binden.

  1. Geben Sie im Terminal opencode ein, um das Programm zu starten.
  2. Geben Sie den Befehl /connect in das Dialogfeld ein.
  3. Claude konfigurieren:
    • Wählen Sie Anthropic -> Wählen Sie Manually enter API Key.
    • Fügen Sie Ihren CodingPlanX API Key ein und drücken Sie die Eingabetaste zum Speichern.
  4. OpenAI konfigurieren:
    • Geben Sie erneut /connect ein.
    • Wählen Sie OpenAI -> Wählen Sie Manually enter API Key.
    • Fügen Sie Ihren CodingPlanX API Key ein und drücken Sie die Eingabetaste zum Speichern.
  5. Geben Sie /exit ein, um das Programm zu beenden, und starten Sie dann opencode neu, damit die Konfiguration wirksam wird.

> 🔐 Hinweis: Ihr API-Schlüssel wird sicher lokal in der Datei ~/.local/share/opencode/auth.json gespeichert.

💡 Fortgeschrittene Nutzungstechniken

Nach Abschluss der Konfiguration können Sie im Terminal opencode eingeben, um ein Gespräch zu beginnen:

&gt; Hallo, bitte lies die package.json im aktuellen Verzeichnis und stelle dieses Projekt vor.

1. ⚡ Ultrawork Ultimativer Paralleler Modus

Wenn Sie oh-my-opencode installiert haben, fügen Sie einfach ultrawork oder die Abkürzung ulw zu Ihrem Prompt hinzu. OpenCode ruft dann den Hauptagenten auf, um die Aufgabe zu zerlegen und sie an Hintergrund-Sub-Agenten zur parallelen Verarbeitung zu verteilen:

&gt; ultrawork Hilf mir, das Authentifizierungsmodul im Verzeichnis src/auth zu refaktorisieren und Unit-Tests hinzuzufügen.

2. 🎯 @ Syntax für das gezielte Aufrufen von Agenten

Sie können das @-Symbol verwenden, um bestimmte Aufgaben präzise an die professionellen Agenten zu verteilen, die wir in der JSON-Datei konfiguriert haben:

&gt; @review Hilf mir zu überprüfen, ob die gerade committete login.ts Logik Sicherheitslücken aufweist.
&gt; @explore Suche nach allen API-Endpunkten im Projekt, die getUserInfo aufrufen.
&gt; @general Hilf mir zu vergleichen, ob React Context oder Redux für das aktuelle Projekt besser ist.

3. 🔄 Schneller Wechsel des Arbeitsmodus mit der Tab-Taste

Drücken Sie die Tab-Taste im Eingabefeld, um schnell zwischen den Hauptagenten zu wechseln:

  • build: Hauptmodus, verfügt über vollständige Dateilese-/-schreibrechte und Terminal-Ausführungsrechte.
  • plan: Sicherer Modus, nur Lesezugriff, wird für die anfängliche Anforderungszerlegung, Architekturanalyse und technische Planung verwendet, um zu verhindern, dass die KI versehentlich Code ändert.

🛠️ Fehlerbehebung / Häufig gestellte Fragen (FAQ)

F1: Meldung API-Verbindung fehlgeschlagen oder Timeout?

  • Überprüfen Sie, ob die baseURL in der opencode.json korrekt ist.
  • Überprüfen Sie, ob das Terminal Proxy-Konflikte aufweist (normalerweise kann die Verwendung der direkten IP-Verbindung System-Proxy-Probleme umgehen).

F2: Meldung "Model not found" oder Modell nicht verfügbar?

  • Bestätigen Sie, dass die Modell-ID in der Konfigurationsdatei (z. B. claude-opus-4-5-20251101) genau mit der von CodingPlanX bereitgestellten offiziellen Modellliste übereinstimmt. Nicht falsch schreiben.

F3: oh-my-opencode Plugin meldet Fehler?

  • Das Plugin befindet sich in einer schnellen Entwicklungsphase. Wenn Sie auf einen Fehler stoßen, versuchen Sie bitte, es zu aktualisieren: bunx oh-my-opencode update.
  • Weitere Konfigurationsfragen finden Sie in der offiziellen oh-my-opencode Dokumentation.

🔗 Weiterführende Lektüre und nächste Schritte