Create multiple isolated Claude Code variants with custom providers.
┌────────────────────────────────────────────────────────────────────────────────┐
│ │
│ One tool. Multiple Claude Code instances. Complete isolation. │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ zai │ │ minimax │ │openrouter│ │ ccrouter │ │ mclaude │ │
│ │ GLM-4.7 │ │ M2.1 │ │ 100+ LLMs│ │ Local │ │ Claude │ │
│ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │
│ │ │ │ │ │ │
│ └──────────────┴──────────────┴──────────────┴──────────────┘ │
│ │ │
│ ┌──────────▼──────────┐ │
│ │ Claude Code │ │
│ │ (isolated) │ │
│ └─────────────────────┘ │
│ │
└────────────────────────────────────────────────────────────────────────────────┘
CC-MIRROR creates isolated Claude Code instances that connect to different AI providers. Each variant has its own config, sessions, themes, and API credentials — completely separate from each other.
# Run the interactive TUI
npx cc-mirror
# Or quick setup from CLI
npx cc-mirror quick --provider zai --api-key "$Z_AI_API_KEY"
| Provider | Models | Auth | Best For |
|---|---|---|---|
| Z.ai | GLM-4.7, GLM-4.5-Air | API Key | Heavy coding with GLM reasoning |
| MiniMax | MiniMax-M2.1 | API Key | Unified model experience |
| OpenRouter | 100+ models | Auth Token | Model flexibility, pay-per-use |
| CCRouter | Ollama, DeepSeek, etc. | Optional | Local-first development |
| Mirror | Claude (native) | OAuth/Key | Pure Claude with team mode |
# Z.ai (GLM Coding Plan)
npx cc-mirror quick --provider zai --api-key "$Z_AI_API_KEY"
# MiniMax (MiniMax-M2.1)
npx cc-mirror quick --provider minimax --api-key "$MINIMAX_API_KEY"
# OpenRouter (100+ models)
npx cc-mirror quick --provider openrouter --api-key "$OPENROUTER_API_KEY" \
--model-sonnet "anthropic/claude-3.5-sonnet"
# Claude Code Router (local LLMs)
npx cc-mirror quick --provider ccrouter
# Mirror Claude (pure Claude with team mode)
npx cc-mirror quick --provider mirror --name mclaudeEach variant lives in its own directory with complete isolation:
┌─────────────────────────────────────────────────────────────────────────┐
│ ~/.cc-mirror/ │
│ │
│ ├── zai/ ← Your Z.ai variant │
│ │ ├── npm/ Claude Code installation │
│ │ ├── config/ API keys, sessions, MCP servers │
│ │ ├── tweakcc/ Theme & prompt customization │
│ │ └── variant.json Metadata │
│ │ │
│ ├── minimax/ ← Your MiniMax variant │
│ │ └── ... │
│ │ │
│ └── mclaude/ ← Your Mirror Claude variant │
│ └── ... │
│ │
│ Wrappers: ~/.local/bin/zai, ~/.local/bin/minimax, ~/.local/bin/mclaude │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Run any variant directly from your terminal:
zai # Launch Z.ai variant
minimax # Launch MiniMax variant
mclaude # Launch Mirror Claude variant| Feature | Description |
|---|---|
| 🔌 Multiple Providers | Z.ai, MiniMax, OpenRouter, CCRouter, Mirror, or custom endpoints |
| 📁 Complete Isolation | Each variant has its own config, sessions, and credentials |
| 🎨 Brand Themes | Custom color schemes per provider via tweakcc |
| 📝 Prompt Packs | Enhanced system prompts for Z.ai and MiniMax |
| 🤖 Team Mode | Multi-agent collaboration with shared task management |
| 📋 Tasks CLI | Manage, archive, and visualize task dependencies from command line |
| 🔄 One-Command Updates | Update all variants when Claude Code releases |
# Create & manage variants
npx cc-mirror create # Full configuration wizard
npx cc-mirror quick [options] # Fast setup with defaults
npx cc-mirror list # List all variants
npx cc-mirror update [name] # Update one or all variants
npx cc-mirror remove <name> # Delete a variant
npx cc-mirror doctor # Health check all variants
# Task management (team mode)
npx cc-mirror tasks # List open tasks
npx cc-mirror tasks show <id> # Show task details
npx cc-mirror tasks create # Create new task
npx cc-mirror tasks update <id> # Update task
npx cc-mirror tasks delete <id> # Delete task
npx cc-mirror tasks archive <id> # Archive task
npx cc-mirror tasks clean # Bulk cleanup
npx cc-mirror tasks graph # Visualize dependencies
# Launch your variant
zai # Run Z.ai variant
minimax # Run MiniMax variant
mclaude # Run Mirror Claude variant--provider <name> zai | minimax | openrouter | ccrouter | mirror | custom
--name <name> Variant name (becomes the CLI command)
--api-key <key> Provider API key
--base-url <url> Custom API endpoint
--model-sonnet <name> Map to sonnet model (OpenRouter)
--model-opus <name> Map to opus model (OpenRouter)
--model-haiku <name> Map to haiku model (OpenRouter)
--brand <preset> Theme: auto | zai | minimax | openrouter | ccrouter | mirror
--enable-team-mode Enable team mode (TaskCreate, TaskGet, TaskUpdate, TaskList)
--no-tweak Skip tweakcc theme
--no-prompt-pack Skip prompt pack
Each provider includes a custom color theme:
| Brand | Style |
|---|---|
| zai | Dark carbon with gold accents |
| minimax | Coral/red/orange spectrum |
| openrouter | Teal/cyan gradient |
| ccrouter | Sky blue accents |
| mirror | Silver/chrome with electric blue |
Enable multi-agent collaboration with shared task management:
# Enable on any variant
npx cc-mirror create --provider zai --name zai-team --enable-team-mode
# Mirror Claude has team mode by default
npx cc-mirror quick --provider mirror --name mclaudeTeam mode enables: TaskCreate, TaskGet, TaskUpdate, TaskList tools plus an orchestrator skill that teaches Claude effective multi-agent coordination patterns.
Manage team tasks from the command line:
# List open tasks
npx cc-mirror tasks
# View across all teams
npx cc-mirror tasks --all
# Create and update tasks
npx cc-mirror tasks create --subject "Add auth" --description "JWT implementation"
npx cc-mirror tasks update 5 --status resolved --add-comment "Done"
# Cleanup resolved tasks
npx cc-mirror tasks clean --resolved --dry-run
npx cc-mirror tasks clean --resolved --force
# Archive instead of delete (preserves task history)
npx cc-mirror tasks archive 5
# Visualize dependency graph
npx cc-mirror tasks graphTasks are automatically scoped by project folder — no cross-project pollution:
# Run in different project folders - tasks stay isolated
cd ~/projects/api && mc # Team: mc-api
cd ~/projects/frontend && mc # Team: mc-frontend
# Multiple teams in the same project
TEAM=backend mc # Team: mc-myproject-backend
TEAM=frontend mc # Team: mc-myproject-frontendA pure Claude Code variant with enhanced features:
- No proxy — Connects directly to Anthropic's API
- Team mode — Enabled by default
- Isolated config — Experiment without affecting your main setup
- Custom theme — Silver/chrome aesthetic
npx cc-mirror quick --provider mirror --name mclaude
mclaude # Authenticate via OAuth or API key| Document | Description |
|---|---|
| Team Mode | Multi-agent collaboration with shared tasks |
| Mirror Claude | Pure Claude Code with enhanced features |
| Architecture | How cc-mirror works under the hood |
| Full Documentation | Complete documentation index |
- tweakcc — Theme and customize Claude Code
- Claude Code Router — Route Claude Code to any LLM
- n-skills — Universal skills for AI agents
Contributions welcome! See CONTRIBUTING.md for development setup.
Want to add a provider? Check the Provider Guide.
MIT — see LICENSE
Created by Numman Ali
@nummanali