Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (cc-mirror) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

CC-MIRROR

CC-MIRROR Provider Themes

Claude Code, Unshackled

Pre-configured Claude Code variants with custom providers,
prompt packs, and battle-tested enhancements.

One command. Instant power-up.

Quick Start

# Fastest path to a configured Claude Code variant
npx cc-mirror quick --provider mirror --name mclaude

# Run it
mclaude

That's it. You now have a Claude Code variant ready to run.

Claude Code Version (Stable/Latest/Pin)

By default, CC-MIRROR installs the latest Claude Code native release. You can pin a channel or version:

# Track upstream stable channel
npx cc-mirror quick --provider mirror --name mclaude --claude-version stable

# Track upstream latest channel
npx cc-mirror update mclaude --claude-version latest

# Pin a specific version
npx cc-mirror update mclaude --claude-version 2.1.37

Notes:

stable and latest are upstream channels. stable may lag behind latest (that is normal).
cc-mirror resolves the channel to a concrete version during install/update and stores it in variant.json.

CC-MIRROR Home Screen

Or use the interactive wizard

npx cc-mirror

What is CC-MIRROR?

CC-MIRROR is an opinionated Claude Code distribution. We did the hacking — you get the superpowers.

At its core, CC-MIRROR:

Clones Claude Code into isolated instances
Configures provider endpoints, model mapping, and env defaults
Applies prompt packs and tweakcc themes
Installs optional skills (dev-browser, opt-in)
Packages everything into a single command

Each variant is completely isolated — its own config, sessions, MCP servers, and credentials. Your main Claude Code installation stays untouched.

┌─────────────────────────────────────────────────────────────────────────┐
│  ~/.cc-mirror/                                                          │
│                                                                         │
│  ├── mclaude/                        ← Mirror Claude                     │
│  │   ├── native/                     Claude Code installation           │
│  │   ├── config/                     API keys, sessions, MCP servers    │
│  │   ├── tweakcc/                    Theme customization                │
│  │   └── variant.json                Metadata                           │
│  │                                                                      │
│  ├── zai/                            ← Z.ai variant (GLM models)        │
│  ├── minimax/                        ← MiniMax variant (M2.5)           │
│  └── kimi/                           ← Kimi Code variant (kimi-for-coding) │
│                                                                         │
│  Wrappers: <bin-dir>/mclaude, <bin-dir>/zai, ...                        │
└─────────────────────────────────────────────────────────────────────────┘

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.

Providers

Mirror Claude (Recommended)

The purest path to vanilla Claude Code. No proxy, no model changes — just clean isolation.

npx cc-mirror quick --provider mirror --name mclaude

Direct Anthropic API — No proxy, authenticate normally (OAuth or API key)
Isolated config — Experiment without affecting your main setup
Provider presets — Clean defaults without hidden patches

Alternative Providers

Want to use different models? CC-MIRROR supports multiple providers:

Provider	Models	Auth	Best For
Kimi	kimi-for-coding	API Key	Long-context coding (Kimi Code)
MiniMax	MiniMax-M2.5	API Key	Unified model experience
Z.ai	GLM-5, 4.7, 4.5-Air	API Key	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	Claude Code endpoint	Auth Token	Simple endpoint setup
CCRouter	Ollama, DeepSeek, etc.	Optional	Local-first development
GatewayZ	Multi-provider gateway	Auth Token	Centralized routing

Provider Setup Links

Provider	Subscribe	Get Key/Token	Docs
Kimi	https://www.kimi.com/code	https://www.kimi.com/code/console	https://www.kimi.com/code/docs/en/more/third-party-agents.html
MiniMax	https://platform.minimax.io/subscribe/coding-plan	https://platform.minimax.io/user-center/payment/coding-plan	https://platform.minimax.io/docs
Z.ai	https://z.ai/subscribe	https://z.ai/manage-apikey/apikey-list	https://z.ai/docs
OpenRouter	https://openrouter.ai/account	https://openrouter.ai/keys	https://openrouter.ai/docs
Vercel	https://vercel.com/ai	https://vercel.com/account/tokens	https://vercel.com/docs/ai-gateway
Ollama	https://ollama.com	https://ollama.com	https://docs.ollama.com/api/anthropic-compatibility
NanoGPT	https://nano-gpt.com	https://nano-gpt.com	https://docs.nano-gpt.com/docs/anthropic-compatibility
CCRouter	https://github.com/musistudio/claude-code-router#installation	https://github.com/musistudio/claude-code-router#2-configuration	https://github.com/musistudio/claude-code-router#2-configuration
GatewayZ	https://gatewayz.ai	https://gatewayz.ai	https://docs.gatewayz.ai/docs/anthropic-compatibility

# Kimi Code (kimi-for-coding)
npx cc-mirror quick --provider kimi --api-key "$KIMI_API_KEY"

# MiniMax (MiniMax-M2.5)
npx cc-mirror quick --provider minimax --api-key "$MINIMAX_API_KEY"

# Z.ai (GLM-5/4.7/4.5-Air)
npx cc-mirror quick --provider zai --api-key "$Z_AI_API_KEY"

# OpenRouter (100+ models)
npx cc-mirror quick --provider openrouter --api-key "$OPENROUTER_API_KEY" \
  --model-sonnet "anthropic/claude-sonnet-4-20250514"

# Vercel AI Gateway
npx cc-mirror quick --provider vercel --api-key "$VERCEL_AI_GATEWAY_KEY" \
  --model-sonnet "anthropic/claude-3-5-sonnet-20241022"

# Ollama
npx cc-mirror quick --provider ollama --api-key "ollama" \
  --model-sonnet "qwen3-coder" --model-opus "qwen3-coder" --model-haiku "qwen3-coder"

# NanoGPT
npx cc-mirror quick --provider nanogpt --api-key "$NANOGPT_API_KEY"

# CC Router (local LLMs)
npx cc-mirror quick --provider ccrouter

# GatewayZ
npx cc-mirror quick --provider gatewayz --api-key "$GATEWAYZ_API_KEY" \
  --model-sonnet "claude-3-5-sonnet-20241022"

All Commands

# Create & manage variants
npx cc-mirror                     # Interactive TUI
npx cc-mirror quick [options]     # Fast setup with defaults
npx cc-mirror create [options]    # Full configuration wizard
npx cc-mirror list                # List all variants
npx cc-mirror update [name]       # Update one or all variants
npx cc-mirror apply <name>        # Re-apply tweakcc patches (no reinstall)
npx cc-mirror remove <name>       # Delete a variant
npx cc-mirror doctor              # Health check all variants
npx cc-mirror tweak <name>        # Launch tweakcc customization

# Launch your variant
mclaude                           # Run Mirror Claude
zai                               # Run Z.ai variant
minimax                           # Run MiniMax variant
kimi                              # Run Kimi Code variant

CLI Options

--provider <name>        kimi | minimax | zai | openrouter | vercel | ollama | nanogpt | ccrouter | mirror | gatewayz | 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
--model-opus <name>      Map to opus model
--model-haiku <name>     Map to haiku model
--brand <preset>         Theme: auto | kimi | minimax | zai | openrouter | vercel | ollama | nanogpt | ccrouter | mirror | gatewayz
--no-tweak               Skip tweakcc theme
--no-prompt-pack         Skip provider prompt pack
--verbose               Show full tweakcc output during update

Brand Themes

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

Documentation

Document	Description
Mirror Claude	Pure Claude Code with clean defaults
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

Contributing

Contributions welcome! See CONTRIBUTING.md for development setup.

Want to add a provider? Check the Provider Guide.

License

MIT — see LICENSE

Created by Numman Ali
@nummanali

cc-mirror