# Claude Desktop mit OpenCheese

> Claude Desktop im Drittanbieter-Inferenzmodus mit OpenCheese: Entwicklermodus, die generierte OpenCheese.json, ihr Import und was du danach prüfst.
>
> Webseite: https://opencheese.dev/de/docs/claude-desktop/ · Alle Seiten der Doku: https://opencheese.dev/de/docs.md

Claude Desktop ist die grafische App von Anthropic für Windows und macOS. Sie erreicht OpenCheese
über ihren Drittanbieter-Inferenzmodus, den du nicht im Terminal einrichtest, sondern über eine
Konfigurationsdatei, die du in der App importierst. Für Linux gibt es kein Claude Desktop: Nutze
dort [Claude Code](https://opencheese.dev/de/docs/claude-code.md).

## 1. App installieren, aber nicht anmelden

Lade Claude Desktop von [claude.com/download](https://claude.com/download) herunter: Windows 10
Build 19041 oder neuer (das `.msix`-Installationsprogramm) oder macOS 14 Sonoma oder neuer (die
`.dmg`).

Öffne die App und geh nicht über den Anmeldebildschirm hinaus. Melde dich nicht an und erstelle kein
Anthropic-Konto: Der Drittanbieter-Modus ersetzt diese Anmeldung, und ein zuerst angemeldetes
Konto schickt deine Anfragen an Anthropic statt an OpenCheese.

## 2. Entwicklermodus aktivieren

Das Konfigurationsfenster bleibt verborgen, bis der Entwicklermodus aktiv ist. Im App-Menü (unter
Windows ist das die Menüschaltfläche oben links auf dem Anmeldebildschirm):

1. Öffne **Help**.
2. Öffne **Troubleshooting**.
3. Klicke auf **Enable Developer Mode**.

Neben **Help** erscheint jetzt das Menü **Developer**. Öffne es, klicke auf **Configure
Third-Party Inference…** und lass dieses Fenster geöffnet.

Öffnet sich das Fenster schreibgeschützt mit dem Hinweis, die Konfiguration werde von der
Organisation verwaltet, hat ein Administrator ein Profil auf dein Gerät verteilt, und die App
lässt sich auf diesem Weg nicht konfigurieren.

## 3. Konfiguration herunterladen

Melde dich im OpenCheese-Dashboard an, öffne **Konfiguration**, wähle den Tab **Claude Code** und dort
den Schalter **Claude Desktop**, such dir einen API-Schlüssel aus und bestätige dein Passwort.
Lade dann `OpenCheese.json` herunter. Die App benennt die Konfiguration nach der Datei; behalte
den Namen also bei, sofern du keine andere Bezeichnung möchtest.

So sieht die Datei aus:

```json
{
  "$schemaVersion": 2,
  "inference": {
    "provider": "gateway",
    "baseUrl": "https://api.opencheese.dev",
    "credential": {
      "kind": "static",
      "apiKey": "YOUR_OPENCHEESE_API_KEY"
    }
  },
  "models": {
    "prefer1mContext": true,
    "pricing": {
      "enabled": true
    }
  }
}
```

- `baseUrl` darf nicht auf `/v1` enden: Die App hängt `/v1/models` und `/v1/messages` selbst an.
- Eine Modellliste ist nicht nötig: Die App liest die Modelle deines Tarifs bei jedem Start aus
  `/v1/models`.
- Die Datei enthält deinen API-Schlüssel im Klartext. Lösche die heruntergeladene Kopie, sobald
  der Import abgeschlossen ist; die App behält ihre eigene.

## 4. Importieren und neu starten

Zurück im Konfigurationsfenster:

1. Öffne die Konfigurationsauswahl oben rechts.
2. Klicke auf **Import configuration…** und wähle die heruntergeladene Datei aus.
3. Prüfe, ob unter **Connection** der Wert **Gateway** steht und Basis-URL und API-Schlüssel
   ausgefüllt sind.
4. Klicke auf **Apply Changes** und dann auf **Apply locally**. Die App schreibt die
   Konfiguration und startet sich neu.

Importierte Konfigurationen liegen hier:

| System | Ordner |
| --- | --- |
| Windows | `%LOCALAPPDATA%\Claude-3p\configLibrary\` |
| macOS | `~/Library/Application Support/Claude-3p/configLibrary/` |

## 5. Prüfen, ob es funktioniert

- Nach dem Neustart bietet der Anmeldebildschirm die OpenCheese-Bereitstellung statt eines
  Anthropic-Kontos an. Wähle sie aus.
- Die Modellauswahl zeigt die Claude-Modelle deines Tarifs. Ist sie leer, konnte die App
  OpenCheese beim Start nicht erreichen.
- Die App liest die Konfiguration einmal beim Start. Wirkt etwas veraltet, beende sie vollständig
  und öffne sie erneut; das Fenster zu schließen genügt nicht.
- Welche Einstellungen die App gelesen hat, zeigt dir **Help → Troubleshooting → Copy Managed
  Configuration Report** (Geheimnisse werden geschwärzt).

Der Verbrauch erscheint im Dashboard unter **Transaktionen**, gruppiert als eine Sitzung pro
Unterhaltung.
