numman-ali/cc-mirror
Create multiple isolated Claude Code variants with custom providers (Z.ai, MiniMax, OpenRouter, LiteLLM)
Deep Analysis
Claude Code distribution tool supporting cloning of independent Claude Code instances, configuring alternative AI providers (Z.ai, MiniMax, OpenRouter, CCRouter), applying custom themes, installing optional skills and orchestration tools while preserving main Claude Code installation
Core Features
Multi-Instance Isolation
Clone Claude Code into independent variants, each stored in ~/.cc-mirror/<name>/ with separate npm/config/tweakcc/variant.json
Multi-Provider Support
Supports Mirror Claude (direct Anthropic API), Z.ai (GLM models), MiniMax (M2.1), OpenRouter (100+ models), CCRouter (local LLMs)
Multi-Agent Orchestration
Task graph decomposition with dependencies, parallel execution patterns (fan-out, pipeline, map-reduce), background agent spawning, Conductor role coordination
Project Isolation
Tasks automatically scoped to project folders preventing cross-project interference, CLI task management supporting list/create/update/visualize dependencies
Technical Implementation
Execute npx cc-mirror quick --provider mirror --name mclaude to create independent variant
Select and configure AI provider (Z.ai/MiniMax/OpenRouter/CCRouter), input API keys
Apply custom themes via tweakcc, install optional skills and orchestration tools
Launch variant via custom command (e.g., mclaude), use independent configuration and chat history
- 1,392 GitHub Stars, one-click creation of independent Claude Code variants
- Supports 100+ AI models (via OpenRouter)
- Windows support (.cmd files and PATH configuration)
- Pre-configured prompt packs and battle-tested enhancements
- Simultaneously using multiple AI providers (official Claude + Z.ai + MiniMax)
- Configuring different Claude Code variants and themes for different projects
- Testing model performance and cost-effectiveness of different providers
- Keeping main Claude Code installation clean, testing experimental features in independent variants
- Multi-Agent orchestration features are from Legacy v1.6.3 version
- Requires configuring separate API keys for different providers
CC-MIRROR: Claude Code Distribution
Purpose & Features
CC-MIRROR is an opinionated distribution that creates isolated Claude Code variants with custom providers. Pre-configured Claude Code variants with custom providers, prompt packs, and battle-tested enhancements.
Core capabilities include:
- Cloning Claude Code into separate instances
- Configuring alternative AI providers (Z.ai, MiniMax, OpenRouter, CCRouter)
- Applying custom themes via tweakcc
- Installing optional skills and orchestration tools
- Preserving main Claude Code installation untouched
Installation & Setup
The quickest path uses a single command:
npx cc-mirror quick --provider mirror --name mclaude
This creates an isolated variant launched via mclaude. An interactive wizard alternative exists: npx cc-mirror
Key Capabilities
Multi-Agent Orchestration (Legacy v1.6.3):
- Task graph decomposition with dependencies
- Parallel execution patterns (fan-out, pipeline, map-reduce)
- Background agent spawning while work continues
- "The Conductor" role for coordinating multiple agents
Provider Support:
- Mirror Claude (direct Anthropic API)
- Z.ai (GLM models)
- MiniMax (M2.1)
- OpenRouter (100+ models)
- Claude Code Router (local LLMs)
Project Isolation: Tasks automatically scope to project folders, preventing cross-project interference. CLI task management supports listing, creating, updating, and visualizing task dependencies.
Technical Architecture
Each variant stores in ~/.cc-mirror/<name>/ containing:
- npm/ (Claude Code installation)
- config/ (API keys, sessions, MCP servers)
- tweakcc/ (theme customization)
- variant.json (metadata)
Wrappers create shell commands mapping to individual variants, with Windows support via .cmd files and PATH configuration.
