Skip to main content

​
clawdia models

Model discovery, scanning, and configuration (default model, fallbacks, auth profiles). Related:

​
Common commands

clawdia models status
clawdia models list
clawdia models set <model-or-alias>
clawdia models scan
clawdia models status shows the resolved default/fallbacks plus an auth overview. When provider usage snapshots are available, the OAuth/token status section includes provider usage headers. Add --probe to run live auth probes against each configured provider profile. Probes are real requests (may consume tokens and trigger rate limits). Notes:
  • models set <model-or-alias> accepts provider/model or an alias.
  • Model refs are parsed by splitting on the first /. If the model ID includes / (OpenRouter-style), include the provider prefix (example: openrouter/moonshotai/kimi-k2).
  • If you omit the provider, Clawdia treats the input as an alias or a model for the default provider (only works when there is no / in the model ID).

​
models status

Options:
  • --json
  • --plain
  • --check (exit 1=expired/missing, 2=expiring)
  • --probe (live probe of configured auth profiles)
  • --probe-provider <name> (probe one provider)
  • --probe-profile <id> (repeat or comma-separated profile ids)
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>

​
Aliases + fallbacks

clawdia models aliases list
clawdia models fallbacks list

​
Auth profiles

clawdia models auth add
clawdia models auth login --provider <id>
clawdia models auth setup-token
clawdia models auth paste-token
models auth login runs a provider plugin’s auth flow (OAuth/API key). Use clawdia plugins list to see which providers are installed. Notes:
  • setup-token runs claude setup-token on the current machine (requires the Claude Code CLI).
  • paste-token accepts a token string generated elsewhere.