OpenCode

OpenCode ist ein Open-Source-AI-Coding-Agent, der im Terminal läuft und neben jedem beliebigen Editor oder jeder IDE verwendet werden kann.

Mit OpenCode können Sie Fragen zu Ihrer Codebasis stellen, Code generieren oder umschreiben, Tests und Shell-Befehle ausführen und mehrstufige Änderungen über mehrere Dateien hinweg vom Agenten ausführen lassen — alles im Terminal, gegen AI Foundation Services-Modelle.

Es eignet sich besonders, wenn Sie einen tastaturzentrierten, editorunabhängigen Workflow bevorzugen und ein Werkzeug suchen, das Sie ohne IDE-Wechsel in jedes Projekt einbringen können.

Hauptfunktionen

• LSP-Unterstützung, die das passende Sprach-Tooling für das Modell lädt
• Multi-Session-Workflows, sodass Sie mehrere Agenten im selben Projekt ausführen können
• Teilbare Session-Links für Zusammenarbeit und Debugging
• MCP-Unterstützung für externe Tools und Datenquellen
• Editor-unabhängiger Workflow, der in jeder IDE funktioniert

Installation und Einrichtung

Proxy-Nutzung

Wie die meisten Kommandozeilen-Tools benötigt OpenCode unter Umständen Proxy-Einstellungen in Ihrer Shell-Umgebung:

http_proxy=<your-proxy-url:port>
https_proxy=<your-proxy-url:port>

1. Fügen Sie die npm-Registry hinzu:

   npm config set @aie:registry https://plugins.dev.aie.ai.t-systems.net/v1/npm

2. Installieren Sie OpenCode global:

   npm install -g @aie/opencode

3. Wenn Sie unter Windows arbeiten und einen Proxy benötigen, setzen Sie die erforderlichen Umgebungsvariablen, bevor Sie OpenCode starten.

4. Holen Sie sich einen API-Key über das Portal:

   • AI Foundation Services API Key Portal

5. Führen Sie aus:

   opencode auth login https://plugins.dev.aie.ai.t-systems.net

   Damit richten Sie OpenCode mit einer Konfiguration ein, die unter https://plugins.dev.aie.ai.t-systems.net/.well-known/opencode veröffentlicht wird und die wir für die konforme Nutzung der AI Foundation Services-Modelle empfehlen.

6. Starten Sie OpenCode:

   opencode

7. Führen Sie in OpenCode den folgenden Befehl aus, um Ihren Provider auszuwählen und sich mit Ihrem API-Key anzumelden:

   /connect

   Wählen Sie AI Foundation Services aus der Provider-Liste und geben Sie auf Aufforderung Ihren API-Key ein.

Sie können nun einen Chat starten und OpenCode verwenden.

Erste Schritte mit OpenCode

Sobald OpenCode läuft, arbeiten Sie in natürlicher Sprache mit dem Agenten. Einige Prompts zum Ausprobieren in Ihrem Projektverzeichnis:

• Fasse zusammen, was dieses Repository tut und wie die Hauptmodule zusammenspielen.
• Refaktoriere getUserById in src/db/users.ts so, dass async/await statt Promise-Ketten verwendet wird.
• Führe die Tests aus und behebe etwaige Fehler.

Eine vollständige Liste der In-Session-Kommandos und weiterführende Konfiguration (eigene Agenten, MCP-Server, Regeln) finden Sie in der OpenCode-Originaldokumentation.

Beispiel-Konfiguration

Wenn Sie OpenCode lieber deklarativ konfigurieren oder ein Standardmodell und eine Base URL fest hinterlegen möchten, legen Sie opencode.json im Projekt-Stamm oder unter ~/.config/opencode/opencode.json als globalen Standard an:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "openai/gpt-4.1", // Standardmodell setzen (Format: provider_id/model_id)

  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://llm-server.llmhub.t-systems.net/v2"
      }
    }
  },

  // Berechtigungen für integrierte Tools setzen
  "permission": {
    "edit": "allow",
    "websearch": "allow"
  }
}

OpenCode liest OPENAI_API_KEY automatisch aus der Umgebung, sodass die Konfiguration nur die baseURL benötigt. Wenn Sie die Variable im Quickstart gesetzt haben, ist hier keine weitere Key-Konfiguration nötig.