DeutschlandGPT in VS Code

Coding-Agenten in VS Code können mit DeutschlandGPT-Modellen arbeiten. Sie richten den Agenten auf die Platform API aus und melden ihn mit einem API-Schlüssel an. Der Agent liest und bearbeitet Dateien in Ihrem Projekt und führt Befehle auf Ihrem Rechner aus; das Modell läuft bei DeutschlandGPT.

Bevor Sie beginnen

1. Ein API-Schlüssel. Legen Sie unter API-Schlüssel einen an, wie im Schnellstart beschrieben. Nehmen Sie für das Programmieren einen eigenen Schlüssel, zum Beispiel vscode, damit sich die Nutzung leicht unterscheiden lässt. Ein Ausgabenlimit auf diesem Schlüssel begrenzt, was ein Agent ausgeben kann.
2. Guthaben. In einem Prepaid-Workspace laufen Anfragen nur, solange Guthaben vorhanden ist. Ohne Guthaben wird jede Anfrage, auch die Modellliste, mit 402 abgelehnt.
3. Die Base URL. Coding-Tools nutzen eine der beiden Schnittstellen:

4. Ein Modell mit Tool-Aufrufen. Agenten lesen Dateien und führen Befehle über Tool-Aufrufe aus, das Modell muss sie also unterstützen. Modelle listet die genauen Modell-IDs, die Ihr Schlüssel nutzen kann; geben Sie sie genau so ein.

Claude Code

Claude Code funktioniert über unsere Anthropic-kompatible Schnittstelle mit jedem Modell, das Ihr Schlüssel nutzen kann, nicht nur mit Claude: Wir haben es mit Claude-, GPT-, Gemini-, Mistral-, gpt-oss- und Qwen-Modellen getestet. Claude Code ist ein Tool von Anthropic; wir unterstützen es mit unserer Schnittstelle. Es gibt Claude Code als Kommandozeilen-Tool und als VS-Code-Erweiterung, beide lesen dieselben Einstellungen.

Setzen Sie diese Umgebungsvariablen, zum Beispiel in ~/.claude/settings.json unter env:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deutschlandgpt.de/anthropic",
    "ANTHROPIC_API_KEY": "<Ihr API-Schlüssel>",
    "ANTHROPIC_MODEL": "<modell-id>",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "<modell-id>",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "<modell-id>",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<modell-id für schnelle Hintergrundaufgaben>",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

• Die Modellauswahl zeigt Aliasse. Das Menü /model in Claude Code bietet opus, sonnet und haiku an. Die drei Variablen ANTHROPIC_DEFAULT_…_MODEL legen fest, welches unserer Modelle jeder Alias aufruft; setzen Sie daher alle drei. Das Menü zeigt für die Aliasse weiter die Namen von Anthropic an; die Anfrage geht an das Modell, das Sie zugeordnet haben.
• Hinweise, die Sie ignorieren können. Bei einer Modell-ID, die Claude Code nicht kennt, meldet es, dass es ein Kontextfenster von 200.000 Tokens annimmt. Bei manchen Claude-IDs zeigt es außerdem den Hinweis, ein älteres Claude-Modell sei eingestellt worden. Beides ändert nichts an der Anfrage: Sie geht an die Modell-ID, die Sie gesetzt haben.
• Hintergrundaufgaben wie Titel und Zusammenfassungen nutzen den Alias haiku. Ordnen Sie ihm ein schnelles, günstiges Modell zu.
• In der VS-Code-Erweiterung können Sie die Variablen statt in settings.json auch in der Erweiterungseinstellung claudeCode.environmentVariables setzen.
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 schaltet die eigene Telemetrie, Fehlerberichte und Update-Prüfungen von Claude Code ab, sodass nur die Modellanfragen Ihren Rechner verlassen.

Cline

Cline ist Open Source und die erste Wahl, wenn Sie einen Open-Source-Agenten möchten.

1. Öffnen Sie die Einstellungen von Cline und wählen Sie als API-Provider OpenAI Compatible.
2. Base URL: https://api.deutschlandgpt.de/v2.
3. API Key: Ihr API-Schlüssel.
4. Model ID: eine genaue Modell-ID aus Modelle. Sobald Base URL und Schlüssel eingetragen sind, lädt Cline die Liste auch selbst.
5. Context Window Size: Cline liest diesen Wert nicht bei uns aus und beginnt mit 128.000 Tokens. Belassen Sie ihn so, wenn Sie das Kontextfenster des Modells nicht kennen; ein kleinerer Wert ist unbedenklich, Cline fasst das Gespräch dann nur früher zusammen. Ein Wert über dem tatsächlichen Kontextfenster lässt lange Aufgaben scheitern.

Die Preise in Cline bleiben bei null, weil Cline unsere Preise nicht kennt. Was eine Aufgabe gekostet hat, sehen Sie im Dashboard.

Prüfen Sie die Freigaben. Cline gibt standardmäßig viele Aktionen selbst frei, in aktuellen Versionen auch das Lesen und Bearbeiten von Dateien. Öffnen Sie das Menü für automatische Freigaben über dem Chat-Eingabefeld und schalten Sie ab, was Sie selbst bestätigen möchten, mindestens das Bearbeiten von Dateien und das Ausführen von Befehlen.

Kilo Code

Auch Kilo Code ist Open Source.

1. Öffnen Sie Settings, wechseln Sie zu Providers und klicken Sie unten auf Custom provider.
2. Provider API: OpenAI Compatible.
3. Base URL: https://api.deutschlandgpt.de/v2.
4. API key: Ihr API-Schlüssel. Kilo Code lädt dann die Modellliste; wählen Sie die gewünschten Modelle aus.
5. Klicken Sie auf Submit. Die Modelle erscheinen in der Modellauswahl von Kilo Code.

Die Telemetrie von Kilo Code folgt der Telemetrie-Einstellung von VS Code (siehe unten).

GitHub Copilot

GitHub Copilot in VS Code kann unsere Modelle als Custom Endpoint nutzen („Bring your own key"). Das funktioniert ohne Copilot-Abo und ohne Anmeldung bei GitHub. In einer Organisation mit Copilot Business oder Enterprise muss Ihr GitHub-Administrator Modelle mit eigenem Schlüssel zuerst erlauben.

1. Öffnen Sie in der Modellauswahl des Chats Manage Language Models (oder führen Sie Chat: Manage Language Models aus der Befehlspalette aus).
2. Klicken Sie auf Add Models und wählen Sie Custom Endpoint. Geben Sie einen Namen und Ihren API-Schlüssel ein und wählen Sie den API-Typ Chat Completions.
3. VS Code öffnet chatLanguageModels.json. Tragen Sie je Modell einen Eintrag ein:

{
  "id": "<modell-id>",
  "name": "<modell-id> (DeutschlandGPT)",
  "url": "https://api.deutschlandgpt.de/v2/chat/completions",
  "toolCalling": true,
  "vision": false,
  "maxInputTokens": 128000,
  "maxOutputTokens": 16000
}

4. Wählen Sie das Modell in der Modellauswahl des Chats. Der Agent-Modus listet nur Modelle mit "toolCalling": true.
5. Ohne Anmeldung bei GitHub fordert VS Code Sie auf, BYOK utility models festzulegen. Klicken Sie auf Configure und wählen Sie eines Ihrer DeutschlandGPT-Modelle, am besten ein schnelles: VS Code nutzt es für kleine Aufgaben wie Chat-Titel und Commit-Nachrichten.

Stattdessen die Responses API nutzen. Setzen Sie den API-Typ auf Responses, verwenden Sie https://api.deutschlandgpt.de/v2/responses als url und ergänzen Sie "statefulResponses": false. Unsere API ist zustandslos; ohne diese Zeile versucht Copilot zuerst, die vorherige Antwort fortzusetzen, erhält 400 und sendet dann das ganze Gespräch erneut, was in jeder Runde eine zusätzliche Anfrage kostet.

Code-Vervollständigung beim Tippen und Copilot-Funktionen, die auf die eigene Suche von GitHub angewiesen sind, stehen über einen Custom Endpoint nicht zur Verfügung. Das ist eine Grenze von Copilot, nicht der API.

Berufsgeheimnisschutz (§203) und Telemetrie

Unterliegt Ihre Organisation dem Berufsgeheimnisschutz, ist jeder API-Schlüssel auf DSGVO-konforme Modelle beschränkt, die Ihre §203-Vereinbarung abdeckt (siehe Berechtigungen). Das gilt unabhängig davon, welches Tool die Anfrage sendet.

Die Tools selbst können außerdem Daten an ihre Hersteller senden. Das können wir auf unserer Seite nicht abschalten; schalten Sie es daher in jedem Tool ab:

Prüfen Sie außerdem die automatischen Freigaben jedes Tools, damit nichts ohne Ihre Bestätigung ausgeführt oder geändert wird.

Fehlerbehebung

• 402: Der Workspace hat kein Guthaben mehr, oder ein Monats- oder Schlüssel-Limit ist erreicht. Siehe Abrechnung.
• 404 an der Anthropic-Schnittstelle: Die Base URL muss auf /anthropic enden, nicht auf /v2/anthropic. Claude Code hängt /v1/messages selbst an.
• Modell nicht gefunden: Verwenden Sie die Modell-ID genau so, wie Modelle sie listet. Anzeigenamen funktionieren nicht als ID.
• Der Agent ruft nie ein Tool auf: Wählen Sie ein Modell, das Tool-Aufrufe unterstützt.