Models

Select and configure AI models in Mux

Mux supports multiple AI providers. Configure provider API keys in Settings → Providers — see Providers for setup.

First-class Models

Mux ships with curated models kept up to date with the frontier. Use any custom model with /model <provider:model_id>.

Model	ID	Aliases	Default
Opus 4.6	anthropic:claude-opus-4-6	opus	✓
Sonnet 4.5	anthropic:claude-sonnet-4-5	sonnet
Haiku 4.5	anthropic:claude-haiku-4-5	haiku
GPT-5.2	openai:gpt-5.2	gpt
GPT-5.2 Pro	openai:gpt-5.2-pro	gpt-pro
GPT-5.2 Codex	openai:gpt-5.2-codex	codex
GPT-5.3 Codex	openai:gpt-5.3-codex	codex-5.3
GPT-5.1 Codex	openai:gpt-5.1-codex	codex-5.1
GPT-5.1 Codex Mini	openai:gpt-5.1-codex-mini	codex-mini
GPT-5.1 Codex Max	openai:gpt-5.1-codex-max	codex-max
Gemini 3 Pro Preview	google:gemini-3-pro-preview	gemini, gemini-3, gemini-3-pro
Gemini 3 Flash Preview	google:gemini-3-flash-preview	gemini-3-flash
Grok 4 1 Fast	xai:grok-4-1-fast	grok, grok-4, grok-4.1, grok-4-1
Grok Code Fast 1	xai:grok-code-fast-1	grok-code

Model Selection

Keyboard shortcuts:

• Cycle models
  • macOS: Cmd+/
  • Windows/Linux: Ctrl+/

To choose a specific model, click the model pill in the chat footer.

Alternatively, use the Command Palette (Cmd+Shift+P / Ctrl+Shift+P):

1. Type “model”
2. Select “Change Model”
3. Choose from available models

Models are specified in the format: provider:model-name

One-shot Overrides

Override the model or thinking level for a single message using slash commands. The override applies only to that message — workspace settings stay unchanged.

Syntax

Command	Effect
/sonnet explain this code	Use Sonnet for one message
/opus+high deep review	Use Opus with high thinking
/haiku+0 quick answer	Use Haiku at its lowest thinking level
/+2 analyze this	Keep current model, set thinking level 2

Thinking levels

Append +level to any model alias. Levels can be named (off, low, medium/med, high, max) or numeric (0–9).

Numeric levels are model-relative — they map to the model’s allowed thinking range:

• 0 = model’s lowest allowed level (e.g., off for Sonnet, medium for GPT-5.2 Pro)
• Higher numbers select progressively higher levels, clamped to the model’s maximum

This means /sonnet+0 disables thinking while /gpt-pro+0 sets thinking to medium (GPT-5.2 Pro’s minimum).

Use /+level (no model) to override thinking on the current model: /+0 quick answer

CLI

The mux run CLI accepts the same thinking levels via --thinking:

mux run -t 0 "Quick fix"          # Lowest thinking for the model
mux run -t high "Deep analysis"   # Named level

Next Steps

Configure Providers

Set up API keys for Anthropic, OpenAI, Google, and other providers.