🚀 Quick Start

1. Get API Keys

2. Clone & Configure

git clone https://github.com/ai-caseylai/cc-router.git
cd cc-router
# Edit setup.py — fill in your API keys

3. One‑Click Deploy

python3 setup.py

4. Launch

source ~/.zshrc && claude

📦 Installation

Prerequisites

• macOS 12+ (Linux/Windows: manual)
• Python 3
• Claude Code (auto‑installed)

Automatic (macOS)

python3 setup.py

Manual

# 1. Start proxy
python3 ~/Documents/minimax/cc-proxy.py &

# 2. Configure settings.json
# → See "settings.json" page for full config

# 3. Add alias
echo "alias cc-model='bash ~/Documents/minimax/cc-model.sh'" >> ~/.zshrc

Verify

curl http://127.0.0.1:3456/health     # → {"status":"ok"}
claude                                 # /status → http://127.0.0.1:3456

DeepSeek

Endpoint

https://api.deepseek.com/anthropic/v1/messages

API Key

Register at platform.deepseek.com, top up, create key → sk-xxxxxxxx. One key serves both models.

Aliases

MiniMax M3 ⚠️ tricky

Correct Endpoint

https://api.minimax.io/anthropic/v1/messages   ← ✅ International
https://api.minimaxi.com/anthropic/v1/messages  ← ❌ CN only → 401

Test Connectivity

curl -s https://api.minimax.io/anthropic/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-cp-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"MiniMax-M3","max_tokens":5,"messages":[{"role":"user","content":"hi"}]}'

Features

• Extended Thinking (toggle: Option+T / Alt+T in Claude Code)
• Context: 512K → set CLAUDE_CODE_AUTO_COMPACT_WINDOW: "512000"

GLM‑5.1 (Zhipu AI)

Endpoints

API Key

Register at open.bigmodel.cn, create key.

🌐 International Endpoints

How Claude Code Connects

"ANTHROPIC_BASE_URL": "http://127.0.0.1:3456"   ← local proxy
"ANTHROPIC_AUTH_TOKEN": "dummy"                ← proxy handles real auth

The proxy strips ?beta=true query params and routes by model field.

🕹️ Model Switching

Terminal

cc-model pro        # Default=DeepSeek Pro  → Haiku=MiniMax
cc-model flash      # Default=DeepSeek Flash → Haiku=MiniMax
cc-model minimax    # Default=MiniMax       → Haiku=DeepSeek Pro
cc-model glm        # Default=GLM‑5.1       → Haiku=MiniMax
cc-model status     # Show mapping + proxy health

Inside Claude Code

Type /model → arrow keys → Default ↔ Haiku. No restart needed.

cc-model CLI

The cc-model command updates ~/.claude/settings.json to remap which models appear in /model's two slots.

Installation

# Auto (setup.py)
python3 setup.py

# Manual
echo "alias cc-model='bash ~/Documents/minimax/cc-model.sh'" >> ~/.zshrc

Commands

🔧 Architecture

cc‑proxy is a single‑file Python HTTP server (~120 lines) using only http.server and urllib.request — zero dependencies.

Request Flow

1. Claude Code → POST /v1/messages?beta=true (model="MiniMax-M3")
2. Proxy strips ?beta=true, reads model name
3. Looks up PROVIDERS["MiniMax-M3"]
4. Forwards to https://api.minimax.io/anthropic/v1/messages
5. Streams response back (SSE supported)
6. Claude Code receives response as if from Anthropic API

📁 File Map

settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456",
    "ANTHROPIC_AUTH_TOKEN": "dummy",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",         ← Default slot
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M3",     ← Haiku slot
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "512000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "model": "deepseek-v4-pro[1m]",
  "availableModels": ["MiniMax-M3","deepseek-v4-pro[1m]","deepseek-v4-flash"]
}

Streaming

The proxy supports both streaming (SSE) and non‑streaming responses:

# Streaming (Claude Code default)
req["stream"] = true   → proxy reads 4KB chunks, forwards immediately

# Non‑streaming
req["stream"] = false  → proxy reads entire response, sends at once

Query Params

Claude Code sends POST /v1/messages?beta=true. The proxy strips query params before path matching (path.split("?")[0]).

"model may not exist"

Cause: Proxy not running, or Claude Code can't reach port 3456.

# Check
curl http://127.0.0.1:3456/health

# Restart
lsof -ti :3456 | xargs kill
python3 ~/Documents/minimax/cc-proxy.py &

Also check: ANTHROPIC_BASE_URL in settings.json must be http://127.0.0.1:3456.

MiniMax 401 · invalid api key

Three causes:

1. Using api.minimaxi.com instead of api.minimax.io
2. API key expired on MiniMax platform
3. Key truncated or malformed (must start with sk-cp-)

curl -s https://api.minimax.io/anthropic/v1/messages \
  -H "x-api-key: sk-cp-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model":"MiniMax-M3","max_tokens":5,"messages":[{"role":"user","content":"hi"}]}'

API Timeout · Retrying

Cause: ANTHROPIC_BASE_URL pointing to dead endpoint or wrong port.

Common causes:

• ~/.zshrc has export ANTHROPIC_BASE_URL=... overriding settings.json
• Proxy not running on port 3456
• Port mismatch (settings.json has 3457 but proxy is on 3456)

# Check for conflicts
grep ANTHROPIC ~/.zshrc
# Comment them out
sed -i '' 's/^export ANTHROPIC_/# export ANTHROPIC_/' ~/.zshrc

Env Var Conflicts

Priority order:

1. ~/.zshrc export ANTHROPIC_*   ← HIGHEST (overrides everything)
2. ~/.claude/settings.json env   ← MIDDLE
3. ~/.claude.json                ← LOWEST

If both .zshrc and settings.json set the same variable, the .zshrc value wins.

launchd "Operation not permitted"

macOS privacy restriction.

Fix: System Settings → Privacy & Security → Full Disk Access → add /usr/bin/python3.

📋 Command Cheatsheet

🔗 Links