Riferimento CLI

Utilizzo globale

claudex [OPTIONS] [COMMAND]

Opzione	Descrizione
`--config <PATH>`	Sovrascrive il percorso del file di configurazione
`--version`	Stampa la versione
`--help`	Stampa l’aiuto

Quando viene eseguito senza un comando, Claudex avvia la dashboard TUI se i profili sono configurati, o mostra un messaggio di benvenuto se non esistono profili.

Comandi

`run`

Esegui Claude Code con un profilo fornitore specifico.

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

Argomento / Opzione	Descrizione
`PROFILE`	Nome del profilo, o `auto` per il routing intelligente
`PROMPT`	Prompt opzionale per l’esecuzione non interattiva (one-shot)
`-m, --model MODEL`	Sovrascrive il modello predefinito per questa sessione
`--hyperlinks`	Forza l’abilitazione degli hyperlink OSC 8 nel terminale
`--print`	Stampa la risposta ed esci (modalita non interattiva)
`--dangerously-skip-permissions`	Salta tutti i prompt di autorizzazione (usa con `--print` per CI/CD)
`ARGS...`	Argomenti aggiuntivi passati a `claude` (dopo `--`)

# Usa Grok (interattivo)
claudex run grok

# Usa Grok con un modello specifico
claudex run grok -m grok-3-mini-beta

# Routing intelligente
claudex run auto

# Forza hyperlink nel terminale
claudex run grok --hyperlinks

# Esecuzione one-shot non interattiva
claudex run grok "Explain this codebase" --print

# Utilizzo in pipeline CI/CD (nessun prompt, nessuna autorizzazione)
claudex run grok "Fix lint errors" --print --dangerously-skip-permissions

# Passa argomenti extra a claude
claudex run grok -- --verbose

`profile`

Gestisci i profili fornitore.

`profile list`

claudex profile list

Elenca tutti i profili configurati con il loro stato, tipo di fornitore e modello.

`profile add`

claudex profile add

Procedura guidata interattiva per aggiungere un nuovo profilo. Guida attraverso la selezione del fornitore, l’inserimento della chiave API (con archiviazione opzionale nel portachiavi), la selezione del modello e il test di connettivita.

`profile show`

claudex profile show <NAME>

Mostra i dettagli per un profilo specifico inclusi tutti i campi di configurazione.

`profile remove`

claudex profile remove <NAME>

Rimuove un profilo dalla configurazione.

`profile test`

claudex profile test <NAME|all>

Testa la connettivita per un profilo specifico o per tutti i profili. Invia una richiesta leggera all’endpoint /models del fornitore.

`auth`

Gestisci l’autenticazione OAuth con abbonamento per i profili fornitore.

`auth login`

claudex auth login <PROVIDER> [OPTIONS]

Opzione	Descrizione
`--profile <NAME>`	Associa a un profilo specifico
`--enterprise-url <URL>`	URL personalizzato del server enterprise (per GitLab self-hosted, ecc.)
`--headless`	Usa il flusso headless (device code), salta l’apertura del browser

Accedi a un fornitore tramite OAuth. Fornitori supportati: claude, openai, google, qwen, kimi, github, gitlab.

# Accedi a OpenAI (legge da Codex CLI)
claudex auth login openai --profile codex-sub

# Accedi a Claude (legge da ~/.claude)
claudex auth login claude

# Accedi a Google
claudex auth login google --profile gemini-sub

# Accedi a GitLab con URL enterprise
claudex auth login gitlab --enterprise-url https://gitlab.mycompany.com

# Modalita headless (nessun browser, solo device code)
claudex auth login github --headless

`auth status`

claudex auth status [PROVIDER]

Mostra lo stato corrente dell’autenticazione. Senza un argomento fornitore, mostra lo stato per tutti i profili OAuth configurati.

# Verifica tutti i profili OAuth
claudex auth status

# Verifica un fornitore specifico
claudex auth status openai

`auth refresh`

claudex auth refresh <PROVIDER>

Aggiorna manualmente il token OAuth per un fornitore. I token vengono aggiornati automaticamente anche dal proxy quando scadono.

`auth logout`

claudex auth logout <PROVIDER>

Rimuove i token OAuth archiviati per un fornitore dal portachiavi di sistema.

`proxy`

Gestisci il server proxy di traduzione.

`proxy start`

claudex proxy start [OPTIONS]

Flag	Descrizione
`-p, --port PORT`	Sovrascrive la porta del proxy (predefinito: dalla configurazione)
`-d, --daemon`	Esegui come daemon in background

`proxy stop`

claudex proxy stop

Ferma il daemon del proxy (invia SIGTERM tramite file PID).

`proxy status`

claudex proxy status

Mostra se il proxy e in esecuzione e su quale porta.

`dashboard`

claudex dashboard

Avvia la dashboard TUI per il monitoraggio in tempo reale e l’avvio rapido.

`config`

Gestisci i file di configurazione.

`config show`

claudex config show

Mostra il percorso del file di configurazione caricato, l’ordine di ricerca e i valori di configurazione correnti.

`config path`

claudex config path

Stampa solo il percorso del file di configurazione risolto.

`config init`

claudex config init

Crea un nuovo file di configurazione nella directory corrente dal template integrato.

`config recreate`

claudex config recreate

Ricrea il file di configurazione da config.example.toml, sovrascrivendo il config esistente.

`config edit`

claudex config edit

Apre il file di configurazione nel tuo $EDITOR (o $VISUAL).

`config validate`

claudex config validate

Valida la sintassi del config, i riferimenti ai profili (backup_providers, regole del router) e le impostazioni dei fornitori OAuth. Riporta errori e avvertimenti.

`config get`

claudex config get <KEY>

Ottieni un valore specifico della configurazione tramite percorso chiave (ad es. proxy_port, profiles.0.name).

`config set`

claudex config set <KEY> <VALUE>

Imposta un valore specifico della configurazione tramite percorso chiave.

`config export`

claudex config export

Esporta la configurazione unificata corrente su stdout in formato TOML.

`sets`

Gestisci i set di configurazione (pacchetti installabili di regole, skill e server MCP).

`sets add`

claudex sets add <PATH>

Installa un set di configurazione da una directory locale contenente un manifest.json (o manifest.yaml).

`sets remove`

claudex sets remove <NAME>

Rimuove un set di configurazione installato per nome.

`sets list`

claudex sets list

Elenca tutti i set di configurazione installati con la loro versione, descrizione e riepilogo dei componenti.

`sets update`

claudex sets update <NAME> <PATH>

Aggiorna un set di configurazione esistente da un nuovo percorso del manifesto.

`sets show`

claudex sets show <NAME>

Mostra informazioni dettagliate su un set di configurazione installato, inclusi tutti i componenti.

`update`

claudex update [OPTIONS]

Flag	Descrizione
`--check`	Verifica solo gli aggiornamenti, non installarli

Senza --check, scarica e installa l’ultima versione da GitHub Releases.