← ClaudeAtlas

switch-modelslisted

Use when someone wants to change which OpenRouter (or Claude) models the proxy routes to — swapping a model behind an alias, retargeting an agent, overriding at runtime, or checking that slugs are still live.
armenr/modelmux · ★ 1 · AI & Automation · score 67
Install: claude install-skill armenr/modelmux
# Switching models The model menu lives in `routes.toml` under `[models]`: friendly **aliases** → `"<upstream>:<slug>"`. Everything below is a way to change that mapping or which alias an agent uses. The proxy **hot-reloads** `routes.toml` on save (and keeps the previous config if an edit is invalid), so most changes need no restart. ## The `mux` CLI ```bash bin/mux models # list aliases → upstream:slug bin/mux set flagship openrouter:z-ai/glm-6 # point an alias at a new model bin/mux use glm-researcher reasoner # retarget an agent's <<route:>> tag bin/mux check-latest # verify configured slugs exist on OpenRouter ``` - **`set <alias> <upstream:slug>`** rewrites just that alias's value in `routes.toml`, validating the spec first (`anthropic:` or `openrouter:`). - **`use <agent> <alias>`** rewrites the `<<route:alias>>` tag inside `.claude/agents/<agent>.md`, so that agent now routes to a different alias. ## Runtime override (no file edit) Override any alias for a single proxy run with an env var named `MUX_MODEL_<ALIAS>` (uppercase; hyphens become underscores): ```bash MUX_MODEL_FLAGSHIP=openrouter:qwen/qwen3.7-max bun run proxy MUX_MODEL_CLAUDE_REVIEW=anthropic:claude-opus-4-8 bun run proxy ``` Handy for trying a model without touching tracked files. ## How an agent chooses its model An agent's model comes from the `<<route:alias>>` tag on the first content line of its `.claude/agents/<name>.md`. The