Claudex Gateway

Was macht Claudex Gateway?

Übersicht

Verwenden Sie diesen Skill, um den lokalen Claude Code -> Codex OAuth Gateway des Benutzers sicher und konsistent zu betreiben. Behandeln Sie den bereitgestellten Stack unter CLAUDEX_GATEWAY_HOME als Quelle der Wahrheit, es sei denn, der Benutzer bittet explizit um eine Neugestaltung. Für diesen Skill gelten folgende Konventionen:

• SKILL_ROOT: der Installationspfad dieses claudex-gateway Skill-Verzeichnisses
• CLAUDEX_GATEWAY_HOME: das Laufzeitverzeichnis für den lokalen Proxy-Stack. Falls nicht gesetzt, suchen die Hilfsskripte zuerst in ${XDG_DATA_HOME:-$HOME/.local/share}/claudex-gateway und dann im Legacy-Verzeichnis ${XDG_DATA_HOME:-$HOME/.local/share}/cliproxyapi-codex-test
• CLAUDEX_WRAPPER: der claudex Wrapper-Pfad. Falls nicht gesetzt, Standardeinstellung auf ${HOME}/.local/bin/claudex

Schnellstart

• Bootstrappen eines frischen Systems: python3 "$SKILL_ROOT/scripts/bootstrap_stack.py"
• Aktualisieren der lokalen Auth-Datei aus ~/.codex/auth.json: python3 "$SKILL_ROOT/scripts/sync_codex_auth.py"
• Überprüfen des aktuellen Gateway-Status: claudex status
• Neustarten des lokalen Proxys: claudex restart
• Rauchtest des Stacks: python3 "$SKILL_ROOT/scripts/probe_stack.py"
• Starten von Claude Code über den Wrapper: claudex --resume

Workflow

0. Zuerst bootstrappen, wenn der Gateway-Stack noch nicht existiert

• Wenn CLAUDEX_GATEWAY_HOME fehlt, keine Dateien einzeln von Hand erstellen.
• Führen Sie python3 "$SKILL_ROOT/scripts/bootstrap_stack.py" aus, um das Laufzeitverzeichnis, Konfiguration, Launcher, Env-Datei, einen claudex Wrapper mit status/start/stop/restart und ein gebautes cli-proxy-api Binary zu erstellen.
• Das Bootstrap-Skript geht davon aus: codex und claude sind bereits installiert git und go sind für das Klonen und Bauen von CLIProxyAPI verfügbar
• Nach dem Bootstrappen die Authentifizierung synchronisieren und den Proxy starten, bevor irgendetwas anderes debuggt wird.

1. Bestätigen, welcher Pfad verwendet wird

• Gehen Sie vom Arbeitspfad aus: Claude Code -> claudex Wrapper -> CLIProxyAPI -> chatgpt.com/backend-api/codex
• Beginnen Sie nicht mit LiteLLM, wenn der Benutzer nach dem aktuellen claudex Setup fragt.
• Lesen Sie current-stack.md, bevor Sie die Architektur ändern oder Kompromisse erklären.

2. Zuerst Anmeldedaten aktualisieren, wenn das Verhalten veraltet wirkt

• Führen Sie python3 "$SKILL_ROOT/scripts/sync_codex_auth.py" aus
• Dies kopiert die aktuellen Codex OAuth-Token von ~/.codex/auth.json in die Proxy-Auth-Datei: "$CLAUDEX_GATEWAY_HOME/auth/codex-current.json"
• Wenn der Benutzer von Codex abgemeldet ist, zuerst stoppen und neu authentifizieren.

3. Den lokalen Proxy überprüfen, bevor Claude Code berührt wird

• Bevorzugen Sie Wrapper-Befehle gegenüber direkten Runner-Aufrufen: claudex status claudex start claudex restart
• Überprüfen Sie Health, /v1/messages, Tool-Nutzung und Token-Zählung: python3 "$SKILL_ROOT/scripts/probe_stack.py"
• Verwenden Sie rohes run.sh nur beim Debuggen der Wrapper-Generierung selbst.

4. Modell-Routing nur in der Env-Datei ändern, es sei denn, der Benutzer wünscht tiefere Änderungen

• Der Wrapper claudex bezieht sich auf: "$CLAUDEX_GATEWAY_HOME/claude-code-gpt54.env"
• Das aktuelle Mapping wird dort gepflegt.
• Bewahren Sie den Wrapper-Vertrag in CLAUDEX_WRAPPER: zuerst Service-Subcommands ansonsten Env-Quelle und exec "$CLAUDE_BIN" "$@"
• Bewahren Sie immer die direkte Argumentübergabe. claudex --resume muss sich genau wie claude --resume mit injizierter Env verhalten.

5. Nur neu bauen, wenn das bereitgestellte Binary fehlt oder defekt ist

• Das bereitgestellte Binary ist: "$CLAUDEX_GATEWAY_HOME/cli-proxy-api"
• Wenn es neu gebaut werden muss, das Upstream-Repository verwenden: git clone --depth=1 https://github.com/router-for-me/CLIProxyAPI.git /tmp/CLIProxyAPI cd /tmp/CLIProxyAPI && go build -o "$CLAUDEX_GATEWAY_HOME/cli-proxy-api" ./cmd/server
• Die Laufzeitkonfiguration und das Auth-Verzeichnis unverändert lassen, es sei denn, der Benutzer wünscht etwas anderes.

Wichtige Regeln

• Ersetzen Sie CLIProxyAPI nicht durch LiteLLM, um den Stack zu "reparieren", es sei denn, der Benutzer bittet explizit um eine Neugestaltung.
• Ändern Sie nicht stillschweigend Ports, Auth-Datei-Pfade oder Wrapper-Semantik.
• Unterbrechen Sie nicht die claudex-Argumentübergabe.
• Bevorzugen Sie die Bearbeitung der aktuellen bereitgestellten Dateien gegenüber der Erstellung paralleler Varianten.
• Wenn Sie den Stack erklären, machen Sie explizit deutlich, dass der Arbeitspfad chatgpt.com/backend-api/codex verwendet, nicht direkte api.openai.com-Aufrufe.

Ressourcen

scripts/

• bootstrap_stack.py: Erstellt eine neue lokale Gateway-Laufzeitumgebung auf einem frischen System
• sync_codex_auth.py: Aktualisiert die Proxy-Auth-Datei aus ~/.codex/auth.json
• probe_stack.py: Überprüft Health, Claude-Nachrichten, Tool-Nutzung und Token-Zählung
• show_status.sh: Zeigt das aktuelle Datei-Layout, Env-Mapping und Port-Status an

references/

• current-stack.md: Hintergrund, Datei-Layout, Befehle und Fehlerbehebungsnotizen