Claudex: GPT-5.6 Sol mit CLIProxyAPI in Claude Code nutzen

Ja, du kannst GPT-5.6 Sol als Modell in der Claude-Code-CLI nutzen. Claude Code bleibt der Agent-Harness, der dein Repository liest, Arbeit plant, Tools aufruft und Subagents koordiniert. Dazwischen übersetzt CLIProxyAPI die Anfrage im Anthropic-Format und leitet sie über deinen Codex-Login an OpenAI weiter. Die Community nennt diese Kombination Claudex.

Der virale Vierzeiler ist nicht das Setup. Er wählt nur ein Modell, nachdem das Gateway bereits installiert, authentifiziert und verbunden wurde. Ohne ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN hat Claude Code keinen Grund, Anfragen an CLIProxyAPI zu senden.

Hier bekommst du die fehlende Verbindung, eine sicherere localhost-Konfiguration, einen Test an jeder Grenze und einen Alias, der normales claude nicht verändert. Fakten und Befehle wurden am 26. Juli 2026 geprüft.

Was Claudex ist, und was nicht

Der Quellcode von CLIProxyAPI liegt auf GitHub, das Projekt gehört aber weder zu Anthropic noch zu OpenAI. Anthropic dokumentiert kompatible Gateways, unterstützt das Routing von Claude Code zu Nicht-Claude-Modellen jedoch nicht. Technisch möglich ist nicht dasselbe wie offiziell unterstützt.

Diese Seite beantwortet die Setup-Frage. Für eine Kaufentscheidung gibt es unseren Kostenvergleich Claude Code vs OpenCode. Für Produktionsinfrastruktur gibt es den Vergleich von LLM-Gateways. So bleibt die Suchintention jeder Seite eindeutig.

Dauert das wirklich zwei Minuten?

Wenn Homebrew, Claude Code und ein berechtigter Codex-Account bereitstehen, dauern die Befehle nur wenige Minuten. Das erste sichere Setup braucht oft länger, weil du Config, Client-Key, Browser-OAuth und Modellliste prüfen solltest. Diese Checks sind wichtiger als ein schneller Screenshot.

1. CLIProxyAPI unter macOS installieren

brew install cliproxyapi
brew services start cliproxyapi

Das sind die aktuellen Befehle aus dem CLIProxyAPI Quick Start. Homebrew nutzt normalerweise $(brew --prefix)/etc/cliproxyapi.conf. Prüfe den aktiven Pfad, bevor du eine andere Kopie änderst.

2. Nur an localhost binden und einen Client-Key setzen

Die Beispielkonfiguration lässt host leer und bindet damit alle IPv4- und IPv6-Interfaces. Ein persönlicher Proxy mit OAuth-Zugangsdaten sollte nur auf 127.0.0.1 lauschen:

host: "127.0.0.1"
port: 8317

remote-management:
  allow-remote: false
  secret-key: ""

api-keys:
  - "claudex-REPLACE-WITH-A-LONG-RANDOM-SECRET"

Erzeuge den Wert lokal mit openssl rand -hex 32 und kopiere ihn weder ins Repository noch in Tickets oder Screenshots. Die offizielle Konfigurationsreferenz dokumentiert Adresse, Port, Auth-Verzeichnis und API-Keys.

brew services restart cliproxyapi

3. Deinen Codex-Account verbinden

cliproxyapi --codex-login

Jetzt öffnet sich OpenAI OAuth im Browser. Auf einem Headless-System dokumentiert die Codex-OAuth-Anleitung --no-browser und einen lokalen Callback auf Port 1455. Wähle den Workspace, dessen Codex-Kontingent du wirklich nutzen willst.

CLIProxyAPI speichert Authentifizierungsmaterial im konfigurierten Auth-Verzeichnis, meist ~/.cli-proxy-api. Halte es aus Git fern, schütze deinen Rechner-Account und aktualisiere den Proxy zeitnah. Prüfe vor der Nutzung eines Abos durch einen Drittclient die aktuellen Produktregeln und Provider-Bedingungen selbst.

4. Den Proxy vor Claude Code prüfen

curl -sS http://127.0.0.1:8317/v1/models \
  -H "Authorization: Bearer claudex-REPLACE-WITH-A-LONG-RANDOM-SECRET"

Mach erst weiter, wenn die JSON-Antwort gpt-5.6-sol enthält. OpenAI nennt genau diese Modell-ID, 1,05 Millionen Token Kontext, maximal 128.000 Output-Token und Reasoning von none bis max auf der Modellseite zu GPT-5.6 Sol. Zugriff kann trotzdem von Plan und Rollout abhängen.

Bei 401 stimmen Client-Key und api-keys-Eintrag nicht überein. Fehlt das Modell, aktualisiere CLIProxyAPI, prüfe OAuth und teste zuerst natives Codex. Ein Alias kann keinen Modellzugang erzeugen.

5. Den vollständigen Claudex-Alias setzen

Füge das in ~/.zshrc ein, ersetze den Key und öffne danach eine neue Shell:

alias claudex='ANTHROPIC_BASE_URL=http://127.0.0.1:8317 \
ANTHROPIC_AUTH_TOKEN=claudex-REPLACE-WITH-A-LONG-RANDOM-SECRET \
CLAUDE_CODE_SUBAGENT_MODEL=gpt-5.6-sol \
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=3 \
ENABLE_TOOL_SEARCH=auto:5 \
claude --model gpt-5.6-sol'

Starte claudex, sende eine kleine Testanfrage und führe /status aus. Laut Claude-Code-Gateway-Anleitung muss der Status die eigene Base URL und Token-Quelle zeigen. Normales claude bleibt unverändert, weil die Variablen nur im Alias gelten.

Warum dieser Alias vom viralen Snippet abweicht

Die Tool-Search-Dokumentation sagt: Eine fremde ANTHROPIC_BASE_URL führt normalerweise zu Eager Loading. auto:5 aktiviert Deferred Discovery explizit, wenn Tool-Schemas mehr als fünf Prozent des Kontexts belegen. Nur wenn CLIProxyAPI Beta-Header oder tool_reference ablehnt, ist false der richtige Fallback.

Reasoning Effort ohne versteckten Flag

GPT-5.6 Sol unterstützt none, low, medium, high, xhigh und max. CLIProxyAPI dokumentiert Suffixe wie gpt-5.6-sol(high) und übersetzt sie in OpenAI-Reasoning-Parameter:

claude --model 'gpt-5.6-sol(high)'

Starte mit medium oder high und miss Kosten pro akzeptiertem Task. Mehr Reasoning kann mehr Kontingent verbrauchen und zusätzliche Tool-Aufrufe auslösen. Unsere Analyse zu Kosten pro Token und pro erledigter Aufgabe erklärt, warum der tiefste einzelne Call nicht automatisch die günstigste akzeptierte Änderung liefert.

Wird GPT-5.6 Sol in Claude Code besser?

Das Modell ändert sich nicht. Der Harness ändert sich. Claude Code entscheidet, welchen Repository-Kontext es liest, wie Tools angeboten werden, wann delegiert wird und wie Ergebnisse zurückkommen. GPT-5.6 Sol erzeugt Entscheidungen und Ausgaben in diesem Loop. Entwickler können die Kombination wegen der Orchestrierung bevorzugen, nicht weil der Proxy OpenAIs Modellgewichte verbessert.

Vergleiche natives Codex, natives Claude Code und Claudex auf demselben Commit, mit denselben Tests, Berechtigungen, Effort-Stufen und Review-Grenzen. Unser Coding-Playbook für Claude Fable zeigt die Alternative, bei der Claude auch das Urteilsmodell bleibt.

Fehler schnell eingrenzen

• Claude bleibt aktiv: Prüfe /status, lade ~/.zshrc neu und suche überschreibende Settings.
• 401: ANTHROPIC_AUTH_TOKEN muss einem lokalen api-keys-Eintrag entsprechen.
• Unknown model: Frage /v1/models ab und nutze exakt die zurückgegebene ID.
• Tool Search liefert 400: Setze vorübergehend ENABLE_TOOL_SEARCH=false und teste nach Proxy-Updates erneut.
• Compaction wirkt falsch: Beobachte /context. Ändere Kontextannahmen nur in einer Wegwerf-Session.

Wann Claudex passt, und wann nicht

Claudex passt für einen reversiblen persönlichen Vergleich, wenn du lokale OAuth-Speicherung und Proxy-Wartung verstehst, Ergebnisse mit Tests und Diffs verifizierst und fehlenden Anthropic-Support akzeptierst.

Nutze dieses Setup nicht als stillen Unternehmensstandard, wenn du Kundencode, regulierte Daten oder Secrets verarbeitest oder zentrale Sperrung, Audit-Logs, Nutzerzuordnung, Budgets und einen Incident Owner brauchst. Ein lokaler Abo-Proxy ist kein Produktions-API-Vertrag.

Für Teams reicht ein Shell-Alias nicht. Ergänze Zugänge pro Nutzer, zentrale Config, Secret-Management, Version-Pinning, Modell-Allowlist, Budgets, redigierte Logs, Update-Verantwortung und Rollback. Wenn du dieses Betriebsmodell brauchst, kann Wavect mit KI-Enablement und KI-Architektur Gateway, Evaluation und Governance mit deinem Team aufsetzen.

Primärquellen und Aktualitätsgrenze

Geprüft am 26. Juli 2026. Prüfe vor der Nutzung erneut die OpenAI-Modellseite, die OpenAI-Verfügbarkeit, die Claude-Code-Gateway-Anleitung, die Umgebungsvariablen-Referenz, den CLIProxyAPI Quick Start, die Codex-OAuth-Anleitung und die Effort-Übersetzung.