Reference CLI

Utilisation globale

claudex [OPTIONS] [COMMAND]

Option	Description
`--config <PATH>`	Surcharger le chemin du fichier de config
`--version`	Afficher la version
`--help`	Afficher l’aide

Lorsqu’il est execute sans commande, Claudex lance le tableau de bord TUI si des profils sont configures, ou affiche un message de bienvenue si aucun profil n’existe.

Commandes

`run`

Executer Claude Code avec un profil de fournisseur specifique.

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

Argument / Option	Description
`PROFILE`	Nom du profil, ou `auto` pour le routage intelligent
`PROMPT`	Invite optionnelle pour l’execution non interactive (ponctuelle)
`-m, --model MODEL`	Surcharger le modele par defaut pour cette session
`--hyperlinks`	Forcer l’activation des hyperliens terminaux OSC 8
`--print`	Afficher la reponse et quitter (mode non interactif)
`--dangerously-skip-permissions`	Ignorer toutes les demandes de permission (utiliser avec `--print` pour CI/CD)
`ARGS...`	Arguments supplementaires passes a `claude` (apres `--`)

# Utiliser Grok (interactif)
claudex run grok

# Utiliser Grok avec un modele specifique
claudex run grok -m grok-3-mini-beta

# Routage intelligent
claudex run auto

# Forcer les hyperliens terminaux
claudex run grok --hyperlinks

# Execution non interactive ponctuelle
claudex run grok "Explain this codebase" --print

# Utilisation en pipeline CI/CD (sans invites, sans permissions)
claudex run grok "Fix lint errors" --print --dangerously-skip-permissions

# Passer des arguments supplementaires a claude
claudex run grok -- --verbose

`profile`

Gerer les profils de fournisseurs.

`profile list`

claudex profile list

Lister tous les profils configures avec leur statut, type de fournisseur et modele.

`profile add`

claudex profile add

Assistant interactif pour ajouter un nouveau profil. Guide a travers la selection du fournisseur, la saisie de la cle API (avec stockage optionnel dans le trousseau), la selection du modele, et le test de connectivite.

`profile show`

claudex profile show <NAME>

Afficher les details d’un profil specifique incluant tous les champs de configuration.

`profile remove`

claudex profile remove <NAME>

Supprimer un profil de la configuration.

`profile test`

claudex profile test <NAME|all>

Tester la connectivite pour un profil specifique ou tous les profils. Envoie une requete legere vers l’endpoint /models du fournisseur.

`auth`

Gerer l’authentification OAuth par abonnement pour les profils de fournisseurs.

`auth login`

claudex auth login <PROVIDER> [OPTIONS]

Option	Description
`--profile <NAME>`	Associer a un profil specifique
`--enterprise-url <URL>`	URL de serveur d’entreprise personnalise (pour GitLab auto-heberge, etc.)
`--headless`	Utiliser le flux headless (Device Code), ne pas lancer le navigateur

Se connecter a un fournisseur via OAuth. Fournisseurs supportes : claude, openai, google, qwen, kimi, github, gitlab.

# Se connecter a OpenAI (lit depuis Codex CLI)
claudex auth login openai --profile codex-sub

# Se connecter a Claude (lit depuis ~/.claude)
claudex auth login claude

# Se connecter a Google
claudex auth login google --profile gemini-sub

# Se connecter a GitLab avec URL d'entreprise
claudex auth login gitlab --enterprise-url https://gitlab.mycompany.com

# Mode headless (pas de navigateur, device code uniquement)
claudex auth login github --headless

`auth status`

claudex auth status [PROVIDER]

Afficher le statut d’authentification actuel. Sans argument de fournisseur, affiche le statut de tous les profils OAuth configures.

# Verifier tous les profils OAuth
claudex auth status

# Verifier un fournisseur specifique
claudex auth status openai

`auth refresh`

claudex auth refresh <PROVIDER>

Rafraichir manuellement le token OAuth pour un fournisseur. Les tokens sont egalement rafraichis automatiquement par le proxy lors de leur expiration.

`auth logout`

claudex auth logout <PROVIDER>

Supprimer les tokens OAuth stockes pour un fournisseur du trousseau systeme.

`proxy`

Gerer le serveur proxy de traduction.

`proxy start`

claudex proxy start [OPTIONS]

Flag	Description
`-p, --port PORT`	Surcharger le port du proxy (defaut : depuis la config)
`-d, --daemon`	Executer en tant que daemon en arriere-plan

`proxy stop`

claudex proxy stop

Arreter le daemon proxy (envoie SIGTERM via le fichier PID).

`proxy status`

claudex proxy status

Afficher si le proxy est en cours d’execution et sur quel port.

`dashboard`

claudex dashboard

Lancer le tableau de bord TUI pour la surveillance en temps reel et le lancement rapide.

`config`

Gerer les fichiers de configuration.

`config show`

claudex config show

Afficher le chemin du fichier de config charge, l’ordre de recherche, et les valeurs de configuration actuelles.

`config path`

claudex config path

Afficher uniquement le chemin du fichier de config resolu.

`config init`

claudex config init

Creer un nouveau fichier de config dans le repertoire courant depuis le modele integre.

`config recreate`

claudex config recreate

Recreer le fichier de config depuis config.example.toml, en ecrasant le config existant.

`config edit`

claudex config edit

Ouvrir le fichier de config dans votre $EDITOR (ou $VISUAL).

`config validate`

claudex config validate

Valider la syntaxe du config, les references de profils (backup_providers, regles du routeur), et les parametres des fournisseurs OAuth. Rapporte les erreurs et avertissements.

`config get`

claudex config get <KEY>

Obtenir une valeur de configuration specifique par chemin de cle (par ex. proxy_port, profiles.0.name).

`config set`

claudex config set <KEY> <VALUE>

Definir une valeur de configuration specifique par chemin de cle.

`config export`

claudex config export

Exporter la configuration fusionnee actuelle vers stdout au format TOML.

`sets`

Gerer les jeux de configuration (ensembles installables de regles, skills et serveurs MCP).

`sets add`

claudex sets add <PATH>

Installer un jeu de configuration depuis un repertoire local contenant un manifest.json (ou manifest.yaml).

`sets remove`

claudex sets remove <NAME>

Supprimer un jeu de configuration installe par nom.

`sets list`

claudex sets list

Lister tous les jeux de configuration installes avec leur version, description et resume des composants.

`sets update`

claudex sets update <NAME> <PATH>

Mettre a jour un jeu de configuration existant depuis un nouveau chemin de manifeste.

`sets show`

claudex sets show <NAME>

Afficher les informations detaillees sur un jeu de configuration installe, incluant tous les composants.

`update`

claudex update [OPTIONS]

Flag	Description
`--check`	Verifier uniquement les mises a jour, ne pas installer

Sans --check, telecharge et installe la derniere version depuis les GitHub Releases.