OpenCode installieren und DeepSeek verbinden

OpenCode ist ein offener Programmieragent, der direkt im Terminal läuft. Es kann Projektdateien lesen, Code bearbeiten, Befehle und Tests ausführen, das Repository durchsuchen und mit Git arbeiten – ungefähr das Gleiche, was Claude Code und andere Konsolenagenten tun. Der Hauptunterschied besteht darin, dass OpenCode nicht an einen Modellanbieter gebunden ist: Dutzende Anbieter können darüber angebunden werden, darunter auch DeepSeek. In diesem Beitrag beschreibe ich die Installation des Agenten und die Verbindung von DeepSeek damit.

Was Sie brauchen

Sie brauchen nur zwei Dinge, um zu funktionieren:

• Modernes Terminal. WezTerm, Alacritty, Ghostty, Kitty oder jedes andere reicht aus.
• API-Schlüssel des Anbieters. In unserem Fall DeepSeek.

Node.js ist nicht erforderlich, wenn Sie den Agenten mit einem Standard-Installationsskript installieren – die Binärdatei kommt fertig an.

Installation

Der einfachste Weg ist das offizielle Installationsskript:

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

Es erkennt die Plattform selbst und legt die ausführbare Datei in PATH ab. Nach der Installation sollten Sie prüfen, ob alles vorhanden ist:

opencode --version

Wenn der Befehl die Version anzeigt, war die Installation erfolgreich.

Installation mit anderen Methoden

Wenn Sie Paketmanager bevorzugen, gibt es mehrere Möglichkeiten. Über Node.js:

npm install -g opencode-ai

Bun, pnpm und Yarn können dasselbe tun:

bun install -g opencode-ai
pnpm install -g opencode-ai
yarn global add opencode-ai

macOS und Linux verfügen über Homebrew. Bitte beachten Sie: Es wird der Tipp der Entwickler empfohlen und nicht die offizielle Formel – sie wird seltener aktualisiert:

brew install anomalyco/tap/opencode

Unter Arch Linux:

sudo pacman -S opencode
paru -S opencode-bin

Der erste Befehl installiert die stabile Version aus dem Repository, der zweite die neueste aus dem AUR.

Installation unter Windows

Unter Windows empfiehlt es sich, über WSL zu arbeiten: Dadurch ist die Leistung höher und die Kompatibilität mit den Fähigkeiten des Agenten ist vollständig. Es gibt aber auch native Methoden. Über Chocolatey, Scoop oder npm:

choco install opencode
scoop install opencode
npm install -g opencode-ai

Es gibt auch eine Option über Mise sowie einen Docker-Container:

mise use -g github:anomalyco/opencode
docker run -it --rm ghcr.io/anomalyco/opencode

Schließlich kann die fertige Binärdatei jederzeit der Release-Seite auf GitHub entnommen werden.

DeepSeek-Taste

Der Schlüssel wird in Ihrem persönlichen DeepSeek-Konto erstellt. Gehen Sie zu platform.deepseek.com, öffnen Sie den Abschnitt mit API-Schlüsseln und klicken Sie auf „Neuen Schlüssel erstellen“. Es ist besser, die resultierende Zeichenfolge sofort zu speichern: Sie wird nur einmal angezeigt.

DeepSeek-Verbindung

Dann wird alles im Agenten selbst erledigt. Starten Sie OpenCode im Terminal:

opencode

In der Schnittstelle führen wir den Verbindungsbefehl aus:

/connect

Suchen Sie in der Liste der Anbieter, die sich öffnet, nach DeepSeek, wählen Sie es aus und geben Sie den API-Schlüssel ein. Auf diese Weise hinzugefügte Schlüssel werden in einer Datei gespeichert:

~/.local/share/opencode/auth.json

Nach dem Verbinden müssen Sie nur noch das Modell mit dem Befehl auswählen:

/models

DeepSeek-Modelle werden in der Liste verfügbar sein, darunter deepseek-v4-pro, deepseek-flash und deepseek-v4-flash. Für Routinearbeiten im Repository reicht die Flash-Option aus; Bei komplexen Aufgaben ist es sinnvoll, auf Pro umzusteigen.

Konfiguration über config

Wenn Sie den Schlüssel nicht über einen Master speichern möchten oder Ihre eigene API-Adresse festlegen müssen, wird der Anbieter direkt in der Konfigurationsdatei opencode.json beschrieben:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "deepseek": {
      "options": {
        "baseURL": "https://api.deepseek.com"
      }
    }
  }
}

Das Feld baseURL ist nützlich, wenn Sie über einen Proxy oder Ihr eigenes Gateway gehen. In diesem Fall ist es praktisch, den Schlüssel selbst in eine Umgebungsvariable zu übertragen:

export DEEPSEEK_API_KEY=ваш_ключ_deepseek
opencode

Diese Option ist gut für CI und einmalige Starts: Der Schlüssel landet nicht im Speicher, sondern lebt nur in der Umgebung des Prozesses.

Erster Start im Projekt

Gehen Sie in das Projektverzeichnis und starten Sie den Agenten:

cd ваш_проект
opencode

Der erste Schritt besteht darin, es zu initialisieren:

/init

OpenCode analysiert die Projektstruktur und erstellt eine Datei AGENTS.md – ein Analogon der Anweisungen für den Agenten. Es lohnt sich, diese Datei an Git zu übergeben: Sie hilft dem Agenten, die im Projekt übernommenen Konventionen und Muster zu verstehen.

So verwenden Sie es

Die Arbeit ist ähnlich aufgebaut wie bei anderen Agenten. Ein paar Tricks, die Sie sofort kennen sollten:

• Planungsmodus. Die Tabulatortaste schaltet den Agenten zwischen Planungs- und Montagemodus um. Im ersten Schritt schlägt er nur vor, wie das Problem gelöst werden kann, und ändert nichts – es ist praktisch, die Idee zu überprüfen, bevor Änderungen vorgenommen werden.
• Links zu Dateien. Die @-Taste öffnet eine Fuzzy-Suche durch Projektdateien, um eine bestimmte Datei an den Agenten im Kontext zu übertragen.
• Änderungen rückgängig machen. Der Befehl /undo macht die letzten Änderungen rückgängig und gibt die ursprüngliche Anfrage zurück, /redo gibt sie zurück. Sie können mehrere Schritte hintereinander rückgängig machen.
• Eine Konversation teilen. Der Befehl /share erstellt einen Link zur aktuellen Konversation und kopiert ihn in die Zwischenablage. Standardmäßig werden Konversationen nirgendwo veröffentlicht.

Für einfache Änderungen müssen Sie nicht in den Planungsmodus wechseln, sondern beschreiben sofort, was zu tun ist und geben die Dateien per @ an.

Worauf Sie achten sollten

Ein paar praktische Punkte. Für OpenCode ist kein Abonnement erforderlich: Sie bezahlen den Anbieter direkt, wenn Sie Token ausgeben, sodass lange Sitzungen mit DeepSeek vorhersehbar günstiger sind als bei Topmodellen. Der Schlüssel wird lokal in auth.json gespeichert – dies ist auf einem gemeinsam genutzten Computer eine Überlegung wert, aber für Umgebungen anderer Personen ist eine Umgebungsvariable zuverlässiger.

Und noch etwas: Die Qualität der Antworten auf komplexe Architekturprobleme unterscheidet sich zwischen den Modellen verschiedener Klassen. Aus Designgründen ist es daher sinnvoll, ein stärkeres Modell zu nehmen und die Routine durch ein schnelles und kostengünstiges Modell zu ersetzen.

Links

https://opencode.ai/
https://opencode.ai/docs/
https://opencode.ai/docs/providers/
https://github.com/anomalyco/opencode
https://platform.deepseek.com/api_keys
https://api-docs.deepseek.com

Quellen

https://opencode.ai/docs/
https://opencode.ai/docs/providers/#deepseek
https://github.com/anomalyco/opencode/releases
https://models.dev/