CLI Reference

Global Usage

claudex [COMMAND]

When run without a command, Claudex launches the TUI dashboard if profiles are configured, or shows a welcome message if no profiles exist.

Commands

`run`

Run Claude Code with a specific provider profile.

claudex run <PROFILE> [PROMPT] [-m MODEL] [--print] [--dangerously-skip-permissions] [ARGS...]

Argument	Description
`PROFILE`	Profile name, or `auto` for smart routing
`PROMPT`	Optional prompt for non-interactive (one-shot) execution
`-m, --model MODEL`	Override the default model for this session
`--print`	Print the response and exit (non-interactive mode)
`--dangerously-skip-permissions`	Skip all permission prompts (use with `--print` for CI/CD)
`ARGS...`	Additional arguments passed to `claude`

# Use Grok (interactive)
claudex run grok

# Use Grok with a specific model
claudex run grok -m grok-3-mini-beta

# Smart routing
claudex run auto

# Non-interactive one-shot execution
claudex run grok "Explain this codebase" --print

# CI/CD pipeline usage (no prompts, no permissions)
claudex run grok "Fix lint errors" --print --dangerously-skip-permissions

# Pass extra args to claude
claudex run grok -- --verbose

`profile`

Manage provider profiles.

`profile list`

claudex profile list

List all configured profiles with their status.

`profile add`

claudex profile add

Interactive wizard to add a new profile. Guides through provider selection, API key entry (with optional keyring storage), model selection, and connectivity testing.

`profile show`

claudex profile show <NAME>

Show details for a specific profile.

`profile remove`

claudex profile remove <NAME>

Remove a profile from the configuration.

`profile test`

claudex profile test <NAME|all>

Test connectivity for a specific profile or all profiles.

`auth`

Manage OAuth subscription authentication for provider profiles.

`auth login`

claudex auth login <PROVIDER>

For OpenAI, Claudex reads tokens from the Codex CLI config (~/.codex/auth.json). For Claude, it reads from ~/.claude. Other providers use a local callback server or device code flow.

# Log in to OpenAI (reads from Codex CLI)
claudex auth login openai

# Log in to Claude (reads from ~/.claude)
claudex auth login claude

# Log in to Google
claudex auth login google

`auth status`

claudex auth status [PROVIDER]

Show the current authentication status. Without a provider argument, shows status for all configured OAuth profiles.

# Check all OAuth profiles
claudex auth status

# Check a specific provider
claudex auth status openai

`auth refresh`

claudex auth refresh <PROVIDER>

Manually refresh the OAuth token for a provider. Tokens are also refreshed automatically by the proxy when they expire.

`auth logout`

claudex auth logout <PROVIDER>

Remove stored OAuth tokens for a provider.

`proxy`

Manage the translation proxy server.

`proxy start`

claudex proxy start [-p PORT] [-d]

Flag	Description
`-p, --port PORT`	Override proxy port (default: from config)
`-d, --daemon`	Run as background daemon

`proxy stop`

claudex proxy stop

Stop the proxy daemon (sends SIGTERM).

`proxy status`

claudex proxy status

Show whether the proxy is running and on which port.

`dashboard`

claudex dashboard

Launch the TUI dashboard for real-time monitoring and quick-launch.

`config`

claudex config [--init]

Flag	Description
`--init`	Create a new config file in the current directory

Without --init, shows the loaded config file path and search order.

`update`

claudex update [--check]

Flag	Description
`--check`	Only check for updates, don’t install

Without --check, downloads and installs the latest version.