Tutorial für Einsteiger: Codex reibungslos in China nutzen – getestet und effektiv

Hallo zusammen, ich bin Cang He.

Seit CodexGuide vorgestern online gegangen ist, explodiert das Backend.

Die am häufigsten gestellte Frage ist: Wie verwende ich Codex in China? Kann ich es ohne ein Plus-Abonnement nutzen?

Um ehrlich zu sein, diesen Schmerz verstehe ich gut.

Ein Plus-Abo zu haben, bringt seine eigenen Hürden mit sich, und man muss sich noch um die Zahlungsmethoden kümmern – das ist anstrengend.

Also habe ich zwei Tage damit verbracht, jede online verfügbare Lösung zu testen, bin auf viele Hürden gestoßen und habe schließlich die drei zuverlässigsten Zugangsmethoden zusammengefasst.

Ich teile sie heute alle mit euch – einfach den Schritten folgen.

Das Tutorial ist auch auf CodexGuide live und jederzeit einsehbar.

Wenn ihr bedenkt, wie viel Arbeit ich hier reingesteckt habe, gebt mir doch einen Stern, hahaha.

Zunächst eine Voraussetzung: Der stabilste Weg, Codex zu nutzen, ist immer noch die Anmeldung mit einem offiziellen GPT-Konto.

Die Verbindung zu einer Drittanbieter-API ist eine fortgeschrittene Operation; ihr müsst wissen, was config.toml, API Key und Base URL sind.

Wenn ihr das nicht wisst, ist das in Ordnung – folgt einfach den nachstehenden Schritten.

So wählt ihr zwischen den drei Varianten

Hier ist eine Tabelle, die euch hilft, die richtige Wahl zu treffen:

Ehrlich gesagt, wenn ihr Anfänger seid, schaut euch einfach Variante 2 an; sie ist am sorgenfreiesten.

Wenn ihr gerade erst anfangt, Codex zu lernen, empfehle ich, zuerst mein vorheriges Codex-Einsteiger-Tutorial anzusehen, bevor ihr euch mit Drittanbieter-APIs beschäftigt.

Variante 1: Manuelle Konfiguration

Diese Methode hat einen Nachteil: Ihr könnt die Plugin-Funktion der Codex-App nicht nutzen.

Wenn ihr Plugins verwenden wollt, überspringt diesen Teil und geht direkt zu Variante 2.

Der Kern der manuellen Konfiguration ist das Ändern einer Datei:

Vor dem Ändern sichert sie – entwickelt gute Gewohnheiten:

Zwei Anmeldemethoden

Ein Tipp: Ändert nicht zu viele Dinge auf einmal. Fügt zuerst nur einen Anbieter hinzu, und sobald es funktioniert, beschäftigt euch mit mehreren Konfigurationen.

Beispiel für GPT-Anmeldestatus

Das bedeutet, dass euer Codex zuerst in ein GPT-Konto eingeloggt sein muss.

Schritt 1: Konfigurationsdatei ändern:

Öffnet ~/.codex/config.toml und fügt die folgende Konfiguration hinzu.

Hinweis: Füllt die Felder und Werte entsprechend eurem tatsächlichen Dienst aus:

Ein paar häufige Fallstricke:

• model_provider muss exakt mit dem xxx in [model_providers.xxx] übereinstimmen; kein Buchstabe darf abweichen.
• base_url sollte nur bis /v1 gehen; fügt nicht das gesamte /v1/responses-Segment hinzu.
• wire_api = "responses" bedeutet, dass im Responses-API-Format angefordert wird; ändert es nicht.
• requires_openai_auth = false bedeutet, dass der offizielle Anmeldestatus nicht verwendet wird.

Schritt 2: Umgebungsvariablen setzen

Öffnet das Terminal und gebt ein:

Schritt 3: Codex-App vom Terminal aus starten

Hier gibt es einen Haken: Mac-Benutzer müssen vom Terminal aus starten; ein direkter Klick auf das Symbol könnte das Modell nicht lesen.

Schließt die Codex-App vollständig, bevor ihr startet, und gebt dann im Terminal ein:

Schritt 4: Wirkung überprüfen

Öffnet die Codex-App, und ihr werdet sehen, dass das Modell erfolgreich gewechselt wurde:

Meine Güte, es hebt ab.

Beispiel für API-Key-Anmeldung

Wenn ihr die API-Key-Methode verwendet, denkt an ein Prinzip: Steckt den geheimen Schlüssel in Umgebungsvariablen, nicht direkt in die Konfigurationsdatei.

Entsprechende config.toml-Konfiguration:

Ein wichtiger Hinweis: Wenn euer Upstream nur Chat Completions und nicht die Responses API unterstützt, reicht eine einfache Konfigurationsänderung nicht aus; ihr benötigt ein Gateway wie CCX für die Protokollkonvertierung. Darauf wird in Variante 3 eingegangen.

Authentifizierungsdatei ändern

Öffnet ~/.codex/auth.json und ändert OPENAI_API_KEY in den Key eures Modellanbieters:

So überprüft ihr den Konfigurationserfolg

Überstürzt nichts nach der Konfiguration; überprüft zuerst:

1. Beendet Codex vollständig und öffnet es erneut.
2. Lasst es eine schreibgeschützte Aufgabe ausführen, z. B. die Zusammenfassung der aktuellen Verzeichnisstruktur.
3. Wenn ein Fehler auftritt, überprüft zuerst den Namen des model_provider, die base_url und die Umgebungsvariablen.
4. Wenn ein Authentifizierungsfehler auftritt, wechselt zuerst zur Backup-Konfiguration zurück; keine Panik.

Variante 2: Codex++

Wenn ihr die manuelle Konfiguration zu umständlich findet, schaut euch Codex++ an.

Es ist ein grafisches Verwaltungstool, das euch hilft, Relay-Konfigurationen mit einem Klick zu erledigen, ohne manuell Toml-Dateien schreiben zu müssen.

Außerdem unterstützt es Plugin-Funktionen, was Variante 1 nicht kann.

Geeignet für diese Personen:

• Diejenigen, die hauptsächlich die Codex-Desktop-App nutzen.
• Diejenigen, die keine Konfigurationsdateien manuell schreiben wollen.
• Diejenigen, die jederzeit zum offiziellen Modus zurückwechseln wollen.

Installationsschritte

1. Öffnet die Codex++-Releases und ladet das Installationspaket herunter.

Ihr werdet zwei Installationspakete sehen: "Codex++ Management Tool" und "Codex++ App"; installiert beide.

1. Öffnet nach der Installation das "Codex++ Management Tool".

Wenn beim ersten Öffnen dieser Fehler auftritt, keine Panik:

Geht zu "Systemeinstellungen" - "Datenschutz & Sicherheit" und klickt auf "Trotzdem öffnen":

Nach dem Öffnen gelangt ihr zur Verwaltungsoberfläche:

Installiert die Codex++-App auf die gleiche Weise; es ist korrekt, wenn die Erkennung des Verwaltungstools komplett grün ist:

Bestätigt, dass der GPT-Anmeldestatus erkannt wird.

1. Fügt die Relay-Konfiguration hinzu.

Wählt "Anbieterkonfiguration" - Anbieter hinzufügen und füllt eure Base URL und euren Key aus.

Hinweis: Wählt "Pure API" für die Zugriffsmethode:

Die Modellliste kann automatisch vom Upstream bezogen werden; wenn ihr eine Relay-Station konfiguriert, gibt es hier viele Modelle zur Auswahl:

Im Grunde hilft euch dieses Tool, Konfigurationen bequemer zu schreiben und erspart euch das manuelle Bearbeiten von Dateien:

Testet nach dem Speichern die Konnektivität; wenn es keine Probleme gibt, verwendet es direkt:

1. Startet Codex vom Codex++-Einstiegspunkt aus.

Hinweis: Startet von Codex++ aus, nicht vom original Codex:

Nach dem Neustart werdet ihr sehen, dass Codex bereits den benutzerdefinierten Modellanbieter verwendet und die Anzahl der wählbaren Modelle plötzlich gestiegen ist:

Plugins können auch direkt verwendet werden; das ist das vollständige Erlebnis:

Ihr müsst zugeben, diese Variante ist die reibungsloseste, die ich bisher verwendet habe; sehr empfehlenswert.

Was, wenn ich zurückwechseln möchte?

• Löscht den API-Modus im Verwaltungstool und wechselt zurück zur offiziellen Konfiguration.
• Wenn Codex++ nach einem Codex-Update nicht mehr funktioniert, wartet einfach auf die Anpassung; es beeinträchtigt nicht die Nutzung der Originalversion.

Variante 3: CCX + CC Switch

Diese Variante ist für Power-User gedacht und trennt das "Gateway" und das "Wechselwerkzeug":

• CCX: API-Proxy-Gateway, verantwortlich für Protokollkonvertierung und Routing. Unterstützt verschiedene Einstiegspunkte wie Claude, OpenAI, Codex, Gemini usw.
• CC Switch: Desktop-Verwaltungstool, mit einem Klick zwischen verschiedenen Anbieterkonfigurationen wechseln.

Wann verwendet man diese Variante? Wenn ihr mehrere inländische Modell-APIs, mehrere Relay-Dienste, mehrere Keys habt oder wenn der Upstream nur Chat Completions unterstützt und eine Konvertierung zur Responses API benötigt wird.

Schritt 1: CCX bereitstellen

Verwendet Docker mit einem einzigen Befehl:

Nach dem Start könnt ihr es sehen, indem ihr den Browser öffnet.

Schritt 2: Upstream-Kanäle hinzufügen

Fügt eure Kanäle in der CCX-Verwaltungsoberfläche hinzu:

1. Wählt den Upstream-Diensttyp aus.
2. Füllt den API-Key und die Base URL aus.
3. Konfiguriert die Modellzuordnung und die Routing-Regeln.
4. Verwendet die integrierte Testfunktion, um die Konnektivität zu bestätigen.

Es gibt einen entscheidenden Punkt hier: Codex benötigt einen Responses-API-Einstiegspunkt. Wenn der Upstream nur Chat Completions hat, führt CCX die Protokollkonvertierung für euch durch – das ist der Hauptgrund, es zu verwenden.

Schritt 3: CC Switch installieren

Befehlszeileninstallation:

Initialisierung:

Während der Initialisierung die CCX-Adresse als Relay-Einstiegspunkt angeben.

Schritt 4: Konfiguration wechseln und starten

Einzeiliger Befehl zum Wechseln des Anbieters:

Startet dann Codex neu, damit die Änderung wirksam wird.

Nach dem Wechsel wird empfohlen, ~/.codex/config.toml zu öffnen und zu überprüfen:

• Ist model_provider das, was ihr gerade ausgewählt habt?
• Zeigt base_url auf CCX?
• Habt ihr versehentlich den Key in ein öffentliches Repository geschrieben (das ist sehr wichtig)?

Zusammenfassung der häufigsten Fallstricke

Abschließend gibt es eine Fehlerbehebungstabelle; überprüft sie zuerst, wenn ihr auf Probleme stoßt:

Um ehrlich zu sein, ich habe alle drei Varianten erfolgreich ausgeführt, aber für den täglichen Gebrauch verwende ich am meisten Variante 2, Codex++; sie ist sorgenfrei.

Wenn ihr der Typ Power-User mit mehreren Keys und mehreren Anbietern seid, ist Variante 3 besser für euch geeignet.

So, das war's für heute.

Wenn euch dieses Tutorial geholfen hat, lasst mir ein Like da, damit ich es weiß, und ich werde in Zukunft weitere praktische Codex-Tipps veröffentlichen.

Wenn ihr Fragen habt, stellt sie direkt im Kommentarbereich; ich werde auf alles antworten, was ich sehe.