OpenParable
Skip to content
← Back to skills

Proxy Mode Reference

Apps & Automation
proxy-mode-reference

Proxy Mode Reference is an Agent Skill for apps & automation published in the MadAppGang/claude-code repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Reference guide for using external AI models via claudish CLI. Use when running multi-model reviews, understanding how /team invokes external models, or debugging external model integration issues. Includes routing prefixes for MiniMax, Kimi, GLM direct APIs.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/MadAppGang/claude-code/blob/HEAD/plugins/multimodel/skills/proxy-mode-reference/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/proxy-mode-reference, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

External Models via Claudish CLI — Reference Guide

⚠️ Learn and Reuse Model Preferences

Models are learned per context and reused automatically:

cat .claude/multimodel-team.json 2>/dev/null
  1. Detect context from task keywords (debug/research/coding/review)
  2. If contextPreferences[context] exists → USE IT (no asking)
  3. If empty (first time) → ASK user → SAVE for that context
  4. User says "change models" → UPDATE preferences

How External Models Work

External models are invoked deterministically via the claudish CLI. The orchestrator (e.g., /team command) calls claudish directly through Bash — no LLM delegation needed.

Orchestrator → Bash(claudish --model {MODEL_ID} --stdin) → External Model

This approach is 100% reliable because it's a direct CLI invocation, not a prompt-based delegation.

Invoking External Models

From /team Command (Automatic)

The /team command handles this automatically:

  • Internal models → Task(dev:researcher)
  • External models → Bash(claudish --model {MODEL_ID} --stdin)

Direct CLI Usage

# Pattern
claudish --model {MODEL_ID} --stdin --quiet < prompt-file.md > result.md

# Examples
claudish --model x-ai/grok-code-fast-1 --stdin --quiet < task.md > grok-result.md
claudish --model google/gemini-3-pro-preview --stdin --quiet < task.md > gemini-result.md

Required flags:

  • --model — The external model to use
  • --stdin — Read prompt from stdin (for large prompts)
  • --quiet — Suppress log messages (for clean output capture)

Multi-Backend Routing

Claudish routes to different backends based on model ID prefix:

PrefixBackendRequired KeyExample
(none)OpenRouterOPENROUTER_API_KEYopenai/gpt-5.2
g/ gemini/Google Gemini APIGEMINI_API_KEYg/gemini-2.0-flash
oai/OpenAI Direct APIOPENAI_API_KEYoai/gpt-4o
mmax/ mm/MiniMax Direct APIMINIMAX_API_KEYmmax/MiniMax-M2.1
kimi/ moonshot/Kimi Direct APIKIMI_API_KEYkimi/kimi-k2-thinking-turbo
glm/ zhipu/GLM Direct APIGLM_API_KEYglm/glm-4.7
ollama/Ollama (local)Noneollama/llama3.2
lmstudio/LM Studio (local)Nonelmstudio/qwen
vllm/vLLM (local)Nonevllm/model
mlx/MLX (local)Nonemlx/model
http://...Custom endpointNonehttp://localhost:8000/model

⚠️ Prefix Collision Warning

OpenRouter model IDs may collide with routing prefixes. Check the prefix table above.

Collision-free models (safe for OpenRouter):

  • x-ai/grok-* ✅
  • deepseek/* ✅
  • minimax/* ✅ (use mmax/ for MiniMax Direct)
  • qwen/* ✅
  • mistralai/* ✅
  • moonshotai/* ✅ (use kimi/ for Kimi Direct)
  • anthropic/* ✅
  • z-ai/* ✅ (use glm/ for GLM Direct)
  • google/* ✅ (use g/ for Gemini Direct)
  • openai/* ✅ (use oai/ for OpenAI Direct)

Direct API prefixes for cost savings:

OpenRouter ModelDirect API PrefixNotes
openai/gpt-*oai/gpt-*OpenAI Direct API
google/gemini-*g/gemini-*Gemini Direct API
minimax/*mmax/* or mm/*MiniMax Direct API
moonshotai/*kimi/* or moonshot/Kimi Direct API
z-ai/glm-*glm/* or zhipu/*GLM Direct API

Correct Usage Patterns

Single External Model

claudish --model x-ai/grok-code-fast-1 --stdin --quiet < task.md > result.md

Parallel External Models (in /team)

# All launched in a single message with run_in_background: true
Bash("claudish --model x-ai/grok-code-fast-1 --stdin --quiet < vote-prompt.md > grok-result.md 2>grok-stderr.log; echo $? > grok.exit")
Bash("claudish --model google/gemini-3-pro-preview --stdin --quiet < vote-prompt.md > gemini-result.md 2>gemini-stderr.log; echo $? > gemini.exit")

Verifying Results

# Check exit code
cat grok.exit  # 0 = success

# Check output size
wc -c < grok-result.md  # Should be >50 bytes

# Check stderr for errors
cat grok-stderr.log

Common Mistakes

Mistake 1: Not capturing exit code

# ❌ WRONG - no way to detect failures
claudish --model grok --stdin < task.md > result.md

# ✅ CORRECT - capture exit code
claudish --model grok --stdin < task.md > result.md 2>stderr.log; echo $? > result.exit

Troubleshooting

"claudish: command not found"

Fix: npm install -g claudish

"OPENROUTER_API_KEY not set"

Fix: export OPENROUTER_API_KEY=your-key

Non-zero exit code

Fix: Check stderr log for error details. Common causes: rate limits, invalid model ID, API key issues.