Create multiple isolated Claude Code variants with custom providers (Z.ai, MiniMax, OpenRouter, LiteLLM)
Create multiple isolated Claude Code variants with custom providers (Z.ai, MiniMax, OpenRouter, LiteLLM)
Pre-configured coding variants with custom providers,
prompt packs, and battle-tested enhancements.
One command. Instant power-up.
cc-mirror is maintained as issues-first. Please open issues with provider docs, reproduction steps, and patch/design links; external pull requests are not accepted directly.
# Fastest path to a configured provider-native variant
npx cc-mirror quick --provider mirror --name mirror
# Run it
mirrorThat's it. You now have an isolated coding variant ready to run.
By default, CC-MIRROR installs the latest native runtime release. You can pin a channel or version:
# Track upstream stable channel
npx cc-mirror quick --provider mirror --name mirror --claude-version stable
# Track upstream latest channel
npx cc-mirror update mirror --claude-version latest
# Pin a specific version
npx cc-mirror update mirror --claude-version 2.1.37Notes:
stable and latest are upstream channels. stable may lag behind latest (that is normal).variant.json.npx cc-mirror update [name] refreshes the native runtime install and cc-mirror-managed defaults for that variant, including provider endpoints, model slots, update/install/privacy flags, provider-managed MCP servers, and managed tweakcc startup/banner settings. Credentials and custom env keys are preserved.
Managed variants default to cc-mirror-controlled updates, disabled upstream install checks, privacy-oriented hosted-provider traffic settings, and hidden upstream startup branding where tweakcc can control it.
npx cc-mirrorCC-MIRROR is an opinionated provider-native coding distribution. We did the wiring; you get the useful defaults.
At its core, CC-MIRROR:
Each variant is completely isolated — its own config, sessions, MCP servers, and credentials. Your main installation stays untouched.
…Default <bin-dir> is ~/.local/bin on macOS/Linux and ~/.cc-mirror/bin on Windows.
Windows tip: add %USERPROFILE%\.cc-mirror\bin to your PATH, or run the <variant>.cmd wrapper directly. Each wrapper has a sibling <variant>.mjs launcher.
Each variant has its own Claude Code config directory. Add MCP servers to:
~/.cc-mirror/<variant>/config/.claude.jsoncc-mirror keeps provider-managed MCP servers up to date during npx cc-mirror update, while preserving unrelated user-added MCP servers in the same file.
For a server that should load in every project for one variant, run the variant wrapper with user scope:
openrouter mcp add-json airtable '{"command":"npx","args":["@rashidazarang/airtable-mcp"],"env":{"AIRTABLE_TOKEN":"","AIRTABLE_BASE_ID":""}}' --scope user
openrouter mcp listFor a server that should live with the current project, use --scope project; Claude Code will write .mcp.json in that project. The default local scope is project-specific but private, so a server added from one working directory may not appear from another.
The clean default runtime path. No proxy, no model changes — just isolation and privacy defaults.
npx cc-mirror quick --provider mirror --name mirrorWant to use different models? CC-MIRROR supports multiple providers:
| Provider | Models | Auth | Best For |
|---|---|---|---|
| Kimi | kimi-for-coding | Auth Token | Long-context coding (Kimi Code) |
| MiniMax | MiniMax-M2.7 | Auth Token | Unified model experience |
| Z.ai | GLM-5.1, 5-Turbo, 4.5-Air | Auth Token | Heavy coding with GLM reasoning |
| OpenRouter | 100+ models | Auth Token | Model flexibility, pay-per-use |
| Vercel | Multi-provider gateway | Auth Token | Vercel AI Gateway |
| Ollama | Local + cloud models | Auth Token | Local-first + hybrid setups |
| NanoGPT | GPT-5.2 / Gemini 3 Flash | Auth Token | Pay-as-you-go model access |
| CCRouter | Ollama, DeepSeek, etc. | Optional | Local-first development |
| GatewayZ | Multi-provider gateway | Auth Token | Centralized routing |
………Each provider includes a custom color theme via tweakcc:
| Brand | Style |
|---|---|
| kimi | Teal/cyan gradient |
| minimax | Coral/red/orange spectrum |
| zai | Dark carbon with gold accents |
| openrouter | Silver/chrome with electric blue |
| vercel | Monochrome with green accents |
| ollama | Warm sandstone with earthy tones |
| nanogpt | Aurora green + cyan accents |
| ccrouter | Sky blue accents |
| gatewayz | Violet gradients |
| Document | Description |
|---|---|
| Mirror | Isolated runtime with clean defaults |
| Architecture | How CC-MIRROR works under the hood |
| Full Documentation | Complete documentation index |
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
No open issues yet, or sync has not completed.