CLI-Referenz

Allgemeine Verwendung

claudex [OPTIONS] [COMMAND]

Option	Beschreibung
`--config <PATH>`	Konfigurationsdateipfad ueberschreiben
`--version`	Version ausgeben
`--help`	Hilfe ausgeben

Ohne Befehl startet Claudex das TUI-Dashboard, wenn Profile konfiguriert sind, oder zeigt eine Willkommensnachricht, wenn keine Profile vorhanden sind.

Befehle

`run`

Claude Code mit einem bestimmten Anbieterprofil ausfuehren.

claudex run <PROFILE> [PROMPT] [OPTIONS] [-- ARGS...]

Argument / Option	Beschreibung
`PROFILE`	Profilname oder `auto` fuer intelligentes Routing
`PROMPT`	Optionaler Prompt fuer nicht-interaktive (einmalige) Ausfuehrung
`-m, --model MODEL`	Standardmodell fuer diese Sitzung ueberschreiben
`--hyperlinks`	OSC-8-Terminal-Hyperlinks erzwingen
`--print`	Antwort ausgeben und beenden (nicht-interaktiver Modus)
`--dangerously-skip-permissions`	Alle Berechtigungsabfragen ueberspringen (mit `--print` fuer CI/CD verwenden)
`ARGS...`	Zusaetzliche Argumente, die an `claude` uebergeben werden (nach `--`)

# Grok verwenden (interaktiv)
claudex run grok

# Grok mit einem bestimmten Modell verwenden
claudex run grok -m grok-3-mini-beta

# Intelligentes Routing
claudex run auto

# Terminal-Hyperlinks erzwingen
claudex run grok --hyperlinks

# Nicht-interaktive einmalige Ausfuehrung
claudex run grok "Explain this codebase" --print

# CI/CD-Pipeline-Verwendung (keine Abfragen, keine Berechtigungen)
claudex run grok "Fix lint errors" --print --dangerously-skip-permissions

# Zusaetzliche Argumente an claude uebergeben
claudex run grok -- --verbose

`profile`

Anbieterprofile verwalten.

`profile list`

claudex profile list

Alle konfigurierten Profile mit Status, Anbietertyp und Modell auflisten.

`profile add`

claudex profile add

Interaktiver Assistent zum Hinzufuegen eines neuen Profils. Fuehrt durch Anbieterauswahl, API-Schluessel-Eingabe (mit optionaler Schluesselbund-Speicherung), Modellauswahl und Konnektivitaetstests.

`profile show`

claudex profile show <NAME>

Details fuer ein bestimmtes Profil einschliesslich aller Konfigurationsfelder anzeigen.

`profile remove`

claudex profile remove <NAME>

Ein Profil aus der Konfiguration entfernen.

`profile test`

claudex profile test <NAME|all>

Konnektivitaet fuer ein bestimmtes Profil oder alle Profile testen. Sendet eine leichte Anfrage an den /models-Endpunkt des Anbieters.

`auth`

OAuth-Abonnement-Authentifizierung fuer Anbieterprofile verwalten.

`auth login`

claudex auth login <PROVIDER> [OPTIONS]

Option	Beschreibung
`--profile <NAME>`	Mit einem bestimmten Profil verknuepfen
`--enterprise-url <URL>`	Benutzerdefinierte Enterprise-Server-URL (fuer selbst-gehostetes GitLab usw.)
`--headless`	Headless-Flow (Device Code) verwenden, Browser-Start ueberspringen

Bei einem Anbieter ueber OAuth anmelden. Unterstuetzte Anbieter: claude, openai, google, qwen, kimi, github, gitlab.

# Bei OpenAI anmelden (liest aus Codex CLI)
claudex auth login openai --profile codex-sub

# Bei Claude anmelden (liest aus ~/.claude)
claudex auth login claude

# Bei Google anmelden
claudex auth login google --profile gemini-sub

# Bei GitLab mit Enterprise-URL anmelden
claudex auth login gitlab --enterprise-url https://gitlab.mycompany.com

# Headless-Modus (kein Browser, nur Device Code)
claudex auth login github --headless

`auth status`

claudex auth status [PROVIDER]

Aktuellen Authentifizierungsstatus anzeigen. Ohne Anbieter-Argument wird der Status aller konfigurierten OAuth-Profile angezeigt.

# Alle OAuth-Profile pruefen
claudex auth status

# Einen bestimmten Anbieter pruefen
claudex auth status openai

`auth refresh`

claudex auth refresh <PROVIDER>

OAuth-Token fuer einen Anbieter manuell aktualisieren. Token werden auch automatisch vom Proxy aktualisiert, wenn sie ablaufen.

`auth logout`

claudex auth logout <PROVIDER>

Gespeicherte OAuth-Token fuer einen Anbieter aus dem System-Schluesselbund entfernen.

`proxy`

Den Uebersetzungsproxy-Server verwalten.

`proxy start`

claudex proxy start [OPTIONS]

Flag	Beschreibung
`-p, --port PORT`	Proxy-Port ueberschreiben (Standard: aus Konfiguration)
`-d, --daemon`	Als Hintergrund-Daemon ausfuehren

`proxy stop`

claudex proxy stop

Den Proxy-Daemon stoppen (sendet SIGTERM ueber PID-Datei).

`proxy status`

claudex proxy status

Anzeigen, ob der Proxy laeuft und auf welchem Port.

`dashboard`

claudex dashboard

Das TUI-Dashboard fuer Echtzeit-Ueberwachung und Schnellstart starten.

`config`

Konfigurationsdateien verwalten.

`config show`

claudex config show

Geladenen Konfigurationsdateipfad, Suchreihenfolge und aktuelle Konfigurationswerte anzeigen.

`config path`

claudex config path

Nur den aufgeloesten Konfigurationsdateipfad ausgeben.

`config init`

claudex config init

Neue Konfigurationsdatei im aktuellen Verzeichnis aus der eingebauten Vorlage erstellen.

`config recreate`

claudex config recreate

Konfigurationsdatei aus config.example.toml neu erstellen, vorhandene Konfiguration ueberschreiben.

`config edit`

claudex config edit

Konfigurationsdatei im $EDITOR (oder $VISUAL) oeffnen.

`config validate`

claudex config validate

Konfigurationssyntax, Profilverweise (backup_providers, Router-Regeln) und OAuth-Anbieter-Einstellungen validieren. Gibt Fehler und Warnungen aus.

`config get`

claudex config get <KEY>

Einen bestimmten Konfigurationswert nach Schluesselpfad abfragen (z.B. proxy_port, profiles.0.name).

`config set`

claudex config set <KEY> <VALUE>

Einen bestimmten Konfigurationswert nach Schluesselpfad setzen.

`config export`

claudex config export

Aktuelle zusammengefuehrte Konfiguration nach stdout im TOML-Format exportieren.

`sets`

Konfigurationssets verwalten (installierbare Pakete aus Regeln, Skills und MCP-Servern).

`sets add`

claudex sets add <PATH>

Ein Konfigurationsset aus einem lokalen Verzeichnis mit einer manifest.json (oder manifest.yaml) installieren.

`sets remove`

claudex sets remove <NAME>

Ein installiertes Konfigurationsset nach Namen entfernen.

`sets list`

claudex sets list

Alle installierten Konfigurationssets mit Version, Beschreibung und Komponentenuebersicht auflisten.

`sets update`

claudex sets update <NAME> <PATH>

Ein vorhandenes Konfigurationsset aus einem neuen Manifest-Pfad aktualisieren.

`sets show`

claudex sets show <NAME>

Detaillierte Informationen ueber ein installiertes Konfigurationsset einschliesslich aller Komponenten anzeigen.

`update`

claudex update [OPTIONS]

Flag	Beschreibung
`--check`	Nur auf Updates pruefen, nicht installieren

Ohne --check wird die neueste Version von GitHub Releases heruntergeladen und installiert.