Externe Tools mit der OpenDesign Cloud API verbinden

Verwalte deine OpenDesign API Keys im Web und nutze die von deinem Tarif unterstützten Modelle in einem externen Agenten. Die OpenDesign Desktop-App ist nicht erforderlich. Die Einrichtung mit einem Klick importiert die Verbindung über CC Switch auf deinem Computer.

Wähle die benötigte Verbindung

Um einen Anbieterschlüssel in OpenDesign zu importieren, folge der Anleitung zur BYOK-Einrichtung. In dieser Anleitung geht es um die umgekehrte Richtung: die Nutzung der OpenDesign Cloud-Modell-API über ein externes Tool wie Claude Code oder Codex.

Bevor du beginnst

Die Cloud API von OpenDesign ist mit den Tarifen Go, Plus, Pro und Max verfügbar. Free wird nicht unterstützt. Die Model-Liste Ihres Kontos bestimmt, welche Textmodelle Sie verwenden können. In Screenshots gezeigte Modelle sind Beispiele und nicht in jedem Tarif enthalten.

Unterstützte Agenten sind Claude Code, Codex, Grok Build, OpenCode, OpenClaw und Hermes Agent. Installiere zuerst den gewünschten Agenten. Wenn CC Switch bereits installiert ist, kannst du den Installationsschritt überspringen.

API Keys im Web öffnen

Melde dich im Web bei der Kontoverwaltung von OpenDesign an und wähle in der Seitenleiste API keys aus. Wähle oben rechts One-click agent setup aus. Du kannst ohne vorhandenen Schlüssel beginnen.

Die vollständige Seite API keys: One-click agent setup befindet sich oben rechts; Connection setup enthält API-Formate und die zugehörigen Basis-URLs.

Öffnen Sie zur manuellen Einrichtung Connection setup, wählen Sie das von Ihrem Tool benötigte API-Format – Chat Completions, Responses oder Messages – und kopieren Sie die zugehörige API-Basis-URL. Achten Sie darauf, dass Endpunkt und Protokoll übereinstimmen. Die folgenden Schritte zeigen den Import mit einem Klick.

Schritt 1: CC Switch installieren und öffnen

Wähle unter One-click agent setup Download for Mac oder Download for Windows aus.
Installiere und öffne CC Switch. Überspringe diesen Schritt, wenn es bereits installiert ist.

Schritt 2: Agent und Modell auswählen

Wähle deinen Ziel-Agenten aus. Claude Code ist standardmäßig ausgewählt.
Wähle aus der Model-Liste ein Textmodell aus, das für deinen Tarif verfügbar ist. Wenn kein Modell verfügbar ist, wähle einen anderen Agenten oder überprüfe deinen Tarif. Das Kopieren eines Modellnamens aus einem Screenshot gewährt keinen Zugriff.

Der Einrichtungsdialog: Wähle den Ziel-Agenten und anschließend ein für dein Konto verfügbares Modell aus.

Schritt 3: Importieren und neu starten

Wähle Import into CC Switch aus. Dadurch wird ein neuer Schlüssel erstellt, dessen Name den Agenten und das System enthält, zum Beispiel Claude Code · Mac, und CC Switch wird geöffnet.
Bestätige im Browserdialog Open CC Switch. Überprüfe in CC Switch API Endpoint, Schlüssel und Modell und wähle anschließend Import aus.
Kehre zur Webseite zurück und wähle Done oder Set up another agent aus, um eine weitere Verbindung einzurichten.
Starte den Ziel-Agenten neu. Beende bei Claude Code die aktuelle Sitzung und führe claude in einem neuen Terminal aus.

Das Bestätigungsfenster von CC Switch: Überprüfe vor dem Importieren den Endpunkt und das Modell. Der Schlüssel ist in diesem Screenshot maskiert.

Bei jeder Einrichtung mit einem Klick wird ein neuer Schlüssel erstellt; ein vorhandener Schlüssel kann nicht wiederverwendet werden. Vorhandene Schlüssel bleiben unverändert. Deine vorherige Agentenkonfiguration bleibt in CC Switch verfügbar.

Aktive Verbindung überprüfen

Sende im neu gestarteten Agenten eine kurze Nachricht und prüfe, ob er antwortet.
Führe in Claude Code /status aus und vergleiche das Modell mit deiner Auswahl. Verwende bei anderen Agenten die entsprechende Statusansicht.
Prüfe auf der Webseite API keys, ob die Zeitangabe Last used des neuen Schlüssels aktualisiert wird.

Wenn weiterhin das alte Modell aktiv ist, schließe die alte Sitzung und starte den Agenten neu. Wenn der Browser CC Switch nicht geöffnet hat, prüfe die Bestätigungsaufforderung neben der Adressleiste, öffne CC Switch und wähle erneut Open aus. Spätere Modelländerungen kannst du in CC Switch vornehmen, ohne die Einrichtung zu wiederholen.

Zurückwechseln oder Zugriff widerrufen

Suche in CC Switch nach der vorherigen Konfiguration des Agenten und aktiviere sie, um zurückzuwechseln. Durch das Entfernen einer CC-Switch-Konfiguration wird der API Key nicht deaktiviert. Widerrufe den Schlüssel auf der Webseite API keys, wenn er nicht mehr funktionieren soll.

Prüfe auf der Kontoseite deinen aktuellen Tarif und die Modellverfügbarkeit. Im Tutorial zur Einrichtung eines Agenten mit einem Klick findest du die vollständige Aufzeichnung und Screenshots. Informationen zur Kontoeinrichtung findest du unter Abonnements und Abrechnung.

Nutzen API-Aufrufe dieselben App-Guthaben?

Ja. Reguläre API-Aufrufe teilen sich die Tarifkontingente und Nutzungszeiträume mit der App. Das Erstellen eines weiteren Schlüssels oder der Wechsel zwischen Agenten setzt sie nicht zurück. Für Aktionsguthaben können separate Bedingungen zur API-Nutzung gelten. Weitere Informationen findest du unter Guthaben und Nutzung.

Öffne die Cloud-Konsole, um Schlüssel und Nutzung zu verwalten. Tools wie Zcode, die einen benutzerdefinierten Modellendpunkt und Schlüssel akzeptieren, können für das entsprechende API-Protokoll konfiguriert werden. Das bedeutet nicht, dass OpenDesign dieses Tool als integrierten lokalen Agenten starten kann.

Anfragen mit Bildern überschreiten das Größenlimit

Laut den aktuellen Supporthinweisen gilt für den gesamten Body einer API-Anfrage ein Limit von 50 MiB. Es gilt für den gesamten Body, nicht für jedes einzelne Bild; auch die Bildkodierung erhöht die Größe. Reduziere die Anzahl oder Abmessungen der Bilder und versuche es erneut mit einer kleinen Anfrage. Wenn sie weiterhin fehlschlägt, teile dem Support den Antwortstatus, die Anfragezeit und das Modell mit, ohne deinen Schlüssel offenzulegen.