Home → Guides → Claude Desktop und Codex auf APICLAN umstellen

Claude Desktop und Codex auf APICLAN umstellen

Desktop-Anwendungen haben in ihren eigenen Einstellungen kein Feld für eine Base-URL. CC Switch schreibt diese Konfiguration für dich. Hier steht, was genau einzutragen ist — und welche zwei Dinge fast jede fehlgeschlagene Einrichtung erklären.

Bevor du anfängst

Du brauchst ein Konto mit Guthaben und einen API-Schlüssel. Lege ihn in der Konsole unter „API-Schlüssel“ an: Wähle die Anbieterfamilie, die du aufrufen willst — Anthropic für Claude Desktop, OpenAI für Codex — und danach die Schlüsselgruppe, von der abgerechnet wird. Die Gruppe bestimmt deinen Satz; was die einzelnen Modelle kosten, steht auf der Preisseite.

Ein Schlüssel gehört zu genau einer Gruppe. Ein Schlüssel für Textmodelle kann keine Bildmodelle aufrufen und umgekehrt; das kommt als 404 auf das Modell zurück, nicht als Berechtigungsfehler. Brauchst du beides, lege zwei Schlüssel an. Was ein bestimmter Schlüssel aufrufen darf, sagt dir immer GET /v1/models, mit genau diesem Schlüssel gesendet.

Die Adresse und die /v1-Regel

Jede Anfrage muss auf einem Pfad ankommen, der mit /v1 beginnt. Ob du /v1 selbst einträgst, hängt vom Client ab: manche hängen es selbst an, andere nicht. Dieses eine Detail steckt hinter den meisten Meldungen, dass „nichts verbindet“.

Client	Einzutragende Anfrageadresse
Claude Desktop (via CC Switch)	https://apiclan.us/v1
Codex / ChatGPT desktop app	https://apiclan.us/v1
OpenAI SDK, Cherry Studio, Chatbox, LobeChat, LM Studio	https://apiclan.us/v1
Cursor, Cline, Roo Code	https://apiclan.us/v1
Claude Code	https://apiclan.us
Anthropic SDK	https://apiclan.us

Vertauscht führt die Anfrage zu einem 404 am Rand des Netzes — sie erreicht das Gateway also nie und taucht in deinem Nutzungsprotokoll nicht auf. Ein leeres Protokoll ist damit selbst das Symptom. Lass niemals einen Schrägstrich am Ende stehen.

Codex steckt inzwischen in der ChatGPT-Desktop-App

Codex wurde in die ChatGPT-Desktop-Anwendung integriert. Unter Windows installierst du ChatGPT aus dem Microsoft Store, unter macOS lädst du es von der OpenAI-Website. Für das Kommandozeilen-Codex gelten dieselben Einstellungen.

Lege in CC Switch einen Anbieter für Codex an, füge deinen Schlüssel ein und trage als Anfrageadresse https://apiclan.us/v1 ein. Aktiviere den Anbieter, beende Codex vollständig — das Fenster zu schließen reicht nicht — und starte es neu. Die Konfiguration wird nur beim Start gelesen; eine laufende Instanz behält die alten Einstellungen, und es sieht aus, als wäre nichts passiert.

Wenn du die Konfigurationsdatei lieber von Hand bearbeitest, stehen Base-URL und die Stelle für den Schlüssel in unserem Schnellstart.

Die Claude-Desktop-App

Installiere Claude Desktop von claude.com und richte den Anbieter dann in CC Switch ein:

1. CC Switch öffnen, das Ziel „Claude Desktop“ wählen und einen neuen Anbieter hinzufügen.
2. Einen beliebigen Namen vergeben und den APICLAN-Schlüssel ins Feld API Key einfügen.
3. Als Anfrageadresse https://apiclan.us/v1 eintragen — der Client hängt /messages selbst an. Kein Schrägstrich am Ende.
4. Speichern, Claude Desktop starten und ein Modell auswählen.

Wenn CC Switch dir die Wahl zwischen Direktverbindung und Modellzuordnung lässt, lies erst den nächsten Abschnitt. Diese Einstellung entscheidet darüber, ob die Modellauswahl überhaupt funktioniert.

Wenn die Modellauswahl einen Gateway-Fehler meldet

Ein Hinweis, die Verbindung funktioniere, der Anbieter habe die Anfrage aber abgelehnt, betrifft fast immer den Modellnamen und nicht den Schlüssel. Die Desktop-App sendet ihre eigenen, fest eingebauten Modellkennungen, und ein Gateway kann nur die Modelle liefern, die seine Upstream-Konten tatsächlich anbieten.

Die Lösung ist Modellzuordnung statt Direktverbindung: Ordne die Einträge der App den Namen zu, die dieses Gateway bedient. Eine Direktverbindung funktioniert nur, wenn der Anbieter genau die Kennungen akzeptiert, die die App sendet.

Sende GET /v1/models mit deinem Schlüssel, um die Liste zu bekommen, auf die du zuordnen kannst. Diese Liste entsteht aus der Gruppe deines Schlüssels — sie ist also die tatsächliche Antwort für dein Konto und kein allgemeiner Katalog.

Zurück zum offiziellen Konto

Nichts wird dauerhaft überschrieben. Aktiviere in CC Switch wieder den offiziellen Anbieter und starte den Client neu — die Desktop-App nutzt dann wieder dein Abo. Du kannst beides eingerichtet lassen und jederzeit wechseln: Das Guthaben hier ist vorausbezahlt und verfällt nicht, eine ungenutzte Konfiguration kostet also nichts.

Wenn es immer noch nicht läuft

• Ein 404 und nichts im Nutzungsprotokoll — die Adresse stimmt nicht. Sieh in der Tabelle oben nach, ob dieser Client /v1 braucht, und entferne einen Schrägstrich am Ende.
• Ein 401 — der Schlüssel kommt nicht in der Anfrage an. Füge ihn erneut ein; er ist lang, und eine unvollständige Kopie scheitert genauso wie ein falscher Schlüssel.
• Ein Modell schlägt fehl, während andere mit demselben Schlüssel laufen — dieses Modell liegt in einer anderen Gruppe. Lege einen zweiten Schlüssel mit der richtigen Gruppe an; an den Berechtigungen zu drehen hilft nicht.

Kommst du nicht weiter? Schreib an support@apiclan.us mit dem Modellnamen, der fehlschlug, und ungefähr wann du es versucht hast. Ein Mensch liest mit.

Start using it

No subscription, no monthly minimum, no sales call. Top up with USDT and spend what you use — 1 USDT gives you 2 credits of API balance.

Read the 30-second quickstart

Prices quoted on this page are regenerated automatically from live billing data. Third-party terms are quoted from that party's own published documentation.