Claude Code Setup — Multi-Provider Router

Use Claude Code with multiple LLM providers (Z.AI GLM, MiniMax, Xiaomi MiMo, or any Anthropic-compatible API) via a local proxy. The main agent (Opus) stays on Anthropic while sub-tasks route through cheaper/faster providers.

7 Routing Modes

Command	Mode	Description
`claude-full`	Full Claude	All → Anthropic OAuth (native, zero overhead)
`glm-on`	Hybrid GLM	Sonnet → GLM-5.1, Haiku → GLM-4.7, Opus → Anthropic
`minimax-on`	Hybrid MiniMax	Sonnet/Haiku → MiniMax M2.7, Opus → Anthropic
`mimo-on`	Hybrid MiMo	Sonnet/Haiku → MiMo-V2.5-Pro, Opus → Anthropic
`mix-on`	Split	Sonnet → MiMo-V2.5-Pro, Haiku → MiniMax M2.7, Opus → Anthropic
`glm-full`	Full GLM	All → Z.AI direct (official config, no proxy)
`mimo-full`	Full MiMo	All → Xiaomi MiMo direct (mimo-v2.5-pro, no proxy)

How it works

                    ┌──────────────────────────────────────────────┐
  claude-full       │  FULL CLAUDE                                  │
                    │  All requests → Anthropic OAuth (native)      │
                    ├──────────────────────────────────────────────┤
  glm-on            │  HYBRID GLM                                   │
                    │  Opus → Anthropic | Sonnet → GLM-5.1          │
                    │                   | Haiku  → GLM-4.7          │
                    ├──────────────────────────────────────────────┤
  minimax-on        │  HYBRID MINIMAX                               │
                    │  Opus → Anthropic | Sonnet/Haiku → MiniMax    │
                    ├──────────────────────────────────────────────┤
  mimo-on           │  HYBRID MIMO                                  │
                    │  Opus → Anthropic | Sonnet/Haiku → MiMo-V2.5  │
                    ├──────────────────────────────────────────────┤
  mix-on            │  SPLIT GLOBAL (MiMo + MiniMax)                │
                    │  Opus → Anthropic | Sonnet → MiMo-V2.5-Pro    │
                    │                   | Haiku  → MiniMax M2.7     │
                    ├──────────────────────────────────────────────┤
  glm-full          │  FULL GLM                                     │
                    │  All requests → Z.AI direct (no proxy)        │
                    ├──────────────────────────────────────────────┤
  mimo-full         │  FULL MIMO                                    │
                    │  All requests → Xiaomi MiMo direct (no proxy) │
                    └──────────────────────────────────────────────┘

Proxy features

Circuit breaker: auto-bypass provider after 5 failures (120s recovery)
Automatic fallback: web_search, vision, PDF → Anthropic transparently
Model-based pricing: accurate cost display from built-in MODEL_PRICING table
Request sanitization: strips Anthropic-specific params for provider compatibility
Per-tier caching: respects each provider's cache_control support

Prerequisites

Requirement	Check	Install
macOS or Linux	`uname -s`	—
Python 3.10+	`python3 --version`	`brew install python3`
jq	`jq --version`	`brew install jq`
Node.js 18+	`node --version`	`brew install node`
Claude Code	`claude --version`	`npm install -g @anthropic-ai/claude-code`
Claude Max subscription	claude.ai/settings	Required for Opus via OAuth
GLM Coding Plan (optional)	z.ai/subscribe	From $10/month
MiniMax API key (optional)	platform.minimax.io	Pay-as-you-go
Xiaomi MiMo Token Plan (optional)	mimo.mi.com	Pro Monthly / Pay-as-you-go (key format: `tp-xxx` or `sk-xxx`)

Installation

Step 1 — Clone

git clone git@github.com:louis-tepe/claude-code-setup.git ~/claude-code-setup
cd ~/claude-code-setup

Step 2 — Install

./install.sh

The script will:

Check prerequisites (Python, jq, Node.js)
Install the proxy + Python dependencies
Copy Claude Code config (settings, agents, statusline)
Copy mode files to ~/.claude/proxy-modes/
Add shell integration to ~/.zshrc (or .bashrc)
Prompt for API keys
Test the proxy

Step 3 — Reload terminal

source ~/.zshrc

Step 4 — Configure API keys

# Z.AI (for GLM modes)
echo 'your_zai_key' > ~/.claude/.zai-api-key

# MiniMax (for MiniMax/mix modes)
echo 'your_minimax_key' > ~/.claude/.minimax-api-key

# Xiaomi MiMo (for MiMo modes)
echo 'your_mimo_key' > ~/.claude/.mimo-api-key

Step 5 — Choose a mode and launch

mimo-on    # or glm-on, minimax-on, mix-on, claude-full
claude

Commands

Mode switching

Command	Description
`glm-on`	Hybrid GLM (Sonnet → GLM-5.1, Haiku → GLM-4.7)
`minimax-on`	Hybrid MiniMax (Sonnet/Haiku → MiniMax M2.7)
`mimo-on`	Hybrid MiMo (Sonnet/Haiku → MiMo-V2.5-Pro)
`mix-on`	Split (Sonnet → MiMo-V2.5-Pro, Haiku → MiniMax M2.7)
`glm-full`	Full GLM (all → Z.AI direct)
`mimo-full`	Full MiMo (all → Xiaomi MiMo direct)
`claude-full`	Full Claude (all → Anthropic)

Utilities

Command	Description
`proxy-status`	Show current mode, routing, health
`proxy-tokens`	Token usage and cost stats
`proxy-keys`	Check configured API keys
`proxy-logs`	Proxy logs in real time
`proxy-setup`	Setup instructions

Architecture

~/.claude/                          # User config (never in git)
├── proxy-routing                   # Current mode state (on/minimax/mix/mimo/full/mimo_full/off)
├── proxy-modes/                    # Provider config per mode
│   ├── on.env                      # GLM hybrid config
│   ├── minimax.env                 # MiniMax hybrid config
│   ├── mimo.env                    # MiMo hybrid config
│   └── mix.env                     # Split MiMo+MiniMax config
├── .zai-api-key                    # Z.AI API key
├── .minimax-api-key                # MiniMax API key
├── .mimo-api-key                   # Xiaomi MiMo API key
├── claude-shell.sh                 # Shell wrapper (sourced by .zshrc)
└── statusline-command.sh           # Status bar display

claude-code-setup/                  # Source code (git repo)
├── proxy/
│   ├── proxy.py                    # FastAPI proxy (Multi-Provider Router v5)
│   ├── .env                        # Operational config (port, log level)
│   └── requirements.txt            # Python deps
├── proxy-modes/                    # Mode file templates
├── shell/claude-shell.sh           # Shell source
├── claude-config/                  # Claude Code config templates
└── install.sh                      # Installer

Adding a new provider

Create API key file: echo 'key' > ~/.claude/.newprovider-api-key

Create mode file ~/.claude/proxy-modes/newprovider.env:

_SHELL_SONNET_KEY=.newprovider-api-key
_SHELL_HAIKU_KEY=.newprovider-api-key
SONNET_PROVIDER_BASE_URL=https://api.newprovider.com/anthropic
HAIKU_PROVIDER_BASE_URL=https://api.newprovider.com/anthropic
PROVIDER_SONNET_MODEL=newprovider-model
PROVIDER_HAIKU_MODEL=newprovider-model

Add pricing to proxy.py MODEL_PRICING table
Add shell command: newprovider-on() { _switch_mode newprovider; }
Add display case in proxy-status()

Mode env file format

# Shell directives (not passed to proxy)
_SHELL_SONNET_KEY=.keyfile          # Key file relative to ~/.claude/
_SHELL_HAIKU_KEY=.keyfile           # Key file relative to ~/.claude/
_SHELL_DISABLE_CACHING_SONNET=1    # Disable prompt caching for Sonnet
_SHELL_DISABLE_CACHING_HAIKU=1     # Disable prompt caching for Haiku

# Proxy env vars (passed to proxy process)
SONNET_PROVIDER_BASE_URL=https://...
HAIKU_PROVIDER_BASE_URL=https://...
PROVIDER_SONNET_MODEL=model-name
PROVIDER_HAIKU_MODEL=model-name
PROVIDER_PASS_CACHE_CONTROL=1       # Pass cache_control to provider

Pricing

Pricing is resolved automatically by model name in proxy.py:

Model	Input/M	Output/M	Provider
GLM-5.1	$1.40	$4.40	Z.AI
GLM-4.7	$0.60	$2.20	Z.AI
MiniMax M2.7	$0.30	$1.20	MiniMax
MiMo-V2.5-Pro	Token Plan	Token Plan	Xiaomi (credits-based)
Claude Sonnet 4.6	$3.00	$15.00	Anthropic
Claude Haiku 4.5	$1.00	$5.00	Anthropic

Troubleshooting

Proxy won't start

proxy-status                    # Check current state
proxy-logs                      # Check error logs
lsof -i:8082                   # Port already in use?

API key issues

proxy-keys                      # Check all configured keys

Switch to safe mode

claude-full                     # Bypass proxy, use Anthropic directly

Credits

Proxy originally based on jodavan/claude-code-proxy
GLM models by Zhipu AI / Z.AI
MiniMax models by MiniMax
MiMo models by Xiaomi
Claude Code by Anthropic

Name		Name	Last commit message	Last commit date
claude-config		claude-config
proxy-modes		proxy-modes
proxy		proxy
service		service
shell		shell
.gitignore		.gitignore
GUIDE.md		GUIDE.md
MESSAGE.md		MESSAGE.md
README.md		README.md
install.sh		install.sh
uninstall.sh		uninstall.sh
update.sh		update.sh

Navigation Menu

Repository files navigation

Claude Code Setup — Multi-Provider Router

7 Routing Modes

How it works

Proxy features

Prerequisites

Installation

Step 1 — Clone

Step 2 — Install

Step 3 — Reload terminal

Step 4 — Configure API keys

Step 5 — Choose a mode and launch

Commands

Mode switching

Utilities

Architecture

Adding a new provider

Mode env file format

Pricing

Troubleshooting

Proxy won't start

API key issues

Switch to safe mode

Credits

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Claude Code Setup — Multi-Provider Router

7 Routing Modes

How it works

Proxy features

Prerequisites

Installation

Step 1 — Clone

Step 2 — Install

Step 3 — Reload terminal

Step 4 — Configure API keys

Step 5 — Choose a mode and launch

Commands

Mode switching

Utilities

Architecture

Adding a new provider

Mode env file format

Pricing

Troubleshooting

Proxy won't start

API key issues

Switch to safe mode

Credits

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages