Claude Code. Any Model. The most powerful AI coding agent now speaks every language.
docs(cli): use <model> placeholders in --help model examples
Jack Rudenkoae8547e91b5a
diff --git a/packages/cli/src/cli.ts b/packages/cli/src/cli.tsindex 6ba04d6e..b2b6adfe 100644--- a/packages/cli/src/cli.ts+++ b/packages/cli/src/cli.ts@@ -1975,11 +1975,11 @@ ${h("USAGE")}${h("MODEL ROUTING")}${bold("New syntax:")} ${yellow("provider@model[:concurrency]")}- ${magenta("google@gemini-3-pro")} ${dim("Direct Google API (explicit)")}- ${magenta("openrouter@google/gemini-3-pro")} ${dim("OpenRouter (explicit)")}- ${magenta("[email protected]")} ${dim("Direct OpenAI API (shortcut)")}- ${magenta("[email protected]:3")} ${dim("Local Ollama, 3 concurrent requests")}- ${magenta("[email protected]:0")} ${dim("Local Ollama, no limits")}+ ${magenta("google@<model>")} ${dim("Direct Google API (explicit)")}+ ${magenta("openrouter@<vendor>/<model>")} ${dim("OpenRouter (explicit)")}+ ${magenta("oai@<model>")} ${dim("Direct OpenAI API (shortcut)")}+ ${magenta("ollama@<model>:3")} ${dim("Local Ollama, 3 concurrent requests")}+ ${magenta("ollama@<model>:0")} ${dim("Local Ollama, no limits")}${bold("Provider shortcuts:")} ${dim("(<shortcut>@<model>)")}${shortcutTable}@@ -2058,7 +2058,7 @@ ${h("MODEL DISCOVERY")}${h("TEAM MODE")}${green("--team")} ${yellow("<models>")} Run multiple models in parallel (comma-separated)- ${dim('Example: --team minimax-m2.5,kimi-k2.5 "prompt"')}+ ${dim('Example: --team <model>,<model> "prompt"')}${green("--mode")} ${yellow("<mode>")} Team mode: default (grid), interactive, json${green("-f, --file")} ${yellow("<path>")} Read prompt from file (use with --team or single-shot)@@ -2096,7 +2096,7 @@ ${h("1PASSWORD")} ${dim("(SDK-based — no op CLI needed for secrets)")}${green("--op")} ${yellow("<glob> --list")} Preview which fields a glob would import (names only)${green("--op")} ${yellow("<glob>")} ${yellow("[...args]")} Resolve a glob into env vars, then run a session${dim("Inline op import requires a GLOB (self-names via field labels)")}- ${dim('Example: claudish --op "op://Jack/Keys/**" --model gpt-4o "task"')}+ ${dim('Example: claudish --op "op://Jack/Keys/**" --model <model> "task"')}${green("--op-env")} ${yellow("<id>")} Load a 1Password Environment (highest-priority source)${dim("Persistent setup (single refs, sets, environments, account): claudish config -> 1Password tab")}@@ -2113,17 +2113,17 @@ ${h("MACOS KEYCHAIN")} ${dim("(local, encrypted at rest, no desktop-app handshak${h("CLAUDE CODE FLAG PASSTHROUGH")}${dim("Any unrecognized flag is forwarded to Claude Code. Claudish flags can appear in any order.")}- ${green("claudish")} --model grok ${yellow("--agent test")} ${yellow('"task"')} ${dim("# --agent passes through")}- ${green("claudish")} --model grok ${yellow("--effort high")} --stdin ${yellow('"task"')} ${dim("# --effort passes, --stdin stays")}- ${green("claudish")} --model grok ${yellow("--permission-mode plan")} -i ${dim("# works in interactive too")}+ ${green("claudish")} --model ${yellow("<model>")} ${yellow("--agent test")} ${yellow('"task"')} ${dim("# --agent passes through")}+ ${green("claudish")} --model ${yellow("<model>")} ${yellow("--effort high")} --stdin ${yellow('"task"')} ${dim("# --effort passes, --stdin stays")}+ ${green("claudish")} --model ${yellow("<model>")} ${yellow("--permission-mode plan")} -i ${dim("# works in interactive too")}${dim("Use -- when a Claude Code flag value starts with '-':")}- ${green("claudish")} --model grok ${green("--")} ${yellow('--system-prompt "-verbose mode" "task"')}+ ${green("claudish")} --model ${yellow("<model>")} ${green("--")} ${yellow('--system-prompt "-verbose mode" "task"')}${h("CUSTOM MODELS & ENDPOINTS")}- ${dim("Claudish accepts ANY valid model ID from the Firebase catalog, even if not in --models:")}- ${green("claudish")} --model ${yellow("openrouter@your_provider/custom-model-123")} ${yellow('"task"')}+ ${dim("An explicit provider@ takes any model id, including one --models does not list:")}+ ${green("claudish")} --model ${yellow("openrouter@<vendor>/<model>")} ${yellow('"task"')}${dim("Named custom endpoints live in ~/.claudish/config.json under 'customEndpoints' and route via @:")}- ${green("claudish")} --model ${yellow("[email protected]")} ${yellow('"task"')}+ ${green("claudish")} --model ${yellow("my-vllm@<model>")} ${yellow('"task"')}${h("MODES")}${green("•")} ${bold("Interactive")} ${dim("(default):")} shows model selector, starts a persistent session@@ -2186,7 +2186,7 @@ ${h("ENVIRONMENT VARIABLES")}${blue("MLX_BASE_URL")} MLX server ${dim("(default: http://127.0.0.1:8080)")}${bold("Claudish settings:")}- ${blue("CLAUDISH_MODEL")} Default model ${dim("(default: openai/gpt-5.3)")}+ ${blue("CLAUDISH_MODEL")} Default model ${dim("(--model overrides it; ANTHROPIC_MODEL is read when unset)")}${blue("CLAUDISH_DEFAULT_PROVIDER")} Fallback provider for bare names; empty disables it ${dim("(see --default-provider)")}${blue("CLAUDISH_PORT")} Default proxy port${blue("CLAUDISH_CONTEXT_WINDOW")} Override context window size@@ -2210,24 +2210,24 @@ ${h("EXAMPLES")}${green("claudish")} --free ${dim("# only FREE models")}${dim("# Explicit provider routing")}- ${green("claudish")} --model ${magenta("google@gemini-3-pro")} ${yellow('"implement auth"')}- ${green("claudish")} --model ${magenta("[email protected]")} ${yellow('"add tests for login"')}- ${green("claudish")} --model ${magenta("openrouter@deepseek/deepseek-r1")} ${yellow('"unknown vendor"')}+ ${green("claudish")} --model ${magenta("google@<model>")} ${yellow('"implement auth"')}+ ${green("claudish")} --model ${magenta("oai@<model>")} ${yellow('"add tests for login"')}+ ${green("claudish")} --model ${magenta("openrouter@<vendor>/<model>")} ${yellow('"any vendor via OpenRouter"')}- ${dim("# Native auto-detection (provider inferred from model name)")}- ${green("claudish")} --model ${yellow("gpt-4o")} ${yellow('"routes to OpenAI"')}- ${green("claudish")} --model ${yellow("gemini-2.5-pro")} ${yellow('"routes to Google"')}+ ${dim("# Bare name: routed from the cloud models catalog")}+ ${green("claudish")} --probe ${yellow("<model>")} ${dim("# show the chain it gets")}+ ${green("claudish")} --model ${yellow("<model>")} ${yellow('"implement auth"')}${dim("# Per-role model mapping")}- ${green("claudish")} --model-opus ${magenta("[email protected]")} --model-sonnet ${magenta("google@gemini-3-pro")}+ ${green("claudish")} --model-opus ${magenta("oai@<model>")} --model-sonnet ${magenta("google@<model>")}${dim("# stdin for large prompts (diffs, code review)")}- ${dim("git diff |")} ${green("claudish")} --stdin --model ${magenta("[email protected]")} ${yellow('"Review these changes"')}+ ${dim("git diff |")} ${green("claudish")} --stdin --model ${magenta("oai@<model>")} ${yellow('"Review these changes"')}${dim("# Local models with concurrency control")}- ${green("claudish")} --model ${magenta("[email protected]:3")} ${yellow('"3 concurrent requests"')}- ${green("claudish")} --model ${magenta("[email protected]")} ${yellow('"LM Studio shortcut"')}- ${green("claudish")} --model ${yellow('"http://localhost:8000/mistral"')} ${yellow('"any OpenAI-compatible URL"')}+ ${green("claudish")} --model ${magenta("ollama@<model>:3")} ${yellow('"3 concurrent requests"')}+ ${green("claudish")} --model ${magenta("lms@<model>")} ${yellow('"LM Studio shortcut"')}+ ${green("claudish")} --model ${yellow('"http://localhost:8000/<model>"')} ${yellow('"any OpenAI-compatible URL"')}${dim("# Autonomous (no prompts, no sandbox) — use with caution")}${green("claudish")} -y --dangerous ${yellow('"refactor entire codebase"')}